PHPackages rollpix/module-disable-sales - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. rollpix/module-disable-sales ActiveMagento2-module rollpix/module-disable-sales ============================ Magento 2 module to temporarily disable sales without disabling catalog navigation 1.1.7(2mo ago)012MITPHPPHP >=7.4 Since Feb 26Pushed 2mo agoCompare [ Source](https://github.com/ROLLPIX/M2-DisableSales)[ Packagist](https://packagist.org/packages/rollpix/module-disable-sales)[ RSS](/packages/rollpix-module-disable-sales/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (9)Dependencies (8)Versions (10)Used By (0) Rollpix\_DisableSales ===================== [](#rollpix_disablesales) > **[Version en español](README.es.md)** **SPONSOR:** [www.rollpix.com](https://www.rollpix.com) Magento 2 module to temporarily disable sales in an online store without affecting catalog navigation. Ideal for high-demand situations, maintenance, or when you need to pause purchases without taking the site down. Supports restricting sales by **customer group**, so you can block purchases for specific groups while allowing others to continue buying. Compatibility ------------- [](#compatibility) RequirementSupported versionsPHP7.4 ~ 8.3Magento2.4.x (Open Source / Commerce)Installation ------------ [](#installation) ### Via composer (recommended) [](#via-composer-recommended) ``` composer require rollpix/module-disable-sales bin/magento module:enable Rollpix_DisableSales bin/magento setup:upgrade bin/magento cache:flush ``` ### Manual [](#manual) 1. Create the folder `app/code/Rollpix/DisableSales` in your Magento installation. 2. Copy all files from this repository into that folder. 3. Run: ``` bin/magento module:enable Rollpix_DisableSales bin/magento setup:upgrade bin/magento cache:flush ``` --- Admin Configuration ------------------- [](#admin-configuration) Go to **Stores > Configuration > Rollpix > Disable Sales**. [![Admin Configuration](docs/admin-config.jpg)](docs/admin-config.jpg) Configuration is divided into three sections: ### General Settings [](#general-settings) FieldTypeDefaultDescription**Enable**Yes/NoNoActivate or deactivate sales blocking**Message**Textarea*(see below)*Message shown to customers. Supports HTML in the banner and modal. Checkout/cart error messages display as plain text**Also Disable Checkout**Yes/NoYesBlock checkout access as an additional safety net**Restrict to Customer Groups**Multiselect*(empty)*Select which customer groups are restricted. If empty, **all groups** are restricted (backward compatible). Includes "NOT LOGGED IN" for guest users**Default message:** > Debido a la alta demanda, las compras estan temporalmente suspendidas. Podes seguir navegando el catalogo. Volve pronto! The message field supports **HTML**. You can use ``, ``, ``, etc. HTML renders in the top banner and modal. Error messages shown in checkout and cart (via Magento message manager) automatically display as plain text. #### Customer Group Filtering [](#customer-group-filtering) When one or more customer groups are selected: - **Only those groups** will have sales disabled. Other groups can purchase normally. - The frontend uses JavaScript (via Magento's `customerData`) to determine the customer's group and show/hide add-to-cart buttons and notifications dynamically. This is **fully compatible with Full Page Cache (FPC)**. - If "NOT LOGGED IN" (group 0) is selected, guests will see buttons hidden and the banner/modal (if enabled). - Server-side plugins always enforce the restriction regardless of frontend behavior. When **no groups are selected** (empty), the module works in legacy mode: sales are disabled for everyone using server-side CSS, identical to v1.0.x behavior. ### Top Banner [](#top-banner) FieldTypeDefaultDescription**Show Top Banner**Yes/NoYesDisplay a dismissible banner at the top of the page**Show Only After Login**Yes/NoNoOnly show the banner after the customer logs in. Guests won't see it even if their group is restricted**Background Color**Color`#ff6b35`Banner background color (hex format)**Text Color**Color`#ffffff`Banner text color (hex format)**Banner Message Custom CSS**Textarea`font-size: 14px; line-height: 1.4;`Inline CSS applied to the message text. Pre-loaded with defaults for easy editingThe banner has a close button (X). Once closed, it won't show again in that browser session (uses `localStorage`). The dismissed state resets automatically when the customer logs in or out. ### Modal Popup [](#modal-popup) FieldTypeDefaultDescription**Show Modal**Yes/NoNoDisplay a modal popup once per session**Show Only After Login**Yes/NoNoOnly show the modal after the customer logs in**Background Color**Color`#ffffff`Modal background color**Text Color**Color`#333333`Modal text color**Modal Message Custom CSS**Textarea`font-size: 18px; line-height: 1.6; text-align: center; padding: 10px 20px;`Inline CSS applied to the modal message text. Pre-loaded with defaultsThe modal is displayed centered on screen, with a max-width of 600px. It appears once per browser session (uses `sessionStorage`). Includes an "Entendido" (Got it) button to close. **Banner and Modal can be active at the same time.** They are independent of each other. --- What the module does when active -------------------------------- [](#what-the-module-does-when-active) ### 1. Hides "Add to Cart" buttons [](#1-hides-add-to-cart-buttons) **Without group filter (legacy mode):** Conditional inline CSS hides `.action.tocart` and `#product-addtocart-button` buttons on all pages. **With group filter:** JavaScript dynamically injects/removes a `` tag based on the customer's group (determined via `customerData`). This approach is FPC-compatible. Affected pages: - Category listing pages - Product pages - Search results - Product widgets ### 2. Blocks add-to-cart (backend) [](#2-blocks-add-to-cart-backend) **First layer:** `around` plugin on `Magento\Checkout\Controller\Cart\Add::execute` - Checks the customer's group against the restricted list - AJAX requests: responds with HTTP 400 JSON containing the configured message - Standard requests: redirects to referer with error message in message manager **Second layer:** `before` plugin on `Magento\Quote\Model\Quote::addProduct` - Checks the quote's customer group against the restricted list - Throws `LocalizedException` with the message (plain text) - Covers any entry point using the Quote model directly ### 3. Blocks checkout (optional) [](#3-blocks-checkout-optional) If "Also Disable Checkout" is set to Yes: - `around` plugin on `Magento\Checkout\Controller\Index\Index::execute` - `around` plugin on `Magento\Checkout\Controller\Onepage\Index::execute` - Checks the customer's group before blocking - Redirects to cart with error message ### 4. Blocks REST API / GraphQL [](#4-blocks-rest-api--graphql) `before` plugin on `Magento\Quote\Api\CartItemRepositoryInterface::save` - Loads the quote to determine customer group - Throws `LocalizedException` blocking item creation via API for restricted groups ### 5. Visual notification [](#5-visual-notification) Displays the configured message to users via: - **Top banner**: fixed at the top, dismissible, customizable colors and CSS - **Modal popup**: centered on screen, appears once per session, with "Got it" button Both support the "Show Only After Login" option and customer group filtering. --- Behavior when disabled ---------------------- [](#behavior-when-disabled) When **Enable = No**: - No plugin logic is executed (immediate early return) - No CSS or JS is injected - Banner and modal templates are not rendered - **Performance impact: zero** The module is **100% reversible**: simply set Enable = No and flush cache, everything returns to normal. No database tables are modified, no crons or observers are created. --- Technical architecture ---------------------- [](#technical-architecture) ### File structure [](#file-structure) ``` rollpix/module-disable-sales/ (repo root) ├── registration.php ├── composer.json ├── etc/ │ ├── module.xml │ ├── di.xml # Global plugins (API, Quote) │ ├── config.xml # Default values │ ├── acl.xml # ACL resource │ ├── frontend/ │ │ └── di.xml # Frontend plugins (Cart, Checkout, CustomerData) │ └── adminhtml/ │ └── system.xml # Admin configuration ├── i18n/ │ └── es_AR.csv # Spanish (Argentina) translation ├── Model/ │ ├── Config.php # Config reading via ScopeConfig │ └── Config/ │ └── Source/ │ └── CustomerGroup.php # Source model for customer group multiselect ├── Plugin/ │ ├── Cart/ │ │ └── AddPlugin.php # Blocks Cart\Add::execute │ ├── Quote/ │ │ └── AddProductPlugin.php # Blocks Quote::addProduct │ ├── Checkout/ │ │ └── DisableCheckoutPlugin.php # Blocks checkout access │ ├── Api/ │ │ └── CartItemRepositoryPlugin.php # Blocks REST API/GraphQL │ └── CustomerData/ │ └── CustomerPlugin.php # Adds group_id to customer section data ├── ViewModel/ │ └── SalesStatus.php # Exposes config to frontend ├── view/ │ └── frontend/ │ ├── layout/ │ │ └── default.xml # Injects blocks on all pages │ ├── templates/ │ │ ├── banner.phtml # Top banner template (two-mode rendering) │ │ └── modal.phtml # Modal popup template (two-mode rendering) │ └── web/ │ └── js/ │ ├── disable-sales-modal.js # Modal JS (RequireJS) │ └── disable-sales-group-filter.js # Group-based restriction JS └── README.md ``` ### Plugins [](#plugins) PluginTypeScopeIntercepted classAddPluginaroundfrontend`Magento\Checkout\Controller\Cart\Add`AddProductPluginbeforeglobal`Magento\Quote\Model\Quote`DisableCheckoutPluginaroundfrontend`Magento\Checkout\Controller\Index\Index` / `Onepage\Index`CartItemRepositoryPluginbeforeglobal`Magento\Quote\Api\CartItemRepositoryInterface`CustomerPluginafterfrontend`Magento\Customer\CustomerData\Customer`### ViewModel [](#viewmodel) `Rollpix\DisableSales\ViewModel\SalesStatus` exposes to frontend: - `isDisabled()`: bool - `getMessage()`: string - `isBannerEnabled()` / `isModalEnabled()`: bool - `getBannerBgColor()` / `getBannerTextColor()` / `getBannerCustomCss()`: string - `getModalBgColor()` / `getModalTextColor()` / `getModalCustomCss()`: string - `hasCustomerGroupFilter()`: bool - `getRestrictedCustomerGroupsJson()`: string (JSON array of group IDs) - `isBannerShowOnLogin()` / `isModalShowOnLogin()`: bool ### ACL [](#acl) Resource: `Rollpix_DisableSales::config` under `Magento_Config::config` --- Manual testing guide -------------------- [](#manual-testing-guide) ### Basic functionality [](#basic-functionality) 1. **Enable the module** in admin (Enable = Yes) → Save configuration → Flush cache - Verify "Add to Cart" buttons disappear on category, product, and search pages - Verify the top banner appears (if enabled) - Verify the modal appears (if enabled) 2. **Try adding to cart via direct URL** (`/checkout/cart/add/product/ID/`) - Verify it is blocked and shows the error message 3. **Try accessing checkout** with products in cart - Verify it redirects to cart with error message 4. **Disable the module** (Enable = No) → Flush cache - Verify everything returns to normal ### Customer group filtering [](#customer-group-filtering-1) 5. **Select specific groups** (e.g., "General" and "NOT LOGGED IN") → Save → Flush cache - As a guest: verify buttons are hidden and banner/modal appear - Log in as a user in the "General" group: verify buttons are hidden - Log in as a user in a non-restricted group (e.g., "Wholesale"): verify buttons are visible and no banner/modal 6. **Test login/logout transitions** - Start as guest (restricted) → log in as non-restricted → verify buttons become visible without page refresh - Start as guest (not restricted) → log in as restricted → verify buttons become hidden 7. **Test "Show Only After Login"** for banner and/or modal - Enable the option → as guest, verify banner/modal don't appear - Log in as a restricted user → verify banner/modal appear ### Visual customization [](#visual-customization) 8. **Change message, colors and CSS** → Flush cache - Verify changes are reflected on the frontend 9. **Test banner close button** (X) - Verify it doesn't show again when navigating (localStorage) 10. **Test modal in incognito mode** - Verify it appears once and doesn't reappear in the session (sessionStorage) 11. **Test banner + modal together** - Enable both and verify they coexist correctly --- Uninstall --------- [](#uninstall) ``` bin/magento module:disable Rollpix_DisableSales bin/magento setup:upgrade bin/magento cache:flush ``` If installed via composer, run `composer remove rollpix/module-disable-sales`. If installed manually, remove the `app/code/Rollpix/DisableSales` folder. No database tables are created or modified. No residue left behind. --- License ------- [](#license) MIT ### Health Score 37 — LowBetter than 83% of packages Maintenance86 Actively maintained with recent releases Popularity8 Limited adoption so far Community6 Small or concentrated contributor base Maturity40 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~1 days Total 9 Last Release 68d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/2244b007d24a136b3d70c0daae65409d493f9ac5e3b6bd868858a907c924a4ed?d=identicon)[nmarquev](/maintainers/nmarquev) --- Top Contributors [![nmarquev](https://avatars.githubusercontent.com/u/20818155?v=4)](https://github.com/nmarquev "nmarquev (11 commits)") ### Embed Badge ![Health badge](/badges/rollpix-module-disable-sales/health.svg) ``` [![Health](https://phpackages.com/badges/rollpix-module-disable-sales/health.svg)](https://phpackages.com/packages/rollpix-module-disable-sales) ``` ### Alternatives [mollie/magento2 Mollie Payment Module for Magento 2 1121.6M10](/packages/mollie-magento2)[dotdigital/dotdigital-magento2-extension Dotdigital for Magento 2 50374.2k18](/packages/dotdigital-dotdigital-magento2-extension)[swissup/module-search-mysql-legacy Legacy mysql search for magento 2.4 10483.0k](/packages/swissup-module-search-mysql-legacy)[lizardmedia/module-varnish-warmer Varnish Cache Warmer Magento2 module by Lizard Media 6276.8k](/packages/lizardmedia-module-varnish-warmer)[mage-os/module-inventory-reservations-grid Add a grid with the list of inventory reservations. 126.8k](/packages/mage-os-module-inventory-reservations-grid)[pagbank/payment-magento PagBank - Payment for Magento and Adobe 2128.3k7](/packages/pagbank-payment-magento) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)