<html>
<body>

    <div id='overview' class='readme' >
         <div class='header'>Introduction</div>
         <p>This readme is a guide to using the purple_cpg_bridge plugin.</p>
         <p>If you are a noob, basic user or advanced developer, this plugin will offer you a myriad of new possibilities to make e107 more exciting and user friendly.</p>

         <div class='header'>Overview</div>
         <p>puprle_cpg_bridge is a tool that forms a bridge between e107 and <a href='http://coppermine-gallery.net/' title='Click to surf to Coppermine' target=_BLANK'>Coppermine Photo Gallery</a> (CPG).  It allows the e107 user database and preferences to be used in Coppermine, thereby seamlessly integrating e107 users into Coppermine.</p>

         <p>It was built using the <a href='http://jquery.com/' title='Click to surf to jQuery' target=_BLANK'>jQuery library</a> and the purple_fancybox plugin by mygoggie from <a href='http://www.purplescroll.com' title='Click to surf to Purple Scroll' target=_BLANK'>The Purple Scroll</a>. Licensed under the <a href='http://en.wikipedia.org/wiki/GNU_Lesser_General_Public_License' target=_BLANK'>GPL</a> license.</p>

        <div class='subheader'>Features:</div>
        <p>
            <ol>
                <li>Allows e107 main administrators to become CPG administrators.</li>
                <li>Allows e107 registered users to become CPG users.</li>
                <li>Allows e107 guests to become CPG guests.</li>
                <li>Automatically create a new default e107 userclass for the CPG administrators. This userclass is by default named 'coppermine_admins'.</li>
                <li>Automatically create a new default e107 userclass for the CPG users. This userclass is by default named 'coppermine_users'.</li>
                <li>Automatically allocate users and main administrators to these userclasses.</li>
                <li>Allows for these userclasses to be changed in the purple_cpg_bridge dashboard.</li>
                <li>Automatically maps the Coppermine gallery 'User galleries' to the e107 userclass for CPG users.</li>
                <li>Automatically links Coppermine 'Home' menu item to e107 'Home'.</li>
                <li>Automatically creates new Coppermine menu item to point to the e107 'Forum'.</li>
                <li>Currently the plugin ONLY uses cookies to bridge. Sessions will be a feature in a future release.</li>
                <li>Will automatically find the CPG installation and copy the required files.</li>
                <li>Automatically create a new sitelink named 'Gallery' that links to CPG.</li>
                <li>Adds a clean e107 plugin dashboard to configure the plugin.</li>
                <li>Secure usage designed into the plugin.</li>
                <li>Checks for plugin updates with a single click.</li>
            </ol>
        </p>

        <div class='header'>Installation</div>
        <P>To install purple_cpg_bridge, follow these simple steps exactly:
            <OL>
                <li>Set e107 to use cookies.  To do this go to Admin&gt;Preferences&gt;Security & Protection&gt;User Tracking method. Set this to "Cookies".</li>
                <LI>Unpack the plugin in the directory e107_plugins (or whatever you have named your plugin directory).</li>
                <li>Download, unpack and install the Coppermine Photo Gallery.  Make a note of where you installed it.</li>
                <LI>Install the plugin by going to Admin&gt;Plugin Manager&gt;Not installed.  Find the purple_cpg_bridge plugin icon and click Install.</li>
                <li>Configure the plugin by going through all the installation steps in the plugin dashboard.  Unless you know exactly what you are doing, use the default settings as displayed.</li>
                <li>Configure Coppermine by logging with the user details with which you installed Coppermine.  Activate the e107 Coppermine bridge by going Configure>Bridge Manager and completing all the input fields and steps.</li>
                <li>Remember to configure the rights of groups in the Coppermine admin dashboard.</li>
                <LI>Grab a beer or coffee (or tea) &ndash; you have completed the installation!</li>
            </OL>
        </P>

        <div class='header'>How to use</div>
        <P>Well, most of the work has been done for you!  All you have to do is sit back and let the plugin do the work!</p>
        <p>Simply click on the "Gallery" sitelink to use CPG.</p>

    </div>
</body>

</html>