Datenobjekt: PublicationArticle

News-Beiträge publizieren

Aufbau und Einsatz des Datenobjekts PublicationArticle

Das Datenobjekt „PublicationArticle“ wird auf CMS-Seiten eingebettet, sodass News-Inhalte auf den Webseiten der MOTOREX publiziert werden können. Das Datenobjekt taucht in der Datenobjekt-Baumstruktur von Pimcore der Tenants Intranet, MOTOREX, YORK, SPECTRO auf. So lassen sich News-Beiträge spezifisch nach Tenant publizieren.

Einen News-Beitrag auf der Webseite publizieren

Um einen neuen News-Beitrag auf der Webseite aufzuschalten muss in Pimcore ein neues PublicationArticle-Datenobjekt erstellt werden. Dazu wechseln wir in der Seitennavigation in den Bereich „Datenobjekte“ und wählen je nach dem auf welcher Webseite der News-Beitrag aufgeschaltet werden soll den entsprechenden Pfad:

  1. Datenobjekte > Intranet > CMS > News

  2. Datenobjekte > Motorex > CMS > News > 2024 (aktuelles Jahr)

  3. Datenobjekte > Spectro > CMS > News

  4. Datenobjekte > York > CMS > News

In diesem Beispiel wird ein neuer News-Beitrag des Tenants MOTOREX erstellt. Rechtsklick auf den Ordner „News“ (Pfad b.) > Objekt hinzufügen > ContentManagement > PublicationArticle.

Der Pfad zur Erstellung eines PublicationArticle Datenobjekts für den Tenant MOTOREX

Es erscheint ein Fenster um das Datenobjekt zu benennen. Wir wählen für das neue Objekt den Namen „Test-Article“ und bestätigen. Das PublicationArticle-Objekt ist nun unveröffentlicht angelegt und kann nun bearbeitet werden.

PublicationArticle Datenobjekte werden unveröffentlicht angelegt

Durch Klick auf das Objekt „PublicationArticle“ erscheint die Bearbeitungs-Maske im Arbeitsbereich.

Damit News-Beiträge nicht jedes Mal von Grund auf manuell erstellt werden müssen, wurden für die verschiedenen Business Units eigene Templates in Form von Snippets (Details unter Tenantspezifische übergeordnete Snippets > Publication) implementiert. Diese Templates erleichtern die Arbeit, da sie bereits vorstrukturierte Felder und Layoutvorgaben mitbringen.

Möglich wurde diese effiziente Vorgehensweise durch die Integration des Frameworks Pimcore Workflows. Dieses Workflow-Framework unterstützt den gesamten Erstellungs- und Freigabeprozess von News-Beiträgen. Redakteure können Inhalte roh oder als Template erfassen, zur Freigabe einreichen, von anderen prüfen lassen und final veröffentlichen — alles innerhalb eines geführten und nachvollziehbaren Prozesses.

Nach Wahl des gewünschten Templates kann der nächste Schritt (Sprachselektion) über den Button "Aktionen" > "Next" (Language) erreicht werden. Durch Klick auf diesen Button wird automatisch gespeichert.

Der Workflow kann via Aktionen > Next fortgeführt werden

Diese Anleitung wird durch zeigen der Workflow Schritte für Pimcore Einsteiger fortgesetzt.

Im Dropdown-Menü werden alle Sprachen ausgewählt, in denen der Newsartikel erstellt werden muss. Anschliessend klickt man oben rechts auf «Aktionen» und danach auf Next «Title and Teaser».

Step: Languages (Sparchauswahl)

In diesem Bereich können für jede gewählte Sprache der Titel und der Teasertext gepflegt werden. So wird sichergestellt, dass der Artikel in allen benötigten Sprachversionen vollständig hinterlegt ist und korrekt auf der Webseite angezeigt wird. Anschliessend klickt man oben rechts auf «Aktionen» und danach auf Next «Picture».

Step: Title & Teaser (Teaser Titel und Text)

Nun kann ein Teaser-Bild hinterlegt werden. Die Richtlinien werden durch die Kommunikations-Abteilung bestimmt. Grundsätzlich soll ein Bild hinterleget werden welches eine klare Vorstellung des kommunizierten Inhalts vermittelt. Via Drag&Drop über die Seitennavigation "Assets" können Bilder hinzugefügt werden. Alternativ über die Suchen-Funktion direkt unter "Teaser Image" (Lupe-Icon). Anschliessend klickt man oben rechts auf «Aktionen» und danach auf Next «Settings».

