Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

template::plugin::clickable::email(3pm) [debian man page]

Template::Plugin::Clickable::Email(3pm) 		User Contributed Perl Documentation		   Template::Plugin::Clickable::Email(3pm)

NAME

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

VERSION

       Version 0.01

SYNOPSIS

	 [% 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 %]

DESCRIPTION

       Template::Plugin::Clickable::Email converts any e-mail addresses found in the filtered text in to HTML "mailto:" links.

       This module uses Email::Find, see the documentation for that module for caveats relating to how addresses are parsed, and why some false
       positives may occur.

AUTHOR

       Nik Clayton, "<nik@FreeBSD.org>"

BUGS

       Please report any bugs or feature requests to "bug-template-plugin-clickable-email@rt.cpan.org", or through the web interface at
       <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Template-Plugin-Clickable-Email>.  I will be notified, and then you'll automatically be
       notified of progress on your bug as I make changes.

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.

       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.

perl v5.10.1							    2010-01-04				   Template::Plugin::Clickable::Email(3pm)

Check Out this Related Man Page

Template::Plugin::Clickable(3pm)			User Contributed Perl Documentation			  Template::Plugin::Clickable(3pm)

NAME

       Template::Plugin::Clickable - Make URLs clickable in HTML

SYNOPSIS

	 [% USE Clickable %]
	 [% FILTER clickable %]
	 URL is http://www.tt2.org/
	 [% END %]

       this will become:

	 URL is <a href="http://www.tt2.org/">http://www.tt2.org/</a>

DESCRIPTION

       Template::Plugin::Clickable is a plugin for TT, which allows you to filter HTMLs clickable.

OPTIONS

       target
	     [% FILTER clickable target => '_blank' %]
	     [% message.body | html %]
	     [% END %]

	   "target" option enables you to set target attribute in A links. none by default.

       finder_class
	   "finder_class" option enables you to set other URI finder class rather than URI::Find (default). For example,

	     [% FILTER clickable finder_class => 'URI::Find::Schemeless' %]
	     Visit www.example.com/join right now!
	     [% END %]

	   this will become:

	     Visit <a href="http://www.example.com/join">www.example.com/join</a> right now!

NOTE

       If you use this module with "html" filter, you should be careful not to break tags or brackets around the URLs. For example if you have a
       following URL form,

	 <http://www.example.com/>

       Clickable plugin will filter this into:

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

       which is bad for HTML viewing. However, if you HTML filter them first and then clickable filter, you'll get:

	 &lt;<a href="http://www.example.com/&gt">http://www.example.com/&gt</a>;

       which href part is wrong.

       You'd better try Template::Plugin::TagRescue in this case.

	 [% USE Clickable -%]
	 [% USE TagRescue -%]
	 [% FILTER html_except_for('a') -%]
	 [% FILTER clickable -%]
	 <http://www.example.com/>
	 [%- END %]
	 [%- END %]

       will give you the right format.

AUTHOR

       Tatsuhiko Miyagawa <miyagawa@bulknews.net>

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

       Template, URI::Find, Template::Plugin::TagRescue

perl v5.8.8							    2006-11-23					  Template::Plugin::Clickable(3pm)
Man Page