The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
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