Step: Picture (Teaser-Bild)
Step: Settings (Klassifizierung eines News-Beitrags)

Im Schritt „Settings“ werden die grundlegenden Metadaten des Newsartikels festgelegt.

Zunächst muss man unter „Publication Type“ (Details unter Datenobjekt: Publication Type) auswählen, ob es sich um einen „News“-Beitrag oder um eine „Best Practice“ handelt. Die Auswahlmöglichkeiten liegen in der Verantwortung der Kommunikation.

Anschliessend wird das Feld „Topics“ gepflegt. (Details unter Datenobjekt: Topics). Bevor man ein Topic auswählt, sollte dies vorab mit der Kommunikation abgestimmt werden, um sicherzustellen, dass die Zuordnung korrekt erfolgt. Die Auswahlmöglichkeiten liegen in der Verantwortung der Kommunikation.

Die Sprachen, die angezeigt werden, sind bereits im vorherigen Schritt definiert worden und werden hier nochmals angezeigt.

Im Feld „Date“ wird das Publikationsdatum eingetragen. Hier sollte immer das tatsächliche Veröffentlichungsdatum verwendet werden. Das Datum hat Einfluss auf die Reihenfolge im Frontend.

Das Feld „Top News“ ist noch aus alten Strukturen und hat keine Logik mehr. Es wird entfernt oder umgebaut.

Unter „Template“ wird angezeigt, ob zu Beginn des Prozesses ein vorgefertigtes Template verwendet wurde. Dieses erscheint hier zur Information.

Anschliessend klickt man oben rechts auf «Aktionen» und danach auf Next «Display Filters».

Step: Display Filters (Steuerung des Beitrags)

Im Bereich „Display Filters“ wird definiert, für welche Zielgruppen der Newsartikel sichtbar sein soll.

Zunächst müssen die Länder ausgewählt werden, in denen der Artikel angezeigt werden soll. Zusätzlich wählt man die Lines (Produktlinien) aus, für die der Artikel relevant ist, zum Beispiel BIKE LINE, CAR LINE oder INDUSTRY LINE.

Darüber hinaus kann man auch Produktgruppen auswählen, wenn der Artikel für bestimmte Produktkategorien relevant ist.

Um einen bestehenden Wert wie ein Land, eine Line oder eine Produktgruppe auszuwählen, klickt man auf das Lupen-Symbol neben dem entsprechenden Feld. Im Suchfeld wird der Begriff eingegeben, und durch einen Doppelklick auf den gewünschten Eintrag wird dieser übernommen.

So wird sichergestellt, dass der Newsartikel zielgerichtet angezeigt wird – sowohl geografisch als auch produktspezifisch. Nach der Auswahl müssen die Änderungen via "Speichern"-Button gespeichert werden, bevor der nächste Schritt "Generate Snippets" erfolgen kann.

Wenn man auf „Generate Snippets“ klickt, werden für jede zuvor ausgewählte Sprache (im Schritt „Sprachen definieren“) automatisch Snippets erstellt. Diese Snippets basieren auf dem gewählten Template und beinhalten alle sprachspezifischen Felder, die anschliessend mit Inhalten (Content) gefüllt werden können.

Nach dem Erstellen der Snippets kann man direkt mit dem Verfassen des Textes beginnen und weitere Inhalte wie Bilder, Verlinkungen und Medien ergänzen.

Unter "Content" des Datenobjekts werden alle generierten Snippets verknüpft
Das DE-Snippet das mit dem Datenobjekt verknüpft ist

Nun kann der effektive Content im Snippet erstellt werden. Details zum Erstellen von Content anhand verschiedener Area Bricks werden unter Pimcore CMS > Grundlagen zur Bearbeitung von CMS-Seiten erklärt. Nach dem Erstellen des Contents in den gewünschten Sprachen kann der Beitrag veröffentlicht werden.

Das Publizieren eines News-Beitrags erfolgt in zwei Schritten

  1. Snippets veröffentlichen

  2. Datenobjekt veröffentlichen

Snippets werden zunächst im Status „unveröffentlicht“ erstellt. Das bedeutet, sie sind im System vorhanden, aber noch nicht live sichtbar. Um die Snippets zu veröffentlichen, muss man mit der rechten Maustaste auf das jeweilige Snippet klicken und anschliessend „veröffentlichen“ auswählen.

