Easy Photo Gallery

Introduction

Easy Photo Gallery is a Joomla plugin that allows you to create customizable photo galleries in your Joomla content with various options for image display, sorting, and styling. This documentation covers the installation, configuration, and usage of the Easy Photo Gallery plugin.

Installation

Downloading the Extension

Email: After you purchase the extension from our store, you will receive an email containing a link to download the extension.

Store: Alternatively, you can download the extension from the "Downloads" section in our store. If you are a new user, you need to create an account using the same email address you used for the purchase.

Click to download the extension package: EasyPhotoGallery_UNZIP.zip

Unzipping the Package

Use any file unzipper tool or WinRAR to unzip the EasyPhotoGallery_UNZIP.zip package. After unzipping, you will find the following contents:

• plg_photo_gallery_X.x.zip: This is the installation file compatible with Joomla 3.x and Joomla 4.x.
• ReadMe.txt: Contains vital information about the current version of the extension.

Installing the Extension

To install the extension, log in to the backend of your Joomla website.

• For Joomla 3 & 4: Navigate to Extensions > Install, then click on the "Upload Package File" tab. Click "Browse" to select the appropriate installation file (plg_photo_gallery_X.x.zip), then click "Upload and Install."

A success message will be displayed once the installation is complete.

Configuration

After installation, the plugin needs to be configured to suit your requirements. Access the plugin settings by navigating to Extensions > Plugins, and find Content - Easy Photo Gallery in the list.

Gallery Settings

• Show Images: Select whether to show images randomly or sequentially.
  • Options: Random, Sequence
• Sort Images By: Select the order on the basis of which you want to sort the images.
  • Options: Ascending (A-Z, 0-9), Descending (Z-A, 9-0)

Thumbnail Settings

• Thumbnail Alignment: Select the alignment of the thumbnail.
  • Options: Left, Right, Center, Justify
  Once configured, you can use the Easy Photo Gallery plugin to create photo galleries in your Joomla content.
• Border Width: Enter the width of the thumbnail border.
• Border Radius: Enter the border radius of the thumbnail.
• Thumbnail Border Color: Enter the hexadecimal color code for the thumbnail border.
• Shadow of Thumbnail: Enter the shadow value of the thumbnail (between 0 and 1).

Caption Settings

• Select Title Font: Select your desired title font family.
• User-defined Title Font: If 'Select Title Font' is set to user defined, enter the font you would like to use.
• Title Background Color: Enter the hexadecimal color code for the title background.
• Title Color: Enter the hexadecimal color code for the title.
• Title Font Size: Enter the size of the title text (in pixels).
• Title Alignment: Select the alignment of the title.
  • Options: Left, Right, Center, Justify

How to Use the Plugin Grabbing Images from a Folder To display images from a specific folder, use the following syntax within your article:

Syntax:

{photogallery folder="FOLDER_PATH" thumbwidth="150"}{/photogallery}

Example:

 {photogallery folder="images/woo" thumbwidth="150"}{/photogallery}

Grabbing Images Individually with Captions or Titles

To display individual images with associated captions or titles, use the following syntax within your article:

Syntax:

{photogallery image="PATH 1,PATH 2,PATH 3" title="Caption 1, Caption 2, Caption 3" thumbwidth="THUMB_WIDTH"}{/photogallery}


Example:

{photogallery image="images/woo/1.jpg,images/woo/2.jpg,images/woo/3.jpg" title="Caption 1, Caption 2, Caption 3" thumbwidth="200"}{/photogallery}


Features

• Customizable Galleries: Add various options for image display, sorting, and styling.
• Flexible Image Source: Fetch images from a specified folder.
• Thumbnail Settings: Customize the alignment, border, radius, color, and shadow of thumbnails.
• Caption Settings: Choose from various fonts, colors, and alignments for image captions.

FAQ

• How do I change the order of images?

  • Adjust the Sort Images By option under Gallery Settings.

• Can I use images from a specific folder?

  • Yes, specify the path in the {photogallery} syntax.

• How do I customize the thumbnail appearance?

  • Configure the Thumbnail Settings for alignment, border, radius, color, and shadow.

• Can I customize the caption appearance?

  • Yes, configure the Caption Settings for font, color, size, and alignment.

Troubleshooting

• Images Not Displaying: Ensure the paths are correct and the images exist in the specified locations.
• Incorrect Position: Verify the Thumbnail Alignment setting and ensure it is correctly set.
• Styling Issues: Check the Caption Settings and other configurations for conflicts.