Instagram-Feed-Integration: Einrichtung und Hilfe

1. Laden Sie die ZIP-Datei von Instagram Feed Integration über "Modules > Module Manager" hoch.
2. Öffnen Sie "Configure".
3. Geben Sie Zugriffstoken, Instagram-Benutzer-ID und Instagram-Benutzernamen ein.
4. Wählen Sie einen tatsächlich von Ihrem Theme unterstützten Anzeige-Hook und speichern Sie.
5. Besuchen Sie diesen Shop-Bereich, damit die erste Feed-Anfrage ausgeführt wird. Prüfen Sie, ob Beiträge auf das gewünschte Konto verlinken.

Erfordert PrestaShop 1.6 oder neuer und PHP 7.1 oder neuer.

Wenn Instagram-Benutzer-ID ausgefüllt ist, ruft das Modul https://graph.facebook.com/v18.0/USER_ID/media ab. Ist das Feld leer, verwendet es https://graph.instagram.com/me/media. Konfigurieren Sie das gewünschte Graph-Konto und prüfen Sie die Feed-Antwort.

Nach jedem Feed-Abruf ohne gültigen Cache versucht das Modul eine Token-Erneuerung über graph.instagram.com/refresh_access_token, auch bei gesetzter Instagram-Benutzer-ID. Bei Erfolg wird das zurückgegebene Token gespeichert. Die Erneuerung ist nicht garantiert; ersetzen Sie Zugangsdaten bei Authentifizierungsfehlern.

Platzierung

Nur der ausgewählte Standard-Hook stellt den Feed dar. Ihr Theme muss diesen Hook aufrufen. Sie können zunächst auf der Startseite testen und den Feed anschließend in einen vom Theme unterstützten Footer- oder Spalten-Hook verschieben.

Layout

Beginnen Sie für ein Raster auf der Startseite mit 12 Beiträgen, vier Desktop-Spalten, zwei mobilen Spalten und drei Zeilen. So erscheinen bis zu 12 Beiträge auf Desktop-Geräten und sechs auf Mobilgeräten; Tablets verwenden drei Spalten. Zeilen begrenzt die sichtbaren Rasterelemente, während Anzahl der Beiträge die Gesamtobergrenze bleibt. Wählen Sie für einen Footer-Slider displayFooterBefore und slider, reduzieren Sie bei Bedarf Anzahl der Beiträge und blenden Sie für ein kompaktes Layout Begleittexte oder Datumsangaben aus.

Der mitgelieferte Slider liest Spalten- und Abstandsvariablen vom Abschnitt, während das Template sie am Raster definiert. Ohne entsprechende Variablen am Abschnitt durch Ihr Theme verwendet die Slider-Bewegung vier Elemente auf Desktop-Geräten, drei auf Tablets, zwei auf Mobilgeräten und 10px Abstand. Prüfen Sie den Slider nach Layoutänderungen.

Sichtbare Inhalte

Videos werden als Vorschaubilder mit Wiedergabemarkierung dargestellt. Karussell-Alben erscheinen als verlinkte Vorschau mit Galeriemarkierung; der Abrufcode fordert nicht alle Karussell-Unterelemente an und zeigt sie nicht vollständig an. Der Feed zeigt Kontomedien, keine Hashtag-Ergebnisse. Elemente ohne verwendbares Bild oder Video-Vorschaubild werden übersprungen.

Cache und Slider

Der Feed verwendet eine lokale JSON-Cache-Datei im Modulverzeichnis. Eine Shopanfrage ruft Medien ab, wenn die Datei fehlt oder älter als Cache-Dauer ist. Shops mit demselben Modulverzeichnis teilen diesen Cache. Es gibt keinen geplanten Aktualisierungsprozess.

Feed-Cache jetzt aktualisieren und das Speichern der Feed-Einstellungen leeren den Cache. Die nächste Shopanfrage ruft Medien ab und speichert nur nicht leere Ergebnisse. Bei API-Fehlern oder leeren Ergebnissen erscheint für diese Anfrage kein Feed; abgelaufene Inhalte werden nicht angezeigt. Lazy Loading verwendet IntersectionObserver und lädt Bilder sofort, wenn dieser nicht verfügbar ist.

Die Konfiguration enthält einen Veröffentlichungsbereich und einen Bereich für Blog-Beiträge. Zum Auflisten der Beiträge benötigt dieser Daten aus MPR Blog Revolution. Feed-Lesen und Veröffentlichen sind getrennte Vorgänge. Lassen Sie Automatische Veröffentlichung aktivieren entsprechend dem Installationsstandard deaktiviert, bis Sie möchten, dass veröffentlichte Blog-Inhalte externe Beiträge erzeugen. Das Speichern des Hauptformulars für den Feed setzt den separaten Veröffentlichungsschalter und die Beschriftungsvorlage zurück. Speichern Sie nach Änderungen der Feed-Einstellungen das Veröffentlichungsformular erneut.

