Help » Aesop Gallery Pop

Aesop Gallery Pop will display the first image from the gallery in your post. When users click this image, the gallery of photos open in a lightbox. If you want to change what image appears in the post that users click, simply drag/drop and rearrange the gallery to place whatever image you’d like first.

Titles, ALT tags, and captions are all displayed. These can be edited in the gallery creation process below. Simply click an image while in the media modal to edit it’s title, ALT, and caption.

Aesop Gallery Pop works out of the box with no additional styles and is compatible with all WordPress themes, so long as Aesop Story Engine is activated.

Creating Galleries

  • Locate the Galleries tab on your left in WordPress admin, and click "Add New Gallery." Give the gallery a title, then proceed to the next step below to start adding gallery information.

  • Give the gallery a title. This is never displayed, it's only for reference. Then, click the "Add Images" button.

  • Choose your images, and select the Gallery Pop layout. Now you can publish your gallery.

  • Once published, go to your story, open the generator, select Gallery Pop, and choose the gallery you'd like to be displayed.

Filters

The registered image size is 1024. You can adjust this registered image size by filtering and passing an integer. Warning, you will need to force regenerate all thumbnails if you modify the size of the image.
agp_image_size

The size of the image that’s clicked that opens the gallery modal. Note, this is not in “pixels.” This should be a string that’s passed denoting the size of the image in WordPress. The default is “large”
agp_trigger_image_size

The icon used on the trigger image. By default it’s an icon of a stack of images by Dashicons. Pass html markup here.
agp_image_icon

The markup used for the caption template.
agp_caption_template

Actions

All actions pass one variable, the unique identifier for the specific gallery.

agp_before_trigger
agp_inside_top_trigger
agp_inside_bottom_trigger
agp_after_trigger

agp_inside_top_gallery
agp_inside_bottom_gallery
agp_after_gallery

Here’s an example of adding something to the first gallery listed on the post with id 1200.

  1. add_action("agp_before_trigger", "my_insert_something", 10, 1);
  2. function my_insert_something( $unique ) {
  3. if ( "1200-1" == $unique ) {
  4. echo "Hi";
  5. }
  6. }
add_action("agp_before_trigger", "my_insert_something", 10, 1);
function my_insert_something( $unique ) {
if ( "1200-1" == $unique ) {
echo "Hi";
}
}