Recaptcha - Revision history

Libjlrs at 15:08, 5 March 2014

2014-03-05T15:08:51Z

← Older revision		Revision as of 15:08, 5 March 2014
Line 39:		Line 39:
	<component surround="None"><field ref="captcha" /></component>		<component surround="None"><field ref="captcha" /></component>
	</source>		</source>
	''If you are running multiple archives and some need reCAPTCHA and others don't, copy the register.pl file into ~/archives/ARCHIVEID/workflows/user/ and edit it there.''		''If you are running multiple archives and some need reCAPTCHA and others don't, copy the register.xml file into ~/archives/ARCHIVEID/workflows/user/ and edit it there.''

	Reload the configuration again, and then visit your 'Create Account' page - you should have a nice shiny reCAPTCHA added to the registration!		Reload the configuration again, and then visit your 'Create Account' page - you should have a nice shiny reCAPTCHA added to the registration!

Libjlrs@leeds.ac.uk: Added categories

2012-10-02T14:27:43Z

Added categories

← Older revision		Revision as of 14:27, 2 October 2012
Line 63:		Line 63:

	Good work EPrints developers - it took about 10 minutes to get it working (and about 30 minutes to write this page :o)!		Good work EPrints developers - it took about 10 minutes to get it working (and about 30 minutes to write this page :o)!

			[[Category:Howto]][[Category:Snippets]][[Category:Metadata Fields]][[Category:Contribute]]

Libjlrs@leeds.ac.uk at 14:16, 2 October 2012

2012-10-02T14:16:24Z

← Older revision		Revision as of 14:16, 2 October 2012
Line 6:		Line 6:

	== What to do ==		== What to do ==
	# Register for a reCAPTCHA key at [http://www.google.com/recaptcha] (Click on the 'Use reCAPTCHA on your site' link).		# Register for a reCAPTCHA key at http://www.google.com/recaptcha (Click on the 'Use reCAPTCHA on your site' link).
	# Add reCAPTCHA keys to config		# Add reCAPTCHA keys to config
	# Configure a field to use reCAPTCHA		# Configure a field to use reCAPTCHA

Libjlrs@leeds.ac.uk: Create page about Captche / reCAPTCHA

2012-10-02T14:15:36Z

Create page about Captche / reCAPTCHA

New page

NOTE: This has been written based on my experience of an EPrints 3.3.10 install.

== Configuring reCAPTCHA for user registration ==
Recent versions of EPrints (3.2+?) have configuration that allows reCAPTCHA to be used for user registration and/or document requests.
If your version of EPrints has the file: ~/perl_lib/EPrints/MetaField/Recaptcha.pm, these instructions *should* work...

== What to do ==
# Register for a reCAPTCHA key at [http://www.google.com/recaptcha] (Click on the 'Use reCAPTCHA on your site' link).
# Add reCAPTCHA keys to config
# Configure a field to use reCAPTCHA
# Add field to workflow

== Adding the config ==
Create a file: ~/archives/ARCHIVEID/cfg/cfg.d/recaptcha.pl
<source lang="perl">
# Used by recaptcha fields. See ~/perl_lib/EPrints/MetaField/Recaptcha.pm
# Captcha registered by you@your-institution
$c->{recaptcha}->{public_key} = "...";
$c->{recaptcha}->{private_key} = "...";
</source>
Add the keys you got when registering for reCAPTCHA.

''You can create either domain specific keys, or general purpose keys. If you run multiple archives you might want to create general keys and add the config file to ~/lib/cfg.d/ instead.''

== Adding reCAPTCHA to User Registration ==
First we have to add the reCAPTCHA field to the user config.
I added the following code to the end of my recaptcha.pl file, but you could also add the field definition directly to the 'user_fields.pl' file.
<source lang="perl">
#Add field to user dataset
$c->add_dataset_field( "user", {
name => "captcha",
type => "recaptcha",
});
</source>
Now reload the configuration and update the database (through the web interface Admin->Config. Tools -> Reload Config / Update Database) - or via the command line.

Next, we have to add the field to the user registration workflow. If you haven't edited the registration workflow, look at ~/lib/workflows/user/register.xml. Add the following component after the existing Field::Multi component.
<source lang="xml">
<component surround="None"><field ref="captcha" /></component>
</source>
''If you are running multiple archives and some need reCAPTCHA and others don't, copy the register.pl file into ~/archives/ARCHIVEID/workflows/user/ and edit it there.''

Reload the configuration again, and then visit your 'Create Account' page - you should have a nice shiny reCAPTCHA added to the registration!

== Adding reCAPTCHA to Document requests==
This is similar to the above, basically add a field to the request dataset, render it in the workflow (did you know that requests now have a workflow? I didn't!).

Add the following to recaptcha.pl - or another suitable cfg.d/...pl file:
<source lang="perl">
#Add field to requests
$c->add_dataset_field( "request", {
name => "captcha",
type => "recaptcha",
});
</source>

Add the field to the workflow for requests ~/lib/workflows/request/default.xml
<source lang="xml">
<component surround="None"><field ref="captcha" /></component>
</source>
Reload config, update database etc. and test it works!

Good work EPrints developers - it took about 10 minutes to get it working (and about 30 minutes to write this page :o)!