If your site uses a YOOtheme Pro template, Price List PRO adds itself as a data source in the YOOtheme Builder. No setup is required, it's detected automatically once both are installed.

Two ways to use it

1. Restyle the built-in pages with the Customizer

Open YOOtheme's Customizer and choose a template for the Price List product, category, categories or multiple view, exactly like you would customize a Joomla article or category template. You design the layout visually with the Builder, using the item's own data.

2. Add a price list to any page

In the Builder, add the Joomill Price List Table element (search for "Price List" in the element picker). It renders as a table with a row per item, and comes with the same style options as YOOtheme's other table-based elements: table style, column widths, title/meta/text styles, image and link button.

Set the element's Source to one of the Price List data sources, then bind each column of the child Item element to a product field via the dynamic content picker.

Available data sources

• Products: the products of the category currently being viewed. Only works on a category page.
• Custom Products Query: an independent list you filter yourself: by category (one or more), featured only, order by (default order, name, price or date added), direction, and a start/limit for pagination.
• Custom Categories Query: a filtered list of categories, for example to build your own category overview.
• Category → Products: nested under a category source, useful for grouping products per category yourself.

Available product fields

ID, Name, Description, Price, Category ID, Featured (0/1), Language, Start publishing, Finish publishing, and Link to product. Category sources expose ID, Title, Alias, Description and Link to category.

Products don't have a native image field. If you want an image per item, add a Media custom field on Components > Price List > Fields, see "Custom Fields", it becomes available as a bindable field automatically, alongside any other custom field you've added.

Example: a category overview with product tables

This example builds a page that lists every category with its own table of products underneath, using only Builder elements, no coding required.

1. Add a Section element to the page.
2. Open the section's Dynamic Content settings and set the source to Custom Categories Query. The section now repeats once for every category that matches your filters.
3. Inside the section, add a Title element and bind it to the category's Title field, then add a Description element underneath and bind it to the category's Description field. Each repeated section now shows its own category name and description.
4. Below the title and description, add the Joomill Price List Table element. Open its Dynamic Content settings, set Parent to Section, the type to Multiple Items, and the source to Products. Because the table's parent is the section that's already showing one category at a time, it automatically lists that category's products, you don't pick a category yourself here.
5. In the table's Item element, bind the content fields: Title to the product's Name, Text 1 to the product's Description, and Text 2 to the product's Price.

Save and preview the page. Every category now shows its own heading, description, and a table of its products underneath.

What visitors see

These sources follow the exact same visibility rules as the rest of the site: a product only appears if it's published, its scheduled publishing dates (if any) are active, and both the product's and its category's access level allow the current visitor to see it. There's nothing extra to configure, if an item is hidden here, check the same things as in "Troubleshooting & FAQ".