README

Overview

ApexPlus is a lightweight enhancement module for the Apex theme in OXID eShop 7. It provides a set of carefully scoped CSS improvements to fix common layout inconsistencies and usability issues without modifying core templates.

The module focuses on stabilizing the default frontend behavior while remaining fully compatible with existing themes and customizations.

Goals

Improve visual consistency across breakpoints
Fix common layout issues in header, footer, and checkout
Provide a stable baseline for further project-specific styling
Avoid invasive template overrides
Maintain maximum compatibility with existing projects

Non-Goals

Redesigning the Apex theme
Replacing existing layouts or components
Introducing opinionated UI changes
Enforcing structural changes in Twig templates

ApexPlus intentionally limits its scope to minimal, targeted improvements.

Features

Layout Improvements

Consistent container widths on large viewports
Stabilized footer spacing on mobile devices
Improved grid behavior in critical views (e.g. checkout, account)

Header Adjustments

Corrected logo scaling across breakpoints
Improved navigation spacing

Checkout Fixes

Optimized spacing for checkout steps on small screens
Reduced layout issues in responsive views

Form & Input Fixes

Improved rendering of form elements (e.g. newsletter forms)

Technical Approach

ApexPlus follows a strictly non-invasive strategy:

Uses scoped CSS via .apex-plus to avoid side effects
Relies on existing DOM structure and classes
Avoids template overrides wherever possible
Uses modern CSS techniques (:where, :is, logical properties)

This ensures maximum compatibility and low maintenance overhead.

Installation

Use this command to install the module:
```
composer require d3/apex-plus
```
Activate the module in the OXID admin panel
Ensure the .apex-plus class is present on the <html> element

Usage

No configuration is required.

Once activated, ApexPlus automatically applies its improvements to the frontend.

Compatibility

OXID eShop 7.x
Apex theme

Designed to work alongside custom themes and project-specific overrides.

Limitations

Does not address structural issues in templates
Some edge cases may still require project-specific adjustments
Relies on existing Apex markup conventions

License

This module is distributed under the GPL v3 License. For more information see the ./LICENSE file.

d3/apex-plus

包简介

关键字：

README 文档