# evoBLOG
## Modulbeschreibung
**Mit unserem evoBLOG Modul können Sie Ihren eigenen Blog im OXID eShop erstellen – ganz ohne Programmierkenntnisse!**
Haben Sie schonmal nach einer Möglichkeit gesucht die Funktionen von WordPress in OXID zu integrieren? Dieses Modul macht es möglich, einzelne Blog-Beiträge, Ratgeber oder Anleitungen zu erstellen – direkt im Backend Ihres OXID eShops. Damit können Sie nicht nur Ihre Kunden begeistern – auch für Suchmaschinen ist Content auf Webseiten sehr wichtig.
Das Modul ist erhältlich auf
## Funktionsumfang
**Die Funktionen dieses Moduls im Überblick:**
* Blog-Beiträge erstellen und verwalten.
* Vorschau-Bilder können bei den Beiträgen hinterlegt werden.
* Gruppierung der Beiträge in verschiedene Kategorien.
* Passende Produkte können bei einem Beitrag angezeigt werden.
* Autoren-Profile können angelegt und Beiträgen zugeordnet werden.
* Diverse SEO-Einstellungen: Meta-Beschreibung, Meta-Keywords und SEO-URL.
* Mit Hilfe von Visual CMS-Widgets können bestehende Beiträge oder Gruppen mühelos in VisualCMS-Snippets eingebunden werden (nur in OXID EE)
* mit Hilfe von eigenem Smarty-Tag odder eigener Twig-Funktion können bestehende Beiträge oder Gruppen mühelos in CMS-Snippets oder Templates eingebunden werden
## Systemvoraussetzungen
### PHP-Version OXID 4 & 5
* PHP 5.6
### PHP-Version OXID 6
* PHP 7.0 (OXID 6.0.x)
* PHP 7.1 (OXID 6.1.x)
* PHP 7.2 - 7.4 (OXID 6.2.x - 6.3.x)
* PHP 8.0 (OXID 6.3.x - 6.4.x)
* PHP 8.1 (OXID 6.5.x)
### PHP-Version OXID 7
* PHP 8.0 - 8.1 (OXID 7.0.x)
### Webserver-Konfiguration
* IonCube Loader (mind. v5.0)
### Kompatibel mit den Themes
* Flow
* Wave
* RoxIVE
* Apex
### Kompatibel mit den OXID Versionen
* OXID CE/PE 4.9.x bis 4.10.x
* OXID EE 5.2.x bis 5.3.x
* OXID CE/PE/EE 6.0.x bis 6.5.x
* OXID CE/PE/EE 7.0
* bei OXID 7.0 wird das "WYSIWYG Editor + Mediathek" von OXID benötigt
### Template-Engine
* Smarty bis OXID 7.0.x
* Twig ab OXID 7.0.x
## Installation
### Ab OXID 6/7
1. Falls noch nicht geschehen, laden Sie bitte zunächst das digidesk Basis-Modul herunter und installieren Sie es gemäß der enthaltenen Installationsanleitung.\
Sie erhalten dieses unter:[ https://www.digidesk.de/produkte/basis-modul](https://www.digidesk.de/produkte/basis-modul)
2. Für dieses Modul erstellen Sie nun einen weiteren Unterordner `magazin` im Ordner `packages/digidesk`, in den die heruntergeladene Zip-Datei entpackt wird.
3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus:
```
composer require digidesk/magazin
```
4. Nun kann das Modul im OXID eShop Admin aktiviert werden
5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren
6. Bitte fahren Sie nun mit der Einrichtung des Moduls fort
### Bis OXID 5.3.x/4.10.x
1. Falls noch nicht geschehen, laden Sie bitte zunächst das digidesk Basis-Modul herunter und installieren Sie es gemäß der enthaltenen Installationsanleitung. \
Sie erhalten dieses unter:[https://www.digidesk.de/produkte/basis-modul](https://www.digidesk.de/produkte/basis-modul/)
2. Fügen Sie den Inhalt des Ordners `modules/digidesk/` via FTP/SFTP unter dem gleichnamigen Pfad in Ihren Shop ein
3. Aktivieren Sie das Modul im OXID eShop Admin
4. Ggf. Tmp-Verzeichnis leeren und Views neu generieren
5. Bitte fahren Sie nun mit der Einrichtung des Moduls fort
## Update
### Ab OXID 6/7
1. Bitte aktualisieren Sie zunächst das Basis-Modul gemäß der darin enthaltenen Installationsanleitung.
2. Entpacken Sie die neue Modulversion in den Ordner `packages/digidesk/magazin`
3. Deaktivieren Sie das Modul im OXID eShop Admin
4. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus:
```
composer update digidesk/magazin
```
Die Frage, ob Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "Y".
5. Aktivieren Sie dieses Modul im OXID eShop Admin.
6. Ggf. Tmp-Verzeichnis leeren und Views neu generieren.
### Bis OXID 5.3.x/4.10.x
1. Bitte aktualisieren Sie zunächst das Basis-Modul gemäß der darin enthaltenen Installationsanleitung.
2. Deaktivieren Sie dieses Modul im OXID eShop Admin.
3. Fügen Sie den Inhalt des Ordners `modules/digidesk/` via FTP/SFTP unter dem gleichnamigen Pfad in Ihren Shop ein und überschreiben Sie dabei die vorhandenen Dateien des Moduls.
4. Aktivieren Sie dieses Modul im OXID eShop Admin.
5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren.
## Funktionsbeschreibung
### Einträge bearbeiten/erstellen
Hier können Sie ihre Blog-Einträge nach Ihren Interessen gestalten:
1. Klicken Sie auf **"evoBLOG"** rechts in Ihrer Leiste und öffnen Sie den Reiter **"Einträge bearbeiten"**
2. Drücken sie auf das **"+"-Symbol** um einen neuen Eintrag zu erstellen
3. Es öffnet sich ein Fenster mit geöffneten Reiter **"Stamm"**
4. Hier können Sie Informationen in das Formular eintragen (Titel,Kurzbeschreibung usw.)
5. Falls es schon **Gruppen** und **Autoren** gibt, können Sie den Eintrag zu den gewünschten Beiträgen zuordnen
6. Unter dem Reiter **"Zuordnungen"** können Sie Artikel zuweisen, welche dann in Ihrem Blog angezeigt werden sollen
7. Sollten Sie auf den Reiter **"SEO"** zutreffen, werden Sie die Möglichkeit haben, die URL Ihres Blogs ändern zu können.
8. Wenn Sie dann zufrieden mit Ihren Einstellungen sind, drücken Sie auf **"Speichern"**
### Gruppen bearbeiten/erstellen
Wenn Sie Ihre Blog-Einträge nach Gruppen sortieren möchten, können Sie hier welche erstellen:
1. Navigieren Sie links zum Reiter **"Gruppen bearbeiten"**
2. Erstellen Sie einen neuen oder bearbeiten Sie einen bereits erstellte Gruppe
3. Folgend öffnet sich ein Fenster mit dem Reiter **"Stamm"**
4. In dem Fenster können Sie den Titel der Gruppe, sowie zum Beispiel ein Vorschaubild festlegen
5. Ist alles festgelegt - klicken Sie auf **"Speichern"**
### Autoren bearbeiten/erstellen
Falls Sie noch Autoren zu dem erstellen Blog-Eintrag hinzufügen möchten, können Sie das wie folgt:
1. Navigieren Sie zum Reiter **"Autoren bearbeiten"**
2. Erstellen Sie einen neuen oder bearbeiten Sie einen bereits erstellten Autor
3. Ein Fenster öffnet sich mit einigen Einstellungsmöglichkeiten
4. Dort können Sie ein Bild festlegen, sowie einen Namen und eine Kurzbeschreibung hinzufügen
5. Anschließend auf **"Speichern"** klicken
Möchten Sie Ihren Blog in Ihrem Shop betrachten, drücken Sie auf **"Blog öffnen"**
Anschließend werden Sie weitergeleitet und können Ihre Einstellungen in Ihrem Shop nun ansehen
### Frontend-Ansicht
Die Blog-Seite bzw. die Übersichtsseite können Sie durch die folgende URL öffnen: **\/?cl=dd\_magazin** öffnen. Über das Shop-Backend können Sie für die Übersichtsseite eine sprechende URL hinterlegen. Öffnen Sie hierzu Ihr Shop-Backend und öffnen Sie den SEO-Reiter über **Stammdaten > Grundeinstellungen > SEO-Reiter**. Hier können Sie unter "**Statische URLs**" eine sprechende URL wie folgt hinterlegen:
Beim Öffnen der Blogseite werden Ihnen zunächst Ihre **Gruppen** angezeigt, welche Sie erstellt haben. Wenn Sie dann eine Gruppe anklicken, wird rechts daneben Ihre Kurzbeschreibung zum Blog-Eintrag angezeigt.
Drücken Sie auf **"Weiterlesen"** und Sie werden zu Ihrem Eintrag weitergeleitet
Hier wird der von Ihnen erstellte Eintrag angezeigt mit dem von Ihnen zugehörigen Autor.
### Kommentare bearbeiten
Natürlich gibt es die Möglichkeit, Ihren Blog von anderen Shop-Usern kommentieren zu lassen und Sie können diese dann nach Ihren Präferenzen bearbeiten:
1. Um die Kommentar-Funktion nutzen zu können, müssen Sie nach ***"Erweiterungen-> Module-> evoBLOG-> Einstell.->***** Einträge*****"*** wechseln.
2. Unten finden Sie dort die Option **"Kommentar aktiveren"**
3. Wenn Sie die Option eingestellt haben, **speichern** Sie anschließend.
Dementsprechend wird ein **neues Feld** in Ihrem Shop angezeigt, wo andere Shop-User ein Kommentar zu Ihrem Blog-Eintrag schreiben können.
Wird dann ein Kommentar abgeschickt, ist er nicht automatisch aktiv. In Ihrem Backend-Bereich können Sie alle eingegangenen Kommentare unter dem Reiter **"Kommentar bearbeiten"** finden:
1. Drücken Sie auf das **"Stift"-Symbol** (rechts neben dem gewünschten Eintrag, wenn Sie mit der Maus über den Eintrag gehen)
2. Es öffnet sich ein Fenster mit verschiedenen Daten:
* Der **Blog-Eintrag** wo kommentiert wurde und wann kommentiert wurde (**Datum**)
* **Name** und **Email** des Absenders
* Der **Kommentar** des Absenders
* Möglichkeit eine **Antwort** zu schreiben (**Autor**)
3. Möchten Sie, dass der Kommentar angezeigt wird, dann setzen Sie einen Haken bei **"Freigegeben?"**
4. Anschließend auf **"Speichern"** drücken
Wenn Sie sich dann wieder auf Ihren Eintrag in Ihrem Shop bewegen, werden Sie feststellen dass der Kommentar inklusive Antwort angezeigt wird.
### Meta-Beschreibung bzw. Meta-Description für die Blog-Übersichtsseite bearbeiten
Die Meta-Beschreibung für die Blog-Übersichtsseite kann man über das CMS-Snippet mit dem Ident "**dd\_magazin\_metadesc**" bearbeiten. Wenn das CMS-Snippet aktiv und Inhalt besitzt, wird der Inhalt auf der Blog-Übersichtsseite als eine Meta-Beschreibung automatisch hinzugefügt.
{% hint style="warning" %}
Falls die Einstellung vorgenommen wurde, dass auf der Übersichtsseite die erste Gruppe angezeigt werden soll, dann wird nur die Meta-Beschreibung der ersten Gruppe angezeigt und nicht der Text aus dem CMS-Snippet.
{% endhint %}
## Mandantenfähigkeit (nur in der EE - Edition)
Die Einträge des Hauptshops werden seit der Version **4.5.3** nicht mehr an Subshops vererbt. In einem Subshop erstellte Einträge sind nur in diesem Shop sichtbar. In früheren Versionen war die Vererbung nicht ganz korrekt.
## Visual CMS
Natürlich ist es auch möglich die Blog-Beiträge im Visual CMS für Landing Pages oder ähnliches selektiv zu nutzen:
1. Öffnen Sie zunächst **"Visual CMS"** im Backend Ihres Shops (unter ***Kundeninformationen***)
2. Links im Reiter **"Einstell."** können Sie dann ein bereits vorhandenen CMS-Inhalt aussuchen oder ein neuen hinzufügen
3. Haben Sie sich für einen CMS-Inhalt entschieden, drücken Sie dann auf das **"+"-Symbol** um ein neues Widget zu erstellen
4. Anschließend öffnet sich ein Fenster mit **Widget-Übersicht**, wo Sie dann unter der Option **"evoBlog-Gruppe"** oder **"evoBlog"** Ihre bereits erstellten Gruppen oder Beiträge aussuchen und in den **Allgemeinen Einstellungen** die Art der Anzeige der Blog-Beiträge vornehmen können
5. Anschließend auf **"Speichern"** clicken
## **Einbindung von Blog-Beiträgen per Smarty in Template oder in einen CMS Beitrag**
Bei Oxid CE Editionen hat man keinen Visual CMS Editor, trotzdem kann man die vorhandene Blog-Beiträge in eigenen Templates oder CMS-Beiträgen wie im folgendem Beispiel einbinden:
Smarty:
```smarty
[{ddmagazinlist group="Gruppe2" limit="6" blShowSubgroups=true blShowCreateDate=true blHideBlogImage=false blHideShortDesc=false}][{/ddmagazinlist}]
```
Twig:
```twig
{{ ddMagazinList( sGroupTitle='groupTitle', iLimit=10, blShowSubgroups=true, blShowCreateDate=true, blHideBlogImage=false, blHideShortDesc=false ) }}
```
Bei der **group (Smarty)** oder **sGroupTitle (Twig)** tragen Sie bitte den Titel der gewünschten Gruppe ein, **limit (Smarty)** oder **iLimit (Twig)** begrenzt die Gesamtzahl der Blog-Beiträge, **blShowSubgroups** erlaubt die Anzeige von Untergruppen vor den Blog-Beiträgen, **blShowCreateDate** blendet das Erstellungsdatum eines Blog-Beitrags ein, **blHideBlogImage** kann die Bilder bei den Blog-Beiträgen ein oder ausblenden und mit **blHideShortDesc** kann die Kurzbeschreibung ein oder ausgeblendet werden.
## Hilfe & Support
Haben Sie Fragen oder benötigen Sie Hilfe bei der Installation? Gerne bieten wir Ihnen auch einen Installationsservice an. Kontaktieren Sie uns einfach über eine der unten stehenden Adressen.
* E-Mail: ****
* Telefon: **+49 (0) 5246 / 9099110**
* Kontaktformular: [**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt)
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.digidesk.de/moduldokumentationen/evoblog.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.