OXID eShop Compilation 7.6.0

Release date: November 16, 2026

Note

OXID eShop 7.6 continues to support PHP 8.3, 8.4 and 8.5 (minimum version PHP 8.3); the PHP version range remains unchanged compared to 7.5.

Highlights

Content & Media Bundle 12

With OXID eShop 7.6, the new Content & Media Bundle 12 is preinstalled. It consists of the following components:

  • Media Library 6

  • WYSIWYG Editor 8

  • Visual CMS 12 (Enterprise and Professional Edition only)

  • Visual CMS 12 - Dynamic Blocks (central new feature): With Dynamic Blocks, CMS content can be displayed at defined positions in the theme (“blocks”). Which content appears at a block is assigned in the admin area - without editing the template; the deciding factor is the context of the assignment: global or bound to a specific product, category or manufacturer; specific assignments take precedence over general ones. Within the block, the familiar Visual CMS visibility controls continue to apply - time-based (date and time, per row/widget) and device-specific (visibility per screen size, per widget).

    This way, a promotional banner can appear, for example, only on a specific category page, and individual elements within it only during a promotion period or only on certain devices. Four blocks (before and after the header and footer) are preconfigured; additional blocks can be set up. The feature is disabled by default and is enabled in the module settings. For detailed instructions and examples, see the Visual CMS documentation.

  • Visual CMS 12 - custom styles now as SCSS: custom styles in CMS content are interpreted as SCSS instead of LESS as of Visual CMS 12. You can check existing content beforehand with ./vendor/bin/oe-console ddoevisualcms:migrate:less-to-scss --dry-run.

  • Media Library 6 - error-free content out of the box: A bundled fallback image is set automatically, so pages render cleanly even when media are missing or deleted - without any configuration. The fallback medium is protected against accidental deletion; missing media can be found more quickly via diagnostic messages.

  • WYSIWYG Editor 8 - more stable CMS links & media URLs: CMS ident links are resolved correctly (no 404), Twig expressions in the filter are preserved, and media URLs are stored as oeMediaUrl instead of hardcoded.

Note

During the update you choose one of the three offered bundle versions (12, 11 or 8); this can be preconfigured as described in the update guide. Older lines (e.g. Visual CMS 9.x/10.x, Media Library 4.x, WYSIWYG 6.x) are not continued; existing installations switch to one of the offered versions.

Note

Note for extensions: Media Library 6 is a major release. The methods MediaFacadeInterface::getMedia() and getMediaUrl() received an additional optional parameter - calling code remains compatible; modules that implement or decorate this interface must be adapted.

Configurable Storefront Rate Limiter

New in 7.6 (included in CE v7.6.0): an optional storefront request rate limiter, disabled by default. It limits the call frequency of storefront actions on a rule basis - from a coarse, global limit (throttling individual clients that call too often) to targeted rules for sensitive actions such as login. It responds with 429 + Retry-After / X-RateLimit-*; extension hook RateLimitExceededEvent; console command oe:rate-limiter:prune (cron). It is a standalone limiter in addition to the API rate limiter already available since 7.5; the two operate independently of each other.

Security Baseline

