Installation

Solidshop is distributed as a single Joomla package file that installs the core component, system plugin, payment plugins, and all supporting modules in one step.

Download the package

Download Solidshop Core from the Downloads page. No account or licence key is required.

Open the Extension Manager

In your Joomla admin panel, navigate to System → Install → Extensions.

If you are new to Joomla: the admin panel is at https://yoursite.com/administrator. Log in with the admin credentials you created during Joomla installation.

Upload and install

Drag and drop Solidshop ZIP into the upload area, or click “Browse for file” and select it. Joomla will install everything automatically. You should see a success message listing the installed components.

Find Solidshop in the admin menu

After installation, Solidshop has its own entry in the Joomla administrator menu, right below Home Dashboard. It opens onto the store’s screens in seven groups: Catalog, Sales, Customers, Marketing, Configuration, Localization and System. On a phone the menu is behind Joomla’s menu button. Each user sees only the screens they may open: someone without the Manage order permission gets no Orders, Reports or Email Queue link.

The grid icon next to the entry opens the Solidshop dashboard: a card for each group and one for the Dashboard, and the orders waiting on you across the top (see Orders). It is a Joomla dashboard like the one for Content, so you can add your own modules to it.

Open Solidshop → Dashboard, the first link in the entry: it offers to set up your store — its details, how it charges tax and how customers pay. See Your first store.

A custom administrator menu (one you built under Menus → Manage for the administrator) is yours to arrange, so Solidshop leaves it alone and keeps its flat list under Components → Solidshop. So does a site that switches off the System - Solidshop plugin.

What gets installed

The Core installer is a Joomla package that bundles sixteen extensions and installs them in one pass. Once it finishes you have a complete storefront, an admin UI, the asynchronous email worker, and the storefront modules — no further downloads required.

Extension What it is
lib_solidshop Shared Solidshop library — the namespaced classes (cart, tax, discount engine, invoice generator, events) used by the component, plugins, and modules. Installed first so everything else can depend on it.
com_solidshop The core component — products, orders, checkout, tax, shipping, dashboard
plg_system_solidshop System plugin for routing, event dispatching, and frontend integration
plg_finder_solidshop Smart Search indexer — makes products findable through Joomla’s own search, with Type, Category, Brand and Language filters
plg_webservices_solidshop Routes the read-only catalog REST API and the MCP endpoint — see Catalog API
plg_quickicon_solidshop Puts the orders waiting on you on the Joomla administrator home page — see Orders
plg_solidshoppayment_cod Cash on Delivery payment method
plg_solidshoppayment_banktransfer Bank Transfer payment method — shows your bank account details and a payment reference on the order confirmation
plg_task_solidshopemailqueue Scheduled task plugin that sends queued transactional emails in batches. Requires a one-time scheduler setup — see Set up the email queue below.
mod_sshop_cart Shopping cart sidebar module
mod_sshop_products Product listing/showcase module
mod_sshop_search Product search form module
mod_sshop_filters Product filter sidebar (category, price, brand, rating, tags)
mod_sshop_currency Currency switcher — lets a visitor see prices converted into another published currency; the order is still taken in the store currency
mod_sshop_quicksearch Admin quick search — one search box in the administrator header for orders, products, customers and coupon codes; see Quick search
mod_sshop_languages Language switcher — links to the translated version of the current Solidshop product or category, falling back to the target language’s home menu on non-Solidshop pages

To check what actually landed on a site — and what is available but not installed — open Solidshop → System → System and switch to the Extensions tab. It lists every installed Solidshop extension with its version, enabled state and any pending update, flags a module that has no published instance or an extension with no update site registered (which would never be offered updates at all), and lists the add-ons you do not have yet. Check for Updates in the toolbar refreshes Joomla’s update check so the versions shown are current.

Set up the email queue (required)

Solidshop sends transactional emails (order confirmations, status updates, invoices) asynchronously through a background queue. Each email is written to the #__sshop_email_queue table the moment it’s triggered, and a scheduled task ships them out in batches of twenty.

Without a working scheduler, queued emails simply pile up — nothing is sent. This is the single most common reason for “my order emails aren’t arriving” reports, so this section walks through the setup end to end.

The Joomla Scheduled Tasks component

Joomla 4.1+ ships with a built-in scheduler at System → Manage → Scheduled Tasks (com_scheduler). Many site builders miss it because it lives under System rather than Components. This is where you add, run, and monitor recurring jobs — including the Solidshop email queue task.

