piFAQ Lite v1.0 (25 December 2003)

http://pifaq.sourceforge.net
Copyright (c), 2004 - Pavel Ivanov (pi@mail.by)                  


1) WELCOME
2) LICENSE
3) INSTALL
4) UPDATE
5) REDESIGN
6) CHANGES



1) WELCOME
----------

piFAQ is a simple script that will help you to create (and manage) FAQ page on your site. 
It is based on PHP, MySQL and FastTemplate so it's fast and easy in configuration.



2) LICENSE
----------

piFAQ is licenses under the: GPL. There should be an included LICENSE file
if it really intrests you (or you having trouble sleeping) go ahead a read it.



3) INSTALL
----------

You need:

	- PHP (I'm using PHP Version 4.3.3) - www.php.net
	- MySQL (I'm using MySQL 3.23.58)   - www.mysql.com
 
 
How to install:
 
	(you can use install.php to create database and tables automatically)
	- Copy all files into your piFAQ directory (it doesn't meter how will you call it)
	- Create MySQL database for piFAQ. (www.mysql.com)
	- Create tables from tables.sql (mysql -u username -p datbase_name < tables.sql)
	- Config piFAQ - edit config.inc.php file
	- You can edit design of pages by editing of templates (directory  "tpl/"). Learn about FastTemplate here: http://www.thewebmasters.net/php/FastTemplate.phtml
	- The main page of piFAQ is faq.php. So, put a link to it from your page.

Warning! Don't forget to delete install.php and update.php after you've done with installation.



4) UPDATE
---------

If you wont to update your piFAQ from older versions to piFAQ Lite v1.0 and you don't wont to add all questions again. 

	- Use update.php to update your database.
	- Delete all old files from your pifaq directory and copy there a new from pifaq_lite-1.0.tar.gz archive.



5) REDESIGN
-----------

Someone can ask: "When I open up edit.php in my text editor it doesn't have any html in it".
Well it is true. There is no html in php files, Because piFAQ use FastTemplate (templates helps to separate program code from html).
And because of templates it's even more easy to redesign script then in simple php with html included.
                                                                                                                                            
You just need to edit files  in the "tpl" directory. Lets look at them.
(NOTE: don't edit data which are in "{" "}" quotes).
                                                                                                                                            
index.tpl - This is a base of your design there you can edit bgcolor of page etc.
body.tpl this is a table that you can see at faq.php (don't touch the comments FastTemplate use it to found dynamic blocks).
edit.tpl  - table that you can see at edit.php (also don't touch the comments).
login.tpl - Login form where program asks you to enter login and password.
addq.tpl  - Adding question form.
error.tpl - better don't touch it :-)
copy.tpl  - CopyLeft at the bottom of page (you can add there your Copy left, counters etc).
                                                                                                                                            
So as you can see you don't need to understand how FastTemplate works but if you wont to, read about it here:

http://www.thewebmasters.net/php/FastTemplate.phtml 
http://www.devshed.com/Server_Side/PHP/PHPFastTemplate/print.
                                                                                                                                            


6) CHANGES
----------

piFAQ Lite v1.0
+ Bug with class.FastTemplate.php fixed
+ Some little bugs fixed
+ All messages stored in config.inc.php

piFAQ Lite v1.0rc1
+ You can set the position of question during the adding
+ Templates are more ergonomic now :-)
 
piFAQ v0.0.3
+ Now you can move questions up and down
+ List of questions in the top of faq page
+ Now you can create mysql tables using install.php. I hope it'll help to those who don't know how to create it manualy :-)
- Ordering questions by date
 
piFAQ v0.0.2-1
+ Some security bugs fixed
 
piFAQ v0.0.2
+ title on edit page
+ editing the questions

