Pearl Theme for Magento 2.

User Guide.

Version 1.14.9 - November 26, 2024

THEME FILES.

The theme includes the following files:

Theme and associated extension files
Documentation
Licensing
Theme sample data

Highly Modular Theme Package.

The theme comes with modular design and associated WeltPixel extensions that highly increase the theme functionality.

Pearl Theme files are located under below folder structure:

app/design/frontend/Pearl/weltpixel
app/design/frontend/Pearl/weltpixel_custom
pub/media
app/code/WeltPixel/Backend
app/code/WeltPixel/FrontendOptions
app/code/WeltPixel/DesignElements
app/code/WeltPixel/CustomHeader
app/code/WeltPixel/CustomFooter
app/code/WeltPixel/ProductPage
app/code/WeltPixel/CategoryPage
app/code/WeltPixel/Command
app/code/WeltPixel/SampleData
app/code/WeltPixel/LazyLoading
app/code/WeltPixel/OwlCarouselSlider

Associated WeltPixel extensions highly increase the theme functionality and are fully compatible with Pearl Theme saving you time that you can dedicate building your store instead of debugging compatibility issues. Extension Files are located under below folder structure, you can choose the extensions you need, and deactivate the ones you don't need - this way you code will be light, fast and more conflict free.

app/code/WeltPixel/NavigationLinks (MegaMenu)
app/code/WeltPixel/Quickview
app/code/WeltPixel/GoogleCards
app/code/WeltPixel/TitleRewrite
app/code/WeltPixel/SmartProductTabs
app/code/WeltPixel/MobileDetect
app/code/WeltPixel/InstagramWidget
app/code/WeltPixel/FullPageScroll
app/code/WeltPixel/GoogleTagManager
app/code/WeltPixel/Sitemap
app/code/WeltPixel/QuickCart
app/code/WeltPixel/ReviewsWidget
app/code/WeltPixel/Multistore
app/code/WeltPixel/ThankYouPage
app/code/WeltPixel/AjaxInfiniteScroll
app/code/WeltPixel/SearchAutoComplete
app/code/WeltPixel/LayeredNavigation
app/code/WeltPixel/Newsletter
app/code/WeltPixel/AdvanceCategorySorting
app/code/WeltPixel/ProductLabels
app/code/WeltPixel/SocialLogin
app/code/WeltPixel/AdvancedWishlist
app/code/WeltPixel/SpeedOptimization
app/code/WeltPixel/EnhancedEmail (Pearl Theme Professional Pack only)
app/code/WeltPixel/CmsBlockScheduler (Pearl Theme Professional Pack only)
app/code/WeltPixel/RecentlyViewedBar (Pearl Theme Professional Pack only)
app/code/WeltPixel/UserProfile (Pearl Theme Professional Pack only)
app/code/WeltPixel/GA4 (Pearl Theme Professional Pack only)
app/code/WeSupply/Toolbox - Integration with WeSupply - Magento Order Tracking

Modularity advantages.

Fast and light code - unnecessary sections or extensions from Pearl Theme theme can be disabled.
Easy debugging - each section of the theme can be disabled in order to identify a potential issue.
Easily replace sections of the theme with other 3rd party functionalities, easy integration without any coding needed. (Example: you can disable WeltPixel MegaMenu and use a 3rd party MegaMenu extension that you prefeer)

For even more speed: Modular Design Elements.

Disable any Design Elements that you don't use from admin options and corresponding code will not be loaded.
Not only the theme and extensions are highly modular but also the all design elements included in the theme.
Yes / No admin option for disabling elements not used.
Enable/ Disable: Bootstrap Grid, Icons, Tables, Toggle, Accordion, Tabs, Pricing Boxes, Headings and Blockquotes, Dividers, Brand lists, Responsive and Helpers, Smooth Scrolling, Icon Boxes, Alert Boxes, Testomonials, Flex Slider, Buttons, Sections/Parallax, Back to top Button, etc..

PREREQUISITES.

Magento Compatibility.

Before installing Pearl Theme on a Magento Store please check the theme compatibility. Pearl is currently compatible with the following Magento Open Source, Commerce & Commerce Cloud, B2B versions:

2.0 - 2.0.x
2.1 - 2.1.17
2.2 - 2.2.10
2.3.0 - 2.3.7-p4
2.4.0 - 2.4.7-p3

It is highly recommended to install the theme first on a testing server before you install it on a live (production) server.

Note: Make sure to enable Magento Developer Mode before installation - this guide can help: How to set Magento 2 Developer and Production Mode

Magento Commerce Cloud Compatibility.

Pearl Theme for Magento 2 is also compatible with Magento Commerce Cloud Edition or other read-only environments. The necessary patch is included in Pearl Theme Commerce Pack. More details under Magento Commerce Cloud Installation chapter.

Browser Compatibility.

Pearl Theme is compatible with most used modern browsers since Jan 1st, 2015 until today. We constantly check browsers compatibility with each release. Older browser versions, or other browsers not mentioned might also be compatible with Pearl Theme.

Compatible Browsers:

Chrome: starting with version 40
Firefox: starting with version 35
Safari: starting with version 7
Opera: starting with version 23
IE: starting with version 11
Edge: starting with version 38

Magento Marketplace.

Make sure you do not have other WeltPixel extensions installed via Magento Marketplace Composer as the same installed extensions are already included in Pearl Theme installation. If you have a clean installation or no WeltPixel products installed you can proceed forward with the installation and ignore below instructions.

When installed via Composer, the extension code is installed under ‘/vendor/weltpixel/’ folder. When manually installing an extension it is copied under ‘/app/code/WeltPixel/‘ so by duplicating the extension code in both locations you will experience installation issues. Follow below guide to uninstall all WeltPixel extensions installed via Magento Marketplace Composer (under /vendor/weltpixel/) before proceeding further with Pearl Theme installation. This guide can help: How to uninstall and remove a Magento 2 extension ( manual vs composer )

Quick Installation.

Pearl Theme GUI (browser) Installation.

Step 1:

Disable Magento Cache from System -> Cache Management -> Select All and hit disable and refresh all caches. Note: This step is required even if cache is disabled.

Step 2.

Unpack and upload the content from 'Theme Files' directory into the root of your Magento installation.

This process will not overwrite any file that you might have on your server, it will only merge them!

Note: If you're running Magento 2.3.0 - 2.3.2, please also copy the content from the Patches folder, making sure you select the Overwrite option when prompted.

Step 3.

In your browser go to www.yourmagentostore.com/pearl-theme-installation/ and simply follow the installation steps from the graphical interface, presented in your browser. See the installation video .

Note: Some Magento servers/versions have their index in the pub folder, as opposed to the root. If this is the case on your instance, you'll need to move the pearl-theme-installation folder into the pub directory or you won't be able to access it. This will generally manifest on the frontend via a 404 message.

Step 4.

Woohoo! Pearl Theme is installed and your store should already be looking awesome!

Note: In order to prevent unauthorised access to your installation GUI, we advise removing or renaming the folder ‘pearl-theme-installation’ from the root of your Magento installation once the installation is completed.

Troubleshooting:

If you experienced any issues or limitations with this quick GUI installation, see also Pearl Theme - Advanced SSH Installation. SSH installation does the same thing but you are required to issue the commands step by step via CLI. Some servers may have high security configurations and may limit the functionality of this GUI Installer.

ADVANCED SSH Installation.

Pearl Theme. SSH Installation Steps.

Step 1:

Disable Magento Cache from System -> Cache Management -> Select All and hit disable and refresh all caches. Note: This step is required even if cache is disabled.

Step 2.

Unpack and upload the content from 'Theme Files' directory into the root of your Magento installation.

This process will not overwrite any file that you might have on your server, it will only merge them!

Note: If you're running Magento 2.3.0 - 2.3.2, please also copy the content from the Patches folder, making sure you select the Overwrite option when prompted.

Step 3.

Connect via SSH connection to your server and run the following commands under location 'mymagentostore.com/html':

If you encounter any conectivity or permissions problems your hosting provider should help providing all necessary details.

Depending on your hosting provider, for some servers command 'php bin/magento' does not work, you may want to replace it with '/usr/local/php56/bin/php-cli bin/magento' or '/usr/local/php70/bin/php-cli bin/magento' . Example: '/usr/local/php70/bin/php-cli bin/magento deploy:mode:set developer'

# a. make sure Developer Mode is enabled for your store
php bin/magento deploy:mode:set developer

#b1. You can enable all the extensions with the following command

php bin/magento module:enable WeltPixel_Backend WeltPixel_FrontendOptions WeltPixel_DesignElements WeltPixel_CustomHeader
 WeltPixel_CustomFooter WeltPixel_NavigationLinks WeltPixel_ProductPage WeltPixel_OwlCarouselSlider WeltPixel_LazyLoading
 WeltPixel_CategoryPage WeltPixel_Command WeltPixel_Quickview WeltPixel_GoogleCards WeltPixel_TitleRewrite WeltPixel_SmartProductTabs
 WeltPixel_MobileDetect WeltPixel_InstagramWidget WeltPixel_FullPageScroll WeltPixel_GoogleTagManager WeltPixel_Sitemap WeltPixel_QuickCart
 WeltPixel_ReviewsWidget WeltPixel_Multistore WeltPixel_ThankYouPage WeltPixel_AjaxInfiniteScroll WeltPixel_SearchAutoComplete
 WeltPixel_ProductLabels WeltPixel_LayeredNavigation WeltPixel_Newsletter WeltPixel_AdvanceCategorySorting WeltPixel_CmsBlockScheduler
 WeltPixel_EnhancedEmail WeltPixel_RecentlyViewedBar WeltPixel_SocialLogin WeltPixel_AdvancedWishlist WeltPixel_UserProfile
 WeltPixel_SpeedOptimization WeltPixel_GA4 --clear-static-content

# b2. enable WeltPixel Theme modules one by one (Start with WeltPixel_Backend)
php bin/magento module:enable WeltPixel_Backend --clear-static-content
php bin/magento module:enable WeltPixel_FrontendOptions --clear-static-content
php bin/magento module:enable WeltPixel_DesignElements --clear-static-content
php bin/magento module:enable WeltPixel_CustomHeader --clear-static-content
php bin/magento module:enable WeltPixel_CustomFooter --clear-static-content
php bin/magento module:enable WeltPixel_NavigationLinks --clear-static-content
php bin/magento module:enable WeltPixel_ProductPage --clear-static-content
php bin/magento module:enable WeltPixel_OwlCarouselSlider --clear-static-content
php bin/magento module:enable WeltPixel_MobileDetect --clear-static-content
php bin/magento module:enable WeltPixel_LazyLoading --clear-static-content
php bin/magento module:enable WeltPixel_CategoryPage --clear-static-content
php bin/magento module:enable WeltPixel_Command --clear-static-content

#b3. enable WeltPixel extensions included in Theme Pack (optional)

php bin/magento module:enable WeltPixel_Quickview --clear-static-content
php bin/magento module:enable WeltPixel_GoogleCards --clear-static-content
php bin/magento module:enable WeltPixel_TitleRewrite --clear-static-content
php bin/magento module:enable WeltPixel_SmartProductTabs --clear-static-content
php bin/magento module:enable WeltPixel_InstagramWidget --clear-static-content
php bin/magento module:enable WeltPixel_FullPageScroll --clear-static-content
php bin/magento module:enable WeltPixel_GoogleTagManager --clear-static-content
php bin/magento module:enable WeltPixel_Sitemap --clear-static-content
php bin/magento module:enable WeltPixel_QuickCart --clear-static-content
php bin/magento module:enable WeltPixel_ReviewsWidget --clear-static-content
php bin/magento module:enable WeltPixel_Multistore --clear-static-content
php bin/magento module:enable WeltPixel_ThankYouPage --clear-static-content
php bin/magento module:enable WeltPixel_AjaxInfiniteScroll --clear-static-content
php bin/magento module:enable WeltPixel_SearchAutoComplete --clear-static-content
php bin/magento module:enable WeltPixel_ProductLabels --clear-static-content
php bin/magento module:enable WeltPixel_LayeredNavigation --clear-static-content
php bin/magento module:enable WeltPixel_Newsletter --clear-static-content
php bin/magento module:enable WeltPixel_AdvanceCategorySorting --clear-static-content
php bin/magento module:enable WeltPixel_AdvancedWishlist --clear-static-content
php bin/magento module:enable WeltPixel_SpeedOptimization --clear-static-content
php bin/magento module:enable WeSupply_Toolbox --clear-static-content
php bin/magento module:enable WeltPixel_CmsBlockScheduler --clear-static-content
php bin/magento module:enable WeltPixel_EnhancedEmail --clear-static-content
php bin/magento module:enable WeltPixel_RecentlyViewedBar --clear-static-content
php bin/magento module:enable WeltPixel_UserProfile --clear-static-content
php bin/magento module:enable WeltPixel_GA4 --clear-static-content


# c. Following command needed only for Pearl Theme sample data installation, otherwise can be skipped
php bin/magento module:enable WeltPixel_SampleData --clear-static-content


# d. clear cache
php bin/magento cache:flush


# e. run magento upgrade scripts
php bin/magento setup:upgrade


# f. generate static content
rm -rf pub/static/_requirejs
rm -rf var/view_preprocessed

#g. Theme Sample Settings Import, depending on required demo store homepage / settings, use different demo version 'v2', 'v3', ...
#   Run below commands even if you do not use a Pearl sample homepage, in below order:

php bin/magento weltpixel:import:demo --store=GLOBAL --demoVersion=v1
php bin/magento weltpixel:theme:configurator --store=GLOBAL --homePage=v1 --header=v1 --categoryPage=3columns --productPage=v1 --footer=v3
php bin/magento weltpixel:cleanup
php bin/magento weltpixel:less:generate
php bin/magento ca:cl

Theme layout Pre-configuration via SSH

Page layout configuration can be done also from Magento Admin, if you want to customize the theme using Pearl Theme admin options skip below instructions and continue to Step 4.

Some users may prefer using SSH import settings to pre-configure pages layout. If you find yourself in this case you can use the theme configuration options below to setup the layout for each page type.

Visit Pearl Demo Store and choose the layout you like for each page type. Available options below:

[--homePage[="..."]] = v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v14, v15

[--header[="..."]] = v1, v2, v3, v4

[--categoryPage[="..."]] = 2columns, 3columns, 4columns, 5columns

[--productPage[="..."]] = v1, v2, v3, v4

[--footer[="..."]] = v1, v2, v3, v4

[--store="..."] = default, GLOBAL

[--demoVersion] = v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v14, v15

When changing between sample home pages make sure to run corresponding import options as each homepage comes with predefined theme settings.

php bin/magento weltpixel:import:demo [--store="..."] [--demoVersion]
php bin/magento weltpixel:theme:configurator [--store="..."] [--homePage[="..."]] [--header[="..."]] [--categoryPage[="..."]] [--productPage[="..."]] [--footer[="..."]]
php bin/magento weltpixel:cleanup
php bin/magento weltpixel:less:generate
php bin/magento ca:cl

