thelia / dpd-pickup-module
Requires
- thelia/installer: ~1.1
This package is auto-updated.
Last update: 2024-08-31 00:35:24 UTC
README
- DPD自提点配送
- 导出/导入订单
安装
手动
- 将模块复制到
<thelia_root>/local/modules/
目录,并确保模块名称为 DpdPickup。 - 在 Thelia 管理面板中激活它
Composer
将其添加到您的 main thelia composer.json 文件中
composer require thelia/dpd-pickup-module:~2.0.0
fr_FR
使用方法
提供配置页面,允许您执行以下任务:- 导出包含通过 DPD Pickup 完成的所有配送信息的 EXAPRINT 文件 (export.dat) - 配置 DPD Pickup 配送的价格区间
要访问它,请转到后台办公,点击“模块”选项卡,然后点击模块 DPD Pickup 行的“配置”按钮。要导出 EXAPRINT 文件,必须填写整个表单。
集成
该模块使用钩子,如果您的模板正确集成了所有 Thelia 钩子,通常不需要您做任何事情。
如果您想进行自己的集成,请参考以下详细说明
例如,为了进行集成,我使用了谷歌地图,这不是必需的,但更可取。实际上,该模块在订单期间不与地图交互。激活模块后,它仍然成为必需的,因为需要传递一个变量 $_POST['pr_code'] 到“thelia.order.delivery”表单中,否则您将无法进入第 3 步(order-invoice)。此外,还有一个名为“delivery.dpdpickup”的循环可用,它应该替换 order-delivery-module-list.html 中的“delivery”循环。这两个循环相似,但“delivery.dpdpickup”有一个额外的变量,它允许知道模块是否为 DpdPickup(这允许对 DpdPickup 行进行特定集成)。变量“pr_code”应包含用户选择的快递点的标识符。提供了一个循环,用于获取用户默认地址附近 10 个最近的快递点:dpdpickup.relais.around。否则,还有一个路由可以用于在某个城市中获取 10 个快递点:/module/dpdpickup/{ville}/{code postal} 这个路由指向“SearchCityController”控制器,它生成一个 json 文件,您可以使用它,例如,与 jquery/ajax 一起使用。
要显示快递点的地址作为订单发票页面的配送地址,只需将循环类型从“delivery-address”更改为 address.dpdpickup,而不是“delivery”。
要向订单确认邮件中添加包裹跟踪地址,我们提供了一个循环:“dpdpickup.urltracking”。它接受一个参数 ref,它是订单的引用,并输出 $URL。如果无法生成 URL,则不返回任何内容。因此,可以按以下方式集成
{loop name="tracking" type="dpdpickup.urltracking" ref=$REF} 您可以在这里跟踪您的包裹 {/loop}
en_US
如何使用
该模块提供了一个配置页面,因此您可以:- 导出包含通过 DPD Pickup 完成的所有配送信息的 EXAPRINT 文件 (export.dat) - 配置配送区域的价格区间
您可以在后台办公中通过转到“模块”选项卡,然后点击 DPD Pickup 行的“配置”按钮来使用它。要导出 EXAPRINT 文件,必须填写整个表单。
集成
此模块使用本地钩子。如果您的模板使用它们,您不需要做任何事情。
如果您想进行自己的集成,请按照以下说明操作
对于集成示例,我使用了谷歌地图,但这不是必须的。实际上,在订单过程中模块不与地图交互。一旦模块激活,你必须在表单“thelia.order.delivery”中创建一个名为“pr_code”的输入,而你不能进入步骤3(订单发票)。此外,“delivery.dpdpickup”循环可用,必须在order-delivery-module-list.html中替换“delivery”,它们执行相同的功能,但delivery.dpdpickup有一个新变量,可以让你知道正在循环的交付模块是否是DpdPickup。输入“pr_code”必须包含用户选择的取件&行店铺的ID。提供了一个循环,以获取用户默认地址附近的10个取件&行店铺:dpdpickup.relais.around。还有一个获取另一个城市10个取件&行店铺的路径:/module/dpdpickup/{city}/{zipcode}。这个路径使用“SearchCityController”控制器。它生成json输出,你可以使用它,例如,jQuery/ajax。
如果你想将店铺的地址显示为配送地址,你只需将“delivery-address”循环类型替换为address.dpdpickup