Copyright (c) 2003, 2004 Alex Pleiner - zeitform Internet Dienste.
[email protected] - http://www.zeitform.de. All rights reserved.
This program is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.


--------
Abstract
--------

Apache::AntiSpam::JavaScript is based on Apache::AntiSpam and implements
a filter module to prevent e-mail addresses exposed as is on web pages.
This module converts the anchors containing e-mail addresses (mailto:)
to JavaScript code.

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

You may want to use other Apache::AntiSpam::* modules after this one.

This work is based on the Apache::AntiSpam::* modules provided by
Tatsuhiko Miyagawa <[email protected]>.

Example output:

  # in html-file
  <a href="mailto:[email protected]">[email protected]</a>

  # in browser
  <script type="text/javascript">
    JSlt=unescape('%3C'); // "<"
    JSgt=unescape('%3E'); // ">"
    document.write(''+JSlt+'a h'+'ref='+'"mai'+'lto:'+'alex'+'@zei'+'tfor'+
                   'm.de'+'"'+JSgt+'al'+'ex@z'+'eitf'+'orm.'+'de'+JSlt+'/'+
                   'a'+JSgt+'');
  </script>


------------
Requirements
------------

This module requires:

  - Apache::Constants
  - Apache::File

The requirements are encoded in Makefile.PL.

------------------
Basic Installation
------------------

Apache::AntiSpam::JavaScript may be installed through the CPAN shell in
the usual CPAN shell manner.  This typically is:

 $ perl -MCPAN -e 'install Apache::AntiSpam::JavaScript'

You can also read this README from the CPAN shell:

 $ perl -MCPAN -e shell
 cpan> readme Apache::AntiSpam::JavaScript

And you can install the component from the CPAN prompt as well:

 cpan> install Apache::AntiSpam::JavaScript

-------------------
Manual Installation
-------------------

Apache::AntiSpam::JavaScript can also be installed manually.

Download the package from:
http://alex.zeitform.de/spamtrap/

Downloading and unpacking the distribution are left as exercises for
the reader.  To build and test it:

 perl Makefile.PL
 make test

When you're ready to install the component:

 make install

It should now be ready to use.