JRPassphrase
Joomla 1.5 Native
Module & Plugin Version 1.54
May 12, 2009

Description:
JRPassphrase makes it easy to control registration on your Joomla 1.5 website by requiring that a passphrase be correctly entered before someone can  register  - useful for your existing club, organization, church, schools, etc. It is also great at keeping the 'bots' from creating phony user registrations on your site.
JRPassphrase consists of a plugin and a module. 

We recommend that you install both the plugin and the module, and use the module for allowing users to enter the registration passphrase.
The plugin intercepts the URL of the registration page, so that a passphrase must be properly submitted before a user can register on the site.
You can distribute the passphrase to your members via newsletter, email, etc.
The passphrase can also be the answer to a question that your members already know - such as: "What is your coach's nickname?", etc.

What's New in JRPassphrase V1.54:
With this version, you can now use JRPassphrase with other registration components besides the standard Joomla registration - see "Using other Registration Components" below.
The JRPassphrase module now  allows a Module Class Suffix to be used, so you can style the module to your liking. The default is to match the Joomla login module style. It also allows you to easily change the button text, as well as the text above and below the button.
This version also runs considerably faster - since the function executes less than half the code of previous versions during normal use.
The parameter "SEF URL of Registration Page" has been removed with this version - it is no longer needed, since this version has been tested to work with SH404SEF and with Joomla's built-in SEF URL option.
If you have an earlier version of JRPassphrase installed, just uninstall both the JRPassphrase plugin and module and reinstall the new versions and set up their parameters as before.

JRPassphrase Plugin:
To use the JRPassphrase module, you need to install and enable BOTH the plugin AND the module, then you can select the plugin option to use the JRPassphrase module INSTEAD of the JRPassphrase_reg.php page . 
If you are using the module, you can select a message to appear when the module intercepts a registration attempt.
Similarly, you can enter another message that will be displayed for incorrect registration attempts , see the plugin options for this.

Incorrect passphrase attempts will normally be redirected to your home page (if using the module), or to the JRPassphrase_reg.php page if only using the plugin. 
If you want to redirect registration attempts to another page, use the "Alternate Passphrase Page URL" option, see the plugin option for this.

To use the JRPassphrase module - After enabling and setting up the plugin, go to the Module Manager to enable the module, setup parameters, and position the JRPassphrase module anywhere you want, just like any other module. See the JRPassphrase Module options below.

If you do not want to use the JRPassphrase module: then select "No" on the "Use the JRPassphrase module instead of JRPassphrase_reg.php" option on the right.  
You can also go to the module manager and disable the JRPassphrase module. 
If you do this, then the plugin will operate the same way as earlier versions of JRPassphrase - as described next.
If you do not use the module, then the included JRPassphrase_reg.php (in joomlaroot/plugins/system/) will be used to intercept registration attempts. 
The other plugin options on the right apply, except for the options that say "Module Use Only".  
You can modify the html portion of the JRPassphrase_reg.php file to change the text wording, font, color, background, etc of the passphrase message.	

The debug plugin option is normall turned off. If enabled, helpful debug messages are displayed for debugging registration issues. 
In debug mode, the plugin only displays messages, it does not redirect registration attempts.

Note: if you have Joomla caching enabled, please clean the cache after installing and setting up the plugin. 
Otherwise, registration attempts may bypass the plugin and will not be intercepted.


JRPassphrase Module:
JRPassphrase Registration Passphrase Module - used with plg_jrpassphrase. 
It will appear as "New User Registration" in the Joomla Module Manager. 
Remember to enable the module!
You can change the title of the module to show whatever you want. 
You can also change the text message shown above and below  the "Submit Passphrase" button. You can now change the text for the button itself too. Usually the order of this module should be set to one below the Joomla Login Form module. Also, be sure to enable and setup the JRPassphrase plugin!

Normally, the JRPassphrase module would be positioned on your home page. If you choose to position it on a different page, then you should go to the plugin settings and  put the full URL path of the page in the plugin option "Alternate Pasphrase Page URL".


Other Registration Components:
JRPassphrase was originally designed to work only with the standard Joomla 1.5 registration page. Now JRPassphrase has an parameter called "Alternate Registration Page URL".  If you are using a different Registration component than the default Joomla registration, just copy and paste the URL of it's registration page into this parameter in  the JRPassphrase Plugin. When JRPassphrase detects that a correct passphrase is entered, it will then redirect to this registration page.