Social Revolution: Einrichtung und Hilfe

Laden Sie die ZIP-Datei von mprsocialrevolution unter Modul > "Module Manager" hoch und installieren Sie sie. Öffnen Sie Soziale Medien im Backoffice. Das Modul bietet Übersicht, Konten, Plattform verbinden, Beitrag verfassen, Beitragswarteschlange, Veröffentlichte Beiträge, Kampagnen, Beschriftungsvorlagen, Feed-Einstellungen, Analysen, Konversionen, Einstellungen und Cron & Planer; Konfigurations- und Wartungsseiten finden Sie unter Einstellungen.

Erfordert PrestaShop 1.6.1 oder neuer und PHP 7.1 oder neuer.

Beginnen Sie mit einem verbundenen Konto und einem kontrollierten Beitrag. Veröffentlichung, Storefront-Feeds und Werbetracking verwenden getrennte Konfigurationen. Die Verbindung eines Veröffentlichungskontos konfiguriert nicht automatisch ein Pixel und erstellt keine Einstellungen zur Feed-Anzeige.

Wählen Sie den gewünschten Shop-Kontext, bevor Sie Konfigurationen oder Warteschlangeneinträge ändern. Veröffentlichungseinstellungen werden zuerst für den Shop, dann für die Shop-Gruppe und schließlich global aufgelöst. Beiträge in der Warteschlange sind an einen Shop und die Identität eines Plattformkontos gebunden; ein Eintrag aus einem anderen oder unbekannten Shop erfordert einen Abgleich.

Öffnen Sie Plattform verbinden. Speichern Sie die Plattform-Zugangsdaten und durchlaufen Sie dann die Autorisierung. Kopieren Sie die vom Modul erzeugte Callback-URL bei Bedarf in die App-Konfiguration Ihres Anbieters. Schließen Sie die Autorisierung für das tatsächliche Konto, die Seite, Organisation oder Pinnwand ab, die Sie nutzen möchten.

Zugangsdaten sind anfangs leer. Prüfen Sie nach der Verbindung Konten. Abgelaufene, widerrufene oder erneut zu verbindende Konten blockieren die Veröffentlichung. Verbinden Sie diese erneut, bevor Sie Warteschlangenaufgaben wiederholen. Ein Konto mit unbekanntem Ablaufdatum hat einen eigenen Status; das bedeutet nicht, dass das Token gültig ist.

Für die Veröffentlichung müssen der Hauptschalter aktiviert, die Veröffentlichungskomponenten kompatibel, die Kontoidentität korrekt und der Shop zur Veröffentlichung berechtigt sein. Entwicklungs- und Staging-Shops sind gesperrt, sofern Ihr Administrator die Veröffentlichung nicht ausdrücklich erlaubt hat. Eine erfolgreiche Verbindung oder gespeicherte Beschriftung bedeutet nicht, dass ein Beitrag veröffentlicht wurde.

Öffnen Sie Soziale Medien > Einstellungen > Konfiguration. Das Formular heißt Einstellungen für Social Revolution und wird über Konfiguration speichern gespeichert.

Veröffentlichung

App-Zugangsdaten

Meta App-ID/Meta App Secret, LinkedIn Client-ID/LinkedIn Client Secret, Pinterest App-ID/Pinterest App Secret, TikTok Client-Schlüssel/TikTok Client-Secret und YouTube Client-ID/YouTube Client Secret sind standardmäßig alle leer. Geben Sie die App-Zugangsdaten der genutzten Plattformen ein oder speichern Sie sie über Plattform verbinden. TikTok-OAuth-Scopes ist standardmäßig user.info.basic. YouTube-Felder aktivieren keine funktionsfähige YouTube-Veröffentlichung.

Queue

Wiederholungslimit ist standardmäßig 3 und wird zur maximalen Anzahl der Versuche für den Warteschlangeneintrag. Gemeint sind nicht drei Wiederholungen zusätzlich zum ersten Versuch. Wiederholungsverzögerung ist standardmäßig 300 Sekunden und bildet die Grundlage für die Wartezeit zwischen Wiederholungen. Automatische Wiederholungen gelten nur für Fehler, die als wiederholbar eingestuft wurden. Konfiguration, Autorisierung, Validierung, abweichende Konten und ungewisse Ergebnisse auf der Plattform können eine manuelle Korrektur oder einen Abgleich erfordern.

