RITUS

Überblick

Ritus ist eine redaktionelle Content Suite innerhalb von Magento 2. Die Lösung verbindet Shopdaten, redaktionelle Planung und Veröffentlichung in einem gemeinsamen Arbeitsablauf. Ein zusätzliches externes CMS ist für den beschriebenen Funktionsumfang nicht erforderlich.

Funktionsumfang

• eigener Magento Blog für Hyvä
• Inhaltsplanung mit Produktzuordnung und Kampagnen
• vollständig manuelle Inhaltserstellung
• optionale OpenAI unterstützte Inhaltserstellung
• menschlicher Prüf und Freigabeprozess
• Redaktionskalender
• Facebook, Instagram Feed, Instagram Stories und Telegram
• Verbindungstests und Veröffentlichungsprüfung
• Versionshistorie und Inhaltsvorlagen
• kleiner Medienbereich zur Vorbereitung von Bildern
• automatische UTM Zuordnung und Magento bezogene Auswertung
• Schema.org Markup für den Ritus Blog

Voraussetzungen

Installation

Ritus wird als Magento Erweiterung in die vorhandene Shopumgebung integriert. Die sichtbare Produktbezeichnung lautet Vermontas Ritus. Die technischen Modulnamen verwenden ebenfalls die Ritus Bezeichnung.

Komplette Installationsfolge

php bin/magento module:enable Vermonta_Ritus Vermonta_RitusAi Vermonta_RitusBlog Vermonta_RitusPlanner Vermonta_RitusSocial
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f
php bin/magento cache:flush

Optional: Static Content nur für verwendete Sprachen

php bin/magento setup:static-content:deploy -f de_DE de_CH en_US fr_FR it_IT

Modulstatus prüfen

php bin/magento module:status Vermonta_Ritus
php bin/magento module:status Vermonta_RitusAi
php bin/magento module:status Vermonta_RitusBlog
php bin/magento module:status Vermonta_RitusPlanner
php bin/magento module:status Vermonta_RitusSocial

Einrichtung und Onboarding

Nach der Installation führt Ritus durch die wichtigsten Schritte bis zum ersten produktiven Inhalt. Nicht benötigte externe Dienste können ausgelassen werden.

Inhalte erstellen

Ritus trennt redaktionelle Planung und tatsächliche Veröffentlichung. Ein geplanter Inhalt kann zunächst nur aus Thema, Produkten und Notizen bestehen und später zu einem vollständigen Beitrag ausgebaut werden.

Typische Inhaltsfelder

Vollständig manuell arbeiten

Alle redaktionellen Felder können ohne KI gepflegt werden. Titel, Teaser, Artikeltext, Meta Title, Meta Description, Texte für Social Media, CTA und Hashtags lassen sich von der Redaktion selbst verfassen und bearbeiten.

Produktzuordnung

Produkte werden über eine Magento Auswahl mit Suche und Grid zugeordnet. Das erste Produkt bildet den Hauptkontext. Weitere Produkte ergänzen den Inhalt. Ritus hält die Produktkontexte getrennt, damit Eigenschaften verschiedener SKUs bei der KI Erstellung nicht miteinander vermischt werden.

KI Funktionen und Modelle

Die KI Funktionen verwenden den eigenen OpenAI API Zugang des Shopbetreibers. Ritus übermittelt den für die jeweilige Erstellung vorgesehenen Kontext und übernimmt die erzeugten Inhalte zurück in die redaktionellen Felder.

Verfügbare Modelle

Was Ritus erzeugen kann

• Titel und Teaser
• Artikelinhalt
• Meta Title und Meta Description
• Facebook Text
• Instagram Text
• Telegram Text
• Call to Action
• Hashtags

Redaktionelle Vorgaben

Über Schreibvorgaben und zusätzliche KI Anweisungen kann festgelegt werden, wie Inhalte formuliert werden sollen. Darüber hinaus können zusätzliche Magento Produktattribute gezielt als KI Kontext freigegeben werden.

Interne Kennzeichnung

Von der KI erzeugte Felder bleiben im Admin als KI erzeugt erkennbar. Manuelle Änderungen werden als bearbeitet nachvollziehbar. Diese Kennzeichnung dient der Redaktion und wird nicht automatisch als sichtbarer Hinweis in einen veröffentlichten Blog oder Social Media Beitrag geschrieben.

Prüfung und Freigabe

Ritus trennt Erstellung und Veröffentlichung bewusst voneinander. Ein KI Entwurf wird nicht allein dadurch zu einem veröffentlichten Inhalt, dass er erzeugt wurde.

