Pamelaware for Joomla is an information cards plugin for the Joomla Content Management System.

DEMO it at:  http://pamelaproject.com/pwjos

== Requirements ==
You will need the following things to use PW-wp:
 * A static IP address 
 * An SSL Certificate
 * A Joomla 1.5.X CMS environment 
 * PHP5
 * php5-mcrypt (a library that contains crypto stuff)

== Installation ==
There are four pieces to the Joomla PamelaWare plugin:
 * com_pwjos:  This is the main component.  It does the heavy lifting.
 * mod_pwlogin:  This is the module that shows the purple "i" and other links on your sidebar.
 * plg_pwuserdel: This is a plugin that deletes information card data for a user when they are deleted.
 * plg_pwlogin:  This is an authentication plugin that authenticates the user once the component validates.

You will have to separately install all four of these pieces.

=== Before you can Install ===
This plugin only works in 1.0 Legacy mode. Before you can install, you will have to to the Plugin Manager, and enable the "Legacy" plugin.

=== Component Installation ===

==== Download one file with all the Extensions ====
 * Download a zip file containing all four extensions to your local computer.
 * Location:  [http:// here].
 * You will have to unzip this file before you install the separate extensions.

===== Checking out from Subversion =====
 1. Check out the "joomla15x" directory from either the trunk or from the latest stable branch:[[BR]]
  Dev Snapshot:  {{{ svn co https://pamelaproject.com/svn/pw/pwjos/trunk/joomla10x joomla15x }}}
 1. If you are installing from your local machine, archive each extension as either as a .tar.gz or as a .zip file, whatever is easier. 
{{{
pamela$ cd joomla15x
pamela$ tar czf com_pwjos.tar.gz com_pwjos
pamela$ tar czf mod_pwlogin.tar.gz mod_pwlogin
pamela$ tar czf plg_pwlogin.tar.gz plg_pwlogin
pamela$ tar czf plg_pwuserdel.tar.gz plg_pwuserdel
}}}

==== Upload All Four Extensions ====
 1. Login to the administration console of your Joomla install
 1. Click on the Extensions menu item and then select Install/Uninstall
 1. For each of the four extensions:
  1. Browse to the zip file (ie com_pwjos.zip or com_pwjos.tar.gz (depending on how you archived the plugin))
  1. OR if you are installing from the server, specify the path to one of the extensions
  1. Once you have selected the extension, click "upload & install".
  1. Note:   you may ignore the following error, if you see it:
{{{File /var/www/joomla10x/media/install_46f3f4a531bf1/com_pwjos/pwjos.xml does not exist!}}}

==== Configuring the Component ====
 1. Once the component has been installed, go to the Components menu item and select "Information Cards" to configure the plugin
    a. Add the private SSL key for your website
    a. Add the passphrase for the key, if one exists
    a. When you are finished, the checklist at the top of the page should display all green arrows
      * [[http://pamelaproject.com/index.php?option=com_content&task=category&sectionid=4&id=27&Itemid=47 Troubleshooting Tips]]
    a. Follow any extra installation steps on the page


==== Configure the Module ====
 1. Once the module is installed, click on the Extensions menu item and select "Module Manager"
 1. Select the "Information Card Login" module and click on it
 1. Make sure the link is published, and that it is in the right position on your front page.
 1. Under the pages/links items, select which pages you want to display infocard information - we suggest "all".
 1. If you need to modify the look or feel of the module to match your site, look [http://code.pamelaproject.com/wiki/adminHandbook/customizingTheFrontPage here].

==== Enable the Plugins ====
 1. Once each of the plugins are installed, click on the Extensions menu item and select "Plugin Manager".
 1. Find the plugin called user-PWuserdel and enable it
 1. Find the plugin called authentication-PWlogin and enable it

==== Testing  ====
 1. Go to the front page - you should see the standard information card logo displayed - if you have the component installed and set up, clicking on that link should trigger a selector and allow you to register an account.


==== Congrats, PamelaWare should be installed! ====