Photos

Photonic supports the following types of photo displays:

  • Individual photos
  • Photo searches by text
  • Photo searches by category
  • Popular photos
  • Recent photos

To display any of the above, the following parameters are mandatory:

  • type="zenfolio"
  • view="photos"

Individual Photos (🔗)

To display an individual photo, the following is the syntax:

[gallery type='zenfolio' view='photos' object_id='...']

The object_id above is the id of your photo. How do you know what that is? Go to a photo in Zenfolio, say http://sayontan.zenfolio.com/p619593020/hbdc51cf#hbdc51cf in the front-end, or . The underlined part is your id. Bear in mind that older photos in Zenfolio used to be prefixed with “h”, while newer photos are prefixed with “p”. With effect from version 2.00 you are able use the “Add / Edit Photonic Gallery” button to insert your gallery to add single photos.

If the photo has a title, then that is displayed as a header for the photo, and if it has a caption/description, that is displayed as a caption.

Photo Searches by Text (🔗)

To search for a photo by text, simply pass the text parameter to it:

[gallery type='zenfolio' view='photos' text='wildlife']

The results are sorted by date, the most recent showing first. You could alternatively specify an explicit sort_order parameter, which can take the values Popularity, Rank or Date.

The following shortcode fetches the 10 most popular wildlife photos with 5 thumbnails per row:

[gallery type='zenfolio' view='photos' text='wildlife' sort_order='Popularity' limit=10 columns=5]

In the above, limit=10 indicates that you want to pull 10 photos instead of the default 20.

Photo Searches by Category (🔗)

To search for a photo by category, pass the category_code parameter to it:

[gallery type='zenfolio' view='photos' category_code='...']

How do you get the category_code? You can go to Photonic → Helpers → Zenfolio → Zenfolio Categories, and list out all the available categories. Pick the one that you need. With effect from version 2.00 you will not require the “Helpers” if you use the “Add / Edit Photonic Gallery” button to insert your gallery.

The following gets the most popular photos in the category “Portraits” (category code 3012000):

[gallery type='zenfolio' view='photos' category_code='3012000' sort_order='Popularity']

For category-based searches you cannot specify Rank in your sort order – Popularity and Date are the only available options.

To display the most popular photos or the most recent photos, use the kind parameter and pass to it the values popular or recent. So:

[gallery type='zenfolio' view='photos' kind='recent']

I am not showing a working example of photos from the above because of the adult nature of some photos.

Miscellaneous Parameters (🔗)

The following miscellaneous parameters can be used whenever multiple results are going to be returned:

  • limit – Shows a certain number of results. The default is 20.
  • columns – Number of thumbnails per row. The default is auto, so the plugin tries to arrange thumbnails one after another till a row is full.
  • thumb_size – This is the size of displayed thumbnails. This can take the following values:
    • 0 – Small thumbnail, upto 80 × 80px
    • 1 – Square thumbnail, 60 × 60px, cropped square
    • 10 – Medium thumbnail, upto 120 × 120px
    • 11 – Large thumbnail, upto 120 × 120px
    • 2 – Small image, upto 400 × 400px

“Show More” and Paged Results (🔗)

If a search result has a lot of photos and you want to reduce the count, Photonic offers a couple of approaches:

  1. For Zenfolio, use the limit attribute documented above, and add an additional tag, more. This will initially show you the number of photos specified in limit, and a button to load more images. Upon clicking the button you will see an additional set of photos as limited by count. The button will continue to show until you have exhausted the entire set of photos.
  2. Photonic can be used in conjunction with <!-- nextpage --> to display photos in a paged manner. For this you can structure your page content thus in the WP Editor: 
    
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nunc porta enim vel tellus dignissim, a venenatis neque congue. Nunc ornare cursus leo ac viverra. Pellentesque suscipit pulvinar metus, non aliquam odio egestas quis. Vestibulum porta viverra magna, vel malesuada ante fermentum vitae.
[gallery type='zenfolio' view='photos' text='wildlife' sort_order='Popularity' limit=25 offset=0]
<!-- nextpage -->
[gallery type='zenfolio' view='photos' text='wildlife' sort_order='Popularity' limit=25 offset=25]
<!-- nextpage -->
[gallery type='zenfolio' view='photos' text='wildlife' sort_order='Popularity' limit=25 offset=50]

    WP interprets <!-- nextpage --> as a page-break and automatically pages the content for you. This works for posts only, not pages, since <!-- nextpage --> doesn’t work on pages.

Here is an example using the first approach. The text you provide to the more parameter controls what is shown in the button:

[gallery type='zenfolio' view='photos' text='wildlife' sort_order='Popularity' limit=10 more='Show More']

Deferred Loading, a.k.a. “Show Gallery” (🔗)

In the examples above you see a button that says Show Gallery. This is a feature that ensures that Photonic doesn’t make the call to your photo source when your page is first loaded. It instead defers the call to your photo source until it the button is explicitly clicked by your end user. Using this button ensures that your page loads quickly the first time.

This button is created by adding the shortcode attribute show_gallery="Click to see gallery". You can replace “Click to see gallery” with the text of your choice.