Example how to set Homepage V8 with coresponding V8 theme options, Header Version 1, Category Page on 3 columns, Product Page Version 1, Footer Version 3:

php bin/magento weltpixel:import:demo --store=GLOBAL --demoVersion=v8
php bin/magento weltpixel:theme:configurator --store=GLOBAL --homePage=v8 --header=v1 --categoryPage=3columns --productPage=v1 --footer=v3
php bin/magento weltpixel:cleanup
php bin/magento weltpixel:less:generate
php bin/magento ca:cl

Step 4.

Enable the theme from Magento Admin

Go to Admin -> Content ->Design Configuration and set your default theme to Custom Pearl Theme for Magento 2, for desired store view.

or you have the possibility to Enable the theme directly from SSH

php bin/magento weltpixel:theme:activate --store=GLOBAL --themePath="Pearl/weltpixel_custom"
php bin/magento setup:upgrade
php bin/magento weltpixel:less:generate
php bin/magento weltpixel:css:generate --store=default
php bin/magento cache:clean

Step 5.

Woohoo! Pearl Theme is installed and your store should be already looking awesome!

Magento Commerce Cloud Installation.

The process of installing the Pearl Theme depends on the state of your Magento Cloud environment. States can be either Ideal or Non-Ideal and the state depends on various environment variables, most notably the phase in which the Static Content Deployment happens. A state cannot be ideal unless the Static Content Deploymeny happens in the Build phase. To find out more about states, and how you can check in which state your environment is, check out Adobe's documentation on Smart Wizards.

Pearl Theme for Magento Commerce Cloud Installation Processes

Ideal State Installation Process - Ideal State Installation Guide
Non-Ideal State Installation Process - Non-Ideal State Installation Guide

Magento Marketplace Installation.

Guide for users who purchsed Pearl Theme from Magento Marketplace

Step 1. Connect Marketplace account.

Go to your Magento Admin > Web Setup Wizard and select Component Manager.

Sign in and copy-paste your Public key and Private Key in the corresponding fields. You can find the keys in Magent Marketplace account. It may be necessary to create the keys first under Magento Marketplace account if this is the first time you are using Magento Marketplace keys. If you are already signed in with your Magento credentials (public and private key), you don’t need to sign in again.

After you sign in, if page loading is taking too long, try to refresh the page.

Step 2. Syncronize purchased extensions.

Click Sync in order to synchronise your purchases from Magento Marketplace with your magneto installation.

You will see now that you have new purchased extensions (full list available after you click Install).

Click Install and you will be redirected to Extensions Grid page where you can select which extension you want to install.

Step 3. Select the theme for installation.

Select Pearl Theme ( weltpixel/m2-theme-frontend-weltpixel ) and all associated packs that start with 'weltpixel/' identifier. ( weltpixel/m2-weltpixel-category-page, etc..). Make sure you select all 23 associated weltpixel dependancy packs or the theme installation will be incomplete.

Click Install.

Make sure Cron is configured on your magento installation. Now the installer will start.

Step 4. Compatibility Check

Click the Next button in order to proceed with Step 1 of the installer. Now the installer will start to check your environment for the correct PHP version, PHP extensions, Cron, file permission and compatibility. Just click Next on all three steps, and the module will be successfully installed.

Note: If the Readiness check fails, first thing try verifying that the Cron Jobs are running and fixing this may also solve remaining PHP check failures. If necessary, follow the links provided for the type of error you receive. Contact your system administrator to properly setup Cron Jobs for your store.

Step 5. Installation Process

The installation process can take a couple of minutes. Open the Console Log if you want to supervise the installation process. Wait until you are redirected to the SUCCESS page.

Step 6. Add Sample Pictures. (optional)

If Pearl Theme sample data installation is required, download Pearl Sample Images from here as sample images are not supported on Magento Marketplace. Unzip and upload the content in your magento root installation, file structure "pub/media/wysiwyg" and "pub/media/weltpixel" is already created, is enough to copy and paste 'pub' directory in your magento root installation.

Note: Make sure to merge the files with the 'pub' folder and not overwrite it.

Step 7. Activate Pearl Theme.

Activate theme from admin :

Go to System > Configuration > (select store view) > Edit > Applied Theme > Custom Pearl Theme for Magento 2
Go to System > Cache Management > Regenerate Pearl Theme LESS/CSS Files
Go to System > Cache Management > Flush Magento Cache

Activate theme via SSH, in the root of the magento installation execute below commands:

php bin/magento weltpixel:theme:activate --store=GLOBAL --themePath="Pearl/weltpixel_custom"
php bin/magento setup:upgrade
php bin/magento weltpixel:less:generate
php bin/magento weltpixel:css:generate --store=default
php bin/magento cache:clean

Step 8. Theme Layout Pre-Configuration or restore to default.

If you want to preconfigure the theme with sample data and sample pages, or restore to default settings later, download the GUI Pearl Theme installer from here, unzip the content and copy the folder 'pearl-theme-installation' it in the root of your Magento installation.

In your browser go to www.yourmagentostore.com/pearl-theme-installation/ and follow the steps from the graphical interface. SKIP the installation steps (1,2,3) until you get to STEP 4 - Demo Import, STEP 5 - Theme Configurator and STEP 6 - Clear Cache. See the installation video .

RUN Step 4 - Import predefined demo settings and set demo homepage - without this step the pages may look broken.
RUN Step 5 - Theme Configurator - you also have these options in admin and you can later change the settings
RUN STEP 6 - Clear Cache in order for the layout changes to apply.

Woohoo! Pearl Theme is installed and configured and your store should be already looking awesome!

Note: In order to prevent unauthorised access to your installation GUI, we advise to remove or rename the folder ‘pearl-theme-installation’ from the root of your Magento installation once the installation is completed.

Upgrade Theme.

How to update Pearl Theme to latest version.

We are constantly releasing theme updates containing fixes, new features and compatibility adjustments with latest Magento releases. You can check Pearl Theme Change log for more details.

Follow this detailed article on our Knowledge Base: How can I upgrade / update Pearl Theme to latest version for detailed steps on how to upgrade the theme to latest version.

Customize Theme (optional)

Check out in below sections how to make customisations to Pearl Theme if needed.
Small Customisations - usefull for small adjustments ( CSS, JS, HTML) using Pearl Theme admin options.
Child Theme Customisations - using Pearl Child Theme already included in this pack for more advanced customisations.

CUSTOM CSS & JS.

It is easy to add simple customization by inserting your CSS and JS code in a few fields introduced by the Pearl theme in your backend.

Your Custom CSS can be applied on each breakpoint which is set in Weltpixel -> Frontend options -> Breakpoints.

You can have your Custom CSS for each breakpoint set in the Weltpixel -> Frontend options -> Breakpoints area.

Custom CSS and JS for category pages.

You can add your own Custom CSS and JS for each individual category page.

Your Custom CSS for categories can be inserted in Products -> Categories -> [desired category] -> WeltPixel options.

So, if you wish to add custom CSS for a category page you just have to add desired CSS classes and declarations.

Custom CSS and JS - static pages

It is easy to add simple customization for a static page by inserting your CSS and JS code in a few fields introduced by the Pearl theme in your backend.

Your Custom CSS for static pages can be inserted in Content -> Pages -> [edit desired page] -> Design.

Custom CSS & JS - static blocks.

It is easy to add simple customization for a static page by inserting your CSS and JS code in a few fields introduced by the Pearl theme in your backend.

Your Custom CSS for static blocks can be inserted in Content -> Blocks -> [edit desired block] and right below the magento editor you can find the fields for the custom CSS and JS.

Child Theme Customizations

Pearl Child Theme Included is already in the package

If you wish to add complex customizations on the theme, go to Admin -> Content ->Design Configuration and set Custom Pearl Theme for Magento 2, for desired store view.

Now, in the file web/css/source/wp_custom.less, you can add your custom CSS. By respecting Magento best practice and making all customizations in a child theme, Pearl Theme will always be update proof and you will not have any risk of loosing your changes.

Note: When you update the theme and if you added your CSS customizations in the wp_custom.less file, make sure you do not overwrite it.

TRANSLATE PEARL THEME.

You can translate Pearl Theme by following next steps:

1. Go to the root of your magento installation ('yourmgentoinstall.com/html') and run below command to export all theme and magento translations.
```
 php bin/magento i18n:collect-phrases --output="dictionary.csv" -m
```
2. Find the generated dictionary.csv file in your root magento installation, open this file , it should contain 4 columns, leave just the first 2, the rest you can delete, they should contain the same english texts.
3. Using a simple editor translate only the second column and the text between “ ”. Make sure all the strings in your .csv file start and end with double quotes, and are separated with comma[,], not semi-colon [;] or any other mark. Example: "Custom Footer","Benutzerdefinierte Fußzeile"
4. After you edited the file, rename the file using magento locale format ( Example: fr_FR.csv, it_IT.csv). The file name must exactly match the locale, and it is case sensitive xx_YY.csv.
5. Copy the file into app/design/frontend/Pearl/weltpixel/i18n/ directory
6.a. For frontend translations make sure you have set your locale in Stores -> Configuration -> General -> Locale Options -> Locale -> Select your language
6.b. For backend translations make sure you have set your users Interface Locale in Account Settings -> Account Information -> Interface Locale -> Select your language
7. Refresh all Magento caches and check results

TRANSLATE MODULES.

You can translate a WeltPixel module by following next steps:

1. Go to app/code/WeltPixel/ModuleYouWantToTranslate/i18n where you should find en_US.csv.
2. Copy the content of this file in a new .csv file using magento locale format ( Example: fr_FR.csv, it_IT.csv). The file name must exactly match the locale, and it is case sensitive xx_YY.csv.
3. Using a simple editor translate only the second column and the text between “ ”. Make sure all the strings in your .csv file start and end with double quotes, and are separated with comma [,], not semi-colon [;] or any other mark. Example: "Custom Footer","Benutzerdefinierte Fußzeile"
4.a. For frontend translations make sure you have set your locale in Stores -> Configuration -> General -> Locale Options -> Locale -> Select your language
4.b. For backend translations make sure you have set your users Interface Locale in Account Settings -> Account Information -> Interface Locale -> Select your language
5. Refresh all Magento caches and check results

CHANGE LOGO.

You can change Pearl Theme logo by following next steps:

Step 1. Go to Magento Admin > Content > Configuration > [store] > Header > Logo Image [Upload] which applies to both Desktop and Mobile. If you'd like to set a different logo for mobile, head to Magento Admin > Content > Configuration > [store] > WeltPixel Header - Mobile Logo > Mobile Logo Image [Upload] .

Step 2. Set Logo Image Width and Height, just fill in numbers, no need to use 'px'.

Step 3. Clear Pearl Theme related cache.
Go to System > Cache Management > WeltPixel Cache Management > Regenerate Pearl Theme Less / Css

Step 4. Woohoo! Your awesome logo is now applied!

Frontend Options.

In this tab you can setup general settings for the frontend of the theme.

IMPORTANT / RECOMMENDED:

1. After changing theme settings make sure to clear related caches: Regenerate Pearl Theme CSS, Flush Magento Cache, Clear Browser Cache (if necessary also Flush JS/CSS Cache, Flush Catalog Images Files, Flush Cache Storage)

2. Make sure you are changing the settings on the right store view, settings may be different in default config vs. storeview

3. NEW: Frontend Options now available at store view level. Use different store locale options (EN, FR, ..) when using Pearl Theme on multiple store views. If using the same language on multiple store views, you should create separate a Pearl Child Theme for each store view. If you only use a single store view no action is necessary.

Breakpoints.

Go to Weltpixel -> Frontend options -> Breakpoints and set your desired breakpoints for different screen sizes resolutions starting from low resolution dedicated for mobile, tablet and up to large screens.

Section width

Go to Weltpixel -> Frontend options -> Section Width and set different widths for the pages or elements of the store:

Page Main: set the width of the main page [in px or %] - this should be set to 100%, all below elements refeer to this value. If you set it to a different value, keep in mind that all the values below expressed in % will refeer to this value and not to 100%.
Footer: set the width of the footer [in px or %] - Example: 1400px, 90%, 100% - for full width use 100%.
Row: set the width of row [in px or %] - you can set the 'row' class width from this value, when you call this class in any page in your store it will show the page width defined here.
Default Page: set width of the default page set [in px or %] - default store pages are pages like: Checkout page, Cart Page, Login Page, and other magento default pages. From here you can set the width of this pages in px or %.
Cms Page: set width of the CMS pages [in px or %] Set the width of CMS pages in your store, for example Homepage or other pages you built. For example you may want to use full width for your Homepage and 1400px for Category Page / Product Page.
Category Page: set width of the category page [in px or %] - Example: 1400px or 90%, for full width use 100%.
Product Pageset width of product page [in px or %] - Example: 1400px or 90%, for full width use 100%.
Header - set the width of the header from Store > Cofiguration > WeltPixel > Custom Header section

Main Options and Google Font Options

Go to Weltpixel -> Frontend options -> Main options and set colors:

Primary color: set primary color used on the store
Secondary color: set secondary color used on the store
Page Background Color: set background color of the store
Active Color: set active color
Error Color: set error color

Go to Weltpixel -> Frontend options -> Google Font Options

Load Google Fonts Asynchronously:If set to yes, the Google fonts will be loaded Asynchronously which eliminates render blocking CSS and should speed up the loading of the page.

Headings H1 up to H6 and Paragraphs.

Go to Weltpixel -> Frontend options -> H1 and set font, font size, font color and more for the H1 tag:

Text Color: set text color
Google Font Family: set Google Font Family; ! Important to select also 'Character Set' for the new font, in order for font to change.
Google Font Character Set: set Google Font Character Set;
Font Weight: set Font weight [ between 300 and 800 ]
Font Size: set Font size [ in px ]
Font Style: set Font Style, for example you can enter normal or italic
Line Height: set Line Height [ in px ]

Headings from H1 up to H6 tags and also the Paragraphs can be configured.

Default Buttons.

Go to Weltpixel -> Frontend options -> Default Buttons and customize the Default Buttons:

Text Color: set text color for default buttons
Hover Color: set text color on hover over the default button
Background Color: set background color of the default buttons
Hover Background Color: set background color on hover over the default buttons
Border Color: set border color for the default buttons
Border Hover Color: set border color on hover over default buttons
Border Radius: set border radius for default buttons
Google Font Family: set border radius for default buttons [ in px ]
Google Font Character Set: set text Google Font Family used for default buttons text
Font Weight: set Font Weight for the text in the default buttons
Font Size: set Font Size for the text in the default buttons [in px]
Line Height: set Line Height of the text in default buttons [ in px ]

Primary Buttons.

Go to Weltpixel -> Frontend options -> Primary Buttonsand customize the Primary Buttons:

Text Color: set text color for buttons
Hover Color: set text color on hover over primary buttons
Background Color: set background color for primary buttons
Hover Background Color: set background color on hover for primary buttons
Border Color: set border color for primary buttons
Border Hover Color: set border color on hover over primary buttons
Line Height(px): set Line Height of text in primary buttons [ in px ]
Border Radius: Set border radius for buttons. Example: 1px. Important: This setting is applied on primary buttons.

