/ 
Apache-Clickable-0.02
River stage zero No dependents
/ Apache::Clickable

NAME

Apache::Clickable - Make URLs and Emails in HTML clickable

SYNOPSIS

# in httpd.conf
<Location /clickable>
SetHandler perl-script
PerlHandler Apache::Clickable
</Location>

# filter aware
PerlModule Apache::Clickable
SetHandler perl-script
PerlSetVar Filter On
PerlHandler Apache::Clickable Apache::AntiSpam Apache::Compress

DESCRIPTION

Apache::Clickable is a filter to make URLs in HTML clickable. With URI::Find and Email::Find, this module finds URL and Email in HTML document, and automatically constructs hyperlinks for them.

For example,

<body>
Documentation is available at http://www.foobar.com/ freely.<P>
someone@foobar.com  
</body>

This HTML would be filtered to:

<body>
Documentation is available at <a href="http://www.foobar.com/">http://www.foobar.com</a> freely.<P>
<a href="mailto:someone@foobar.com">someone@foobar.com</a>
</body>

This module is Filter aware, meaning that it can work within Apache::Filter framework without modification.

CONFIGURATION

PerlSetVar ClickableTarget _blank
PerlSetVar ClickableEmail Off
ClickableTarget
PerlSetVar ClickableTarget _blank

specifies target window name of hyperlinks. If set "_blank" for example, it filters to:

<a href="http://www.foobar.com/" target="_blank">http://www.foobar.com/</a>

None by default.

ClickableEmail
PerlSetVar ClickableEmail Off

specifies whether it makes email clickable. On by default. See Apache::AntiSpam for more.

TODO

  • Configurable hyperlink construction using subclass.

  • Currently, this module requires HTML::Parser, not to make duplicate hyperlinks. Maybe this can be done without HTML::Parser.

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

Apache::Filter, Apache::AntiSpam, URI::Find, Email::Find, HTML::Parser