/************************************************************************/
/* pnCPG       (/pndocs/readme.txt)                                */
/************************************************************************/

The pnCPG hack for Postnuke 0.72x is very simple and requires no tables in the DB.

Basically what this hack does is that it tries to log on the current Postnuke user within Coppermine.
If the user is known, automatically this user will be logged on.
There is no database integration, this hack only offers seamingless logon pass-through.

Tested with :
Postnuke 0.72x
Coppermine 1.3
Linux/Windows

Location of the Coppermine installation is not important.

INSTALLATION
======================
1.  Unzip the contents to your /modules directory.
2.  Copy pnCPG\Coppermine/index_pn.php to your Coppermine root directory. (mandatory)
3.  Initialise & activate the module
4.  Go to the AdminPanel and set the directory of Coppermine
5.  Link the module into a menu block as : {pnCPG}
	or as :
	{pnCPG:main&task=users} to have a direkt link into a users gallery
6.  Make this link only available to Registered Users through Permissions (unless you allow guest access).
7.  Add a new block and set your preferences for that


If you have installed Coppermine itself in the modules directory of PostNuke, you will need to remove a check within index.php of Coppermine.
Please remove the following code :
// Check if standalone is installed in a portal like phpNuke (added by DJMaze)
$DIR=preg_split("/[\/\\\]/",dirname($_SERVER["SCRIPT_NAME"] ? $_SERVER["SCRIPT_NAME"] : $HTTP_SERVER_VARS["SCRIPT_NAME"]));
if ($DIR[count($DIR)-2] == "modules") {
    echo "<html><body><h1>ERROR</h1>You installed the standalone Coppermine into your Nuke portal.<br>".
         "Please download and install a CPG Port: <a href=\"http://sourceforge.net/project/showfiles.php?group_id=89658\">CPG for PostNuke OR CPG for PHPnuke</a></body></html>";
    die();
} // end check



BLOCK SETTINGS
==============
When you setup the block, there are some settings that need explaining.
You can choose to use a Java menu  for options.
If you choose "yes" :
you can choose to load the java-component, it defaults to Yes but there might be another app that already loaded it, in that case change the setting to "n".
You can choose where the menu pop ups, Left or Right from the mosue. Choose the opposite direction of the side you are placing the block.

Applications using same Java library :
PostCalandar
pnChangeLog


Guest Account
=============
If one enables guest access, a user-account named "guest" will be created. This account will have the same rights as any other normal user (such as creating albums). This can be avoided by restricting the access rights of this Guest-user.



FINALLY
========================
In the admin panel, there is a checkbox in order to sync the PN users with Coppermine.
