Skip to main content

Source Methods

Oriel Pro supports two different source methods for displaying albums and images: Dynamic and static.

Static Source Mode

In static mode everything is as we know it from the various modules & components we've all already tried and used. Select the folder that contains your pictures / albums. Your module instance is permanently connected to this folder. If you want to show the images of another gallery in article x you have to create another module instance, adjust your settings.... etc. Or we use the:

Dynamic Source Mode

In dynamic mode we do not define the source folder within the module settings. We define the Customfield item that contains the source folder information. If the module is used in recurring layouts, several galleries can be created with one module.

Let's make an example:

We have to develop a website that lists different hotels, say 50 of them. Each of these hotels made an effort and sent us the most beautiful pictures of their suites, rooms, the reception area and the pool bar. For each of these hotels we have created folders and categorized the pictures into named subfolders.

  1. We create a new custom field of type Text (or nx-folderlist --> you get it for free when you buy Oriel Pro) and name this hotel pictures (Yes I know I am mega creative today)
  2. Now we create our module instance in Joomla - For this we navigate in the backend to Extensions-->Modules and create a new module of the type Oriel - the UIkit3 Gallery via the New button. In the settings of the module we choose as Source Method Dynamic and as Customfield our field hotel pictures from the dropdown.
    Please make sure that the module is published on all pages (second tab in the module settings).
  3. For each of these hotels we now create a Joomla article insert our texts and use Joomla's integrated Shortcode plugin for modules to place the Oriel Dynamic Gallery in the desired location (For some Editors like JCE there exists a button below the article edit textfield called "Module" to add those).
  4. In the field settings of our hotel, we now select as value for the custom field hotel pictures the corresponding folder with the images for this hotel on our server.
  5. If we now look at our article in the frontend we will see that Oriel Pro has built the gallery for us. If we have selected the Oriel Mode Filter, the subfolders of the gallery (suites, rooms, pool) are shown as filter options above the gallery.

* This tutorial will be extended with pictures soon