Technical Documentation

Complete guide for the installation, configuration, and maintenance of the PsEdiWheelConnect module.

Version: 3.0 · Last updated: May 2026

🚀 Quick Start
⚙️ Configuration
🔧 Troubleshooting

🚀 Quick Start Guide

3.1 — Minimum Requirements

Component	Minimum Version	Recommended Version
PrestaShop	1.7.7.0	8.1.x or 9.0.x
PHP	8.1	8.3+
MySQL / MariaDB	5.7 / 10.3	8.0+ / 10.6+
Composer	2.x	2.7+
PHP Extensions	curl, json, xml, mbstring, openssl	—
PHP Memory Limit	256 MB	512 MB
SSH Access	Recommended (for cron and CLI)	—

⚠️ Warning: The module requires Composer to load dependencies. If your hosting doesn’t support SSH, consider buying our Assisted Installation service.

3.2 — Installation

Method A — Back Office Upload (Recommended)

Log into your PrestaShop Back Office.
Go to Modules → Module Manager → Upload a module.
Drag and drop the psediwheelconnect.zip file received after purchase.
Wait for the installation to complete.
The module will appear under Improve → EDIWheel Connect in the sidebar.

Method B — FTP / SSH (Advanced)

# 1. Extract the archive into the modules folder
cd /var/www/html/modules/
unzip psediwheelconnect.zip

# 2. Install Composer dependencies
cd psediwheelconnect/
composer install --no-dev --optimize-autoloader

# 3. Set correct permissions
chmod -R 755 .
chmod -R 775 uploads/
chown -R www-data:www-data .

# 4. Install the module via PrestaShop CLI
cd /var/www/html/
php bin/console prestashop:module install psediwheelconnect

3.3 — License Activation

After installation, go to Improve → EDIWheel Connect → EDIWheel Configuration.
In the License section, enter:
- License Key: Found in your purchase confirmation email.
- License API URL: https://app.vmatlabs.local/api/check-license (pre-filled).
- API Token: Provided separately via email.
Click Save.

⚙️ Configuration Guide

All parameters are accessible from Improve → EDIWheel Connect → EDIWheel Configuration.

4.1 — Environment & Connection Settings

Define connection environments (Test vs Production) and specify API endpoints provided by your supplier (e.g. VanDenBan).

4.2 — Performance & Caching Settings

Active Stock Cache (Recommended): Stores stock queries locally (TTL default 10 minutes) to avoid redundant external supplier calls and maintain fast page speeds.
Asynchronous Orders (Highly Recommended): Places orders in an internal queue to transmit in background, reducing checkout delay for customers.

4.3 — Cron Jobs Settings

To support background automation, add these crontab records to your server:

Cron Task	CLI Command	Frequency
Queue Processor	`php bin/console ediwheel:queue:process`	Every 2-5 min
Order Status Sync	`php bin/console ediwheel:orders:sync`	Every 15-30 min
Stock bulk Import	`php bin/console ediwheel:stock:import`	Once a day (night)

🔧 Troubleshooting — 3 Common Issues

Issue 1: ❌ “500 Error” or “Class not found” after installation

Cause: Composer dependencies have not been installed, or folder permissions are incorrect.

Solution: Access your server via SSH, navigate to the module folder, and run: composer install --no-dev --optimize-autoloader. Fix folder permissions with standard web user owners (e.g. chown -R www-data:www-data .).

Issue 2: ⚠️ The module installs but conflicts with another module

Cause: Two modules loading conflicting dependencies (such as GuzzleHTTP version mismatches).

Solution: PsEdiWheelConnect uses an isolated autoloader. If a conflict occurs, make sure the other module compiles its classmap authoritatively or contact support.

Issue 3: 🕐 Timeouts during order transmission

Cause: The supplier API is slow, causing PHP timeouts.

Solution: Verify that Asynchronous Orders is enabled in the configuration. This ensures order processing is handled by cron in the background, making it immune to checkout timeouts.

Technical Documentation — PsEdiWheelConnect