Skip to main content

9.5 - Placing a gallery inside an article

Details
Manual

A gallery in the middle of an article, a galleries module under a paragraph: from Iris 3.0.062, the Iris - Galleries editor button places them for you, without leaving the article.

What you need

  • Iris 3.0.062 or newer: the panel, the card and the placed galleries. Layouts and modules come with 3.0.063.
  • Joomla's TinyMCE editor, installed by default, and the Button - Iris plugin, enabled by the package.

The button

In the editor toolbar, click Iris - Galleries. A panel opens on the right, titled Iris: place a gallery. It has three tabs: Layout, Galleries and Reuse.

What you place goes where the cursor is. Click in the text first, at the spot you want.

The tab lists the published galleries, in two groups: In this article and Other galleries. Each row shows a thumbnail, the gallery's name and its number of media. Three buttons:

  • Place: the gallery is inserted in the article. If it is already there, the button becomes Update and replaces the gallery present with the current version.
  • Preview: the gallery as the site displays it, with your template's style, at the real width of an article column. If that width could not be measured, the preview takes the window's width and says so.
  • Edit: opens the gallery in a large window. An Insert in the article (or Update in the article) button brings the result back into the text and closes the window. The close cross does the same, and releases the gallery. When you come back from Edit, if the gallery has changed, the article's copy is updated straight away.

The New gallery button, at the top of the tab, opens the same large window on an empty gallery: fill it in, then insert it.

Only published galleries are offered. A gallery placed and then unpublished stays in the article, marked with a warning: it will not show on the site.

Layout: a new Iris Galleries module

This tab shows the 15 layouts of the Iris Galleries module, in two groups: Images and Documents. They are the same thumbnails as in the module.

  1. Click the layout you want. A new module opens in a large window, on the Settings tab, with the layout already set.
  2. Choose the gallery to show. The title is empty: the grey text is only an example.
  3. Click Save & Close.

Iris publishes the module on all pages and places it in the article. If you close the window with the cross, nothing is created and nothing is placed.

Reuse: a module that already exists

This tab lists the site's Iris Galleries modules, in two groups: In this article and Other Iris Galleries modules. Place inserts the chosen module without creating a new one. The button becomes Placed when it is already in the article. An unpublished module is marked.

The card, in the editor

In the text, a gallery or a module appears as a card: the name, the number of media, and at most eight thumbnails for the drawing. The card dresses the placed element, it does not replace it.

  • The handle, at the head of the card: grab the card and drop it elsewhere in the article.
  • The plus, above and below: places another gallery against the card.
  • The arrows: move the card up or down. On the keyboard, Alt + Shift + Up arrow or Down arrow.
  • The gear: opens the gallery (or the module) in the large window.
  • The eye: the preview, with your template's CSS.
  • The minus: removes the card from the article.

Ctrl+Z undoes a placing, a move or a removal.

Removing a gallery opens an alert window: Remove "..." from the article? The gallery stays in Iris, with its images: it only leaves this article. Nothing is saved before the article is.

Removing a module asks one more question: What should happen to the module?

  • Keep it: the module is not deleted. It stays in the Reuse tab.
  • Delete it: the module goes to the module trash. This choice is offered only if the module is placed nowhere else and you have the right to do it.

If the module is also placed in another article, Iris says so and keeps it. The trash applies when the article is saved. Without saving, or with Ctrl+Z, the module is left alone.

What Iris writes in the article

  • A gallery is placed as real HTML: the copy stays readable, even without Iris. The card exists only in the editor, it is never saved with the text.
  • A module is placed with Joomla's own tag, {loadmoduleid 152} (the number is the module's number), which Joomla replaces with the module when the page is displayed.

What is placed stays up to date: a gallery or a module is edited in Iris, and the article follows. For a gallery placed as a copy, use Update.

What does not exist yet

The button is offered only in the administrator, not in the site's edit form. And a placed module does not yet get a note or a position of its own in the article, as Opus does.

Up to date for Iris 3.0.066.

Send by email

Use Iris

Need help?