README

WordPress 主题电话链接助手函数集合。

• 为您提供一组处理电话链接的函数。
• 自动将 <meta name="format-detection" content="telephone=no"> 条目添加到您的网站中，以禁用第三方脚本检测电话链接。

安装

您可以通过 Composer 安装此软件包

composer require mindkomm/theme-lib-links-phone

使用方法

当您使用 Timber 时，您可以在 Twig 中使用一些提供的函数。

Twig

<a {{ get_phone_link_attributes(number) }} aria-label="{{ phone_accessible(number) }}">{{ number }}</a>

函数

phone_accessible

为屏幕阅读器格式化电话号码。

将 052 203 45 00 转换为 0 5 2. 2 0 3. 4 5. 0 0。这使得电话号码更容易听到。在电话号码中添加空格和点。空格告诉屏幕阅读器逐个读取每个数字。点告诉屏幕阅读器暂停（就像句尾一样）。

将生成的字符串作为 aria-label 添加到您的电话号码链接中。

phone_accessible( string $phone_number )

返回： string 格式化后的电话号码，适用于无障碍。

PHP

<?php $number = '052 203 45 00'; ?>

<a href="tel:<?php echo $number; ?>" aria-label="<?php echo phone_accessible( $number ); ?>"><?php echo $number; ?></a>

Twig

<a href="tel:{{ number }}" aria-label="{{ phone_accessible(number) }}">{{ number }}</a>

phone_raw

获取未格式化的电话号码。

示例：从 '+41 052 203 45 00' 到 '00410524500'

phone_raw( string $phone_number )

返回： string 格式化后的电话号码。

PHP

<a href="tel:<?php echo phone_raw( $phone_number ); ?>"><?php echo $phone_number; ?></a>

get_phone_link_attributes

获取包含适当 HTML 属性的电话号码。

get_phone_link_attributes( string $phone_number )

返回： string HTML 属性字符串。

PHP

<a <?php echo get_phone_link_attributes( '+41 52 203 45 00' ); ?>>+41 52 203 45 00</a>

将导致

HTML

<a href="tel:0041522034500" rel="nofollow">+41 52 203 45 00</a>

Twig

<a {{ get_phone_link_attributes(phone_number) }}>{{ phone_number }}</a>

Twig 函数

您需要 Timber 来使用这些函数。

• get_phone_link_attributes
• phone_accessible

支持

这是一个我们在 MIND 开发 WordPress 主题时使用的库。您可以自由使用它，但我们目前不提供任何支持。