README

WordPress 主题链接辅助函数集合。

安装

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

composer require mindkomm/theme-lib-links

将 URL 转换为锚点链接。

在 URL 的最后一个部分前加上 # 以使用它作为锚点链接。

make_anchor_link( string $url )

返回: string 更新后的 URL。

PHP

// Output: https://www.mind.ch/onepager#subsection
echo make_anchor_link( 'https://www.mind.ch/onepager/subsection' );

检查 URL 是否为外部或内部。

is_external_url( string $url )

返回: bool 是否为外部 URL。

PHP

if ( is_external_url( 'https://example.org' ) ) {
    // Do something
}

Twig

{% if is_external_url('https://www.example.org') %}
    {# Do something #}
{% endif %}

将 URL 转换为仅包含域名和顶级域。

url_to_domain( string $url, bool $strip_www = false, int|bool $limit = false )

返回: string URL 的域名部分。

PHP

<?php $domain = 'https://www.mind.ch/post/blablabla?param=wow'; ?>
<a href="<?php echo $url; ?>"><?php echo url_to_domain( $domain ); ?></a>

Twig

{# url = 'https://www.mind.ch/post/blablabla?param=wow' #}
<a href="{{ url }}">{{ url_to_domain(url) }}</a>

获取带有适当 target 和 rel 属性的链接标签的 href 属性。

检查 URL 是否为内部或外部。对于外部 URL 添加 target="_blank"。受 http://stackoverflow.com/a/25090564/1059980 启发。为了捕捉安全漏洞，添加了属性 rel="noopener noreferrer"，更多信息请参阅 https://mathiasbynens.github.io/rel-noopener/。

get_link_attributes( string $url )

返回: string|bool 带有 target 和 rel 属性的 href 属性，必要时返回。如果输入为空，则返回 false。

PHP

<a <?php echo get_link_attributes( 'https://www.mind.ch/blog' ); ?>>MIND Blog</a>

Twig

<a {{ get_link_attributes(url) }}>MIND Blog</a>

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

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