Inhaltsverzeichnis

1. Vorwort Inhalt

Steter Tropfen, so sagt man, höhlt den Stein, und ja, so auch bei mir. Deswegen, ohne viele Umschweife, das hochgelobte und vielseits im Einsatz befindliche Getränkebuchungssystem „TUMdrinks“ firmiert jetzt unter einem anderen Namen, „csDrinks“. Natürlich verstehe ich, dass der Name TUM (für Technische Universität München) und die jeweiligen Grafiken nicht einfach so verwendet werden dürfen, und nachdem man an mich herantrat und bat, das zu ändern, möchte ich der Bitte gerne entsprechen.

Blumiger Worte Kurzer Sinn: TUMdrinks heißt jetzt csDrinks. Und hat ein neues Logo bekommen.

Damit noch nicht genug, es erreichen mich immer wieder einmal Anfragen hinsichtlich einer Veröffentlichung des Quelltextes, und ja, vom Drauf-Sitzen-Bleiben habe ich wirklich nichts. Daher hier mein Entschluß, csDrinks als Beerware (extended) zu veröffentlichen.

2. Bedingungen Inhalt

Ihr dürft unter den folgenden Bedingungen csDrinks für eure eigenen Abteilungen und Kühlschränke benutzen und nach Belieben anpassen und erweitern:

• Nicht-Kommerziell: Weder csDrinks oder Teile hiervon werden von euch kommerziell, z.B. in euren eigenen Produkten, eingesetzt. Ihr verdient durch csDrinks kein Geld.
• Urheberschaft: Footer bleibt in der Form „basiert auf csDrinks von Christoph Söllner“ mit Link erhalten oder die Urheberschaft wird mit Link vergleichbar irgendwo anders auf den Seiten kenntlich gemacht. Das Logo dürft ihr natürlich austauschen.
• Keine Garantie („provided as-is“): Ich kann wirklich keine Garantie darauf geben, dass die Software sicher ist oder für eure Zwecke paßt. Ihr könnt PHP und modifiziert sie selbst nach Euren Vorstellungen.
• Beerware: Wenn euch die Software gefällt und Ihr sie vollständig oder in Teilen einsetzen möchtet, würde ich mich pro Kühlschrank und Jahr über ein Sixpack lokales Bier freuen. Aktuelle Adresse findet ihr im Impressum auf der Webseite.

3. Installation Inhalt

Widmen wir uns kurz der Installation, für die ihr euch einen PHP-MySQL-Rechner (LAMP, XAMP, …) schon installiert habt. Weiterhin habt ihr auf dem MySQL-Server eine leere Datenbank mit Proxy-User (der Vollzugriff hat) eingerichtet, es eignet sich dazu der PHPmyAdmin am besten, oder nehmt ein anderes Tool eurer Wahl.

1. Kopiert den Inhalt dieses ZIPs (Source-Code for csDrinks) in den htdocs-Ordner eures Servers.
2. Ladet diese SQL-Scripte herunter (SQL-Code für Struktur, beispielhafte Artikel, Benutzer und Preise) und entpackt sie in einen Ordner. Dann haltet euch an diese Schritte:
   • Zuerst bearbeitet ihr die struktur.sql, in der Tabelle „benutzer“ tragt ihr die Bezeichner der Organisationen einen, die es bei euch gibt, beispielhaft sind unsere drei F13, I20 und AISEC eingetragen. Führt den SQL-Code aus, alle Tabellen sollten erzeugt sein.
   • Dann könnt ihr die drei anderen Scripts ausführen, sie erzeugen Artikel, einen Preis für „Einzahlung“ und ein Kassenwart-Benutzer mit Login kassenwart@local und Paßwort none für das Webinterface.
3. Kopiert /config/sysconfig_sample.php nach /config/sysconfig.php und paßt dort die Daten für MySQL-Zugriff und Mailversand an.
4. Richtet einen Cron-Job ein, der php mit /kw_email_cron.php täglich aufruft um z.B. 17:00 Uhr und gebt als Kommandozeilenparameter „OK“ an.
5. Stellt sicher, dass /kw_email_cron.php unter gar keinen Umständen aus dem Web aufgerufen werden darf (auch wenn es durch „OK“ als Parameter verhindert werden sollte).
6. Editiert /kw_email_cron.php, Zeile 73, und paßt die URL und ggf. den Mailtext an.

4. Konfiguration Inhalt

Sodann ist die Software einzurichten, wobei dies über das Webinterface erledigt werden kann. Beachtet auch, dass eine Hilfe-Funktion existiert. Ihr findet sie im Webinterface oben unter „Hilfe“ auf den meisten Seiten.

1. Tragt zunächst eure Benutzer und ihre Daten ein. Es wird keine Historie über die Benutzer geführt, wenn einer ausscheidet, sollte er auf inaktiv gesetzt werden, und er verschwindet damit aus den Listen. Löschen von Benutzern ist nicht vorgesehen. Hey, ist für kleine Abteilungen gedacht.
2. Ergänzt die Artikel um die Artikel, die ihr bei euch habt. Ihr könnt auch ein kleines Bild zu jedem Artikel speichern.
3. Paßt auf der Preise-Seite die Preise für jeden (buchbaren) Artikel an bzw. tragt diese initial ein.

5. Scanner-Interface Inhalt

Für den Rechner neben dem Kühlschrank bietet sich ein gewöhnlicher CCD-Scanner (oder Laser-Scanner) an, der sich per USB als Tastatur anmeldet und nach dem Code automatisch die ENTER-Taste drückt. Auf dem Kassenrechner läuft ein Webbrowser im Vollbildmodus, der einfach die Seite /bcscanner.php anzeigt. Per JavaScript bleibt der Fokus im Eingabefeld; alles weitere wird über den Scanner gesteuert.

Im oben verlinkten Artikel steht allerdings noch mehr Beschreibung, lest da einfach nach bei Bedarf.

In diesem Sinne, Kommentare sehr willkommen, Happy Scanning.