Location: PHPKode > projects > Contrack Order Management > contrack/patUser-2.2.3/install.txt
patUser Installation
====================

CAUTION! 
patUser <= version 2.1.x are based on patDbc. Now patDbc is obsolete
- see http://www.php-tools.de/site.php?file=misc/patDbc.xml for details.
Further releases of patUser - version 2.2.0 and above - are based on PEAR::DB
which allows to access different types of datasources (MySQL, Postgres, ...)
Therefore currently all pat-classes switch to PEAR::DB. 

Release notes:
==============
Version 2.2.2 BETA:
- Added better security when using "crypt" encryption. 
- Added "mode" to requireAuthentication() - patUser now supports callback-objects to handle login
- removed some notices
- review of modifyUser() and fixed "username/password requirede"-bugs - hopefully!

Thanks to:
- Paul Baranowski <hide@address.com> who sends us a completely rewritten version of patUser 
  that implements lots of additional features and improvements. This version of patUser implements two of them 
  (improved crypt-function, callback for authentication).
- Gregor Gramlich <hide@address.com> for testing, reporting bugs and solutions.
- and YOU, for download, usage, test, bugreports, support, ...

Version 2.2.1:
- most changes were made to improve the download package
- minor bugfixes and removed notices

Version 2.2.0:
- derived from 2.1.1
- all functions changed to use work with PEAR:DB
- removed lots of warnings and notices
- patUser also works without "permissions" (uses only "groups" and "users")
- getPermissions() now can return a permission list of all users/groups

Installation:
=============
Installing these example are quite easy.

- Setup your Database
  patUsers stores all data in tables of your database. Use the SQL-dumps to setup the needed tables.
  
  This package provides two sets of SQL-dumps.
  
  1) sql/simple.sql
  This SQL-dump contains a very basic setup for patUser. It includes table definitions for "users", "groups", "permissions" and "usergroups"
  and four users: "gerd" (password: "gerd123"), "tom", "heiko" and "mathias" (Guess what the passwords are :-)).
  
  I suggest to use this "simple" setup for your first steps with patUser.
  
  2) sql/complex_*.sql
  There are some SQL-dumps named complex_base.sql, complex_users.sql and so on. Even if they are called "complex" 
  they are not really complicated. They are just dumps whose may come close to a real-live application. 
  The file complex_base.sql contains the basic table definitions, the oter files can be used for inserting
  data into you tables. I split the dump to ease playing with different data in your tables.
  
  Use any DB-Client (like "mysql" or "phpMyAdmin") to import the SQL-dump.
  
  Notes about SQL-Dumps:
  The SQL-dumps work fine in my case - but maybe you need to adjust the SQL-files if you use a different
  version of MySQL. If you have any suggestions to improve the SQL-dumps: please contact us/me!
  Please also notice, that I've never tested the dumps on other databases (like Postgres, etc). Furthermore I don't
  plan to test these dumps on any other database than the one I use. (I don't want to spend time for that.)
  On the other hand, if you send me fixed SQL-dumps I'll include them in the package. 

  
- copy files
  Copy the complete directory patUser into your web-root. 

- configure your installation of patUser
  patUser needs access to you database - of course. Therefore you have to setup your database-connection
  
  1) use exmaple.php and example2.php
  Open "prepend.php" and change $dsn to you needs. E.g.: mysql://pat:hide@address.com/pat
  (see the documentation of PEAR:DB on http://pear.php.net)
  
  2) use example_patConfiguration.php 
  Open the xml-config-file: "conf/user.xml" and change the 
  values of the "userdsn"-tag e.g. mysql://pat:hide@address.com/pat
   
- Start the example
  Start your web-browser and start the example:
  
  example.php - the basic example which is recommended
  
  example_patConfiguration.php - an example that shows how patUser can be configured with patConfiguration
  (This is just for advanced usage of patUsers)
  
  example_getPermissions.php - this example tests the improved features of the getPermission-method
  (Please notice, that you need some permissions in your database in order to fetch them!)
  
- start coding
  Load the example-files into your favourit editor and use patUser within your own projects.
  

Hav fun, gERD
Viel Spass am Gerät, gERD
Return current item: Contrack Order Management