thelia/dpd-pickup-module

安装: 814

依赖: 0

建议者: 0

安全: 0

星级: 2

关注者: 8

分支: 13

开放性问题: 4

类型:thelia-module

2.0.5 2024-05-31 10:14 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