Install and update the module

The PrestaOne module connects your PrestaShop installation to the mobile app. Install it in the store first; then connect each phone from the module's Connections & Access page.

You need a PrestaShop administrator account that can install and configure modules. A PrestaOne app account is a separate account: your Back Office password is not used to sign in to the app.

Before you install

• Check that your store runs a supported PrestaShop version: 1.7.8 or later in the 1.7 series, 8, or 9. Your host must meet the PHP requirements of its PrestaShop version and the module's minimum of PHP 7.4, with the required extensions, including cURL, JSON, Mbstring and OpenSSL.
• Open the public storefront over HTTPS. The address entered in the app is the public store address, not the private Back Office login address.
• Take a backup of the store files and database before changing installed modules. Keep it available until the installation has been checked.
• Use one store context. PrestaOne does not officially support PrestaShop Multistore. Connecting several independent stores in the app is a different feature; install the module separately in each of those stores.

Install the ZIP in PrestaShop

1. Open PrestaOne Downloads on your computer and download the module ZIP. If you obtained the module through a marketplace, use the package supplied for your purchase. Keep the ZIP intact.
2. In your store's Back Office, open Modules → Module Manager and choose Upload a module. Menu wording can vary slightly between PrestaShop versions.
3. Select the downloaded ZIP and wait for PrestaShop to finish uploading and installing it. The completed upload is not the final check: PrestaShop must report that installation succeeded.
4. Find PrestaOne Mobile Bridge in Module Manager and choose Configure. Confirm that the module is enabled.
5. Open Advanced in the module and expand Server diagnostics. Check the server requirements. If one is unavailable, send that exact requirement to your hosting provider before attempting to pair a phone.

The module has its own tabs inside PrestaShop. Use these names to follow the rest of the documentation. Enlarge ↗

At this stage, Not connected is expected: installation creates the store-side component, but no phone has been paired yet. Continue with Connect your store to the app.

Check the installation before connecting

Open the module's configuration again from Module Manager. The page should load its tabs and show the option to connect the mobile app. JavaScript must be enabled in the browser for the pairing controls to work.

Also open a normal storefront page. Installing the module should not prevent visitors from browsing or checking out. A storefront that opens successfully does not, by itself, prove that pairing or Live Chat works; those have their own verification steps.

If installation fails, keep the exact error text. A file upload limit, missing PHP extension and module setup failure require different fixes. Check Advanced → Server diagnostics where available; otherwise send the error to your host or PrestaOne support.

Update an existing installation

Updating keeps the existing installation and runs the module's upgrade steps. Do not uninstall the module as a way to update it. Uninstalling removes module data, including chat conversations, recovery records, analytics and connection settings.

1. Note the installed version in Module Manager and back up the store files and database.
2. Download the newer official ZIP. Use PrestaShop's module update/upload action for the existing PrestaOne installation.
3. Wait for the upgrade result, then reopen Configure. Check that your existing connections and service settings are still present.
4. In the app, refresh the connected store and open an order or product to confirm that store data loads.
5. If you use Live Chat, check the storefront widget. If you use recovery, check the saved campaign and its service status. An app connection alone does not verify those services.

If PrestaShop reports a failed upgrade, keep the backup and error details. Do not repeatedly uninstall and reinstall. If the app explicitly says the module version is no longer supported, update the module before retrying the connection.

If the module is installed but will not connect

Use Connect your store for the full pairing sequence. For a specific failure, use Connection and service checks.

Behind a CDN or reverse proxy, the public storefront can use HTTPS while PHP sees an internal HTTP connection. Follow the reverse proxy guide for that case. Do not guess proxy addresses or disable HTTPS protections to make an error disappear.