Webal Phoca Blocks is a set of 15 Webal Blocks modules that show your Phoca Cart shop on any page of your site: products, prices, categories, brands, the basket, search and filters.
The set works beside Phoca Cart. It reads your shop and never changes it. Phoca Cart keeps looking after your products, orders and shop pages. Every price, tax figure and stock word in a module comes from Phoca Cart, so a module always agrees with your shop.
Tip. A module is a block that you put on a page. A package is one zip file that holds several parts. The words used in these instructions explains more.
The modules
Each module has its own page with its options, the steps to add it to a page and its known limits.
Products and prices
- Webal Phoca Product: a short list of products as cards, chosen by category, by brand, by order or only the featured ones.
- Webal Phoca Scroller: a shelf of product cards in a slider, or in a grid, such as the newest products or the best sellers.
- Webal Phoca Pricing Table: products shown as price plans side by side, with an optional monthly and yearly switch.
- Webal Phoca Countdown: the products on sale right now, each with a clock that counts down to the end of the sale.
Finding your way round the shop
- Webal Phoca Category: your categories as a list that folds, as tiles with pictures, or as a row you scroll.
- Webal Phoca Brands: the brands of your shop as a row of logos or a grid.
- Webal Phoca Mega Menu Content: your categories or brands as links with pictures, made to sit inside a Webal Blocks mega menu.
- Webal Phoca Search: a search box that takes visitors to your shop's own list of results.
- Webal Phoca Filter: lets visitors narrow the product list by category, price, brand, tag, label or a choice of your own.
- Webal Phoca SVG Scheme: a picture of a place, such as a floor plan, with a shape over each category that visitors can choose.
The visitor's basket and lists
- Webal Phoca Cart: what is in the visitor's basket, as a cart icon with a number, a panel or a list in the page.
- Webal Phoca Compare: the visitor's comparison list, in the same three looks.
- Webal Phoca Wish List: the visitor's wish list, in the same three looks.
- Webal Phoca Currency: lets visitors choose the currency that your shop shows prices in.
Newsletter
- Webal Phoca Newsletter: a newsletter sign-up for shops that use the Phoca Email component.
Help
- Finding a brand number and an option ID: where Phoca Cart shows the numbers that some modules ask for.
What you need
The install checks four things before it writes any file. If one is missing, nothing is installed, and a message tells you what to do.
| Part | What it needs | Tested with |
|---|---|---|
| PHP | PHP 8.3 or later | PHP 8.4 |
| Joomla | Joomla 5.4 or later | Joomla 6.2 only |
| Webal Blocks | Installed and switched on, in a version this set works with | The current development version |
| Phoca Cart | Installed and switched on, version 6.0.0 or later | Phoca Cart 6.1.9 |
Phoca Cart 5 is not supported. If your shop runs Phoca Cart 5, update it to version 6 first. Webal Phoca Newsletter also needs the Phoca Email component. The other modules do not.
Before you start
- Make a backup of your site.
- Install Webal Blocks first, and check that it is switched on.
- Check that Phoca Cart 6 is installed and switched on. To look, open System, then Manage, then Extensions, and type Phoca Cart in the search box.
- Sign in to the administrator area as a Super User.
Install it
The file is called pkg_wblphoca_v, then the version number, then .zip. Keep it as one zip file and do not unzip it. You install it in the same way as Webal Blocks.
- Open System, then Install, then Extensions.
- Choose the tab Upload Package File.
- Drag the zip file onto the box that says Drag and drop file here to upload. Or choose Or browse for file and pick the zip.
- Wait until Joomla shows a message. Do not close the page while it works.
- Read the message. A success message means that the install worked. A red message says why it stopped.
If the installer refuses
The installer only looks at your site at first. It writes nothing until every check passes. It lists all the problems it finds together, so you can fix them in one go. Each message says what is wrong and how to fix it.
| The message starts | What to do |
|---|---|
| Webal Phoca Blocks needs PHP 8.3 or later | Ask your web host to move the site to PHP 8.3 or later. |
| Webal Phoca Blocks needs Joomla 5.4 or later | Update Joomla, then install again. |
| Webal Phoca Blocks needs Webal Blocks, and Webal Blocks is not installed | Install the Webal Blocks package first. |
| Webal Phoca Blocks needs Webal Blocks, which is installed but switched off | Switch Webal Blocks on in System, Manage, Extensions. |
| Webal Phoca Blocks needs Webal Blocks, followed by a version number | Update Webal Blocks by installing its newer package. |
| Webal Blocks is installed, but its version could not be read | Install the Webal Blocks package again. |
| Webal Phoca Blocks needs Phoca Cart 6 or newer, and Phoca Cart is not installed | Install Phoca Cart 6 and switch it on. |
| Webal Phoca Blocks needs Phoca Cart 6 or newer. Phoca Cart is installed but switched off | Switch Phoca Cart on in System, Manage, Extensions. |
| Webal Phoca Blocks needs Phoca Cart 6.0.0 or later | Update Phoca Cart to version 6. |
| Phoca Cart is installed, but its version could not be read | Install Phoca Cart 6 again over the top. |
| Phoca Cart is installed, but one of its files is missing | Install Phoca Cart 6 again over the top. |
When a check fails, Joomla also shows its own line, "Unable to install extension". After you put things right, install again.
Two cases are not refusals. The set installs and shows a warning:
- Your Phoca Cart is newer than 6.1.99, the newest version we tested. Look at your pages, and at the overview screen below, to check that they still look right.
- Your site runs Joomla 5 with Phoca Cart 6. Phoca publishes Phoca Cart 6 for Joomla 6, and this combination has not been tested.
What you have now
- A component called Webal Phoca Blocks. It holds the shared code and styles of the set, and an overview screen.
- The 15 modules listed above. Each one is in the list of module types when you press New under Content, then Site Modules.
- A plugin called System - Webal Phoca Picture Sizes. It stops Phoca Cart's shop pages jumping while their pictures load. It is installed switched off, because installing the set must never change a page on its own. You can switch it on in System, then Manage, then Plugins.
- A template called Cassiopeia - Webal Shop, a child of Cassiopeia with a shop look in light and dark colours. The install adds it as a new template style, but your site keeps the template it had.
- A new line in the Joomla menu: Components, then Webal Phoca Blocks.
As with any Joomla module, the install also adds one copy of each module to Site Modules. Those copies are switched off and have no position, so they show on no page until you use them.
The overview screen
Open Components, then Webal Phoca Blocks. The screen is called Webal Phoca Blocks: overview. It tells you in plain words whether everything is in place.
- A line at the top says "Everything Webal Phoca Blocks needs is in place." Or it says that something needs a look, or that the set cannot work yet.
- What Webal Phoca Blocks is says what the set does.
- Is everything in place? is a table of Webal Blocks, Phoca Cart and this set. Each row has its version and a sentence that says what to do if something is wrong.
- Webal Phoca modules on this site lists the modules of the set that you have installed and how many copies are on your site. With none, it says so, and it has a button, Add a Webal Phoca module.
- What this set does not do lists three things. It does not change Phoca Cart's own pages. It does not change your template. It adds nothing to a page that has no Webal Phoca module on it.
- More about Webal Blocks has two links: Open the Webal Blocks dashboard and Open the Webal Blocks manual.
The Webal Blocks dashboard has a section called Webal sets. It lists this set with its version and modules, and says whether Webal Blocks and Phoca Cart are in place. It only appears while a set is installed.
If Phoca Cart goes missing later
Suppose you switch Phoca Cart off, remove it, or update it to a version that is too old.
- Visitors see nothing where a Webal Phoca module was. The page still opens as normal. They never see an error page.
- You, signed in as an administrator, see one message at the top of the page. For example: "the module mod_wblp_pricing is showing nothing because Phoca Cart is switched off." Visitors cannot see it.
- The overview screen and the dashboard say what is wrong and how to fix it.
Switch Phoca Cart back on, or install it again, and the modules come back by themselves.
What the install never changes
We tested this on a practice site. It ran Joomla 6.2 and Phoca Cart 6.1.9 with the sample shop. We compared its files, its database tables and seven ordinary pages before and after each step: install, update and uninstall.
- Phoca Cart. The set changes no Phoca Cart file, table or setting, and no Phoca Cart page.
- Your site. Your articles, menus, template, other extensions and settings are not touched. The new template and the new plugin change nothing until you choose to use them.
- Your pages. A page with no Webal Phoca module on it gets no style, no script and no new markup from the set.
Tip. Joomla itself asks browsers to fetch fresh copies of your site's styles after any extension install. That is Joomla's doing, not the set's.
Uninstalling
Remove the set in this order. The set is protected, so Joomla stops you if you try another way.
- Make a backup of your site. Remember that every Webal Phoca module on your pages will go.
- If Cassiopeia - Webal Shop is your Default template style, choose another Default first in System, then Site Template Styles. Joomla does not remove a template that is the Default.
- Open System, then Manage, then Extensions.
- Type Webal Phoca in the search box.
- Tick the row called Webal Phoca Blocks whose type is Package.
- Press Uninstall and confirm.
- Only now, if you want to, remove Webal Blocks. See Uninstalling.
In our test, the set took its component, its modules, every copy of the modules on a page, its plugin, its template and its menu line with it. The practice site came back to what it was before the install. Phoca Cart, Webal Blocks and your own template were not touched.
Two things stop an uninstall, and both leave everything as it was.
- You try to remove the component Webal Phoca Blocks on its own while its modules are installed. The message says it cannot be removed on its own and names the modules. Remove the whole package instead.
- You try to remove Webal Blocks while the set is installed. The message names the set and its modules. Remove the set first.
Known limits
- Joomla 5.4 has not been tested. The installer accepts it, because Webal Blocks does. Every test so far ran on Joomla 6.2.
- Only Phoca Cart 6.1.9 has been tested. The install accepts 6.0.0 and later. The warning for a newer version was tested with a pretend version number, not with a real update of Phoca Cart.
- Only Cassiopeia and its Webal child themes have been tested. See Template requirements.
- Removing one module on its own has not been tested. Removing the whole package has.
- English (UK) only. The words of the set are in English.
- The page of each module lists its own limits. Read it before you rely on a module.
Related pages
- Download and install the package
- What the install does and does not touch
- Uninstalling
- Finding a brand number and an option ID
Other manuals
- Webal Blocks manual: Build a whole Joomla site from native blocks: requirements, installing, first setup, navigation, a page for every module, site-wide features and help.
- Webal Layouts manual: Arrange the parts of a Cassiopeia page on one screen, with a live preview: sections, rows, sidebars, the error and offline pages, and checks.
- Webal Phoca Pages manual: Arrange Phoca Cart's product page from blocks: layouts, category rules and checks before visitors see them.
- Webal Phoca Cart Easy Edit manual: Edit a Phoca Cart product on one clear screen: prices, stock, options, variations, pictures, tags and labels, the tax tool and staff permissions.