PDF-Katalog – Einbinden im Shop und Aktualisierung

Im Shop zeigen

• Code: Kopieren Sie den Code oben in der Bearbeiten-Ansicht, zum Beispiel [salepix-katalog id=1], und fügen Sie ihn in eine Eigene Seite, eine Artikelbeschreibung oder einen Textbaustein ein. Je Seite wirken bis zu 50 Codes.
• OnPage Composer: Ziehen Sie den Baustein PDF-Katalog auf die Seite und wählen Sie den Katalog.
• Feste Adresse: Jede Sprache hat eine feste Adresse, zum Beispiel https://ihr-shop.de/media/salepix_katalog/gesamtkatalog-2026-ger.pdf. Sie bleibt bei jeder Neuerzeugung gleich und eignet sich für Newsletter und gedruckte QR-Codes. Ändern Sie Dateiname oder Kundengruppe des Katalogs, ändert sich auch die Adresse.

An der Stelle des Codes erscheinen das Titelbild, der Titel, „Stand: TT.MM.JJJJ“, der Knopf Ansehen und der Knopf Herunterladen mit der Dateigröße. Ist das Plugin PDF-Flipbook ab Version 1.0.16 aktiv, öffnet „Ansehen“ das Flipbook, sonst öffnet sich die PDF im Browser.

Jeder Besucher sieht nur Kataloge seiner eigenen Kundengruppe. Setzen Sie die Codes für den Gäste- und den Händlerkatalog nebeneinander auf dieselbe Seite: Gäste sehen den einen, angemeldete Händler den anderen. Kataloge für eine andere als die Standard-Kundengruppe bekommen einen nicht erratbaren Zusatz im Dateinamen.

Es erscheint nichts, wenn der Katalog inaktiv ist, nicht zur Kundengruppe des Besuchers gehört, für die Sprache des Kunden noch keine PDF hat oder keine gültige Lizenz vorliegt. Die Ursache steht dann im Systemlog.

So bleibt der Katalog aktuell

• Ein eigener Cron „SALEPIX PDF-Katalog“ prüft jede Nacht zwischen 1 und 4 Uhr, ob sich Preise, Sonderpreise, Texte, Bilder, Merkmale, Varianten, Kategorien oder Einstellungen geändert haben. Nur dann entsteht eine neue Fassung.
• Mit Jetzt neu erzeugen starten Sie die Erzeugung sofort.
• Ein Katalog entsteht in kurzen Schritten. Jeder Cron-Aufruf arbeitet höchstens etwa 15 Sekunden.
• Die alte PDF bleibt online, bis die neue vollständig geprüft ist, und wird dann in einem Zug ausgetauscht.
• Im Shop steht „Stand: TT.MM.JJJJ“ der Fassung, die gerade online ist. Das gleiche Datum steht im PDF.

Server-Cron einrichten

Der JTL-Cron läuft ab Werk nur, wenn Besucher Seiten aufrufen. Richten Sie bei Ihrem Hoster einen Server-Cron ein, der alle 5 Minuten diese Datei aufruft:

php /pfad/zum/shop/includes/cron_inc.php

Läuft der Katalog-Cron länger als 48 Stunden nicht, zeigt die Katalogseite des Plugins einen Hinweis. Für sehr große Kataloge mit zehntausenden Artikeln ist ein Server-Cron Pflicht.

Zwischenspeicher auf nginx

Damit Browser keine alte Fassung zeigen, legt das Plugin im Ordner media/salepix_katalog/ eine .htaccess an, die das Zwischenspeichern abschaltet. Auf nginx wirkt diese Datei nicht. Ergänzen Sie dort die Server-Konfiguration:

location ^~ /media/salepix_katalog/ {
    add_header Cache-Control "no-cache, must-revalidate";
    expires off;
    location ~ /intern- { deny all; }
    location ~ \.(php|json|state)$ { deny all; }
}

Wenn etwas schiefgeht

• Fehler und Hinweise des letzten Laufs stehen unten in der Bearbeiten-Ansicht: fehlende Bilder, Artikel ohne Übersetzung, abgebrochene Teile.
• Scheitert ein Schritt, versucht der nächste Aufruf ihn erneut. Scheitert er ein zweites Mal, wird die Erzeugung gestoppt und erst wieder aufgenommen, wenn Sie Erneut versuchen klicken. Die bisherige PDF bleibt online. Sehen Sie nach der Ursache, meist eine Speicher- oder Zeitgrenze des Servers.