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@email.com.</p>
{% endfilter %}

Outputs:

<p>Content here with an email address like <a href="mailto:email@email.com">email@email.com</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@email.com') }}

Outputs:

<a href="mailto:email@email.com">email@email.com</a>

Make a link to a URL

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

Outputs:

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