XH-Shop

Voraussetzungen

• CMSimple_XH ≥ 1.6.3
• PHP ≥ 5.3.0
• Plugin FA_XH (ist ab CMSimple_XH 1.7 schon dabei)
• Plugin FancyBox wird empfohlen – der Shop funktionier aber auch ohne.

Installation

1. Sichere deine CMSimple_XH-Installation von deinem Server (Sicherheitskopie).
2. Entpacke das heruntergeladene ZIP-Archiv auf deinem Computer.
   
   

Nach dem Entpacken findest du 3 Ordner vor: content, plugins und userfiles. Diese Ordner repräsentieren die Zielordner deiner CMSimple_XH-Installation – das heißt, die Inhalte dieser Ordner müssen in die entsprechenden Ordner deiner CMSimple_XH-Installation kopiert werden.

Der Ordner content
Kopiere den darin enthaltenen Ordner xhshop komplett in den Ordner content deiner CMSimple_XH-Installation. Dieser Ordner enthält die catalog.php mit allen Daten aller Shop-Artikel und Kategorien, die zur Demonstration ausgeliefert werden. Die Speicherung im Content-Ordner hat den Vorteil, dass die Daten bei einer Neuinstallation oder einem Update des Shops erhalten bleiben. Außerdem enthält dieser Ordner einen weiteren: tmp_orders, der zur Zwischenspeicherung temporärer Daten bei PayPal-Bestellungen dient.

Der Ordner plugins
Kopiere den darin enthaltenen Ordner xhshop komplett in den Ordner plugins deiner CMSimple_XH-Installation. Dieser Ordner enthält das XH-Shop-Plugin. Sorge hier für Schreibrechte (0755) für die Unterverzeichnisse config/, css/ und languages/.

Der Ordner userfiles
Kopiere den darin enthaltenen Ordner images/shop/ komplett in den Ordner userfiles/images/ deiner CMSimple_XH-Installation. Dieser Ordner enthält Beispielbilder, die zur Demonstration ausgeliefert werden. Du kannst diese Demo-Bilder später entfernen, sobald du eigene Artikel mit eigenen Bildern angelegt hast.

Administration

Einstellungen

Admin-Menü: Plugins ⇒ xhshop ⇒ Konfiguration.

Hier kannst du die vorhandenen Beispiel-Einstellungen des Shops ändern. Beim Überfahren der Hilfe-Icons (?) mit der Maus werden Hinweise zu den Einstellungen angezeigt.

Sprache

Admin-Menü: Plugins ⇒ xhshop ⇒ Sprache.

Sämtliche Texte, die durch das Plugin im Frontend oder im Backend ausgegeben werden, sind hier zu finden und können – abhängig von der gerade verwendeten Sprache – geändert werden.

Einige besondere Link-Adressen (z.B. die Shop-Hauptseite, die AGB und die Versandkosten) werden hier festgelegt (gleich oben im Abschnitt Config). Auch die Einstellungen für Dezimal-Punkt/-Komma und Tausender-Trennzeichen erfolgen hier für den gesamten Shop.

Stylesheet

Admin-Menü: Plugins ⇒ xhshop ⇒ Stylesheet.

Die CSS-Styles des XH-Shops können hier angepasst werden.

Einen Shop eröffnen

Logge dich in CMSimple_XH ein und erstelle mit dem Pagemanager (Adminmenü ⇒ Seiten) eine neue Seite Shop. Auf dieser Seite gibst du den Pluginaufruf ein. Der „normale“ Aufruf für den XH-Shop lautet:

{{{display_shop();}}}

Hinweis: Wenn du den Code von hier kopierst, dann musst du im Editor vor dem Einfügen „Als Text einfügen“ wählen. Am Ende sollte der Aufruf in der html-Ansicht des Editors so aussehen:

<div>{{{display_shop();}}}</div>

Es ist problemlos möglich oberhalb oder unterhalb dieses Aufrufes andere Elemente auf der Shop-Seite zu platzieren.

Shop-Templates

Die html-Ausgabe des XH-Shops wird komplett über Templates gesteuert. Diese sind zu finden im Plugin-Ordner /templates.

Wenn du lieber die Originaldateien nicht verändern möchtest – und das solltest du wirklich nur mit äußerster Vorsicht tun –, dann kopiere einfach die gewünschten Dateien (zum Beispiel für das Frontend) in den Ordner xhshop/theme/frontend/. Mit diesen Dateien kannst du gefahrlos experimentieren. XH-Shop wird bei jedem Aufruf schauen, ob Dateien in diesem Ordner vorhanden sind. Falls ja, wird er diese Dateien vorrangig für die Ausgabe verwenden. Ist etwas schief gegangen, kannst du deine veränderten Dateien umbenennen oder entfernen – der XH-Shop wird dann wieder die Original-Dateien verwenden.

Weitere Hilfe

Der XH-Shop ist klein, fein und simpel – aber nicht trivial. Es ist nicht möglich in dieser Hilfedatei sämtliche Funktionen und Optionen zu beschreiben. Deshalb wurde ein Wiki eingerichtet, das von mehreren Autoren bearbeitet werden kann und allen Nutzern zur Verfügung steht. Hier die Adresse:

https://github.com/cmsimple-xh/xhshop/wiki

Falls du auf Fragen stößt, die im Wiki noch nicht behandelt wurden, dann stelle diese im CMSimple_XH-Forum, wo fast immer schnell und kompetent geantwortet wird:

https://cmsimpleforum.com/

Dank

Außerordentlicher Dank gebührt Martin Damken – zeichenkombinat.de, der den Shop unter dem Namen wellrad-Shop ursprünglich entwickelte. Besonders dankbar sind wir für seine Genehmigung, den Shop unter anderem Namen mit der CMSimple_XH-Community weiter zu entwickeln.

Die erste neue XH-Shop-Version, basierend auf dem wellrad-Shop 1.2.1, entstand unter wesentlicher Mitwirkung von Christop (cmb), Albert (albert) und Frank (frase) – Dank dafür.

Auch wenn schon genannt, Christoph (cmb) muss an dieser Stelle besonderer Dank ausgesprochen werden. Er hat die Haupt-Programmierarbeit übernommen und für eine bessere CMSimple_XH-Integration gesorgt.

Zu guter Letzt vielen Dank an Peter Harteg, den Vater von CMSimple, und allen Entwicklern von CMSimple_XH, ohne die dieses fantastische CMS nicht existierte.

Lizenz

Der XH-Shop kann unter Einhaltung der GPLv3 verwendet werden.

© 2017 The CMSimple_XH community.