Skip to main content

8.2 - Placing an Opus block inside an article

Since Opus 1.5.600, an editor button places an Opus block straight into an article, without going through the module list.

What you need

The Opus package (1.5.600 or later) and Joomla 6.2 or later. The button comes from the Button - Opus plugin, installed and enabled by the package. It appears in the TinyMCE editor, in the administration and on the site. With the JCE editor, the button works too; the card described below stays a TinyMCE feature.

Placing a block

  1. Put the cursor where you want the block in the article.
  2. Click the Opus: place a block button. The Place an Opus block panel opens, with three tabs.
  3. Layout: complete layouts, with sample texts.
  4. Element: one element at a time (title, image, table, agenda...).
  5. Reuse: your existing Opus modules, sorted into "In this article" and "Other Opus modules". Each one is marked Place or Placed.
  6. A click on a layout or an element opens a new module in a large window, already filled with examples. Give it a title (required: the field is empty, with a grey example), change what you like, then click Save & Close. The block is placed at the cursor.

In the article, the block is written as {loadmoduleid N}. It is replaced by the module when the page is displayed.

The card in the editor

In the editor, the block shows as a card with its controls:

  • the handle: drag it to move the block;
  • the + buttons, above and below: they add a paragraph so you can write next to the block;
  • the arrows: they move the block up and down. On the keyboard: Alt+Shift+arrow;
  • the wheel (Edit): reopens the module in the large window;
  • the eye (Preview): shows the block at the exact width of the article column;
  • the minus (Remove): takes the block out of the article.

Removing a block

Remove opens the "What to do with the module?" window. Two choices:

  • Keep it: the module stays in the module list, so you can reuse it elsewhere;
  • Move it to the trash: the module goes to the Joomla trash when the article is saved. Ctrl+Z undoes it. If the same module is placed in another article, it is kept.

Opus never deletes a module permanently. To do that, empty the module trash yourself.

Finding the module again

In Content → Site Modules, the placed module carries a note such as "Article 3, "Title"" and its position is opus-article-3 (the number is the article's). The System - Opus plugin writes both. This way the module does not show up somewhere else on the site by mistake.

Site search

The System - Opus plugin also lets Joomla's Smart Search read the text of the blocks: an article that places Opus blocks is found by their words. The page display does not change. After updating Opus, run the indexing once in Components → Smart Search.

On the site

The button also works when you edit an article from the site (chapter 8). The plugin creates the module and opens the site form. If you close without saving a brand-new module, it is removed.

Up to date for Opus 1.5.930.