TWebShop2

Aus OrgaMon Wiki
Zur Navigation springen Zur Suche springen

Überblick

TWebShop ist das Web-Gesicht des OrgaMon. Er ist in PHP geschrieben und konnektiert direkt auf die Datenbank des jeweiligen OrgaMon-Mandanten. Des weiteren ist der Webshop über ein XMLRPC Interface an einen ständig laufenden OrgaMon-Server-Prozess angebunden um eCommerce Funktionen im OrgaMon anzustossen. Somit bestehten keine Buchungsunterschiede ob Transaktionen direkt im OrgaMon oder über den Webshop durchgeführt werden.

Installation

Apache Webserver

Verwendete diesen Link vom apache 2.0 , da von 2.2 anscheinend noch keine Version für Windows vorliegt: http://apache.easy-webs.de/httpd/binaries/win32/apache_2.0.55-win32-x86-no_ssl.msi

  • Download auf dem Desktop speichern und ausführen.
  • bei Installation Standardeinstellungen verwenden
  • Hintergrund: der Apache-Webserver stellt die Anfrage an den Computer, dass andere Rechner auf diesen zugreifen können. Dies wird von der Windows-Firewall möglicherweise verhindert, worüber man auch informiert wird. Diese Nachricht beantworte man mit "nicht blocken", damit der Apache-Webserver voll funktionsfähig ist.
  • der Apache-Webserver sollte jetzt funktionsfähig sein (testen im Web-Browser mit eingabe von http://localhost)
  • zum Test ob der Apache-Webserver funktioniert, einfach im Internetexplorer "localhost" ein geben. Wenn der Server funktioniert, erscheint der Schriftzug:"Es klappt! (It Works!) Der Apache-Webserver ist auf dieser Website installiert.


  • Nach der Installation der Apache Software ist das Startmenü um einen Eintrag reicher.
 ->Dort kann man unter anderem die Apache-Konfigurations Datei "httpd.conf" editieren.
 ->die "httpd.conf"-Datei ist unter "Startmenü\Alle Programme\Apache HTTP Server(z.B.)2.0.55   \Configure Apache Server" zu finden.
  • den Eintrag "DocumentRoot=" sollte man auf das Verzeichnis setzen in dem die "index.html"

oder eine andere Index-Datei der Homepage liegt, die geservt werden soll.

 ->den Eintrag <Directory= > sollte man auf das gleiche Verzeichnis setzen.
  • Wir nehmen an, dass PHP auf dem Rechner im Verzeichnis "C:\Programme\PHP" installiert ist (siehe vorheriges Kapitel).
  • Jetzt wird die Apache-Konfigurations-Datei "httpd.conf" im Editor (Notepad) geöffet und

ans Ende werden(für PHP5) diese drei Zeilen eingefügt:

LoadModule php5_module "c:/programme/PHP/php5apache2.dll"
AddType application/x-httpd-php .php
PHPIniDir "C:/Programme/PHP"

Nach diesen Änderungen sollte PHP unter Apache laufen. Ob PHP funktioniert, sieht man, wenn man das im Anhang vorhandene Skript "phpinfo.php" aus dem Browser (nicht per Doppelklick) aufruft, während der Apache Server läuft. Dann wird eine Seite mit allen PHP-Informationen angezeigt. Auch der Pfad in dem PHP die "php.ini" erwartet.

  • Weitere Informationen zur Installation von PHP stehen in der Datei "C:\Programme\PHP\install.txt".


PHP

PHP-Systemvoraussetzungen:

  • >=PHP 5.1.0

Zusatzmodule, die nicht in der Standard-Installation aktiv sind

  • Modul: php5 mcrypt (Linux: kann man über yast hinzuinstallieren)
  • Modul: php5 interbase (Linux: mehr infos dazu in PHP)


OrgaMon XML-RPC Server

erster Login

Systemanforderungen beim Benutzer/Client

Der benutzte Browser muss Cookies annehmen und speichern. Das heisst es wird dem Browser im Moment des Login eine eindeutige Zeichenfolge übermittelt die Sie während einer Anmeldung immer als den gleichen Benutzer ausweist. Diese Cookies sind keine schädlichen Viren oder ähnliches und können problemlos aktiviert werden.

  • Internet Explorer

Extras->Internetoptionen->Datenschutz: Hier sollte die Stufe "Mittel" eingestellt sein.

  • Mozilla Firefox

Starten Sie den Firefox
Wählen Sie das Menü - Extras - Einstellungen
Dann den Reiter "Datenschutz" - Cookies
Dort setzten Sie den haken "Cookies akzeptieren"

Kontrolle, ob der Mozilla die Cookies akzeptiert: Extras->Einstellungen->Reiter "Datenschutz"->Cookies anzeigen->Als Suchbegriff "hebu" eintragen->Es müssen 2 Cookies angezeigt werden->"c_user" und "PHPSESID" mit der Gültigkeit "c_user"=24 h und "PHPSESSID"=Bis zum Ende der Sitzung.


i_config.inc.php5

<?php

define("TWEBSHOP_ID","01");
define("TWEBSHOP_TITLE","Neu WebShop");
define("XMLRPC_HOST","OrgaMonPC");
define("XMLRPC_PORT","3049");
define("XMLRPC_NAMESPACE","abu");

define("EMAIL_ADMIN","ich@schopbetreiber.de");

include_once("i_default_config.inc.php5");

?>

  • Es reicht also die folgenden 5 Einstellungen vorzunehmen. Alle weiteren Einstellungen werden vom OrgaMon über die Funktion "BasePlug" übermittelt.

connections.php.inc

 # 
 # 
 define ("eMailDevelopment","phpfreak@domain.tld");
 define ("eMailWebmaster","phpfreak@domain.tld");
 define ("eMailShop","phpfreak@domain.tld");
 define ("eMailMiniScore","phpfreak@domain.tld");

der Webshop sucht die Person, die im Feld EMAIL die angegebene eMailAdresse eingetragen hat.

in der Regel benutzt der WebShop das Mail-Out System des OrgaMon. Falls es irgendwann wieder Probleme mit dem Maildienst geben sollte, der WebShop kann per Konstante (true/false) auf SMTP Mail aus eigener Kraft umgestellt werden, sofern die Zugangsdaten in der connections.inc.php korrekt sind.


Shop Interna

Datei Nameskonventionen

  • index.php5: Zentrales und einziges PHP-Skript das Apache direkt anspricht
  • a_*.inc.php5 : a für ACTION, die vom User angestossen wird (z.B. Artikel in den Einkaufswagen legen, Bestellung abschicken,...)
  • i_*.inc.php5 : i für INCLUDE: eine Datei, die keinen Code ausführt, sondern nur (Funktions- oder Konstanten-) Definitionen enthält
  • p_*.inc.php5 : p für PHP: eine Datei, die einen Code für einen bestimmten Zweck (*) ausführt
  • l_*.inc.php5 : l für LANGUAGE: eine Datei, die Sprachbausteine für die Sprache * enthält
  • s_*.inc.php5 : s für SITE, enthält den auszuführenden Code für die Seite *
  • t_*.inc.php5 : t für THORSTEN (in Anlehnung an TVISION von Borland Pascal 7.0): eine Datei, die eine oder mehrere Klassendefinition(en) enthält

In einem Unterverzeichnis von Template:

  • i_template.inc.php5 : enthält den Namen des Templates
  • i_template_*.inc.php5 : eine i_*.inc.php5, die Templates für die jeweilige Klasse * enthält
  • s_*.html : Template für s_*.inc.php5, also das Template der Seite *
  • h_*.html : ein Header-Template
  • f_*.html : ein Footer-Template

Template-System

Überblick

der WebShop kann durch Benutzerspeziefische Templates in seiner Erscheinung angepasst werden. In der Standard-Konfiguration läuft der shop mit dem Template "twebshop". Templates heissen so wie das Verzeichnis, in das sie installiert sind. Templates befinden sich im Unterverzeichnis "templates" der WebShop Installation.

Setup

Beim Setup eines Templates muss der gesamte Pfad des Templates angegeben werden. Läuft ihr Shop also auf "W:\Stage1\" so muss im Rahmen der Installation "W:\Stage1\templates\NameDesTemplate" angegeben werden. Auch in der ...

i_config.inc.php5 

define("TWEBSHOP_TEMPLATE","NameDesTemplate");

... muss der Name des Templates angegeben werden

Internas

die s_myshop.html gehört ja zum Template.

Es gibt dieses (Standard-)TWebShop-Template, es gibt ja aber auch das Orgamon-Template, das die Tickets beherrscht und oben links halt das OrgaMon-Logo anzeigt. Du hast jetzt als Basis für die s_myshop.html das TWebShop-Template benutzt. Habe die alte und neue Version dieser Datei mal mit DiffMerge verglichen, da sind ja nur ein paar Zeilen dazugekommen. Soll ich diese Zeilen in die s_myshop.html des OrgaMon-Templates einbauen ?

Namespace - System

man kann mehrere WebShops an einem OrgaMon-Mandanten betreiben. Der Artikelumfang der Shops wird über verschiedene System-OLAPs gesteuert.

System.WebShop.~Namespace~.OLAP.txt
  • ~Namespace~ ist ein Parameter in den WebShop Systemeinstellungen
  • ohne OLAPs wird nur noch der "interne" Suchindex erzeugt, er ist für die globale Beleg-Suche.
  • alle anderen Suchindex sind auf die WebShop-Artikel beschränkt egal wie das OLAP ausfällt.
  • bei "2" im Namespace wird der eingeschränkte Wortraum (nur mit LAUFNUMMER) bei der Erzeugung benutzt.

Damit das alte System wieder läuft gibt es also 2 OLAPs

  1. "abu"
  2. "abu2"

die alle RIDs enthalten (- die WebShop-Drückeberger)

Allen Webshop-Suchindizes-OLAPs für die ist ein "Rote Liste"-OLAP vorgeschaltet:

   select 
    ARTIKEL.RID 
   from 
    ARTIKEL 
   where 
    (ARTIKEL.WEBSHOP='N') or 
    (ARTIKEL.SORTIMENT_R in (select RID from SORTIMENT where WEBSHOP='N'))

Änderungen / Erwiterungen programmieren

  • schaue oben in der Internet-Adresse was bei "Site=" und "SubSite=" angegeben ist, dann suche ...
  • ... die Datei s_~Site~_~SubSite~.php5
  • ... suche den Abschnitt, um den es geht, bei mir war das $user->getBills();
  • hm, getBills mach einen grep
  • ... ich fand es in ./classes/t_webshoP-user.inc.php
  • ... ich fand twebshop_bill, machte einen grep
  • ... ich fand es in t_webshop_bill.inc.php5 ...
  • ich merkte, dass im Kontruktor die Teillieferung fehlt
  • ich wollte RECHNUNGSNUMMER zu den Properties hinzufügen, doch dies ist keine 1:1 Beziehung zwischen Feldname im select und die Art wie ich da dran kommen. Also das Feld heisst RECHNUNGSNUMMER ich komme aber mit Hilfe eines (select ...) as RECHUNGSNUMMER dran. Deshalb ...
  • ... muss es ein properties1 hinzugeben
  • obwohl es die Infrastruktur für die properties gibt werden diese nicht automatisch in die templates gepustet -> kann man da was tun
  • Das .\Template für die "bill" musste ich nun ändern (Ergänzen um "RECHNUNGSNUMMER")

Betrieb und Wartung

Kontext-Links des Shops

Kontext-Links von aussen : der OrgaMon/ein Mailung ruft den WebShop, dafür gab es bisher folgende Standards, die gehen alle nicht mehr:

BEDEUTUNG             BISHER                                             NEU
Such-Anfrage          web_search.php?expression=~SuchStr~                ?site=search&action=search_user_expression&f_search_expression=henn
Login                 login.php?email=~eMail~&key=~Password~&login=      ?site=login&action=login&f_user=thorsten.schroff@orgamon.org&f_pass=nase
Pwd-Anforderung       new_user_password.php?email=&reg=+++Ok+++          ?action=send_password&f_user=thorsten.schroff@orgamon.org
Artikel-Anzeige       <war nicht möglich>                                ?site=article&id=192713
Verfügbarkeits-Check  <war nicht möglich>                                ?site=test&info=

Bilder des Shops

Bilder werden über die Funktion TPicUpload direkt in den Shop hochgeladen.

~ShopPfad~ + "upload/" + DOKUMENT_R + ( "th.jpg" | ".jpg" )

ist der Dateiname des Bildes, fall DOKUMENT.ARTIKEL_R passt.

Fragen & Antworten:

  • Q wer erzeugt bei Bildneuanlage eigentlich einen neuen Eintrag in der Tabelle "DOKUMENT" ?
  • A tpicupload.php5 des Shops
  • Q wer schiebt das Bild in den Shop?
  • A die Taste TpicUpload des OrgaMon
  • Q wie prüft der Shop ob ein img-Tag erzeugt werden kann oder nicht?
  • A keine Prüfung, es wird darauf vertraut dass es klappt
  • Q erfolgt ein Abgleich / Problembericht für "verwaiste" oder "fehlende" Bilder?
  • A JA, mit FileZilla: ich habe mit dem Open-Source FileZillaClient (installiert auf Gates) das ganze W:\twebshop\images hoch geladen nach "http://hebu-music.de/twebshop/images/" FileZilla ermöglicht es bereits vorhandene Dateien zu überspringen, es lässt sich also eine primitive Variante eines Verzeichnisabgleichs programmieren. So ab und an sollte man die Aktion nun ausführen.
  • Q können wir schon auf einen externen image-url verweisen?
  • A JA, der Pfad entspricht schon jetzt dem Baseplug-Parameter 12. Aus der Sicht des OrgaMon ist das der Parameter ShopArtikelBilderURL=http://hebu-music.de/twebshop/images/upload/, der wie man an diesem Beispiel sieht bis hin zu den Bildern an sich formuliert werden muss.
  • Q können wir Shop-Eigene Bilder auf eine externe URL umlenken?
  • A NEIN, Der PNG-Pfad wird in der Datei i_global_const.inc.php5 als Konstante definiert.

Hierzu sollte ich erwähnen, dass bei TWebShop-eigenen Grafiken immer die Existenz der Datei überprüft wird. Mein (möglicherweise nicht hochaktuelles) Halbwissen sagt mir, dass dies bei externen URLs durch einen php.ini-Eintrag ermöglicht werden muss. Da hab ich jetz mal nicht weiter nachgehakt, denn ich habe 2 weitere Gründe für das Belassen der TWebShop-eigenen Grafiken beim Shop:

bei mehreren Namespaces MÜSSEN wir meiner Meinung nach eine externe Artikel-Image url anbieten (die ggf. lokal liegen kann), da sonst alle ./images/upload-Verzeichnisse gedoppelt werden müssten. Oder mit einem Symbolischen Link unter linux versehen werden müssen. Im Moment wäre mir so ein H:\delphi\Bilder\ irgendwie sympatisch ...



Apache konfigurieren

Icon des Shops

Ausführliche Infos gibts dazu in "http://www.favicons.de/"


Virtual Hosts unter Confixx Webserver

joe /etc/httpd/confixx_vhosts.conf

die entsprechende php direktive open_basedir muss auskommentiert werden.

#php_admin_value open_basedir ...

NeueSubDomain.host.tld

wir gehen so vor, dass der Webshop auf einer Subdomain erreichbar ist. In diesem Fall "neu". Bei Subdomain treffer.de, ist der Shop-Einstieg also über http://neu.treffer.de erreichbar.

Auf dem Linux-Apache2-Server

  • Einen smb-Share auf \srv\www\ legen
  • Einen subdomain auf das Shopverzeichnis lenken:


Datei /etc/apache2/vhosts.d/neu.hebu-music.com.conf anlegen
<VirtualHost *:80>

ServerName neu.hebu-music.com
ServerAlias neu.hebu-music.com
ServerAlias neu.raib181
DocumentRoot /srv/www/htdocs/neu
HostnameLookups Off
UseCanonicalName Off

</VirtualHost>

"neu" kann natürlich durch jeden anderen subdomain ersetzt werden.

Auf einem Windows-Arbeitsplatz

  • Über Windows das Setup-TWebShop_Dev-1.027.exe (aktueller Entwicklungsstand [hier]) ausführen, z.B. in das Verzeichnis "neu"
  • Nun die Konfigurationsdatei editieren.

hebu2008

für alle 3 Templates gilt:

  • linker Rand nicht so breit

Stage1

  • neuen Namen suchen (->Alexander)

Stage2

  • neuen Namen suchen (->Alexander)

Stage3

  • neuen Namen suchen (->Alexander)

to do

  • TS: statische ArtikelMembers-Klasse mit eigenen Templates
  • TS: Verbesserung Katalog-Seite
  • Klick man auf einen Katalog muss wieder eine Suchtrefferliste ausgegeben werden mit den bisherigen Detail-Infos, Problem: "Statische Teilnehmer"
  • Statische Teilnehmer die leer sind bewirken ein FETT Attribut für die kommenden Titel
  • Bug: zwischen "Tonträger" under dem CD Symbol ist kein Nbsp

Andreas

  • LETZER_VERKAUF, z.B. 13748321 wird das gepflegt, wenn ja wie?