YouTube-Feed-Integration: Einrichtung und Hilfe

Verwenden Sie bei älteren PrestaShop-Versionen die entsprechende Modulinstallationsseite. Öffnen Sie dieses Modul über "Configure", wenn Sie zu seinen Einstellungen zurückkehren möchten.

Der Profil-/Kanallink im Kopfbereich liegt innerhalb des Abschnittstitelblocks. Legen Sie Abschnittstitel fest, damit dieser Link erscheint. Die separate Folgen-/Abonnieren-Schaltfläche hat einen eigenen Schalter.

Die Spalten- und Abstandseinstellungen gelten für das Feed-Layout. Prüfen Sie das Karussell bei den Desktop- und Mobilbreiten Ihres Shops.

Verwenden Sie für manuelle Videos diese URL-Formate mit einer echten elfstelligen YouTube-Video-ID:

https://www.youtube.com/watch?v=ABCDEFGHIJK
https://youtu.be/ABCDEFGHIJK
https://www.youtube.com/embed/ABCDEFGHIJK
https://www.youtube.com/shorts/ABCDEFGHIJK

Die Beispiel-ID ist ein Platzhalter. Ersetzen Sie sie durch ein verfügbares Video. Der Parser extrahiert die ID und erstellt Wiedergabe-URL, Einbettungs-URL und Vorschaubild-URL auf img.youtube.com. Er fragt YouTube oEmbed nach Titel und Autor ab. Eine gültig ausgelesene ID erzeugt auch bei oEmbed-Fehlern eine Karte; Titel/Autor können jedoch leer sein und Vorschaubild/Player fehlschlagen.

Geben Sie für eine automatische Quelle YouTube-API-Schlüssel und Playlist-ID oder Kanal-ID ein. Bei gesetzter Playlist verwendet das Modul den Endpunkt playlistItems. Andernfalls verwendet es search für die nach Datum sortierten Kanalvideos. Anschließend ruft es videos-Details für Dauer und Statistiken ab. Das Ergebnis ist auf 25 pro API-Anfrage begrenzt. Gibt die API keine Videos zurück, werden manuelle URLs verwendet. Nach einer fehlgeschlagenen Playlist-Anfrage erfolgt kein neuer Versuch mit Kanal-ID.

Im manuellen Modus gibt es keine Dauer, Aufrufzahl oder Veröffentlichungsdatum. Die API-Datumsanzeige verwendet das Datum der gewählten Quelle. Sie zeigen einen konfigurierten Feed an; das Modul bietet keine Videozuordnung pro Produkt. Eine Produktseite kann denselben Feed anzeigen, wenn ihr Theme den gewählten Hook ausgibt.

Bei Player-Modus embed fängt das Modul-JavaScript den Vorschaubildlink ab und öffnet eine Lightbox. Es befüllt eine YouTube-iframe-URL mit autoplay=1&rel=0. Schließen Sie über die Schaltfläche, einen Klick auf den Hintergrund oder Escape. Beim Schließen wird die iframe-Quelle geleert und die Wiedergabe gestoppt.

Im Modus newtab öffnet der Link die YouTube-Wiedergabeseite in einem neuen Tab. Ohne JavaScript führt der Vorschaubildlink ebenfalls zu YouTube, allerdings können per JavaScript verzögert geladene Vorschaubilder ungeladen bleiben. Das Modul kontrolliert weder Verfügbarkeit oder Werbung des externen Players noch Konto-/Videobeschränkungen. Testen Sie die konkreten Videos, die Sie verwenden möchten.

Der Feed-Cache verwendet diese lokale Datei:

modules/mpryoutubeintegration/mpryoutube_feed_cache.json

Die Feed-Daten liegen in einer lokalen JSON-Datei pro Modulinstallation. Shops mit demselben Modulverzeichnis teilen diese Datei. Eine Shopanfrage ruft Videos ab, wenn der Cache fehlt oder abgelaufen ist. Es gibt keinen geplanten Hintergrundprozess zur Feed-Aktualisierung.

Mit Clear Cache löschen Sie die Cache-Datei. Auch das Speichern der Haupteinstellungen leert den Cache. Die nächste Shopanfrage ruft neue Videos ab; vorhandene Cache-Inhalte bleiben dabei nicht sichtbar.

