Edy's phpRechnung


Willkommen auf der offiziellen Website von phpRechnung.

phpRechnung ist ein einfach-zu-benutzendes Rechnungsprogramm.

Mit phpRechnung können Sie folgende Aufgaben erledigen:


Aktuell phpRechnung 1.6.6

Projekt auf SourceForge.net

Häufig gestellte Fragen
ChangeLog
Lizenz
Herunterladen

LiesMich

31.01.2011

Um phpRechnung 1.6.4 installieren zu können wird folgendes benötigt:

Server

Webserver:
nginx, Apache, Lighttpd oder auch ( Microsoft IIS - nicht getestet )

PHP Version 5 - ( mbstring, PEAR::Mail, Mail_Mime )

MySQL Version 5 oder auch 4 ( ab phpRechnung 1.8 auch andere Datenbaksysteme )

MailServer:
z. B. Postfix, Exim, Sendmail ...

Klient

Browser:
z. B. Firefox, Konqueror, Safari, Opera, Google Chrome ...
( Javascript muss eingeschaltet sein )

PDF-Betrachter

Die oben genannten Programme müssen bereits
installiert und konfiguriert sein.

Wichtig:

Unter Einstellung muss eine korrekte E-Mail Adresse eingetragen
werden, da ansonsten der E-Mail Verasand nicht funktioniert.
Das selbe gilt auch, wenn ein Relay-Server benutzt wird,
da ansonsten die E-Mail's vom Relay-Server abgewiesen werden.

In der Datei /include/mail.inc.php müssen noch
Änderungen vorgenommen werden Host, Port und falls
Anmeldung notwendig ist, $Smtp["auth"] auf true zu stellen
und $Smtp["username"] und $Smtp["password"] eintragen.

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


Wichtiger Hinweis:

Bitte haben Sie Verständnis, dass für die oben genannten
Programme keine Anfragen mehr beantwortet werden können.

Fragen zu ( open_basedir, safe_mode etc. ) haben nichts mit
phpRechnung zu tun und werden auch nicht mehr beantwortet


phpRechnung_1_6_4.tar.gz entpacken - tar -zxvf phpRechnung_1_6_4.tar.gz
Das Verzeichnis 'phpRechnung_1_6_4' auf den Webserver kopieren
z. B. /var/www


!!! WICHTIGER HINWEIS !!!


Seit phpRechnung 1.6 RC1 wird Smarty Template Engine verwendet.
Damit das ganze funktioniert, müssen noch einige Änderungen
vorgenommen werden.

Der Webserver muss für die Verzeichnise '/include/smarty/cache'
und '/include/smarty/templates_c' Schreibrechte bekommen.

!!! Es wird empfohlen ein Verzeichnis ausserhalb des DocumentRoot zu verwenden !!!

Das gilt auch für die Verzeichnise '/include/smarty/templates' und '/include/smarty/configs'

Nach den Änderungen müssen Sie dies auch phpRechnung mitteilen.

In '/include/smarty.inc.php' folgende Variablen anpassen:

$Templateroot und $Cacheroot von $_SERVER['DOCUMENT_ROOT'] ."phpRechnung";

ändern in z. B.

$smarty->template_dir = "/var/www/include/ smarty/templates";
$smarty->config_dir = "/var/www/include/ smarty/configs";
$smarty->compile_dir = "/var/www/include/ smarty/templates_c";
$smarty->cache_dir = "/var/www/include/ smarty/cache";

Achten Sie bitte auf eine korrekte Schreibweise.

Mehr Informationen finden Sie unter Link: https://www.smarty.net/

Datenbank erstellen


Wichtiger Hinweis:

Diese Anleitung ist nur für eine Neu-Installation gedacht.

Wenn Sie ein UPDATE von phpRechnung 1.6 Test3.01 durchführen
möchten, dann lesen Sie bitte in der Datei UPDATE weiter.

Vor einem UPDATE bitte alle Daten sichern.


mysqladmin -u 'benutzername' -p create phprechnung

Tabellen erstellen:
mysql -u 'benutzername' -p phprechnung < phprechnung_1_6_4.sql

Falls kein 'root' Zugriff vorhanden, dann am besten 'phpMyAdmin' benutzen.