Analysen

Analytics aktiviert ist standardmäßig auf Ja gesetzt. Die Analyse erfasst veröffentlichte und fehlgeschlagene Beiträge pro Konto. Reichweite, Impressionen, Interaktionen, Klicks und Follower erscheinen als null, weil diese Plattformkennzahlen nicht verfügbar sind; die Nullen stehen nicht für gemessene Publikumsaktivität.

Feeds

Aufbewahrung von Feed-Bildern in Tagen ist standardmäßig 7. Feed-Bilder behalten ist standardmäßig 120 pro Plattform. Diese Werte steuern die Aufbewahrung und Bereinigung zwischengespeicherter Bilder. Die Installation speichert außerdem einen Feed-Cache-Wert von 3600 Sekunden (FEED_CACHE_DURATION); das Formular bietet dafür kein Steuerelement.

"Theme styles"

Die gemeinsamen Steuerelemente für das Theme-Design verwenden erkannte Theme-Werte. Die Feed-Präfixe von Facebook und Instagram sind mprfacebook und mprinstagram. Ihre registrierten Zuordnungen umfassen Primärfarbe, Primärfarbe bei Hover, Text, gedämpften Text, Hintergründe, Rahmen, Radius, Schatten und Übergang. Ändern Sie diese Einstellungen, wenn das erkannte Design angepasst werden muss.

Öffnen Sie Beitrag verfassen und prüfen Sie Veröffentlichen auf. Schreiben Sie Basisbeschriftung und prüfen Sie dann das Beschriftungsfeld jeder ausgewählten Plattform. Die Basisbeschriftung wird in die einzelnen Plattformbeschriftungen kopiert. Prüfen Sie den kopierten Text vor dem Speichern oder Veröffentlichen.

Ergänzen Sie Link-URL und Titel, wo diese angeboten werden. Verwenden Sie erreichbare Medien-URLs. Instagram, Pinterest und TikTok erfordern Medien im Beitragseditor. Veröffentlichungen auf YouTube sind nicht verfügbar.

Wählen Sie die sofortige Veröffentlichung oder einen zukünftigen Termin. Verwenden Sie durchgehend die konfigurierte Zeit von Shop und Server und prüfen Sie den gespeicherten Zeitstempel in der Warteschlange. Die Planungsvalidierung erzwingt das maximale Zeitfenster und den LinkedIn-Veröffentlichungsabstand. Ein geplanter Beitrag benötigt Cron, um veröffentlicht zu werden.

Die gespeicherten Nutzdaten verwenden Namen wie:

platforms[]=facebook
platforms[]=linkedin
platform_data[facebook][caption]=Specific Facebook caption
platform_data[facebook][link]=https://example.com/article
platform_data[linkedin][caption]=Specific LinkedIn caption
platform_data[linkedin][link]=https://example.com/article
platform_data[linkedin][title]=Article title
media_urls[]=https://example.com/image.jpg
schedule_at=2026-11-01 09:30:00
id_campaign=12

Das tatsächliche Formular verwendet außerdem ein Übermittlungstoken. Wiederholen Sie Nutzdaten nicht als Ersatz für den geschützten Administrationsablauf.

Legen Sie unter Kampagnen Name, optional Beschreibung, Plattformen, Status, Startdatum und Enddatum fest. Der Status beginnt mit Entwurf; weitere Optionen sind Aktiv, Pausiert und Abgeschlossen. Öffnen Sie eine gespeicherte Kampagne, um über den Beitragseditor Beiträge hinzuzufügen. Prüfen Sie die entstandenen Warteschlangenzeilen; Kampagnendaten allein erstellen keine Beitragsinhalte.

Geben Sie unter Beschriftungsvorlagen Name, optional Plattform oder Alle Plattformen, Vorlage und Standard ein. Neue Textfelder sind anfangs leer; Standard ist eine boolesche Auswahl. Verwenden Sie eine plattformspezifische Vorlage, wenn Beschriftungslänge oder Formulierung abweichen.

Das Modul ersetzt die von der Inhaltsquelle bereitgestellten Platzhalter, darunter {title}, {excerpt}, {url}, {shop_name} und den optionalen Wert {hashtags}. Automatische Produkt-/Bloginhalte liefern standardmäßig keine Hashtags. Nicht aufgelöste Platzhalter in Kleinbuchstaben werden entfernt. Beispiel:

