Special Boxes

Mit dem Modul Special Boxes können Sie relativ einfach template-abhängige Boxen erzeugen und darin  Artikel, Kategorien, Hersteller, Standard-Inhalte sowie spezielle Inhalte anzeigen und kombinieren.

Im Einzelnen können Sie:

• mehrere Boxen gleichzeitig anzeigen
• mehrere Artikel, Kategorien, Hersteller, Standard-Inhalte oder spezielle Inhalte je Box anzeigen
• Artikel, Kategorien, Hersteller, Standard-Inhalte oder spezielle Inhalte zufällig anzeigen
• Produktdetails individuell anzeigen und anordnen
• alle Kategorieattribute anzeigen und frei anordnen
• alle Boxen individuell gestalten
• zusätzliche Boxen auch im Nachhinein installieren

Änderungen in Version 1.3.1

Es lassen sich nun mehrere Boxen mit dem gleichen Key anlegen. Welche dieser Boxen dann angezeigt wird, bestimmt die Kategorie-Zuordung für Box bzw. Box-Content.

Dieses Verhalten lässt sich auswählen über den neuen Konfigurationspunkt “Rück-fall-Ebene für doppelte Box-Keys aktivieren”. Ist dieser ausgewählt, wird bei mehr-fachen Box-Keys geprüft, welche Box genau angezeigt werden soll. Und zwar an-hand der Kategorie-Zuweisung bei den Boxen mit dem gleichen Box-Key und ob zu diesen Boxen Box-Inhalte (inkl. deren Kategorie-Zuweisung) angelegt sind. Wird eine passende Box gefunden, wird diese angezeigt. Wenn keine Box gefunden wird, greift das Standard-System.

Änderungen in Version 1.4.0

• Anlegen freier Contents möglich
• verbesserte Template-Auswahl für Boxen-Elemente und Seiten-Elemente

Änderungen in Version 1.4.1

Bei Kategorien, die als “Box-Inhalt” angelegt wurden, lässt sich nun festlegen, dass anstelle der Kategorie deren Artikel in der Box angezeigt werden. Dabei lässt sich auswählen, ob die Artikel der Kategorie mit oder ohne den Artikeln etwaiger Unterkategorien angezeigt werden sollen.

Systemvoraussetzung

Systemvoraussetzung für die aktuelle Plugin-Version ist xt:Commerce Veyton ab Version 4.0.13.

Plugin-Versionen für ältere Shopversionen sind in der Regel nicht kompatibel mit xt:Commerce Veyton 4.0.13.

Testversion

Dieses, wie alle unsere Plugins für xt:Commerce VEYTON, können Sie 21 Tage kostenfrei testen. Falls wir Ihnen eine Testlizenz des Plugins zusenden sollen, wenden Sie sich bitte über dieses Kontakt-Formular an uns.

Wir freuen uns, dass Sie sich für eines unserer Module entschieden haben.

Unsere Module sind sehr leicht in wenigen Schritten zu installieren. Sie können dessen ungeachtet zu jeder Zeit den Installationsservice nachbestellen. Eine kurze E-Mail an info@bui-hinsche.de mit Angabe der Bestellnummer reicht dazu aus.

Bei Bestellung unseres Installationsservices

Für die Installation unserer Module benötigen wir zusätzlich folgende Daten von Ihnen:

1. die URL des Shops
2. FTP-Zugangsdaten (Server, Username, Passwort)
3. Datenbankzugangsdaten (Datenbankserver, Datenbankname, Username, Passwort)
4. Shopadmin:
   a) E-Mail-Adresse, Passwort (bis Version 3.0.4 SP2.1) oder
   b) Benutzername, Passwort (ab Veyton 4.0)

Senden Sie diese Daten am besten gleich bei Beauftragung des Installationsservice mit.

Nicht im Installationsangebot enthalten sind jegliche programmiertechnischen und grafischen Anpassungen, die nichts mit der Einbindung des Moduls zu tun haben. Diese führen zu einem zusätzlichen Auftrag, für die wir Ihnen gerne ein separates Angebot unterbreiten.

