 |
31. May 2007, 22:05YAPB Template Functions |
232 |
Since YAPB 1.5 you may use the following template functions:
yapb_is_photoblog_post
Function returns wheter this post is a photoblog post or not.
No Parameters
Returns boolean
Sample usage:
<?php if (yapb_is_photoblog_post()): ?>HEHEHE<?php endif ?>
yapb_get_image
Function returns an image tag according to the given parameters
Parameters:
- string $before HTML to be rendered before the image
- array $parameters Additional IMG Attributes except src, width and height
- string $after HTML to be rendered after the image
Returns string containing the image tag
Sample Usage:
<?php echo yapb_get_image('<div>', array('alt' => 'This is an image'), '</div>'); ?>
yapb_image
Same as yapb_get_image (See above) – It just prints out the result instead of returning it
Parameters: Same as yapb_get_image
Sample Usage:
<?php yapb_image('<div>', array('alt' => 'This is an image'), '</div>'); ?>
yapb_get_thumbnail
Function returns an thumbnail image tag according to the given parameters
Parameters:
- string $before HTML to be rendered before the thumbnail
- array $parameters Additional IMG Attributes except src, width and height
- string $after HTML to be rendered after the thumbnail
- array $phpThumbConfiguration The phpThumb configuration
- string $class Additional CSS Class of the image
Returns string containing the image tag
Sample Usage:
<?php echo yapb_get_thumbnail('<div>', array('alt' => 'This is a thumbnail', 'rel' => 'lightbox'), '</div>', array('w=200', 'q=90'), 'thumbnail'); ?>
As you can see above, this code sample is also an example on how to include the lightbox.js script.
yapb_thumbnail
Same as yapb_get_thumbnail (See above) – It just prints out the result instead of returning it
Parameters: Same as yapb_get_thumbnail
Sample Usage:
<?php yapb_thumbnail('<div>', array('alt' => 'This is a thumbnail'), '</div>', array('w=200', 'q=90'), 'thumbnail'); ?>
yapb_get_exif
functions returns a list of the exif tokens if available
Parameters:
- boolean $flagUnfiltered No EXIF-tag filtering if true – Return all EXIF tokens
Returns assoziative array containing all (filtered) EXIF tokens
Sample Usage:
<?php $theWonderfulExif = yapb_get_exif() ?>
yapb_exif
literally the same as the function above – It just prints out the exif tags and gives you some parameters so you can customize the output.
Parameters:
- string $liClass CSS class of the li tags
- string $keyValueSeparator HTML between EXIF key and EXIF value
- string $htmlBeforeKey HTML to be rendered before the EXIF key
- string $htmlAfterKey HTML to be rendered after the EXIF key
- string $htmlBeforeValue HTML to be rendered before the EXIF value
- string $htmlAfterValue HTML to be rendered after the EXIF value
- boolean $flagUnfiltered No EXIF-tag filtering if true – Return all EXIF tokens
Sample Usage:
<h3>EXIF</h3><ul><?php yapb_exif('exiftag', ':', '<strong>', '</strong>', '<i>', '</i>') ?></ul>
yapb_get_alternative_image_formats
Returns a listitems with links to alternatively provided image sizes. It will only return image sizes lower or equal that the original uploaded file. The array availableSizes contains should contain a list of all sizes to be provided: The number gets mapped to the longer side of the image.
Parameters:
- array $availableSizes An array containing all max. sizes to be made available
Returns string containing some li’s
Sample Usage:
<h3>Alternative Image Formats</h3><ul><?php echo yapb_get_alternative_image_formats(array(1600, 1024, 800, 640, 320)) ?></ul>
yapb_alternative_image_formats
Basicly the same as above – Just prints out the result
Parameters: Same as above
Sample Usage:
<h3>Alternative Image Formats</h3><ul><?php yapb_alternative_image_formats(array(1600, 1024, 800, 640, 320)) ?></ul>
erreichen.
Comment by Queso
How can I set the large image inside the post to be 790px instead of 460?
this is a great plugin!
Comment by Mac [unlesbar]
Was mich davon abhält, die Funktion
yapb_thumbnail()zu nutzen ist der Umstand, dass ich einen Alternativtext, sowie einen Titel angeben können muss. Vielleicht könntest du den entsprechenden 2. Parameter dahingehend abändern, dass bei Übergabe eines Arrays (etwa'alt'=>'...', 'title'=>'...') beides angegeben werden kann. Dann musst du die API nicht wieder umkrempeln. Gleiches gilt für die Übergabe einer ID.Der Ansatz gefällt mir ansonsten.
Comment by Cyclefitness
Two questions:
1. Is this updated for the latest release of WordPress?
2. Are there instructions for what to do with these functions?
Comment by Johannes
1. yes
2. You can edit your themes template files so the use those functions to display yapb images. More info on the adapt themes manually pages.
Comment by Cyclefitness
Thanks, Johannes. My blog is here: http://www.debbiesilbert.com/photoblog. I want a way to add thumbnails on the sidebar. Is that something I can do with one of these functions? If so, do I need to do anything other than copy the function over to my site and put it on the correct page?
Comment by Johannes
Have a look at the sidebar widget provided by YAPB ;-)
Comment by Raicho Nikolov
I have had problems with the sample codes above. You probably have to put it in tags or something like this, because when I copy it it is reformatted and the single quotes are very strange and need to be edited(if they are not edited PHP complains).
Thank you for the nice plugin! Keep walking :)
Comment by Johannes
Thanks – i didn’t mention it. I’ll have a look how to disable that WordPress feature ;-)
Comment by Johannes
Corrected! Thanks again for the tip – If someone has this problem too, just google for “disable wordpress smart quotes” – i used the following plugin: http://www.planetmike.com/jour.....odequotes/
Comment by Dario
Hi! Can you help me with this problem?…
http://johannes.jarolim.com/ya.....hp?tid=552
Comment by Jorge Otero
yapb_thumbnail and yapb_get_thumbnail aren’t passing the class and title parameters. They seem to be ignored. Is that so?
Comment by Johannes
Yup a bug. Released YAPB 1.7.3 some minutes ago. Thanks for the report!
Happy photoblogging!
Comment by Mackan
I gor this error:
Warning: Invalid argument supplied for foreach() in /foo/bar/wp-content/plugins/yet-another-photoblog/lib/YapbImage.class.php on line 645
with this tag:
<?php echo yapb_get_thumbnail(”, ‘This is a thumbnail’, ”, array(’w=200′, ‘q=90′), ‘thumbnail’); ?>
Using YAPB 1.7.3 with WP 2.3.3
Comment by Johannes
Ah – This is a bug in the documentation and will be fixed in some minutes. The second parameter of the function is an array containing additional attributes of the img tag –
array('alt' => 'Wonderful image', 'border' => '0')for example.Comment by Johannes
Fixed in the documentation – Thanks for the feedback!
Pingback by hkim » photo » Macro
[...] Jan 31st, 2004 • Category: photo YAPB 테스트. 보다 ìž?세한 사용법ì?„ ë³´ë ¤ë©´ how to use yapb code in template ì?„ ë°©ë¬¸í• [...]
Comment by JanT
Thanks for the template!
I’m using Grain, also. Warning: dumb question ahead. Would one of the functions above help, or is there a way to add a new page so that it appears at the top of the page?
Ideally I want to add a separate category of photos, similar to adding a new tab on a website. Possible?
Thanks very much.
Jan
Comment by vahid
Hi
yapb_image function doesn’t work. it out puts:
http://localhost/wordpress/wp-.....raider.jpg
and nothing is being displayed
But when I activate automatic image insertation for single posts it works fine and output is like this:
http://localhost/wordpress/wp-.....8w.th.jpeg
Comment by vahid
Hey it was just a localhost issue. sorry
Great plugin
Comment by Paracetamol
Hello! That’s probably a dumb question; but in my template I want to set a link to the file/thumbnail itself, whithout showing the image. Right now, I’m stripping it out of “yapb_get_image” via PHP, but is there a more practicable solution?
Thanks in advance, also cheers for this great and stable plugin!
Comment by KoalaEatingTree
Hello, I am using YAPB and the phT theme and am stuck on how to have my thumbnails for vertical pictures appear the same as the horizontal picture thumbnails. I want to have all my thumbnails, vert and horizontal, appear the same shape. Thanks!
Comment by pvfe
Hi Johannes!!
thanks for the plugin, its incredible!
im having a little issue, and i know im really close to getting it to work…
i have been able to get thumbnails to appear depending on the category being shown….the problem is when one of those thumbnails are clicked on, they dissapear….this shouldnt happen as they are the navigation of the category!
im using:
cat_ID)) {
query_posts(’cat=’.$cat->cat_ID.’&showposts=-1′);
while (have_posts()) : the_post();?>
image): ?>
<a href=”" title=”"><img src=”image->getThumbnailHref(array(’w=100′,’fltr[]=usm|30|0.5|3′)) ?>” alt=”" title=”" width=”100″/>
any suggestions?
Comment by Suresh
Hi, I’m kinda new to wordpress and blogging. I’m a novice trying to make a mark! Can you please let me know how to upload images without linking them to any particular posts? Can’t I just upload a bunch and then have them displayed on my sidebar randomly? Can I also have a slideshow? I installed both, the YAPB and YAPB Sidebar widgets. Using Wordpress 2.8. Please help. Thanks in advance.
Comment by Heiko
Hi,
ich nutze dieses großartige Plugin schon länger in meinem Blog, möchte es aber nun erweitern. Und zwar möchte ich ein Plugin schreiben, was auf einer Seite alle yapb Bilder in einer google-map anzeigt. Besser noch, alle yapb Bilder deren Artikel zu einer bestimmten Kategorie gehört. Kann ich irgendwie alle yabp Bilder in ner Schleife durchgehen, oder starte ich besser eine neue (the)Loop und parse die nach yapb Bilder durch?
Comment by Johannes
Hi Heiko – Normalerweise holst du dir mit normalen WordPress Bordmitteln die Artikel, die du anzeigen willst (Also die der gewünschten Kategorie). Dann gehst du diese ganz normal mit dem Loop durch und zeigst die YAPB Bilder an, sofern vorhanden.
Tipp: Schau dir auf jeden Fall die Möglichkeit von eigenen Kategorie-Templates in Wordpress an: http://codex.wordpress.org/Category_Templates
Mach das lieber mit den Bordmitteln – Sonst kannst du lange suchen, bevor du per Hand ein SQL gebaut hast, dass alle Artikel einer Kategorie GEJOINED mit der YAPB-Tabelle zurückliefert: Die Kategorisierung in WP ist zwar superflexibel, benötigt aber etwas Einarbeitungszeit ;-)
greets,
johannes
Comment by Heiko
Danke für die Hinweise. Habs jetzt mit Bordmitteln gemacht. Ist allerdings gar nicht so einfach *innerhalb* der Loop eine weitere Loop durchlaufen zu lassen. Das musste aber sein, da mein Plugin ein Tag [[map]] zur Verfügung stellt, mit dem ich *innerhalb* von normalen Beiträgen eine Karte anzeigen lassen kann. Deswegen konnte ich das auch nicht imn Template machen, da das denn zu ner riesigen case Wüste ausgeufert wäre, oder die Karte in jedem Beitrag wäre.
Beispiel: http://trekking-photos.net/?page_id=179 hat im Content einfach nur ein [[map category_name=türkei]] stehen und zeigt die Karte mit allen Fotos die diese Kategorie haben an. Breite und Mittelpunkt werden auch selber ausgerechnet. Wenn Interesse besteht Räume ich das Plugin noch etwas auf und veröffentliche es…
Greetz, Heiko
Comment by mana
Hi, I’m kinda new to wordpress and blogging. I´ve installed the plug in and its amazing, but i am having a little problem. when i upload a picture for a certain post, image appears everywhere BUT in the home of the blog…. I am using a template called Theme Js O3 Lite designed by Jinwen. Valid CSS 3 & XHTML 1.1.
could you help me somehow???
thanks!
mana