Skip to the main content

Webal Phoca Wish List shows the visitor's Phoca Cart wish list. It can be a small icon with a round number and a panel that opens to list the products, or the list right in the page, or only the icon and the number. Each product in the panel has a Remove button.

The number and the products come from Phoca Cart, so they always agree with your shop. It takes the place of Phoca Cart's own Wish List module.

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

Tip. The wish list is kept by Phoca Cart for one visitor while they shop. Every visitor has their own, so the module is never kept by Joomla's cache.

What the visitor sees

  • The icon is a link. It goes to the Phoca Cart page for the wish list.
  • The number is in a small round badge. It is how many products are in the list.
  • The panel opens from a small button next to the icon. It lists the first products by name, each with a Remove button, and a button to the Phoca Cart page. It closes when the visitor presses Escape or clicks somewhere else.
  • Remove asks Phoca Cart to take that product out of the list and brings the visitor back to the page they were on. Phoca Cart's own page then shows the same list.

When the list is full

The most products a wish list holds is a Phoca Cart Option, "Maximum wish list items". When the list holds that many, the panel says so, in Phoca Cart's own words: "Count of products in wish list is limited". If the visitor then presses another Wish list button, Phoca Cart refuses it and shows its own message. The number in the module does not change.

When a visitor adds a product

On Phoca Cart's own pages, the Wish list button of a product works without reloading the page. The number in the module changes at once, to the figure Phoca Cart has just confirmed. A screen reader says the new number.

The list of products in the panel is not redrawn at that moment. It is hidden, and a short note with the button to the Phoca Cart page takes its place. The list is right again on the next page. If scripts are switched off, nothing changes until the next page, and then everything is right.

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 Wish List from the list.
  4. Type a Title for the module. Joomla uses it to name the module in the list.
  5. On the Module tab, under Wish list, choose How the list is shown.
  6. Choose whether to show the number of products, and how many products to list.
  7. In the right-hand column, open the Position list and choose a position. A position is a named place in your template where a module can go. A place in the header suits an icon with a panel.
  8. Beside Show Title in the same column, choose Hide. Choose Show only if you want Joomla's module title above the list.
  9. Press Save. The message "Module saved." appears.
  10. Open the Menu Assignment tab. In Module Assignment, choose On all pages for an icon in the header, or Only on the pages selected and tick the pages you want.
  11. Press Save & Close.
  12. Open a page of your site and look at the icon. Press a Wish list button on a Phoca Cart page and look again.

Accessibility. If you put more than one Webal Phoca Wish List on a page, give each 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 block. See the Title group. If you type one, set Show Title to Hide.No title
How the list is shownAn icon with a panel that opens suits a header. The list in the page suits a side column. An icon and the count only has no list of products.An icon with a panel that opens
The words beside the iconShown prints the words Wish list beside the icon. Hidden keeps the words for screen readers, so the icon link still has a name.Hidden
Own words for the listThe words used beside the icon and as the name of the link, for example Favourites. Leave it empty to use the standard words in the language of the page.Empty
Show the number of productsThe round badge with the number.Yes
Show a small picture on each lineA small picture of the product beside each line. It is decoration: the product name beside it says the same.No
Products listedThe most products listed, from 0 to 20. If the list holds more, a short sentence says how many are not shown. With 0 you see the button only.5
Button to the wish list pageA button under the list that goes to the Phoca Cart page. Always, only when the list has products, or never.Always
Button styleThe look of that button: filled, grey or an outline.Filled
Which edge the panel lines up withA block at the right of a header opens its panel towards the left, so choose the end. A block at the left opens it towards the right, so choose the start. With scripts on, the panel also turns round by itself if it would leave the screen. With scripts off, the panel opens in the page under the icon, whichever you choose.The end

The Layout tab and the Animation tab hold the shared groups that every Webal module has: General, Spacing, Width, Colour scheme and Animation. They work as they do in the other Webal modules.

Tip. Phoca Cart's own Wish List module has a box for a description above the list. The Webal module does not. Use the Title, or put a Webal Text module beside it.

Accessibility

  • The icon link has a name. When the words are not shown, a screen reader still hears them, with the number.
  • The panel opens and closes with the keyboard. Enter or Space opens it, Escape closes it and puts the focus back on its button. Each Remove button can be reached and pressed with the keyboard, and its name says which product it removes.
  • Every link and button is at least 44 pixels high and wide. The focus ring is three pixels wide.
  • The small chevron turns only for visitors whose device allows movement. In high contrast mode the number keeps a visible edge.
  • Words that the module prints itself come from language files.

Tips

  • For a header, use An icon with a panel that opens and keep The words beside the icon hidden.
  • Keep Products listed small. Each product asks the shop a few questions every time the page is shown.
  • Visitors add products with the buttons Phoca Cart prints on its own pages. Switch them on in the Phoca Cart Options if you do not see them.
  • If Phoca Cart is switched off, visitors see nothing and you see a notice at the top of the page.
  • If your host or a service in front of your site keeps whole pages, leave the pages of your shop out of it. The module shows each visitor's own list.

What has been tested

  • Phoca Cart. Version 6.1.9 with its demo shop, as a guest. The number matches what Phoca Cart answers after an add with Phoca Cart's own button, with two of its add methods. A reload agrees. When the list is full, Phoca Cart refuses the next add and the number does not move.
  • Remove. The Remove button removes the product through Phoca Cart's own request, and Phoca Cart's own page then shows the same products. A request with no token removes nothing.
  • Pages kept by Joomla. With the System - Page Cache plugin switched on, a page with this module on it is not kept for the next visitor.
  • Without scripts. The icon is a link, the panel opens in the page with every product name on the screen, and Remove works.
  • Not tested. A signed-in customer, a site in another language, Joomla 5.4, Safari and Firefox, and a cache outside Joomla.

Other ways to reach us

Ask the community