包简介

Banner Slider core module - business logic and data layer

README 文档

README

Core business logic and data persistence layer for the Banner Slider system.

Part of hryvinskyi/magento2-banner-slider-pack - Complete Banner Slider solution for Magento 2

Description

This module implements all API contracts from BannerSliderApi and provides the database schema, data models, image processing capabilities, and video handling functionality.

Features

Complete implementation of all API interfaces
Database schema with 5 optimized tables
Image processing with WebP and AVIF conversion
Video provider support (YouTube, Vimeo, Local MP4/WebM)
Responsive image generation with breakpoint-based cropping
Automatic default breakpoint creation for new sliders

Database Schema

Tables

Table	Description
`hryvinskyi_banner_slider`	Main slider storage with carousel configuration
`hryvinskyi_banner_slider_banner`	Banner content including images, videos, and custom HTML
`hryvinskyi_banner_slider_image`	Responsive image variants per banner
`hryvinskyi_banner_slider_breakpoint`	Viewport breakpoints per slider
`hryvinskyi_banner_slider_responsive_crop`	Image crops per banner/breakpoint combination

Slider Configuration

The slider table supports extensive configuration:

Animation: Effect type, auto width/height, loop, lazy loading
Autoplay: Enable autoplay, timeout duration
Navigation: Arrow navigation, dot pagination
Responsive: Responsive mode, items per breakpoint, preload count
Visibility: Date range (from/to), store IDs, customer group IDs

Banner Types

Type	Value	Features
Image	0	Desktop image, responsive variants, alt text, link URL
Video	1	YouTube/Vimeo URL or local file, aspect ratio, background mode
Custom HTML	2	Full HTML content support

Image Processing

WebP Conversion

Uses cwebp binary for optimal compression
Configurable quality settings (1-100)
Automatic fallback if binary unavailable

AVIF Conversion

Modern next-gen image format support
Configurable quality settings (1-100)
Smaller file sizes than WebP

Responsive Crops

Per-breakpoint cropping with precise coordinates
Source image preservation
Automatic generation of WebP and AVIF variants

Video Support

Supported Providers

Provider	Detection	Features
YouTube	youtube.com, youtu.be URLs	Iframe embed, background mode
Vimeo	vimeo.com URLs	Iframe embed, background mode
Local MP4	.mp4 file extension	Native video element
Local WebM	.webm file extension	Native video element

Video Options

Custom aspect ratio
Background mode (no controls, autoplay, loop)
Responsive sizing

Observers

CreateDefaultBreakpointsOnSliderSave

Automatically creates default responsive breakpoints when a new slider is saved:

Desktop (1200px+)
Tablet (768px - 1199px)
Mobile (up to 767px)

Dependencies

PHP 8.1+
magento/framework
magento/module-store
magento/module-customer
hryvinskyi/magento2-banner-slider-api
hryvinskyi/image-binaries
symfony/process ^5.4 || ^6.0 || ^7.0

Installation

This module is typically installed as part of the hryvinskyi/magento2-banner-slider-pack metapackage:

composer require hryvinskyi/magento2-banner-slider-pack
php bin/magento module:enable Hryvinskyi_BannerSlider
php bin/magento setup:upgrade
php bin/magento cache:flush

Author

Volodymyr Hryvinskyi

Email: volodymyr@hryvinskyi.com

License

MIT

hryvinskyi/magento2-banner-slider 适用场景与选型建议

hryvinskyi/magento2-banner-slider 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 158 次下载、GitHub Stars 达 0，最近一次更新时间为 2026 年 01 月 31 日，在 PHP 生态内属于活跃度较高的组件。

我们在过去多个企业项目中使用过 hryvinskyi/magento2-banner-slider 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 hryvinskyi/magento2-banner-slider 我们能提供哪些服务？

定制开发 / 二次开发

基于 hryvinskyi/magento2-banner-slider 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

hryvinskyi/magento2-banner-slider

包简介