Nach der Freigabe kann ein Inhalt geplant oder direkt veröffentlicht werden. Blog und einzelne Social Media Kanäle können unterschiedliche Veröffentlichungszeitpunkte besitzen.

EU AI Act und menschliche Prüfung

Ritus unterstützt einen echten Human in the Loop Prozess. KI erzeugte Felder bleiben intern erkennbar, werden redaktionell geprüft und erst nach bewusster Freigabe veröffentlicht. Nach einem abgeschlossenen menschlichen Prüf und Freigabeprozess fügt Ritus nicht automatisch einen sichtbaren Hinweis wie „KI erstellt“ in Blog oder Social Media Inhalte ein.

Versionshistorie

Frühere Inhaltsstände bleiben nachvollziehbar. Dadurch kann die Redaktion Änderungen vergleichen und bei Bedarf auf einen früheren Stand zurückgreifen.

Kampagnen und Kalender

Kampagnen bündeln mehrere Inhalte unter einem gemeinsamen redaktionellen Ziel. Zugehörige Blogbeiträge und Social Media Veröffentlichungen bleiben dadurch im Zusammenhang sichtbar.

Kampagnen

• eigene Kampagnen anlegen und verwalten
• Inhalte einer Kampagne zuordnen
• zugehörige Blog und Social Media Veröffentlichungen gemeinsam betrachten
• geplante Veröffentlichung im Kampagnenkontext organisieren

Redaktionskalender

Der Kalender zeigt geplante und veröffentlichte Inhalte. Blog und Social Media Kanäle können eigene Termine besitzen. Dadurch kann ein Blogartikel beispielsweise zuerst erscheinen und die begleitenden Social Media Beiträge zeitversetzt folgen.

Blog, SEO und Schema Markup

Ritus enthält ein eigenes Blogsystem für Magento 2 und Hyvä. Blogartikel können sowohl aus der Inhaltsplanung entstehen als auch direkt redaktionell gepflegt werden.

Blog Funktionen

• Kategorien und Beiträge
• responsive Kachelübersicht
• Beitragsseiten mit sprechenden URLs
• Store View Zuordnung
• Suche und Filter
• Pagination
• Featured Image Upload
• optionale Übernahme eines Produktbildes
• verknüpfte Produkte
• Meta Title und Meta Description
• Canonical URL
• Vorschau unveröffentlichter Beiträge
• zeitgesteuerte Veröffentlichung
• Cache Invalidierung bei relevanten Änderungen

Schema.org Markup ist enthalten

Ritus gibt für den Blog strukturierte Daten aus. Dadurch erhalten Suchmaschinen maschinenlesbaren Kontext für Beiträge, Übersichten und Navigation.

Indexierung und Vorschau

Öffentliche Blogbeiträge können indexiert werden. Suchseiten des Blogs sowie unveröffentlichte Vorschauen werden mit noindex behandelt. Canonical Angaben vermeiden unnötige URL Duplikate.

Social Media Veröffentlichung

Ritus kann freigegebene Inhalte direkt an die eingerichteten Social Media Kanäle übergeben. Jeder Kanal besitzt einen eigenen Text, Zeitpunkt und Veröffentlichungsstatus.

Instagram Bilder

Für die Instagram Veröffentlichung bereitet Ritus die benötigten Bilddaten lokal vor und prüft die Voraussetzungen. Für den Feed ist ein geeignetes JPEG Bild erforderlich.

Telegram

Der Telegram Bot muss im Zielchat beziehungsweise Kanal die erforderlichen Rechte zum Senden von Nachrichten besitzen. Die vollständige numerische Chat oder Channel ID ist einzutragen. Bei Gruppen und Channels kann diese ID ein führendes Minuszeichen enthalten und muss vollständig übernommen werden.

Verbindungen und Qualitätsprüfung

Verbindungstests

Facebook, Instagram und Telegram können direkt in Ritus geprüft werden. Die Tests sollen zeigen, ob die hinterlegte Verbindung, das Ziel und die grundsätzliche Erreichbarkeit funktionieren, bevor eine geplante Veröffentlichung davon abhängig ist.

Veröffentlichungsprüfung

Vor einer Veröffentlichung kontrolliert Ritus die für den jeweiligen Inhalt relevanten Voraussetzungen. Dazu können je nach Ziel gehören:

• vorhandener Inhalt
• erforderliches Bild
• SEO Felder für den Blog
• Verbindungsstatus eines externen Kanals
• Freigabestatus
• geplanter Veröffentlichungszeitpunkt

Medien und Vorlagen

Medienbereich

