philipnewcomer/linkify-tracking

为DHL、FedEx、UPS和USPS的包裹追踪号添加链接

维护者

详细信息

github.com/philipnewcomer/linkify-tracking

源代码

问题

安装次数: 42,994

依赖项: 0

建议者: 0

安全性: 0

星标: 5

关注者: 2

分支: 2

开放问题: 6

2.0.0 2021-12-01 00:15 UTC

GPL-3.0 7b9e022abf9a50f9e008c4bcb1114362fd9ed553

  • Philip Newcomer <contact.woop@philipnewcomer.net>

This package is auto-updated.

Last update: 2024-08-29 04:48:30 UTC

README

为DHL、FedEx、英国皇家邮政、UPS和USPS的包裹追踪号添加链接。

安装

composer require philipnewcomer/linkify-tracking

用法

首先实例化库的一个实例

$linkifyTracking = new PhilipNewcomer\LinkifyTracking\LinkifyTracking;

获取单个追踪号的追踪URL

$linkifyTracking->getLinkUrl('12345678901234567890');

结果

https://tools.usps.com/go/TrackConfirmAction?tLabels=12345678901234567890

获取单个追踪号的链接数据

$linkifyTracking->getLinkData('12345678901234567890');

结果

[
    'carrier' => 'USPS',
    'url' => 'https://tools.usps.com/go/TrackConfirmAction?tLabels=12345678901234567890'
]

将给定内容中的所有追踪号转换为HTML链接

$content = '
Here is a tracking number: 12345678901234567890
And another tracking number: 12345678901234567890
';
$linkifyTracking->linkify($content)

结果

Here is a tracking number: <a href="https://tools.usps.com/go/TrackConfirmAction?tLabels=12345678901234567890">12345678901234567890</a>
And another tracking number: <a href="https://tools.usps.com/go/TrackConfirmAction?tLabels=12345678901234567890">12345678901234567890</a>

配置

可以将配置参数传递给LinkifyTracking构造函数。

以下参数可能被提供：

  • linkAttributes：应添加到生成的HTML链接中的属性数组

示例

$linkifyTracking = new PhilipNewcomer\LinkifyTracking\LinkifyTracking([
    'linkAttributes' => [
        'class' => 'tracking-link',
        'target' => '_blank'
    ]
]);

致谢

DHL、FedEx、UPS和USPS的追踪号正则表达式取自https://github.com/darkain/php-tracking-urls。