YAPB Plugins / Hooks

The way of the master: Install WordPress, convert it to a photoblog via YAPB and finally pimp it up with some plugins.

Already Available Plugins

YAPB Bulk Uploader

Joost’s second YAPB extensions: According to the plugin page on wordpress.org, you may now upload multiple images at once – INCLUDING IPTC SUPPORT – whoa.

Download the plugin from
the WordPress Plugin repository

XP Uploader

Historically the first available third-party extension to YAPB: Developed by Joost, it allows you to upload images directly over the Windows XP File Explorer.

Download the plugin from
the WordPress Plugin repository

YAPB-Queue

Bulk-import your images via FTP.

Download the plugin from
the WordPress Plugin repository

YAPB-Geotag

Extract GPS-data from your YAPB-Images.

Download the plugin from
the WordPress Plugin repository

YAPB Sidebar Widget

Previously included in the default YAPB installation, the YAPB sidebar widget was outsourced since version 1.9 and has become a plugin of it’s own. Of course, it evolved a little bit and now offers you the following functionality: Either show a list of your prevously posted images or just output some random images. Additionally you now may display a link to your mosiac page below the widget.

Download the plugin from
the WordPress Plugin repository

YAPB XMLRPC Sidebar Widget

Basically the same as the default YAPB Sidebar Widget, this version may display your images remotely on another blog. All you need is a source-blog running YAPB + the YAPB XMLRPC Server Plugin (As seen below) so you can access those images remotely.

Download the plugin from
the WordPress Plugin repository

YAPB XMLRPC Server

Originally provided by Mac, the YAPB XMLRPC Server Plugin allows remote access to your photoblog. You define an API key and voila: Your images are accessible via XML RPC. If you don’t know how to do that: Just have a look at the YAPB XMLRPC Sidebar Widget ;-)

Download the plugin from
the WordPress Plugin repository

Developing your own YAPB Plugin

Ah, finally – The interesting part for us developers ;-) Read this little introduction and have a look at the code of the yapb-sidebar-widget for example, and you should know how to develop YAPB plugins. It’s no rocket science.

Why YAPB Plugins?

First of all: Why splitting YAPB into a main part + plugins? Imho, separating blocks of functionality helps YAPB stay clean, “small” (whatever that means) and helps YAPB keeping focused on its primary target: Extend WordPress to become a Photoblog platform.

Secondly, separate plugins may be developed and evolved separately without any coupling to the main YAPB release cycle. Developers may now create additional features without “asking me for permission” or whatever – just go and do it ;-)

It’s simple

Writing a YAPB-Plugin is basically the same thing as writing a WordPress Plugin – It’s just a matter of view: We develop additional functionality built onto the YAPB foundation:

YAPB basicly offers you the “yapb_register_plugin” action-hook, which gets called right after YAPB initialization. Additionally, your function gets called with the current YAPB Class Instance as parameter: It’s a simple as that:

[code language=”php”]
function my_cool_plugin_initialization($yapb) {
// hook into WordPress,
// add some options to YAPB and
// finally do what you want
}

add_action(‘yapb_register_plugin’, ‘my_cool_plugin_initialization’);
[/code]

Have a look at the YAPB Sidebar Widget Plugin for more handy sample code.

The ultimate YAPB Hook Reference

YAPB offers some hooks out of the box. If you’re interested in developing your own YAPB Extension you should have a look at this list:

yapb_register_plugin

Source: Yapb.class.php
Since: 1.9

yapb_register_thumbnail gets fired just after the initialization of YAPB itself (last line in the constructor). That means you can execute code right after YAPB was initialized – And you get the YAPB Instance as Parameter. This hook is an action which means that it primarily acts as an event trigger, instead of a content filter.

yapb_get_thumbnail

Source: YapbTemplateFunctions.php
Parameters: String containg the thumbnail image tag

yapb_get_thumbnail gets fired just before the image tag gets returned from the yapb_get_thumbnail() template function. This hook is a filter which means that information is passed through it, and then used by WordPress.

yapb_get_exif

Source: YapbTemplateFunctions.php
Parameters: Assoziative array containg the exif data

