Installationsanleitung: um-Bestellformularskript_V1.00

Vom 30. 10. 2007 @um-fritz.de

Vielen Dank für Ihr Interesse an meinem Bestellformularskript. Damit die Installation reibungslos erfolgt, lesen Sie bitte zunächst diese Installationsanleitung.

Inhalt von um-Bestellformularskript_V1.00.zip

[DIR]um-bestellformular

bestform.php5

bestform.css

lies_mich.html

[DIR]um-admin: admin.html; artdelete.php5; artedit.php5; artsecure.php5; bg_black.gif; bg_orange_gr.gif; bg_orange_kl.gif; bottom.html; confedit.php5; delete.gif; left.html; logedit.php5; top.html

[DIR]um-config: fixed_dat.php5; um_admin_main.css

[DIR]um-data: art_liste.php5; configdata.php5

[DIR]um-html: agb.gif; agb.html; info.gif; p_info.html; p_info.jpg; popup.css

[DIR]um-login: auth.php; login.php; logout.php

[DIR]um-skript: autoload.php5; bestform_classes.php5; bestform_skript.php5; class_CleanPostData.php5; class_MakeArtikellist.php5; class_Save.php5

[DIR]um-templates: formular.tpl

Installation

Zunächst entpacken Sie bitte um-Bestellformularskript_V1.00.zip auf Ihren Rechner. Die oben aufgeführte Verzeichnisstruktur sollte entsprechend vorhanden sein. Das Verzeichnis um-bestellformular kann umbenannt werden.
Die Namen der Unterverzeichnisse sollten nicht verändert werden, da die skriptinternen Verweise und Einbindungen dann nicht funktionieren.

Laden Sie dann das Verzeichnis mit den enthaltenenen Unterverzeichnissen und Dateien auf Ihren Webspace. Danach rufen Sie als erstes den Adminbereich auf. Nach Konfiguration Ihrer Zugangsdaten loggen Sie sich ein und können dann die nötigen Optionen ausführen. Konfigurieren Sie das Skript und geben Sie Ihre Artikel und die anderen Daten ein.

Das eigentliche Bestellformular können Sie in Ihre bestehende Website einbinden, indem Sie in der entsprechenden PHP Seite folgende Angaben eintragen:

Zeile 1: <?PHP include_once "um-skript/bestform_skript.php5"; ?>

Im head-Bereich: <link rel="stylesheet" media="screen" type="text/css" href="bestform.css" />

An der Stelle, an der das Formular eingefügt werden soll: <?PHP echo $bestellform_ausgabe; ?>

Wenn das unklar ist, lesen Sie den Quelltext der Datei um-bestellfomular/bestform.php5. Diese Seite ist ein Beispiel, wie die Einbindung erfolgen muss. Wenn Sie das Formular in Ihr Projekt einbinden, können Sie diese Beispielseite ersetzen. Speichern Sie dann Ihre Datei im Ordner um-bestellformular/[dateiname].php5.

Das Aussehen des Formulars können Sie mit der Datei um-bestellfomular/bestform.css anpassen, sofern Sie das nicht schon über eine übergeordnete CSS-Datei tun.

Der Ordner um-bestellformular/um-html/ ist für die Dateien vorgesehen, die als zusätzliche Informationen erscheinen können. Das betrifft zum einen Ihre AGB, zum anderen eventuelle Produktinformationen. Das Vorgehen in diesem Fall, sollte aus den Beispieldateien ersichtlich werden. Das Aussehen der "Popups" wird mit popup.css in diesem Ordner gesteuert. Sie können Webseiten mit Produktinformation im Adminbereich für jeden Artikel in der Artikelliste referenzieren.

Der Zweck der einzelnen Dateien sollte sich im Wesentlichen aus den Ordnernamen und den Dateinamen ergeben. Sollten Sie dazu Fragen haben, öffnen Sie den Quelltext der betreffenden Datei. Dort ist im Kommentar kurz erklärt, welche Aufgaben die Datei im Programmablauf übernimmt.

