YOOtheme Pro
The YOOtheme Pro add-on controls the YOOtheme 5 builder: pages, templates, styles, library and backups. It requires YOOtheme Pro 5 to be installed and active; otherwise, its tools remain hidden.
Read tools require no special permissions. Each write tool follows the permissions of the relevant Joomla component — pages and their field bindings use com_content, while templates, settings and snapshots use com_templates — so a standard Administrator can manage YOOtheme without being a Super User. Every write is preceded by a snapshot, and destructive actions require confirmation.
Builder pages
Read and write an article builder layout, including dynamic field bindings.
| Tool | Function | Required permissions (ACL) |
|---|---|---|
get_yootheme_page | Read a builder page | None (read) |
set_yootheme_page | Write a builder page | core.edit on com_content |
create_yootheme_page | Create a builder page | core.create on com_content |
set_yootheme_field_binding | Bind an element to a field (source) | core.edit on com_content |
set_yootheme_repeatable_source | Repeatable source (collection / subform) | core.edit on com_content |
set_yootheme_composed_binding | Composed binding (if / otherwise) | core.edit on com_content |
set_yootheme_visibility_condition | Visibility conditions (Essentials) | core.edit on com_content |
Templates & styles
Manage layout templates and styles.
| Tool | Function | Required permissions (ACL) |
|---|---|---|
list_yootheme_templates | List templates | None (read) |
get_yootheme_template | Read a template | None (read) |
create_yootheme_template | Create a template | core.create on com_templates |
clone_yootheme_template | Duplicate a template | core.create on com_templates |
update_yootheme_template | Modify a template | core.edit on com_templates |
delete_yootheme_template | Delete a template | core.delete on com_templates |
reorder_yootheme_templates | Reorder templates | core.edit.state on com_templates |
list_yootheme_styles | List styles | None (read) |
Library & saved items
Two separate libraries are available. The YOOtheme library contains layouts and elements supplied by YOOtheme, which can be filtered by topic, type or originating site: the assistant can browse it, inspect a layout and import it into a page or template before adapting it to your content. Your personal library (“My Layouts”) contains the elements, sections and layouts you have saved: the assistant can add anything it has just built and reinsert any saved element into a page or template.
| Tool | Function | Required permissions (ACL) |
|---|---|---|
list_yootheme_library | Browse the YOOtheme library | None (read) |
get_yootheme_library_item | Inspect a library layout | None (read) |
import_yootheme_library_item | Import a library element | core.edit on com_content |
list_yootheme_saved | List your personal library | None (read) |
get_yootheme_saved | Read a saved element | None (read) |
save_yootheme_saved | Save an element | core.edit on com_content |
insert_yootheme_saved | Reinsert a saved element | core.edit on com_content |
delete_yootheme_saved | Delete a saved element | core.edit on com_content |
Settings & snapshots
Adjust YOOtheme settings and restore a previous version.
| Tool | Function | Required permissions (ACL) |
|---|---|---|
get_yootheme_settings | Read a style’s settings | core.edit on com_templates |
set_yootheme_settings | Write a style’s settings | core.edit on com_templates |
list_yootheme_snapshots | List template snapshots | core.edit on com_templates |
restore_yootheme_snapshot | Restore a template snapshot | core.edit on com_templates |
list_yootheme_style_snapshots | List style snapshots | core.edit on com_templates |
restore_yootheme_style_snapshot | Restore a style snapshot | core.edit on com_templates |
What you need to know
Recreating an existing page. If the page is on your site, the assistant reads its layout (sections, grids, elements and settings) and recreates or clones it in a new page or template. If the page is external, the assistant retrieves it from the web, analyses its structure and text, then rebuilds an equivalent page using the builder’s standard elements: sections, columns, headings, text, images, buttons and cards. The text is retained; images must be uploaded to the media library. This is not a pixel-perfect import but a reconstruction: the result is a clean page that can be edited later in the Customizer, rather than a fixed block of HTML.
Adopting a site’s style. A YOOtheme style is a set of design tokens (LESS variables: colours, typography, spacing and buttons), together with header, navbar and footer settings. The assistant can analyse a reference site and apply its colour palette, fonts and header style to your active style through the less and custom_less sections of the settings, with an automatic snapshot so you can roll back. It does not save the result as a new named entry in YOOtheme’s Styles panel: that step takes two clicks in the Customizer.
Security. Every write is preceded by a snapshot, and destructive actions require confirmation. The required permissions follow the Joomla ACL of the relevant component — com_content for pages and their bindings, and com_templates for templates, settings and snapshots — meaning that an Administrator is sufficient; no Super User account is required (see Security & permissions).
Prompt examples
“Import the ‘Hero’ template from the library and apply it to the home page.”
“Bind this section’s heading to the article’s ‘name’ field.”
“Look at this page and recreate its layout and content in a new page.”
“Find an e-commerce layout in the YOOtheme library, import it into the Shop page and replace the text with the following.”
“Save this section to my library under the name ‘Promo banner’.”
“Apply this site’s colour palette and fonts to my active style.”