PHPackages                             rapidez/amasty-promo-banners - 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 &amp; Helpers](/categories/utility)
4. /
5. rapidez/amasty-promo-banners

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

rapidez/amasty-promo-banners
============================

Rapidez Amasty Promo Banners

4.0.1(7mo ago)24.2k↓100%4[1 issues](https://github.com/rapidez/amasty-promo-banners/issues)[1 PRs](https://github.com/rapidez/amasty-promo-banners/pulls)PHPPHP ^8.0

Since May 20Pushed 2mo ago2 watchersCompare

[ Source](https://github.com/rapidez/amasty-promo-banners)[ Packagist](https://packagist.org/packages/rapidez/amasty-promo-banners)[ RSS](/packages/rapidez-amasty-promo-banners/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (1)Versions (22)Used By (0)

Rapidez Amasty Promo Banners
============================

[](#rapidez-amasty-promo-banners)

Requirements
------------

[](#requirements)

You need to have the [Amasty Promo Banners](https://amasty.com/promo-banners-for-magento-2.html) module installed and configured within your Magento 2 installation.

Installation
------------

[](#installation)

```
composer require rapidez/amasty-promo-banners

```

If you haven't published the Rapidez views yet, you can publish them with:

```
php artisan vendor:publish --provider="Rapidez\Core\RapidezServiceProvider" --tag=views

```

Usage
-----

[](#usage)

### Categories

[](#categories)

Add `@banners('category_page', $category->entity_id)` where you'd like to display your banners, add the specified location to make sure the banner shows up on the location you've specified in magento backend. The possible locations are listed at [locations](#Locations). For categories, you can just pass the category id in the blade directive to make sure it only displays for the selected categories in the Magento backend.

### Products

[](#products)

#### With product rules

[](#with-product-rules)

If you want the banners to be rendered conditional (based on magento rules), you can pass the product as object to the banners directive: `@banners('prod_page', $product)`. This will display the banners for all products that passes the conditions.

#### Without product rules

[](#without-product-rules)

If you just want to show the banner on some product pages, you can pass the SKU in the banners directive: `@banners('prod_page', $product->sku)`This will only display the banner for the specified SKUs in the Magento backend.

### Among category products

[](#among-category-products)

Note

To make these work properly you will currently need to modify your listing component and possibly your toolbar accordingly. Make sure to read on.

Just add the view at the bottom of `listing/partials/item.blade.php`:

```
@includeWhen(config('frontend.category'), 'AmastyPromoBanners::promobanners.amongproducts')

```

Note that, to currently make this work, you will need to modify the hitsPerPage in your listing. If you haven't already, extend the `Listing.vue` component with the following:

```
computed: {
    hitsPerPage() {
        return [{
            label: '',
            value: this.$root.getListingSize(12),
            default: true,
        }]
    },
}
```

You can replace the `12` with how many items you actually want to show per page, and you can add multiple items if you want more options shown in the hits-per-page. If you only want just the one like above, you will also probably want to overwrite the `vendor/rapidez/listing/partials/toolbar/pages.blade.php` view to remove the selection box:

```

```

Views
-----

[](#views)

If you need to change the views you can publish them with:

```
php artisan vendor:publish --provider="Rapidez\AmastyPromoBanners\AmastyPromoBannersServiceProvider" --tag=views

```

Locations
---------

[](#locations)

These are the locations that are configurable in the magento backend for each banner.

Backend labelcode keyAbove Cart`above_cart`Cart Page (Below Total)`checkout_below_total`Sidebar Additional`sidebar_right`Sidebar Main`sidebar_left`Product Page (Top)`prod_page`Product Page (Bottom)`prod_page_bottom`Product Page (Below Cart Button)`prod_page_below_cart`Category Page (Top)`category_page`Category Page (Bottom)`category_page_bottom`Category Page (Below Add to Cart Button)`category_page_below_add_to_cart`Catelog Search (Top)`catalog_search_top`On Top of Page`top_page`Home Page under Menu`top_index`Among Category Products`among_products`Note
----

[](#note)

Not all features are implemented yet! For example: cart rules, show on search, etc.

###  Health Score

47

—

FairBetter than 94% of packages

Maintenance66

Regular maintenance activity

Popularity27

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 57.5% 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 ~87 days

Recently: every ~115 days

Total

19

Last Release

238d ago

Major Versions

0.5.0 → 2.0.02024-05-28

2.2.1 → 4.0.02025-09-02

PHP version history (4 changes)0.1.0PHP ^7.4

0.2.0PHP ^8.0|^8.1

0.5.0PHP ^8.0|^8.1|^8.2

2.2.1PHP ^8.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/72222911?v=4)[Rapidez](/maintainers/rapidez)[@rapidez](https://github.com/rapidez)

---

Top Contributors

[![royduin](https://avatars.githubusercontent.com/u/1703233?v=4)](https://github.com/royduin "royduin (23 commits)")[![indykoning](https://avatars.githubusercontent.com/u/15870933?v=4)](https://github.com/indykoning "indykoning (7 commits)")[![BobWez98](https://avatars.githubusercontent.com/u/23509926?v=4)](https://github.com/BobWez98 "BobWez98 (5 commits)")[![Jade-GG](https://avatars.githubusercontent.com/u/32514269?v=4)](https://github.com/Jade-GG "Jade-GG (2 commits)")[![quintenbuis](https://avatars.githubusercontent.com/u/36452184?v=4)](https://github.com/quintenbuis "quintenbuis (1 commits)")[![claudio-ferraro](https://avatars.githubusercontent.com/u/54107647?v=4)](https://github.com/claudio-ferraro "claudio-ferraro (1 commits)")[![VincentBean](https://avatars.githubusercontent.com/u/3906942?v=4)](https://github.com/VincentBean "VincentBean (1 commits)")

---

Tags

hacktoberfest

### Embed Badge

![Health badge](/badges/rapidez-amasty-promo-banners/health.svg)

```
[![Health](https://phpackages.com/badges/rapidez-amasty-promo-banners/health.svg)](https://phpackages.com/packages/rapidez-amasty-promo-banners)
```

###  Alternatives

[abhi1693/yii2-sms

Send Free Sms for Yii2

171.9k](/packages/abhi1693-yii2-sms)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
