Lumarix Theme Project

Lumarix is a base theme for all future Rixxo projects, idea is to build and maintain reusable codebase for faster development and easier maintaining of the codebase

Dev Admin Credentials

Url: http://dev.example.com/admin_lumarix

• Username: rixxo

• Password: rixxo123

• DB_name: lumarix

Features

• Ajax qty and remove function on cart and minicart

• Enhanced ecommerce analytics tracking

• Extended GTM data layer and full ecommerce coverage

• SEO Schema coverage

• Custom breadcrumbs implementation

• GDPR requirements

• Cookie Consent

• Cweagans composer patches

Theme Setup

• Rixxo_GoogleTagManager - Configuration can be modified at Stores -> Configuration -> Sales -> Google API

• Rixxo_Seo - Scheme data has to be manually configured in the templates of the extension (Rixxo/Seo/view/frontend/templates/store_info.phtml & Rixxo/Seo/view/frontend/templates/catalog/product_info.phtml)

• Rixxo_CustomAttributeManagement - Dependency of CustomerCustomAttributes

• Rixxo_CustomerCustomAttributes - Allows for creation and modification of customer and customer address entity attributes from administration grid. (Stores -> Attributes -> Customer/Customer Address)

• Rixxo_CookieConsent - Cookie consent configuration Stores -> Configuration -> Rixxo -> CookieConsent

• Rixxo_Gdpr - GDPR configuration Stores -> Configuration -> Rixxo -> Gdpr

Placeholders

Product placeholders have to be manually replaced, along with logo and loader.gif's

• Rixxo/lumarix/Magento_Catalog/web/images/product/placeholder/*

• web/images/gallery_placeholder.jpg

• web/images/loader-1.gif

• web/images/loader-2.gif

Roadmap

• [x] Installation of 2.4.3 and setup of the project

• [x] Installing extension bundle

• [x] Applying latest security patches and setting up framework for future ones (cweagans/composer-patches)

• [x] Adding custom extensions for SEO and GTM optimizations

• [x] Performance optimizations in theme by cutting down unused JS

• [x] Migrate and refactor CMS content

• [ ] Styling frontend

• [ ] Styling backend

• [ ] Transactional Emails

• [ ] Demo site

See the open issues for a full list of proposed features (and known issues).

Contributing

1. Fork the Project

2. Create your Feature Branch (git checkout -b feature/LUM-XXX)

3. Commit your Changes (git commit -m 'Commit message is mandatory')

4. Push to the Branch (git push origin feature/LUM-XXX)

5. Open a Pull Request here

Installation

Template that was used for setup: Magento 2 Quick Start Install Refference

• Search engine: Elastic

• Session cache: Redis

• Page cache: NVME disk or Fastly

...

...

Overview

This package will install the Base Lumarix theme to Magento with the Magento/Blank as it's parent theme.

It will also install the required CMS Blocks, Pages and Third Party Modules required for the theme.

Installation

• Create the database and user as per Sonassi guidelines - https://www.sonassi.com/help/mysql/adding-a-new-database-and-user

• Navigate to the website document root (/http directory on Sonassi)

• Create a Magento 2 project using Composer

composer create-project --repository-url=

...

https://repo.magento.com/

...

 magento/project-community-edition 

...

.

• Set Magento file permissions

find var generated vendor pub/static pub/media app/etc -type f -exec chmod g+w {} +
find var generated vendor pub/static pub/media app/etc -type d -exec chmod g+ws {} +
//chown -R :www-data . #
Ubuntu specific, otherwise use your own 
chmod u+x bin/magento

# Setup magento configuration

• Install Magento on the command line, changing database details & store URLs

  Code Block
  bin/magento setup:install --cleanup-database \ --base-url=

...

• http://test.lumarix.shop/

...

• \ --db-host=

...

• db1.i \ --db-name=lumarix_test \ --db-user=

...

• lumarixtest \ --db-password=

...

• gFD6kNvcdfo6 \ --admin-firstname=

...

• Rixxo \ --admin-lastname=

...

• Admin \ --admin-email=

...

• dev@rixxo.com \ --admin-user=rixxo \ --admin-password=rixxo123 \ --backend-frontname=lumarixadmin \ --language=en_

...

• GB \ --currency=GBP \ --timezone=Europe/London \ --use-rewrites=1 \ --search-engine=elasticsearch7 \ --elasticsearch-host=

...

• search1.i \ --elasticsearch-port=9200

• Create the file auth.json in the document root directory with the following content:

  Code Block
  { "http-basic": { "repo.magento.com": { "username":"16fa74b8c1076dd14e75ba35434537dd", "password":"7a8596da3464634d531e402f39f04cd5" }, "dist.aheadworks.com": { "username": "AAAAB3NzaC1yc2EAAAADAQABAAABAQC52KiKTJxjjaUKGcqEF5jDEhpzqb8W0o8L", "password": "MIIEpAIBAAKCAQEAudioikycY42lChnKhBeYwxIac6m/FtKPC4ZDFmlhdDK+hX3F" } } }

• Install Sample Data now (optional)

  Code Block
  bin/magento sampledata:deploy bin/magento setup:upgrade bin/magento setup:di:compile bin/magento setup:static-content:deploy

• Configure Composer to use the Rixxo Repository authorisation token

  Code Block
  composer config --global --auth http-basic.rixxo.repo.repman.io token fa87c5fd081f292ac02869e8d8b317951a99d1d0de7f99dffac4d432a3c8a123

• Add the Rixxo composer repository

  Code Block
  composer config repositories.rixxo composer https://rixxo.repo.repman.io

• Add the Aheadworks composer repository

  Code Block
  composer config repositories.aheadworks composer https://dist.aheadworks.com/

• Install the Lumarix Theme and included modules

  Code Block
  composer require rixxo/theme-frontend-lumarix

• Run the following commands to complete the setup of Magento

  Code Block
  bin/magento setup:upgrade bin/magento setup:di:compile bin/magento setup:static-content:deploy

• Log in to the Magento Admin at /lumarixadmin using the admin details from the installation step. From the Admin side menu select "Content -> Design -> Configuration". Select 'edit' on the top entry in the list, change the 'Applied Theme' to Rixxo/Lumarix.

• Scroll down to 'Header' and replace the logo and save the configuration

• Configure product placeholder images at "Stores > Settings > Configuration -> Catalog -> Catalog"

• Install the Lumarix CMS Blocks & Widgets

  Code Block
  bin/magento rixxo:lumarix:install-blocks

• Clear the cache

  Code Block
  bin/magento clear:cache