# 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](https://store.shopware.com/en/extensions/?p=1\&o=12\&n=21\&c=2069\&shopwareVersion=6) or our free "ThemeWare® Customizing Plugin" (an extension based on the plug-in system of Showpare 6).

{% hint style="info" %}
**Note**: Please use the "[ThemeWare® Customizing App](https://knowledge.themeware.design/more-knowledge/themeware-tools/themeware-customizing-app)" in the Shopware 6 Cloud.
{% endhint %}

***

## Download

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

{% embed url="<https://service.themeware.design/en/themeware-utilities>" %}
ThemeWare® Utilities
{% endembed %}

{% hint style="warning" %}
**Important**: Please note that we offer the "ThemeWare® Customizing Plugin" free of charge and **cannot provide support** for the plugin or individual customisations.
{% endhint %}

***

## 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:

{% content-ref url="../../knowledge-base/shopware/configuration/extensions/installing-extensions-manually" %}
[installing-extensions-manually](https://knowledge.themeware.design/knowledge-base/shopware/configuration/extensions/installing-extensions-manually)
{% endcontent-ref %}

If the extension has been successfully installed, example implementations (a "test banner") appear in the Storefront:

<figure><img src="https://1979975522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F178YilsPBIFHBAxTvcMo%2Fuploads%2FSxL98NFu8R4YJGxyNcVo%2Fimage.png?alt=media&#x26;token=1d60c314-ea83-4907-817e-7acafa06752a" alt=""><figcaption><p>ThemeWare® Customizing Plugin</p></figcaption></figure>

### Activate/deactivate example implementations

From version 5.0, you can activate or deactivate the example implementations (e.g. the "test banner") in the plugin settings.

***

## 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.

You can always find the **download link for the latest version** via the ThemeWare® Utilities. If necessary, just register again:

{% embed url="<https://service.themeware.design/en/themeware-utilities>" %}
ThemeWare® Utilities
{% endembed %}

{% hint style="warning" %}
**Important**: Please note that we offer the "ThemeWare® Customizing Plugin" free of charge and **cannot provide support** for the plugin or individual customisations.
{% endhint %}

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.

{% hint style="info" %}
**Note**: You can find the latest version in the [ThemeWare® Utilities](https://service.themeware.design/en/themeware-utilities).
{% endhint %}

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

### Shopware 6.7

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

<pre class="language-json" data-title="composer.json"><code class="lang-json">"require": {
 "shopware/core": "6.6.*"
},

"require": {
<strong> "shopware/core": "6.7.*"
</strong>},
</code></pre>

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

In addition, the twig block for our example customisation changes, but you have probably already removed this block:

<pre class="language-twig" data-title="base.html.twig"><code class="lang-twig">{% block base_header %}
>>
<strong>{% block base_body_inner %}
</strong></code></pre>

{% hint style="info" %}
**Note**: Please note that your individual customizations may also need to be made compatible.
{% endhint %}

For more information about the extensive changes to the storefront in Shopware 6.7, please visit the ThemeWare® Service Portal:

{% embed url="<https://service.themeware.design/en/news/20250519-shopware-6.7-what-you-need-to-know>" %}

### 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:

<pre class="language-json" data-title="composer.json"><code class="lang-json">"require": {
 "shopware/core": "6.5.*"
},

"require": {
<strong> "shopware/core": "6.6.*"
</strong>},
</code></pre>

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

{% hint style="info" %}
**Note**: Please note that your individual customizations may also need to be made compatible.
{% endhint %}

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

{% embed url="<https://service.themeware.design/en/news/20240308-shopware-6.6>" %}

### 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:

<pre class="language-json" data-title="composer.json"><code class="lang-json">"require": {
 "shopware/core": "6.4.*"
},

"require": {
<strong> "shopware/core": "6.5.*"
</strong>},
</code></pre>

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:

{% embed url="<https://www.shopware.com/en/news/shopware-6-5/>" %}
Shopware 6.5 – all about the brand new major release
{% endembed %}

### 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:

<pre class="language-json" data-title="composer.json"><code class="lang-json">"require": {
 "shopware/core": "6.3.*"
},

"require": {
<strong> "shopware/core": "6.4.*"
</strong>},
</code></pre>

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:

<pre class="language-twig"><code class="lang-twig">shopware.theme["..."] => theme_config('..')
>>
<strong>shopware.config.core... => config('core...')
</strong></code></pre>

> State: Shopware 6.6.0