====== Magento 2 Banner Slider Extension ======

===== Extension context =====

This is a Toweringmedia Magento 2 extension guide in the **Catalog/Admin** category. Use this page for slider/banner merchandising setup.

  * **Module name**: `Toweringmedia_BannerSlider`
  * **Composer package**: `toweringmedia/module-banner-slider`

===== Quick links =====

  * [[magento2:start|Magento 2 docs home]]
  * [[magento2:extensions:start|Magento 2 extension index]]

===== Overview =====

Banner Slider provides admin-managed sliders and banners for promotional content, with scheduling, device targeting, and theme-compatible frontend rendering.

===== Installation =====

<code bash>
cd /path/to/magento
composer require toweringmedia/module-banner-slider:<VERSION>
php -d memory_limit=-1 bin/magento setup:upgrade
php -d memory_limit=-1 bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f
php bin/magento cache:flush
</code>

===== Versioning notes =====

  * Pick the version you are licensed for.
  * To see available versions for your credentials:
    * `composer show -a toweringmedia/module-banner-slider`

===== Configuration =====

Recommended setup flow:
  - Create slider container and set global behavior (autoplay, nav, transition).
  - Create banners with image/content/link and assign to slider.
  - Configure schedule windows and device visibility.
  - Place slider in target CMS/page block locations.

===== Validation checklist =====

  * Slider renders on intended pages.
  * Banners rotate/order correctly.
  * Mobile/desktop visibility rules work as expected.
  * Scheduled banners appear/disappear on time.

===== Troubleshooting =====

  * **Slider not visible**: verify block placement and slider enabled state.
  * **Images missing**: verify media paths and cache/static content state.
  * **Transition issues**: test configured effect and theme-specific JS compatibility.

===== Related Magento 2 docs =====

  * [[magento2:extensions:start|Magento 2 extension index]]
  * [[magento2:start|Magento 2 docs home]]