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

The pnOwl hack for Postnuke 0.723 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 OWL.
If the user is known, automatically this user will be logged on. Otherwise a message will indicate that
this user is not authorised.
There is no database integration, this hack only offers seamingless logon pass-through.

Tested with :
Postnuke 0.723 / 0.726
Owl 7.1/7.2/7.3
Linux/Windows

Requirements :
- Availability of the postwrap module (If not opened in New Window).Optional as of Version 1.0

Location of the Owl installation is not important.


INSTALLATION
======================
1.  Unzip the contents to your /modules directory.
3.  Copy pndocs/*.*/ into your OWL root directory. (mandatory)(backup the old files)
    x.x represents your version, there are hacks for 7.1 / 7.2 / 7.3
4.  Initialise & activate the module
5.  Go to the AdminPanel and set the directory of Owl
6.  Link the module into a menu block as : {pnOwl}
7.  Make this link only available to Registered Users through Permissions (unless you allow guest access).
8.  Add a table to the database from Owl, use a tool like phpMyAdmin and execute the query as found in :
	sql/pnOwl.sql
9.  Add the following lines to your existing config/owl.php :

Owl 7.1		// Table with PostNuke info
		$default->owl_pn_table  = "pn_users";

Owl 7.2		// Table with PostNuke info
		$default->owl_pn_table  = $default->owl_table_prefix ."pn_users";

Owl 7.3		// Table with PostNuke info
		$default->owl_pn_table  = $default->owl_table_prefix ."pn_users";
		$default->IN_POSTNUKE = true ;

a.  If you allow Guest Access, a user with Loginname "guest" will be used with it's first usage (password = "guest")
b.  If you choose to have registered postnuke users automatically created, they will need to update their data.

Included is also a sideblock which will show the last X changed documents. Clicking the link in the block will take you to the folder where the documents resides.

Changes in 1.2
==============
Changed logic of single signon, no more cookies since they could give issues, certainly under windows.
Fixed a couple of small bugs in the Side block

Changes in 1.3
==============
You now can call pnOwl with a folder parameter like :
{pnOwl:main&folder=name_of_folder}
The folder can be called by Name or Id
Some cosmetic stuff

Changes in 1.4
==============
Support for version 7.3 (Mysql)


TO Do
=====
Check on the Bulk function.

TIPS
=====
In order to have the application opened in a separate New Window (full screen) do the following :
Create a Core/HTML block with the following contents :
<a href="index.php?module=pnOwl&func=main" target=_blank">Owl Inranet</a>
Make sure that in Admin Panel you have checked the Full Screen option
