Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Captcha::reCAPTCHA::MaUserdContributed Perl DocCaptcha::reCAPTCHA::Mailhide(3)

NAME
       Captcha::reCAPTCHA::Mailhide - A	Perl implementation of the reCAPTCHA
       Mailhide	API

VERSION
       This document describes Captcha::reCAPTCHA::Mailhide version 0.94

SYNOPSIS
	   use Captcha::reCAPTCHA::Mailhide;

	   my $m = Captcha::reCAPTCHA::Mailhide->new;

	   # Get the URL that reveals the email
	   my $url = $m->mailhide_url( MAIL_PUBLIC_KEY,	MAIL_PRIVATE_KEY, 'someone@example.com'	);

	   # Or	- even easier -	get the	formatted HTML for an email link
	   print $m->mailhide_html( MAIL_PUBLIC_KEY, MAIL_PRIVATE_KEY, 'someone@example.com' );

       For complete examples see the /examples subdirectory

DESCRIPTION
       reCAPTCHA is a hybrid mechanical	turk and captcha that allows visitors
       who complete the	captcha	to assist in the digitization of books.

       From <http://recaptcha.net/learnmore.html>:

	   reCAPTCHA improves the process of digitizing	books by sending words that
	   cannot be read by computers to the Web in the form of CAPTCHAs for
	   humans to decipher. More specifically, each word that cannot	be read
	   correctly by	OCR is placed on an image and used as a	CAPTCHA. This is
	   possible because most OCR programs alert you	when a word cannot be read
	   correctly.

       This Perl implementation	is modelled on the PHP interface that can be
       found here:

       <http://recaptcha.net/plugins/php/>

INTERFACE
       To use reCAPTCHA	Mailhide you need to get a public, private key pair
       from this page:

       <http://www.google.com/recaptcha/mailhide/apikey>

       The Mailhide API	consists of two	methods	"mailhide_html"	and
       "mailhide_url". The methods have	the same parameters.

       The _html version returns HTML that can be directly put on your web
       page. The username portion of the email that is passed in is truncated
       and replaced with a link	that calls Mailhide. The _url version gives
       you the url to decode the email and leaves it up	to you to place	the
       email in	HTML.

       "new"
	   Create a new	"Captcha::reCAPTCHA::Mailhide".

       "mailhide_url( $pubkey, $privkey, $email	)"
	   Generate a link that	will decode the	specified email	address.

	   $pubkey
	       The Mailhide public key from the	signup page

	   $privkey
	       The Mailhide private key	from the signup	page

	   $email
	       The email address you want to hide.

	   Returns a URL that when clicked will	allow the user to decode the
	   hidden email	address.

       "mailhide_html( $pubkey,	$privkey, $email )"
	   Generates HTML markup to embed a Mailhide protected email address
	   on a	page.

	   The arguments are the same as for "mailhide_url".

	   Returns a string containing HTML that may be	embedded directly in a
	   web page.

CONFIGURATION AND ENVIRONMENT
       Captcha::reCAPTCHA::Mailhide requires no	configuration files or
       environment variables.

       To use Mailhide get a public/private key	pair here:

       <http://www.google.com/recaptcha/mailhide/apikey>

DEPENDENCIES
       Crypt::Rijndael,	MIME::Base64, HTML::Tiny

INCOMPATIBILITIES
       None reported .

BUGS AND LIMITATIONS
       No bugs have been reported.

       Please report any bugs or feature requests to
       "bug-captcha-recaptcha@rt.cpan.org", or through the web interface at
       <http://rt.cpan.org>.

AUTHOR
       Andy Armstrong  "<andy@hexten.net>"

LICENCE	AND COPYRIGHT
       Copyright (c) 2007, Andy	Armstrong "<andy@hexten.net>". All rights
       reserved.

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

DISCLAIMER OF WARRANTY
       BECAUSE THIS SOFTWARE IS	LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
       FOR THE SOFTWARE, TO THE	EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT
       WHEN OTHERWISE STATED IN	WRITING	THE COPYRIGHT HOLDERS AND/OR OTHER
       PARTIES PROVIDE THE SOFTWARE "AS	IS" WITHOUT WARRANTY OF	ANY KIND,
       EITHER EXPRESSED	OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
       WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE
       ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF	THE SOFTWARE IS	WITH
       YOU. SHOULD THE SOFTWARE	PROVE DEFECTIVE, YOU ASSUME THE	COST OF	ALL
       NECESSARY SERVICING, REPAIR, OR CORRECTION.

       IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR	AGREED TO IN WRITING
       WILL ANY	COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
       REDISTRIBUTE THE	SOFTWARE AS PERMITTED BY THE ABOVE LICENCE, BE LIABLE
       TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL, OR
       CONSEQUENTIAL DAMAGES ARISING OUT OF THE	USE OR INABILITY TO USE	THE
       SOFTWARE	(INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
       RENDERED	INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
       FAILURE OF THE SOFTWARE TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
       SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
       DAMAGES.

perl v5.32.1			  2010-07-03   Captcha::reCAPTCHA::Mailhide(3)

NAME | VERSION | SYNOPSIS | DESCRIPTION | INTERFACE | CONFIGURATION AND ENVIRONMENT | DEPENDENCIES | INCOMPATIBILITIES | BUGS AND LIMITATIONS | AUTHOR | LICENCE AND COPYRIGHT | DISCLAIMER OF WARRANTY

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Captcha::reCAPTCHA::Mailhide&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help