Robert O'Rourke

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.
<h4>Usage</h4>
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.
<h4>For developers</h4>
The plugin exposes its methods for your use in themes as template tags but the main one you may find useful is <code>flickr_api()</code>. This is a general function for calling any API method with the parameters you specify.
<pre><code><?php
$response = json_decode( flickr_api( $method, $params, $cache ) );
?>
</code></pre>
All responses are in JSON format so you will need to use <code>json_decode()</code> to use the response in PHP.
<pre><code>@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
</code></pre>
You can use the API via javascript as well:
<pre><code><script>
var photos = flickr_api( method, params, cache );
</script>
</code></pre>
NSID lookup:
<pre><code><?php
$nsid = flickr_get_user_nsid( $username );
?>
</code></pre>
Just pass in the Flickr username of the person to get the NSID for.
<h4>Filters/Hooks</h4>
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.
<pre><code><?php
add_filter( 'flickr_galleria_themes', 'my_galleria_themes' );
function my_galleria_themes( $themes ) {
 $themes[ /* full or relative url to theme js file */ ] = __( 'Theme Name' );
 return $themes;
}
?>
</code></pre>

Flickr API

A comprehensive Flickr plugin that makes it easy to show off your images in style.

Mathieu Chartier

For English people
Modal Portfolio works in English and in French 
Modal Portfolio uses the shortcode [modal-portfolio] (with or without options) for displaying image galleries with video (optionnal), title and description in a modal. Many settings are available to optimize the display and display filters by category
The main feature of Modal Portfolio is to manage several categories of portfolio with different customizable shortcodes . Thus, you can have multiple portfolios depending on the chosen categories.
En français
Modal Portfolio fonctionne en anglais et en français 
Modal Portfolio utilise le shortcode [modal-portfolio] (avec ou sans options) pour afficher des galeries d’images avec vidéo (optionnel), titre et description dans une modale. Beaucoup de paramètres sont disponibles pour optimiser l’affichage ainsi que des filtres d’affichage par catégorie.
La principale particularité de Modal Portfolio est de gérer plusieurs catégories de portfolio avec des shortcodes différents et personnalisables. Ainsi, vous pouvez avoir plusieurs portfolios selon les catégories choisies.

Modal Portfolio

Portfolio avec photos, description, titre et filtres en responsive avec de multiples options (responsive portfolio with images, description, title and filters (with multiple settings)

Flickr API vs Modal Portfolio