yapb_get_exif gets fired just before the EXIF tags array gets returned from the yapb_get_exif() template function. This hook is a filter which means that information is passed through it, and then used by WordPress.

yapb_alternative_image_formats

Source: YapbTemplateFunctions.php
Parameters: Array containing the alternative image formats

yapb_alternative_image_formats gets fired just before the list of alternative image formats get returned by the according template function. This hook is a filter which means that information is passed through it, and then used by WordPress.

yapb_image_upload

Source: Yapb.class.php
Parameters: YapbImage Instance of the current image
Since: 1.9.18

yapb_image_upload gets fired just after you saved a post containing a YAPB image and that image was persisted to database and disc. This hook is an action which means that it primarily acts as an event trigger, instead of a content filter.

damn_i_need_a_new_hook

If you need a hook in YAPB to develop something new: Leave me a note in the forum so we can discuss it. But hey: I’m the last one blocking new features. As long as it’s not disturbing the way YAPB works, i’m with you.

This entry was posted 12 years and 1 month ago on Monday, June 16th, 2008 at 12:24 and is filed under .

You can follow any responses to this entry through the RSS 2.0 feed; You may leave a response, or trackback from your own site.

Fifty One Replies

24. June 2008, 21:16
Comment by Shae

This is a "Sidebar Widget", but the YAPB-ready themes you list don't have sidebars. What theme will this work with?

Any suggestion(s) would be appreciated, as I tried this about six months ago and could not get it to work with any sidebar theme I chose. I'm not picky on a theme, as long as it has a sidebar and comments, because I can tweak the colors and styles.

Thanks
- 25. June 2008, 07:11
  Comment by Johannes
  
  Hi Shae -
  
  First of all, you may use YAPB with nearly every theme - Those "ready-to-use-themes" are only very specialiced themes for photography. My homepages theme is a regular type of wordpress theme since i want to write normal articles too. And it uses the YAPB Sidebar Widget. Another possibility would be to use the Widget on another blog to display the images of your photoblog: That may be achieved in conjunction with the YAPB XMLRPC Server Plugin.
  
  But yes: You need a theme with widget-enabled sidebar.
  
  Hope that gave a little overview.
25. June 2008, 13:17
Comment by Shae

I know that "photoblogs" aren't different from regular blogs. That isn't the problem.

As I said, the ones I chose did NOT work, and I tried with a half dozen or so. They were Broken. They caused errors.

Can you give a name of a theme that you believe will work, please? Perhaps the one you started with? Or any other?
- 25. June 2008, 15:04
  Comment by Johannes
  
  Try the WordPress Default theme first. YAPB and YAPB Sidebar Widget work with it. If that doesn't work for you, there is another problem - not a theme problem.
  
  The feedback i got so far shows me that YAPB works with nearly every WordPress theme out there... Personally, i think you could have a technical problem installing YAPB - Not a "YAPB is correctly installed but the theme doesn't work" kinda problem.
  
  And PLEASE use the forum for support questions.
  
  Greets from Salzburg,
  
  Johannes
25. June 2008, 21:03
Comment by Shae

Meep meep meep meeep mep meep meep meep meep meeep YAPB meep meep, meep meep meep meep. Meeeep meep meep meep meep meep meep meep meeeep mep mep meep.php meep meep meep meep meep meep meeep meeep meeep mep mep meep meep meep meep meeeep.

True, meep meep meep, meeep mep mep mep mep meep, meeep meeep meep meeep meep meeeep meep mep mep meeeep (Meep meeep mep mep mep) meeep meep meep, Meeep meep meep meep meep meeep meeeeeep meep.

Moved answer to the forum.
- 26. June 2008, 07:07
  Comment by Johannes
  
  And PLEASE use the forum for support questions.
11. August 2008, 09:28
Comment by the.darkman

Hallo,

ich habe YAPB schon länger benutzt und wollte nun auch den Sidbar Widget benutzen. Installation hat super geklappt, aber in den allgemeinen YAPB Optionen ist nirgens etwas bzgl. des Widgets zu finden. Ich nutze die deutsche Version von Wordpress, neusten Version, und auch YAPB ist aktuell. Woran kann das liegen? YAPB selbst funktioniert sehr gut.

Gruß darkman
18. August 2008, 16:20
Comment by George

