mattstauffer / craftcms-linkhelpers

Twig LinkHelpers for Craft CMS

Add a series of Twig filters and functions for CraftCMS to add link helpers for URLs and emails.

Installation

1. Move the linkhelpers directory into your craft/plugins directory.
2. Go to Settings > Plugins from your Craft control panel and enable the linkHelpers plugin

Usage

This plugin adds several Twig filters and several Twig functions.

Filters

Auto-link emails

Searches a string of text for email addresses and turns them into links.

{{ contentString | auto_link_emails }}

Or:

{% filter auto_link_emails %}
    <p>Content here with an email address like [email protected].</p>
{% endfilter %}

Outputs:

<p>Content here with an email address like <a href="mailto:[email protected]">[email protected]</a>.</p>

Auto-link URLs

Searches a string of text for URLs and turns into links.

{{ contentString | auto_link_urls }}

Or:

{% filter auto_link_emails %}
    <p>Content here with a URL like http://www.site.com/</p>
{% endfilter %}

Outputs:

<p>Content here with a URL like <a href="http://www.site.com/">http://www.site.com/</a></p>

Functions

Make a link to an email address

{{ linkEmail('[email protected]') }}

Outputs:

<a href="mailto:[email protected]">[email protected]</a>

Make a link to a URL

{{ linkUrl('http://www.site.com/') }}

Outputs:

<a href="http://www.site.com/">http://www.site.com/</a>