Webal Phoca Category shows your Phoca Cart categories as a list that folds, as tiles with pictures, or as a row you scroll. The names, pictures, links and product counts come from Phoca Cart, so the list always agrees with your shop.
Use it in a side column or above the products, so that visitors can move around your shop. It works with scripts switched off. The category that the visitor is looking at is marked.
This module is part of Webal Phoca Blocks, which needs Phoca Cart 6 or later.
Tip. A category is a group of products in Phoca Cart, such as Shoes. A sub-category is a category inside another one, such as Boots inside Shoes. A tree is a list with the sub-categories tucked inside their category.
The three looks
- A tree. A list of categories. A category that has sub-categories has a small arrow button. Press it to open or fold the sub-categories. The branch the visitor is in starts open.
- Tiles. A grid. Each tile is one link with the category picture above its name.
- A row you scroll. The same tiles in one row. There are arrows and dots to move along it, and a Pause button if you switch on auto play.
Tiles and the scrolling row show the top level only. The tree can go down as far as six levels.
Where the list starts
The list always starts at the top level of your shop. Phoca Cart's own Category module works the same way.
The box Only these categories shows just the categories you list, at every level. A sub-category is shown only inside its parent. So if you list a sub-category on its own, there is nothing to start from, and nothing is shown. To show a sub-category, list its parent too.
When nothing is left to show, visitors see nothing at all, not even the heading. If you are signed in as an administrator, a short message at the top of the page tells you why.
Add it to a page
These steps follow the order of the screens in Joomla. Nothing is saved until you press Save.
- Log in to the Joomla administrator. In the menu on the left, choose Content, then Site Modules.
- Press New. A list of module types opens.
- Choose Webal Phoca Category from the list.
- Type a Title for the module.
- On the Module tab, under Categories, choose Show the categories as: a tree, tiles, or a row you scroll.
- To show only some categories, type their numbers in Only these categories, with commas between them. To find a number, open Phoca Cart in another tab: Components, Phoca Cart, then Categories. The number is in the ID column.
- Choose a Position in the right-hand column. A position is a named place in your template where a module can go. For a side column in Cassiopeia,
sidebar-leftandsidebar-rightare good choices. - Press Save. The message "Module saved." appears. If a number is not a Phoca Cart category, the save is refused and the message names the number. Correct it and save again.
- Open the Menu Assignment tab. To show the list on every page, choose On all pages. To show it only in the shop, choose Only on the pages selected, press None, and tick the shop's menu items.
- Press Save & Close.
- Open a category page of your shop and look at the module. The category you are on is bold, with a bar beside it.
Accessibility. Give each Webal Phoca Category on a page a different title. The title names the list for screen readers.
Options
Module tab
| Option | What it does | Default |
|---|---|---|
| Title | An optional heading above the list. If you type one, set Show Title to Hide. | No title |
| Show the categories as | A tree, tiles, or a row you scroll. | A tree |
| Only these categories | The numbers of the categories to show, with commas between them. Only the categories you list are shown. List a parent and its sub-category together to show both. Saving refuses a number that is not a Phoca Cart category. | Empty (every category) |
| Hide these categories | The numbers of the categories to leave out. A hidden category takes its sub-categories with it. | Empty (none) |
| Order | As ordered in Phoca Cart, the reverse, by name, by date, by number of products, or at random. It applies at every level. | As ordered in Phoca Cart |
| Featured categories | Show all, hide the categories marked Featured in Phoca Cart, or show only those. | Show all |
| Hide categories with no products | Leaves out a category that Phoca Cart counts no products in. | Off |
| Only categories in the page language | For a site with more than one language. Shows the categories made for the language of the page and the ones made for all languages. | Off |
| Show how many products | Adds the number of products after each name. It is the number that Phoca Cart stores. A screen reader reads it as, for example, "12 products". | Off |
| Show the category pictures | Tiles and the scrolling row only. Shows the picture of each category above its name. The picture is decoration only, because the name is written out in the same link. | On |
| Picture size | Small, medium or large, from the sizes that Phoca Cart has made. The special picture of a category, if you set one in Phoca Cart, is used as it is. | Medium |
Look tab
| Option | What it does | Default |
|---|---|---|
| Levels in the tree | Tree only. How many levels go down, from 1 to 6. 1 shows the top level only. | 3 |
| Folded branches | Tree only. Open the branch the visitor is in, open every branch, or keep every branch folded. A visitor can always open or fold a branch with its button. | Open the branch the visitor is in |
| Columns and Last row | Tiles only. How many tiles fit in a row at each screen size, and what to do with a short last row. See the Grid group. | 2, 3 and 4 columns |
| Slides, arrows and dots | The scrolling row only. How many tiles show at each screen size, and the arrows, dots and Pause button. See the Slider group. | As in the Slider group |
The Layout tab and the Animation tab hold the same shared groups as other Webal modules. See the General, Spacing, Width, Colour scheme and Animation groups.
For keyboards and screen readers
- The list is a navigation landmark. The Title names it. If there is no Title, the module's own title does.
- The category being viewed is marked as the current page. On a product page inside it, the category is marked as the place you are, not as the page.
- The category being viewed is also bold with a bar, so it does not rely on colour.
- Each arrow button is 44 pixels square. A screen reader reads it as "Sub-categories of" and the category name. Enter or Space opens and folds it.
- With Show how many products on, a screen reader reads "Shoes (12 products)".
Tip. If the list looks wrong, open the same categories in Phoca Cart. This module shows what Phoca Cart gives it for the person looking at the page.