Magento 2 强制客户登录插件安装与配置指南
本指南将引导您了解并设置 bitExpert/magento2-force-login
开源项目,这是一个专为Magento 2电子商务平台设计的插件,用于强制访客登录才能访问指定页面。
1. 项目目录结构及介绍
该插件遵循Magento 2的标准目录结构,主要组件分布如下:
-
app/code/BitExpert/ForceCustomerLogin: 主要代码存放区。
- Block: 包含MVC模式中的块类,用于渲染前端视图。
- Controller: 控制器,处理用户请求。
- Model: 模型,处理业务逻辑。
- Setup: 安装和升级脚本。
- View: 前端资源,包括布局文件、模板和静态资源等。
- etc: 配置文件所在,包括模块的XML配置。
- registration.php: 注册模块到Magento中。
- composer.json: 描述模块依赖和其他元数据。
-
dev: 开发者工具和配置,如PHPStan和PHPUnit配置。
-
docker-compose: 环境配置文件,用于容器化部署。
-
readme.md: 项目的主要说明文档,包括安装步骤和其他重要信息。
2. 项目的启动文件介绍
在Magento 2框架下,并没有一个单独的“启动文件”来直接运行该项目。但是,核心操作是从命令行通过Magento的CLI(命令行界面)执行的。关键的“启动”流程涉及两个主要方面:
- 安装插件:通过Composer在您的项目中添加此插件。
- 启用与配置:安装之后,使用Magento CLI命令来启用模块,并且通过后台配置进行设置。
启用模块的命令如下:
bin/magento module:enable BitExpert_ForceCustomerLogin
以及系统升级命令(依据环境模式可能还需要执行编译命令):
bin/magento setup:upgrade
bin/magento setup:di:compile (在生产模式下)
3. 项目的配置文件介绍
主要配置文件
- app/code/BitExpert/ForceCustomerLogin/etc/module.xml: 模块的基本配置,包括模块名称、版本等信息。
- app/code/BitExpert/ForceCustomerLogin/etc/config.xml 或 etc/adminhtml/system.xml: 这些文件定义了在Magento后台的配置选项,允许您设定哪些页面不需要强制登录即可访问,以及默认的重定向行为。
- app/code/BitExpert/ForceCustomerLogin/view/adminhtml/ui_component/forced_login_whitelist_form.xml: 若存在,这将是管理界面表单配置,用于设置白名单规则。
配置过程主要在Magento的后台完成:
- 登录到Magento后台,导航至“Stores” > “Configuration”。
- 在这里找到“Force Login”配置部分,您可以按网站、商店或视图来开启或关闭模块,并设置未匹配白名单时的重定向URL。
确保在进行任何配置更改后保存,并清缓存以便变更生效:
bin/magento cache:flush
通过上述指南,您可以有效地集成并配置这个插件,实现对客户的强制登录要求。