PS PrestaShop PrestaShop Anfänger

DF Download Center — Dokumentation

Installation, Konfiguration und Nutzung des Produkt-Download-Centers: Produkt-Tab, indexierbare zentrale Seite, Dokumenttypen, Dateisicherheit.

Aktualisiert Modulversion 1.0.0

Übersicht

DF Download Center ordnet Ihre Anleitungen, Handbücher, Datenblätter und CE-Zertifikate direkt Ihren Produkten zu. Jede Produktseite erhält einen Tab „Dokumente & Downloads“, der die Dateien nach Typ gruppiert auflistet. Parallel dazu bündelt eine indexierbare zentrale Seite den gesamten Dokumentenbestand, mit Suche, Typfiltern und strukturierten JSON-LD-Daten.

Das Modul ist kompatibel mit PrestaShop 8.0 bis 9.x, multishop-fähig, in fünf Sprachen verfügbar und hängt weder von Composer noch von einem externen Framework ab.

Installation

  1. Gehen Sie im Backoffice zu Module und dann Modul-Manager.
  2. Klicken Sie auf Modul hochladen und legen Sie die Datei dfdownloadcenter-1.0.0.zip ab.
  3. Klicken Sie auf Installieren.

Die Installation legt die Modultabellen an, vier Standard-Dokumenttypen, einen Admin-Tab unter dem Menü Katalog und registriert die erforderlichen Hooks.

Leeren Sie nach der Installation den Cache unter Erweiterte Einstellungen und dann Leistung. Die Route der zentralen Seite wird über den Routing-Hook deklariert und ist erst nach der Cache-Regenerierung aktiv.

Berechtigungen

Der Ordner modules/dfdownloadcenter/uploads/ muss für den Webserver beschreibbar sein. Er enthält eine htaccess-Datei, die jeden direkten HTTP-Zugriff blockiert: Dateien verlassen ihn nur über den Download-Controller.

Konfiguration

Öffnen Sie das Modul unter Module und dann Modul-Manager, und klicken Sie auf Konfigurieren.

Zentrale Seite

  • Zentrale Seite aktivieren — ist sie deaktiviert, liefert die Seite einen 404 und der Link aus dem Produkt-Tab verschwindet.
  • URL-Slug — das URL-Segment der Seite, zum Beispiel downloads oder telechargements. Leeren Sie nach jeder Änderung den Cache.
  • Dokumente pro Seite — standardmäßig 20.
  • Meta-Titel und Meta-Beschreibung — pro Sprache konfigurierbar, verwendet im Title-Tag und in der Meta-Beschreibung der Seite.

Dokumenttypen

Vier Typen werden standardmäßig installiert, übersetzt in alle fünf Katalogsprachen:

  • Anleitungen & Handbücher
  • Datenblätter
  • CE-Zertifikate
  • Weitere Dokumente

Im Konfigurationsbildschirm können Sie Typen anlegen, umbenennen und neu sortieren. Die Position bestimmt die Anzeigereihenfolge der Gruppen im Produkt-Tab und auf der zentralen Seite.

Ein Typ, der von mindestens einem Dokument genutzt wird, kann nicht gelöscht werden. Das Modul zeigt die Anzahl der betroffenen Dokumente an und fordert Sie auf, sie zuvor einem anderen Typ zuzuordnen.

Dokumente verwalten

Dokumente werden unter Katalog und dann Download-Center verwaltet. Die Liste zeigt für jedes Dokument Titel, Typ, Dateiname, Größe, Anzahl der Downloads und Aktivstatus.

Ein Dokument anlegen

  1. Klicken Sie auf Neu hinzufügen.
  2. Geben Sie den Titel in jeder Sprache ein. In der Standardsprache ist er Pflicht.
  3. Fügen Sie eine optionale Beschreibung hinzu, ebenfalls pro Sprache. Sie erscheint unter dem Titel im Produkt-Tab und auf der zentralen Seite.
  4. Wählen Sie den Typ des Dokuments.
  5. Wählen Sie die hochzuladende Datei.
  6. Ordnen Sie die zugehörigen Produkte zu, indem Sie ihren Namen oder ihre Artikelnummer in das Suchfeld eingeben: Vorschläge erscheinen ab zwei Zeichen, und jedes ausgewählte Produkt wird zu einem Chip, der sich mit einem Klick entfernen lässt.
  7. Legen Sie die Position des Dokuments innerhalb seines Typs und seinen Aktiv-Status fest.
  8. Speichern Sie.

Dateiformate und -größe

Akzeptierte Erweiterungen: PDF, DOC, DOCX, ODT, XLS, XLSX, ODS, CSV, TXT, RTF, ZIP, PNG, JPG, JPEG, WEBP, SVG, DWG, DXF, STEP und STP. Die maximale Dateigröße beträgt 50 MB.

Wird eine Datei unter 50 MB abgelehnt, prüfen Sie die Direktiven upload_max_filesize und post_max_size Ihrer PHP-Konfiguration: das Modul kann keine Datei entgegennehmen, die PHP bereits vorher ablehnt.

Eine Datei ersetzen

Öffnen Sie das Dokument zur Bearbeitung und wählen Sie eine neue Datei. Die alte Datei wird nach erfolgreicher Aktualisierung automatisch vom Server entfernt. Der Download-Zähler bleibt erhalten.

Ein Dokument, mehrere Produkte

Die Zuordnung Dokument-Produkte ist mehrfach. Ein CE-Zertifikat, das drei Artikelnummern abdeckt, wird in einem Schritt allen dreien zugeordnet und erscheint dann im Tab jeder einzelnen. Umgekehrt kann ein Produkt beliebig viele Dokumente tragen.

