Templa...:Email(3pm)

💌 Templa...:Email(3pm) — bestie edition

okay so. imagine ur chillin in ur Perl Template Toolkit era and u got a wall of text with email addresses just SITTING there, not clickable, not slaying, just plain text?? tragic. that's literally what this page is about. it lives in the User Contributed Perl Documentation corner of the manpage universe, and it's here to make emails into links. let's go 💅

---

✨ NAME ✨

Template::Plugin::Clickable::Email — Make email addresses in to HTML links 🎀

like. it takes emails. it makes them links. no cap.

---

🦋 VERSION 🦋

Version 0.01

yes bestie it's a baby version, we love an early release, she's just getting started 🌸

---

🌈 SYNOPSIS 🌈

first u gotta summon the plugin, like so:

  [% USE link_emails = Clickable::Email %]

Then

  [% text | $link_emails %]

or

  [% FILTER $link_emails %]
  <p>Some text that contains an address: nik@FreeBSD.org.</p>
  [% END %]

see how easy?? the vibe check passed, the filter is installed, ur emails are about to be clickable ✨

---

💖 DESCRIPTION 💖

Template::Plugin::Clickable::Email converts any e-mail addresses found in the filtered text in to HTML "mailto:" links. that's the whole glow-up. ur text walks in as plain prose and walks out with actual clickable mailto energy 🔥

this module uses Email::Find, so if u want the tea on how addresses get parsed, and why some false positives may occur, go read that module's documentation. not me guessing at ur addresses bestie, that's Email::Find's whole job, and sometimes it gets a lil overexcited 🙈

---

👑 AUTHOR 👑

Nik Clayton, "<nik@FreeBSD.org>" — icon behavior, we stan 🫶

---

💀 BUGS 💀

found a bug?? want a feature?? please report any bugs or feature requests to "bug-template-plugin-clickable-email@rt.cpan.org", or slide through the web interface at <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Template-Plugin-Clickable-Email>.

the author will be notified, and then you'll automatically be notified of progress on your bug as changes get made. it's giving collaborative. it's giving transparency. we love a feedback loop 😭💜

---

🍓 COPYRIGHT & LICENSE 🍓

Copyright (c) 2005 Nik Clayton All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

ok so here comes the loud part, and it is LOUD for a reason, do not skip it bestie. THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

translation: no warranty, no promises, no taking anyone to court over it, it is what it is 💀

---

and that's the whole page, bestie!! 🎀 this lil masterpiece came from perl v5.34.0 and was dated 2022-06-17. go forth, make ur emails clickable, and remember — the mailto: links are the main character now 👑✨🦋