Ratings

Go to Weltpixel -> Frontend options -> Ratings and set color and size for Ratings:

Rating Active Color: set color for active stars
Rating Inactive Color: set color for Inactive stars
Rating Icon Size: set Icon size for Ratings [ in px ]

Form inputs.

Input Background: set input background color
Input Border Color: set input border color
Input Border: set input border (ex. 1px solid @form-element-input__border-color;)
Input Border Radius: set input border radius [ in px ]
Input Height: set input height [ in px ]
Input Font Size: set input font size [ in px ]
Input Font Color: set input font color
Google Input Font Family: set Google Font Family
Google Input Font Character Set: set Google Font Character Set
Input Font Weight: set Font Weight
Input Line Height: set font Height
Input Font Style: set font Style
Input Placeholder Color: set placeholder color

Breadcrumbs

Go to Weltpixel -> Frontend options -> Breadcrumbs and set colors, size and style for the breadcrumbs:

Breadcrumbs Font Size: set font size for breadcrumbs [ in px ]
Breadcrumbs Font Style: set font style for breadcrumbs
Breadcrumbs Separator Color: set breadcrumbs separator color
Breadcrumbs Current Page Color: set breadcrumbs current page color
Breadcrumbs Color: set breadcrumbs color
Breadcrumbs Link Hover Text Decoration: set breadcrumb color on hover
Breadcrumbs Background: set breadcrumbs background color
Breadcrumbs Padding Top Bottom: set Top and Bottom padding for Breadcrumbs text. Example: 15px

Custom Header

In this area you can customize the header and choose from 4 different header styles already prepared.

Header Version 1

Header Version 2

Header Version 3

Header Version 4

General Settings.

Go to Weltpixel -> Custom Header -> General Settings and choose the type of header you like:

Header Style select the version of header you like, Version 1 to 4

Global Promo Message.

Go to Weltpixel -> Custom Header -> Global Promo Message and choose [ Yes / No ] if you want to show a top bar with promo message or any message for your customers. You can control the bar color and the text color. Once users close this message it will not show again. Useful if you have promotions or special announcements to comunicat.

Enable [ Yes / No ] If enabled, 'weltpixel_global_promo_message' static block content is displayed with below color options.
Hide Global Promo Message on mobile [ Yes / No ] If set to Yes, the Global Promo Message will not be displayed on mobile devices.
Text Color Set the color code for the text featured in promo box, example: #B05D5D
Background Color Set the background color code for the promo box, example: #FFE8E8
Global Promo Position Choose the position of the Global Promo Message.
Display Global Promo Message [ Cookie Based / Always ] - If set to 'Always', the Global Promo Message will reload upon page refresh or change even if the user has closed it. This option also boosts Global Promo Message load speed. If set to 'Cookie-based', when a user closes the Global Promo Message, it will not display again until the user's cookies expire.
Pick Custom CMS Block Choose CMS Block that you want to be displayed in the Global Promo Message section.

Top Header.

Go to Weltpixel -> Custom Header -> Top Header and customize the top header:

Width: set the width of the Top Header [in px]
Link Color: set color for links in header
Visited Link Color: set color for visited link in header
Hover Link Color: set color on hover over links in the header
Active Link Color: set color for active link in the header
Text Color: set text color in the header
Background Color: set background color of the header
Border Bottom Color: set border color of the header bottom

Middle Header.

Go to Weltpixel -> Custom Header -> Middle Headerand customize the middle header:

Width: set width of the middle header [in px]
Background: set background color middle header

Search Options

Go to Weltpixel -> Custom Header -> Search Options and customize the Search Bar:

Search Version: - Select between 2 search versions. Version 1 is configurable with all below options. Search Version 2 has a predefined design.
Field Width: set the width of the search field [in px]
Field Height: set the height of the search field [in px]
Field Border Width: set the border width for Top/Right/Bottom/Left
Field Border Style: set border style of the search bar
Field Border Color: set border color for the search
Font size: set font size for text in search [in px]
Field Background color: set background color of the field in search
Font color: set font color for the text in search

Header Navigation.

Go to Weltpixel -> Custom Header -> Header Navigation and customize the header navigation:

Width: set width of the header [in px]
Background: set background color for the header navigation
Link Color: set link color in header navigation
Hover Link Color: set link color on hover on header navigation
Navigation Shadow: set shadow for header navigation. For example: 0px 10px 30px 0 px rgba(0,0,0,0.05)

Sticky Header.

Go to Weltpixel -> Custom Header -> Sticky Header Options and customize the Sticky Header:

Enable Sticky Header - [Yes / No] - Choose whether or not to enable the Sticky Header functionality.
Custom Logo Size when Sticky - [Yes / No] - Select Yes to be able to customize the logo size when the Sticky Header is active.
Logo Width: Set the width of the logo when the Sticky Header is active.
Logo Height: Set the height of the logo when the Sticky Header is active.
Top Position: Set the top position (in percentage values) for the logo when the Sticky Header is active.
Enable Sticky Header also on mobile - [Yes / No] - Set Yes to enable Sticky Header also on mobile view. If set to No, Sticky Header is enabled only on desktop view.
Enable Sticky Header when scroll up - [Yes / No] - Set Yes to Enable sticky header only when you scroll the page up.
Use Advanced Color Control - [Yes / No] - If set to Yes you will be able to control the background and elements color for the Sticky Header. If set to No, the Sticky Header will use a white background color and existing header color options.
Sticky Header Background Color - Select the background color for the Sticky Header.
Sticky Header Link Color - Select the link color for the Sticky Header Navigation. Only applies for level 0 categories.
Sticky Header Link Color on Hover - Select the hover link color for the Sticky Header Navigation. Applies for all categories and subcategories.

Header Icons.

Go to Weltpixel -> Custom Header -> Header Icons to customize the Header Icons:

Icon Size: Set the size of icons from Header. Example: 16px
Icon Color: Set the color of icons from Header. Example: #000000
Icon Hover Color: Set hover color of icons from Header. Example: #CCCCCC

Mobile Logo.

Go to Weltpixel -> Custom Header -> Mobile Logo to enable the Mobile Logo functionality.

Enable - [Yes / No] - Enable / Disable the Mobile Logo functionality. To upload the mobile logo, go to Content -> Design -> Configuration > [your store] > WeltPixel Header - Mobile logo.

Prefooter and Footer.

Go to Weltpixel -> Custom Footer -> PreFooter Settings and enable/disable the PreFooter.

You can customize the prefooter by editing the CMS block with identifier weltpixel_pre-footer in admin to Content -> Blocks .

Go to Weltpixel -> Custom Footer -> Footer Settings and choose the footer version.

Enable: [ Yes / No ]
Footer version: choose footer version

You can go in admin to Content -> Blocks , and edit the block with identifier name weltpixel_footer_v[x], where x is the footer version.

Go to Weltpixel -> Custom Footer -> Copyright Settings: and choose show or hide the copyright section of the footer.

Enable [ Yes / No ] - Edit the copyright content in Content -> Configuration -> Desired store view Edit -> Footer -> Copyright

DESIGN ELEMENTS. MODULAR ELEMENTS.

Disable any Design Elements that you don't use from admin options and coresponding code will not be loaded, offering your store more speed. Also by disabling unused Design Elements you wll experience less conflicts with other 3rd party functionality that you will install in the future.

General.

Go to Weltpixel -> Design Elements-> Generaland set design for elements:

Bootstrap Grid: enable or disable Bootstrap Grid[ Yes / No ]
Icons: enable or disable Icons[ Yes / No ]
Tables: enable or disable tables[ Yes / No ]
Toggle, Accordion and Tabs: enable or disable Toggle, Accordion and Tabs[ Yes / No ]
Pricing Boxes: enable or disable pricing boxes[ Yes / No ]
Headings And Blockquotes: enable or disable Heading and Blockquotes [ Yes / No ]
Dividers: enable or disable dividers [ Yes / No ]
Brand lists: enable or disable Brand lists[ Yes / No ]
Responsive And Helpers: enable or disable Responsive and Helpers[ Yes / No ]
Smooth Scrolling: enable or disable Smooth Scrolling[ Yes / No ]
Icon boxes: enable or disable Icon boxes[ Yes / No ]
Alert boxes: enable or disable Alert boxes [ Yes / No ]
Flex Slider: enable or disable Testimonials [ Yes / No ]
Buttons: enable or disable buttons [ Yes / No ]
Sections/Parallax: enable or disable Sections/Parallax[ Yes / No ]
Animations: enable or disable animations[ Yes / No ]
Activate Back to Top Button: enable or disable Back To Top functionality [ Yes / No ]
Auto-jump to Top when click on Collapsible Widgets: enable or disable the functionality whereby clicking on collapsible widgets takes you back to the top of the page [ Yes / No ]

BACK TO TOP.

Go to Weltpixel -> Design Elements to enable and customize the back to top button:

Activate Back to Top Button: activate back to top button [Yes / No]
Show button after "x" pixels of scroll down: set after how many pixels of scroll down to show the button [in px]
Reduce the opacity of "Back to Top" button after "x" pixels of scroll down: set after how many pixels of scroll down to reduce the opacity of the button[in px]
Duration of top scrolling animation: duration of top scrolling animation [in ms]

Advanced Back to top.

Go to Weltpixel -> Design Elements -> Advanced Back to Top on Product Page to enable and customize the Advanced Back to Top button:

Enable Advanced Back To Top On Product Page: activate the Advanced Back to Top button [Yes / No]
Text Label on Back to top: Insert custom text to be displayed on Advanced Back to Top button. Leave empty for no label.
Show Product image on Back to top: Choose whether or not to display the product image on the back to top button.
Show reviews on Back to top: Choose whether or not to display the product reviews on the back to top button.
Show product price on Back to top: Choose whether or not to display the product price on the back to top button.
Back To Top Background Color: Choose the background color for the back to top button.
Button Box Shadow: Insert shadow values for the Back To Top Button on product page. Example: 0px 5px 30px 0px rgba(0,0,0,0.5)
Back To Top Border Width: Insert border width for Back To Top Button on product page. Example: 1px
Back to top on Mobile: Choose which version of the back to top button you'd like to display on mobile or hide it altogether. [Display Default / Display Advanced / Hide]

Category Page.

Go to Weltpixel -> Category Page to customize the category page.

General Options.

Go to Weltpixel -> Category Page -> General and choose general settings for the category page:

Display Add To Wishlist: display on category page the icon Add to Wishlist to [Hidden / Top - Left / Top - Left On Hover / Top - Right / Top Right On Hover / Below Swatches On Hover]
Display Add To Compare: display on category page the icon Add to Compare to [Hidden / Top - Left / Top - Left On Hover / Top - Right / Top - Right On Hover / Below Swatches On Hover]
Display Swatches: display swatches on products from category page [ No / Yes / On Hover ]
Display Swatch Tooltip: display swatch tooltip when hover over swatches on products from category page [ Yes / No ]
Display Add to Cart: display on category page the button Add to Cart [ Hidden / Image Bottom / Image Bottom On Hover / Below Price / Below Price On Hoover / Below Swatches On Hover ]
Align Add to Cart Button: align the Add to Cart button [ Center / Left ]
Products per line (Desktop view): set the number of products per line in desktop view [ 3 / 4 / 5 ]
Remove Breadcrumbs: remove the breadcrumbs from the category page [ Yes / No ]
Hover animation: Select the animation when hovering over items on the category page [ None / Zoom Item / Zoom Image ]
Animation Speed: Select the speed at which you'd like the animation to play out. Values are in seconds.
Disable Mobile Double Click: Set this option to Yes to ensure a single tap is required to register a click and navigate to the Product Page on mobile devices.

Item Options.

Go to Weltpixel -> Category Page -> Item Options and customize the items from the category page:

Item Box Shadow: set item Box shadow on category page [ex: 0px 5px 30px 0px rgba(0,0,0,0.1)]
Item Border Width: set item border width on category page [ in px ]
Item Border Color: set item border color on category page

Item Image Options.

Go to Weltpixel -> Category Page -> Item Image Optionsand set width and height Items Images in Grid and List view, on the category page:

Enable Hover Image: [Yes / No] select the hover image for each product from Product -> Edit -> Images -> Listing Hover Image.
If you want to show Hover Image also in Product Carousels you can enable this functionality from Magento Admin Sidebar > WeltPixel Logo > Carousels Pro > General Settings > Enable Hover Image on products > [ Yes / No ]
Grid View Image Width (In Px): set image width in Grid View [ in px ]
Grid View Image Height (In Px): set image height in Grid View [ in px ]
List View Image Width (In Px): set image width in List View [ in px ]
List View Image Height (In Px): set image height in List View [ in px ]

Item Name Options.

Go to Weltpixel -> Category Page -> Item Name Options and set text align, font size and text color for Items Name on the category page:

Text Align: align text on items in category page [ Left / Center ]
Font Size: set font size on items in category page [in px]
Text Color: set text color on items in category page

Item Review Options.

Go to Weltpixel -> Category Page -> Item Review Options and set different settings for Item Reviews on the category page:

Display Reviews: display the reviews [ Yes / No ]
Text Align: align reviews text [ Left / Center ]

Item Price Options.

Go to Weltpixel -> Category Page -> Item Price Optionsand customize Item Prices on the category page:

Text Align: align price in items on category page [ Left / Center ]
Price Size: set price size in items on category page [in px]
Price Color: set price color in items on category page
Special Price Size: set size for special price in items on category page [in px]
Special Price Color: set color for special price in items on category page

Item Swatch Options.

Go to Weltpixel -> Category Page ->Item Swatch Options and customize the swatches on items on the category page:

Radius: set radius for swatches on items in category page [ in px ]
Width: set width for swatches on items in category page [ in px ]
Height: set height for swatches on items in category page [ in px ]
Font Size: set font size for swatches on items in category page [ in px ]
Swatch Align: set swatch align on items in category page [ left / center ]
Apply the changes also to text swatches: [ Yes / No ] - If set to No, the settings above will not apply to Text-type swatches, allowing them to be customized separately.

Toolbar.

Go to Weltpixel -> Category Page ->Toolbar and customize the toolbar in category page:

Toolbar Background Color: set the toolbar background color
Toolbar Border Color: set toolbar border color
Toolbar Padding: set padding [ in px ]
Label Font Size: set label font size [ in px ]
Label Font Color: set label font color
Grid / List Background Color: set grid/list background color
Grid / List Background Hover Color: set grid/list background color on hover
Grid / List Background Active Color: set grid/list background active color
Grid / List Border Color: set grid/list border color
Grid / List Border Hover Color: set grid/list border color on hover
Grid / List Border Active Color: set grid/list border active color
Grid / List Icon Size: set grid/list icon size [in px]
Grid / List Icon Color: set grid/list icon color
Grid / List Icon Hover Color: set grid/list icon color on hover
Grid / List Icon Active Color : set grid/list icon active color
Dropdown Background Color: set dropdown background color
Dropdown Background Focus Color: set dropdown background color on focus
Field Border Width: set field border width on top/right/bottom/left [in px]
Dropdown Border Color: set dropdown border color
Dropdown Border Focus Color: set border color on focus
Dropdown Font Size: set font size for dropdown items [ in px ]
Dropdown Font Color: set font color for dropdown text
Dropdown Arrows Color: set arrows color in dropdown
Dropdown Arrows Hover Color: set arrows color on hover
Dropdown Option Font Color: set font color for options in dropdown
Direction Font Size: set font size for direction (ascending/descending) arrows
Direction Font Color: set font color for direction (ascending/descending) colors
Direction Font Hover Color: set font color on hover for direction (ascending/descending) arrows
Pagination Font Size: set font size for elements in pagination area
Pagination Font Color: set font color for elements in pagination area
Pagination Font Hover Color: set font color on hover for elements in pagination area
Pagination Font Active Color: set font color for active element in pagination area
Pagination Background Color: set background color for pagination area
Pagination Background Hover Color: set background color on hover on elements in pagination area
Pagination Background Active Color: set background color for active element in pagination area
Pagination Border Color: set border color for elements in pagination area
Pagination Border Hover Color: set border color on hover for elements in pagination area
Pagination Border Active Color: set border color for active elements in pagination area
Pagination Next / Prev Font Size: set font size for Next / Prev in pagination area
Pagination Next / Prev Font Color: set font color for Next / Prev in pagination area
Pagination Next / Prev Font Hover Color: set font color on hover over Next / Prev in pagination area
Pagination Next / Prev Background Color: set font color on hover over Next / Prev in pagination area
Pagination Next / Prev Background Color: set background color for Next / Prev in pagination area
Pagination Next / Prev Background Hover Color: set background color on hover over Next / Prev in pagination area

Description Options.

Go to Weltpixel -> Category Page -> Description Options to enable / disable and configure the Show More / Show Less option.

Show More/Less: Enable show more/less trigger for category description, useful for long paragraphs.
Number of Lines: Insert the number of initially visible paragraph lines. Ex. 3, for first three lines of text. This value is multiplied with the value of WeltPixel > Frontend Options > Default > Line Height setting.
Animation Speed: Show more/less animation speed in milliseconds. Ex. 300.

Layered Navigation Swatch Options.

Go to Weltpixel -> Category Page -> Layered Navigation Swatch Options and customize the swatches in Layered Navigation on the category page:

Radius: set radius for swatches in layered navigation [ in px ]
Width: set width for swatches in layered navigation [ in px ]
Height: set height for swatches in layered navigation[ in px ]
Font Size: set font size for swatches in layered navigation [ in px ]
Swatch Align: set swatch align in layered navigation [ left / center ]

Layered Navigation Options.

Go to Weltpixel -> Category Page -> Layered Navigation Options to cutomize the filter bullets for the Layered Navigation on the Category Page.

Filter Option Bullet - [Yes / No] - Enable / Disable the bullet design for Layered Navigation filters.
Bullet Width: - Set Width of the bullets. Example: 10px.
Bullet Height: - Set Height of the bullets. Example: 10px.
Bullet Border: - Set Border of the bullets. Example: 1px solid #999.
Bullet Border Radius: - Set Border Radius of the bullets. Example: 15px.

Custom Link option.

If you would like to have a custom link in the main navigation just go to Products -> Categories -> WeltPixel Options tab and in the Custom link field type any of the following solutions:

Use http:// to create an external link
Use "/" to create a link to the homepage
Use "#" to disable the link

and choose Yes if you wish to open the link in a new tab.

Display Subcategories with images.

To display Subcategories of a certain Category as images, head into Admin -> Catalog -> Categories -> Choose your Category -> WeltPixel Options

Category Layout - Choose between Default or Subcategories with Images.
Number of Columns - Choose the number of columns you want displayed.
Subcategory title position - Choose the position in which the Subcategory's title is displayed.

To configure the images displayed for each Subcategory, head into the Subcategory configuration -> WeltPixel Options -> Subcategory Image and upload your image.

Product page.

In this area you can customize the look and feel of the product page.

The product page is highly customizable. You can customize the images dimensions, the images gallery, the images gallery in fullscreen, the zoom, the swatches and much more.

Note: In order for the product page changes to apply, make sure you are changing the theme options on the Store View ( Defaut Store View) and not globally on Default Config.

The product page is highly customizable. You can customize the images dimensions, the images gallery, the images gallery in fullscreen, the zoom, the swatches and much more. You can choose between 4 demo product pages we already created as a strating point for your project.

Product Page Version 1

Product Page Version 2

Product Page Version 3.

Product Page Version 4.

Based on your selection you can further customize how the product page looks and works.

General Options.

Right from the beginning you can select the layout that you want. You can set how much of from the width of the screen will have the image and the product info areas.

Go to Weltpixel -> Product Page -> General and set general settings for the product page:

Image area width: set width for image section [ in % ], for example you can set it to 60% of the width of the website
Product info area width: set width for product info area [ in %], for example you can set it to 40% of the width of the website
Move Description and Tabs under info area: [ Yes / No ] move description tab, more information tab and reviews tab on right section
Remove wishlist: [ Yes / No ] remove wishlist button from the product page
Remove compare: [ Yes / No ] remove compare button from the product page
Remove email: [ Yes / No ] remove email button from the product page
Remove qty box: [ Yes / No ] remove quantity box from the product page
Remove sku: [ Yes / No ] remove sku info from the product page
Remove stock availability: Remove stock availability Remove stock availability Remove stock availability
Remove Breadcrumbs: [ Yes / No ] remove breadcrumbs from the product page
Remove Tabs Border: [ Yes / No ] remove tabs border on the product page
Information Layout on Desktop: select tabs layout type [ Tab / Accordion / List ]
Quantity Input Type: choose input type for quantity field [ Default input / Dropdown / Plus Minus ]
Border Radius for Plus Minus Selector: Set border radius for plus / minus quantity selector. Example: 1px.
Add to Cart Button Position: [ On the same line with QTY selector / Under QTY selector ]
Quantity Dropdown Max Value: set max value for quantity field when is set in dropdown [ value, ex: 10 ]
Display Swatch Tooltip: [ Yes / No ] display tooltip on hover over swatch on product page

Note: The sum of Image area width and Product info area width, should not exceed 100%. This settings is applied only on desktop, on mobile devices the columns will automatically take advantage of the responsive design.

Images

Go to Weltpixel -> Product Page -> Images and set width and height for main image and thumb image on the product page:

Main Image Width: set main image width [ in px ]
Main Image Height: set main image height [ in px ]
Thumb Image Width: set gallery thumb image width [ in px ]
Thumb Image Height: set gallery thumb image height [ in px ]

Gallery.

Go to Weltpixel -> Product Page -> Gallery and set different settings for the image gallery on the product page:

Gallery strategy for Configurable products: [ Prepend / Replace ] - The Prepend optio nalways displays the images of the configurable parent product and adds the images of the simple product after swatch selection while the Replace option displays only the images assigned to the associated simple product.
Gallery navigation style: set gallery navigation style [ Thumbs / Dots / None ]
Gallery navigation loop: enable gallery navigation loop [ True / False ]
Turn on/off keyboard arrows navigation: turn on/off keyboard arrows navigation [ True / False]
Turn on/off arrows on the sides preview: turn on/off arrows on the sides preview [ True / False]
Display alt text as image title: display alt text as image title [ True / False ]
Sliding direction of thumbnails: display sliding direction of thumbnails [ Vertical / Horizontal ]
Turn on/off on the thumbs navigation sides: turn on/off the thumbs navigation sides [ True / False]
Sliding type of thumbnails: set sliding type of thumbnails [ Thumbs / Slides ]
Sets transition effect for slides changing: set transition effect for slides changing [ Slide / Crossfade / Dissolve ]
Sets transition duration in ms: set transition duration [in milliseconds ]

Gallery Fullscreen.

Go to Weltpixel -> Product Page -> Gallery Fullscreen and set how the gallery should work when enter in fullscreen of the images gallery on the product page:

Enable Fullscreen Image Zoom: enable fullscreen image zoom [ True / False ]
Fullscreen navigation style: set gallery navigation style in fullscreen [ Thumbs / Dots / None ]
Fullscreen navigation loop: enable gallery navigation loop in fullscreen [ True / False ]
Turn on/off arrows on the sides preview: turn on/off arrows on the sides preview [ True / False]
Display alt text as image title: display alt text as image title [ True / False ]
Sliding direction of thumbnails in full screen: display sliding direction of thumbnails [Vertical / Horizontal]
Sets transition effect for slides changing: set transition effect for slides changing [ Slide / Crossfade / Dissolve ]
Sets transition duration in ms: set transition duration [in milliseconds ]

Magnifier Options.

With this intuitive option users can zoom into your product by simply mousing over them.

Go to Weltpixel -> Product Page -> Magnifier Options and set the position and how the magnifier should work on the product page:

Enable Magnifier: enable or disable the magnifier [ True / False ]
Zoom of fullscreen: set zoom value of fullscreen [ value ]
Top position of magnifier: set top position of magnifier
Left position of magnifier: set left position of magnifier
Width of magnifier block: set width of magnifier block
Width of magnifier block: set height of magnifier block
Action that activates zoom: set action that activates zoom [ Hover / Click ]
Zoom Type: Select the zoom type. [ Outside / Inside ]

Swatch Options.

Go to Weltpixel -> Product Page -> Swatch Options and set how the swatches should look on the product page:

Radius: set radius [ in px ]
Width: set width [ in px ]
Height: set height [ in px ]
Line Height: set line height [ in px ]
Font Size: set font size [ in px ]
Auto select swatches: choose whether swatches should auto-select when accessing the Product Page [ Default (No Preselect) / If only one option available / First swatch always ]
Apply the changes also to text swatches: [ Yes / No ] - If set to No, the settings above will not apply to Text-type swatches, allowing them to be customized separately.

Visitor Counter.

Enable Visitor Counter - [Yes / No] - Enable / Disable the Visitor Counter functionality.
Vistor conter based on - Choose whether you'd like to have the Visitor Counter displayed based on User Session or User IP.
Update frequency - Choose the frequency at which the Visitor Counter is updated.
Time Delay - Set a delay in seconds.
Display Text - Choose the text you'd like displayed. The {visitor_counter} custom variable can be used in the text.
Display Limiter - Set a lower limit for the number of visitors you'd like the Counter to display. The Counter will only be displayed if the number of visitors surpasses this threshold.

Size Chart / Custom Block.

Enable Size Chart / Custom Block - [Yes / No] - Enable / Disable the Size Chart / Custom Block functionality.
Size Chart Custom Label - Fill in the label that you want to be displayed on the Product Page instead of "Size Chart".
Select Size Chart Custom Block - Select the WeltPixel Size Chart CMS block and edit it with your own content, or choose different CMS block.
Conditions - Configure the conditions based on which to display the Size Chart block on specific Product Pages.

Previous / Next Products.

Enable - [Yes / No] - Enable / Disable the Previous / Next functionality for Product Pages. The Prev/Next buttons will only display on products when they are navigated to from the Category Page. Accessing them directly via link, for example, will not trigger the buttons to be displayed.
Product Name for Prev / Next product - Choose how you'd like to display the Product Name the Prev/Next buttons link to. This option applies to desktop only.

Sale Message.

Show Sale Message - [Yes / No] - Enable / Disable the custom Sale Message functionality. You can use this message to highlight a discount or price reduction on your Product Pages.
Message Content - You can show a custom message when a Special Price is used. You can use the following custom variables: {discount_percent} and {discount_value}. Example: You Save {discount_percent} ({discount_value}).

Sticky Add to Cart.

Enable on Desktop - [Yes / No] - Enable / Disable the custom Sticky Add to Cart functionality on desktop.
Sticky Cart Mode - [Replace Menu / Under Menu / Page Bottom] - Choose the display mode/position of the Sticky Add to Cart.
Display on Desktop - Choose the elements you'd like the Sticky Add to Cart to contain on Destkop view.
Enable on Mobile - [Yes / No] - Enable / Disable the custom Sticky Add to Cart functionality on mobile.
Display on Mobile - Choose the elements you'd like the Sticky Add to Cart to contain on mobile view.

CSS Options.

Go to Weltpixel -> Product Page -> Other CSS Options and set thumbnail image border on the product page:

Thumbnail Image Border: set border color for Thumbnail Image
Tab Active Background: set background color for active tab
Tab Background: set background color for tab
Tab Text Active Color: set text color for active tab
Tab Text Color: set text color in tab
Tab Container Padding: set padding for container [ in px ]
Product Name Text Case: Select text case of product names on the product page

CUSTOM CSS & JS.

You can add your own Custom CSS and JS for categories, static pages and static blocks.

Your Custom CSS can be applied on each breakpoint which is set in Weltpixel -> Frontend options -> Breakpoints.

You can have your Custom CSS for each breakpoint set in the Weltpixel -> Frontend options -> Breakpoints area.

Custom CSS and JS for category pages.

You can add your own Custom CSS and JS for each individual category page.

Your Custom CSS for categories can be inserted in Products -> Categories -> [desired category] -> WeltPixel options.

So, if you wish to add custom CSS for a category page you just have to add desired CSS classes and declarations.

Custom CSS and JS - static pages

You can add your own Custom CSS and JS for any static page Your Custom CSS for static pages can be inserted in Content -> Pages -> [edit desired page] -> Design.

Custom CSS & JS - static blocks.

You can add your own Custom CSS and JS for any static block you wish.

Your Custom CSS for static blocks can be inserted in Content -> Blocks -> [edit desired block] and right below the magento editor you can find the fields for the custom CSS and JS.

Widgets.

Using Widgets you can insert several types of blocks in your static pages.

There are already built 6 types of widgets from which you can choose to insert in your pages, each one with its own functionality: Icon, Heading, Divider, Brands, Accordions and Toggles.

Icon Widget.

Insert a WeltPixel Icon Widget to display Icons in you page, from a very wide list of Icons, by following this steps:

1. Go to Content -> Pages and Edit the page where you wish to insert the Icon
2. Go to Content taband place place the cursor where you wish to have the widget in your page, then click Insert Widget button
3. Select WeltPixel Icon widget and you will be able to customize it in the Widget Options area:
- Select Icon: select the icon you wish to display on the page. Go to the presented link to preview the list of icons
- Icon Size: set icon size [ in px, for example: 20px ]
- Padding: set icon’s padding [ in px, for example: 20px 20px 20px 20px ]
- Custom class: set a custom class to be able to customize it in the Custom CSS field. You can name your custom class, for example: my-class
- Custom CSS: here you can customize the class with the name from the above field. You can set the color of the icon, for example: .my-class{ color: green; }
4. Click Insert Widgetbutton and the widget code will be placed in your page content
5. Save Page and check results in your store frontend

Heading Widget.

Insert a WeltPixel Heading Widget to display Headings in your page.