Der integrierte Medienbereich dient der Vorbereitung von Bildern für Blog, Feed und Story. Bilder können innerhalb des redaktionellen Ablaufs auf geeignete Formate und Seitenverhältnisse vorbereitet werden, ohne dafür den Ritus Workflow verlassen zu müssen.

Inhaltsvorlagen

Wiederkehrende redaktionelle Formate können als Vorlagen organisiert werden. Typische Beispiele sind Produktvorstellung, Ratgeber, Neuigkeit, Aktion oder Saisoninhalt.

Eine Vorlage kann wiederkehrende Strukturen wie Schreibvorgaben, CTA Logik oder andere redaktionelle Anforderungen vorbereiten. Sie ersetzt nicht die konkrete inhaltliche Prüfung des einzelnen Beitrags.

UTM Zuordnung und Auswertung

Ritus kann veröffentlichte Links automatisch mit eindeutigen Angaben zu Quelle, Medium, Kampagne und Inhalt versehen. Kommt ein Besucher über einen solchen Link in den Magento Shop, kann der Einstieg dem auslösenden Inhalt und Kanal zugeordnet werden.

Was ausgewertet wird

Ritus liest keine Reichweite, Likes, Reaktionen, Kommentare, Impressionen oder andere plattformeigene Social Media Kennzahlen aus externen Diensten aus.

Status, Wiederholungen und Veröffentlichungsprotokoll

Blog und Social Media Veröffentlichungen besitzen eigene Status. Dadurch bleibt nachvollziehbar, ob ein Inhalt geplant, veröffentlicht oder bei einem externen Kanal fehlgeschlagen ist.

Automatische Wiederholungen

Temporäre Fehler bei externen Veröffentlichungen können erneut versucht werden. Ein kurzzeitig nicht erreichbarer Dienst muss dadurch nicht automatisch zu einer dauerhaft verlorenen Veröffentlichung führen.

Veröffentlichungsübersicht

• Status pro Kanal
• geplanter beziehungsweise tatsächlicher Veröffentlichungszeitpunkt
• erkennbare Fehlerzustände
• Protokoll bereits ausgeführter Veröffentlichungen

Store Views und Sprachen

Ritus arbeitet Store View bezogen. Inhalte können dadurch sprachlich und redaktionell passend zum jeweiligen Shop Kontext gepflegt werden.

Updates und Troubleshooting

Update Ablauf

Sichern Sie vor einem Update die vorhandenen Ritus Modulverzeichnisse beziehungsweise verwenden Sie den in Ihrer Umgebung etablierten Deployment Prozess. Nach dem Austausch der Dateien wird das Magento Setup erneut ausgeführt.

php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f
php bin/magento cache:flush

Ritus Bereiche fehlen im Admin

• Modulstatus prüfen
• Magento Cache leeren
• Admin Sitzung bei Bedarf neu anmelden
• ACL Rechte der Administratorrolle prüfen

php bin/magento module:status Vermonta_Ritus
php bin/magento module:status Vermonta_RitusAi
php bin/magento module:status Vermonta_RitusBlog
php bin/magento module:status Vermonta_RitusPlanner
php bin/magento module:status Vermonta_RitusSocial
php bin/magento cache:flush

Geplante Veröffentlichungen laufen nicht

Prüfen Sie zuerst den Magento Cron. Anschließend kontrollieren Sie den Status des betroffenen Inhalts und verwenden bei externen Kanälen den jeweiligen Verbindungstest.

php bin/magento cron:run

Instagram Veröffentlichung schlägt fehl

• Verbindungstest ausführen
• prüfen, ob ein geeignetes Bild vorhanden ist
• JPEG Anforderung des Feed Workflows beachten
• Veröffentlichungsstatus und Protokoll prüfen

Telegram veröffentlicht nicht

• Bot Rechte im Zielchat oder Kanal prüfen
• vollständige numerische Chat oder Channel ID kontrollieren
• führendes Minuszeichen nicht entfernen
• Verbindungstest ausführen

KI Erstellung funktioniert nicht

• OpenAI API Zugang prüfen
• ausgewähltes Modell kontrollieren
• Netzwerkzugriff des Servers prüfen
• Magento Logs auf konkrete Fehlermeldungen prüfen

Support und Anpassungen

Ritus wird passend zur vorhandenen Magento und Hyvä Umgebung integriert. Umfang von Einrichtung, projektspezifischen Anpassungen, Übergabe und anschließendem Support richtet sich nach der jeweils vereinbarten Umsetzung.

Für technische Rückfragen sind insbesondere Magento Version, betroffene Store View, verwendeter Veröffentlichungskanal, Inhaltsstatus und eine möglichst genaue Beschreibung des erwarteten und tatsächlichen Verhaltens hilfreich.