{title}

{excerpt}

Shop now: {url}

{hashtags}

Die enthaltenen plattformspezifischen Ersatzformate sind:

facebook:  {title}\n\n{excerpt}\n\nRead more: {url}
instagram: {title}\n\n{excerpt}\n\n{url}
x:         {title}\n\n{url}
linkedin:  {title}\n\n{excerpt}\n\n{url}
pinterest: {excerpt}
tiktok:    {title} {url}

Öffnen Sie Cron & Planer und kopieren Sie die genaue erzeugte URL einschließlich Token. Konfigurieren Sie Ihren Scheduler so, dass er sie jede Minute aufruft. Ein Beispiel ohne URL-Umschreibung:

curl 'https://yourshop.com/index.php?fc=module&module=mprsocialrevolution&controller=cron&token=YOUR_TOKEN'

Das Token ist erforderlich. Der Controller gibt bei fehlendem Token 401, bei ungültigem Token 403 und bei deaktiviertem Cron 503 zurück. Er sendet X-Robots-Tag: noindex, nofollow, noarchive. Optionale Ausführungsparameter sind max_tasks und max_seconds; verwenden Sie die erzeugten Scheduler-Anweisungen für Ihre Installation.

Zu den registrierten Aufgaben gehören die Warteschlangenverarbeitung alle 60 Sekunden, die Feed-Aktualisierung alle 1800 Sekunden, die Token-Aktualisierung und das nachträgliche Ergänzen von Feed-Bildern alle 3600 Sekunden, die tägliche Analyse um 06:00 sowie die Verarbeitung der Conversion-Warteschlangen der Anbieter alle 300 Sekunden. Dies sind Intervalle fälliger Aufgaben; Ihr externer Aufruf muss tatsächlich ausgeführt werden.

Prüfen Sie unter Beitragswarteschlange ausstehende, fehlgeschlagene, blockierte und abzugleichende Zustände. Unter Veröffentlichte Beiträge finden Sie erfasste Ergebnisse auf den Plattformen. Prüfen Sie das tatsächliche Ziel, bevor Sie bei unbekanntem Ergebnis erneut versuchen: Der Beitrag kann auf der Plattform existieren, obwohl sein Beleg nicht gespeichert werden konnte. Die Verbindung eines anderen Kontos ändert nicht das Ziel einer alten Warteschlangenzeile; verfassen Sie bei geändertem Ziel einen neuen Beitrag.

Die Feed-Ausgabe ist nur für Facebook und Instagram implementiert. Das Modul kann auf displayHome, displayFooterBefore, displayFooter, displayLeftColumn und displayRightColumn ausgeben, sofern ein aktiviertes Konto und eine passende Feed-Konfiguration vorhanden sind.

Feed-Einstellungen zeigt den Status verbundener Konten und die Aktion "Optimize existing feed images". Feed-Aktivierung, Platzierung, Layout und angezeigte Details können hier nicht konfiguriert werden und werden bei der Installation nicht eingerichtet. Ein Konto zu verbinden und einen Hook zuzuweisen, reicht für die Feed-Einrichtung nicht aus.

Lassen Sie den Feed durch Ihren Administrator oder den Support einrichten und prüfen Sie ihn anschließend im Shop. Die folgenden Konfigurationsschlüssel sind für diese Integration bestimmt und keine Felder der Einstellungsseite:

FEED_FACEBOOK_ENABLED=1
FEED_FACEBOOK_DISPLAY_HOOK=displayHome
FEED_FACEBOOK_POST_COUNT=8
FEED_FACEBOOK_LAYOUT=grid
FEED_FACEBOOK_COLUMNS=4
FEED_FACEBOOK_MOBILE_COLUMNS=2

FEED_INSTAGRAM_ENABLED=1
FEED_INSTAGRAM_DISPLAY_HOOK=displayFooterBefore
FEED_INSTAGRAM_LAYOUT=slider
FEED_INSTAGRAM_AUTO_SCROLL=1
FEED_INSTAGRAM_SCROLL_SPEED=5000

Für jedes Präfix FEED_{PLATFORM}_ liest der Renderer diese Optionen:

