How to use Pearl Theme on multiple store views. Important update / install instructions

Starting with Pearl Theme release 1.5.5 (October 20, 2017), Frontend Options functionality is improved, and the options are now available at store view level. For this reason, a different approach is necessary when using the theme on multiple store views.

Sharing the same theme with the same locale language on multiple stores/store views will lead to overwriting the LESS/CSS files and potential design/functionality issues.

To avoid potential conflicts, you should use a separate set of LESS/CSS files for each individual store/storeview. In order to make sure you have separate sets of LESS/CSS for each store/store view,  please choose one of the following approaches below, while taking into consideration this important note:

Important note: If you upgraded from a theme version older than 1.5.5 by overwriting theme files, please manually delete the app/code/WeltPixel/FrontendOptions/view/frontend/web/css/ source/_module.less file, it is not used anymore starting with release 1.5.5 and it causes LESS generation issues if this file is still present. All the custom LESS generation was moved to view/frontend/web/css/source/_store_STORECODE_extend.less file.

1. Use different store locale options (EN, FR, ..) for each store view when using Pearl Theme on multiple store views.You should not have the same locale language for two store views Stores->Configuration->General->General->Locale Options->Locale .

2. Create different  Pearl Child Themes for each store view,  if using the same language on multiple  store views. Please find below the steps to create a new child theme for each store view:

STEP 1:

Go to   /app/design/frontend/Pearl/

Duplicate weltpixel_custom directory (with all sub folders and files) and rename the newly created folder to weltpixel_custom_storeview2 (or what name you want to use for the custom child theme).

STEP 2:

Go to   /app/design/frontend/Pearl/weltpixel_custom_storeview2/theme.xml

Open the file for editing, and change the <title> of the new child theme. Also, make sure you change the <parent> to be Pearl/weltpixel_custom, as shown below:

<theme xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Config/etc/theme.xsd">

    <title>Custom Pearl Theme for Magento 2 - storeview 2</title>

    <parent>Pearl/weltpixel_custom</parent>

    <media>

       <preview_image>media/preview.png</preview_image>

    </media>

</theme>

STEP 3:

Go to /app/design/frontend/Pearl/weltpixel_custom_storeview2/registration.php

Open the file for editing and change the new theme path:

<?php

\Magento\Framework\Component\ComponentRegistrar::register(

    \Magento\Framework\Component\ComponentRegistrar::THEME,

    'frontend/Pearl/weltpixel_custom_storeview2',

    __DIR__

);

STEP 4:

Go to Admin->Content->Configuration

And apply the newly created child theme on the desired store/store view.