Flickr API vs Image Formatr

The Flickr API plugin provides tools for displaying your flickr galleries, sets, photostream or favourites and more using a shortcode in posts and pages or as a widget. You can choose the size of image you want, whether it should be linked to another image size or back to flickr or not linked at all, how many images to show and more… There are some built in options for displaying your images as a simple slideshow or using the Galleria jquery plugin. Alternatively you can choose to style the output yourself and use your own javascript. For developers the plugin also gives you an easy method for calling and caching API responses both in PHP and javascript, and lots of useful tools for working with those responses. Usage You will need to get an API key from flickr to use this plugin. Under the ‘You’ menu look for ‘Your Apps’. Click to get a key and then go to the media settings screen to add your API key and user name. The plugin will automatically determine your NSID so you never need to look this up. To use the plugin either generate a shortcode using the media upload/insert button and selecting what you want to get or use the Flickr widget provided. For developers The plugin exposes its methods for your use in themes as template tags but the main one you may find useful is flickr_api(). This is a general function for calling any API method with the parameters you specify. All responses are in JSON format so you will need to use json_decode() to use the response in PHP. @param $method: (string) This is the API method to call @param $params: (array) Additional arguments to pass into the call such as user_id, photoset_id, gallery_id, text, tags etc... @param $cache : (bool) Whether or not to cache the response based on the arguments passed in You can use the API via javascript as well: var photos = flickr_api( method, params, cache ); NSID lookup: Just pass in the Flickr username of the person to get the NSID for. Filters/Hooks flickr_galleria_themes You can enable the choice of custom or purchased galleria themes by extending the themes array. Useful if you want your theme to have a choice of galleria theme beyond the ‘classic’ style.

Image Formatr is a simple plugin that goes through all the content images on posts & pages, and with zero user changes: gives them a standardized thumbnail format using CSS puts a caption underneath each one using the title makes them linked so they popup in full size Thumbnails are not generated, but will be used if available in the media library. This plugin is driven by the prettyPhoto library so we could call this plugin a prettyPhoto integration plugin. *Note: Supports images on Flickr. Usage This only applies to the images you put in your content, not theme graphics. After the plugin runs, the output to the browser looks like: A sample caption Documentation You can find plugin documentation at http://warriorself.com/blog/about/image-formatr/ Features Standardizes all thumbnails without altering posts Supports displaying images from Flickr: Generates image captions using the image title or alt Integrates WordPress media library thumbnails Gives popups for WordPress gallery images (adjust priority setting to 12) Shows all content images on the blog as small thumbnails (does not create new thumbnails but can use Media Library for thumbs) Allows for fine-grained control of each image’s format Zooms image to large size when clicked using the prettyPhoto library Outputs standard XHTML compliant markup Gallery Support To get WordPress Gallery images to popup, this plugin must run at a priority greater (later) than the [gallery] shortcode which runs at priority 11. Therefore set the priority setting to 12 in the Administration Options. Overrides The actions of the plugin are enabled and disabled with administration settings but can be overridden on each individual image. usemysize – true/false – true = do not ignore an image width and height usemya – true/false – true = do not ignore a parent anchor tag nocap – true/false – true = do not create a caption nofx – true/false – true = no popup effect link – string url – make the caption a link to the url hint – string txt – this will be the new image title asis – true/false – true = don’t change nuthin group – string txt – separate popup slideshows thumb – string url – image thumbnail (version 0.9.7) page – single/!single/front/!front – page filtering (version 0.9.7) If you want to surround an image with an anchor tag , then you should add a usemya attribute within the image tag or else your anchor will be ignored and replaced. If you do not want the popup effect at all, add a nofx attribute to the image. If you do not want any caption, you can specify nocap, or just leave the title blank. And to have the plugin completely ignore an image and output the content directly from the post, use the asis attribute. Example Note: concerning the true/false overrides, do not include “false” parameters like , i.e these overrides should only include the attributes for which you want to designate a “true” value. Credits Image Formatr is Copyright 2014 Steven Almeroth and licensed under a GPL license. Based on: image-caption by Yaosan Yeo. PrettyPhoto: The JavaScript Image thumbnail viewer library by Stephane Caron is licensed under GPLv2. Website More information, including how to contact me, is available at warriorself.com. Translations If you would like to contribute a translation of the administration settings screen please have a look at the .pot file and post to the support forum of e-mail to me. ToDo List add screenshot of output image with caption Wish List phone-home feature, activate/deactivate stats helper with version number add admin option for html/xhtml closing tags add admin option for moving title attribute to alt attribute should it overwrite an existing alt? debug mode could show images not found and whatnots and profiling stats change [flickrset id=”1234″] to [flickr set=”1234″] change [flickr pid=”123″] to [flickr img=”123″] show “the_content” ordering vis a vie wp-hooks-filters-flow.php Priority 8 : WP_Embed->run_shortcode() WP_Embed->autoembed() Priority 10 : wptexturize() convert_smilies() convert_chars() wpautop() shortcode_unautop() prepend_attachment() Priority 11 : capital_P_dangit() do_shortcode() Priority 20 : ImageFormatr->filter() Bug List bug: add_settings_field() not work-around is to only use unique single char id fields defined as constants