Wenn ein Abruf fehlschlägt, behält die Feed-Aktualisierung den letzten verwendbaren Cache. Das Bildcache-Werkzeug skaliert Bilder und erzeugt Formate, die GD/Imagick auf Ihrem Server unterstützt. Es benötigt Bearbeitungsrechte und beschreibbare Cache-Verzeichnisse. Feeds sind nur für Facebook und Instagram verfügbar.

Zu den Theme-Selektoren gehören .mprfacebook-section, .mprfacebook-grid, .mprfacebook-follow-btn, .mprinstagram-section, .mprinstagram-grid und .mprinstagram-slider-btn. Prüfen Sie das tatsächlich ausgegebene Markup, bevor Sie CSS anwenden. Gehen Sie nicht davon aus, dass für jeden Ausgabepfad ein allgemeiner, einheitlicher Social-Wall-Selektor existiert.

Zugangsdaten für Veröffentlichungskonten und Werbetracking sind getrennt. Öffnen Sie unter Einstellungen > Konfiguration den Tracking-Tab des Anbieters, aktivieren Sie dessen Browser-Tag und geben Sie die richtige Tracking-Kennung ein. Lassen Sie nur Ereignisse aktiviert, die Sie nutzen möchten. Konfigurieren Sie anschließend bei Bedarf die serverseitige Übermittlung gesondert.

Tracking ist für Facebook, Pinterest, Microsoft Ads, Google Ads, LinkedIn, TikTok, X, Snapchat, Reddit, Taboola und Outbrain implementiert. Die serverseitige Übermittlung benötigt Anbieter-Zugangsdaten und die geplanten Conversion-Aufgaben. Die Warteschlange für Google Ads-Klick-Conversions ist standardmäßig aktiviert, der API-Upload dagegen deaktiviert.

Verwenden Sie die Steuerelemente zur Tracking-Zuständigkeit auf der Konfigurationsseite, wenn mehrere installierte Module um dieselben Anbieterkennungen konkurrieren. Interner Traffic wird über den gemeinsamen Richtlinienbereich für Shop, Modul und Funktion gesteuert. Die einzelnen Anbieterformulare enthalten Mitarbeiter ausschließen nicht mehr; verwenden Sie die gemeinsame Richtlinie für internen Traffic.

Cookie-Einwilligung respektieren ist bei jedem Anbieter standardmäßig auf Ja gesetzt. Das Modul liest unterstützte MPR-Einwilligungscookies und deren Einwilligungsstatus. Ohne erteilte Marketing-Einwilligung bleibt einwilligungspflichtiges Tracking blockiert; es wird nicht automatisch erlaubt, nur weil kein Einwilligungsmodul vorhanden ist. Testen Sie Ablehnung und Zustimmung einschließlich der serverseitigen Übermittlung aus der Warteschlange.

Leer bedeutet, dass das Modul keine Zugangsdaten oder Kennung vorgibt. Ein standardmäßig auf 1 gesetzter Ereignisschalter aktiviert kein Tracking, solange der Hauptschalter seines Anbieters ausgeschaltet ist. Ihr Theme muss außerdem die entsprechenden Interaktionsereignisse senden.

Facebook-Tracking

Pinterest-Tracking

Microsoft Ads-Tracking

Google Ads-Tracking

LinkedIn-Tracking

TikTok-Tracking

X-Tracking

Snapchat-Tracking

Reddit-Tracking

Taboola-Tracking

Outbrain-Tracking

Der Tab Facebook-Tracking enthält außerdem einen Bereich zur Anzeige und Prüfung des Verbindungsstatus sowie eine Einrichtungsanleitung. Verwenden Sie dessen genaue Felder für Pixel-ID, Zugriffstoken und Testereignisse, um die Serververbindung zu prüfen.

Das aktuelle Formular und die Laufzeit bieten nicht mehr die frühere JSON-Einrichtung benutzerdefinierter Ereignisse mit beliebigen Klick-Selektoren. Fügen Sie die früheren Beispiele GalleryBrowse, conversion_label oder x_event_id nicht als undokumentierte Konfigurationswerte hinzu. Die ereignisspezifischen Google-Labels und X-IDs in den Tabellen sind unterstützte Steuerelemente.

Veröffentlichung