Neben dem Veröffentlichen der Snippets muss auch das Datenobjekt des Artikels selbst veröffentlicht werden. Wenn dieses nicht veröffentlicht ist, wird der Teasertext auf der Website nicht angezeigt.

Um das Datenobjekt zu veröffentlichen, wählt man es im Menü auf der linken Seite aus, klickt auf „Aktion“ und dann auf „veröffentlichen“. Erst wenn sowohl das Data-Objekt als auch die Snippets veröffentlicht sind, ist der News-Beitrag vollständig online sichtbar.

Hier endet die Grund-Anleitung welche den PublicationArticle Workflow erklärt. Es folgen weitere nützliche Infos sowie wiederholende, etwas ausführlichere Infos rund um PublicationArticles.

PublicationArticle: Der Advanced Mode

Der Advanced Mode zeigt alle Workflow-Schritte in einer Maske mit verschiedenen Reitern an. Fortgeschrittene Pimcore User müssen somit nicht den Workflow nutzen.

Reiter „Base Data“

Die Maske Base Data bestimmt die Basis-Daten des Teasers

Sprachen

Wie auch andere Datenobjekte kann auch das Objekt PublicationArticle nach Sprache erfasst werden. Die Sprache unter „Base Data“ definiert die Sprachversion des Teasers.

Standardmässig ist die Sprache „German“ geöffnet. Wird also ein Text unter „German“ erfasst, wird der Teaser Titel und Text bei späterer Veröffentlichung in Deutsch angezeigt. Je nachdem in welchen Sprachen der News-Beitrag erstellt werden, soll muss der Text der jeweiligen Sprache ergänzt werden.

Sprache

Webseite Land

German

Schweiz DE (de-ch)

German (Switzerland)

Schweiz (de-ch)

German (Germany)

Deutschland (de-de)

German (Austria)

Österreich (at-at)

French (Switzerland)

Suisse FR (fr-ch)

French (France)

France (fr-fr)

Swedish (Sweden)

Sverige (sv-se)

English (US)

USA (en-us)

English Switzerland

International EN (en-ch)

Spanish (Spain)

Wird nicht verwendet

Chinese

China (zh-cn)

French

Wird nicht verwendet

English

International EN (en-ch)

Spanish

Internacional ES (es-es)

Ist der News-Beitrag in mehereren Sprachen erfasst, wird er durch das Wechseln der Sprache auf der Webseite angezeigt

Title

Hier kann der Titel des Teasers vom News-Beitrag erfasst werden (Bsp. Test-Beitrag). SEO-Titles werden automatisch aus dem Titel des Artikels generiert. Diese Daten werden in Suchmaschinen ausgespielt und verbessern die Sichtbarkeit und Relevanz.

  • Limit (offiziell): 75 Zeichen (entspricht bei voller Breite ca. 2 Zeilen)

  • Limit (technisch): 80 Zeichen

Teaser Text

Hier wird der Kurztext des Teasers vom News-Beitrag erfasst. Dieser erscheint auf dem Teaser als Kurztext sowie auf der jeweiligen CMS-Seite des News-Beitrags. SEO-Descriptions werden aus dem Teaser-Text abgeleitet. Diese Daten werden in Suchmaschinen ausgespielt und verbessern die Sichtbarkeit und Relevanz.

  • Limit: 255 Zeichen (entspricht bei voller Breite ca. 5 Zeilen)

Per 01.12.2024 wurde für den Title und den Teaser-Text eine Maximallänge festgelegt.

Publication Type

Der Typ der Publikation kann gewählt werden. Zur Erstellung von Typen siehe unter "PublicationType"

Zur Typisierung von Publikationen

Date

Hier muss ein Erstellungsdatum der Publikation gewählt werden. Es erscheint oberhalb des Teaser Titels sowie auf der verknüpften CMS-Seite des News-Beitrags. Ebenso hat es Einfluss auf die Reihenfolge der Ausgegebenen Publikationen.

Top News - DEPRECATED

Sinnvolle Logik wird mit diesem Button übersteuert. Diese Funktion wurde aufgrund diversen Problematiken deaktiviert. Der Button wird entfernt, sofern keine neue sinnvolle Verwendung definiert wird. Um die automatisierte Ausgabe von Beiträgen zu übersteuern müssen die manuellen Publication-Komponenten verwendet werden. Generell wird empfohlen die aktuelle Anzeige-Logik nicht zu übersteuern.

Teaser Image

Hier kann via Drag&Drop aus den Assets oder durch Klick auf das Such-Symbol ein Bild für den Teaser sowie der verknüpften CMS-Seite hinterlegt werden.