Der Standardwert für Vorlage für die Bildunterschrift ist:

{title}

{excerpt}

{url}

Sie können auch {shop_name} verwenden. Ändern Sie beispielsweise den letzten Teil in Read the article: {url} und fügen Sie {shop_name} in einer weiteren Zeile hinzu.

Die automatische Veröffentlichung reagiert auf Hooks zum Hinzufügen/Aktualisieren von Objekten mit Veröffentlichungsstatus 1 und konfigurierten Zugangsdaten. Der Instagram-Publisher benötigt Zugriffstoken, Instagram-Benutzer-ID und ein Beitragsbild. Er erstellt einen Mediencontainer und reicht ihn zur Veröffentlichung ein. Er veröffentlicht kein Karussell mit mehreren Bildern.

Auch manuelle Schaltflächen im Bereich der neuesten Blog-Beiträge veröffentlichen echte Inhalte auf Instagram. Prüfen Sie vor der Verwendung den gewählten Beitrag, das Konto und den Begleittext und stellen Sie sicher, dass das Token Veröffentlichungsrechte hat.

Veröffentlichungsversuche verwenden gemeinsame persistente Warteschlangen-/Verlaufsdaten mit Prüfungen auf Duplikate und unbekannte Ergebnisse. Die Veröffentlichung wird während der Anfrage versucht; fehlgeschlagene Versuche müssen vor einer Wiederholung geprüft werden. Ist das Ergebnis unbekannt oder muss es abgeglichen werden, prüfen Sie vor einem erneuten Versuch das externe Konto und das Warteschlangenergebnis.

Die gemeinsame Schreibrichtlinie kann das Veröffentlichen auf einem Entwicklungs-/Staging-Host oder bei unklarem konfiguriertem Shop-Host blockieren. Verwenden Sie das angezeigte Ergebnis und die PrestaShop-Protokolle zur Diagnose. Zum Testen des Feed-Lesens muss die Veröffentlichungsrichtlinie nicht geändert werden.

Wenn die gespeicherte Einstellung zur Plattformaktivierung von mprsocialrevolution eingeschaltet ist, unterdrückt dieses Modul seinen eigenen Feed und die automatische Veröffentlichung für diese Plattform. Diese Übernahmeprüfung liest die Plattformeinstellung; sie prüft nicht nur, ob das andere Modul installiert ist.

• Prüfen Sie, ob die erforderlichen Zugangsdaten gespeichert sind, der Feed eingeschaltet ist und der gewählte Hook in Ihrem Theme ausgeführt wird.
• Leeren Sie den Cache, besuchen Sie den gewählten Bereich und prüfen Sie den angezeigten Feed. Prüfen Sie bei leerer Anzeige den Zeitstempel der Cache-Datei und PHP-/API-Fehler.
• Testen Sie Raster- oder Slider-Steuerung, mobile Sichtbarkeit, Folgen-Links und Beitrags-Permalinks. Like-/Kommentarzähler benötigen die Anfrage mit Benutzer-ID und zurückgegebene positive Werte.
• Wenn die Authentifizierung fehlschlägt, prüfen Sie Token, Konto-ID, externe API-Version und Berechtigungen. Beim Speichern muss das Token ausgefüllt sein; die externe Kontoidentität wird nicht geprüft. Eine Änderung des Benutzernamens allein ändert die API-Konto-ID nicht.
• Wenn das Veröffentlichen verweigert wird, prüfen Sie Modulzugriff des Mitarbeiters, Kontozugangsdaten, Ergebnis der Host-Richtlinie, Kompatibilität gemeinsamer Pakete und Status des vorherigen Versuchs. Veröffentlichen Sie nach einer unklaren Antwort nicht wiederholt.

Bewahren Sie Template-Überschreibungen in Ihrem Theme auf:

themes/your-theme/modules/mprinstagramintegration/views/templates/hook/feed.tpl
themes/your-theme/modules/mprinstagramintegration/views/templates/hook/post_item.tpl

Das CSS Ihres Themes kann .mprinstagram-section, .mprinstagram-title, .mprinstagram-grid, .mprinstagram-slider, .mprinstagram-item und .mprinstagram-follow-btn ansprechen. Verwenden Sie .mprinstagram-caption für die Gestaltung der Begleittexte. Zu den Layout-Variablen gehören --mprinstagram-gap und --mprinstagram-radius.

Deaktivieren Sie Modul aktivieren, um die Ausgabe zu pausieren. Deaktivieren Sie Automatische Veröffentlichung aktivieren separat, um die automatische Veröffentlichung zu stoppen. Bewahren Sie vor der Deinstallation die Zugangsdaten auf und sichern Sie den benötigten Veröffentlichungsverlauf. Die Deinstallation entfernt Menü und Einstellungen des Moduls, leert seinen Cache und führt die Schemabereinigung aus. Bereits auf Instagram erstellte Beiträge werden nicht gelöscht.