Each scheduled task has:

  • A type — the task plugin that does the work (e.g. Solidshop: Process Email Queue).
  • An execution rule — how often it should run: an interval in minutes, hours, days or months, or a cron expression (e.g. every minute, every 5 minutes, daily at 03:00).
  • A status (Enabled/Disabled) and an Execution History tab with the last exit code, the last and next run, and how many times the task has run and failed.

How tasks actually get triggered

Creating a task only schedules it — something still has to fire the scheduler at the right interval. Joomla supports three trigger options. Pick whichever fits your hosting environment:

Option A — System Cron (recommended)

A real cron job on your server hits a Joomla CLI script every minute. This is the most reliable option because it runs even when nobody is visiting the site, and it has no impact on page-load performance.

On most Linux hosts, add this entry to your crontab (crontab -e):

* * * * * /usr/bin/php /path/to/your/site/cli/joomla.php scheduler:run --all --live-site=https://www.example.com/

Replace /path/to/your/site with your Joomla document root, https://www.example.com/ with your site’s address, and adjust the PHP path to match your environment. Most shared hosts (cPanel, Plesk, DirectAdmin) expose a UI for adding cron jobs — the command is the same; just paste it into the form.

A task run from cron knows your site’s address only from --live-site, or from Live Site in configuration.php. Without it, the e-mails a task sends go out without links to your site — a subscription reminder loses its Renew button — and the task’s log says so. Keep the slash at the end of the address: without it Joomla builds its own links from the wrong path.

--all runs every task that is due; without it, each run starts only the next one. Run the job as the account that owns the site’s files, and once it works, turn the Lazy Scheduler off (Option C), as Joomla recommends when you trigger with cron.

Option B — Web Cron

A unique URL hits Joomla’s scheduler endpoint over HTTP. Useful when you don’t have shell access but you do have access to an external cron-as-a-service (cron-job.org, EasyCron, UptimeRobot, GitHub Actions on a schedule).

Go to System → Manage → Scheduled Tasks, click Options in the toolbar, open the Web Cron tab, set Web Cron to Yes and save. Joomla generates the secret key on save and then shows the Webcron Link (Base), a URL of the form:

https://yoursite.com/index.php?option=com_ajax&plugin=RunSchedulerWebcron&group=system&format=json&hash=<your-secret>

Copy the link from that screen and configure your external cron service to call it every minute. Each call runs the next due task. Keep the URL secret — anyone with it can fire your tasks. If it leaks, Reset Access Key on the same tab issues a new one.

Option C — Lazy Scheduler

Joomla checks for due tasks on the back of normal page loads: when a task is due, the visitor’s browser asks the site to run it. No cron job is required — it is on by default and works on any host.

Its settings are under Scheduled Tasks → Options, on the Lazy Scheduler tab: Lazy Scheduler itself and the Request Interval (seconds), 300 by default: how often a page left open asks again. The trade-off: tasks only run when somebody visits the site in a browser that runs JavaScript. On low-traffic stores this can mean order confirmation emails are delayed by minutes or hours, so treat this option as a fallback — convenient for development, fragile for production.

Pick System Cron in production. Web Cron is a solid alternative when shell access isn’t available. Lazy Scheduler is convenient but unsuitable for live stores — emails won’t go out until somebody visits the site. Once cron or Web Cron is in place, switch the Lazy Scheduler off.

Create the Solidshop email queue task

With a trigger in place, create the task that processes queued emails:

Check the task plugin is enabled

The email queue is the plg_task_solidshopemailqueue plugin that ships with the core package. A fresh install of Solidshop 1.7.0 or later enables it; a store first installed with an earlier version may have it disabled. Go to System → Manage → Plugins, search for Solidshop Email Queue and make sure Task - Solidshop Email Queue is enabled. Until it is, its task type is not offered.

Open Scheduled Tasks

Go to System → Manage → Scheduled Tasks and click New in the toolbar.

Choose the task type

Joomla lists the task types its enabled plugins offer, with a search box. Pick Solidshop: Process Email Queue.

Set the schedule

Set Execution Rule to Interval, Minutes and Interval in Minutes to 1 to run every minute. Slower intervals work too (e.g. 5 for every 5 minutes), but every minute is recommended for transactional email so order confirmations arrive promptly.

Save and verify

Leave Status at Enabled and save. In the task list, click Run Task in the task’s Run Manually column: the window that opens should read Status: Completed. A task whose last run failed shows a warning icon next to its title with the exit code. Place a test order and confirm the confirmation email arrives within a minute or two.

The same scheduler handles other Solidshop background jobs you may add later — invoice PDF generation, recurring invoices, subscription renewals, expired download link cleanup. They each ship as their own task plugin (in the optional plugins) and are configured the same way: one task per plugin, on whatever interval fits.