mediarox / module-checkout-placeholder
在常见结账字段(包括必填标记)上显示占位符而不是标签。
Requires
- php: ~7.4|~8.0|~8.1
- magento/framework: 103.0.*
- magento/module-checkout: 100.4.*
This package is auto-updated.
Last update: 2024-09-06 14:42:03 UTC
README
描述
此模块旨在视觉上更改所有字段对(标签+字段),使标签放置在字段内部(包括“required-entry”标记“*”作为HTML占位符)。此外,您可以决定是否要隐藏标签,定义自定义必填标记,隐藏必填标记,自定义占位符文本,并将字段标记为可选。
注意事项
大多数结账字段通过PHP收集并通过模板动态渲染。例如,所有输入字段都通过模板 vendor/magento/module-ui/view/frontend/web/templates/form/element/input.html
渲染。对于所有这些动态字段,我们创建了一个布局处理器,该处理器提供了以下功能。
然而,也有一些字段无法通过布局处理器来影响。在标准结账中,这些字段是
- 电子邮件
- 密码
- 密码确认(如果可用)
这些字段在knockout模板 Magento_Checkout/template/form/element/email
中一起创建,并且默认情况下也没有为HTML占位符做好准备。对于这些字段,我们目前只提供knockout模板覆盖,确保在安装后始终使用标签作为占位符。包括静态必填标记“*”。
一旦时间或客户订单允许,我们将提供这些字段的完整功能。
功能
- 将字段标签显示为占位符
- 自定义占位符文本
- 隐藏标签
- 定义自定义必填标记
- 隐藏必填标记
- 将字段标记为可选
安装
composer require mediarox/module-checkout-placeholder bin/magento setup:upgrade
配置
店铺 > 配置 > MEDIAROX > 结账占位符
常规
启用
启用模块。激活后,默认情况下字段占位符将填充标签。
- 路径:checkout_placeholder/general/enable
- 默认:0
隐藏标签
启用此设置以隐藏标签。
- 路径:checkout_placeholder/general/hide_labels
- 默认:0
显示必填标记
启用以显示必填标记。
- 路径:checkout_placeholder/general/enable_required_mark
- 默认:1
自定义必填标记
如果想要显示自定义必填标记,请在此处输入。
- 路径:checkout_placeholder/general/custom_required_mark
- 默认:'*'
- 依赖于:checkout_placeholder/general/enable_required_mark = 1
特定字段
要覆盖特定字段的占位符内容(标签文本),请输入字段_id和您想要显示的占位符。如果您需要自定义在多个字段集中使用的字段(例如,姓名在账单和收货地址中可用),请输入额外的唯一字段集id(例如,账单地址:'form-fields',收货地址:'shipping-address-fieldset')。对于街道字段,请使用field_ids street_0
、street_1
和 street_2
。
- 路径:checkout_placeholder/general/specific_fields
- 默认:''
可选字段
启用
如果启用,将在可选字段中配置的字段上应用自定义可选标记。
- 路径:checkout_placeholder/optional_marks/enable
- 默认:0
可选标记
在此处输入您想要显示的任意文本/标记。
- 路径:checkout_placeholder/optional_marks/custom_optional_mark
- 默认:''
将字段标记为可选
在此处指定您想显示可选标记的字段。如果您需要自定义在多个字段集中使用的字段(例如,名字在账单和收货地址中都可用),请输入额外的唯一字段集ID(例如,账单地址:'form-fields',收货地址:'shipping-address-fieldset')。对于街道字段,请使用字段ID street_0
、street_1
和 street_2
。
- 路径:checkout_placeholder/optional_marks/optional_fields
- 默认:''
兼容性
- amzn/amazon-pay-module(已弃用的核心依赖),测试版本:4.2.2
- amzn/amazon-pay-magento-2-module(最新的亚马逊支付模块),测试版本:5.7.1,5.9.1
- amasty/module-single-step-checkout,测试版本:3.1.2,3.1.3,4.0.0