Slug / URL

Die URL wird automatisch generiert und kann nicht angepasst werden

Maske „Content“

In dieser Maske muss nichts konfiguriert werden. Man sieht lediglich in welchem Zustand (veröffentlicht / unveröffentlicht) sich das „Snippet“, welches der Erstellung des Inhalts des News-Beitrags dient, befindet.

Die zweite Maske im Datenobjekt News-Article muss nicht bearbeitet werden

Content – Deprecated

Diese Maske wird aktuell (01.06.2024) nicht mehr verwendet und wird zu gegebenem Zeitpunkt umgebaut.

Advanced

In dieser Maske steuert man in welchen Bereichen auf der Webseite innerhalb des gewählten Tenants der News-Beitrag (inkl. Teaser) publiziert werden soll. Man definiert die News-Kategorie und zusätzlich werden die Länder definiert, für die der News-Beitrag freigegeben werden soll.

Kategorisierung des News-Beitrags

Jedes PublicationArticle-Objekt kann kategorisiert werden. Die Kategorie hat Einfluss darauf, in welchen Bereichen der Webseite der News-Beitrag publiziert wird. Auf all unseren Webseiten wurden durch die Marketingabteilung Bereiche definiert, bei denen Content wie News-Beiträge publiziert werden. Wird zum Beispiel ein News-Beitrag für die Bike-Line kategorisiert, erscheint dieser an den durch die Marketingabteilung definierten Bereichen der Bike-Line.

Zu beachten:

  • Der Benutzer ist nicht für die Definition und Konfiguration dieser Bereiche zuständig. Dies erfolgt aus Qualitätsgründen ausschliesslich durch die Marketingabteilung.

  • Alle möglichen Kategorien wurden bereits durch die Marketingabteilung definiert. Der Benutzer muss diese nur noch selektieren.

  • Je nach Tenant sind unterschiedliche Kategorien zu verwenden.

Kategorisierungsmöglichkeiten nach Tenant

Tenant
Kategorien
Verwendung

Intranet

News Marketing & Kommunikation

Ausschliesslich für die Abteilung Marketing zur Kategorisierung von News-Beiträgen im Intranet

"

HR News

Ausschliesslich für die Abteilung Human Resources zur Kategorisierung von News-Beiträgen im Intranet

"

News Events

Ausschliesslich für die Abteilung Events zur Kategorisierung von News-Beiträgen im Intranet

"

News Sales

Ausschliesslich für die Abteilung Verkauf zur Kategorisierung von News-Beiträgen im Intranet

Motorex, Spectro, York

Lines

Freie Verwendung für alle Benutzer. Zur Kategorisierung von News-Beiträgen auf der Webseiten der Tenants

"

Produktgruppen

Motorex, York und Spectro

Product Lines and Product Groups:

Durch Klick auf das Such-Symbol können die obenstehenden Kategorien ausgewählt werden:

Hier lassen sich die verschiedenen Kategorieren via Drag&Drop oder über das Such-Symbol hinzufügen

Auswahlmöglichkeiten Lines

Es können Lines als Mehrfachauswahl selektiert werden.

Durch Filtern nach "Category" werden die Lines angezeigt, die hinzufgefügt werden können

Auswahlmöglichkeiten Produktgruppen

Es können Produktgruppen (Motorenöle) und Produkttypen (2T-Motorenöl) als Mehrfachauswahl selektiert werden.

Durch Filtern nach ProductGroup werden die Produktgruppen angezeigt, die hinzugefügt werden können

Countries

Durch Klick auf das Such-Symbol können die zur Verfügung stehenden Länder ausgewählt werden:

Die selektieren Länder bestimmen in welchen Ländern der Webseite der News-Beitrag angezeigt wird
Die Auswahl der Länder entspricht der Länder Auswahlmöglichkeit der Webseite

Automatisches Erstellen der CMS-Seite

Sobald alle Pflichtfelder im Datenobjekt ausgefüllt wurden und man das Objekt gespeichert hat, wird automatisch in der Seitennavigation unter „Dokumente“ des jeweiligen Tenants (in diesem Fall MOTOREX) ein neuer Ordner erstellt. Sollte der Ordner nicht angezeigt werden muss entweder die Seite neu geladen werden oder es fehlt ein Pflichtfeld. In diesem Ordner werden standardmässig mehrere unveröffentlichte CMS-Seiten nach Sprache erstellt. In diesen CMS-Seiten bearbeitet man den sprachspezifischen Inhalt des News-Beitrags.

