Erweiterte Versandkosten für xt:Commerce

Downloads

Bitte achten Sie darauf, dass Sie das Plugin mit der passenden PHP Version für Ihren Shop downloaden.
Ihre PHP Version können Sie im Adminbereich unter: System -> phpinfo einsehen.

• ad_special_shipping_cost_php_5-6_to_7-4.zip
• ad_special_shipping_cost_php_81.zip
• ad_special_shipping_cost_php_82.zip

Kompatibilität

Das Plugin ist für das Shopsystem xt:Commerce entwickelt und für die folgenden Versionen getestet:

6

Hinweis: Eine optimale Darstellung kann nur im Standard-Template des Shopsystems gewährleistet werden. Sollten Sie ein eigenes oder modifiziertes Template einsetzen, müssen Sie ggf. Änderungen am Template für die Integration vornehmen.

Ioncube: Sie benötigen für unsere Plugins eine aktuelle Ioncube Version. Es gibt keinen Grund eine veraltete Ioncube Version auf dem Server ein zu setzen, da diese stets abwärtskompatibel sind.

Installation

Vor der Installation eines Plugins sollten stets alle Daten gesichert werden. Besonders wichtig ist die Shopdatenbank.

Ablauf der Installation:

1. Backup (Sicherung) des Shopsystems erstellen.
2. Das Plugin entpacken und die entpackten Daten (Plugin Name) per FTP auf den Server in den Ordner: /plugins des Shops hochladen.
   Hinweis: Überprüfen Sie das wirklich alle Dateien (achten Sie auch auf mögliche .htaccess-Dateien) korrekt hochgeladen wurden.
3. Die Lizenz-Datei des Plugins (Plugin Name.txt) per FTP in den Ordner /lic des Shops hochladen. Ohne Lizenz-Datei ist das Plugin nicht funktionsfähig!
4. Im Adminbereich des Shops das Plugin über den Menüpunkt: Inhalte -> Plugin -> deinstallierte Plugins installieren.
5. Im Adminbereich des Shops das Plugin über den Menüpunkt: Inhalte -> Plugins -> installierte Plugins aktivieren (ggf. auch für den jeweiligen Mandanten).
6. Zuletzt muss noch der komplette Adminbereich neu geladen werden. Dies geht über den "neu laden" -Button Ihres Browsers oder z.B. die F5-Taste.
7. Weitere Informationen und eine Anleitung finden Sie weiter unten.

Integration & Konfiguration

Integration

Es sind keine besonderen Integrationsschritte notwendig.

Einstellungen und Konfiguration

Das Backend stellt die Konfigurationsparameter zum Einstellen des Versandkosten Plugins bereit.

Allgemeine Plugineinstellungen

Plugin Status: Aktiviert oder deaktiviert das Plugin grundsätzlich.

Plugin aktivieren: Aktiviert / Deaktiviert das Plugin im jeweiligen Mandanten.

Sortierungsmethode: Stellt ein in welche Reihenfolge die Versandkosten aufgelistet werden.

Standardversand festlegen: Legt fest welche Versandart berechnet wird, wenn ein Produkt keine Versandart zugeordnet hat.

Verwende Versandkosten im Checkout: Legt fest, welche Versandarten (sofern mehrere verfügbar sind) im Checkout angezeigt werden und somit vom Kunden gewählt werden können.

Versandarten beim Artikel anzeigen: Falls aktiviert, werden die verfügbaren Versandarten direkt beim Artikel angezeigt.

Einstellungesmöglichkeiten pro Versandart:

Die folgenden Einstellungen können pro Versandart aktiviert werden:

Zeige diese Versandkosten im Checkout nur wenn alle Artikel diesen Versandtyp haben: Sorgt dafür, dass eine Versandart nur dann angezeigt wird, wenn diese allen Artikeln zugewiesen wurde.
Beispiel: Sie möchten die Versandart Express nur dann anbieten, wenn diese auch für alle Artikel in der Bestellung verfügbar ist. Hat ein Artikel z.B. die Versandart Express nicht zugeordnet, können Sie so erreichen, dass der Kunde nicht die Versandart Express wählen kann.

Addiere diese Versandkosten im Checkout von jedem einzelnen Produkt dieser Versandart.: Sorgt dafür, dass die Versandart addiert wird, wenn der Artikel mehrfach im Warenkorb ist.
Beispiel: Ein Kunde bestellt 5x einen Artikel, der separat versendet werden muss und somit fallen 5x Versandkosten an.

Versandkosten Exportieren

Die Versandkosten stehen in einer Variablen im Export-Manager bereit und können exportiert werden.

Folgende Variablen stehen im Export-Manager bereit:

• {$data.ad_shipping_price_id};
• {$data.ad_shipping_price_name};
• {$data.ad_shipping_price};
• {$data.ad_shipping_price_country};
• {$data.ad_shipping_price_type};
• {$data.ad_shipping_price_tax_class};

Weitere Anpassungen

Anpassungen am Design (CSS)

Grundsätzlich können Sie das Plugin optisch frei nach Ihren Wünschen anpassen, ohne dass Sie Dateien des Plugins "Plugin Name" verändern müssen. Das hat den Vorteil, dass bei einem Update keine Dateien überschrieben und Änderungen verloren gehen.

CSS Anpassungen:
Sie können die gewünschten CSS-Regeln in Ihre CSS-Datei des aktiven Templates einfügen und beeinflussen. Regeln in Ihrer eigenen CSS-Datei werden die Regeln im Plugin überschreiben.

Erweiterte Anpassungen:
Darüber hinaus können Sie die Template-Datei des Plugins in Ihr eigenes Template kopieren und so auch dieses anpassen. Sie können auch die Template-Dateien direkt im Plugin ändern, wir empfehlen aber das Vorgehen wie zuvor beschrieben.

Gehen Sie zum kopieren der Template-Dateien (sofern im Plugin vorhanden) wie folgt vor:

• Kopieren aller Dateien im Ordner: plugins/Plugin Name/templates/
• Einfügen in: templates/[MY_TEMPLATE]/plugins/Plugin Name/

Achtung: Unsachgemäße Änderungen an der Template-Datei (auch in Ihrem eigenem Template) können dazu führen, dass das Plugin oder der Shop nicht mehr korrekt funktionieren.

Language Keys (Sprachtexte)

Wenn Sie Texte im Shop (Template) ausgeben möchten oder vorhandenen bearbeiten möchten, wird das am besten über die sog. Language Keys realisiert. Das hat den Vorteil das diese mehrsprachig angelegt werden können und außerdem über den Adminbereich verwaltet werden.

Die Language Keys finden Sie hier: Einstellungen -> Lokalisierung -> Sprachtexte

Über den Button "Neu" können Sie einen neuen Language Key anlegen.
Über den "Bearbeiten" Button können vorhandene Texte angepasst werden.
Bei "Schlüssel" hinterlegen Sie den Namen für den Language Key, so wie dieser im Templat eingefügt wird. Beispiel: TEXT_MEIN_LANGUAGE_KEY
Bei "Klasse" können Sie wählen ob der Language Key im Frontend, Backend oder an beiden Stellen zur Verfügung stehen soll.
Bei "Text" wird die jeweilige Übersetzung (Text) eingegeben.

Nun kann der Language Key wie folgt an einer beliebigen Stelle im Shop (auch in Plugins) eingefügt werden:

{txt key=TEXT_MEIN_LANGUAGE_KEY}