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 the
        Apache::AntiSpam manpage 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

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