Ein PublicationArticle-Objekt mit ausgefüllten Pflichtfeldern....

Ein News-Article-Objekt mit ausgefüllten Pflichtfeldern

…erstellt automatisch ein Ordner im entsprechenden Tenant.

Wir sind nun bereit, den Inhalt des News-Beitrags für verschiedene Sprachen zu hinterlegen.

Wurden die Pflichtfelder im Datenobjekt ausgefüllt, wird automatisch ein neuer Ordner inkl. CMS-Seiten in allen Sprachvarianten erstellt

Inhalt des News-Beitrags erstellen

Durch Klick auf das jeweilige Snippet öffnet sich eine leere CMS-Seite im Arbeitsbereich.

  • Durch Klick auf das grüne Plus-Symbol können verschiedene CMS-Komponenten hinzugefügt werden.

  • Die separate Anleitung „CMS-Komponenten“ erklärt alle verfügbaren CMS-Komponenten im Detail

Durch Klick auf das grüne Plus-Symbol können neue CMS-Komponenten hinzugefügt werden.

Möchte man CMS-Komponenten von bereits erstellten Inhalten übernehmen, kann man diese aus den jeweiligen Snippets bzw. News-Beiträgen kopieren…

Bestehende CMS-Komponente kopieren

…und im Snippet des neuen News-Beitrags einfügen.

Kopierte CMS-Komponente einfügen

News-Beitrag nach Inhaltsgestaltung publizieren

Die Inhaltsgestaltung ist fertiggestellt. Durch Klick auf Speichern & Veröffentlichen wird der News-Beitrag publiziert.

Der Beitrag wird durch Klick auf Speichern&Veröffentlichen publiziert
Der publizierte News-Beitrag auf der Webseite von Motorex
Publizierte News-Beiträge werden je nach Kategorisierung auch in den Lines, Gesamtsortiment und Produktgruppen angezeigt

Darstellung Objekt PublicationArticle auf der Webseite

Teaser

Ein Beispiel eines Teasers. Klickt man darauf, erscheint die CMS-Seite des PublicationArticle Objekts:

Das UX-Design eines Teasers der Motorex

CMS-Seite des News-Beitrags (Inhalt des Teasers)

Durch Klick auf den Teaser wird die verknüpfte CMS-Seite des News-Beitrags geöffnet:

DIe CMS-Seite eines erstellten News-Beitrags

Anzeige-Logik PublicationArticle

Per 01.12.2024 gelten folgende Anzeigeregeln bei News-Beiträgen:

Generelle Anzeige Logik

Ausschlaggebend für die Anzeige von PublicationArticle Objekten ist das Feld "Date". Werden zwei PublicationArticle am selben Tag geschaltet greift die "ModificationDate" des Datenobjekts "PublicationArticle". In solchen Fällen prüft Pimcore somit bis auf die Sekunde, welcher Beitrag zuerst erstellt wurde.

Anzeige Logik unter Line, Produkte oder Produktgruppe

Senzario A: Es sind keine News-Artikel verknüpft

Es werden keine News angezeigt - die ganze Komponente wird ausgeblendet

Szenario A: 1 News-Beitrag verknüpft

  • Links: Der verknüpfte Beitrag wird angezeigt.

  • Mitte: Falls eine übergeordnete Line besteht, die über weitere Verknüpfte News verfügt, soll der Neuste Beitrag angezeigt werden.

    • Ansonsten soll von den “Top-News” der neuste Beitrag angezeigt werden (ausser es ist der bereits dargestellte, dann nächster)

    • Fallback: Der neuste “News”-Beitrag (ausser es ist der bereits dargestellte, dann nächster)

  • Rechts: Es wird ein allgemeiner Platzhalter angezeigt. Mit Platzhalter Bild, Titel und Teaser Text. Beim Klick darauf gelangt der User auf die Neues und Aktuelles-Seite.

  • Mobile: Es wird nur der verknüpfte Beitrag und der Platzhalter angezeigt (Kein Fallback)

Szenario B: 2 News-Beiträge verknüpft

  • Links und Mitte: Die verknüpften Beitrag (Datum absteigend von links nach rechts)

  • Rechts: Allgemeiner Platzhalter

Szenario C: 3 oder mehr News-Artikel verknüpft

  • Links, Mitte, Rechts: Es werden die drei neusten Beiträge angezeigt (Datum absteigend von links nach rechts)

Last updated