This plugin allows you to create, edit and display photos arranged in albums.

Managing content

There are 2 types of content in Photoalbums plugin: albums and photos. An album can have a title, slug, description and multiple photos related to it. A photo can have an optional title, description and an attached image file.

You can create, edit or delete new albums and photos from Photoalbums backend menu item. You can create an album by using the "New album" button in the sidebar, you can edit or delete an album using albums list ("Albums" button in the sidebar).

Uploading photos to albums

There are 3 ways to upload photos to an album:

• You can add single photo using "New photo" button in the sidebar.
• You can add single photo using relations manager at the bottom of album update form.
• Or you can add multiple photos at once using "Upload photos" button in the sidebar.

When uploading multiple photos you can provide an optional title for each photo.

Album front

In the relations manager in album edit form you can set an album front (cover) photo. Front photo will be passed to Albums List component as a thumbnail for this album. To select front photo for an album. check this photo in the manager and click on "Set as front" button.

If no front photo is set, the last one in album photos list will be used.

Reordering

You can change the order of displaying album's photos by clicking on "Reorder photos" button in album edit form. Just drag photos up and down, the form is saved automatically.

Displaying content

There are 4 components declared in this plugin:

• Albums List component to display a list of existing albums with titles, thumbs, photos count and pagination support.
• Album component to display album photos with titles, thumbs and pagination support.
• Photo component to display a single photo with mini-pager with links to previous and next photos.
• Random Photos component to display some randomly selected photos.

See Documentation section for more details on these components.

Insert photos from galleries

Dialog to insert photos into Blog posts

You can insert photos from galleries created by this plugin into Blog posts. Just click on a camera icon near media manager in the post markdown editor, then select album and photo. Markdown code for selected photo will appear in the editor.

Markdown syntax

To change the code template, go to Settings -> Photo Albums tab. The syntax is explained below and you can use %id% and %title% placeholders for photo id and title. You can use placeholders multiple times. For example, you can type in template like this:

[![%title%]([photo:%id%:640:480:crop]){.img-responsive}]([photo:%id%] "%title%"){.magnific}

It will result in image 640x480 cropped thumb with title and img-responsive class, linked to full-size image with title and magnific class. Note that you can't use quote symbol in the template, you have to replace quotes with ".

The syntax for [photo] part is as follows:

[photo:id:width:height:mode]

Here:

• id is a photo model id (you can get it from url).
• width and height are optional, if they are provided, photo will be inserted as a thumbnail with these width and height.
• mode is an optional mode for thumbnail generation, possible values are: auto, exact, portrait, landscape, crop (see October thumbs generation for more info). Defaults to auto.

For example:

• [photo:123:640:480:crop] for cropped thumbnail 640x480 of photo with id 123
• [photo:123:200:200] for thumbnail 200x200 of photo with id 123
• [photo:123] for image as is, no thumb

The placeholder will be replaced with path to image (or thumb), for example: /storage/app/uploads/public/57a/24e/bff/thumb_301_640x480_0_0_auto.jpg.

You can use this code to insert photos in any markdown-processed text.

Note that to avoid possible conflicts, placeholders are only replaced inside src and href attributes. So if you add placeholder into href attribute of anchor tag or into src attribute of IMG tag (or into Markdown link or image), it will be replaced. And if you add it into plain text, it will be ignored and displayed as a text.

Searching

Searching for albums and photos content is supported through OFFLINE.SiteSearch plugin.

The following themes use this plugin

$24

Vermillion

26 projects

# 11 in Paid of all time.

$24

Vermillion

Ultimate Responsive Company Profile Theme

Blogging, Corporate

$16

Yell-Ow!

8 projects

# 25 in Paid of all time.

$16

Yell-Ow!

Yell-Ow! - Ultimate Company Profile

Blogging, Portfolio website