Zuerst Datenbank erstellen, wählen Sie dann die Datenbank aus, dann Importieren,
Datei dursuchen, passende SQL Datei auswählen: phprechnung_1_6_4.sql,
Zeichencodierung der Datei 'latin1' wählen und auf OK klicken.

Sie sollten dann z. B. folgende Meldung sehen:

Der Import wurde erfolgreich abgeschlossen, 127 Abfragen wurden ausgeführt.

!!! WICHTIG !!!

Bitte fügen Sie NICHT die SQL-Datei in das Feld SQL-Befehl(e) in Datenbank ein.
Die Daten werden ohne Fehler eingefügt aber eine Anmeldung ist danach NICHT mehr möglich.


Folgende Dateien müssen geaendert werden
damit man auf die neu erstellte Datenbank 'phprechnung' zugreifen kann.

Im Verzeichnis 'include'

'dbconf.php' für die Datenbankverbindung
_DBHOST z. B. "localhost"
_BBUSER z. B. "muster"
_DBPASS z. B. "muster123"
_DBNAME z. B. "phprechnung"

Der _DBUSER muss über ausreichende Rechte auf dem
Datenbankserver verfügen - Erstellen, Ändern, Löschen etc.

'phprechnung.inc.php'
( wichtig ist die Variable "$web" dort bitte eigene Webadresse zu
phpRechnung eintragen ) z. B. mustermann.de/phpRechnung
( ohne '/' am Ende ) da sonst die Weiterleitung nicht funktioniert.

Für die Benutzer die phpRechnung auf einem Windows Server betreiben,
bitte unter Konfiguration/Einstellung den Wert von TMP-Verzeichnis
anpassen. Standard ist '/tmp/' in z. B. 'c:\windows\temp\'

Bitte beachten Sie den letzten Backslash. Wichtig.
Der Webserver muss Schreibrechte für das Verzeichnis haben.

Auf einem Windows Server bitte auch 'session.save_path' überpruefen.

Standard ist session.save_path = /tmp
Wenn das der Fall ist, dann bitte ändern
in z. B. session.save_path = c:\windows\temp

Anmeldung:

Administrator: admin, admin

Die Benutzerdaten sind in der Tabelle
'user' verschlüsselt gespeichert

Nach der Ersten Anmeldung werden Sie aufgefordert die
phpRechnung Lizenz ( GPL v2 ) zu akzeptieren.
Dieses Vorgehen ist für jeden Benutzer einmalig notwendig.

Das Administrator-Passwort kann geändert werden
nur der Anmeldename 'admin' darf nicht vereändert
werden. Ansonsten werden viele Seite nicht anzeigen.

phpRechnung wurde erfolgreich getestet unter Debian/Ubuntu Linux Server standard PHP Konfiguration.

Aktualisierung

31.01.2011

Aktualisieren von phpRechnung 1.6 Test3.01 auf phpRechnung 1.6.4

!!! WICHTIG !!!

Vor einer Aktualisierung bitte alle Daten sichern.

mysqldump -u 'benutzername' -p --add-drop-table 'datenbankname' > phprechnung.sql

Tabellen erstellen

Die Tabellen müssen in die gleiche Datenbank wie die von
phpRechnung 1.6 Test3.01 importiert werden.

mysql -u 'benutzername' -p 'datenbankname' < phprechnung_1_6_4_update.sql

!!! HINWEIS !!!

Wenn Sie phpMyAdmin benutzen dann wählen Sie zuerst bitte die
Datenbank aus, dann Importieren, Datei durchsuchen, passende
SQL Datei auswählen: phprechnung_1_6_4_update.sql,
Zeichencodierung der Datei 'latin1' wählen und auf OK klicken.

Sie sollten dann z. B. folgende Meldung sehen:

Der Import wurde erfolgreich abgeschlossen, 127 Abfragen wurden ausgeführt.

!!! WICHTIG !!!

Bitte fügen Sie NICHT die SQL-Datei in das Feld SQL-Befehl(e) in Datenbank ein.
Die Daten werden ohne Fehler eingefügt aber eine Anmeldung ist danach NICHT mehr möglich.

phpRechnung installieren

phpRechnung_1_6_4.tar.gz entpacken - tar -zxvf phpRechnung_1_6_4.tar.gz
Das Verzeichnis 'phpRechnung' auf den Webserver kopieren z. B. /var/www
Sie können das Verzeichnis auch umbenennen.