You can find lots of styles for you headings to insert them in your pages as you desire.

To insert an Heading Widget follow this steps:

1. Go to Content -> Pages and Editthe page where you wish to insert the Heading
2. Go to Content tab and place place the cursor where you wish to have the widget in your page, then click Insert Widget button
3. Select WeltPixel Heading widget and you will be able to customize it in the Widget Options area:
- Select Style: select the style for you heading. Go to the presented link to preview how the styles look.
- Title: insert text for the Heading Title
- Subtitle: insert subtitle text of the Heading
- Title Color: select color for the Heading
- Custom CSS: here you can make advanced customization for the heading. For example, to change the subtitle color: .heading-block.center span{ color: green; }
4. Click Insert Widgetbutton and the widget code will be placed in your page content
5. Save Page and check results in your store frontend

Note: To insert a Text Rotator in the Heading, you have to insert special signs $# in the front and end of the text, and | (vertical bar) between rotating texts.

Divider Widget.

Insert a WeltPixel Divider Widget to display dividers in your page.

You can choose from several different style of dividers and you can insert them in your page as you desire.

To insert a Divider Widget follow this steps:

1. Go to Content -> Pages and Edit the page where you wish to insert the Divider
2. Go to Content tab and place place the cursor where you wish to have the widget/divider in your page, then click Insert Widget button
3. Select WeltPixel Divider widget and you will be able to customize it in the Widget Options area:
- Select Style: select the style for you divider. Go to the presented link to view the list of dividers.
- Select Icon: select the icon you wish to display on the divider. Go to the presented link to preview the list of icons
- Custom class: set a custom class to be able to customize it in the Custom CSS field. You can name your custom class, for example: my-class
- Custom CSS: here you can make advanced customization for the heading. For example, to change the subtitle color: .heading-block.center span{ color: green; }
4. Click Insert Widget button and the widget code will be placed in your page content
5. Save Page and check results in your store frontend

Brands Widget.

Insert a WeltPixel Brands Widget to display a list of brands in your page.

You can view lots of dividers ready for you to insert them in your pages as you desire.

Before creating a Brands Widget you need to create a block with the images which will be part of the widget. Follow this steps to create a block containing the images:

1. Go to Content -> Blocks and click button Add New Block
2. Fill in all necessary data for the new block
3. In the Content area insert one by one the images, using Insert Image button
4. Click Save Block

Note: You can make each image to be a link if you use the href tag. For example:
<a href="https://www.weltpixel.com"><img src="{{media url="your-image"}}" alt="" /></a>

Now you can use the created block with the images, to insert a Brands Widget. Follow this steps:

1. Go to Content -> Pages and Edit the page where you wish to insert the Brands
2. Go to Content taband place place the cursor where you wish to have the widget/divider in your page, then click Insert Widget button
3. Select WeltPixel Divider widget and you will be able to customize it in the Widget Options area:
- Select Style: select the style for your brands section. Go to the presented link to preview the styles available.
- Block: select the block with the images, previously created
4. Click Insert Widgetbutton and the widget code will be placed in your page content
5. Save Page and check results in your store frontend

Brands with style Carousel, block example :

<img class="lazyOwl" src="{{media/image1.png}}" alt="Lazy Owl Image" data-src="{{media/image1.png}}" />

Toggles Widget.

Insert a WeltPixel Toggle Widget to display toggles in your page.

You can choose from different toggles style ready for you to insert them in your pages.

Before creating a Toggle Widget you have to create a block with the content of the toggle.

Follow this steps to create a block with the content:

1. Go to Content -> Blocks and click button Add New Block
2. Fill in all necessary data for the new block
3. In the Content area insert your content and images as you wish
4. Click Save Block

To insert a Toggle Widget follow this steps:

1. Go to Content -> Pages and Edit the page where you wish to insert the Toggle
2. Go to Content taband place place the cursor where you wish to have the toggle widget in your page, then click Insert Widgetbutton
3. Select WeltPixel Toggle widget and you will be able to customize it in the Widget Optionsarea:
- Select Style: select the style for you toggle. Go to the presented link to preview the list of toggles.
- Background Color: set the background color for toggles with background
- Border Color: set border color for toggles with borders
- Open Icon: set the icon name displayed when the toggle is open
- Close Icon: set the icon name displayed when the toggle is closed
- Title: set title of the toggle
- Block: set previously created block
4. Click Insert Widget button and the widget code will be placed in your page content
5. Save Page and check results in your store frontend

Accordions Widget.

Insert a WeltPixel Accordions Widget to display accordions in your page.

You can choose from different accordions styles ready for you to insert them in your pages.

Before creating an Accordion Widget you can create a block with the content of the accordion.

Follow this steps to create a block with the content:

1. Go to Content -> Blocks and click button Add New Block
2. Fill in all necessary data for the new block
3. In the Content area insert your content and images as you wish
4. Click Save Block

To insert a Accordions Widget follow this steps:

1. Go to Content -> Pages and Edit the page where you wish to insert the Accordion
2. Go to Content tab and place place the cursor where you wish to have the accordion widget in your page, then click Insert Widget button
3. Select WeltPixel Accordion widget and you will be able to customize it in the Widget Options area:
- Select Style: select the style for your toggle. Go to the presented link to preview the list of accordions.
- Background Color: set the background color for accordion with background
- Border Color: set border color for accordion with borders
- Block set previously created block
4. Click Insert Widget button and the widget code will be placed in your page content
5. Save Pageand check results in your store frontend

Accordion Block example:

               <div class="acctitle"><i class="acc-closed icon-ok-circle"></i><i class="acc-open icon-remove-circle"></i>
               Our Mission</div> <div class="acc_content clearfix">Donec sed odio dui. Nulla vitae
               elit libero, a pharetra augue.Nullam id dolor id nibh ultricies vehicula ut id elit.
               Integer posuere erat a ante venenatis dapibus posuere velit aliquet.</div>

Documentation for
MAGENTO 2 EXTENSIONS
Included in Pearl.

ALL INCLUDED EXTENSIONS ARE COMPATIBLE WITH EACH OTHER OUT OF THE BOX

Magento modules developed by WeltPixel are compatible with both OPEN SOURCE and COMMERCE and used by thousands of merchants. Extensions were developed, crafted, and tested with the utmost care. Make sure to check them all and discover the great value these extensions can bring to your online business. Modularity allows you to only enable functionality specific for each project, keeping the project light and fast. Click the links for the documentation.

Clear Pearl Theme Cache.

1. From Magento Admin.

Go to System > Cache Management > WeltPixel Cache Management > Select Store View > Regenerate Pearl Theme LESS/CSS files.

2. Using Command Line SSH.

Go to the root of your magento installation and execute below commands:

php bin/magento weltpixel:less:generate
php bin/magento weltpixel:css:generate --store=default
php bin/magento cache:clean

Some cache related questions.

#1 Do I need to clear cache for each store-view?

Yes, LESS & CSS files needs to be re-generated for each individual store-view in order for the changes to apply in corresponding store-front. If you have multiple store-views and you are working on all of them in the same time you may want to use SSH regeneration as it's faster.

#2 Why do I need to clear Pearl Theme Cache?

Based on the admin settings LESS files are generated. Based on theme LESS files, CSS files are generated for each store view, so each time theme admin settings are changed, LESS/CSS files need to be regenerated in order to take into cosideration the changes made in admin settings.

#3 Can I change theme settings in Production Mode?

Yes, starting with Pearl Theme version 1.5.0 this is possible without any downtime. You don't need to switch between Production mode and Developer Mode to make theme changes, it's enough to regenerate theme cache.

#4 Do I need to regenerate LESS/CSS theme cache for any theme change?

No, only below modules use LESS files, if you are changing settings in the rest of the theme or associated WeltPixel modules, you don't need to regenerate LESS/CSS files:

Frontend Options
Design Elements
Custom Header
Custom Footer
Category Page
Product Page
Mega Menu (Navigation Links)

#5 Can I use Pearl Theme Cache Clear functionality for other themes installed on my store?

No, it only works on store views where Pearl Theme is activated.

#6 I regenerated Pearl Theme cache, still the changes do no show up in my store front.

Try clearing also Magento Cache. Clearing Pearl Theme cache does not replace the need to clear magento cache or other caches you might use.
Try clearing Browser Cache also, the page content may be cached by your machine browser.
Make sure you are making the changes on the coresponding store-view you verify in the store front.
Product Page changes needs to be made on the store-view level and not globally.

Troubleshooting.

#1 Licensing the product.

For more details on product licensing follow this detailed article on our support center: License key for local / staging / development environment. Multi-store licensing.

#2 Changes not applied from Pearl Theme admin options?
No worries, most probably is one of below issues:

Step 1. After changing settings make sure to clear related caches: Flush Static Files Cache, Flush Magento Cache, Clear Browser Cache (if necessary also Flush JS/CSS Cache, Flush Catalog Images Files, Flush Cache Storage)

Step 2. Make sure to clear Pearl Theme related cache from System > Cache Management > WeltPixel Cache Management > Regenerate Pearl Theme Less / Css

Step 3. Make sure you are changing the settings on the right store view.

#3 Pearl Theme - GUI Installation issues? Try SSH Installation.

If you experienced any issues or limitations with the browser quick GUI installation, see also Pearl Theme - Advanced SSH Installation. SSH installation does the same thing as GUI but you are required to issue the commands step by step via Command Line Interface (CLI). Some servers may have high security configurations and may limit the functionality of GUI (browser) Installer.

#4 Bitnami Magento Image - Installation issues when using Bitnami?

In case you are using Bitnami you may experience some installation issues due to how this server image is configured. Based on the feedback from other users we've put together an article explaining the most common permission problems encountered, check it out here Bitnami AWS - Installation issues with Magento 2 Theme or Extensions. If this is causing to much server configuration trouble, try choosing a different hosting solution optimised for Magento 2. This article may help: Choosing the right Magento 2 hosting.

#5 Pearl Theme styles not applied or design issues after switching Magento to Production Mode?

Make sure to Regenerate Pearl Theme LESS/CSS AFTER you enabled Production Mode, you can do this from Admin -> Cache Management section or from SSH using below commands.

bin/magento weltpixel:less:generate
bin/magento weltpixel:css:generate --store=StoreCode

If you switched to Production Mode without regenerating Theme LESS & CSS files, most probably some styles will not apply properly. CSS needs to be generated for each store-view if using multiple stores.

#6 Design issues after upgrading theme, when using multiple store views.

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:

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. Steps on how to create additional child themes can be followed in this article: How to use Pearl Theme on multiple store views. Important update / install instructions

#7 How to customize the store width for different page types.

Follow this detailed article on our support center: How to customize the width for your store sections in Magento 2 Pearl Theme

#8 How to customize css / xml / phtml / js files in Magento 2 - examples [ Tutorial ].

For more details on customizations follow this detailed article on our support center: How to customize css / xml / phtml / js files in Magento 2 - examples [ Tutorial ]

#9 How LESS / CSS Generation works in Pearl Theme & Magento - developer corner

About LESS/CSS generation. Why is it necessary? Quick answer: Performance & Best Practice. For more details follow this detailed article on our support center: How LESS / CSS Generation works in Pearl Theme & Magento [developer corner]

#10 How to use GRUNT with Pearl Theme & Magento 2. [Step-by-step Tutorial]

Check out how to use GRUNT with Pearl Theme, follow this detailed article on our support center: How to use GRUNT for Magento 2 and Pearl Theme [step by step Tutorial]

# More helpful resources on our Support Knowledge Base and Community Center.

We encourage you to visit our: Support Knowledge Base as it is constantly updated. Here you can find answers on different topics or you can engage and consult with WeltPixel Community users already using our products.

Developer Corner.

WeltPixel SSH Commands.

1. Re-generate LESS/CSS, equivalent of admin regeneration:
php bin/magento weltpixel:less:generate
php bin/magneto weltpixel:css:generate --store==default
php bin/magneto weltpixel:css:generate --store==StoreCode1
php bin/magneto weltpixel:css:generate --store==StoreCode2


2. Activate Pearl Theme via SSH
php bin/magento weltpixel:theme:activate --store=GLOBAL --themePath="Pearl/weltpixel_custom"
php bin/magento setup:upgrade
php bin/magento weltpixel:less:generate
php bin/magento weltpixel:css:generate --store=default
php bin/magento cache:clean
--store=GLOBAL - if you do not want to activate the theme globally, specify the store name where you want to activate the theme, ex: --store=default


3. Import Demo settings
php bin/magento weltpixel:import:demo [--store="..."] [--demoVersion]
php bin/magento weltpixel:theme:configurator [--store="..."] [--homePage[="..."]] [--header[="..."]] [--categoryPage[="..."]] [--productPage[="..."]] [--footer[="..."]]
php bin/magento weltpixel:cleanup
php bin/magento weltpixel:less:generate
php bin/magento ca:cl

[--homePage[="..."]] = v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v14, v15
[--header[="..."]] = v1, v2, v3, v4
[--categoryPage[="..."]] = 2columns, 3columns, 4columns, 5columns
[--productPage[="..."]] = v1, v2, v3, v4
[--footer[="..."]] = v1, v2, v3, v4
[--store="..."] = default, GLOBAL
[--demoVersion] = v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v14, v15

Example:
php bin/magento weltpixel:import:demo --store=GLOBAL --demoVersion=v8
php bin/magento weltpixel:theme:configurator --store=GLOBAL --homePage=v8 --header=v1 --categoryPage=3columns --productPage=v1 --footer=v3
php bin/magento weltpixel:cleanup
php bin/magento weltpixel:less:generate
php bin/magento ca:cl


4. Pearl Theme Import / Export settings
4a. Export Pearl Theme Configurations from existing environment
php bin/magento weltpixel:export:configurations --store=default
--store=default - if not default, specify the store name from where you want to export the settings

> This command exports the settings for the modules that are part of Pearl Theme:  
Frontend Options
Design Elements
Category Page
Product Page
Custom Header
and will generate a .csv file weltpixel_configurations_default.csv in the root of your magento instalaltion.

4b. Export WeltPixel Module Configurations from existing environment
php bin/magento weltpixel:export:modules --store=default  --modules=WeltPixel_OwlCarouselSlider,WeltPixel_Quickview
--store=default - if not default, specify the store name from where you want to export the settings
--modules=WeltPixel_OwlCarouselSlider - the exact module name from composer should be used, if multiple modules you should separate them by comma [,].

