Virtual Products Management Pro - Herunterladbare Dateien je Kombination mit Versionen und GitHub-Sync

Das PrestaShop-9-Problem, für das es dieses Modul gibt

In PrestaShop 9 sind "Virtuelles Produkt" und "Produkt mit Kombinationen" sich gegenseitig ausschließende Produkttypen. Das ist unproblematisch, bis Sie Software, E-Books, Samples oder Lizenzen in mehr als einer Variante verkaufen — Standard und Pro, Einzelplatz und Team, Windows und macOS — denn sobald Sie Kombinationen brauchen, ist das eingebaute Dateifeld für virtuelle Produkte verschwunden.

Dieses Modul verwaltet herunterladbare Dateien vollständig außerhalb des Systems für virtuelle Produkte von PrestaShop. Legen Sie das Produkt als Produkt mit Kombinationen an, definieren Sie die Varianten und laden Sie zu jeder eine Datei hoch. Jede Kombination erhält ihre eigene Datei, ihre eigene Versionsnummer und ihr eigenes Änderungsprotokoll.

Eine Seite statt ein Produkt nach dem anderen

Die Dateien des gesamten Katalogs liegen auf einem einzigen Bildschirm. Produkt aufklappen, Kombinationen sehen, Datei hochladen oder ersetzen, Version setzen, Änderungsprotokoll schreiben. Sieben Zähler am oberen Rand zeigen Ihnen auf einen Blick, wo Sie stehen — Virtuelle Dateien, Produkte, Kombinationsdateien, Einfache Dateien, Fehlende Dateien, Downloads gesamt und Kunden — sodass ein Produkt, dessen Datei nie hochgeladen wurde, dort in Rot auffällt, statt von einem Kunden entdeckt zu werden.

Jede Datei führt außerdem ihr eigenes Download-Limit, ihre Gültigkeit in Tagen und ihr eigenes Ablaufdatum, sodass eine Lizenz zeitlich begrenzt statt unbefristet übergeben werden kann. Jedes herunterladbare Format funktioniert: ZIP, PDF, MP3, FLAC, EPUB oder was auch immer Sie verkaufen.

Kombination mit GitHub verknüpfen und das Hochladen sein lassen

Jede Kombination arbeitet in einem von zwei Modi: Datei hochladen oder GitHub-Repository. Stellen Sie auf GitHub um, geben Sie ein owner/repo und optional einen Branch oder Tag an — und eine einzige Schaltfläche Von GitHub abrufen / synchronisieren holt Datei, Version und Änderungsprotokoll gemeinsam: Sie packt das Release, liest die Version aus und übernimmt die letzten Commit-Betreffzeilen serverseitig, statt lediglich ein Feld in Ihrem Browser zu füllen.

Private Repositories werden über ein Personal Access Token unterstützt. Legen Sie einmal ein Standard-GitHub Personal Access Token für den ganzen Shop fest und überschreiben Sie es pro Produkt, wenn ein anderes Repository andere Zugangsdaten benötigt.

Eine Tabelle Recent Sync Log (Protokoll der letzten Synchronisierungen) hält fest, was pro Durchlauf tatsächlich passiert ist — Produkt, Kombination, Status, Meldung und Datum — inklusive des Übergangs alte → neue Version oder ausdrücklich "no version change", wenn ein Durchlauf nichts gefunden hat. Darüber steht ein Zeitstempel Last automatic run (letzter automatischer Durchlauf), sodass Sie auf einen Blick erkennen, ob die geplante Synchronisierung wirklich gelaufen ist oder überhaupt noch nie stattgefunden hat. Diese beiden Bezeichnungen sind im Template fest auf Englisch hinterlegt und erscheinen daher auch in einem deutschen Backoffice in englischer Sprache.

Eine ehrliche Einschränkung: Die stündliche Synchronisierung setzt auf das Cron-Aufgabensystem von PrestaShop auf, das von einem echten externen Cron-Job auf Ihrem Server ausgelöst werden muss. Solange das nicht eingerichtet ist, erledigt die Schaltfläche Von GitHub abrufen / synchronisieren dieselbe Arbeit auf Abruf — und die Zeile Last automatic run meldet weiterhin never, was genau der Grund ist, sie überhaupt anzuzeigen.

Sagen Sie Ihren Kunden, dass es ein Update gibt

Jede Kombination hat ihre eigene Schaltfläche Kunden benachrichtigen, die den Kunden, die dieses Produkt gekauft haben, eine E-Mail über die neue Version schickt. Bei allem, was als Lizenz oder Werkzeug verkauft wird, entscheidet diese eine Schaltfläche darüber, ob ein Kunde aktualisiert oder vergisst, dass er das Produkt besitzt.

Kunden erhalten einen richtigen Download-Bereich

Käufer sehen ihre Dateien in ihrem Kundenkonto und auf der Bestelldetailseite, jeweils mit der Version, auf die sie Anspruch haben. Es ist die gewohnte PrestaShop-Kontoumgebung, erweitert um Dateien je Kombination, die der Standard nicht abbilden kann.

Was Version 1.5.x behoben hat

Version 1.5.2 hat eine Reihe echter Fehler behoben, die man kennen sollte — es sind genau die, die sich monatelang verstecken.

