Skip to main content

Shopware 6

Welcome to the manual for the Clonable integration for Shopware 6.

Downloads and supported Shopware versions.

Shopware versionSupported
Shopware <= 6.3
Shopware 6.4
Shopware 6.5
Shopware 6.6
Shopware 6.7
info

Clonable is currently working on publishing the Shopware extension in the official Shopware store. Until this process is complete, the extension is available as a ZIP file.

Installation

  1. Create a new Sales Channel (e.g. English)
  2. Install and activate the Clonable extension
  3. Make sure you have a Clonable account. Copy API key and Clone ID from “Quick setup guide” Clonable dashboard intallation guide
  4. Go to Settings, Extensions, Clonable » select the newly created Sales Channel (English) » Enable » Paste API key and Clone ID » Test API Credential » Save when success Shopware test API credentials
  5. Select “Translate category names” and “Translate product names” (Save again)

Required settings

For every newly created foreign language you create a separate Sales Channel in Shopware. Within Shopware, you place the same content, in the same language as in your default store (e.g. German). The most important settings in Shopware are:

  • Language default store in Shopware must match the Locale code of your site in Clonable (Site settings » General Settings) Default language in Shopwarelanguage default store shopware

Locale code Clonable dashboard locale code clonable dashboard

The most important settings for the Sales channel are:

  • Language: the language of the Sales channel must be the same as the language of the clone.
  • URL: the URL of the sales channel must also be the same as the URL of the clone (including any subfolder). Clonable detects the default language, applies all the translation settings from the Clonable dashboard and keeps translations in sync.

Manual translations

Select the products and click on “Translate with Clonable” to translate product names. The task will be added to the Shopware queque, it could take some seconds to finalize (refresh your browser). Shopware manual translations

Translations of categories

To translate existing categories, use the CLI command. New categories will be translated automatically by the extension

Translations with CLI commands

To kick off the bulk translation during the initial installation, you can use a number of CLI commands.

Bulk product translations

To perform bulk product translations, you can use the command below to translate all product names. The command will apply the settings that are currently active to all product names within that sales channel, including sales channels that have already been translated or manually adjusted. Please note: the command does not ask for confirmation.

$ ./bin/console clonable:translate:products {SALES_CHANNEL_ID}

Bulk category translations

To perform bulk category translations, you can use the command below to translate all categories. The command will apply the settings that are currently active to all categories within that sales channel, including sales channels that have already been translated or manually adjusted. Please note: the command does not ask for confirmation.

$ ./bin/console clonable:translate:categories {SALES_CHANNEL_ID}