All you need to know about modules and positions in YOOtheme Pro – from controlling their appearance and style to using the page builder above and below the main content.
The Joomla Module Manager is seamlessly integrated into YOOtheme Pro. Modules can be added, edited and deleted directly in the Modules panels without leaving YOOtheme Pro. There are several module positions that can be used to create all kinds of complex layouts.
The Modules panel shows a list of all module positions and their assigned modules. A gray dot next to a module indicates that this module is published on the page shown in the live preview. Hovering a module in the sidebar highlights its representation in the live preview with a blue border. An option to only display modules in the sidebar that are published and visible on the specific page is also available.
To edit a module, simply click on it. A modal with the Edit Modules view from Joomla will open. Here you can change the module's title, content and its options. YOOtheme Pro adds an additional Template tab containing a number of options to control the appearance and style of the module. A Delete button is also available in the upper right corner of the modal.
In the Modules panel, scroll down to the bottom and click the New Module button to create a new module. A modal with the New Module view from Joomla will open. Alternatively, add a module in the Joomla module manager.
For a more detailed information about modules, refer to the Joomla documentation.
YOOtheme Pro comes with 8 available module positions where any number of modules can be published. Positions which are empty as well as published modules with no content output will automatically collapse, and the layout will adapt accordingly.
||These positions are located above the theme header. Find the toolbar settings in Layout → Site.|
||These positions can be used instead of the logo set in the Layout → Site settings.|
||These are the theme header positions. Find the header and navbar settings in Layout → Header.|
||This position allows publishing modules in the mobile navigation, i.e. the off-canvas, modal or dropdown menu. Find the mobile header settings in Layout → Mobile.|
||This position allows publishing modules next to the main system output, e.g. a blog or a shop but not pages built with the YOOtheme Pro page builder. Find the sidebar settings in Layout → Sidebar.|
||These positions allow publishing modules above and below the main system output, e.g. a blog, a shop or a static page. Find the top and bottom settings in Layout → Top and in Layout → Bottom.|
||These positions are reserved for the Position element in the YOOtheme Pro page builder. They are not rendered anywhere else in the theme.|
Instead of using the menu positions, you still can publish a menu module in the Navbar or Mobile module position.
header positions are perfect for publishing a single line of text, a search, a language switcher, a shopping cart, different menus or social icons in the header of your website. Multiple modules are displayed next to each other in a row.
YOOtheme Pro offers an easy way to add all required standard logos to your site. For advanced use cases, for example when displaying different logos on different pages or for different languages, use the
sidebar position is not rendered on static pages built with the YOOtheme Pro page builder, even if a module is published in the sidebar. This is because the page builder allows building full-width sections where the sidebar needs to be placed within the layout of these sections. This can be done using the Position element in the page builder. Each Position element has its own settings. This allows you to have separate sidebar layouts on different pages. Modules published in the
sidebar position will stack above each other.
The mobile position is only shown if the mobile header layout is enabled. It will show up in the modal, dropdown and offanvas modes when you click on the menu toggle. All modules published in the mobile module position will be stacked above each other under the mobile menu.
Modules published in the
bottom position are displayed in a horizontal grid. By default, the modules fill up the available space evenly. For example, when publishing two modules, each of them will automatically use 50% of the available space. It's possible to create complex module layouts. Just set a different width for each module using the Width option in the module's settings. The breakpoint from which modules will stack above each other is set for medium device font-size, like tablets.
Important Publishing modules directly in the
bottom position may suffice for simple use cases. Using a Builder Module instead will offer advanced possibilities and allow you to create more complex module layouts.
There are six
builder-6 positions which are not rendered anywhere else in the theme. They are reserved to be used by the Position element from the page builder.
YOOtheme Pro adds a Template tab to the Joomla module settings with additional options. The availability of certain settings depends on the position where the module is published and its type.
Note Mind that the following settings are ignored if the module is published using the YOOtheme Pro module element. This is because these settings are available in the element itself.
Use this default option to style your modules published in any position.
|Visibility||Display the module only on a specific device width and larger.|
Use these appearance settings to style your modules published in the
|Style||Define whether the module looks like a card or whether the style is blank.|
|Title Style||Title styles differ in font-size but may also come with a predefined color, size and font.|
|Title Decoration||Decorate the title with a divider, bullet or a line that is vertically centered to the heading.|
|Alignment||Center, left or right align the text.|
|Alignment Breakpoint||Define the device width starting from which the alignment will apply.|
|Alignment Fallback||Define an alignment fallback for device widths below the breakpoint.|
Use these grid settings to style your modules published in the
|Width||Set the width of the grid column that contains the module in percent or choose Expand to fill up the available space evenly.|
|Max Width||Set the module's maximum width.|
|Max Width Alignment||Define the module's alignment if the grid column is larger than its max-width.|
Use these settings to style your list modules published in
Joomla offers the following list modules: Articles - Archived, Articles - Categories, Articles - Latest, Articles - Most Read, Tags - Popular, Tags - Similar.
|List Style||Select whether the list items should be separated with dividers or not.|
|Link Style||Use the default link color or the muted color.|
Use these settings to style your menu modules.
|Menu Style||Select whether the menu should be rendered as a horizontal subnav, a sidebar nav, or iconnav. The Default style depends on the position the module is published.|
|Menu Dividers||Show dividers between menu items.|
In Joomla you can assign modules to specific pages. For more advanced options, we recommend installing a free extension from Regular Labs called Advanced Module Manager. It changes your Menu Assignments tab in the module settings to Assignments and provides more advanced settings to show modules on specific pages. The extension needs to be installed and activated in the Joomla extension manager.
Use the builder module to create sophisticated layouts with the YOOtheme Pro page builder above and below the main content. The builder module is a regular Joomla module. Publish it only in the
bottom module position. Otherwise, it will not be rendered, and an error message will appear. This is because the page builder is designed to create layouts that can take up the full width of the viewport which is not possible for positions like the sidebar.
Note The layout settings in Layout → Top and Layout → Bottom are ignored by the builder module because it allows you to create multiple sections which each has its own settings.
Editing the builder module in the Joomla module manager, click the Open Builder button to access the Modules panel.
The YOOtheme builder module is especially powerful in combination with the module and position elements from the YOOtheme Pro element library. Both elements collapse if they have no content output, and the layout adapts accordingly. This gives you a lot of possibilities to create advanced layouts above and below the main content. Read more in the collapsing layouts documentation.