Plugin-Funktionen

Artikelpreise als Bilder ist ein Plugin für xt:Commerce 4 zur grafischen Darstellung von Preisen.
In individuell gestalteten Online-Shops können die Preise interessante typografische Akzente setzen. In der Regel werden Preise vom Shop-System als HTML-Texte ausgegeben. Mit der bildlichen Ausgabe als PNG, GIF oder JPEG ergeben sich jedoch mehr gestalterische Möglichkeiten. Template-Designer können Ziffern, Trennzeichen, Währungssymbole sowie verkleinerte Nachkomma-Ziffern frei entwerfen und als Grafiken im System hinterlegen. Mit dem Modul Artikelpreise als Bilder greift das Shop-System dann bei der Preis-Darstellung auf jene hinterlegten Grafiken zurück und setzt die Ziffern, Trennzeichen und Währungs-Symbole zum jeweiligen Artikelpreis zusammen.

Das Plugin funktioniert bei den üblichen Artikelpreisen, nicht jedoch bei manchen Sonderpreisen, die vom System oder anderen Plugins untypisch ausgegeben werden.

Systemvoraussetzung

Systemvoraussetzung für dieses Plugin ist xt:Commerce ab Version 4.1. Die Aufwärtskompatibilität ist in der Regel gegeben, kann jedoch nicht zu jedem Zeitpunkt garantiert werden.

Installation

Vorbereitung

Vor der Installation eines Plugins sollten Sie Ihre Daten sichern. Besonders wichtig: die Shopdatenbank.

Installation – Schritt für Schritt

  • 1. Plugin entpacken und die entpackten Ordner und Dateien per FTP in den Ordner Plugins des Shops laden.
  • 2. Die per E-Mail erhaltene 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 für den jeweiligen Mandanten) und konfigurieren.

Nach der Installation laden sie den kompletten Adminbereich neu (in den meisten Browsern mit F5).

Installations- und Update-Service

Falls Sie das Plugin nicht selbst installieren oder updaten möchten, nutzen Sie bitte unseren (kostenpflichtigen) Installations- oder Update-Service.

Konfiguration

Bilddaten anlegen und hinterlegen

Im Plugin-Ordner vt_imageprices finden Sie den Ordner demo_digits. Er enthält Muster-Bilddateien mit den notwendigen Dateinamen:

0.png bis 9.png für die Ziffern 0-9,
com.png für das Komma
cur.png für das Währungszeichen
dot.png für den Punkt
klein_1.png usw. für kleinere Nachkommaziffern

Statt PNG können Sie auch andere Bildformate verwenden, zum Beispiel GIF oder JPEG. Die Formate müssen allerdings gleich sein, also entweder alle GIF oder alle JPEG oder alle PNG.

Das voreingestellte Präfix für kleinere Nachkommaziffern ist klein_. Dieses Präfix können Sie im Plugin-Bearbeitungsfenster ändern: Inhalte -> Plugin -> installierte Plugins -> Image Prices.
Im Plugin-Bearbeitungsfenster können Sie auch den Pfad zu den Bildern ändern, wenn Sie die Dateien in einem anderen Ordner ablegen möchten.

Smarty-Funktion kopieren

Kopieren Sie die Datei function.imageprice.php aus dem Ordner des Plugins nach /xtFramework/library/smarty/plugins.

Template-Dateien anpassen

In der Datei price.html Ihres jeweiligen Templates (im Standard-Template von xt:Commerce im Ordner ../xtCore/pages/price/) ersetzen Sie den Code durch folgende Zeile:

Falls Sie den ursprünglichen Code später noch einmal brauchen, kommentieren Sie ihn lediglich aus. Der gesamte Quellcode sieht dann so aus:

Anpassung weiterer Template-Dateien für Fortgeschrittene

Im selben Ordner price befinden sich noch andere Dateien, die die Formatierung von Sonderpreisen beeinflussen. Deren Code kann nicht einfach mit dem für die Datei price.html überschrieben werden, weil sonst Funktionen verloren gehen. Wenn Sie selbst Programmier-Kenntnisse besitzen, können Sie nach Variablen suchen, die das Muster PRICE.formated enthalten, und sie um die Plugin-Funktion erweitern. Zum Beispiel in der Datei price_special.html:

Alt:

Neu:

Auf Wunsch können auch wir Ihr Template individuell anpassen und, falls notwendig, auch das Plugin erweitern. Für ein entsprechendes Angebot wenden Sie sich bitte über die Kontakt-Seite an uns