Learn how to install, activate and configure InGallery for Joomla, create Instagram galleries from multiple sources, filter content, add call-to-action buttons, enable GDPR-Friendly Media Loading and publish galleries on your website.

Contents

📦 Installation

Log in to your Joomla Administrator and go to System > Install > Extensions. Upload and install the ingallery-package.zip package.

Important: Install the InGallery installation package located inside the main archive downloaded from AllForJoomla, not the main downloaded archive itself.

InGallery also uses the System - inGallery plugin. Current Joomla versions normally enable the plugin during installation, but some older Joomla versions may leave it disabled.

After installation, go to System > Manage > Plugins, find System - inGallery and make sure it is enabled.

🔑 License Activation

InGallery requires a valid License Key. Each purchased license has its own License Key, available in your AllForJoomla account.

  1. Go to Components > InGallery > Options.
  2. Open your AllForJoomla Orders page.
  3. Find your InGallery license and copy its License Key.
  4. Paste the key into the Premium License key field.
  5. Save the settings.

After activation, you can create and manage InGallery galleries from the Joomla Administrator.

Go to Components > InGallery to see your existing galleries.

Click New to create a gallery, or open an existing gallery to edit it. InGallery uses an integrated visual builder with an instant preview, so you can see the result while configuring the gallery.

No Instagram API key or Instagram App setup is required.

The visual builder is divided into four main sections:

  • Albums — Instagram sources, filters and album content;
  • Layout — gallery type, columns, rows, spacing and responsive behavior;
  • Display — thumbnails, popup, post information and CTA buttons;
  • Colors — gallery and interface colors.

Albums and Instagram Sources

Each gallery contains one or more albums. An album defines a group of Instagram content displayed together inside the gallery.

Enter an Album name and add one or more Instagram sources. Supported source types include:

  • @username — posts from an Instagram account;
  • #hashtag — posts associated with an Instagram hashtag;
  • Instagram post URL — an individual Instagram post.

Multiple sources can be combined within the same album. Add additional albums when you want to organize different groups of Instagram content inside one gallery.

Use Limit items to limit the number of media items displayed in the current album. Set the value to 0 to display all available items.

Filter Instagram Content

InGallery provides two types of content filters:

  • Only — display only content that matches the specified criteria;
  • Except — exclude content that matches the specified criteria.

Filters can contain any combination of:

  • @username
  • #hashtag
  • an Instagram post URL
  • the videos keyword

Separate multiple filter criteria with commas.

For example:

#travel, videos

When videos is used in the Only filter, only video posts matching the filter are displayed. When it is used in the Except filter, video posts are excluded.

Configure the Gallery Layout

Open the Layout section of the visual builder to control how Instagram photos and videos are arranged.

InGallery supports:

  • Grid
  • Masonry
  • Carousel

Depending on the selected layout, you can configure options such as columns, rows, gutter between items and mobile optimization.

Carousel galleries also support automatic scrolling. Larger galleries can use a Load More button or infinite scrolling to display additional media.

Configure Display Options

Open the Display section to control how gallery items and Instagram information are presented.

You can configure options including:

  • gallery display style;
  • album names;
  • likes counter;
  • comments counter;
  • publication date;
  • media description;
  • Instagram user information;
  • link to the Instagram profile;
  • comments;
  • video looping;
  • Load More button text.

These options can be used to create a minimal media-focused gallery or a more detailed Instagram feed with additional post information.

InGallery can open Instagram photos and videos in its built-in popup.

Use the popup settings to control the popup image size and which Instagram information is displayed together with the media.

Visitors can navigate between gallery items directly inside the popup without leaving your website.

Call-to-Action Buttons

InGallery lets you assign custom call-to-action buttons to individual Instagram posts.

In the Call to Action Buttons section, add a CTA and configure:

  • Post URL — the Instagram post that should display the CTA;
  • Button URL — the destination opened when the visitor clicks the button;
  • Button Label — the text displayed on the CTA button;
  • Button Position — the position of the button on the post media.

You can create multiple CTA rules and assign different buttons to different Instagram posts.

The CTA button is displayed directly on the selected post media in the popup. This can be used to link Instagram posts to product pages, services, downloads, portfolio pages or other relevant destinations.

Customize Gallery Colors

Open the Colors section to customize the appearance of the gallery.

Available color settings include gallery elements such as album buttons, Load More controls, thumbnail overlays, popup elements and CTA buttons.

Color settings are stored with the gallery, so different galleries can use different visual configurations.

🛡️ GDPR-Friendly Media Loading

InGallery supports GDPR-Friendly Media Loading for Instagram photos and videos.

With this mode enabled, Instagram media is downloaded and served from your own Joomla website instead of being requested directly from Instagram servers by the visitor's browser.

To enable it:

  1. Go to Components > InGallery > Options.
  2. Find the Pictures display mode setting.
  3. Select Download and display from this website server (GDPR-Friendly Media Loading).
  4. Save the settings.

Despite the legacy name of the Pictures display mode setting, GDPR-Friendly Media Loading in the current InGallery version applies to both Instagram photos and videos.

