README

停止俄罗斯战争。 🇺🇦 乌克兰自由！

shippingmax

为 OpenMage 添加新的取货配送方式的模块。

Composer 依赖项

• adamlc/address-format
• giggsey/libphonenumber-for-php
• azuyalabs/yasumi

包含的依赖项

• owebia/shipping (2.6.10-lite, without jquery/editor/phpparser/doc)
• leaflet (1.9.4)

外部服务

• Nominatim: 地址地理编码（结果存储在数据库中）
• DaData: 地址地理编码（结果存储在数据库中，仅限RU和KZ），需要账户

新的配置选项

在 系统 / 配置 / 交货时间 中，您可以按交货国家/地区配置 交货时间。您在标题中看到 * 号吗？这是因为所有时间尚未配置。

在 系统 / 配置 / 配送方式 / 通用 中，您可以 隐藏和清除配置 供自定义选择的未使用配送方式。您在标题中看到 * 号吗？这是一个标记，通知您配送方式适用于当前商店视图的默认国家/地区。

在 系统 / 配置 / 客户 / 地址模板 中，使用 adamlc/address-format 自动管理模板，电话号码使用 giggsey/libphonenumber-for-php 格式化。

新的配送方式（取货）

根据订单重量和金额，配送方式适用于选择的国家/地区。所有详细信息都在配送方式配置中显示（您还可以在 config.xml 中的 <default> 标签中读取内容）。

您会喜欢调试取货配送方式的 URL。您打开了一个链接，看到地图，而配送方式被禁用，但有一个标题？这不是错误，这是一个功能。

取货点的列表定期从互联网（通过 cron 作业）检索并保存到 var/shippingmax/*.dat。当禁用 cron 作业时，列表按需检索（当客户打开地图，如果缓存文件不存在或缓存文件已过期时）。

地图上使用客户配送地址的国家/地区，并且无法在地图上更改。

此模块不会生成任何标签。

演示链接可能无法正常工作，请不要惊慌，这不是错误。

您想要更多吗？联系我们，也许我们可以合作添加新方法！例如：Colissimo，Relais Colis，Swiss Post，GLS，UPS...

自定义

对于一步式结账模块，您必须编辑您的配送方式模板，例如使用

<?php foreach ($shippingRateGroups as $code => $rates): ?>
	[...]
	<?php foreach ($rates as $rate): ?>
		[...]
		<?php if ($this->helper('shippingmax')->isSpecial($code)): ?>
			<?php echo Mage::getBlockSingleton('shippingmax/selected')
				->setTemplate('kyrena/shippingmax/selected.phtml')
				->setData('code', $code)
				->toHtml() ?>
		<?php else: ?>
			[...]
			<input type="radio" name="shipping_method"
				value="<?php echo $rate->getCode() ?>" ...
			[...]
		<?php endif ?>
		[...]
	<?php endforeach ?>
<?php endforeach ?>

要显示交货时间，您必须使用以下方法编辑您的模板

<?php $shippingDate = $this->helper('shippingmax')->getShippingDate($rate->getCode()) ?>
<?php if (!empty($shippingDate)): ?>
	<?php echo $shippingDate ?>
<?php endif ?>

版权和致谢

• 当前版本：3.3.1 (16/06/2023)
• 兼容性：OpenMage 19.x / 20.x / 21.x，PHP 7.2 / 7.3 / 7.4 / 8.0 / 8.1 / 8.2
• 客户端兼容性：Firefox 36+，Chrome 32+，Opera 19+，Edge 16+，Safari 9+
• 翻译：英语（en），法语（fr-FR/fr-CA），德语（de），意大利语（it），葡萄牙语（pt-PT/pt-BR），西班牙语（es）/中文（zh），捷克语（cs），荷兰语（nl），希腊语（el），匈牙利语（hu），日语（ja），波兰语（pl），罗马尼亚语（ro），俄语（ru），斯洛伐克语（sk），土耳其语（tr），乌克兰语（uk）
• 许可证：GNU GPL 2+

如果您愿意，可以花些时间改进翻译，请访问https://bit.ly/2HyCCEc。

安装

使用composer

• composer remove owebia/magento1-module-advanced-shipping
• 搜索并删除所有 owebia/shipping 文件和目录
• composer require kyrena/openmage-shippingmax
• 清除缓存

不使用composer

• 搜索并删除所有 owebia/shipping 文件和目录
• 下载最新版本并提取 src/* 目录
• 在这里，adamlc/address-format、giggsey/libphonenumber-for-php 和 azuyalabs/yasumi 不是必需的也不被使用，所以我建议您从我们的 system.xml 中移除 <customer>...</customer> 块
• 清除缓存