Several improvements harden the shop across the entire compilation:

  • Stronger password hashing: The default bcrypt cost was increased (#0007727).

  • Trusted proxies: Remote address resolution now uses Symfony’s Request::getClientIp(). Proxy headers are no longer trusted by default; trusted IPs are configured via the DI parameter oxid_esales.request.trusted_proxies.

  • HTTPS behind SSL offloaders is detected via forwarded headers from trusted proxies.

  • APEX - external product URL secured: external URLs are escaped and the scheme is checked (XSS/scheme injection hardening).

  • GDPR-compliant deletion: When deleting a user by ID, all related records are now removed via cascade (#0007138).

Modern Foundation - Migrations, Module Lifecycle, Console

The technical base continues to be modernized within a predictable framework - old methods remain usable, the new way is shown:

  • Database migrations registerable via DI: Doctrine migrations can be provided via the DI tag oxid_esales.migration_path_provider (MigrationPathProviderInterface). This benefits components and is also the future preferred way for modules.

  • New console command oe:database:migrate to run the migrations.

  • Services before activation: Modules can provide selected services via an optional bootstrap-services.yaml - loaded for every installed module, regardless of activation state.

  • Clean console return values: Console commands return consistent exit codes (0 = success, 1 = failure) - CI/automation-ready.

Note

Note for theme and module developers: The Vite-based asset build was updated (Vite version bump, Sass 1.80). As a result, the Node version required for the asset build increases: APEX theme Node 20.19+, the modules of the Content & Media Bundle - Media Library, WYSIWYG Editor and Visual CMS - Node 22.12+ or 22.13+ respectively. This affects only the asset build; shop operation itself does not change.

Continued Modernization (Deprecations)

In the course of modernization, some paths are marked as deprecated; the previous methods remain usable, the new way is named in each case. Excerpt:

  • Module metadata.php events (onActivate / onDeactivate) → DI event subscriber.

  • oxid-esales/oxideshop-doctrine-migration-wrapper / oe-eshop-db_migrate → oe:database:migrate.

  • The BC autoloader for legacy class names (e.g. oxarticle, oxorder) - as well as the generation of the corresponding BC class aliases in the Unified Namespace Generator.

  • Argon2IPasswordHashService; UtilsServer::getRemoteAddress() / ViewConfig::getRemoteAddress().

The complete deprecation list can be found in the CE changelog 7.6.

Improvements & Bug Fixes

  • #0006025 Case-sensitive column names in the admin order article search: Bugtracker

  • #0007073 Products already assigned no longer appear under “All available Products” in the category assignment popup: Bugtracker

  • #0007770 Endless redirect and wrong URL generation fixed: Bugtracker

  • Admin login no longer emits a PHP warning when the request has no Accept-Language header: PR-999

  • Address selection validation in account and checkout corrected.

  • APEX #0007703 Product detail tabs render content again: Bugtracker

  • APEX #0007880 Price calculation in order summary e-mails corrected: Bugtracker

  • APEX #0007866 Missing oxwactions template added: Bugtracker

  • APEX Order history “Shipped” status corrected: PR-72

  • APEX #0008006 Recommendation list page (cl=recommlist) renders again (leftover Smarty -> syntax removed); heading title, author and search term are escaped: Bugtracker

  • APEX Review page (cl=review) renders again when reviews are enabled (product rating in the reviews widget skipped on non-product pages).

  • Twig Admin #0007837 Field controls for unsaved/inherited selection lists: Bugtracker

  • Twig Admin #0007953 Setting a category as the main category on a product: Bugtracker

  • Twig Admin: In the admin AJAX assignment lists (e.g. assigning products, groups or accessories), the display of a column can now be customized via a custom formatter.

  • WYSIWYG Editor: CMS ident links/Twig filter fixed, media URLs as oeMediaUrl, image URL cache cross-frame, leading <style> tag preserved during DOMPurify sanitization.

  • WYSIWYG Editor: The migration command ddoewysiwyg:migrate:urls-to-ids now converts media references in all img src and a href attributes (instead of only in marked images), reports every converted and every unresolvable reference, and can output the report as CSV via --report-file.

  • Media Library: the requested media ID is preserved in the exception when no fallback is configured, media URL cache frame sharing; uploaded items show the stored file name; newly created folders appear at the top.

  • GDPR Opt-In: exported files get a file extension.

  • Demodata CE: correct SEO identifiers for “forgot password” pages.

Packages

Note

The 7.6 compilation consists of CE, PE and EE (B2B is not part of the initial 7.6 compilation).

OXID eShop CE Compilation

With functional 7.6 change:

  • OXID eShop CE v7.5.3 → v7.6.0: Changelog

  • APEX Theme v3.1.0 → v3.2.0: Changelog

  • WYSIWYG Editor Module v7.0.1 → v8.0.1 (Content & Media Bundle 12; alternatively v7.1.1 for Bundle 11 or v5.0.1 for Bundle 8): Changelog

  • Media Library Module v5.1.0 → v6.0.0 (Content & Media Bundle 12; alternatively v5.2.0 for Bundle 11 or v3.0.0 for Bundle 8): Changelog

  • GDPR Opt-In Module v4.4.0 → v4.5.0: Changelog

  • Twig Admin Theme v3.1.0 → v3.2.0: Changelog

  • Unified Namespace Generator v5.3.1 → v5.4.0: Changelog

  • OXID Cookie Management powered by Usercentrics v3.3.0 → v3.4.0 (7.6 compatibility only): Changelog

  • Demodata CE v8.1.0 → v8.1.1: Changelog

  • Doctrine Migration Wrapper v5.5.0 → v6.0.0 (package is deprecated - replaced by oe:database:migrate): Changelog

Without functional 7.6 change (branch initialization / workflow / test adjustments only) remain on their 7.5 version:

External:

  • Eye-Able Assist v3.0.3 (unchanged)

  • Makaira Connect Essential 2.2.0 → 2.2.1

OXID eShop PE Compilation

The OXID eShop PE Compilation additionally contains the following packages:

  • OXID eShop PE v7.5.3 → v7.6.0

  • OXID eShop Demodata PE v8.1.0 → v8.1.1

  • Twig Component PE v2.6.0 (unchanged)

  • Visual CMS Module v10.0.1 → v12.0.0 (Content & Media Bundle 12; alternatively v11.1.0 for Bundle 11 or v8.0.2 for Bundle 8)

OXID eShop EE Compilation

The OXID eShop EE Compilation additionally contains the following packages:

  • OXID eShop EE v7.5.3 → v7.6.0

  • OXID eShop Demodata EE v8.2.0 → v8.2.1

  • Twig Component EE v2.6.0 → v2.7.0

Compatible OXID Extensions

Update

The update procedure is described step by step in our update guide.

Installation

If you want to install OXID eShop 7.6 from scratch, please follow our installation guide.