Webal Phoca Scroller shows a shelf of your Phoca Cart products as cards. The cards sit in a slider that the visitor can swipe, step through with arrows or dots, or leave to play by itself. If you prefer, they sit in a grid instead.
You choose which products to show: the newest, the featured ones, the best sellers, the most viewed, a random choice, or your own order. You can narrow the shelf to some categories or brands. The picture, name, price and stock words come from Phoca Cart, so the shelf always agrees with your shop.
Each card has a button. The button goes to the product page, or puts the product in the basket.
This module is part of Webal Phoca Blocks, which needs Phoca Cart 6 or later. For a short plain list of products, with no slider, use Webal Phoca Product.
Tip. A category number is the number that Phoca Cart gives to each category. You find it in the ID column of the Phoca Cart category list.
Where the prices come from
The shelf never works out a price itself. It asks Phoca Cart, and it shows the answer that Phoca Cart gives to the person looking at the page.
So these are all exactly what Phoca Cart shows: the price, the tax, the sale price, the old price, the price for each unit, the stock words, and the words for a free product.
The module has no setting for any of these. To change one, change it in Phoca Cart, and the shelf follows. There is one switch, Show prices. It hides the price. It never changes it.
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 Scroller from the list.
- Type a Title for the module.
- Choose Which products. For example, choose New arrivals for the newest products first.
- To show only some categories, type their numbers in Categories, separated by commas, for example 3, 7, 12. Leave the box empty to show every category. Do the same in Brands if you want only some brands.
- Type how many products to show in How many products.
- Press Save. If a number is not a category or a brand in your shop, the save is refused. The message names the box and the number. Correct the number and save again.
- Open the Card tab. Choose what the Button does: a link to the product page, an arrow only, add to cart, both, or no button.
- Open the Display tab. Choose A slider or A grid. For a slider, choose how many products show at once on each screen size.
- In the right-hand column of the Module tab, open the Position list and choose a position. A position is a named place in your template where a module can go.
- Beside Show Title in the same column, choose Hide if you typed a heading in the Title group. Choose Show only if you want Joomla's module title above the shelf.
- Open the Menu Assignment tab. In Module Assignment, choose Only on the pages selected.
- Beside Assign to Menu Items, press None. Every page is ticked until you do this.
- Type the name of the page in the search box, then tick that page.
- Press Save & Close.
- Open that page on your site and look at the shelf.
If Phoca Cart is switched off, missing or too old, visitors see nothing at all. You, signed in as an administrator, see a short notice at the top of the page.
If no product matches your choices, the module shows nothing, not even its heading.
Accessibility. Give each Webal Phoca Scroller on a page a different module title. The title names the shelf for screen readers.
How the slider behaves
- Arrows and dots. The arrows move the row by one card, or by a page of cards if you choose that. Each dot is named after its product. With only one product there are no arrows or dots.
- Swiping. The row is an ordinary scrolling strip that settles on a card, so it can be swiped. It was not tried on a real touch screen.
- Auto play. Switch it on in the Slider group and choose the delay, from 3 to 15 seconds. A Pause button always appears first in the slider, and it changes to Play when pressed. Auto play waits while the pointer is over the row or the keyboard focus is inside it. It never starts for a visitor whose device is set to reduce motion.
- Part of the next card. Choose 1.5, 2.5 or 3.5 cards in view to show a part of the next card. Fade the edges softly fades the card that is cut off by the edge of the row.
- Without script. If scripts are off, the row is still there. It scrolls, every card can still be reached, and the add to cart buttons still work. The arrows and dots are hidden, because they need script.
Options
Module tab
| Option | What it does | Default |
|---|---|---|
| Title | An optional heading above the shelf. If you type one, set Show Title to Hide. | No title |
| Which products | A ready-made shelf: new arrivals, featured products, best sellers, most viewed, or a random choice. Choose the order myself uses the Order setting below. | Choose the order myself |
| Categories | Show only products from these categories. Category numbers, separated by commas. It narrows every choice of Which products. | Empty (every category) |
| Brands | Show only products from these brands. Brand numbers, separated by commas. | Empty (every brand) |
| Order | The order of the products: shop order, name, price, date added, rating, best selling, most viewed, or random. The two choices about what the signed-in visitor viewed list nothing for a visitor who has not signed in. That is Phoca Cart's own rule. It shows only when Which products is Choose the order myself. | Shop order |
| Featured products only | Shows only the products marked as featured in Phoca Cart. It shows only when Which products is Choose the order myself. | No |
| How many products | The most products shown, from 1 to 48. | 8 |
| Only products in the page language | Shows the products written for the language of the page, and the ones for every language. It matters only when your site uses Joomla's language filter. | Yes |
| Keep the shop data | Never asks the shop every time, so a change in Phoca Cart shows at once. Keeping a copy for a few minutes is quicker on a busy site. | Never |
Card tab
| Option | What it does | Default |
|---|---|---|
| Show prices | Shows the price under each product name. Off hides it. Phoca Cart can also hide prices from some visitors, and that still applies. | Yes |
| Price size | How big the price is. Four standard sizes. | Normal |
| Products with options | For a product whose price depends on options that the customer must choose. From and to shows the lowest and the highest price, From only just the lowest. Both figures come from Phoca Cart. | From and to |
| Show the short text | Shows the start of the product's description under its name, as plain text, with the number of characters you choose. | No |
| Button | A link to the product, an arrow only, add to cart, add to cart with a link, or no button. A product that needs options chosen first gets the link. | Link to the product |
| Button words, style and size | Your own words for the buttons, and their look and size. Every size is at least 44 pixels high. | Standard words, filled, normal |
| Label on every card | A short label on each card, for example New. | Empty |
| Product name heading level | The heading level of each product name. Automatic uses the level just below your Title. The name looks the same whatever its level. | Automatic |
| Card style, space inside and pointer | The look of each card: plain, border, shadow or filled; the room inside; and whether the card lifts a little under the pointer. | Border, medium, nothing happens |
Display tab
| Option | What it does | Default |
|---|---|---|
| Show the products as | A slider, or a grid. | A slider |
| Grid | Columns for each screen size, gaps, equal height, links at the bottom, and what to do with a short last row. Columns, gaps and the last row are used by the grid. Equal height and links at the bottom are used by both. | The group's own settings |
| Slider | How many cards show at once on each screen size, one card or a page for each arrow press, auto play and its delay, loop, centring, fade the edges, the gap, the arrows and the dots. | 1, 2, 3 and 4 cards; no auto play |
Layout and Animation tabs
The shared General, Spacing, Width and Colour scheme groups, and the Animation group. Everything moves less, or not at all, for visitors who ask their device for reduced motion.
Advanced tab
This module has no Caching setting. It shows a price for the person looking at the page, so Joomla never stores it.
Add to cart
The add to cart button is a real form that sends the visitor to Phoca Cart's own basket step, and then back to the page. It needs no script, so it also works when scripts are off. Inside a slider it works the same way, also for a card that was out of view.
Phoca Cart decides whether a product can be added. If a product needs options chosen first, the card shows a link to the product page instead.
Accessibility
- The slider is a named carousel. Each slide says where it is in the row, and each dot is named after its product.
- Every product name link and every button can be reached with the keyboard, also in cards that are out of view. The row scrolls to the card that has the focus.
- The picture is a second link that keyboards and screen readers skip, because the name says the same.
- Every button shows its words and also names its product for a screen reader.
- The module is tested against WCAG 2.2 AA. What was and was not checked is in the evidence file.
Known limits
- Joomla 5.4 has not been tested. Every test so far ran on Joomla 6.2 with Phoca Cart 6.1.9.
- Browsers. The browser tests used one browser. Safari and Firefox have not been tried, and no screen reader was used.
- Customers in special groups, other currencies and sites in other languages. They were not checked in a browser.
- The edge fade. It softens the part of a card that is cut off, including its words and button. Whole cards are never faded, and the row scrolls a card fully into view when it gets the keyboard focus.
- The category and brand boxes are plain number boxes. They do not yet show the name beside the number. Finding a brand number and an option ID says where Phoca Cart shows the numbers.
- At most 48 products.
- Phoca Cart's own pages are not changed. The product page, the basket and the checkout look as Phoca Cart makes them.