Produkt Downloads & Produkt Links

Highlights

Features

Produkt Downloads

• Downloads von Dateien direkt beim Artikel
• Erklärungen, Software und Manuals anbieten
• Formate wie JPG, GIF, PNG und PDF möglich
• Im Shopware Standard sind für den Dateiupload im Medienmanager folgende Dateitypen möglich:
  jpg, jpeg, png, webp, gif, svg, bmp, tiff, tif, eps, webm, mkv, flv, ogv, ogg, mov, mp4, avi, wmv, pdf, aac, mp3, wav, flac, oga, wma, txt, doc
  
• Wenn sie spezielle Dokumente mit anderen Endungen hochladen möchten, dann wird das durch Shopware blockiert
  Eine einfache Anpassung der Shopware Konfigurationsdatei ermöglicht dies:
  Ausgehend vom Shopware Root > config > packages > shopware.yaml  
  (wenn vorhanden editieren, wenn nicht vorhanden anlegen - dies ist eine einfache Textdatei und kann mit einem Notepad++ oder ähnlichen bearbeitet werden)
  Bitte diesen Eintrag rein kopieren oder Eintrag entsprechend anpassen:
  shopware:
    filesystem:
      allowed_extensions: ["jpg", "jpeg", "png", "webp", "gif", "svg", "bmp", "tiff", "tif", "eps", "webm", "mkv", "flv", "ogv", "ogg", "mov", "mp4", "avi", "wmv", "pdf", "aac", "mp3", "wav", "flac", "oga", "wma", "txt", "doc"]
  
• Wir haben ein Plugin zur Erweiterung der Dateiendungen ohne manueller Anpassung der shopware.yaml erstellt - dies können sie bei uns kostenlos über den Support anfordern. 

Produkt Links (ab Plugin Version 3.x)

Grundeinstellung

Über Einstellungen > System > Plugins> AcrisProductDownloads

Position der Download Produkte festlegen

Medien Pfad für Import eingeben

Konfiguration

Im Produkt wird mit Downloads ein Modul für Downloadartikel angeboten

Wie bei Medien können dort Dateien abgelegt werden.

Bilder und Dateien können auch direkt über eine URL hochgeladen werden

Title, Beschreibung sowie die Position der Dateien lassen sich nachträglich ändern

Die Download-Dateien können an verschiedenen Positionen angezeigt werden.

• In einem eigenen Karteireiter

• Vor der Beschreibung

• Zwischen der Beschreibung und den technischen Daten

• Nach den technischen Daten

Import über Shopware API

1. Hochladen der Downloads über FTP

2. Import der Downloads über Sync-API

Der JSON-Aufruf für die Sync-API:

POST http://www.mein-shop.de/api/_action/sync

[
    {
        "action": "upsert",
        "entity": "product",
        "payload": [
            {
                "id": "b851fd3085054856b83e1e693b5bbd1b",

               ...

                "acrisDownloads": [
                    {
                        "fileName": "ACRIS_12345_1_DE.pdf",
                        "title": "Benutzerhandbuch",
                        "position": 0,
                        "languages": [
                            {
                                "id": "2fbb5fe2e29a4d70aa5854ce7ce3e20b"
                            }
                        ]
                    },
                    {
                        "fileName": "ACRIS_12345_1_EN.pdf",
                        "title": "Manual",
                        "position": 0,
                        "languages": [
                            {
                                "id": "01896943f9847021b988cede9f40d445"
                            }
                        ]
                    }
                ]
            }
        ]
    }
]

• id: Pflichtfeld. Die ID entspricht der UUID des Produktes.
  
• fileName: Pflichtfeld. Hier bitte nur den Dateinamen inklusive Dateiendung angeben. Die Datei muss sich am Server in dem in den Plugineinstellungen angegebenen Verzeichnis befinden.
• title: Optional. Der Titel kann auch übersetzt werden analog zu den anderen Übersetzungen wie sie in Shopware 6 üblich sind.
• position: Optional. Legt die Anzeigeposition im Shop fest.
• languages: Optional. Downloads können auf Sprachen eingeschränkt werden. Wird languages weg gelassen oder leer übergeben, ist die Downloaddatei für alle Sprachen verfügbar.
  