> This command exports the settings for the modules that are included with Pearl Theme:  
Advance Product Quick View and Ajax Cart (WeltPixel_Quickview)
OWL Banner Slider and Product Carousel (WeltPixel_OwlCarouselSlider)
Google Analytics Enhanced Ecommerce Tag Manager (WeltPixel_GoogleTagManager)
Rich Snippets & Cards schema.org (WeltPixel_GoogleCards)
Enhanced Quick Cart (WeltPixel_QuickCart)
Google XML Sitemap (WeltPixel_Sitemap)
SEO Page Title Overwrite (WeltPixel_TitleRewrite)
Smart Product Tabs (WeltPixel_SmartProductTabs)
Instagram Widget Advanced (WeltPixel_InstagramWidget)
Full Page Scroll (WeltPixel_FullPageScroll)
CMS Product Reviews Widget (WeltPixel_RewiewsWidget)
Mega Menu (WeltPixel_NavigationLinks)
Enhanced Multi-Store Multi-Brand (WeltPixel_Multistore)
Custom Thank You Page (WeltPixel_ThankYouPage)
etc
and will generate a .csv file weltpixel_configurations_modules_default.csv in the root of your magento instalaltion.

4c. Import WeltPixel Settings exported from a different environment:
php bin/magento weltpixel:import:configurations --store=default --file="path/to/file"
> run above command for both theme settings and also for module settings.

Other Magento SSH Commands we use.

1. Create Magento admin user via SSH
php bin/magento admin:user:create --admin-user='weltpixel' --admin-password='qwerty123' --admin-email='[email protected]' --admin-firstname='WeltPixel' --admin-lastname='Support'

Pearl Change Log.

What’s new in v.1.14.9 - November 26, 2024

New Features:

Google Analytics 4 - A new setting was added that allows for swapping the load order for the Google Tag Manager initialization script and the dataLayer script. Depending on store setup, speed, and other factors, you may experience more accurate client-side tracking one way or the other.
Google XML Sitemap - The extension now comes with two new Magento Admin configuration options that allow for setting INDEX/FOLLOW (or NOINDEX/NOFOLLOW) values for Category and Search Pages with Layered Navigation Filters applied. This increases the extension's SEO optimization capabilities.
Instagram Widget - Updated the Instagram Widget extension to use Instagram's new API. Instagram's Basic Display API is due to be deprecated on December 4th, 2024, meaning all apps that use this API will become obsolete. Our extension is now fully integrated with the new API and will retain all current functionality.
Product Labels - Added a new Magento Admin option that allows for setting Product Page label configurations to be the same as the ones used for the Category Page, eliminating the need to reconfigure the same settings in cases in which the same label is used for both.
Social Login - The extension once again benefits from the Instagram Login functionality, which was previously deprecated due to Instagram's API being retired. Instagram has recently released a new API which permits using the login functionality again, which our module now benefits from.
Newsletter - Added a new Magento Admin configuration option to allow for hiding the Newsletter Trigger Button on mobile devices for better user experience.
Quick Cart - Added a new option that allows for displaying the Grand Total in the Quick Cart, which is extremely useful when the store has active Cart Price rules, or when a discount code is added via the Quick Cart. When this option is enabled, the discount value and Grand Total is displayed in the Quick Cart, informing the customer how much they save.

Fixes and improvements:

Backend - Added minor Magento Admin adjustments to the module status section for increased clarity and compatibility with server-side Social Pixel addons.
Advanced Category Sorting - Fixed an error that would, in some cases, be thrown when using various custom attributes as sorting options.
Advanced Category Sorting - Fixed an error that would be thrown when the sort by position option was disabled in Magento.
Advanced Wishlist - Added nonces to some of the extension's frontend scripts to maximize compatibility with Magento's latest restrictions.
Google Analytics 4 - Adjusted the script tag the extension uses to ensure its scripts stay in the head section when Move JS to Bottom functionalities are used. The tag now uses a data-attribute.
Google Analytics 4 - Added additional validations to account for situations in which the Magento Cookie Restriction mode status can't be read properly.
Google Analytics 4 - Fixed an error specific to PHP 8.x that would sometimes be thrown when using the extension's Promotion Tracking functionality.
Google Analytics 4 - Added new whitelisted domains to account for Magento CSP restrictions.
Google Tag Manager - Adjusted the script tag the extension uses to ensure its scripts stay in the head section when Move JS to Bottom functionalities are used. The tag now uses a data-attribute.
Layered Navigation - Fixed a bug that would cause Category and Search Page sorting errors when the Ratings filter was enabled and sorting options based on custom attributes were being used.
Quick View - Added nonces to some of the extension's frontend scripts to maximize compatibility with Magento's latest restrictions.
Speed Optimization - Added nonces to some of the extension's frontend scripts to maximize compatibility with Magento's latest restrictions.

What’s new in v.1.14.7 - October 11, 2024

New Features:

Introduced compatibility with the latest Magento 2.4.7-p3, 2.4.6-p8, 2.4.5-p10 and 2.4.4-p11 versions, which come with critical security adjustments for the platform. Magento 2 merchants are urged to upgrade to the latest patches ASAP.
Custom Header - Added a new Magento Admin configuration option that allows for hiding the Global Promo Message from mobile devices for better user experience.
Product Page - The Sticky Add to Cart functionality now features a new configuration option for its position, which now allows it to be moved to the bottom of the Product Page.
Layered Navigation - Added a new Magento Admin setting that allows for displaying the default Category Filter as opened/closed by default.
Newsletter - Added a new Magento Admin configuration option to allow for hiding the Newsletter Trigger Button on mobile devices for better user experience.
Quick Cart - Added a new option that allows for displaying the Grand Total in the Quick Cart, which is extremely useful when the store has active Cart Price rules, or when a discount code is added via the Quick Cart. When this option is enabled, the discount value and Grand Total is displayed in the Quick Cart, informing the customer how much they save.

Fixes and improvements:

Backend - Added various code updates for increased security around the licensing functionality as well as the Help Center and WeltPixel Developer Magento Admin sections.
Category Page - Fixed a small design/UX issue that would sometimes cause the page to jump down when hovering over items on the Category Page, due to a height recalculation on the fly.
Custom Header - Fixed a bug that would prevent the custom logo size settings from applying properly on the Sticky Header.
Product Page - Fixed a niche design issue that would cause tabs to be displayed incorrectly in very specific cases. This would only happen when custom tabs were added (via the Custom Product Page Tabs extension, for example) and they were moved under the product info area. The issue was caused by a lack of space and the fixes ensure at least one additional tab can be added.
Product Page - Fixed a bug that would prevent the Add to Cart button from disappearing from the Sticky Add to Cart section when products were out of stock.
Ajax Infinite Scroll - Fixed an error that would sometimes be thrown in the Magento logs when the extension couldn't properly pick up the page URL for use with the canonical functionality.
Email Template Editor - Added minor design adjustments to the extension's default Email Footer template for better social icon alignment.
Mega Menu - Fixed a display bug that would sometimes result in HTML tags being shown on the frontend when using the Subcategories with Images layout type in conjunction with the Magento Pagebuilder.
Mega Menu - Fixed a display bug that would cause the dropdown menu content to overlap with content added to pages via the Magento Pagebuilder.
Product Labels - Fixed an issue that would sometimes result in labels generated by the extension being shown inconsistently via Stock Status conditions when using the Magento Multi Source Inventory functionality.
Social Login - Added a new patch for the extension, found in the patches folder, which fixes a compilation error that is thrown when the extension is installed on a Magento instance that does not have the core ReCaptcha modules enabled. The patch is not required if the modules are present and enabled on the environment.

What’s new in v.1.14.5 - August 23, 2024

New Features:

Introduced compatibility with the latest Magento 2.4.7-p2, 2.4.6-p7, 2.4.5-p9 and 2.4.4-p10 versions, which come with critical security adjustments for the platform. Magento 2 merchants are urged to upgrade to the latest patches ASAP.
CMS Product Reviews Widget - The module now comes with a dedicated Magento Admin page, which displays information about the current version, latest version, as well as allows for submitting new feature requests.
Layered Navigation - Introduced compatibility with Elastic Search 8. The extension was previously not compatible (or required to be) as Magento no longer comes bundled with Elastic Search. Compatibility was added for users who manually install Elastic Search 8 via composer.
SEO Page Title Overwrite - The module now comes with a dedicated Magento Admin page, which displays information about the current version, latest version, as well as allows for submitting new feature requests.
Smart Product Tabs - Added a new Tab Label functionality, which allows you to add fully-customizable labels to your Custom Product Page Tabs. You can choose a custom text on the label, or select an attribute from which to pull and display the value on the frontend.

Fixes and improvements:

Frontend Options - Fixed a minor typo in the extension's storeview_template.less file.
Various modules (Google Tag Manager, Google Automated Discounts, Design Elements) - Tagged frontend and admin inline scripts with nonces to account for recent Magento CSP requirements. In most cases, CSP reports would not impact functionality, but a proactive approach was taken to ensure the module is future-proof.
Various modules (Lazy Loading, Owl Carousel & Banner Slider, Category Page) - Added a code optimization that aligns the extended ImageFactory.php file with the core Magento equivalent to prevent potential errors.
Design Elements - Fixed a bug that would result in the Product Page being broken when using the Advanced Back to Top Button functionality, caused by an improperly closed script.
Product Page - Fixed a bug that would result in the Add to Cart button being disabled when the default Magento "After Adding a Product Redirect to Shopping Cart" option was set to Yes.
Product Page - Fixed a bug that would sometimes prevent Grouped Products from being added to the cart, with a "Please specify the quantity of product(s)" warning on the frontend.
Product Page - Fixed a bug related to Grouped Product quantity validation for quantity increment changes. This bug was specific to Magento 2.4.7.
Product Page - Added minor CSS & layout adjustments on mobile for the +/- quantity input type.
Category Page - Added an optimization to the extension's code which aligns the module's extended ImageFactory.php file with the core Magento equivalent to prevent potential errors.
Advanced Wishlist - Fixed a small conflict with our Google Analytics 4 extension, which would prevent the Add to Wishlist event from triggering when the Ajax Wishlist & Share extension was enabled.
Ajax Search Autocomplete - Fixed an error related to PHP 8 that would be thrown in certain cases when initiating a search on the frontend. The error would only show up in the Magento logs, but no results would be shown on the frontend.
Google XML Sitemap - Fixed an error that would sometimes be thrown on Product and Category Pages when using the extension's Meta Tags functionality. This was later discovered to be caused by a conflict, but the adjustment remains as a way to ensure the particular error is bypassed for UX purposes.
Mega Menu - Fixed a frontend display issue that would occur on the Boxed and Sectioned display modes which would result in the navigation menu items being pushed out of position when inserting a Custom HTML block in the menu.

What’s new in v.1.14.3 - June 20, 2024

New Features:

Introduced compatibility with the latest Magento 2.4.7-p1, 2.4.6-p6, 2.4.5-p8, 2.4.4-p9 versions, which come with critical security adjustments for the platform. Magento 2 merchants are urged to upgrade to the latest patches ASAP.
Added a new section in the Magento Admin that checks to make sure the latest product version is installed and notifies in case an update is available, as well as a button that allows for new features to be requested.
Category Page - Added a new configuration option that allows for disabling the functionality through which a double-tap is required to access the Product Page on mobile devices.
Google Analytics 4 - Added a new backend configuration option that is applicable when the Item Variant is enabled, which allows for choosing between sending the Product SKU as the variant, or a dynamically generated string consisting of the product configurations.
Mega Menu - Added a new configuration option that allows you to set a custom text to be displayed in the Menu instead of the Category Name. This allows for keeping a longer Category Name for SEO purposes.
Quick Cart - Added a new design option for the Quantity Input on the Cart Page that allows for transforming the default Quantity Input into either Arrows or Plus/Minus icons.
Quick View & Ajax Cart - The extension now allows the Quick View product URL to be structured with the product's SKU as well. Previously, only the Product ID was accepted in the Quickview URL.

Fixes and improvements:

Custom Header - Fixed a display issue that would happen when including a large number of categories in the menu, which would push the header icons down and break alignment with the menu.
Product Page - Fixed a JS console error that would be thrown on Grouped Product Pages on Magento versions lower than 2.4.7.
Google Tag Manager - Added a deprecation notice for the extension in the Magento Admin configuration section. We recommend upgrading to the Google Analytics 4 extension ASAP to keep tracking eCommerce data.
Newsletter - Added minor configuration option description changes to reflect shift from the deprecated Google Tag Manager extension to the Google Analytics 4 integration.
Owl Carousel & Banner Slider - Added minor configuration option description changes to reflect shift from the deprecated Google Tag Manager extension to the Google Analytics 4 integration.
Owl Carousel & Banner Slider - Fixed a bug that would, in certain cases, result in an error being thrown when trying to save a banner in the Magento Admin.
Quick Cart - Fixed a bug related to the Free Shipping integration whereby the extension would not properly calculate the Free Shipping threshold on different currency options.
Recently Viewed Products Bar - Fixed a minor display issue that would result in text and other content overflowing downwards off the screen on extremely high resolutions (2k and up).
Google Analytics 4 - Fixed a bug that would cause the extension's script initialization to break because of incorrect characters when adding custom attributes to the script tag in the extension's backend configuration.
Google Analytics 4 - Added a technical improvement to the extension's Item Name fetching process for View Item List and View Item events which allows for enhanced compatibility with various Magento customizations.
Google Analytics 4 - Added minor improvements to script nonce generation in order to ensure the extension's scripts properly pass Magento CSP restrictions.
Google Analytics 4 - Added an adjustment to the extension which boosts compatibility with 3rd party extensions that send/modify HTTP headers.
Google Analytics 4 - Added improvements to discount parameter calculations for products with tax included in the price.

What’s new in v.1.14.1 - April 19, 2024

New Features:

The Pearl Theme Professional Pack now includes the standard version of the Google Analytics 4 extension in order to replace the deprecated Universal Analytics module.
The Pearl Theme & all included extensions are now confirmed for compatibility with the latest Magento 2.4.7 release, as well as newly released 2.4.6-p5, 2.4.5-p7 & 2.4.4-p8 Security Patches.
The Pearl Theme & all included extensions are now confirmed for compatibility with PHP 8.3 on the Magento 2.4.7 release. PHP 8.2 is also supported for this Magento version.
Design Elements - Upgraded the AOS library used by the Pearl Theme to the latest version. This avoids usage of deprecated functionality and ensures better performance.
Product & Category Pages - Added the possibility of styling Visual and Text-based Swatches individually. The default behavior ensures the same design options apply to all swatch types, however, this can now be changed.
Advanced Wishlist - Added a new configuration option that allows for selecting whether an item should stay in the wishlist after being added to the cart.
Google Analytics 4 - Added an option that allows for including a new event in the dataLayer called ads_purchase which can be used as a trigger for the Google Ads Conversion Tracking Tag, used in cases in which the tag misses timing.
Instagram Widget - The extension can now fetch posts from Instagram that include multiple images. Previously, this post type was ignored and no images were displayed.
Mega Menu - Added a new Magento Admin configuration option that allows for setting a custom Alt Text value for Subcategory Images, for increased SEO performance.
Mega Menu - Added a new Magento Admin configuration option that can be used to display the Category Description for the Subcategories with Images functionality.
Mega Menu - The extension now features a new Magento Widget that can be used to display the Subcategories grid on other page types, such as CMS Pages.
Owl Carousel & Banner Slider - Improved the extension's SEO capabilities by ensuring all Banners assigned to Sliders have an Alt Text attribute. If one is not specified, the Banner Title is used.

