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

Requirements

You will need the following things to use PW-wp:

  • A static IP address
  • An SSL Certificate
  • A Joomla 1.0.X CMS environment
  • PHP5
  • php5-mcrypt (a library that contains crypto stuff)

Installation

There are two pieces to the Joomla PamelaWare plugin -- a component and a module. The component does the heavy lifting, and the module gives you the infocard link on the front page.

Component Installation

Getting the Component from Subversion & Compressing it

  1. On your local machine (ie not the server itself) Check out the "com_pwjos" directory from either the trunk or from the latest stable branch:
    Dev Snapshot: svn co https://pamelaproject.com/svn/pw/pwjos/trunk/joomla10x/com_pwjos com_pwjos
    Stable: svn co https://pamelaproject.com/svn/pw/pwjos/trunk/joomla10x/com_pwjos com_pwjos
  2. Archive the directory either as a .tar.gz or as a .zip file, whatever is easier.

pamela$ tar czf com_pwjos.tar.gz com_pwjos

Uploading the Component

  1. Login to the administration console of your Joomla install
  2. Click on the Installers menu item and then select Components
  3. Browse to either com_pwjos.zip or com_pwjos.tar.gz (depending on how you archived the plugin)
  4. Once you have selected the code, 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. Edit the main joomla.php file in the /includes directory of joomla (this is a hack, we don't like altering core code but haven't found an alternative)
    1. Copy the contents of /administrator/components/com_pwjos/pwjos-login.php into joomla.php, just before the "login" function (search for "function login" and insert just before"
  2. Once the component has been installed, go to the Components menu item and select "Information Cards" to configure the plugin
    1. Add the private SSL key for your website
    2. Add the passphrase for the key, if one exists
    3. When you are finished, the checklist at the top of the page should display all green arrows
    4. Follow any extra installation steps on the page

Module Installation

Getting Code from Subversion

  1. On your local machine (ie not the server itself) Check out the "mod_pwjos" directory from either the trunk or from the latest stable branch:
    Dev Snapshot: svn co https://pamelaproject.com/svn/pw/pwjos/trunk/joomla10x/mod_pwjos mod_pwjos
    Stable: svn co https://pamelaproject.com/svn/pw/pwjos/trunk/joomla10x/mod_pwjos mod_pwjos
  2. Archive the directory either as a .tar.gz or as a .zip file, whatever is easier.

Uploading the Module

  1. Login to the administration console of your Joomla install
  2. Click on the Installers menu item and then select Modules
  3. Browse to either mod_pwjos.zip or mod_pwjos.tar.gz (depending on how you archived the plugin)
  4. Once you have selected the code, click "upload & install".

Configuring the Module

  1. Once the module is installed, click on the Modules menu item and select "Site Modules"
  2. Select the "Information Card Login" module and click on it
  3. Make sure the link is published, and that it is in the right position on your front page.
  4. Under the pages/links items, select which pages you want to display infocard information - we suggest "all".
  5. There are a bunch of other options, most of which don't mean much yet, but feel free to play.

Testing the Module

  1. Go to the front page - you should see the standard information card logo displayed - if you have the component installed and set up, licking on that link should take you to the main login page.

Congrats, PamelaWare should be installed!