Verbinden Sie ein Konto, lassen Sie Veröffentlichung aktiviert eingeschaltet und erstellen Sie eine konkrete Beschriftung für ein ausgewähltes Ziel. Planen Sie den Beitrag für einen zeitnahen Termin, prüfen Sie ihn unter Beitragswarteschlange, rufen Sie Ihren konfigurierten Cron auf und prüfen Sie den Beitrag auf der Plattform sowie den Beleg unter Veröffentlichte Beiträge. Wiederholen Sie eine sofortige Veröffentlichung nur, wenn Sie einen weiteren tatsächlichen Beitrag erstellen möchten.

Lesen Sie bei blockierter Veröffentlichung die gemeldete Ursache. Prüfen Sie Hauptschalter, Kontostatus, Zielidentität, Host-Richtlinie, Bearbeitungsrechte des Mitarbeiters und Kompatibilität der gemeinsamen Pakete. Ein unbekanntes Plattform-Ergebnis muss vor einem erneuten Versuch abgeglichen werden. Ein fehlgeschlagener geplanter Beitrag kommt nicht zwangsläufig für eine automatische Wiederholung infrage.

Feeds

Prüfen Sie, ob der Plattform-Feed aktiviert und der genaue Hook konfiguriert ist, das verbundene Konto aktiviert ist und Beiträge im Cache oder aus der API vorliegen. Prüfen Sie die Storefront in Desktop- und Mobilansichten. Ein Feed erscheint nur dort, wo er eine aktivierte Platzierung hat, unabhängig vom Status unter Feed-Einstellungen.

Tracking

Testen Sie als Besucher, der durch die Richtlinie für internen Traffic zugelassen ist. Prüfen Sie zuerst die Ablehnung und dann die Erteilung der Marketing-Einwilligung. Durchlaufen Sie die gewählten, von Ihrem Shop unterstützten Produkt-, Warenkorb-, Kassen-, Such-, Registrierungs- und Kaufabläufe. Prüfen Sie die Browser-Werkzeuge des Anbieters, die Conversion-Ergebnisse des Moduls, die Cron-Ergebnisse und die Testberichte beim Anbieter. Prüfen Sie, ob ein Kauf der erwarteten Bestellung und den erwarteten Anbieter-IDs zugeordnet ist.

Wenn das Browser-Tag fehlt, prüfen Sie Anbieterschalter, Tracking-ID, Zuständigkeit, internen Traffic, Einwilligung und geladene Assets. Wenn Serverereignisse nicht ankommen, prüfen Sie die Schalter zur serverseitigen Übermittlung, Anbieter-Token, Conversion-Regeln/-Labels, Warteschlangenfehler und Cron. Der Google-Upload benötigt außerdem Kunden-/Aktionskennungen und einen lesbaren Service-Account-Schlüssel. Einen Schalter zu aktivieren, schließt die Anbietereinrichtung allein nicht ab.

Verwenden Sie Integrität bei Datenbank- und Hook-Fehlern. Publikumskennzahlen sind nicht verfügbar. Nutzen Sie die Werkzeuge der Plattform, um auf Kommentare zu antworten und den Posteingang zu verwalten.

Dokumentieren Sie Kontoeinrichtung, Warteschlangenstatus und Verlauf vor der Deinstallation. Die Deinstallation entfernt Theme-Registrierung, Cron-Aufgaben, Administrationsmenüs, Konfiguration, dem Modul gehörende Conversion-Warteschlangenzeilen und moduleigene Schematabellen wie Konten, Kampagnen, Vorlagen und Analysen. Gemeinsam genutzte Veröffentlichungs-/Warteschlangentabellen sind als gemeinsam genutzt markiert und werden bei der Schemabereinigung nicht gelöscht. Die Deinstallation lässt Feed- und Bildcache-Dateien auf dem Datenträger zurück. Prüfen Sie beim Entfernen des Pakets verbleibende Moduldateien gesondert.

Die Deinstallation des Moduls löscht keine Social-Media-Beiträge auf den Plattformen oder Datensätze auf Werbeplattformen. Wenn die Bereinigung der Theme-Registrierung fehlschlägt, meldet die Deinstallation einen Fehler, bevor die weiteren Entfernungsschritte erfolgen. Deaktivieren Sie das Modul, wenn Sie installierte Daten behalten und zugleich seine normalen Hooks stoppen möchten.