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 Solidshop Core from the Downloads page. No account or licence key is required.
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.
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.
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:
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.
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.
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:
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.
Go to System → Manage → Scheduled Tasks and click New in the toolbar.
Joomla lists the task types its enabled plugins offer, with a search box. Pick Solidshop: Process Email Queue.
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.
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.