Das Feld Änderungsprotokoll konnte von der Synchronisierung nie aktualisiert werden. Beide Synchronisierungspfade ließen changelog in ihrer UPDATE-Anweisung aus, sodass das Feld, sobald der Datensatz einer Kombination existierte, auf dem letzten manuell eingetippten Stand einfror — und keiner der Pfade holte serverseitig überhaupt Änderungsprotokoll-Inhalte von GitHub. Die Synchronisierung liest jetzt selbst die letzten Commit-Betreffzeilen der aufgelösten Ref aus und speichert sie im selben Vorgang, sowohl auf dem manuellen als auch auf dem automatischen Pfad.

Der manuelle und der automatische Synchronisierungspfad waren auseinandergelaufen. Der manuelle Endpunkt hatte die GitHub-Aufrufe, die Zip-Verarbeitung und die Versionsermittlung eigenständig nachgebaut, sodass eine Korrektur an einer Stelle stillschweigend nicht für die andere galt. Der manuelle Pfad delegiert jetzt an die gemeinsame Synchronisierungsklasse — nimmt Repository und Ref aber weiterhin aus dem Formular, das Sie gerade vor sich haben, damit ausprobieren vor dem Speichern weiter funktioniert.

Die stündliche Synchronisierung protokollierte immer "success" ohne jedes Detail, selbst wenn sich nichts geändert hatte — was das Protokoll unbrauchbar machte, um einen ruhigen Durchlauf von einem stillen Fehlschlag zu unterscheiden. Und bei Neuinstallationen wurde der Cron-Hook nie registriert — das tat nur der Selbstheilungs-Block der Konfigurationsseite, sodass die stündliche Synchronisierung erst laufen konnte, wenn ein Administrator diese Seite zufällig öffnete. Die Installation registriert ihn jetzt direkt.

Eines sollten Sie einplanen

Da das Produkt in PrestaShop nicht als Virtuell gekennzeichnet ist, greift weiterhin die normale Versandkostenberechnung. Damit für diese Produkte keine Versandkosten anfallen, ordnen Sie sie einem Transportunternehmen mit einer Kostenlos-Regel für den Versand zu. Das ist ein einmaliger Einrichtungsschritt, und die Konfigurationsseite des Moduls weist ausdrücklich darauf hin, statt Sie das an einer echten Bestellung herausfinden zu lassen.

Kompatibilität

PrestaShop 1.7, 8 und 9, in acht Sprachen: Deutsch, Englisch, Französisch, Italienisch, Niederländisch, Polnisch, Spanisch und Türkisch. Multistore-fähig. Beim Deinstallieren werden die Daten des Moduls und die von ihm verwalteten virtuellen Dateien entfernt, worauf die Deinstallations-Bestätigung unmissverständlich hinweist — sichern Sie also vorher eine Kopie, wenn Sie eine Neuinstallation planen.

Häufig gestellte Fragen

Warum brauche ich das unter PrestaShop 9?

Weil PS 9 Virtuelles Produkt und Produkt mit Kombinationen gegenseitig ausschließt. Wenn Sie ein herunterladbares Produkt in mehreren Editionen oder Stufen verkaufen, kann der Standard jeder Variante keine eigene Datei geben. Dieses Modul kann es.

Kann jede Kombination eine andere Datei und Version haben?

Ja — ihre eigene Datei, ihre eigene Versionsnummer und ihr eigenes Änderungsprotokoll. Genau darum geht es in diesem Modul.

Wie funktioniert die GitHub-Synchronisierung?

Stellen Sie eine Kombination auf den Modus GitHub-Repository, geben Sie ein owner/repo sowie optional einen Branch oder Tag an und drücken Sie Von GitHub abrufen / synchronisieren — damit werden Datei, Version und Änderungsprotokoll in einem Zug geholt. Private Repositories funktionieren über ein Personal Access Token, das einmal als Shop-Standard gesetzt und pro Produkt überschrieben werden kann. Die stündliche automatische Synchronisierung benötigt zusätzlich den Cron-Aufgabenplaner von PrestaShop, angetrieben von einem echten Cron-Job auf Ihrem Server.

Erfahren meine Kunden, wenn ich ein Update ausliefere?

Ja, wenn Sie bei der Kombination auf Kunden benachrichtigen drücken — damit erhalten die Kunden, die dieses Produkt gekauft haben, eine E-Mail.

Werden für diese Produkte Versandkosten berechnet?

Das kann passieren, weil PrestaShop sie nicht als virtuell ansieht. Ordnen Sie sie einem Transportunternehmen mit einer Kostenlos-Regel für den Versand zu, und die Gebühr verschwindet.

Welche Dateitypen werden unterstützt?

ZIP, PDF, MP3, FLAC, EPUB und jedes andere herunterladbare Format.

Wie erkenne ich ein Produkt, dessen Datei fehlt?

Zu den Zählern am oberen Seitenrand gehört der Wert Fehlende Dateien, sodass eine Lücke dort auffällt und nicht erst in einer Kundenbeschwerde.

Was passiert beim Deinstallieren?

Die Daten des Moduls und die von ihm verwalteten virtuellen Dateien werden gelöscht — die Bestätigung sagt das auch so. Bewahren Sie eine Kopie von allem auf, was Sie noch einmal brauchen.