# mageplaza/module-banner-slider

> Magento 2 Banner Slider extension

`composer require mageplaza/module-banner-slider`

Canonical URL: https://packagento.com/mageplaza/module-banner-slider

## At a glance

- **Vendor**: mageplaza (https://packagento.com/mageplaza.md)
- **Latest version**: 4.1.1 — released 2025-05-21
- **Pricing**: Free
- **Package type**: Magento 2 module
- **Status**: active, accepting new buyers

## Installation

Packagento is licence-gated, so even free packages need a licence on a project before Composer can resolve them.

1. **Sign in or create an account** at https://packagento.com/customer/account/.

2. **Add the package to your account.** Open https://packagento.com/mageplaza/module-banner-slider and complete the free checkout. A licence is minted automatically.

3. **Create or pick a project, then activate the licence on it.**
   - Projects represent the Magento installs you deploy to. Manage them at https://packagento.com/projects/.
   - Activate the new licence on the project you'll deploy this package to. Activation is what generates the Composer credentials scoped to that project.

4. **Add the project credentials to your Magento codebase.**

   Grab the project's public + private key from https://packagento.com/projects/ (open the project, then its Credentials tab), and add them to `auth.json`:

   ```json
   {
     "http-basic": {
       "packagento.com": {
         "username": "ppk_live_...",
         "password": "psk_live_..."
       }
     }
   }
   ```

   Add the Packagento Composer repository to `composer.json`:

   ```json
   {
     "repositories": [
       { "type": "composer", "url": "https://packagento.com" }
     ]
   }
   ```

5. **Install and apply.**

   ```bash
   composer require mageplaza/module-banner-slider:*
   bin/magento setup:upgrade
   bin/magento setup:di:compile
   bin/magento cache:flush
   ```

## What it does

Magento 2 Banner Slider extension

## README


**[Banner slider for Magento 2](https://www.mageplaza.com/magento-2-banner-slider-extension/)** is a supportive marketing tool which allows store owners to display unlimited eye-catching banner sliders on their Ecommerce website. By this way, the extension helps draw customers' attention as well as optimize their experience, with a user-friendly interface. 

Magento 2 Banner Slider Module accordingly will help improve customer retention and prevent the site from being abandoned by customers. This actually will increase the rate of subscribers of the website. 

[![Latest Stable Version](https://poser.pugx.org/mageplaza/module-banner-slider/v/stable)](https://packagist.org/packages/mageplaza/module-banner-slider)
[![Total Downloads](https://poser.pugx.org/mageplaza/module-banner-slider/downloads)](https://packagist.org/packages/mageplaza/module-banner-slider)

**IMPORTANT NOTE:** This version of Mageplaza Banner Slider extension on Github is free as a contribution to the Magento community from Mageplaza. This package does not include the technical support. Should you need technical support for this extension, you will have to buy a license from Mageplaza. [Click here to buy](https://www.mageplaza.com/magento-2-banner-slider-extension/).

### 1. Documentation

- [Installation guide](https://www.mageplaza.com/install-magento-2-extension/)
- [User Guide](https://docs.mageplaza.com/banner-slider-m2/)
- [Get Support](https://github.com/mageplaza/magento-2-banner-slider/issues)
- [Download from our Live site](https://www.mageplaza.com/magento-2-banner-slider-extension/)
- [Contribute on Github](https://github.com/mageplaza/magento-2-banner-slider)



### 2. How to install Banner Slider in Magento 2

#### ✓ Install via composer (recommend)

Run the following command in Magento 2 root folder:

With Social Proof (recommend):
```
composer require mageplaza/module-banner-slider avada/module-proofo
php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy
```

Without Social Proof:
```
composer require mageplaza/module-banner-slider 
php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy
```


#### ✓ Install Package from Mageplaza


- Download the latest version at [Mageplaza Banner Slider for Magento 2](https://www.mageplaza.com/magento-2-banner-slider-extension/)
-  [Installation guide](https://www.mageplaza.com/install-magento-2-extension/)


### 3. FAQs

**Q: I got error: `Mageplaza_Core has been already defined`**

A: Read solution [Here](https://github.com/mageplaza/module-core/issues/3).

**Q: Can I set the Banner to any places on the store site?**

A: Absolutely yes, you can configure it easily by adding Banner Slider widget to any CMS Page of CMS Static Block.

**Q: Is there any animation effects for Banners movement?**

A: Yes, there are 9 optional animation effects for Banner Sliders displaying. You can select and flexible change it in the backend.

**Q: Does this extension support any available templates for banners?**

A: Yes. We support 4 available templates that you can use for customization. Please set Advanced Type and select the demo template. See more information [Here](https://docs.mageplaza.com/banner-slider-m2/index.html).

**Q: Can I create a Banner Slider Widget?**

A: Yes, you can create the widget by navigating to `Content > Elements > Widgets`, then set type as Banner Slider Widget and Design Theme. See more information [Here](https://docs.mageplaza.com/banner-slider-m2/index.html).



### 4. Highlight features of Magento 2 Banner Slider

#### Unlimited Banners and Sliders

Banner Slider Extension helps store owners upload unlimited banners with ease. This tool supports multiple image formats as .ipg, .ipeg, .gif, and .png. The flexibility of banners and sliders location even can meet requirements of store owners with special marketing strategies. More amazing, the diversity in design, as well as the appearance of banners and sliders, can contribute to the professional performance of the store. And helps they achieve typical views from expectable customers. 

![Imgur](https://i.imgur.com/wis3Jr4.gif)

#### Optional animation effects to show Slider

Animation effects can considerably better the Sliders' appearance, and make them appealing to customers. Banner Slider module by Mageplaza support 9 available slider effects including:

- Slider 
- Fade-out
- Rotate-out
- Flip-out
- Roll-out
- Zoom-out
- Slide-out-left
- Slide-out-right
- Light-speed-out

![Imgur](https://i.imgur.com/7hqW3oT.png)

#### Easy to custom the Slider's design 

The store owner can swiftly design the banner sliders as their requirement. Besides the presentation effects, the extension also allows customizing various features of the slider such as:

- Width
- Height
- Infinity Loop
- Next/ Prev Buttons
- Dots Navigation 
- Lazy Loading Images
- Autoplay

![Imgur](https://i.imgur.com/FzbY5a8.png)

#### Advanced Template Editor 

For website administrators who have certain knowledge and technical skills about coding, uploading images for Sliders can be quicker and easier than ever. You can input codes into the editor section, as the module supports advanced demo templates that can be edited via the backend editor.

Furthermore, this function allows admins to upload multiple images at the same time, by embedding their links to the editor. 

![Imgur](https://i.imgur.com/prIwSPn.gif)


#### Flexibly located Banner Sliders  

The extension allows the store admin to set position for Sliders easily from the options list with various available positions on the site. The main positions including the product view page, product list page, homepage, header, and footer. Furthermore, another way to locate Banner Sliders is manually creating a widget and add to any CMS Page, or CMS Static Block of the site. The strategic location of Banner Sliders will play an ind

_(README truncated for .md surface. Full README on https://packagento.com/mageplaza/module-banner-slider.)_

## Changelog

CHANGELOG: https://www.mageplaza.com/releases/banner-slider

## Recent Versions

| Version | Released |
|---|---|
| 4.1.1 | 2025-05-21 |
| 4.1.0 | 2025-04-29 |
| 4.0.4 | 2023-05-31 |
| 4.0.3 | 2022-06-14 |
| 2.0.7 | 2021-08-17 |
| 4.0.2 | 2021-08-17 |
| 2.0.6 | 2021-06-01 |
| 4.0.1 | 2021-05-31 |
| 4.0.0 | 2020-11-09 |
| 2.0.5 | 2020-07-14 |

Showing 10 of 17 versions. Full release history on https://packagento.com/mageplaza/module-banner-slider.

## Dependencies

### Require

| Package | Constraint |
|---|---|
| mageplaza/module-core | ^1.5.13 |

## Quality

Latest release (4.1.1) fails the Packagento QA pipeline. Verdicts below are per-cell (Magento line × PHP version) for the matrixed tools, and run-once for the static / security tiers.


### Compatibility

Each Magento line is installed on its supported PHP versions, then the module is built (DI compile + static-content deploy). Cells show passed / failed / untested; staircase gaps render as `–`.

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | Pass | Pass | – | – |
| 2.4.8 | – | Pass | Pass | – |
| 2.4.9 | – | – | Pass | Pass |


### Code Quality

Advisory checks against the module's source. Never affect the Compatibility verdict — a phpcs finding can't make a module incompatible.

#### Static Analysis

Coding standards (phpcs), mess detection (phpmd), copy-pasted code (cpd), PHP cross-version compatibility, composer.json validity. Each runs once for the whole module.

| Tool | Status | Findings | Summary |
|---|---|---|---|
| PHPCS | Warning | 293 | 293 warnings (ruleset: Magento2) — 153 auto-fixable with phpcbf |
| PHPMD | Warning | 15 | 15 rule violations (CyclomaticComplexity:6, ExcessiveMethodLength:4, NPathComplexity:2, UnusedFormalParameter:1, MissingImport:1) |
| Cpd | Warning | 1 | 1 duplicated chunk spanning 54 total lines (min-lines=5, min-tokens=70) |
| Composer validate | Info | 1 | valid; 1 advisory note (composer validate --strict) |

#### PHPStan

Type-checks the module against a real Magento install. Re-runs per Magento + PHP version because resolvable symbols differ between releases.

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | 58 | 58 | – | – |
| 2.4.8 | – | 58 | 58 | – |
| 2.4.9 | – | – | 56 | 56 |


### Tests

Unit and integration suites run per Magento + PHP cell. Test failures speak to the module's behaviour, not its compatibility with a line, so they're reported here separately.

#### Unit Tests

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | N/A | N/A | – | – |
| 2.4.8 | – | N/A | N/A | – |
| 2.4.9 | – | – | N/A | N/A |

#### Integration Tests

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | N/A | N/A | – | – |
| 2.4.8 | – | N/A | N/A | – |
| 2.4.9 | – | – | N/A | N/A |


### Security

Dependency-advisory audit (composer audit) plus a source malware scan. A malware detection fails the version outright.

| Tool | Status | Findings | Summary |
|---|---|---|---|
| Composer audit | Pass | 0 |  |
| Malware scan | Pass | 0 |  |

## Licence and pricing

Free. A licence is still minted on checkout and bound to your project for Composer access — no payment step.

Refundable within 14 days of first purchase via https://packagento.com/account/refunds/.

## Install via Claude Code or any MCP client

The Packagento MCP server can run the licence + project + Composer steps above in one tool call:

```
purchase_and_install_packages(
  composer_names=["mageplaza/module-banner-slider"],
  project_id="proj_xxx"
)
```

This handles cart, checkout, licence minting, project activation, and writes auth.json credentials. Connect a client with `claude mcp add packagento https://mcp.packagento.com`. Full setup at https://packagento.com/docs/mcp-setup.

## Vendor

mageplaza is a Magento 2 vendor on Packagento. See https://packagento.com/mageplaza.md for their full catalogue.