Urheberrecht

Das Skript darf von jedem ohne Einschränkungen benutzt werden. Der Backlink auf meine Website muss aber vorhanden bleiben. Sie können Ihn aber gerne auch an eine andere Stelle Ihres Projektes verlagern.

<a href="http://um-fritz.de" title="Webseitenerstellung">um-fritz.de</a>

Zudem bitte ich darum folgenden Metatag in der (X)HTML Vorlage zu lassen, bzw. in eine neue Vorlage im head Bereich zu übernehmen:

<meta name="Generator" content="script by http://um-fritz.de" />

Auch das Löschen der Kommentarzeilen in den Skriptdateien ist nicht zulässig.
In den HTML Dateien können die Kommentare jedoch bei Bedarf entfernt werden.
Sollten Teile des Codes für eine eigene Weiterentwicklung dienen, ist das in Ordnung. Ungemein ungehalten wäre ich jedoch, dieses Skript mit fremden Urheberrechtsvermerken wiederzuerkennen.

Haftungsausschluss

Ich habe dieses Skript nach bestem Wissen erstellt und getestet. Trotzdem besteht keinerlei Gewährleistung für das Skript. Das Skript steht so zur Verfügung, „wie es ist“, ohne irgendeine Gewährleistung, weder ausdrücklich noch implizit, einschließlich - aber nicht begrenzt auf - die implizite Gewährleistung der Marktreife oder der Verwendbarkeit für einen bestimmten Zweck. Das volle Risiko bezüglich Qualität und Leistungsfähigkeit des Skripts liegt bei Ihnen. Sollte sich das Skript als fehlerhaft herausstellen, liegen die Kosten für notwendigen Service, Reparatur oder Korrektur bei Ihnen.

In keinem Fall, bin ich Ihnen gegenüber für irgendwelche Schäden haftbar, einschließlich jeglicher allgemeiner oder spezieller Schäden, Schäden durch Seiteneffekte (Nebenwirkungen) oder Folgeschäden, die aus der Benutzung des Skripts oder der Unbenutzbarkeit des Skripts folgen (einschließlich - aber nicht beschränkt auf - Datenverluste, fehlerhafte Verarbeitung von Daten, Verluste, die von Ihnen oder anderen getragen werden müssen, oder dem Unvermögen des Skripts, mit irgendeinem anderen Programm zusammenzuarbeiten), selbst wenn ich über die Möglichkeit solcher Schäden unterrichtet worden war.

Ob dieses Skript mit der aktuellen Gesetzgebung bezüglich Onlineverkäufen konform geht und in dieser Form ausreichend ist, habe ich nicht geprüft und es obliegt somit Ihrer Verantwortung die juristischen Sachverhalte zu klären.

Mit der Installation dieses Skriptes erkennen Sie diese Bedingungen an und stellen Sie mich von jeglichen Ansprüchen frei.

Problemlösungen