Fixes and improvements:

Product Page - Fixed an error related to PHP 8.2 that would be thrown when attempting to regenerate the theme's LESS/CSS from the Magento Admin Cache Management section or the CLI.
Category Page - Fixed a display issue whereby, depending on the Magento Admin design options and on Swatch Tooltip settings, swatches would sometimes overlap on the Category Page.
Backend - Added security improvements to the Backend module's license verification process.
Ajax Catalog & Infinite Scroll - Added minor adjustments to "next" and "previous" page link structure for improved technical on-page SEO.
Ajax Search Autocomplete - Fixed a bug related to PHP 8 that would, in certain cases, depending on the Product Description, result in an error on the frontend when initiating a search.
Email Template Editor - Updated Social Media Platform branding for Social Icons used in default Email Templates, including the new X (formerly Twitter) icon.
Google Analytics 4 - Fixed a bug that would sometimes cause an error to be displayed when modifying item quantity in the cart from a small to a large number.
Google Analytics 4 - Fixed a bug that would sometimes result in item variants being duplicated in the Add to Cart & Remove from Cart event dataLayer.
Google Analytics 4 - Added adjustments to increase compatibility with custom script insertion/optimization methods, particularly Rocket Javascript.
Google Analytics 4 - Added/adjusted Magento Admin configuration option descriptions for improved clarity.
Google XML Sitemap - Fixed an error that would sometimes be thrown on the frontend when enabling and using the extension's INDEX/FOLLOW functionality. This would only be the case on CMS pages.
Instagram Widget - Fixed an issue that prevented the extension's Post Limit settings from fetching more than 25 images from Instagram. The extension now includes pagination.
Layered Navigation - Fixed an issue whereby the extension's Slide In and Slide Down design modes would not function correctly when the Ajax feature was disabled.
Owl Carousel & Banner Slider - Fixed an issue specific to the Mozilla Firefox browser whereby window resizes would cause display issues, particularly with spacing under Product Carousels.
Product Labels - Fixed a bug that would cause labels to be duplicated in cases in which a page included multiple iterations of the same product. This was most apparent when using Product List widgets.
Product Labels - Fixed an issue that would prevent labels created by the extension with stock-based conditions from displaying when using Magento's MSI functionality.
Rich Snippets - Fixed an error that would sometimes be thrown on the frontend in cases in which a canonical link was present in the head section of the store and was unparsable by Facebook Open Graph.
Rich Snippets - Fixed a schema-related issue related to backorders whereby the extension would send an incorrect "In Stock" availability value. This also applies to Facebook Open Graph.
Social Login - Fixed an error that would be thrown on the frontend when trying to create an account via the extension's popup functionality. This would also prevent the account from being created.
Social Login - Fixed an issue that would sometimes result in an error that prevented a successful login due to a premature expiration of the password token.
Social Login - Fixed an error that would sometimes be thrown on the frontend when using the "Login as Customer" functionality in the Magento Admin section.
User Profile - Updated a deprecated/incorrect jQuery function that was used in the extension's functionality related to Ajax.

What’s new in v.1.11.21 - January 9, 2024

New Features:

Added a new theme_custom.css file in the web/css directory. This file ensures that added Custom CSS is loaded at the end and that no redeploy is necessary, regardless of the current Magento mode.
Updated the Google Fonts library to include all the latest Google Fonts and optimized the page inclusion process to match Google's recommendations.
Adjusted CMS Page custom inline JS script blocks to allow script tags, including tags with custom types, such as type="text/x-magento-init">.
Updated Social Icons and Logos used throughout the Pearl Theme to reflect the new Twitter/X Branding changes.
Newsletter - Updated Social Icons and Logos used in the Newsletter Popup extension to reflect the new Twitter/X Branding changes.
Owl Carousel & Banner Slider - Updated the Conditions-Based Owl Carousel type to allow the use of the Stock Status (Quantity) attribute as a display condition.
Product Labels - Added a new functionality that allows for duplicating an existing Product Label, with all the current settings/configuration options, via the Product Labels Grid.
Quick Cart - Updated the Quick Cart Coupon Code functionality to ensure there is no longer a page refresh when applying a discount code via the Quick Cart, enhancing the UX.

Fixes and improvements:

Fixed an error that would be thrown in the WeltPixel -> Extensions Version admin section when a module's composer.json file was missing the version node.
Fixed an issue that would cause various content blocks to render incorrectly when i tags were changed to em by content editors, such as the WYSIWYG editor.
Added various optimizations for ADA compliance to ensure a high degree of compatibility and increased scores across testing platforms.
Fixed a couple of minor CSS/styling issues that would sometimes cause elements on the Product Page to break on certain breakpoint resolutions, usually around 768 pixels.
Fixed an issue that would prevent the Parallax effect from functioning correctly in the Home Page V2 Sample Data.
Fixed an issue that would sometimes prevent the Search Popup from opening if the page wasn't finished loading.
Adjusted default admin settings to ensure Icon Boxes and Date Pickers are properly styled out of the box.
Added small adjustments to the JS Parser used alongside the Speed Optimization extension for performance improvements.
Ajax Catalog & Infinite Scroll - Added various optimizations for ADA compliance to ensure a high degree of compatibility and increased scores across testing platforms.
Ajax Catalog & Infinite Scroll - Added minor adjustments for increased compatibility with Varnish Caching in conjunction with the Google Analytics 4 extension.
Ajax Search Autocomplete - Fixed a bug that would cause HTML tags used in Product Description and Short Description fields to show up as unescaped plain text in the Search Results on the frontend.
Google Tag Manager - Added various optimizations for ADA compliance to ensure a high degree of compatibility and increased scores across testing platforms.
Layered Navigation - Added various optimizations for ADA compliance to ensure a high degree of compatibility and increased scores across testing platforms.
Layered Navigation - Added minor adjustments for increased compatibility with Varnish Caching in conjunction with the Google Analytics 4 extension.
Mega Menu - Fixed a couple of minor CSS/styling issues that would sometimes cause the Mega Menu to break on certain breakpoint resolutions, usually around 768 pixels.
Newsletter Popup - Added minor adjustments for increased compatibility with Varnish Caching in conjunction with the Google Analytics 4 extension.
Owl Carousel & Banner Slider - Added various optimizations for ADA compliance to ensure a high degree of compatibility and increased scores across testing platforms.
Product Labels - Added various optimizations for ADA compliance to ensure a high degree of compatibility and increased scores across testing platforms.
Quick Cart - Added various optimizations for ADA compliance to ensure a high degree of compatibility and increased scores across testing platforms.
Quick View & Ajax Cart - Added various optimizations for ADA compliance to ensure a high degree of compatibility and increased scores across testing platforms.
Recently Viewed Products Bar - Added various optimizations for ADA compliance to ensure a high degree of compatibility and increased scores across testing platforms.
Rich Snippets - Adjusted Product structured data to ensure backorder products with a quantity of 0 always display the correct stock status. Previously, in some cases, this would show as In Stock.
Rich Snippets - Adjusted Home Page structured data to ensure the website name is also included. The value displayed is taken from the Magento Admin website details configuration.
Rich Snippets - Fixed an error that would sometimes be thrown in cases in which the Rich Snippets extension would not have access to the website URL in order to parse it.
Rich Snippets - Fixed an error that would be displayed in Google Search Console with Social Login markups enabled.
Social Login - Fixed a bug that would cause the Social Login popup window to close prematurely in cases in which errors caused by incorrect app configurations were thrown.
Social Login - Added various optimizations for ADA compliance to ensure a high degree of compatibility and increased scores across testing platforms.
Social Login - Added minor code adjustments for increased compatibility with 3rd party extensions/functionalities.

What’s new in v.1.11.19 - October 19, 2023

New Features:

Confirmed compatibility with the newly released Magento 2.4.6-p3, 2.4.5-p5, and 2.4.4-p6 Security Patches for the Pearl Theme, Stack Framework & all individual extensions.
Ajax Catalog & Infinite Scroll - Added a new functionality that allows you to display a Progress Bar which indicates the number of products that have already been loaded, as well as the total number of products available in the Category.
Mega Menu - Added optimizations for ADA Accessibility which address underlying navigation accessibility problems present natively in the Magento 2 core, and which would be flagged by Google Page Speed Insights.
Social Login - Login with Twitter redesign. The Twitter login button has been updated and now uses the new "X" branding, as well as colors. Magento Admin settings have also been updated to reflect new branding and API labels.

Fixes and improvements:

Backend - Optimized the license verification process for increased Magento Admin performance, as well as to account for licensing server downtimes.
Backend - Fixed an issue that would sometimes result in an error being thrown when using older PHP versions, such as PHP 7.4.
Custom Header - Fixed a bug that would prevent the Active Link Color settings in the Magento Admin section from being applied to the header links.
Product Page - Added various optimizations and improvements to Product Page v2 in order to ensure smooth scrolling when using the sticky product info section functionality.
Product Page - Code cleanup, removed unused variables.
Category Page - Added adjustments for compatibility with the new Ajax Infinite Scroll Progress Bar functionality.
CMS Block Scheduler - Fixed an error related to PHP 8 that was thrown in the Magento Admin section when editing a CMS Block using the Block Scheduler functionality.
Email Template Editor - Fixed an issue that would prevent the correct store URL from being used in the Email Template Menu section when sending emails from a store view/website other than the default one.
Email Template Editor - Fixed an error that would be thrown upon attempting to change/reset the password of a customer account. This would only occur when the user was logged in.
Email Template Editor - Adjusted the Order Confirmation email to fetch the Small Image of the products included in the order. Previously, the Thumbnail image would be used.
Email Template Editor - Fixed an error that would sometimes show in email content within the email client (such as Gmail) in certain cases when using custom inline CSS.
Full Page Scroll - Fixed an error related to PHP 8 that would sometimes be thrown on the frontend when attempting to implement the Full Page Scroll functionality.
Google XML Sitemap - Fixed an error related to PHP 8 that would sometimes be thrown upon attempting to generate an XML Sitemap via the Magento Admin section with the extension enabled.
Layered Navigation - Fixed a bug that would cause the Category Page layout to break on Category Pages with special characters in the name, when using the extension in conjunction with the Google Analytics 4 extension.
Layered Navigation - Adjusted the Horizontal Filter design to account for filter dropdowns with a large number of options. Previously, in some cases, the dropdown would extend beyond the height of the screen.
Layered Navigation - Fixed an error that would sometimes be thrown upon loading Category Pages. This would happen when the extension was not able to determine an attribute's ID.
Owl Carousel & Banner Slider - Fixed an issue that would result in images being displayed with incorrect width values in Recently Viewed Products Carousels. Other carousel types were unaffected.
Product Labels - Fixed an error that would sometimes be thrown when using labels on products with a price of 0 and/or similar combinations of pricing and special pricing.
Product Labels - Fixed an issue that prevented the description of the Label Text Magento Admin setting from being displayed, which explains the usage of variables.
Quick Cart - Fixed an error related to PHP 8 that would sometimes be thrown on the frontend when attempting to display a Free Shipping Message via the extension's settings.
Quick View & Ajax Add to Cart Popup - Fixed a bug that would sometimes result in an infinite spinner being displayed in the Mini Cart after adding a product to the cart via the Quick View popup.
Rich Snippets - Fixed an issue that would, in certain cases, result in the duplication of the product data in the Rich Snippets structured data, which could be verified with structured data Testing Tools such as Google's.
Rich Snippets - Fixed a bug that would sometimes result in the extension overriding the product's Canonical URL with a shortened version, which would then be used in the Rich Snippets structured data.
Smart Product Tabs - Fixed a bug that would prevent some of the extension's settings from being applied at the Store View level, even when the "Use Default" checkbox was unchecked.

What’s new in v.1.11.17 - June 28, 2023

New Features:

Magento Compatibility - Confirmed compatibility with Magento 2.4.6-p1, 2.4.5-p3 and 2.4.4-p4 for the Pearl Theme, Stack Framework and all individual extensions.
Magento Cloud - Refactored the Magento Cloud Patches included with the Pearl Theme to account for all Cloud Project types. Previously, the patches would fail on certain project configurations that used specific directory structures, resulting in an inability to regenerate the LESS/CSS files.
Theme Frontend - Enhanced the Pearl Theme's customizability with inherited Media Queries by adding an _extend-child.less file in the main theme and the Custom Pearl Theme for Magento 2 Child Theme.
Licensing - Added .localdev as a universally accepted licensing domain.
Google XML Sitemap - Added the ability to choose whether to use the Canonical URL generated by the extension as the Canonical URL for the XML Sitemap. This applies to Products, Categories and CMS Pages.
Google XML Sitemap - The extension now automatically adds the Magento Base URL to the Canonical URL configured via the settings for Products, Categories and CMS Pages.
Layered Navigation - Added compatibility with Open Search. While Magento Open Source will continue to function with Elasticsearch, Magento Cloud now requires Open Search as the default Search Engine.

Fixes and improvements:

Backend - Fixed an error related to PHP 8.2 that would show when accessing the WeltPixel Debugger.
Theme Frontend - Fixed a bug that prevented the Sale Message functionality from working correctly when products used a Dropdown Attribute type.
Theme Frontend and other modules - Added minor PHP 8.2 related adjustments.
Design Elements - Fixed a bug that would result in 404 errors related to various missing image/loader files.
Product Page - Fixed an issue that would result in Product Images being displayed in an incorrect order on Product Pages V2 and V4.
Product Page - Fixed an error that would show up on certain Magento 2.4.6 installations related to an mage/ie-class-fixer.js file.
Product Page - Fixed an error thrown on the Product Page when the default Magento Reviews functionality was disabled/missing.
Advanced Category Sorting - Fixed a bug that would cause sorting options on the frontend to be displayed incorrectly when not all sorting options were enabled for a specific category.
Ajax Catalog & Infinite Scroll - Fixed a bug that would cause an incorrect addition of tags to Category Pages which were configured to display as Static Blocks with products assigned.
Email Template Editor - Added background and text color adjustments to ensure default values don't overlap with Magento Admin settings and cause text to become unreadable.
Email Template Editor - Fixed a bug that prevented Order Details from showing when sending a Test Email via the extension's Test Email feature.
Email Template Editor - Template Variable Cleanup. Removed unnecessary and unused template variables.
Email Template Editor - Fixed a translation issue that affected the Invoice Email Template.
Google XML Sitemap - Fixed an issue that would cause two Canonical URL tags to be added when using the Ajax Infinite Scroll extension's Canonical URL feature as well. The URL added by the Infinite Scroll module now takes precedence.
Google XML Sitemap - Fixed a bug that caused Sitemap URLs to be generated incorrectly when Magento's Use Categories Path for Product URLs setting was enabled.
Instagram Widget - Fixed an issue that would cause an incorrect table prefix to be added to the Instagram Widget's database tables if a prefix was defined in the Magento configuration.
Layered Navigation - Fixed a bug that would sometimes cause an error related to the Multi Select functionality to be displayed on the Category Page.
Layered Navigation - Fixed a small bug that would cause the Product Count on the Category Page to disappear when a filter was applied.
Layered Navigation - Fixed an issue that would prevent the stars from displaying in the Ratings Filter.
Mega Menu - Fixed a bug that would cause the Mega Menu to render incorrectly some mobile resolutions. This would result in the content overflowing outside of the screen.
Product Labels - Fixed an issue that would cause the indexation of Product Label-specific URLs.
Quick View - Fixed an issue that would sometimes prevent products from being added to cart when using the Quick View Popup functionality.
Rich Snippets - Fixed a couple of minor itemprop errors that would be displayed when running tests via the Markup Validation Service.
Social Login - Fixed a bug that would result in 404 errors related to various missing image/loader files.
Success Page - Fixed an issue that prevented the Success Page from generating links for Bundle Products.
User Profile - Fixed an issue that would cause an incorrect table prefix to be added to the User Profile's database tables if a prefix was defined in the Magento configuration.

