rapidez/amasty-promo-banners

Rapidez Amasty Promo Banners

Requirements

You need to have the Amasty Promo Banners module installed and configured within your Magento 2 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

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. 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

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

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

Just add the view within the renderItem slot in listing/partials/item.blade.php

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

You should also use getListingSize(...) as the page size in your products.blade.php, for example like so:

<reactive-list
    [...]
    :size="getListingSize(parseInt(listingSlotProps.pageSize))"
    [...]
>

Views

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

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

Locations

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

Backend label	code key
Above 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

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

amasty-promo-banners's Issues

Custom template per location

At this moment there's only a different template for banner types. We'd like to see different templates per location too.

@banners('among_products')

Should be able to load `banners/among_products/.blade.php