Album Extension

Overview

The Album extension allows you to embed photos from specific Facebook albums into your site, displayed in a single column or grid format.

Below is an example of using the Album extension to display photos from an album.

Shortcode used above:

[custom-facebook-feed album=10153863906176919]

See the How to use tab above for directions on how to use the extension.

How to use

Installation

Extensions are installed just like any other WordPress plugin. You can follow the same process used when uploading and installing the Custom Facebook Feed Pro plugin.

Finding the Album ID

You can find the ID of a Facebook album from it’s URL. It is the set of numbers between the first two periods in the URL, as highlighted below:

https://www.facebook.com/media/set/?set=a.440612488444.242105.15087023444

Shortcode

The Album extension allows you to specify the ID of a Facebook album directly in the shortcode:

[custom-facebook-feed album=440612488444]

You can also set the number of columns in the photo grid by using the ‘albumcols’ shortcode option, and the number of photos to display using the ‘num’ option:

[custom-facebook-feed album=440612488444 albumcols=4 num=100]

Shortcode Options

Name Attribute Options Description Example
Album ID album Any album ID The ID of the Facebook album you want to display album=440612488444
Number of columns albumcols 1-4 The number of columns in the photo grid albumcols=2
Number of photos num Any number The number of photos to display num=50

Show newest photos first

To change the order of the photos you would need to manually reorder them inside the album on Facebook, by clicking the 3 dots in the corner and selecting “Edit album”. You can then drag and drop the photos in the album and click “Save”. If you then clear the cache on the plugin settings page then the plugin will update to reflect the order on Facebook.

Display captions on hover

When clicking on a photo the caption will be displayed in the pop-up lightbox, but you can also choose to display the caption when the photo is hovered/rolled over without opening the lightbox. Just add the following to the plugin’s Custom JavaScript section, which is under the Misc tab on the plugin’s Customize page:

$('.cff-album-cover').each(function(){
  $self = $(this);
  $self.find('.cff-photo-hover').html('<p style="color: #fff; width: 90%; padding: 5%;">' + $self.find('.cff-lightbox-link').attr('data-title') + '</p>');
});

Change Log

= 1.0.5 =
* Fix: Fixed a compatibility issue with the latest version of the Custom Facebook Feed Pro Plugin.

= 1.0.4 =
* New: Added a header which displays the album title, description, and meta data. This can be enabled/disabled using the plugin “Header” settings: Facebook Feed > Customize > General > Header.

= 1.0.3 =
* New: Now dispays full size images in the popup lightbox

= 1.0.2 =
* Tweak: Updated the plugin updater script to reduce requests on the WordPress Plugins page

= 1.0.1 =
* Added the caption to work with the Lightbox extension

= 1.0 =
* Launched the Album extension