Uploads: Dateien & Bilder hochladen 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_upload_php_5-4_to_5-5.zip
• ad_upload_php_5-6_to_7-4.zip
• ad_upload_php_81.zip

Kompatibilität

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

5 und 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

Bitte fügen Sie die folgenden drei Hookpoints in Ihr Template ein:

1. Produkt

Template Datei: /templates/aktives_template/xtCore/pages/product/product.html)

{hook key=ad_upload_template_files}

2. Warenkorb

Template Datei: /templates/aktives_template/xtCore/pages/cart.html)

{hook key=ad_upload_cart_show_thumps}

3. Checkout (Bestellbestätigungsseite)

Template Datei: /templates/aktives_template/xtCore/pages/checkout/subpage_confirmation.html)

{hook key=ad_upload_checkout_confirmation_show_thumps}

Erweiterung der Bestellbestätigung

Wenn gewünscht können die Uploads auch in der Bestellbestätigung ausgegben werden. Damit erhält der Kunde und Admin alle nötigen Infos über die Uploads direkt in der E-Mail.

Die Bestellbestätigung ist im Adminbereich wie folgt zu finden: Inhalte -> E-Mail Manager -> send_order

Dort steht das Array "products_uploads" zur Verfügung.

Ausgabe Beispiel:

Fügen Sie folgenden Code direkt nach der Zeile "{$order_values.products_name}" ein:

{if $order_values.products_uploads|@count > 0}
    <p>Aufpreis für Dateien ({$order_values.products_uploads|@count}): {$order_values.products_upload_price.formated}</p>
    {foreach $order_values.products_uploads as $upload}
        <img class="img-thumbnail" src="{$upload.url_to_pic}" style="max-width: 60px;" />
    {/foreach}
{/if}

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}