Ideal Grid – Documentation
Ideal Grid takes the full YOOtheme Pro grid and adds text on hover, badges and polished hover effects for portfolios, shops and team pages, without any CSS.
Requirements
- Joomla 4.4, 5 or 6, or WordPress 6.2 and later (see WordPress version)
- PHP 8.1 to 8.4
- YOOtheme Pro 4 or 5
Installation
- Download the ZIP from My licences or from the link in your order e-mail. Do not unzip it.
- In Joomla, open System › Install › Extensions and drop the ZIP into Upload Package File.
- Ideal Grid enables itself. There is nothing else to switch on.
A new version installs the same way, over the old one. Your content and settings are kept.
Licence key and updates
Your licence key (format IDPC-XXXX-XXXX-XXXX-XXXX) is in your order e-mail and on the My licences page. Paste it once per site:
- Open System › Update › Update Sites.
- Click Ideal Grid. Joomla shows “missing download key”.
- Paste the key into the Download Key field, then click Save & Close.
New versions then appear in System › Update › Extensions and install in one click. Updates and e-mail support are included for 12 months. After that, the extension keeps working with no time limit; only access to new versions stops. You can renew at any time from My licences.
On Joomla, the key does not go into the plugin settings or into YOOtheme. The same key works for all your IdealPC extensions.
WordPress version
Ideal Grid also works with the YOOtheme Pro theme on WordPress (WordPress 6.2 or later, PHP 8.1 or later). The element settings are the same as on Joomla, and the same licence key works for both versions.
- Download the “Ideal Grid (WordPress)” ZIP from My licences. Do not unzip it.
- In WordPress, open Plugins › Add New Plugin › Upload Plugin, choose the ZIP, then click “Install Now” and “Activate”.
- Open Settings › Ideal Grid and paste your licence key: every new version then appears under Plugins and installs in one click.
The element is in the YOOtheme Pro page builder, in the “IdealPC” group. The Settings › Ideal Grid page also shows the status of your licence and links to the documentation and support.
1. Add the element
In the YOOtheme Pro page builder, add the Ideal Grid element (group “IdealPC”). It has all the settings of the YOOtheme Grid element (columns per breakpoint, gaps, dividers, panel styles, image, title, meta, content and link options), plus two extra tabs: Hover (Ideal Grid) and Badges (Ideal Grid).
2. Items
Each item can have an image, a video or an icon, a title, meta text, content and a link, as in the YOOtheme grid. Ideal Grid adds:
- Hover title and hover content: shown over the image when the mouse moves over it.
- Hover image or hover video: replaces the image on hover.
- Badge and badge colour: a small label on the image, e.g. “New” or “-20%”.
- Tags: used by the filter navigation.
3. Hover effects
- Hover style: dark overlay, gradient to bottom, frosted glass (blur), primary colour, secondary colour or muted.
- Text position: centred, bottom left or bottom centre.
- Animation: fade, slide up from bottom or zoom.
- Always show the hover text on mobile: recommended, because touch screens have no hover.
4. Badges
Set the default badge colour, the position (top left, top right, bottom left, bottom right) and the shape (rounded, slightly rounded or corner ribbon) in the Badges tab. Each item can override the colour: primary, dark, light, success (green), warning (orange), danger (red) or Custom colour (since 1.6.1): pick any colour with the colour picker that appears just below. The same choice exists in Badge style for the default colour of the whole grid. With a light colour, the badge text automatically turns dark.
Automatic “New” badge (1.6)
In Settings › Badges, tick “New” badge: every item added or copied in the builder automatically gets its date added (a field you can see and change in the item) and shows a “New” badge for the number of days you choose (30 by default). After that, the badge goes away by itself.
- Badge text: leave empty for “New” in the language of the site (Nouveau, Neu, Nuovo…), or write your own text.
- Badge colour: primary, dark, light, success, warning, danger, or a custom colour.
- If the item already has a badge (for example “Sale”), both are shown, one below the other.
- For an existing item, just enter a date added (YYYY-MM-DD).

5. Filter, masonry, lightbox
These work as in the YOOtheme grid: enable the filter navigation and give each item one or more tags (comma-separated), enable masonry for images of different heights, and the lightbox for a gallery.
Open the grid on a tag 1.5
In Settings › Filter:
- Default tag: type the name of a tag, for example “Christmas”. The page opens directly on that tag, and visitors can still click the others. Upper and lower case don’t matter. Leave it empty to open “All” (or the first tag if “All” is hidden). If the tag doesn’t exist in the grid, nothing changes.
- Position of « All »: “Start (left)”, as before, or “End (right)” to put “All” after the tags. This setting appears when All Items is checked.
Handy for a seasonal shop: in December, set “Christmas” as the default tag and “All” at the end; the other collections stay one click away.

Tags in the builder 1.5
In the Content tab, the list of items shows each item’s tags, with one colour per tag: you spot your Christmas or Halloween items at a glance, even when several have the same title. Up to 3 tags are shown per item, then “+2” for example (hover it to see the others). This only changes the display in the builder: nothing changes on your site.

Languages
The settings are shown in the administrator’s language (English, French, German or Italian). Your content is shown as you enter it.
Multilingual site with Falang (1.7)
Ideal Grid is Falang compatible (Joomla and WordPress, with Falang for YOOtheme). In the builder, the grid and every item have a Falang tab with, for each language other than the default one, a copy of the text fields:
- Item: title, meta, content, link, link text, ARIA label, image alt text, hover title and text, badge, tags.
- Grid: “New” badge text, “All” label, default tag, link text, ARIA label.
A field left empty uses the text of the default language. Translate the tags the same way in every item, and the default tag of the grid with the same word, so that the filter works in every language. Without Falang, the tab is not shown and nothing changes; you can also create one grid per language page.
FAQ
- What is the difference with the YOOtheme Grid element?
- Ideal Grid includes everything the YOOtheme grid does and adds hover text, hover backgrounds and animations, and badges. See the comparison on the product page.
- Can I switch an existing YOOtheme grid to Ideal Grid?
- Add an Ideal Grid element next to it and recreate the items; the settings are the same, so it is quick.
- Does it work with dynamic content?
- Yes, like the YOOtheme grid, items can be linked to dynamic content sources.
Support
A question, a bug, an idea? Write to