Downloads bei erneutem Import ersetzen

Damit Downloads beim erneuten Import nicht mehrfach zugeordnet werden, kann vor dem Feld "fileName" auch eine id (UUID) in dem Feld "id" mitgegeben werden.

3. Ergebnis

Häufig gestellte Fragen

• Wie kann ich Links über die API zuordnen ?Hier ist ein API-Muster, wie Links über die Sync-API zum Produkt importiert werden sollten. [ { "action": "upsert", "entity": "product", "payload": [ { "id": "b851fd3085054856b83e1e693b5bbd1b", "acrisLinks": [ { "url": "https://www.acris-ecommerce.at/", "linkTarget": true, "title": "Link" Text, "description": "Link Beschreibung", "position": 1, "languages": [ { "id": "2fbb5fe2e29a4d70aa5854ce7ce3e20b" } ] } ] } ] } ]
• Wie kann ich Downloads über die API zuordnen ?Beispiel eines JSON-Aufruf für die Sync-API: POST http://www.mein-shop.de/api/_action/sync [ { "action": "upsert", "entity": "product", "payload": [ { "id": "b851fd3085054856b83e1e693b5bbd1b", ... "acrisDownloads": [ { "fileName": "ACRIS_12345_1_DE.pdf", "title": "Benutzerhandbuch", "position": 0, "languages": [ { "id": "2fbb5fe2e29a4d70aa5854ce7ce3e20b" } ] }, { "fileName": "ACRIS_12345_1_EN.pdf", "title": "Manual", "position": 0, "languages": [ { "id": "01896943f9847021b988cede9f40d445" } ] } ] } ] } ]
• Wie kann ich Downloads von den Medien via API zuordnen ?Wenn die Downloads bereits in den Medien im Shopware Admin hochgeladen wurden, dann ich eine Zuordnung der Downloads via API wie folgt möglich: { "id": "f947b036a41c4be38cdad7fddf13bd1d", "acrisDownloads": [ { "mediaId": "11d0ac3beb2e4f738f72732739e108b0", "title": "Test file", "position": 0, "languages": [ { "id": "2fbb5fe2e29a4d70aa5854ce7ce3e20b" }, { "id": "7a6b724e70614488bc10740313df0409" } ] } ] }
• Wie kann ich vorhandene Downloads am Produkt umbenennen?Beispiel eines JSON-Aufruf für die Sync-API (UUID des Produktes, der Sprache und des Download Eintrages müssen bekannt sein): POST http://www.mein-shop.de/api/_action/sync [ { "key": "write", "action": "upsert", "entity": "product", "payload": [ { "id": "0189f245a8047d0e928c3d3a702eeedc", "acrisDownloads": [ { "id": "0189f2466f197d7b808601c970f8d034", "title": "Download Title EN (default language)", "description": "Download Description EN (default language)", "translations": [ { "languageId": "2fbb5fe2e29a4d70aa5854ce7ce3e20b", "title": "Download Title EN (default language)", "description": "Download Description EN (default language)" }, { "languageId": "0189d01b707a7298885830df99fcd93f", "title": "Download Titel DE", "description": "Download Description DE" } ] } ] } ] } ]
• Wie kann ich vorhandene Downloads am Produkt löschen?Beispiel eines JSON-Aufruf für die Sync-API (UUID des Download Eintrages muss bekannt sein): POST http://www.mein-shop.de/api/_action/sync [ { "action": "delete", "payload": [ { "id": "0189f2466f197d7b808601c970f8d034" } ], "entity": "acris_product_download" } ] Achtung: Das Medium selbst wird mit diesem Aufruf nicht gelöscht. Dieses muss über einen zusätzlichen Aufruf mit der bekannten UUID des Mediums gelöscht werden: DELETE http://www.mein-shop.de/api/media/0189f2466ded7927a13d3904b7d1a0a2