Installing J2Commerce

This guide covers installing J2Commerce on a fresh Joomla 6 installation.

Requirements

Server Requirements

Requirement	Minimum	Recommended
PHP	8.3.0	8.3+
MySQL	8.0+	8.0+
Joomla	6.0+	6.0+

PHP Extensions

• mysqli or pdo_mysql: Database connectivity
• json: JSON encoding/decoding
• curl: HTTP requests for payment gateways and currency updates
• mbstring: Multi-byte string support
• gd or imagick: Image processing
• zip: Extension installation
• openssl: Secure API connections

Permissions

The following directories must be writable by the web server:

• /tmp: Temporary file storage
• /logs: Log file writes
• /administrator/cache: Cache files

Purchase and Download

‌Step 1: Go to our J2Commerce website -> Plugins

Step 2: Locate the J2Commerce installation package -> click View Details -> Add to cart -> Checkout.

Step 3: Go to your My Downloads under your profile button at the top right corner and search for the app. Click Available Versions -> View Files -> Download

Install J2Commerce

You can install this J2Commerce installation package using the Joomla installer. The following steps help you with a successful installation.

In the Joomla admin, go to System -> Install -> Extensions

Upload the plugin ZIP file or use the Install from URL option.

tip

If you're upgrading from J2Store, use the Install from Directory option and select the extracted folder. The installer detects the upgrade path automatically.

Enable Required Plugins

After installation, J2Commerce requires several system plugins to be enabled:

Navigate to System -> Manage -> Plugins

Search for j2commerce

Enable the following plugins:

• System - J2Commerce: Core system integration

• System - J2Commerce Content: Article-to-product conversion

• Content - J2Commerce: Product display in articles

Verify Installation

Go to Components -> J2Commerce

You should see the Dashboard

The Setup Wizard should appear if this is a fresh installation

Manual Installation

If the Joomla installer fails, you can install manually:

Via File Manager

1. Extract the J2Commerce .zip file

2. Upload the extracted contents to your Joomla installation via FTP or file manager:

   • Component to: /administrator/components/com_j2commerce/
   • Media to: /media/com_j2commerce/
   • Plugins to: /plugins/system/j2commerce/, /plugins/content/j2commerce/, etc.

3. Log in to phpMyAdmin and import the SQL file if provided

4. Enable plugins via System -> Manage -> Plugins

Via Command Line

# Navigate to your Joomla installation
cd /var/www/html

# Extract the package
unzip j2commerce.zip

# Move files to correct locations
mv j2commerce/administrator/components/com_j2commerce administrator/components/
mv j2commerce/media/* media/com_j2commerce/
mv j2commerce/plugins/* plugins/

# Set permissions
chmod -R 755 administrator/components/com_j2commerce
chmod -R 755 media/com_j2commerce

Post-Installation Checklist

After installation, verify the following:

• Dashboard loads without errors
• Setup Wizard appears (fresh install)
• The product menu is accessible
• The orders menu is accessible
• Settings save correctly
• Payment methods can be configured
• Shipping methods can be configured

Troubleshooting

Installation Fails

Error: "Unable to find install package"

• The zip file may be corrupted. Download again and retry.
• Ensure you're uploading the .zip file directly, not an extracted folder.

Error: "Unable to copy files"

• Check directory permissions. The web server user needs write access.
• Verify the /tmp and /logs directories exist and are writable.

Blank Screen After Installation

1. Enable Joomla's debug mode: System -> Global Configuration -> System -> Debug
2. Check /logs/error.php for PHP errors
3. Verify PHP version and required extensions

Plugin Not Found

If plugins don't appear in the plugin manager:

1. Verify all plugin folders were uploaded
2. Check for duplicate installations from J2Commerce
3. Clear Joomla cache: Home Dashboard -> System -> Cache -> Delete Cache

Uninstalling

To uninstall J2Commerce:

1. Go to System -> Manage -> Extensions
2. Find J2Commerce in the component list
3. Click Uninstall

warning

Uninstalling removes all J2Commerce data, including products, orders, and customers. Create a backup before proceeding.