README

Chameleon Shop Theme based on: https://themes.getbootstrap.com/product/sell-bootstrap-4-e-commerce-template/

Installation

1. Remove Bundle chameleon-shop-theme-bundle

   composer remove chameleon-system/chameleon-shop-theme-bundle
   

2. Install Bundle

   composer require chameleon-system/chameleon-shop-theme-sell:dev-main
   

3. Copy ChameleonShopThemeSellBundle in Project

   cp -r vendor/chameleon-system/chameleon-shop-theme-sell/Resources/bundle-dist/Esono ./src/
   

4. Create Symlik from theme-sell-bundle

   cd customer/src/Esono/ChameleonShopThemeSellBundle/Resources/theme/scss
   ln -s ../../../../../../vendor/chameleon-system/chameleon-shop-theme-sell/Resources/sell-dist/scss/ sell-dist-scss
    ```
   
   

5. Check if a AmazonPay Bundle has been installed

   composer require chameleon-system/amazon-pay-bundle:~7.1.0
   

6. Update AppKernel.php

   /home/wwwusers/../customer/app/AppKernel.php
   ....
   new \ChameleonSystem\ChameleonShopThemeSellBundle\ChameleonSystemChameleonShopThemeSellBundle(),
   new \Esono\ChameleonShopThemeSellBundle\EsonoChameleonShopThemeSellBundle(),
   new \ChameleonSystem\AmazonPayBundle\AmazonPayBundle(),
   

7. Install NPM Packages Before the assets building, we need the installation all dependencies, for from the customer directory:

   npm --prefix src/Esono/ChameleonShopThemeSellBundle/Resources/theme install
   

8. Building SASS

Build assets by running the respective npm script for a dev or prod build from the customer directory:

npm --prefix src/Esono/ChameleonShopThemeSellBundle/Resources/theme run build-dev

or

npm --prefix src/Esono/ChameleonShopThemeSellBundle/Resources/theme run build-prod

1. Demo Database, if needed.

You can also use the database within https://redmine.esono.de/projects/frxsh/files, it corresponds to the demo database

Watch Mode for Development

To watch the code and build whenever something changes, run the watch npm script from the customer directory:

npm --prefix src/Esono/ChameleonShopThemeSellBundle/Resources/theme run watch

Dev Notes

• JS files are not compiled at the moment.
• Copies of Images, Icons files are not included from Base Theme Bundle in system.

DevOps Notes

Webpack Output Directory:

/web/assets/esonochameleonshopthemesell/css/

Todo

• JS Dependencies
  • Many Javascript Libraries are currently registered as Dependencies, it would be useful for the installation and development process to extract the unused ones.

Manual ToDo (WIP):

• change logo image
• all text blocks
• Address in Resources/public/js/theme.js
• change and add lines in /customer/app/config/config.yml like this:
  • chameleon_system_shop.article_list.view_to_list_view_mapping: rightNoticeList: "/common/lists/listScrollShopArticle.html.twig" full: "/common/lists/listScrollShopArticle.html.twig" carouselWide: "/common/lists/listStandardShopArticleCarousel.html.twig" carouselWideGrayBackground: "/common/lists/listStandardShopArticleCarousel.html.twig" standardEmptyOnNoArticles: "/common/lists/listScrollShopArticle.html.twig" standard: "/common/lists/listScrollShopArticle.html.twig"
• This bundle sets default text-blocks (Textbausteine). There are 2 things to consider:
  • The field 'name' in table (pkg_cms_text_block) is set to "required" by default as long as the core issue #764 (https://github.com/chameleon-system/chameleon-system/issues/746) isn't done. If not see at FRXSH-Project the update src/AppBundle/Bridge/Chameleon/Migration/Script/update-1639733263.inc.php Without this change it isn't possible to change the text blocks manually in Backend without headline that comes from field 'name'.
  • if you change the text-blocks with updates within the customer bundle, make sure that the updates with the default texts from this bundle must run beforehand.