Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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 requierments

  • 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 lastest 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

...

languagebash

...

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

Code Block
composer create-project --repository-url=

...

https://repo.magento.com/

...

 magento/project-community-edition 

...

.

  • Set Magento file permissions

Code Block
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