Nur nicht leere Ergebnisse werden gespeichert. Schlägt der Abruf fehl oder liefert er keine Videos, erscheint bei dieser Anfrage kein Feed. Spätere Shopanfragen versuchen den Abruf erneut. Eine abgelaufene Datei kann auf dem Server verbleiben, ihre alten Videos werden aber nicht angezeigt. API-Zähler und relative Datumsangaben entsprechen der gespeicherten Antwort.

Die folgenden Beispiele beschreiben Werte für die Backoffice-Formulare. Es sind keine Shell-Befehle. Ersetzen Sie Kontonamen, Pin-/Video-IDs und Zugangsdaten durch echte Werte. Der Theme-Hook muss mit Anzeige-Hook übereinstimmen.

Manuelles Grid für Produktvorführungen ohne API-Schlüssel:

MPRYOUTUBE_ENABLED=1
MPRYOUTUBE_VIDEO_URLS=https://www.youtube.com/watch?v=ABCDEFGHIJK
https://youtu.be/LMNOPQRSTUV
https://www.youtube.com/shorts/WXYZabcdefg
MPRYOUTUBE_DISPLAY_HOOK=displayHome
MPRYOUTUBE_LAYOUT=grid
MPRYOUTUBE_POST_COUNT=3
MPRYOUTUBE_COLUMNS=3
MPRYOUTUBE_PLAYER_MODE=embed

Playlist-Slider mit zwischengespeicherten API-Abrufen:

MPRYOUTUBE_ENABLED=1
MPRYOUTUBE_API_KEY=AIza...
MPRYOUTUBE_PLAYLIST_ID=PL...
MPRYOUTUBE_DISPLAY_HOOK=displayFooterBefore
MPRYOUTUBE_LAYOUT=slider
MPRYOUTUBE_POST_COUNT=6
MPRYOUTUBE_AUTO_SCROLL=1
MPRYOUTUBE_SCROLL_SPEED=4000
MPRYOUTUBE_CACHE_DURATION=3600

Unterstützte manuelle URL-Formate:

https://www.youtube.com/watch?v=ABCDEFGHIJK
https://youtu.be/ABCDEFGHIJK
https://www.youtube.com/embed/ABCDEFGHIJK
https://www.youtube.com/shorts/ABCDEFGHIJK

Wenn Ihr Theme den gewählten Hook nicht ausgibt, ergänzen Sie den passenden PrestaShop-Hook-Aufruf im entsprechenden Smarty-Template:

{hook h='displayFooterBefore'}

Theme-CSS kann die Shop-Klassen des Moduls ansprechen:

.mprfeed-youtube .mprfeed-title {
  font-size: 20px;
}

.mprfeed-youtube .mprfeed-follow-youtube {
  background: #cc0000;
}

.mprfeed-youtube .mprfeed-caption {
  min-height: 2.8em;
}

Der Feed-Cache verwendet diese lokale Datei:

modules/mpryoutubeintegration/mpryoutube_feed_cache.json

Behalten Sie CSS- und Template-Änderungen in Ihrem Theme.

• Fehlt der Abschnitt, prüfen Sie Modul aktivieren, die Quellfelder, Auf Mobilgeräten anzeigen und den gewählten Hook. Das Modul gibt keinen Abschnitt zurück, wenn keine Elemente verfügbar sind.
• Prüfen Sie, ob Ihr Theme displayHeader zum Laden von Stylesheet und JavaScript aufruft und den gewählten Anzeige-Hook ausgibt.
• Bleiben Bilder leer, prüfen Sie Netzwerkfehler im Browser. Deaktivieren Sie versuchsweise Lazy Loading und prüfen Sie die Bild-URLs.
• Ist das Layout falsch, testen Sie zuerst das Grid und prüfen Sie dann das Karussell bei Desktop- und Mobilbreiten.
• Wenn MPR Social Revolution die Einstellung YOUTUBE_ACTIVE aktiviert hat, wird dieser eigenständige Feed unterdrückt. Die Prüfung liest das gespeicherte Flag; Social Revolution muss dafür nicht aktuell als Modul aktiviert sein.

Öffnen Sie die Seite "Integrity" des Moduls für Konfigurations- und Hook-Prüfungen. Lizenz, Support und Aktualisieren sind Wartungsseiten. Testen Sie nach Änderungen an Konto-IDs oder Feed-Quellen die tatsächlichen Ziele.

Setzen Sie Modul aktivieren auf Nein und speichern Sie, um den Feed auszublenden und die Konfiguration zu behalten. Deinstallieren Sie über den Modulmanager, um Konfiguration, lokalen Cache und Admin-Menüeinträge dieses Moduls zu entfernen.