Hi John,

I downloaded the 1.9.7 version of the plugin, and it appears fine at the plugins list. However, when I go to the Options, the version there mentioned is 1.8.1, and I can't find any configuration options there for the yapb widget for the latest/random pictures. Is there anything wrong with the installation files?

kind regards,

George
4. November 2008, 23:02
Comment by Jenna

Hi There - When I first installed the plugin, my post would show next to the image but now it shows below the image. Is there a way I can ensure that the post shows up beside the image instead of below??

Thanks!
- 5. November 2008, 08:34
  Comment by Johannes
  
  By default, YAPB images are shown above the content. You may place the images on the left if you change the css in the automatic image insertion tab in the YAPB options. Something like "float:left;" could do the thing, but it could break your layout too - depends on your wordpress theme.
  
  To take control, you could adapt your theme manually with YAPB template tags.
10. December 2008, 10:08
Comment by francis

Hi, just want to ask why is the uploaded image in YAPB not showing in the content page?

Need response asap please.

Thanks and happy holidays!
- 10. December 2008, 11:46
  Comment by Johannes
  
  Please provide more info (the url of the post for example) so i may take a look. Do you see the image in the admin area if you edit the post? what's the size of the image? etc. etc.
  
  and please post that info to the forum:
  http://johannes.jarolim.com/yapb-forum
  
  thanks!
15. December 2008, 09:03
Comment by francis

hi, i just posted my problem in the forum last week but no response yet. I badly need answers asap so please...need something to fix it.

thanks in advance.
4. January 2009, 23:27
Comment by Joanna

Can you explain me why photos rendered by YAPB are of worse quality? Compare these: YAPB with Grain - http://photo.pozaschematy.pl/?p=109 and regular website here: http://i1.trekearth.com/photos/5853/ratusz_hdr.jpg. Why this difference in sharpness?
thank you
Joanna
5. January 2009, 10:33
Comment by Johannes

I think your question was answered in the forum - Greets from Salzburg!
8. January 2009, 06:31
Comment by Jon

hi! sweet plugin, absolutely love it. So much in fact, I wrote an export/import plugin for it so that I could migrate Wordpress and all my YAPB images from one site to another.

If you're interested I can send you the code. Will probably post it on my blog soon too if that's OK with you!
- 8. January 2009, 08:18
  Comment by Johannes
  
  Hi Jon -
  
  Surely - I'm interested! Let's meet in the forum?
  http://johannes.jarolim.com/yapb-forum
  
  Greets from Salzburg,
  
  Johannes
  - 14. January 2009, 16:23
    Comment by Jon
    
    Hi! Didn't see a way to private message you in the forums so I just made a post here: http://johannes.jarolim.com/yapb-forum/showthread.php?tid=853
    
    Wasn't sure if that was the right place for it, but I saw some other posts in there about custom plugins, so I stuck it in there.
    
    Let me know what you think!!
14. January 2009, 10:13
Comment by mitcho

Hi Johannes - I'm the developer of Yet Another Related Posts Plugin. One thing I've often been asked is how to use YARPP to display thumbnails of related posts. I'm wondering if YAPB has any functions that let you get another post's thumbnail by post ID. For example, something like: `get_thumbnail($post_ID)` and `thumbnail_exists($post_ID)`. Any advice would be appreciated!
14. January 2009, 10:35
Comment by mitcho

Johannes, actually template tags were all I needed, so I figured it out. :) Thanks a lot. I'll let you know when the YAPB thumbnail-compatible version of YARPP is out.
- 14. January 2009, 11:06
  Comment by Johannes
  
  Glad you found your answer - Please don't forget to check for existance of the template function before using it - Then, your plugin will run even if YAPB gets deactivated by the user:
  
  if (function_exists('yapb_is_photoblog_post') && yapb_is_photoblog_post()) {
  ...
  }
  
  Greets from Salzburg!
  
  Johannes
  - 14. January 2009, 14:41
    Comment by mitcho
    
    Hi Johannes - thanks for your quick reply! I just released the beta of my next version and wrote up how to incorporate Yet Another Related Posts Plugin with YAPB here:
    
    Using Templates with YARPP 3
    
    Thanks for your support!