Das Skript funktioniert nicht.: Das Skript benötigt PHP5 oder höher. Je nach Serverkonfiguration ist es nötig durch die Dateiendung mitzuteilen, welche PHP Version benutzt werden soll. Aus diesem Grund sind hier die Dateiendungen *.php5 verwendet worden.
Ob das mit Ihrer Serverkonfiguration kompatibel ist, können sie mit folgendem Test erfahren:
Erstellen Sie eine Datei mit folgendem Inhalt:
<?PHP phpinfo(); ?>
und speichern sie diese als [dateiname].php und [dateiname].php5 auf Ihrem Webspace. Wenn die diese Dateien dann im Browser aufrufen, werden Ihnen die PHP Informationen angezeigt, unter anderem die Versionsnummer. Wenn *.php5 nicht funktioniert, aber *.php mit PHP 5 oder höher verarbeitet wird, ändern Sie die Dateiendung der aufrufenden Seite in *.php um oder verändern Sie die Serverkonfiguration so, dass *.php5 Dateien mit PHP5 geparst werden. Sollten Sie Dateinamen verändern, müssen ggf. Links in den HTML-Dokumenten geändert werden (um-bestellformular/um-admin/left.html).
Fehlermeldung beim Speichern der Zugangsdaten: Vermutlich ist auf Ihrem Webspace "save_mode" aktiv. Das können sie auch mit phpinfo(); überprüfen. In diesem Fall sind die Schreibrechte nicht ausreichend, damit dieses Skript Dateien erstellen kann. Kontaktieren Sie Ihren Provider und lassen Sie save_mode deaktivieren.; Ist das nicht möglich, geben Sie dem Ordner um-bestellformular/um-data/ die Schreibrechte chmod 0777.; Wenn das nicht reicht, müssen Sie allen Dateien im Ordner um-bestellformular/um-data/ mit chmod die Rechte 0666 geben. Dann erstellen Sie eine Datei mit dem Inhalt:
<?PHP define("USER", "user"); define("PASS", "1a1dc91c907325c69271ddf0c944bc72"); ?>
und speichern sie diese unter um-bestellformular/um-data/logindata.php5. Dann geben Sie dieser Datei die Schreibrechte 0666 und können sich anschliessend mit "user" und "pass" einloggen und Ihre eigenen Zugangsdaten angeben.
Da sich dieses Problem fortsetzt, erstellen sie eine leere Datei um-bestellformular/um-data/art_liste_bak.php5 und geben auch hier die nötigen Schreibrechte 0666.
Warning: include_once() [function.include]: Failed opening: Vermutlich liegt die aufrufende Skriptdatei nicht im "SkriptRoot"-Verzeichnis, also in um-bestellformular/. Sie können gerne dieses Verzeichnis umbenennen, aber die untergeordneten Verzeichnisse müssen Ihren Namen behalten. Ebenso muss die eigentliche Datei, die im Browser aufgerufen wird in um-bestellformular/ liegen.
Zugangsdaten vergessen:: Sollten Sie einmal Ihre Zugangsdaten vergessen haben, löschen Sie die Datei um-bestellformular/um-data/logindata.php5 und rufen Sie das Admincenter erneut auf. Wenn diese Datei nicht existiert, können Sie erneut Zugangsdaten angeben.
Kann der Adminbereich auch per .htaccess geschützt werden?: Schützen Sie einfach den Ordner um-bestellformular/um-admin/. Das PHP Login können Sie deaktivieren, indem Sie in den PHP Dateien in diesem Ordner folgende Zeilen löschen:
include_once $pfad."um-login/auth.php";
Der Ordner um-bestellformular/um-login/ und die Datei um-bestellformular/um-data/logindata.php5 können in diesem Fall auch gelöscht werden.
Probleme mit Umlauten in den gesendeten Mails: Der verwendete Zeichenstz für die Mails ist ISO-8859-15. Dieser sollte auch für die Seite, die das Formular beeinhaltet angegeben werden. Alternativ kann in der Datei um-bestellformular/um-skript/bestform_classes.php5 in den Zeilen 383 und 398 ein anderer Zeichensatz angegeben werde, z.B. charset=UTF-8
Support:: Dieses Skript wird ohne Support zur Verfügung gestellt. Sollten sich bei der Installation für Sie nicht lösbare Probleme ergeben, kann ich trotzdem unter Umständen behilflich sein. Ein Anspruch darauf besteht jedoch nicht.
Sollten Sie eine Anfrage an mich richten, so geben Sie bitte eine aussagekräftige Problembeschreibung an.
Zitieren Sie auch die auftretenden Fehlermeldungen und geben Sie wenn möglich den Link zu der Seite bekannt.

In eigener Sache

Wenn Ihnen dieses Skript gefällt, würde ich mich über eine Nachricht freuen. Vielleicht werde ich Seiten, die dieses Skript einsetzen als Beispiele verlinken. Wenn Sie daran Interesse haben, lassen sie es mich wissen.

mit freundlichen Grüßen
Ulrich Fritz