Am besten ein anderes Verzeichnis wählen als das der Vorgänger-Version.

Die Anpassungen wie in der 'README' beschrieben durchführen.

Wenn Sie den Wert von '$pschluessel' ( 1.6 Test3.01 ) in 'phprechnung.inc.php'
verändert haben. Dann bitte diesen Wert auch in '$pkeyOld' ( 1.6.4 ) eintragen.

Jetzt kann die Erste Anmeldung erfolgen

Benutzername ist 'admin' das Passwort ist auch 'admin'

Nach der Ersten Anmeldung werden Sie aufgefordert die
phpRechnung Lizenz ( GPL v2 ) zu akzeptieren.

Dieses Vorgehen ist für jeden Benutzer einmalig notwendig.

Mit einem Klick auf 'Akzeptieren' gelangen Sie zu der Startseite.

Tabellen die NICHT aktualisiert werden sind:

'category' - Kategorie
'methodofpay' - Zahlungsweise
'posgroup' - Position - Gruppe
'tax' - Mehrwertsteuer

Wenn Sie die vordefinierte Text ändern möchten, dann können Sie dies jetzt
machen, da die Texte auch in Rechnungen/Angeboten ... gespeichert werden.

UPDATE

Jetzt bitte auf 'Update' klicken ( auf der Startseite unten links )
Sie gelangen jetzt zu der Updateseite. Danach bitte auf 'Update Login' klicken.

Wenn Sie den Wert von '$pschluessel' ( 1.6 Test3.01 ) in 'phprechnung.inc.php'
verändert hatten und in '$pkeyOld' ( 1.6.4 ) eingetragen haben, dann bitte
den Wert auch unter '$pkey' ( 1.6.4 ) eintragen.

Wenn Sie den Wert von '$pschluessel' ( 1.6 Test3.01 ) nicht verändert haben,
dann sind keine Änderungen in 'phprechnung.inc.php' mehr nötig. Ab diesem
Zeitpunkt wird '$pkeyOld' ( 1.6.4 ) nicht mehr benötigt.

In Deutschland wurde der Steuersatz am 01.01.2007 von 16% auf 19% geändert.

In den Dateien 'invoiceposf.php' und 'offerposf.php' im Verzeichnis 'update' wurden die
Anpassungen schon vorgenommen, so dass auch Rechnungen/Angebote, die vor dem 01.01.2007
erstellt wurden, wieder einen korrekten Steuersatz erhalten.

Wenn Sie einen anderen Steuersatz haben, dann müssen Sie dies vor dem Update manuell anpassen

'invoiceposf.php'

if($Tax == "1" && $InvoiceDate < "2007-01-01")
{
   $Tax_Multi = "0.16000";
   $Tax_Divide = "1.16000";
   $Tax_Desc = "16.00 %";
}

'offerposf.php'

if($Tax == "1" && $OfferDate < "2007-01-01")
{
   $Tax_Multi = "0.16000";
   $Tax_Divide = "1.16000";
   $Tax_Desc = "16.00 %";
}

Das gleiche gilt auch für den 2. Steuersatz.

In beiden Dateien bitte auch $Pos_Group = "Hotel"; anpassen.

Die Gruppe sollte natürlich schon existieren siehe oben 'posgroup' - Position - Gruppe

Jetzt bitte abmelden und wieder als 'admin' anmelden das Passwort
ist das gleiche wir in phpRechnung 1.6 Test3.01

Jetzt bitte wieder auf 'Update' klicken und dann wieder auf 'Update phpRechnung'

Je nach Datenmenge kann dieser Vorgang einige Minuten in Anspruch nehmen.

!!! WARNUNG, WÄHREND DER AKTUALISIERUNG BITTE NICHT AUF ABBRECHEN KLICKEN !!!
!!! ANSONSTEN MÜSSEN SIE WIEDER VON VORNE ANFANGEN !!!

Während der Aktualisierung sehen Sie folgende Meldung:

phpRechnung 1.6.4 UPDATE... Please wait, this can take some time.

Wenn die Aktualisierung abgeschlossen wurde erscheint folgende Meldung:

Congratulation, phpRechnung was succesfully updated.