Eigene Installation

Wichtige Vorbereitung

Vor der Installation eines Moduls oder Plugins die Datensicherung nicht vergessen!

Besonders wichtig: die Shopdatenbank!

Installation

1. Plugin entpacken und per FTP in den Ordner Plugins des Veyton-Shops laden.
2. Die beiliegende Lizenzdatei in den Ordner /lic des Shops laden.
3. Im Adminbereich des Shops das Plugin unter Inhalte -> deinstallierte Plugins installieren.
4. Im Adminbereich das Plugin unter Inhalte -> installierte Plugins aktivieren (auch die jeweiligen Mandanten) und konfigurieren.
5. Den kompletten Adminbereich mit F5 neu laden lassen.

Damit haben Sie das Plugin installiert. Um Special Boxes anzuzeigen, müssen Sie noch Ihr Template anpassen.

Einstellungsmöglichkeiten beim Aktivieren des Plugins

Plugin-Status: aktiviert das Plugin generell

Status: aktiviert das Plugin für den jeweiligen Shop

Rückfall-Ebene für doppelte Box-Keys aktivieren: wählt bei gleichen Box-Keys die Box entsprechend der Kategorie

Kategorieabhängigkeit bei Box-Content auf Unterkategorien übernehmen: selbsterklärend

Kategorieabhängigkeit bei Box auf Unterkategorien übernehmen: selbsterklärend

Seite aktivieren: generiert aus den Box-Inhalten eine Seite, die über einen Link innerhalb der Special Box erreichbar ist

Anlegen von Special Boxes

Das Plugin erzeugt im Admin unter Shop einen Menüeintrag Special Boxes mit den Unterpunkten Boxen verwalten und Freier Content. Unter Letzterem können Sie unabhängige Inhalte anlegen, die Sie dann in Special Boxes einbinden können. Über Boxen verwalten legen Sie Special Boxes neu an und bearbeiten sie.

Box-Key: Hier geben Sie eine Zeichenfolge ein, mit der Sie die Special Box später aufrufen möchten.

Anzahl angezeigter Boxelemente: Das betrifft die Elemente, die Sie unter Box-Inhalte ausgewählt haben (siehe unten).

Zufallsanzeige: Box-Inhalte können nach dem Zufallsprinzip angezeigt werden. Wenn Sie zum Beispiel insgesamt 30 Box-Inhalte ausgewählt haben und im Feld Anzahl angezeigter Boxelemente den Wert 5 eingetragen haben, werden fünf Elemente zufällig aus den 30 angezeigt.

Info: Für interne Informationen. Eine Eingabe ist nicht notwendig.

Box-Status: aktiviert die Special Box

Template-Aufruf: Der Code, mit dem die Special Box im Template aufgerufen werden kann. Der oben eingetragene Box-Key wird beim Speichern automatisch übernommen. Sie müssen Ihn also nicht von Hand eintragen.

Zuweisen von Box-Inhalten

Den Special Boxes können Sie Inhalte zuweisen:

• über das Icon Boxinhalte in der Listenansicht der Special Boxes (Bild oben)
• im Bearbeitungsfenster einer Special Box über das Menü Bearbeiten -> Box-Inhalte hinzufügen
• im Bearbeitungsfenster einer Special Box über den Button Box-Inhalte hinzufügen

Als Box-Inhalte können Sie Artikel, Kategorien, Hersteller, Contents und Freie Contents hinzufügen. Freie Contents legen Sie im Admin an unter Shop -> Special Boxes -> Freier Content.

Um eine Box im Template aufzurufen, fügen Sie an gewünschter Stelle folgenden Code ein:


{hook key=vt_special_boxes box_key=XYZ}


Beim Anlegen der Box kann für jede Box ein Code festgelegt werden. Mit diesem Code ersetzen Sie das XYZ.

