包简介

A lightweight and configurable Scroll to Top button for Adobe Commerce and Magento 2 storefronts.

README 文档

README

A lightweight and configurable module that adds a "Scroll to Top" button to your storefront.

Features

Enable/disable via admin configuration
Configurable position: Left or Right
Configurable style: Round or Square
Smooth scroll animation
Accessible (ARIA labels)
Scope-aware configuration (Default / Website / Store View)

Requirements

PHP 8.1+
Magento 2.4.x / Adobe Commerce 2.4.x
Hyvä Theme (optional) — automatically detected, no extra configuration needed

Hyvä Theme Compatibility

When the Hyvä Theme is active, the module automatically serves an Alpine.js + Tailwind CSS template instead of the default jQuery/Less one.

No additional compatibility module is required. After installing, run:

bin/magento setup:upgrade
bin/magento hyva:config:generate
# inside your Hyvä theme directory (e.g. app/design/frontend/Hyva/default):
npm run build-prod

The hyva:config:generate command triggers the observer that registers this module in app/etc/hyva-themes.json. The subsequent npm run build-prod is when Tailwind actually scans the module templates and compiles the utility classes into the theme CSS. Without this step, the button will have no styles.

Installation

composer require backentec/m2-scroll-to-top
bin/magento module:enable Backentec_ScrollToTop
bin/magento setup:upgrade
bin/magento cache:flush

Configuration

Admin panel: Stores > Configuration > Backentec > Scroll To Top

Option	Description	Default
Enabled	Show or hide the button	Yes
Position	Horizontal position (Left / Right)	Right
Style	Button shape (Round / Square)	Round

License

MIT

backendorf/m2-scroll-to-top 适用场景与选型建议

backendorf/m2-scroll-to-top 是一款基于 HTML 开发的 Composer 扩展包，目前已累计 1 次下载、GitHub Stars 达 0，最近一次更新时间为 2025 年 10 月 11 日，在 PHP 生态内属于活跃度较高的组件。

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

围绕 backendorf/m2-scroll-to-top 我们能提供哪些服务？

定制开发 / 二次开发

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

BUG 修复 & 性能优化

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

项目外包 & 长期维护

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

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

backendorf/m2-scroll-to-top

包简介