All pages
Powered by GitBook
1 of 1

Loading...

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 Shopware 6).

Note: Please use the "" in the Shopware 6 Cloud.


Download

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

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


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:

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

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


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


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:

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

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.

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

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:

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 customization changes, but you have probably already removed this block:

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

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:

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

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

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:

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:

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:

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:

State: Shopware 6.7.0

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

  • composer.json
    "require": {
     "shopware/core": "6.6.*"
    },
    
    "require": {
     "shopware/core": "6.7.*"
    },
    base.html.twig
    {% block base_header %}
    
    >>
    {% block base_body_inner %}
    composer.json
    "require": {
     "shopware/core": "6.5.*"
    },
    
    "require": {
     "shopware/core": "6.6.*"
    },
    composer.json
    "require": {
     "shopware/core": "6.4.*"
    },
    
    "require": {
     "shopware/core": "6.5.*"
    },
    composer.json
    "require": {
     "shopware/core": "6.3.*"
    },
    
    "require": {
     "shopware/core": "6.4.*"
    },
    shopware.theme["..."] => theme_config('..')
    
    >>
    shopware.config.core... => config('core...')

    Activate/deactivate example implementations

    Structure and function

    Update

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

    Manual update

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

    Shopware 6.7

    Note: Whether your existing version can continue to be used with Shopware 6.7 depends primarily on your individual customizations. We recommend testing this first in a test or staging environment.

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

    Shopware 6.6

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

    Shopware 6.5

    Shopware 6.4

    Install extensions manually
    ThemeWare® Customizing App
    ThemeWare® Customizing Plugin
    Request ThemeWare® Utilities for free | ThemeWare® Service PortalThemeWare®
    ThemeWare® Utilities
    Request ThemeWare® Utilities for free | ThemeWare® Service PortalThemeWare®
    ThemeWare® Utilities
    Logo
    Logo
    Shopware 6.6: A look ahead | ThemeWare® Service PortalThemeWare®
    Logo
    Shopware 6.7 – What You Need to Know | ThemeWare® Service PortalThemeWare®
    Logo
    Shopware 6.5 – all about the major releaseShopware's Blog - Ecommerce News
    Shopware 6.5 – all about the brand new major release
    Logo