Installation

Installing the plugin

1. Upload the plugin — Extensions → My extensions → Upload extension, or place it in the plugin directory and install it from the command line.
2. Install and activate it under Extensions → My extensions.
3. Clear the admin cache and reload the browser (Ctrl+F5) so that Stockly appears under Catalogues.

From the command line:

bin/console plugin:refresh
bin/console plugin:install --activate P2LabStockly
bin/console cache:clear

The installation creates the plugin’s own tables and adds its privileges. It changes no products and no orders. Until the setup wizard has been completed, the shop behaves exactly as before.

Background processing

Every operation that can take longer is executed in the background: linking the catalogue, mapping locations, imports, report figures, integrity checks, replenishment schedules. Without queue processing these jobs remain in the queue and are not executed.

bin/console messenger:consume async low_priority
bin/console scheduled-task:run

In production both processes should run as services. The state of the jobs is available under Stockly → Settings → Diagnostics → Background jobs.

Caution

If the shop processes the queue through an open admin tab, long operations started from the admin are executed only while that tab is open. The setup wizard states this at every such step.

Privileges

After installation the administrator has access. Other roles are granted access under Settings → System → Users & permissions → Roles → role, where the Stockly privileges are collected in their own groups. See Privileges.

Splitting the roles has a practical purpose: a picker requires operations and scanning, but does not need access to settings, purchase orders or the deletion of warehouses.

What to check afterwards

• Catalogues → Stockly opens and displays the Dashboard.
• Settings → Diagnostics → Background jobs lists jobs and the list does not grow indefinitely, which indicates that the queue is being processed.
• The place where location information is currently held has been established. If it is held in a product field, the wizard can build bin locations from it.

Updating

An update runs its database migrations on start. Clear the cache afterwards. If a custom admin build is in use, rebuild it after the update.

bin/console plugin:update P2LabStockly
bin/console cache:clear

Next step

Menu and navigation — how to navigate the module.