- 29. March 2009, 04:48
  Comment by Pete
  
  Can you post the template tags that were the solution to your problems? I'm looking for a similar method to get the thumbnail from another YAPB post via post ID and can't quite get it.
  --
  Thanks!
7. March 2009, 16:20
Comment by Edwin

Fantastic work! I got a stylish looking photoblog in a matter of an hour, and that's a feat for a beginner like me! Kudos to you and keep improving YAPB!
7. March 2009, 16:21
Comment by Edwin

Fantastic work! Keep it up!
14. April 2009, 19:54
Comment by Becks

Is there any way to create seperate galleries using the YAPD plugin?
28. April 2009, 14:50
Comment by curro

I can not see the pics in my sidebar. Perhaps is becouse i can't change permission to the directory of the
> pics??? This is from my ftp program:
>
> SITE CHMOD 777 yapb_cache
> 550 CHMOD 777 yapb_cache: Operation not permitted
>
> Could it be this????
> Thanks
> Curro
- 28. April 2009, 15:08
  Comment by Johannes
  
  The directory YAPB_CACHE should be writeable by the user your Webserver or PHP CGI installation works with so YAPB can cache thumbnails.If you have problems setting the permission via FTP, you could try that action with a filebrowsing app provided by your webhoster or one of the PHP Filebrowsers available all over the net.
  - 28. April 2009, 15:15
    Comment by curro
    
    thanks, I did to '777' but now it tell me this:
    Thumbnail generation unsuccessful
    
    DEBUG post_id=197
    DEBUG Found YAPB image
    DEBUG h=80
    DEBUG fltr[]=usm|30|3|3
    ERROR Couldn't save /var/www/vhosts/tincan.es/subdomains/noticiasit/httpdocs/imagenes/yapb_cache/informatica3_presenta_nuevas_versiones_de_sus_programas_de_gestion_empresarial2.bw57tr1az1kokc0wc8kskcwcs.89y7syhqq1c8g408w04wk44sc.th.jpeg - Please check cache directory permissions
    and i verify that the directory is writable and readable¡¡¡¡
    please, help me...
    
    thanks
    curro
    - 28. April 2009, 15:30
      Comment by Johannes
      
      Hi curro - Please check if the directory above really exists... As far as i know, WordPress usually uploads files and images to a folder called wp-content/uploads: The usual location of the yapb_cache dir is wp-content/uploads/yapb_cache.
      
      And please post such requests to the YAPB-Forum - Thanks!
28. April 2009, 15:47
Comment by curro

thanks Johannes, yes it exist and all my 'normal' pics are in there. I change the location for 'iamgenes' aT THE BEGGINING of the blog. and I verify just right now again this directory and the yapb_cache are both in '777'... so, please... help me...
curro
28. April 2009, 15:47
Comment by curro

ooopsss is a subdomain... couold it be this????
thamnks
curro
28. April 2009, 17:32
Comment by curro

Done¡¡¡ mi ISP had a 'sure protection' on the subdomain and just this¡¡¡
Thanks very much
Curro
5. May 2009, 15:18
Comment by curro

finished¡¡¡ i have to talk with my ISDP, it has protected my site¡¡¡¡ so now is done and work perfectly.. thanks very much... you has win a cold beer in MAdrid¡¡¡ just give a call when you where here,... and done... thanks
24. August 2010, 19:16
Comment by Sarah Valentine

For the life of me I can not get any photos to upload to my new blog address even after I have installed your plug-in. I am going to pull all of my hair out. I have spent so much time trying to figure this out and now I am in the weeds....Can you please help me? Sarah

You're welcome to leave a message here

Imprint

This is the private homepage of Johannes Jarolim, Maria Cebotari Straße 6, 5020 Salzburg. You may reach me over this email address .

Das ist die private Homepage von Johannes Jarolim, Maria Cebotari Straße 6, 5020 Salzburg. Sie können mich unter dieser Emailadresse erreichen.

Photos copyrighted: Please notice that all photographs are copyrighted and must not be used without my proper permission.

Fotos unterliegen dem Urheberschutz: Alle Fotos auf dieser Seite unterliegen dem Urheberschutz und dürfen ohne meine explizite Erlaubnis nicht verwendet werden.