ThemeWare® Customizing Plugin

In this article you will find out everything regarding the free "ThemeWare® Customizing Plugin".

Individual customizations have to be implemented in Shopware 6 with an own theme or an extension (plugin or app).

For the integration of individual customizations you may use an extension from the Shopware Community Store or our free "ThemeWare® Customizing Plugin" (an extension based on the plug-in system of Showpare 6).

Note: Please use the "ThemeWare® Customizing App" in the Shopware 6 Cloud.

---

Download

You can find the download link for the free "Customising plugin" via the ThemeWare® Utilities:

ThemeWare® Utilities | ThemeWare® Service Portal

ThemeWare® Utilities

Important: Please note that we offer the "ThemeWare® Customizing Plugin" free of charge and cannot provide support for the plugin or individual customisations.

---

Installation

The extension has to be uploaded using the administration of Shopware via "Extensions" => "My extensions" and the button "Upload extension".

Then install and activate the extension.

After activation, recompile your ThemeWare® theme once (just save the theme configuration unchanged, for example) and clear the Shopware cache.

Please find more information regarding the manual installation of extensions in the article:

Install extensions manually

If the extension has been successfully installed, a "test banner" appears in the storefront:

ThemeWare® Customizing Plugin

---

Structure and function

The "ThemeWare® Customizing Plugin" offers the possibility to deposit individual customizations. The following folders and files are relevant:

• File "base.scss":

  • Basis for all customizations with CSS/SCSS

  • Folder: src/Resources/app/storefront/src/scss

  • Note: The file contains sample customizations which can be edited or deleted.

• File "base.html.twig":

  • Example of template customization with Twig/HTML

  • Folder: src/Resources/views/storefront

  • Note: The file contains sample customizations which can be edited or deleted.

• Assets

  • Folder: src/Resources/public

---

Update

As the plugin is free of charge and not available via the Shopware Store, there is currently no automatic update option.

Deactivate the plugin before you perform a Shopware update. You can find information on how to update your plugin manually below:

Manual update

As all changes are overwritten on file level when updating extensions, it is important to backup the folder custom/plugins/TcinnCustomizing/src before updating and upload it again after the update.

Note: You can find the latest version in the ThemeWare® Utilities.

Below you will find notes on manual update options for the latest Shopware 6 major releases:

Shopware 6.6

To make the "Customizing Plugin" compatible with Shopware 6.6, it is sufficient to modify the required Shopware version in the file "composer.json" as follows:

composer.json

"require": {
 "shopware/core": "6.5.*"
},

"require": {
 "shopware/core": "6.6.*"
},

This makes the extension compatible with Shopware 6.6 and it does not need to be updated.

Note: Please note that your individual customizations may also need to be made compatible.

For more information on the extensive changes to the storefront in Shopware 6.6, please visit the Shopware Blog:

Shopware 6.6: A look ahead | ThemeWare® Service Portal

Shopware 6.5

To make the customizing plugin basically compatible with Shopware 6.5, it is sufficient to modify the required Shopware version in the file "composer.json" as follows:

composer.json

"require": {
 "shopware/core": "6.4.*"
},

"require": {
 "shopware/core": "6.5.*"
},

This makes the extension compatible with Shopware 6.5 and it does not need to be updated.

Please note that your individual customizations may also need to be made compatible. For more information on the extensive changes to the storefront in Shopware 6.5, please visit the Shopware Blog:

Shopware 6.5 – all about the major releaseShopware

Shopware 6.5 – all about the brand new major release

Shopware 6.4

To make the customizing plugin basically compatible with Shopware 6.4, it is sufficient to rename the file "main.scss" to "base.scss" and modify the required Shopware version in the file "composer.json" as follows:

composer.json

"require": {
 "shopware/core": "6.3.*"
},

"require": {
 "shopware/core": "6.4.*"
},

This will make the extension compatible with Shopware 6.4 and does not need to be updated.

Please note that your individual customizations may also need to be made compatible. The most important change in Shopware 6.4 is the retrieval of theme and Shopware variables:

shopware.theme["..."] => theme_config('..')

shopware.config.core... => config('core...')

State: Shopware 6.6.0