mage-os / module-advanced-widget

mage-os/module-advanced-widget

Advanced cms widget module

  • Davide Lunardon
  • Yuriy Boyko
magento2-module Compatibility: 2.4.7-2.4.9 Code Quality: Fail Tests: N/A Security: Pass MIT

MageOS AdvancedWidget Module for Magento

Add configurable multi-row CMS Widgets with image picker component, product picker component, select fields and much more.


Overview

The AdvancedWidget module allows you to define multi-row CMS widgets.
These features combined with MageOS_PageBuilderWidget module (that is explicit dependency) make finally possible to develop custom pagebuilder components with own preview and a large set of configurations.
Complex pagebuilder ui components development is no more needed.

πŸš€ Features

  1. This module let you specify Title separators inside widgets
    [image: title section]
  1. This module let you specify multiple "repeatable" sections where you can specify unlimited rows inside widgets
    [image: repeatable section]

2.1) Each item field can receive a dedicated tooltip
[image: repeatable section]

2.2) Each field is validated and ask to be required for compilation
[image: repeatable section]

2.3) Items can be sorted
[image: repeatable section]

2.4) You can specify whether a field is editable directly in the main box or whether it must be edited in the detail modal.
[image: repeatable section]

  1. Row item images fields are available
    [image: image field]
    [image: image field selection]
  1. Row item select fields are available
    [image: select field]
  1. Row item product fields are available
    [image: product field]
    [image: product field selection]

πŸ”§ Installation

  1. Install it into your Mage-OS/Magento 2 project with composer:

    composer require mage-os/module-advanced-widget
    
  2. Enable module

    bin/magento module:enable MageOS_AdvancedWidget
    bin/magento setup:upgrade
    

🀝 Changelog

Please see CHANGELOG for more information on what has changed recently.

πŸ“„ License

The MIT License (MIT). Please see License File for more information.

Attribution

This software uses Open Source software. See the ATTRIBUTION page for these projects.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog
and this project adheres to Semantic Versioning.

1.2.1

Fixed - Added

  • Add wysiwyg and color repeatable component types
  • Fix fatal error on redeclaration for properties removing protected attribute from $rawResultFactory and $getInsertImageConten. Thanks to @Sental

1.2.0 - 2026-04-21

Fixed

  • PHP 8.5 compatibility: cast nullable values to string before passing to str_replace, strpos, str_contains, preg_match, explode, urldecode and similar string functions to avoid deprecation notices and fatal errors
  • Cast nullable values to string/int before using as array index (PHP 8.5 null array key deprecation)
  • Replace deprecated strpos / strpos(..., 'http') === false usages with str_starts_with / str_contains
  • Add declare(strict_types=1) and missing return type hints to Controller/Adminhtml/Image/Chooser
  • Clean up redundant $this->escaper = $escaper ?: ObjectManager::getInstance()->get(...) fallback in Controller/Adminhtml/Product/Widget/Chooser (constructor already enforces non-null Escaper)

Changed

  • Change remaining private promoted/regular properties to protected for consistent extensibility across all classes

1.1.2

Fixed

  • Fix getRowClickCallback() returning null instead of string when massaction is enabled
  • Change private constructor properties to protected for extensibility

1.1.1

Fixed

  • Unset missing products from repeatable fields during widget configuration rendering

1.1.0

Updated

  • Update composer JSON making the module installable for Magento Opensource also

1.0.0

Added

  • First Commit, now is possible to define CMS widgets with multiple row fields!
Versions
Version Stability QA Status Compatibility Released
1.2.2 stable Fail Magento 2.4.7-2.4.9 Details 2026-05-30 16:32:10
1.2.1 stable Not tested Not yet tested Details 2026-05-29 13:13:18
1.2.0 stable Not tested Not yet tested Details 2026-05-06 03:30:45
1.1.2 stable Not tested Not yet tested Details 2026-04-16 16:14:09
1.1.1 stable Not tested Not yet tested Details 2026-03-13 07:06:07
1.1.0 stable Not tested Not yet tested Details 2026-03-10 10:44:00
1.0.1 stable Not tested Not yet tested Details 2026-02-25 09:45:11
1.0.0 stable Not tested Not yet tested Details 2025-10-11 17:29:36

Requires 4

Package Constraint
php ^8.1
magento/module-widget *
magento/module-page-builder ^2.0
mage-os/module-page-builder-widget *

Compatibility

Each Magento release line is installed on its supported PHP versions, then the module is built (DI compilation + static-content deploy) and its unit and integration suites are run. The matrix shows the lines and PHP versions the module is confirmed to install and run on. Code-quality results further down (phpstan, phpcs, …) are reported separately and never affect compatibility.

Compatibility matrix (Magento Γ— PHP)
Magento PHP 8.2 PHP 8.3 PHP 8.4 PHP 8.5
2.4.7 Pass Pass
2.4.8 Pass Pass
2.4.9 Pass Pass

Code Quality

Advisory checks against the module's source. Static analysis runs once across the whole module; PHPStan re-runs per Magento + PHP version because resolvable symbols differ between releases. These NEVER affect the Compatibility badge β€” a phpcs finding can't make a module incompatible.

Static analysis

Coding standards (phpcs), mess detection (phpmd), copy-pasted code (cpd), PHP cross-version compatibility, composer.json validity. Each runs once for the whole module.

Static analysis results
Tool Status Findings Summary
PHPCS Fail 136 45 errors, 91 warnings (ruleset: Magento2) β€” 45 auto-fixable with phpcbf
PHPMD Warning 5 5 rule violations (IfStatementAssignment:2, UnusedFormalParameter:2, UnusedLocalVariable:1)
Cpd Pass 0
Composer validate Info 2 valid; 2 advisory notes (composer validate --strict)

PHPStan

Type-checks the module's PHP against a real Magento install at the configured gate level. Re-runs per Magento and PHP version because resolvable symbols differ between releases. Cell β†’ details modal.

PHPStan results by Magento and PHP version
Magento PHP 8.2 PHP 8.3 PHP 8.4 PHP 8.5
2.4.7 21 21
2.4.8 20 20
2.4.9 16 16

Tests

Unit and integration suites, run for each applicable Magento and PHP version. A test failure speaks to the module's behaviour, not its compatibility with a Magento line, so it is reported here separately and never reddens the compatibility matrix.

Unit tests

Unit tests results by Magento and PHP version
Magento PHP 8.2 PHP 8.3 PHP 8.4 PHP 8.5
2.4.7 N/A N/A
2.4.8 N/A N/A
2.4.9 N/A N/A

Integration tests

Integration tests results by Magento and PHP version
Magento PHP 8.2 PHP 8.3 PHP 8.4 PHP 8.5
2.4.7 N/A N/A
2.4.8 N/A N/A
2.4.9 N/A N/A

Security

Security checks run directly against the module: an audit of its declared dependencies for known vulnerabilities (composer audit) and a scan of its source for malware and web-shell signatures. Each runs once. A malware detection fails the version outright.

Security results
Tool Status Findings Summary
Composer audit Pass 0
Malware scan Pass 0
License
MIT
Authors

More from mage-os

View vendor
Make it pay

Turn an existing module into recurring revenue.

If you already maintain a Magento 2 module on GitHub or GitLab, listing it on Packagento takes about five minutes. We mirror your tags, handle distribution signing, and route paid licenses through Stripe Connect, so you can keep shipping the way you already do.