Skip to the main content

Webal Phoca Product shows a short list of your Phoca Cart products as cards. You choose which products to show: by category, by brand, by order, or only the featured ones. The picture, name, price and stock words come from Phoca Cart, so the list always agrees with your shop.

Each card has a button. The button goes to the product page, or puts the product in the basket.

Use it for a few products on a page, such as the newest products on your home page. For a long catalogue, use Phoca Cart's own product list.

This module is part of Webal Phoca Blocks, which needs Phoca Cart 6 or later.

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 list 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 list follows. There is one switch, Show prices. It hides the price. It never changes it.

Tip. If a price in the list looks wrong, look at the same product on its Phoca Cart page. They should match.

Add it to a page

These steps follow the order of the screens in Joomla. Nothing is saved until you press Save.

  1. Log in to the Joomla administrator. In the menu on the left, choose Content, then Site Modules.
  2. Press New. A list of module types opens.
  3. Choose Webal Phoca Product from the list.
  4. Type a Title for the module.
  5. To show one category, type its number in Categories. For several, separate the numbers with 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.
  6. Choose the Order, and type how many products to show in How many products.
  7. 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, for example "there is no Phoca Cart category with the ID 99999". Correct the number and save again.
  8. 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.
  9. 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.
  10. 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 list.
  11. Open the Menu Assignment tab. In Module Assignment, choose Only on the pages selected.
  12. Beside Assign to Menu Items, press None. Every page is ticked until you do this.
  13. Type the name of the page in the search box, then tick that page.
  14. Press Save & Close.
  15. Open that page on your site and look at the module.

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 Product on a page a different module title. The title names the block for screen readers.

Options

Module tab

Options on the Module tab
OptionWhat it doesDefault
TitleAn optional heading above the list. If you type one, set Show Title to Hide.No title
CategoriesShow only products from these categories. Category numbers, separated by commas.Empty (every category)
BrandsShow only products from these brands. Brand numbers, separated by commas.Empty (every brand)
OrderThe 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. Random changes on every visit.Shop order
Featured products onlyShows only the products marked as featured in Phoca Cart.No
How many productsThe most products shown, from 1 to 48.4
Only products in the page languageShows 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 dataNever 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. A change then shows after at most that many minutes.Never

Card tab

Options on the Card tab
OptionWhat it doesDefault
Show pricesShows the price under each product name. Off hides it. Phoca Cart can also hide prices from some visitors, and that still applies.Yes
Price sizeHow big the price is. Four standard sizes.Normal
Products with optionsFor 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 textShows the beginning of the product's description as plain text.No
Characters of textHow many characters of the description are shown, from 20 to 500.120
ButtonA link to the product with words, a link as an arrow only, add to cart, add to cart with a link, or no button. A product that needs options chosen first, is on request, or that Phoca Cart does not let this visitor buy, gets the link.Link to the product, with words
Link button words, Add to cart button wordsThe words on the buttons. Left empty, the standard words are used.Empty
Button style, Button size, Full width buttonHow the buttons look. The arrow only button is never stretched. Every button is at least 44 pixels high.Primary, Normal, Yes
Label on every cardA short label such as New.Empty
Product name heading levelThe heading level of each product name. Automatic is one level below the Title, so the page outline never skips a level.Automatic
Card stylePlain, Border, Shadow or Filled.Border
Space inside the cardNone, Small, Medium or Large.Medium
Picture positionAbove the words, or beside them on the start or end side. Beside the words applies from the medium screen size up. One column with the picture beside the words gives the list look of the Phoca Cart module.Above the words
When the pointer is over a cardNothing happens, or the card lifts a little. Nothing moves for visitors who ask their device for less motion.Nothing happens
GridHow many columns on each screen size, the gaps, equal height, links at the bottom, and what to do with a short last row.1, 2, 3 and 4 columns

Layout tab

The shared General, Spacing, Width and Colour scheme groups. See the Title group and the other common options.

Animation tab

The shared Animation group. Everything is off 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.

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 products are a real list, so a screen reader says how many there are.
  • Each product name is a link. 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 old and new prices are read out with the words Was and Now.
  • 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.
  • Customers in special groups, other currencies and sites in other languages. They were not checked in a browser.
  • Browsers. The browser tests used one browser. Safari and Firefox have not been tried.
  • 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.

Other ways to reach us

Ask the community