Sie finden unten eine Schritt-für-Schritt-Anleitung für ein Update, bei dem bereits angelegte Daten übernommen werden sollen. Alternativ können Sie die neue Plugin-Version ohne Datenübernahme installieren. Für das unten beschriebene Updaten mit Datenübernahme empfehlen wir Erfahrungen und einen sicheren Umgang mit Datenbanken sowie eine sichere Bedienung des Shops im Bereich Plugins und Hookpoints. Natürlich können Sie auch uns mit dem Update beauftragen.

Systemvoraussetzung

Die Versionen ab 1.4.0 sind kompatibel mit xt:Commerce Veyton ab Version 4.13. Ob das Plugin mit früheren Versionen kompatibel ist, können wir auf Anfrage beantworten.

Geänderter Plugin-Code

Beachten Sie den geänderten Plugin-Code, zum Beispiel beim Einbinden der Special Boxes im Template.

Alter Plugin-Code: bui_special_boxes
Neuer Plugin-Code: vt_special_boxes

Update-Schritte

1. Datensicherung

a) Datenbank-Sicherung

Sichern Sie im phpMyAdmin einmal die komplette Shop-Datenbank und einmal die Plugin-Tabellen (enthalten plg_bui_special_boxes im Namen).

b) Datei-Sicherung

Sichern Sie die Shop-Dateien (besonders wichtig sind die Ordner lic, plugins, templates und plugins/bui_special_boxes).

2. Installation des neuen Plugins

Installieren Sie das neue Plugin wie andere Plugins auch, beachten Sie aber, das Sie nach der Installation das Plugins noch deaktiviert lassen.

3. Übernahme der Daten aus dem alten Plugin in das neue Plugin

Stellen Sie zunächst sicher, dass beide Plugins im Shop deaktviert wurden (Haken bei der Einstellung Plugin Status darf nicht gesetzt sein!)

a) Umbenennen der Tabellen

Benennen Sie in der Datenbank die Tabellen des neuen Plugins um, die plg_vt_special_boxes im Namen enthalten, indem Sie _org an den Tabellen-Namen anhängen.

Benennen sie die Tabellen um, die plg_bui_special_boxes im Namen enthalten, indem Sie das bui im Namen durch vt ersetzen.

Spielen sie anschließend das Datenbank-Backup, in dem Sie nur die Plugin-Tabellen des alten Plugins gesichert haben, wieder ein.

b) Anpassen der Tabellen-Struktur der neuen Plugin-Tabellen

Da die alte Plugin-Version weniger Tabellen besitzt als die neue Version, müssen die neu angelegten Tabellen, die in der alten Version nicht enthalten waren, wieder umbenannt werden. Alle Tabellen, die in der alten Version nicht enthalten waren, müssen wieder mit dem ursprünglichen Namen versehen werden. Das heißt, das vorhin hinzugefügte _org muss bei diesen Tabellen wieder entfernt werden.

Öffnen Sie die Install-XML des neuen Plugins (vt_special_boxes/installer/vt_special_boxes.xml).

Überprüfen Sie die Tabellen-Struktur der neuen Plugin-Tabellen an Hand der Install-XML des neuen Plugins, ob diese mit der aktuellen Version übereinstimmt und nehmen Sie die evtl. nötigen Aktualisierungen vor.

4. Aktualisierung der Plugin-Hookpoints

Gehen Sie in den Admin-Bereichs Ihres Shop auf: Inhalt/Plugins/installierte Plugins/vt_special_boxes/Hookpoints.

Vergleichen Sie, ob alle Hookpoints, die in der Install-XML angegeben sind, auch im Admin-Bereich beim Plugin angelegt sind bzw. ob auch der entsprechende Code im Hookpoint steht.

5. Aktualisierung der Templates und der Box-Hookpoints

Passen Sie die angelegten Boxen an und ändern Sie im Feld Template-Aufruf die Bezeichnung bui_special_boxes in vt_special_boxes.

Die gleiche Änderung müssen Sie nun noch in Ihren Shop-Templates durchführen.

6. Test

Aktvieren Sie das neue Special-Boxes-Plugin und testen Sie, ob alles korrekt angezeigt wird.