# 2. Erste Schritte Pimcore

### Pimcore Zugang

|                                  | URL                                |
| -------------------------------- | ---------------------------------- |
| Pimcore Produktivsystem (P)      | <https://motorex.com/admin/login>  |
| Pimcore Testsystem (QA)          | <https://pimcore-qa.motorex.com/>  |
| Pimcore Entwicklungssystem (Dev) | <https://pimcore-dev.motorex.com/> |

### Anmeldung <a href="#toc171245495" id="toc171245495"></a>

Die Anmeldung erfolgt anhand E-Mail Adresse und Passwort sofern initial ein Pimcore Login durch die Marketingabteilung bereitgestellt wurde.&#x20;

* Neue Logins können via E-Mail Anfrage an <webshop@motorex.com> beantragt werden.&#x20;
* Duch Klick auf "Kennwort vergessen?" kann das Passwort zurückgesetzt werden
* Loginprobleme? Hilfe unter [Webshop Troubleshooting für Business Units](https://motorex-1.gitbook.io/motorex/haufig-gestellte-fragen)

Bei der ersten Anmeldung in Pimcore, erscheint einFenster für die 2-Faktor Authentifizierung. Die Authentifizierung erfolgt anhand derselben App, "Sophos Intercept X", für die VPN-Verbindung zum MOTOREX Netzwerk.&#x20;

<table><thead><tr><th width="343">App / Betriebssystem</th><th>Download Link</th></tr></thead><tbody><tr><td>Sophos Intercept X for Mobile (Android)</td><td><a href="https://play.google.com/store/apps/details?id=com.sophos.smsec&#x26;hl=de_CH&#x26;pli=1">https://play.google.com/store/apps/details?id=com.sophos.smsec&#x26;hl=de_CH&#x26;pli=1</a></td></tr><tr><td>Sophos Intercept X for Mobile (iOS)</td><td><a href="https://apps.apple.com/de/app/sophos-intercept-x-for-mobile/id1086924662">https://apps.apple.com/de/app/sophos-intercept-x-for-mobile/id1086924662</a></td></tr></tbody></table>

Durch scannen des QR-Codes anhand der Sophos App wird ein Authentifizierungs-Code zur Verfügung gestellt, welcher sich laufend aktualisiert.

<figure><img src="https://1483599048-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkHyho5Kn3U8bWBYfwVBk%2Fuploads%2FC3Cx0oC9yAGHq7rNPhwd%2Fimage.png?alt=media&#x26;token=13ecc3c1-4f6a-4606-b14c-b15d51febd4b" alt="" width="339"><figcaption><p>Die 2-Faktor Authentifizierng muss initial und einmalig eingerichtet werden.</p></figcaption></figure>

<figure><img src="https://1483599048-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkHyho5Kn3U8bWBYfwVBk%2Fuploads%2FsTD1IOJATuABdvm8qTAW%2Fimage.png?alt=media&#x26;token=72a0a548-e164-45e0-9077-9913bceea220" alt=""><figcaption><p>Der Authentifizierungs-Code wird in der Sophos App zur Verfügung gestellt.</p></figcaption></figure>

### Übersicht der Benutzeroberfläche <a href="#toc171245496" id="toc171245496"></a>

Nach erfolgreichem Login gelangt man zur Startmaske in Pimcore.&#x20;

<div data-full-width="true"><figure><img src="https://1483599048-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkHyho5Kn3U8bWBYfwVBk%2Fuploads%2Fi6oynqPSqh9PK9jXUSl4%2Fimage.png?alt=media&#x26;token=48b704b5-f8bc-476d-a5c9-94af570a3058" alt=""><figcaption><p>Wie sich der Einstieg in Pimcore nach erfolgreichem Login präsentiert</p></figcaption></figure></div>

### Erklärung der Benutzeroberfläche

### 1. Navigationsmenü

Im Navigationsmenü von Pimcore finden Sie die wichtigsten Hauptbereiche und Funktionen der Software, die für die Verwaltung und Veröffentlichung digitaler Inhalte und Daten verwendet werden. Hier ist eine Übersicht über die Elemente:

### 1.1 Menüpunkt "Datei"

<figure><img src="https://1483599048-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkHyho5Kn3U8bWBYfwVBk%2Fuploads%2FgwwuHC9krTMe2kKpMJTr%2Fimage.png?alt=media&#x26;token=e18d5bc3-9478-4118-9bee-74d335eaa969" alt=""><figcaption><p>Durch Klick auf Datei im Navigationsmenü</p></figcaption></figure>

#### Perspektiven

In dieser Rubrik können die Perspektiven von Pimcore gewechselt werden, sofern diese in der Rubrik *"Einstellungen > Perspektiven/Ansichten"* konfiguriert wurden. In Pimcore bezeichnen "Perspektive&#x6E;**"** unterschiedliche Ansichten oder Arbeitsumgebungen innerhalb der Benutzeroberfläche, die es ermöglichen, spezifische Aufgaben und Workflows effizient zu verwalten. Jede Perspektive bietet eine angepasste Ansicht auf die relevanten Daten und Funktionen, die für einen bestimmten Anwendungsbereich notwendig sind.&#x20;

#### Dashboard

Der Bereich "Dashboar&#x64;**"** in Pimcore bietet eine zentrale Übersicht über wichtige Kennzahlen, Statistiken und aktuelle Aktivitäten. Es ist ein anpassbarer Bereich, der Benutzern ermöglicht, auf einen Blick relevante Informationen und Daten zu sehen, die für ihre täglichen Aufgaben und Entscheidungen wichtig sind.

#### Kollektionen

In Pimcore bietet der Bereich **"**&#x4B;ollektione&#x6E;**"** unter dem Menüpunkt **"Datei"** spezielle Funktionen, die es Benutzern ermöglichen, Gruppen von Datenobjekten, Assets oder Dokumenten zu erstellen, zu organisieren und gemeinsam zu verwalten.

#### Dokument mit ID öffnen

Die Funktion **"**&#x44;okument mit ID öffnen" in Pimcore ermöglicht es Benutzern, ein bestimmtes Dokument direkt zu öffnen, indem sie dessen eindeutige Identifikationsnummer (ID) eingeben. Dies ist besonders nützlich, wenn Benutzer schnell auf ein bestimmtes Dokument zugreifen möchten, ohne durch die gesamte Dokumentenstruktur navigieren zu müssen.

#### Öffne Asset via ID

Die Funktion **"**&#x41;sset mit ID öffnen" in Pimcore ermöglicht es Benutzern, ein bestimmtes Asset direkt zu öffnen, indem sie dessen eindeutige Identifikationsnummer (ID) eingeben. Dies ist besonders nützlich, wenn Benutzer schnell auf ein bestimmtes Asset zugreifen möchten, ohne durch die gesamte Assetstruktur navigieren zu müssen.

#### Datenobjekt öffnen

Die Funktion **"**&#x44;atenobjekt mit ID öffnen" in Pimcore ermöglicht es Benutzern, ein bestimmtes Datenobjekt direkt zu öffnen, indem sie dessen eindeutige Identifikationsnummer (ID) eingeben. Dies ist besonders nützlich, wenn Benutzer schnell auf ein bestimmtes Datenobjekt zugreifen möchten, ohne durch die gesamte Datenobjektstruktur navigieren zu müssen.

#### Suche & Ersetze Zuweisungen

Die Funktion **"**&#x53;uche & Ersetze Zuweisunge&#x6E;**"** in Pimcore bietet eine leistungsfähige Möglichkeit, innerhalb von Datenobjekten, Dokumenten oder digitalen Assets bestimmte Werte zu suchen und durch andere zu ersetzen. Dies ist besonders nützlich, um Änderungen in großem Umfang effizient durchzuführen.&#x20;

<details>

<summary>Beispiel:</summary>

Viele Produkte enthalten in ihrer Beschreibung eine alte Bezeichnung die geändert werden muss. &#x20;

1. Geben Sie im Suchfeld den veralteten Text ein, den Sie in den Produktbeschreibungen finden möchten.&#x20;
2. Wählen Sie das Datenobjekt oder die Dokumententypen aus, in denen gesucht werden soll (z.B. Produktdatenobjekte).
3. Geben Sie im Feld "Ersetzen durch" die neue Bezeichnung ein.

Pimcore durchsucht nun alle ausgewählten Datenobjekte oder Dokumente und ersetzt überall, wo Text xy in den Produktbeschreibungen vorkommt, diesen Text durch die neue Bezeichnung.

</details>

#### zuletzt geöffnete Elemente

Zeigt alle Elemente bzw. Objekte auf die zuletzt geöffnet wurden.&#x20;

#### Vorschaumodus

Der **Vorschaumodus** in Pimcore ist eine Funktion, die es Benutzern ermöglicht, den aktuellen Stand von Inhalten (wie Webseiten, Dokumenten oder Produkten) so zu betrachten, wie sie später im Frontend erscheinen werden. Dies ist besonders nützlich für Redakteure, Entwickler und Marketing-Teams, um sicherzustellen, dass alle Änderungen korrekt dargestellt werden, bevor sie veröffentlicht werden.

#### Schliesse alle Tabs

Schliesst alle offenen Tabs oberhalb des Arbeitsbereichs (siehe Übersicht Benutzeroberfläche)

#### Hilfe

Dokumentation: Öffnet die internationale und offizielle Pimcore Dokumentation

Fehler melden: Öffnet github von Pimcore. Hier können Entwickler Bugs von Pimcore melden

#### Über Pimcore

Zeigt die aktuelle Version von Pimcore an

### 1.2 Menüpunkt "Werkzeuge"

<figure><img src="https://1483599048-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkHyho5Kn3U8bWBYfwVBk%2Fuploads%2FZcTrR9y8LzAqcgItw0rV%2Fimage.png?alt=media&#x26;token=56b5fd5e-e5bf-4dfe-a761-b81335e6d6b3" alt=""><figcaption><p>Durch Klick auf Werkzeuge im Navigationsmenü</p></figcaption></figure>

#### Weiterleitungen

Der Bereich **"**&#x57;eiterleitunge&#x6E;**"** in Pimcore dient der Verwaltung von URL-Weiterleitungen. Diese Funktion ermöglicht es Benutzern, Umleitungen von alten oder nicht mehr existierenden URLs zu neuen URLs einzurichten. Dies ist besonders wichtig für die Aufrechterhaltung der Benutzerfreundlichkeit und SEO-Wert einer Webseite, wenn Inhalte verschoben oder URLs geändert werden.

#### Glossar

Der Bereich **"**&#x47;lossa&#x72;**"** in Pimcore dient zur Verwaltung und Definition von Begriffen und deren Erklärungen, die auf einer Webseite verwendet werden. Diese Funktion ermöglicht es, spezielle Begriffe automatisch zu verlinken oder hervorzuheben, wenn sie in den Inhalten der Webseite auftauchen.

#### Übersetzungen&#x20;

In Pimcore ermöglicht die Übersetzungsfunktion das Management mehrsprachiger Inhalte und Daten. Dies ist besonders wichtig für Unternehmen, die in mehreren Ländern tätig sind und ihre Inhalte in verschiedenen Sprachen anbieten möchten.

{% hint style="warning" %}
Faustregel: Grundsätzlich sollen die Übersetzungen sämtlicher Elemente und Daten aus SAP kommen da die Pflege zentral über das ERP erfolgt. Alle Daten/Inhalte die nicht in SAP übersetzt werden können, werden in Pimcore übersetzt.
{% endhint %}

<details>

<summary>Prozess für Übersetzungen in Pimcore</summary>

Entsteht ein neues Feature wie beispielsweise die Merkliste im Webshop, müssen sämtliche neu programmierten Elemente unter *Werkzeuge > Übersetzungen > Übersetzungen* übersetzt werden. Initial wird der Story in Jira automatisch der Sub-Task "Translations" zugewiesen. Valantic definiert für jedes Element das übersetzt werden soll einen **Schlüssel bzw. Key**. Diese Keys befinden sich in Pimcore Übersetzungen unter Kolonne 1 (Schlüssel). Der PIM-Manager pflegt dann für jeden Key die entsprechende Übersetzung in allen Sprachen. Sind die Übersetzungen gepflegt werden die Änderungen im Frontend durch Klick auf "Frontend Übersetzungen aktualisieren" übernommen.&#x20;

&#x20; <img src="https://1483599048-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkHyho5Kn3U8bWBYfwVBk%2Fuploads%2Fm3qdjzO6Ov4lbWoXBTKl%2Fimage.png?alt=media&#x26;token=4eee5dd1-05de-45db-bbe9-415b1c38ca5d" alt="" data-size="original">![](https://1483599048-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkHyho5Kn3U8bWBYfwVBk%2Fuploads%2FU9nBki0i6OS5rLwa5mFE%2Fimage.png?alt=media\&token=52a21683-79c2-4a22-abd6-6741cc054709)

</details>

<figure><img src="https://1483599048-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkHyho5Kn3U8bWBYfwVBk%2Fuploads%2FFXMvkS6Oizw6pp8j3a2h%2Fimage.png?alt=media&#x26;token=b6db1be8-467f-432e-a2da-0f5619ef7678" alt=""><figcaption><p>Übersicht aller Übersetzungen unabhängig vom Tenant</p></figcaption></figure>

#### Papierkorb

Pimcore Administratoren können fast ausnahmslos Objekte in Pimcore löschen. Gelöschte Objekte können unter *Werkzeuge > Papierkorb* wiederhergestellt oder endgültig gelöscht werden. Kann aus Berechtigungsgründen ein gelöschtes Objekt nicht wiederhergestellt werden, ist der PIM-Manager via E-Mail zu benachrichtigen.

{% hint style="danger" %}
Beim Löschen von Datenobjekten oder Ordnern die Datenobjekte enthalten ist besondere Vorsicht geboten. Es gibt Konstellationen die nicht wiederhergestellt werden können. Vor dem Löschen dieser Objekte soll vorgängig Valantic in Kenntnis gesetzt werden.
{% endhint %}

#### Notizen und Termine

Auf jedem Objekt lassen sich interne Notizen bzw. Hilfestellungen hinterlegen. Diese Notizen findet man gesammelt unter *Werkzeuge > Notizen und Termine.*&#x20;

{% hint style="info" %}
Um eigene Notizen wieder finden zu können kann in der Spalte "Benutzer" nach dem Namen gesucht werden
{% endhint %}

<figure><img src="https://1483599048-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkHyho5Kn3U8bWBYfwVBk%2Fuploads%2FFIN7QbS5KNEk8ge8W4lv%2Fimage.png?alt=media&#x26;token=00253843-a9da-478e-ba4c-1e13bc365661" alt=""><figcaption><p>Gefilterte Suche nach Notizen eines bestimmten Benutzers</p></figcaption></figure>

#### DSGVO Daten Exporter

Der DSGVO-Datenexporteur in Pimcore ermöglicht es Benutzern, Daten gemäß den Bestimmungen der Datenschutz-Grundverordnung (DSGVO) zu exportieren. Die Daten können im .json Format exportiert werden.&#x20;

Die Suche erfolgt anhand der Pimcore ID für alle Objekte. Benutzerdaten können anhand Vor- und Nachname sowie E-Mail Adresse gesucht werden.

#### E-Mail

Pimcore selbst ist kein E-Mail-Client oder E-Mail-Dienst. Stattdessen integriert es sich oft mit externen E-Mail-Systemen oder Dienstleistern über APIs, um E-Mail-Funktionalitäten in seine Anwendungen zu integrieren. Dies bedeutet, dass Pimcore in der Lage ist, E-Mail-Versandfunktionalitäten zu unterstützen, zum Beispiel für **automatisierte Benachrichtigungen**, **Bestätigungs-E-Mails** bei **Formulareingaben** oder ähnliche Anwendungsfälle innerhalb von Geschäftsanwendungen.

{% hint style="info" %}
MOTOREX verwendet Postmark als E-Mail-Dienst: <https://account.postmarkapp.com/servers>

Die Zugangsdaten für Postmark ist nur der IT- sowie der Marketingabteilung vorbehalten.
{% endhint %}

Unter *Werkzeuge > Versendete E-Mails* können alle automatisierte Standard E-Mails die an Benutzer (Mitarbeitende/Kunden) versendet werden eingesehen, nochmals versendet, weitergeleitet und gelöscht werden.

<figure><img src="https://1483599048-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkHyho5Kn3U8bWBYfwVBk%2Fuploads%2FkiCZZFGCXA3993LbzinD%2Fimage.png?alt=media&#x26;token=0226c760-87e0-4664-bb69-b271816035da" alt=""><figcaption><p>Einsicht in die Funktion "Versendete E-Mails" in Pimcore</p></figcaption></figure>

<table data-full-width="false"><thead><tr><th width="249">Subjet</th><th width="372">Typ</th><th width="340">Empfänger</th></tr></thead><tbody><tr><td>Bestellbestätigung Shop</td><td>Webshop Bestellbestätigung</td><td>Kunde</td></tr><tr><td>register_motorex</td><td>Erhaltenes Registrationsformular für den Webshop</td><td>Verkaufsinnendienst (webshop@motorex.com)</td></tr><tr><td>Ihre Anfrage bei MOTOREX</td><td>Bestätigung des übermittelten Anfrage-Formulars</td><td>Kunde</td></tr><tr><td>Passwort setzen</td><td>Initiales Setzen des Passworts für den Webshop  (Wird bei Vergabe der B2B-E-Shop Rolle im CRM verschickt. )</td><td>Kunde</td></tr></tbody></table>

<details>

<summary>Prozess zur Bearbeitung bestehender oder Erstellung neuer Standard-E-Mails</summary>

<mark style="background-color:red;">tba</mark>

</details>

<mark style="color:red;">Marketing</mark>

<mark style="color:red;">Einstellungen</mark>

<mark style="color:red;">Onlineshop</mark>

<mark style="color:red;">Customer Management Framework</mark>

<mark style="color:red;">Datahub</mark>

#### Suchen

Die Suche ermöglich ein effizientes Suchen von Objekten und ist eine beliebte Alternative zum Navigationsbaum. Es besteht jeweils die Möglichkeit nach allen Objekten anhand des eigegebenen Suchworts...

<figure><img src="https://1483599048-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkHyho5Kn3U8bWBYfwVBk%2Fuploads%2FLpU3JaAUQEKJi3f3VJFV%2Fimage.png?alt=media&#x26;token=0b32e5a0-f0e9-44e1-9106-837b3a80d6ec" alt=""><figcaption></figcaption></figure>

...oder gefiltert nach Objekttyp (Dokumenten, Assets oder Datenobjekten) zu suchen.

<figure><img src="https://1483599048-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkHyho5Kn3U8bWBYfwVBk%2Fuploads%2F9EAK8VoavtRc3ODE9DVi%2Fimage.png?alt=media&#x26;token=8f83c0b2-ebd0-4682-bc9e-0e95fac1dbed" alt=""><figcaption><p>Suche nach Datenobjekten</p></figcaption></figure>

{% hint style="info" %}
Eine gefilterte Suche nach Objekttyp führt in der Regel schneller zum Ziel da zusätzliche Suchfilter bestehen.
{% endhint %}

<mark style="color:red;">Pimcore Lizenz</mark>

<mark style="color:red;">Benachrichtigungen</mark>

<mark style="color:red;">Mein Profil</mark>

Unter „Mein Profil“ im Navigationsmenü kann das Profil des Benutzers konfiguriert werden.

<figure><img src="https://1483599048-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkHyho5Kn3U8bWBYfwVBk%2Fuploads%2FGdFBKU9SovwMFlEH7R53%2Fimage.png?alt=media&#x26;token=36822771-20dd-4926-828b-035f4ac68b31" alt="" width="368"><figcaption><p>Mein Profil im Navigationsmenü</p></figcaption></figure>

Folgende Einstellungen können vorgenommen werden:

1. Allgemeine Einstellungen (vordefiniert)
2. Anpassung Name, E-Mail, Systemsprache
3. Passwort ändern
4. Überschreiben des Passworts
5. Blitz-Symbol zur auto Generierung eines neuen Passworts
6. Zwei-Faktor Authentifizierung
   1. Einrichten
   2. erneuern
7. Profilbild hochladen

{% hint style="danger" %}
Die Zwei-Faktor Authentifizierung soll aus Sicherheitsgründen immer aktiviert sein und erfolgt via App „Intercept X“ von Sophos. Die Einrichtung erfolgt im gleichen Prinzip wie bei der VPN-Einrichtung – es muss lediglich initial der QR Code in der Intercept X-App gescannt werden. Danach ist ein Sicherheitscode für Pimcore in der App ersichtlich.
{% endhint %}

<figure><img src="https://1483599048-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkHyho5Kn3U8bWBYfwVBk%2Fuploads%2Fnu5COCSFCJpIq5YaH7MQ%2Fimage.png?alt=media&#x26;token=8d1e11a9-9256-467b-9a37-e152c11b9c2a" alt=""><figcaption><p>Einstellungen unter "Mein Profil"</p></figcaption></figure>

**Ausloggen**

Der Benutzer kann sich über den Button "Ausloggen" von Pimcore abmelden.&#x20;

### Navigationsbaum / Seitennavigation

Dokumente

Verwaltung und Organisation von Webseiten, Artikeln, Landing Pages und anderen Inhalten im Content Management System (CMS).

Assets

Verwaltung von digitalen Medien und Dateien wie Bildern, Videos, Dokumenten und anderen digitalen Assets im Digital Asset Management (DAM).

Datenobjekte

Verwaltung und Organisation von strukturierten Datenobjekten wie Produkten, Kategorien, Kunden, etc. im Product Information Management (PIM) und Master Data Management (MDM).

3. Tabs / Registerkarten

Alle selektierten Objekte werden in einem neuen Tab, bzw. in einer neuen Registerkarte geöffnet, ähnlich wie bei einem Internet-Browser. Dies ermöglicht Benutzern , mehrere Aufgaben gleichzeitig zu verwalten und zwischen ihnen zu wechseln.&#x20;

4. Arbeitsbereich

Wird ein Bereich oder Objekt in Pimcore selektiert, öffnet sich der Inhalt im Arbeitsbereich zur weiteren Bearbeitung

### Kontextmenü

Das Kontextmenü ist ein zentrales Bedienelement in Pimcore und erleichtert die tägliche Arbeit erheblich. Es öffnet sich durch einen Rechtsklick auf ein Element – sei es ein Dokument, Asset oder Datenobjekt – und bietet alle relevanten Aktionen, die für dieses Element verfügbar sind.

Je nachdem, welche Art von Inhalt ausgewählt wird , passt sich das Kontextmenü dynamisch an. So stehen beispielsweise für einen Ordner andere Optionen zur Verfügung als für eine einzelne Datei oder ein Dokument. Auch ist die Auswahl von der erteilten Berechtigung des Users abhängig. Typische Funktionen sind: Kopieren, Ausschneiden, Löschen, Umbenennen, Veröffentlichen, oder Eigenschaften anzeigen.

Das Kontextmenü ermöglicht einen schnellen und direkten Zugriff auf häufig genutzte Befehle, ohne dass Benutzer*innen lange in der Menüstruktur suchen müssen. Gerade für neue Anwender*innen ist es ein wichtiger Bestandteil, um die Navigation und Bearbeitung in Pimcore intuitiv und effizient zu gestalten.

#### Auswahlmöglichkeiten Kontextmenu je Navigationsbereich

| Dokumente                                                                                                                                                                                                                                                  | Assets                                                                                                                                                                                                                                                     | Datenobjekte                                                                                                                                                                                                                                               |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <img src="https://1483599048-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkHyho5Kn3U8bWBYfwVBk%2Fuploads%2FgR4XlXPJOe0j4p5gpVFf%2Fimage.png?alt=media&#x26;token=881bc9c1-a968-48f0-90cd-b3e27f4cc82c" alt="" data-size="original"> | <img src="https://1483599048-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkHyho5Kn3U8bWBYfwVBk%2Fuploads%2FvvPIbDzD9IkI4ryTq1UK%2Fimage.png?alt=media&#x26;token=f4234f3c-a8c1-44b8-8ed9-aaf75df604c3" alt="" data-size="original"> | <img src="https://1483599048-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkHyho5Kn3U8bWBYfwVBk%2Fuploads%2FMR1Si7vvBAEzYWF4DdSQ%2Fimage.png?alt=media&#x26;token=ac5860b1-00ba-4c15-bebf-3aab3c27723b" alt="" data-size="original"> |

#### Erklärung Auswahlmöglichkeiten Kontextmenu je Navigationsbereich

#### Dokumente

<table data-full-width="true"><thead><tr><th width="203">Menupunkt</th><th width="152">Navigationsbereich</th><th width="383">Kurzbeschrieb</th><th>Details</th></tr></thead><tbody><tr><td>Druckseite hinzufügen</td><td>Dokumente</td><td>Funktion zur Erstellung eines Pimcore Katalogs</td><td>Anleitung unter Pimcore PIM > Datenobjekt "<a href="../6.-pimcore-pim#datenobjekt-printcontainer-einen-produkt-katalog-erstellen">Printcontainer</a>"</td></tr><tr><td>Seite erstellen</td><td>Dokumente</td><td>Erzeugt eine neue Inhaltsseite</td><td>Anleitung unter Pimcore CMS > <a href="../4.-pimcore-cms#grundlagen-zur-bearbeitung-von-cms-seiten">Grundlagen zur Erstellung von CMS-Seiten</a></td></tr><tr><td>Schnipsel einfügen</td><td>Dokumente</td><td>Fügt ein bereits vorhandenes Snippet (vordefinierter Inhaltsbaustein) ein.</td><td><mark style="color:red;">tba</mark></td></tr><tr><td>Link hinzufügen</td><td>Dokumente</td><td>Erstellt ein Link-Dokument, das auf eine interne oder externe URL verweist.</td><td><mark style="color:red;">tba</mark></td></tr><tr><td>E-Mail hinzufügen</td><td>Dokumente</td><td>Erstellt eine E-Mail-Vorlage im CMS-Bereich, die für automatisierte E-Mail-Kommunikation oder manuelle Mailings verwendet werden kann.</td><td><mark style="color:red;">tba</mark></td></tr><tr><td>Hardlink hinzufügen</td><td>Dokumente</td><td>Erstellt ein Hardlink-Dokument, das Inhalte von einer anderen Pimcore-Seite oder einem Objekt referenziert und 1:1 übernimmt, ohne Duplikate zu erzeugen. Änderungen am Original wirken sich auch hier aus.</td><td><mark style="color:red;">tba</mark></td></tr><tr><td>Newsletter hinzufügen</td><td>Dokumente</td><td>Erstellt eine neue Newsletter-Vorlage oder einen neuen Newsletter auf Basis vordefinierter Templates.</td><td><mark style="color:red;">tba</mark></td></tr><tr><td>Ordner hinzufügen</td><td>-Dokumente<br>-Assets<br>-Datenobjekte</td><td>Erstellt einen neuen Ordner zur Strukturierung und besseren Organisation von Dokumenten innerhalb des CMS-Baumes.</td><td><mark style="color:red;">tba</mark></td></tr><tr><td>Einfügen</td><td>-Dokumente<br>-Assets<br>-Datenobjekte</td><td>Fügt ein zuvor kopiertes oder ausgeschnittenes Dokument oder einen Ordner in die gewählte Position ein.</td><td>Details unter "<a href="#einfugen-einfugen-vererbung">Einfügen / Einfügen (Vererbung)</a>"</td></tr><tr><td>Einfügen (Vererbung)</td><td>Dokumente</td><td>Fügt Inhalte unter Berücksichtigung von Vererbungsregeln ein. Dies kann verwendet werden, um bestimmte Elemente aus einer übergeordneten Struktur abzuleiten und automatisch zu übernehmen.</td><td>Details unter "<a href="#einfugen-einfugen-vererbung">Einfügen / Einfügen (Vererbung)</a>"</td></tr><tr><td>Kopieren</td><td>-Dokumente<br>-Assets<br>-Datenobjekte</td><td>Kopiert das ausgewählte Dokument oder den Ordner in die Zwischenablage, um es später an einer anderen Stelle einzufügen.</td><td><mark style="color:red;">tba</mark></td></tr><tr><td>Ausschneiden</td><td>-Dokumente<br>-Assets<br>-Datenobjekte</td><td>Schneidet das gewählte Dokument aus, um es an eine andere Stelle zu verschieben. Nach dem Einfügen wird es am Ursprungsort entfernt.</td><td><mark style="color:red;">tba</mark></td></tr><tr><td>Umbenennen</td><td>-Dokumente<br>-Assets<br>-Datenobjekte</td><td>Ermöglicht die direkte Änderung des Namens des Dokuments oder Ordners.</td><td><mark style="color:red;">tba</mark></td></tr><tr><td>Löschen</td><td>-Dokumente<br>-Assets<br>-Datenobjekte</td><td>Löscht das gewählte Dokument oder den gewählten Ordner aus dem CMS-Baum.</td><td><mark style="color:red;">tba</mark></td></tr><tr><td>Fortgeschritten</td><td>-Dokumente<br>-Assets<br>-Datenobjekte</td><td>Öffnet erweiterte Optionen, wie z. B. das Anzeigen von Verknüpfungen, das Anzeigen der Revisionen oder das manuelle Bearbeiten technischer Eigenschaften.</td><td><mark style="color:red;">tba</mark></td></tr><tr><td>Neu laden</td><td>-Dokumente<br>-Assets<br>-Datenobjekte</td><td>Lädt den aktuellen Ordner bzw. Baumabschnitt neu, um alle Änderungen oder Aktualisierungen anzuzeigen. Dies ist sinnvoll, wenn in einem anderen Tab Änderungen vorgenommen wurden.</td><td><mark style="color:red;">tba</mark></td></tr><tr><td>Als ZIP herunterladen</td><td>Assets</td><td>Lädt mehrere Dateien oder Inhalte gebündelt in einer komprimierten Datei im <strong>ZIP-Format</strong> herunter.</td><td></td></tr></tbody></table>

#### Einfügen / Einfügen (Vererbung)

Pimcore bietet verschiedene Möglichkeiten, Dokumente, Datenobjekte und Assets in der Baumstruktur einzufügen. Die Auswahl hängt davon ab, ob eine einfache Kopie, eine Vererbung oder eine rekursive Einfügung erforderlich ist.

<div align="center"><figure><img src="https://1483599048-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkHyho5Kn3U8bWBYfwVBk%2Fuploads%2FvayDXyeUvF2PH5NwFPGJ%2Fimage.png?alt=media&#x26;token=8fcb19ff-43d0-4429-ab62-b56ac6cc257f" alt=""><figcaption><p>Einfügen / Einfügen (Vererbung)</p></figcaption></figure></div>

<table data-full-width="true"><thead><tr><th width="211">Funktion</th><th width="198">Anwendungsfall</th><th>Details</th></tr></thead><tbody><tr><td>Einfügen als Kindelement (Rekursiv)</td><td>Struktur als Unterelement einfügen, inkl. aller Unterelemente</td><td><ul><li>Fügt das kopierte Element als untergeordnetes Element (Kind) in den gewählten Ordner oder das gewählte Dokument ein.</li><li>Rekursiv bedeutet, dass alle Unterelemente (z. B. bei Ordnern oder mehrstufigen Dokumentenstrukturen) mit übernommen werden.</li><li>Typische Anwendung: Wenn eine komplette Struktur (z. B. Produktkategorie mit allen Unterseiten) an einer neuen Stelle eingefügt werden soll.</li></ul></td></tr><tr><td>Rekursiv einfügen und Referenzen aktualisieren</td><td>Ganze Struktur kopieren und alle internen Verlinkungen anpassen</td><td><ul><li>Fügt das kopierte Element und alle Unterelemente rekursiv ein.</li><li>Zusätzlich werden alle internen Referenzen (z. B. Links innerhalb der Struktur) angepasst, sodass sie auf die neu eingefügten Elemente verweisen und nicht mehr auf das Original.</li><li>Typische Anwendung: Wenn eine vollständige Struktur übernommen werden soll, ohne dass Links oder interne Verweise auf die ursprüngliche Kopie verweisen.</li></ul></td></tr><tr><td>Einfügen als Kindelement</td><td>Nur das oberste Element als Unterseite einfügen, ohne Unterelemente</td><td><ul><li>Ähnlich wie "Einfügen als Kindelement (Rekursiv)", aber hier wird nur das oberste Element eingefügt.</li><li>Untergeordnete Elemente werden nicht mitkopiert.</li><li>Typische Anwendung: Wenn nur ein einzelnes Dokument oder eine Seite als Unterseite eines anderen Elements eingefügt werden soll.</li></ul></td></tr><tr><td>Einfügen als neue Sprachvariante</td><td>Eine neue Sprachversion für ein Dokument erstellen</td><td><ul><li>Erstellt eine neue Sprachvariante für ein bestehendes Dokument oder Objekt.</li><li>Das ursprüngliche Element bleibt unverändert, aber eine neue Sprachversion (z. B. Französisch oder Spanisch) wird hinzugefügt.</li><li>Typische Anwendung: Wenn ein bestehendes Dokument um eine zusätzliche Sprache ergänzt werden soll.</li></ul></td></tr><tr><td>Als neue Sprachvariante einfügen (rekursiv)</td><td>Mehrere Dokumente als neue Sprachversion einfügen</td><td><ul><li>Wie „Einfügen als neue Sprachvariante“, aber rekursiv für alle untergeordneten Dokumente oder Objekte.</li><li>Typische Anwendung: Wenn eine gesamte Seitenstruktur in einer neuen Sprache ergänzt werden soll.</li></ul></td></tr><tr><td>Sprache einfügen (rekursiv, Referenzen aktualisieren)</td><td>Ganze Struktur mit Sprachvarianten erstellen und Links anpassen</td><td><ul><li>Fügt eine neue Sprachvariante für eine komplette Struktur hinzu und aktualisiert gleichzeitig alle internen Verweise, sodass diese korrekt zur neuen Sprachversion passen.</li><li>Typische Anwendung: Wenn eine vollständige Website- oder Produktstruktur in einer neuen Sprache erstellt werden soll, ohne dass bestehende Verlinkungen auf die alte Sprachvariante verweisen.</li></ul></td></tr><tr><td>Hier nur Inhalte einfügen</td><td>Nur Text/Bild-Inhalte einfügen, ohne Layout oder Metadaten</td><td><ul><li>Fügt nur die Inhalte eines Dokuments oder Objekts ein, nicht aber die strukturellen Eigenschaften (wie Metadaten, Layout oder URL-Struktur).</li><li>Typische Anwendung: Wenn nur der Text oder die Bilder eines Dokuments übernommen werden sollen, aber nicht dessen komplette Einstellungen.</li></ul></td></tr></tbody></table>

### Sprachen / Sprach-Icons

In Pimcore können Inhalte in vielen Datenobjekten mehrsprachig gepflegt werden. Über die Sprach-Icons (Fähnchen) oberhalb des Feldes lässt sich zwischen den verfügbaren Sprachversionen umschalten. Je nach Sprache wird hier das entsprechende Ländersymbol angezeigt.\
Diese Sprach-Icons sind in verschiedenen Objekten innerhalb von Pimcore verfügbar. Der Inhalt, der unter einem bestimmten Sprach-Icon gepflegt wird, erscheint im jeweiligen Sprach-/Länderkontext auf der Website.

<figure><img src="https://1483599048-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkHyho5Kn3U8bWBYfwVBk%2Fuploads%2Fc9ELQmmxj8BkmpluHWKU%2Fimage.png?alt=media&#x26;token=76068591-57a1-4c92-9e65-001bf9659df8" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1483599048-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkHyho5Kn3U8bWBYfwVBk%2Fuploads%2FWHWYho6aPNlMumNNtU8d%2Fimage.png?alt=media&#x26;token=d4d6670c-3957-4d68-bb38-5c3b256c104a" alt=""><figcaption></figcaption></figure>

#### Definition

Bei den Fallback-Sprachen besteht die Möglichkeit, Inhalte entweder einheitlich für alle gleichsprachigen Länder oder länderspezifisch zu pflegen. Wird z. B. ein Text unter „German“ erfasst, dient dieser als Fallback für alle deutschsprachigen Länder, sofern keine spezifischere Sprachversion vorhanden ist. Die Texte die unter "German" gepflegt sind werden im Frontend also nicht nur unter DE-CH sondern auch unter DE-DE = "German (Germany)“ und DE-AT = "German (Austria) angezeigt. Alternativ können individuelle Texte für „German (Switzerland)“, „German (Germany)“ oder „German (Austria)“ hinterlegt werden, um gezielt länderspezifische Inhalte anzuzeigen.

<table data-header-hidden><thead><tr><th width="247"></th><th width="304"></th><th></th></tr></thead><tbody><tr><td><strong>Sprache / Sprach-Icon</strong></td><td><strong>Sprach-/Länderkontext Webseite</strong></td><td><strong>Fallback-Sprache</strong></td></tr><tr><td>German</td><td>Schweiz DE (de-ch)</td><td>x</td></tr><tr><td>German (Switzerland)</td><td>Schweiz (de-ch)</td><td></td></tr><tr><td>German (Germany)</td><td>Deutschland (de-de)</td><td></td></tr><tr><td>German (Austria)</td><td>Österreich (at-at)</td><td></td></tr><tr><td>French (Switzerland)</td><td>Suisse FR (fr-ch)</td><td></td></tr><tr><td>French (France)</td><td>France (fr-fr)</td><td></td></tr><tr><td>Swedish (Sweden)</td><td>Sverige (sv-se)</td><td></td></tr><tr><td>English (US)</td><td>USA (en-us)</td><td></td></tr><tr><td>English Switzerland</td><td>International EN (en-ch)</td><td></td></tr><tr><td>Spanish (Spain)</td><td>Wird nicht verwendet</td><td></td></tr><tr><td>Chinese</td><td>China (zh-cn)</td><td></td></tr><tr><td>French</td><td>Wird nicht verwendet</td><td>x</td></tr><tr><td>English</td><td>International EN (en-ch)</td><td>x</td></tr><tr><td>Spanish</td><td>Internacional ES (es-es)</td><td></td></tr></tbody></table>
