PHPackages chrismallory/module-promobanner - 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. [Utility & Helpers](/categories/utility) 4. / 5. chrismallory/module-promobanner ActiveMagento2-module[Utility & Helpers](/categories/utility) chrismallory/module-promobanner =============================== Display a global promotional message throughout your website 1.0.1(5y ago)8133OSL-3.0JavaScript Since Dec 30Pushed 5y ago1 watchersCompare [ Source](https://github.com/christophermallory/ChrisMallory_PromoBanner)[ Packagist](https://packagist.org/packages/chrismallory/module-promobanner)[ RSS](/packages/chrismallory-module-promobanner/feed)WikiDiscussions master Synced today READMEChangelog (2)DependenciesVersions (3)Used By (0) ChrisMallory\_PromoBanner ========================= [](#chrismallory_promobanner) `chrismallory/module-promobanner` Description ----------- [](#description) This Magento 2 module adds the ability to display a simple promotional banner throughout your website. It also includes the ability to customize the styles of the promotional banner. ### Screenshots [](#screenshots) #### Mobile [](#mobile) [![Mobile Screenshot](https://camo.githubusercontent.com/14c9a79952d87a3f5d21b5496b2f6e0dcad7e67276189bcdbc40d195baaae95c/68747470733a2f2f692e706f7374696d672e63632f525a594b687062582f6d6f62696c652e706e67)](https://camo.githubusercontent.com/14c9a79952d87a3f5d21b5496b2f6e0dcad7e67276189bcdbc40d195baaae95c/68747470733a2f2f692e706f7374696d672e63632f525a594b687062582f6d6f62696c652e706e67) #### Desktop [](#desktop) [![Desktop Screenshot](https://camo.githubusercontent.com/20297b91cef9a55cb6d06ccd80b87d55c04a75089e4c952399efa8278f20ee9a/68747470733a2f2f692e706f7374696d672e63632f566b76585950344a2f6465736b746f702e706e67)](https://camo.githubusercontent.com/20297b91cef9a55cb6d06ccd80b87d55c04a75089e4c952399efa8278f20ee9a/68747470733a2f2f692e706f7374696d672e63632f566b76585950344a2f6465736b746f702e706e67) Installation ------------ [](#installation) ### Using Composer (Recommended) [](#using-composer-recommended) - Install the module composer by running `composer require chrismallory/module-promobanner` - Enable the module by running `php bin/magento module:enable ChrisMallory_PromoBanner` - apply database updates by running `php bin/magento setup:upgrade` - Flush the cache by running `php bin/magento cache:flush` ### Manual File Transfer [](#manual-file-transfer) - Clone or unzip this repository to `app/code/ChrisMallory` - Enable the module by running `php bin/magento module:enable ChrisMallory_PromoBanner` - Apply database updates by running `php bin/magento setup:upgrade` - Flush the cache by running `php bin/magento cache:flush` Configuration ------------- [](#configuration) This module adds a new section in the general tab of your store's configuration. ### How to Configure [](#how-to-configure) To access this module's configuration, navigate to `Stores > Settings > Configuration` In the configuration menu click on Header under the General tab. [![General Tab Header Section](https://camo.githubusercontent.com/7298703da51312ad88d60f1c43a737a9ed524dd6bd91b209a92249e526a645e1/68747470733a2f2f692e706f7374696d672e63632f31587866314c584e2f53637265656e2d53686f742d323032302d31322d33302d61742d31302d30382d30392d414d2e706e67)](https://camo.githubusercontent.com/7298703da51312ad88d60f1c43a737a9ed524dd6bd91b209a92249e526a645e1/68747470733a2f2f692e706f7374696d672e63632f31587866314c584e2f53637265656e2d53686f742d323032302d31322d33302d61742d31302d30382d30392d414d2e706e67) The Promotional Banner settings will now be displayed. Make your desired changes then click save. [![Promotional Banner Settings](https://camo.githubusercontent.com/58f9fdd34c3230d761a4e9a11841b172c3b0610eb813251188b473da10a36aba/68747470733a2f2f692e706f7374696d672e63632f36337038686453792f53637265656e2d53686f742d323032302d31322d33302d61742d31302d30302d32382d414d2e706e67)](https://camo.githubusercontent.com/58f9fdd34c3230d761a4e9a11841b172c3b0610eb813251188b473da10a36aba/68747470733a2f2f692e706f7374696d672e63632f36337038686453792f53637265656e2d53686f742d323032302d31322d33302d61742d31302d30302d32382d414d2e706e67) ### Settings Explanation [](#settings-explanation) #### Enable [](#enable) This setting will enable or disable the display of the banner. By default, the banner is disabled. #### Banner Message [](#banner-message) Here you will enter the text shown on the banner. This field is required to be filled out when the banner is enabled. Otherwise, the banner will just display a bar along the bottom of the site header. There is no default for this setting. *This message will wrap on the frontend when the view is smaller so be careful to not make the message too long so that it doesn't take up too much real estate on mobile.* #### Banner Link [](#banner-link) When filled out, the link entered here will be used when a user clicks on the banner. If no link is provided, the banner will not be clickable. There is no default for this setting. #### Use Custom Styles [](#use-custom-styles) When set to "Yes" you will be able to change the styles used in the banner to better fit your store or promotion. When this is set to "No" the default styles will be used. By default, this is set to no. #### Background [](#background) Here you can enter your preferred banner background color by either using the dropdown color picker that is activated when this field is active or by entering a valid CSS color value. This field will also accept all valid inputs for the [CSS background property](https://www.w3schools.com/cssref/css3_pr_background.asp) to allow for more advanced backgrounds like gradients, opacity, or even images. This setting defaults to #e22626 if not entered and is only shown when the use custom styles setting is set to "Yes". *Color Picker* [![Background & Font Color Picker](https://camo.githubusercontent.com/d31cd6cca51dcbb82cd18b8cbd11ecccbbebee74f1c99aa0807650d662612106/68747470733a2f2f692e706f7374696d672e63632f6d6b6368765454342f53637265656e2d53686f742d323032302d31322d33302d61742d31302d30322d33382d414d2e706e67)](https://camo.githubusercontent.com/d31cd6cca51dcbb82cd18b8cbd11ecccbbebee74f1c99aa0807650d662612106/68747470733a2f2f692e706f7374696d672e63632f6d6b6368765454342f53637265656e2d53686f742d323032302d31322d33302d61742d31302d30322d33382d414d2e706e67) #### Font Size [](#font-size) Enter the font size you'd like your banners message to be. This field will also accept all valid inputs for the [CSS font-size property](https://www.w3schools.com/cssref/css3_pr_font_font-size.asp). This setting defaults to 16px if not entered and is only shown when the use custom styles setting is set to "Yes". #### Font Color [](#font-color) Here you can enter your preferred banner message font color by either using the dropdown color picker that is activated when this field is active or by entering a valid CSS color value. This field will also accept all valid inputs for the [CSS color property](https://www.w3schools.com/cssref/css3_pr_text_color.asp) to allow for more advanced colors such as gradients and opacity. This setting defaults to #ffffff if not entered and is only shown when the use custom styles setting is set to "Yes". *Color Picker* [![Background & Font Color Picker](https://camo.githubusercontent.com/d31cd6cca51dcbb82cd18b8cbd11ecccbbebee74f1c99aa0807650d662612106/68747470733a2f2f692e706f7374696d672e63632f6d6b6368765454342f53637265656e2d53686f742d323032302d31322d33302d61742d31302d30322d33382d414d2e706e67)](https://camo.githubusercontent.com/d31cd6cca51dcbb82cd18b8cbd11ecccbbebee74f1c99aa0807650d662612106/68747470733a2f2f692e706f7374696d672e63632f6d6b6368765454342f53637265656e2d53686f742d323032302d31322d33302d61742d31302d30322d33382d414d2e706e67) #### Font Weight [](#font-weight) The font weight sets how thick or thin characters in text should be displayed. This can be set between 100 and 900 by the hundreds (100, 200, 300, 400, etc). This field will also accept all valid inputs for the [CSS font-weight property](https://www.w3schools.com/cssref/css3_pr_font_weight.asp). This setting defaults to 600 if not entered and is only shown when the use custom styles setting is set to "Yes". *Not all font weights are supported by all fonts* Compatibility ------------- [](#compatibility) This module has been tested and validated to work on Magento versions 2.3 and higher. This module uses a ViewModel and should be compatible with versions 2.2 and higher but has not been tested on versions lower than 2.3. Bugs & Issues ----------------- [](#bugs--issues) If you find a bug or issue please create a new issue [here](https://github.com/christophermallory/ChrisMallory_PromoBanner/issues) and include as much detail and context as possible including screenshots. License ------- [](#license) This module is licensed under the Open Software License V3.0 which you can refer to [here](LICENSE.txt). ### Health Score 26 — LowBetter than 43% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity13 Limited adoption so far Community6 Small or concentrated contributor base Maturity54 Maturing project, gaining track record 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 ~3 days Total 2 Last Release 1953d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/6373ffc6af4bf4f878e75009ae39a4aea2cad0c90f81a0632ea5c0af7088942b?d=identicon)[chris.mallory](/maintainers/chris.mallory) --- Tags magento2magento2-extensionmagento2-module ### Embed Badge ![Health badge](/badges/chrismallory-module-promobanner/health.svg) ``` [![Health](https://phpackages.com/badges/chrismallory-module-promobanner/health.svg)](https://phpackages.com/packages/chrismallory-module-promobanner) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)