/*	phpInvoice 1.6 - README-EN - 04.10.2005

	phpInvoice - is easy-to-use Web-based multilingual accounting software.
	Copyright (C) 2001 - 2005 Edy Corak < phprechnung at ecorak dot de >

	This program is free software; you can redistribute it and/or modify
	it under the terms of the GNU General Public License as published by
	the Free Software Foundation; either version 2 of the License, or
	(at your option) any later version.

	This program is distributed in the hope that it will be useful,
	but WITHOUT ANY WARRANTY; without even the implied warranty of
	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
	GNU General Public License for more details.

	You should have received a copy of the GNU General Public License
	along with this program; if not, write to the Free Software
	Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
*/

To install phpInvoice you will need:

Web server:
Apache 1.3 or 2.0 or maybe ( Microsoft IIS - not tested )

PHP:
4.1.0 or higher - register_globals = off

MySQL:
3.23.47 or higher ( lower versions were not tested )

MailServer:
Postfix, Sendmail, Exim or other.

Important note:
Under Configuration/Settings please enter a correct E-Mail address,
otherwise you will have problems sending e-mail's.

The configuration file ' mail.inc.php ' can be found in the /include directory.

$Smtp["host"] = "yourmailserver";
$Smtp["port"] = "25";
$Smtp["auth"] = false;
$Smtp["username"] = "";
$Smtp["password"] = "";

If your mail server needs authentication, so please change
$Smtp["auth"] = true; and set $Smtp["username"] and $Smtp["password"]

#####

Important note:

Questions to (open_basedir, safe_mode etc.) have nothing to do
with phpInvoice and will not be answered any more.
(approx.. 90% of the inquiries).

#####

Unpack phprechnung-1.x.tar.gz - tar zxvf phprechnung-1.x.tar.gz
Copy the directory ' phpRechnung ' to your Web server e. g. /var/www
( or change the name phpRechnung to phpInvoice )


Create Database:
-------------------

####################

Important note:

Before an UPDATE please backup all your data,
because all tables will be deleted.

####################

mysqladmin -u ' user name ' -p create phpinvoice

Create tables:
mysql -u ' user name ' -p phpinvoice < phprechnung-1.6.sql

If you have no ' root ' access, please use ' phpMyAdmin '

First create database, then select the data base, then select SQL,
Location of the text file: select suitable file e.g. phprechnung-1.6.sql,
then select Character set of the file: latin1 and click on Go.

You will see a message something like this:

Your SQL query has been executed successfully:
The content of your file has been inserted. (phprechnung-1.6.sql: 76 Instructions)

!!! IMPORTANT NOTE !!!

Please don't insert the SQL file into the field Run SQL query/queries on database.
The data will be inserted without any errors, but thereafter, a login is no longer possible.


The following files must be changed
in order to access your new database ' phpinvoice '.

In the directory ' /include '

' dbconf.php ' for the data base connection
_DBHOST z. B. "localhost"
_DBUSER z. B. "username"
_DBPASS z. B. "userpassword"
_DBNAME z. B. "phpinvoice"

_DBUSER must have enough rights on your
Data base server - SELECT, INSERT, UPDATE, DELETE

' phprechnung.inc.php '
(importantly is the variable "$web" please enter your own Web address
where you copy phpInvoice e.g. http://yourserver/phpInvoice
(without '/' at the end) otherwise the forwarding will not work.

For users who run phpInvoice on a Windows server,
please adapt the variable "$pdfdir".

Standard $pdfdir = "/tmp/"; in e.g. $pdfdir = "c:\windows\temp \";

or $pdfdir = "c:\\windows\temp\\"; if Parseerror should occur.

Please consider the last backslash. Importantly.
The Web server must have write access for this directory.

On Windows servers please also examine ' session.save_path '

Standard is session.save_path = /tmp
In this case, please change it
in e.g. session.save_path = c:\windows\temp

Login:

Administrator: admin, admin
Demo user: user, user

The user data are stored encrypted in the table ' anmeldung '

The administrator password can be changed
only the user name ' admin ' may not be changed.
Otherwise you will not be able to access many sites.

####################

phpInvoice was successfully tested under

Apache 1.3.19 - 2.0.54
PHP 4.0.6 - 4.3.11 (php.ini.recommended)
MySQL 3.23.47 - MySQL 4.1.11

phpInvoice homepage - http://www.phprechnung.de/phpRechnung/

If you wish to subscribe to new releases please go to
http://freshmeat.net/projects/phprechnung/ and register.

Thank you for using phpInvoice

Edy Corak < phprechnung at ecorak dot de >