Learn more about GDPR-Friendly Media Loading for Joomla.

🔗 Display the Gallery with a Shortcode

After saving a gallery, go to Components > InGallery. The galleries list contains a Shortcode column with the shortcode assigned to each gallery.

For example:

[ingallery id="2"]

The gallery ID in your shortcode will depend on the gallery you created.

Copy the shortcode and paste it where you want the Instagram gallery to appear. You can use an InGallery shortcode in:

  • a Joomla article;
  • a Custom HTML module;
  • a Joomla template file.

Gallery configuration is managed centrally in InGallery. Changes made in the visual builder are therefore reflected wherever that gallery shortcode is used.

🧩 Template Overrides

If you need to modify the HTML structure of an InGallery gallery item, use a Joomla template override instead of editing the extension files directly.

Copy the required template file from:

/components/com_ingallery/views/tmpl/

to:

/templates/YOUR_TEMPLATE/html/com_ingallery/

Keep the original filename and modify the copied template inside your Joomla template.

Important: Do not modify InGallery core files directly. Changes made to extension files can be overwritten when InGallery is updated.

🌐 Translation

InGallery can be translated using Joomla Language Overrides or by creating complete translated language files.

Quick Translation with Joomla Language Overrides

Language Overrides are the easiest way to change individual InGallery words or phrases without modifying the extension language files.

  1. Go to System > Manage > Language Overrides.
  2. Select the language and location where you want to create the override.
  3. Click New.
  4. Enter the InGallery language constant into the Language Constant field.
  5. Enter your replacement text into the Text field.
  6. Save the override.

Examples of useful frontend language constants include:

  • COM_INGALLERY_UNFORTUNATELY_AN_ERROR_OC
  • COM_INGALLERY_SYTEM_ERROR_PLEASE_REFRES
  • COM_INGALLERY_YEAR
  • COM_INGALLERY_MONTH
  • COM_INGALLERY_WEEK
  • COM_INGALLERY_DAY
  • COM_INGALLERY_HOUR
  • COM_INGALLERY_MINUTE
  • COM_INGALLERY_SECOND
  • COM_INGALLERY_YEARS
  • COM_INGALLERY_MONTHS
  • COM_INGALLERY_WEEKS
  • COM_INGALLERY_DAYS
  • COM_INGALLERY_HOURS
  • COM_INGALLERY_MINUTES
  • COM_INGALLERY_SECONDS
  • COM_INGALLERY_YEARS2
  • COM_INGALLERY_MONTHS2
  • COM_INGALLERY_WEEKS2
  • COM_INGALLERY_DAYS2
  • COM_INGALLERY_HOURS2
  • COM_INGALLERY_MINUTES2
  • COM_INGALLERY_SECONDS2
  • COM_INGALLERY_AGO
  • COM_INGALLERY_JAN
  • COM_INGALLERY_FEB
  • COM_INGALLERY_MAR
  • COM_INGALLERY_APR
  • COM_INGALLERY_MAY
  • COM_INGALLERY_JUN
  • COM_INGALLERY_JUL
  • COM_INGALLERY_AUG
  • COM_INGALLERY_SEP
  • COM_INGALLERY_OCT
  • COM_INGALLERY_NOV
  • COM_INGALLERY_DEC

Full Extension Translation

For a complete InGallery translation, use the English language files included with the extension:

  • en-GB.com_ingallery.ini
  • en-GB.com_ingallery.sys.ini

For example, to create a German translation:

  1. Copy en-GB.com_ingallery.ini and rename it to de-DE.com_ingallery.ini.
  2. Copy en-GB.com_ingallery.sys.ini and rename it to de-DE.com_ingallery.sys.ini.
  3. Translate the text values in both files. Do not change the language constant names on the left side of the = sign.
  4. Save the files as UTF-8.
  5. Place them in the Joomla 6 language folder:
/administrator/language/de-DE/

The resulting files should be:

/administrator/language/de-DE/de-DE.com_ingallery.ini
/administrator/language/de-DE/de-DE.com_ingallery.sys.ini

Replace de-DE with the language tag of the language you are translating InGallery into.

🛠️ Troubleshooting

The shortcode is displayed as text instead of the gallery

Go to System > Manage > Plugins and make sure the System - inGallery plugin is enabled.

The gallery is empty

Open the gallery in Components > InGallery and make sure every album has a name and at least one valid Instagram source.

Also check any Only and Except filters that may prevent content from being displayed.

A specific Instagram post does not appear

Check the Instagram post URL used as a source or filter and make sure it points to the intended public Instagram post.

A CTA button is not displayed

Check that the Post URL in the CTA rule matches the Instagram post, that the Button URL and Button Label are filled in, and that the gallery is configured to open posts in the popup.

Instagram media is still loaded directly from Instagram

Go to Components > InGallery > Options and verify that Download and display from this website server (GDPR-Friendly Media Loading) is selected.

InGallery reports that it is not activated

Open Components > InGallery > Options and verify that the correct License Key from your AllForJoomla Orders page is entered into the Premium License key field.