Ein Dokument ohne zugeordnetes Produkt bleibt gültig: es erscheint in keinem Produkt-Tab, bleibt aber auf der zentralen Seite sichtbar. Das ist die passende Verwendung für eine Qualitätscharta, einen Gesamtkatalog oder jedes Unternehmensdokument.

Der Produkt-Tab

Auf der Produktseite erscheint der Tab „Dokumente & Downloads“ neben der Beschreibung, über den nativen Extra-Content-Hook von PrestaShop. Keine Theme-Datei wird überschrieben.

Die Dokumente sind nach Typ gruppiert, in der durch die Typ-Positionen festgelegten Reihenfolge. Jede Zeile zeigt einen farbigen Erweiterungs-Chip, den Titel, die optionale Beschreibung, die Dateigröße und einen Download-Button. Ein Link zur zentralen Seite schließt den Tab ab, sofern diese aktiviert ist.

Hat ein Produkt kein aktives zugeordnetes Dokument, erscheint der Tab gar nicht.

Die zentrale Seite

Die zentrale Seite wird unter der durch den Slug definierten URL ausgeliefert, zum Beispiel /downloads, oder /fr/downloads in anderen Sprachen, je nach mehrsprachiger Konfiguration Ihres Shops.

Suche und Filter

Das Suchfeld durchsucht gleichzeitig den Dokumenttitel, seine Beschreibung, den ursprünglichen Dateinamen sowie Name und Artikelnummer der zugeordneten Produkte. Ein Kunde, der eine Artikelnummer eingibt, findet also die passende Anleitung.

Die Typfilter erscheinen als Pills, jeweils mit der Anzahl aktiver Dokumente. Die Paginierung ist über die Einstellungen konfigurierbar.

SEO

Die Seite ist auf Indexierung ausgelegt:

  • Meta-Titel und Meta-Beschreibung pro Sprache konfigurierbar;
  • robots-Direktive auf index follow;
  • saubere kanonische URL — nur die Seitennummer bleibt erhalten, Filter und Suche werden ausgeschlossen, um Duplikate zu vermeiden;
  • Breadcrumb;
  • strukturierter JSON-LD-Datenblock vom Typ ItemList, der jede Datei als DigitalDocument beschreibt;
  • interne Links zu den betroffenen Produkten unter jedem Dokument.

Download und Sicherheit

Die Dateien sind nie direkt erreichbar. Sie werden unter einem gehashten Namen im Ordner uploads/ des Moduls abgelegt, der durch eine htaccess-Datei gesperrt ist.

Der Download läuft zwingend über einen Front-Controller, der vor dem Ausliefern der Datei:

  • prüft, ob das Dokument existiert und aktiv ist;
  • prüft, ob es dem aktuellen Shop zugeordnet ist;
  • den Download-Zähler erhöht;
  • die Datei unter ihrem Originalnamen zurückgibt.

PDFs und Bilder öffnen sich im Browser; andere Formate lösen einen Download aus. Jede ungültige Anfrage wird auf die 404-Seite des Shops umgeleitet.

Multishop

Dokumente werden über die Standard-Tabellenzuordnung von PrestaShop nativ Shops zugeordnet. Im Multishop-Kontext erscheint ein in einem Shop angelegtes Dokument nur dort, und der Download-Controller weigert sich, eine einem anderen Shop zugeordnete Datei auszuliefern.

Auch die Einstellungen der zentralen Seite — Slug, Metadaten, Paginierung — werden pro Shop verwaltet.

Deinstallation

Die Deinstallation entfernt die Modultabellen, seine Konfigurationswerte, seinen Admin-Tab und löscht sämtliche Dateien im Ordner uploads/.

Sichern Sie Ihre Dateien, bevor Sie das Modul deinstallieren: hochgeladene Dokumente lassen sich danach nicht wiederherstellen.

Fehlerbehebung

Die URL der zentralen Seite liefert einen 404

Leeren Sie den Cache unter Erweiterte Einstellungen und dann Leistung. Über den Routing-Hook deklarierte Routen werden von PrestaShop zwischengespeichert und erst nach der Regenerierung berücksichtigt.

Prüfen Sie außerdem, ob sprechende URLs unter Shop-Parameter und dann Traffic & SEO aktiviert sind, und ob die zentrale Seite in der Modulkonfiguration aktiviert ist.

Der Tab erscheint nicht auf der Produktseite

Prüfen Sie, ob dem Produkt mindestens ein aktives Dokument zugeordnet ist und ob der Extra-Content-Hook für das Modul auf der Seite Positionen im Backoffice korrekt registriert ist. Stellen Sie bei einem stark angepassten Theme sicher, dass das Produktseiten-Template die Extra-Content-Blöcke ausgibt.

Der Download liefert einen 404

Drei mögliche Ursachen: das Dokument ist deaktiviert, es ist nicht dem aktuellen Shop zugeordnet, oder die physische Datei fehlt im Ordner uploads/. Bearbeiten Sie das Dokument erneut und laden Sie die Datei neu hoch.

Der Upload schlägt ohne klare Meldung fehl

Prüfen Sie die Schreibrechte auf modules/dfdownloadcenter/uploads/ und anschließend die PHP-Direktiven upload_max_filesize, post_max_size und max_file_uploads.

Technische Kompatibilität

  • PrestaShop 8.0 bis 9.x
  • PHP 7.4 bis 8.3
  • Verwendete Hooks: displayProductExtraContent, moduleRoutes, displayHeader, actionObjectProductDeleteAfter
  • Kein Core-Override, keine Composer-Abhängigkeit
  • Autovervollständigung in nativem JavaScript, ohne jQuery
  • Multishop und mehrsprachig: DE, FR, EN, ES, IT
War diese Seite hilfreich?

Immer noch nicht weiter? Support kontaktieren