What’s new in v.1.11.15 - March 22, 2023

New Features:

Magento Compatibility - Confirmed compatibility for the Pearl Theme and all included extensions with the latest Magento 2.4.6 and 2.4.5-p2 versions.
Frontend Options - Added minor HTML/CSS changes to optimize and improve usability and accessibility.
Custom Header - Added minor HTML/CSS changes to optimize and improve usability and accessibility.
Ajax Search Autocomplete - Added minor HTML/CSS changes to optimize and improve usability and accessibility.
Owl Carousel Slider - Added configuration options to control carousel image size when inserting an Owl Carousel Widget via the Magento Admin.

Fixes and improvements:

Backend - Fixed an error that would sometimes be thrown in the WeltPixel Debugger, depending on various server permissions.
Custom Header - Fixed an issue that would sometimes cause the Global Promo Header to briefly jump when in Production mode.
Custom Header - Added minor HTML/CSS changes to optimize and improve usability and accessibility.
Design Elements - Fixed an issue whereby the theme's Core Icon Boxes were disabled by default, causing certain elements to break on some Home Pages.
Product Page and other modules - Fixed a bug that would occasionally prevent certain frontend notification messages from being displayed.
Product Page - Added additional PHP 8.1 code validations.
Google Tag Manager - Fixed an error that would appear when the default Magento Reviews functionality was disabled.
Owl Carousel & Banner Slider - Fixed a bug that would result in an incorrect redirect when adding a product to the cart from a Cross-Sell Carousel.
Quick View - Fixed a bug that would cause the Quick View button to be displayed incorrectly on certain Category Page configurations.
Quick View - Fixed an error that would be thrown in some cases when displaying the Product Price in the Quick View window.
Social Login - Fixed a bug that would cause the Show Password checkbox to stop working when the Social Login functionality was enabled.
Speed Optimization - Fixed an issue that would result in a console error being displayed after implementing the Advanced JS Bundling process. This was specific to Magento 2.4.4 and 2.4.5.
Success Page - Fixed a small dependency issue when the extension was used with the Pearl Theme.

What’s new in v.1.11.11 - November 23, 2022

New Features:

Magento Compatibility - Confirmed compatibility for the Pearl Theme and all included extensions with the latest Magento 2.4.5-p1 and 2.4.4-p2 versions.
Design Elements - Added a TikTok Icon to the theme's available Icon Library
Ajax Infinite Scroll - Added compatibility with the Google Analytics 4 PRO for sending Item List Views via Measurement Protocol.
Layered Navigation - Added compatibility with the Google Analytics 4 PRO for sending Item List Views via Measurement Protocol.
Mega Menu - Added an option to hide Subcategory Titles from the Mega Menu - this is useful when you want to display your Subcategories as images.
Mega Menu - Added options for various Subcategory padding values, depending on the level and type of element you'd like to apply the values to.
Smart Product Tabs - Added tab ID generation to match the Smart Product Tab name configured in the Magento Admin - this results in increased SEO and allows for better targeting when generating links to specific tabs.

Fixes and improvements:

Custom Header - Fixed an issue related to Search V2 which would prevent the search functionality from working correctly if the page was refreshed while the Search overlay was active.
Custom Footer - Added a LESS file to the extension's file structure for optimizing Magento Cloud installations.
Mobile Detect - General code cleanup related to PHP warnings.
Email Template Editor - Fixed an error related to PHP 8.1 that was thrown when editing an Email Template via the Magento Admin.
Google Tag Manager - Fixed an issue that caused certain dataLayer variables to be marked as "Other" when using Magento's Move JS to Bottom functionality in conjunction with Full Page Caching.
Google Tag Manager - Added various adjustments to Magento Admin setting text for increased clarity.
Layered Navigation - Applied adjustments for increased compatibility with 3rd party Shop By Brand extensions.
Newsletter - Fixed a bug that would, in some cases, result in an error related to a Newsletter Javascript file when running a bundling command via our Speed Optimization extension.
Product Labels - Fixed an issue that would sometimes cause the Product Label position to reset to top-left when saving the configuration in the Magento Admin.
Product Labels - Fixed an error related to PHP 8.1 that was thrown when trying to create a new Product Label on Magento Commerce installations.
Quick Cart - Fixed an issue that prevented the Related Products Carousel from displaying correctly in the Quick Cart.
Quick Cart - Fixed an issue that prevented Product Prices from showing up in the Quick Cart Related Products Carousel.
Quick View - Fixed an error related to PHP 8.1 that was thrown when adding Quick View Messages on Magento Commerce.
Quick View - Fixed a bug that prevented tax from being applied correctly to prices in the Quick View Popup.
Rich Snippets - Fixed an error related to PHP 8.1 that would sometimes be thrown on Configurable Product Pages.
Smart Product Tabs - Fixed a bug that would result in Customer Groups being displayed incorrectly in the module's Magento Admin settings when certain Customer Groups were deleted.
Smart Product Tabs - Fixed an error related to PHP 8.1 that was thrown when creating a new Smart Product Tab via the Grid functionality on Magento Commerce.
Smart Product Tabs - Fixed an issue that would sometimes prevent created tabs from showing on Product Pages when specific conditions were used.
Success Page - Fixed an issue which sometimes caused prices to be displayed without tax on the Success Page, in the Order Items section.

What’s new in v.1.11.7 - September 1, 2022

New Features:

Magento Compatibility - Confirmed compatibility for the Pearl Theme and all included extensions with the latest Magento 2.4.5 and 2.4.4-p1 versions.
Magento Compatibility - Updated installation/upgrade scripts to use data patches.
Google Tag Manager - Extended the Child/Parent SKU/ID functionality to apply to Add to Cart and Remove from Cart events as well.
Quick View - The Add to Cart Confirmation Popup functionality now works on CMS Pages as well - the popup will display when adding products to the cart from Product Carousels or Product Grids.

Fixes and improvements:

Frontend Options - Added additional validations for Admin Font settings.
Custom Header - Fixed an issue that would prevent Search V2 from opening correctly when using the theme's Ajax functionalities.
Product Page - Ensured that the Quantity input on Product Pages respects the Maximum Quantity Allowed setting in the Magento Admin - this currently applies to Simple Products.
Product Page - Added minor code enhancements to keep in line with Magento Best Practices.
Product Page - Fixed an issue that would sometimes cause the Next/Prev Products tooltip to overlap with the header.
CMS Block Scheduler - Fixed a error related to PHP 8.1 that was thrown on the frontend when using the Customer Group functionality.
Email Template Editor - Fixed a bug that prevented the item section from showing up in Email Templates on certain Magento versions.
Email Template Editor - Fixed an error that was thrown when sending or previewing the Newsletter Subscribe Email Template.
Email Template Editor - Fixed a Google Markup error related to an incorrect store frontend URL.
Google Tag Manager - Fixed an error related to PHP 8.1 that occurred when refreshing the Success Page.
Layered Navigation - Fixed an issue that caused the browser back button to return to the previous page when Ajax Filters were applied, as opposed to removing the applied filter.
Layered Navigation - Fixed a bug that prevented the Price Slider from functioning on Magento 2.4.4.
Mega Menu - Fixed an error related to PHP 8.1 that prevented accessing a Category's settings in the Magento Admin - this only affected Magento Commerce.
Mega Menu - Fixed an issue that prevented Font Color options from applying to top-level Categories.
Layered Navigation - Applied optimizations to the filtering functionality to increase compatibility with 3rd party Brand/Shop by Brand modules.
Mega Menu - Fixed a bug that would cause the link on a category in the breadcrumbs to be disabled when using the Custom Link Mega Menu # option within the Category settings.
Mega Menu - Fixed a bug that prevented certain Mega Menu Design Settings from applying to the Full Width Display Mode.
Mega Menu - Fixed a bug that prevented Level 1 Category settings from applying if there were no subcategories present.
Newsletter Popup - Fixed an issue that prevented the Newsletter from automatically appearing when it was configured to do so.
Owl Carousel Slider - Fixed a bug related to PHP 8.1 that prevented sliders configurations from being saved in the Magento Admin section.
Owl Carousel Slider - Added minor code enhancements to keep in line with Magento Best Practices.
Product Labels - Fixed an error related to PHP 8.1 that was thrown in some cases when creating a Product Label via the Magento Admin.
Product Labels - Fixed a bug that prevented the Product Label Position Grid from showing in the Label Configuration section.
Quick View - Fixed a bug that prevented the Continue Shopping button on the Add to Cart Popup from functioning correctly.
Rich Snippets - Fixed an error that would sometimes be thrown on the Category Page when using a custom attribute in the Brand configuration option, along with a Meta Description on the Product Page.
Rich Snippets - Fixed a bug that resulted in an error on the Product Page when the product had no Description.
Smart Product Tabs - Fixed an issue that would sometimes prevent Customer Group names from displaying correctly in the Smart Product Tab Grid.
Social Login - Fixed an error related to PHP 8.1 that was thrown upon trying to create and account/log in via the Google Login.

What’s new in v.1.11.1 - April 25, 2022

New Features:

Magento Compatibility - Confirmed compatibility for the Pearl Theme and all included extensions with the latest Magento 2.4.4 and 2.3.7-p3 versions.
PHP Compatibility - Confirmed compatibility for the Pearl Theme and all included extensions with PHP 8.1.
Product Page - Added an option to have Accordion Tabs on Product Pages closed by default. Previously, one of the Accordion Tabs were opened by default on page load.
Google Tag Manager - Added the possibility of including custom Success Page URLs with an asterisks to account for dynamic Success Page URLs and increase compatibility with 3rd party Payment Methods.
Layered Navigation - Moved all the WeltPixel Layered Navigation options under their own tab in the Admin -> Stores -> Attributes -> Product section, at the attribute configuration level.
Layered Navigation - Added a new option in the Magento Admin that allows for choosing whether the page should scroll back to the top after filtering via the Ajax functionality.
Layered Navigation - Added a new option in the Magento Admin that allows for keeping an attribute fully opened in the sidebar after filtering with Multiple Select.
Product Labels - Discounts are now displayed in the Cart if coupon codes are used.

Fixes and improvements:

Theme frontend - Fixed various styling issues for Braintree icons on the Checkout Page.
Custom Header - Fixed an issue whereby the Search Icon would not reposition to its original location after resizing the page.
Product Page - Added adjustments to prevent Product Page Tab settings/styling from applying on mobile. Settings are now desktop-only as intended.
Product Page - Adjusted Size Chart Condition setting to ensure it's set to True by default when the option is enabled.
Product Page - Fixed an issue that would sometimes cause the Next/Prev Products tooltip to overlap with the header.
Backend - Fixed an incorrect licensing message on B2B Magento Enterprise instances which would display when an invalid license was entered.
Advanced Category Sorting - Fixed an error that occurred when manually inputting invalid sorting parameters via the URL.
Ajax Search Autocomplete - Fixed a bug that would sometimes result in categories from different websites within the Magento installation being displayed in the Search Results.
Email Template Editor - Fixed a styling issue that prevented the menu from loading horizontally in email templates when using the Outlook client for Windows. Other versions and clients were unaffected.
Email Template Editor - Fixed an error that prevented Magento Bundle Products from appearing in email templates.
Google Tag Manager - Fixed an error that occurred when the Impression Chunk Size setting in the Magento Admin was set to 0.
Google Tag Manager - Removed the deprecated Login with Google functionality from the Magento Admin settings.
Google Tag Manager - Ensured Price and Quantity values are passed as integers via the dataLayer to conform to Google recommendations.
Google Tag Manager - Initiated a clear of the dataLayer eCommerce object before a push event to conform with Google recommendations.
Google Tag Manager - Code cleanup: Removed certain unused jQuery/UI elements from the Magento Admin.
Instagram Widget - Fixed an issue the caused certain parts of the extension settings to be accessible without a license key.
Layered Navigation - Applied various optimizations to the extension's DB operations which sometimes caused sluggish performance on very large product catalogs.
Layered Navigation - Applied optimizations to the filtering functionality to increase compatibility with 3rd party Brand/Shop by Brand modules.
Mega Menu - Fixed a bug that would cause the link on a category in the breadcrumbs to be disabled when using the Custom Link Mega Menu # option within the Category settings.
Mega Menu - Fixed a bug that prevented certain Mega Menu Design Settings from applying to the Full Width Display Mode.
Mega Menu - Fixed a bug that prevented Level 1 Category settings from applying if there were no subcategories present.
Owl Carousel & Slider - Fixed a bug that caused all banners within a Slider to disappear unless there was an Image type banner present in the Slider.
Quick Cart - Added the backorder notification to the Quick Cart as well - this was previously only displayed on the Cart Page.
Quick Cart - Added updated translations.
Quick View - Fixed a bug that prevented the Quick View Popup from displaying when using the Owl Carousel Free extension and displaying a carousel in the Popup.
Smart Product Tabs - Fixed a bug that prevented content from tabs built with the Smart Product Tab Grid functionality from being edited with the Magento Page Builder.
Social Login - Performed various code cleanups and removed unused functions.
User Profile - Added improvements to Date Picker styling.

What’s new in v.1.10.17 - October 22, 2021

New Features:

Magento Compatibility - Confirmed compatibility for the Pearl Theme and all included extensions with the newly released Magento 2.4.3-p1 and 2.3.7-p2 versions.
Category Page - Added a new Admin option that allows for controlling the speed for the Hover Animation on Category Pages.
Sample Data - Added a new Home Page called Home Page V16, built with the Magento Page Builder. This new Home Page is exclusive to Magento 2.4.x installations.
Owl Carousel and Banner Slider - Added a new sorting option for Recently Viewed Product Carousels that allow for sorting items in the order they were seen.
Owl Carousel and Banner Slider - Added new options to control banner transtion speed when using the AutoPlay functionality.
Owl Carousel and Banner Slider - Added options to control radius for Banner Slider Next/Prev buttons.
Product Labels - Added a new functionality that allows for dynamic label construction with variables. Show your customers discount percentages for products with Special Prices or implement the FOMO effect by making it obvious when discounts end. Different combinations are possible and result in conversions going up.