Installation und Konfiguration des Moduls Kowal Blog

Dieses Dokument beschreibt die Installation des Moduls Kowal_Blog sowie die Bedeutung der Konfigurationsfelder, die im Magento-Panel verfügbar sind.

Anforderungen

Das Modul ist für Magento 2.4.x vorgesehen.

Erforderliche Magento-Module:

• Magento_Catalog,
• Magento_CatalogUrlRewrite,
• Magento_Eav,
• Magento_Store.

Das Modul wird als Composer-Paket installiert:

kowal/module-blog

Installation über Composer

Fügen Sie das Composer-Repository hinzu:

Die Zugangsdaten zum Composer-Repository, also die E-Mail-Adresse des Kunden und das Lizenz-Token, erhalten Sie nach dem Kauf per E-Mail. Sie sind außerdem nach der Anmeldung im Kundenpanel auf kowal.store verfügbar. Ersetzen Sie TWOJ_EMAIL_KLIENTA durch die E-Mail-Adresse Ihres Kontos und TWOJ_TOKEN durch das erhaltene Token. Führen Sie die Befehle im Magento-Stammverzeichnis aus.

composer config repositories.kowal composer https://repo.kowal.store

Konfigurieren Sie die Zugangsdaten zum Composer-Repository Kowal:

composer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'

Installieren Sie das Modul:

composer require kowal/module-blog

Aktivieren Sie das Modul:

bin/magento module:enable Kowal_Blog

Führen Sie das Upgrade aus:

bin/magento setup:upgrade

Leeren Sie den Cache:

bin/magento cache:flush

Führen Sie im Produktionsmodus zusätzlich aus:

bin/magento setup:di:compilebin/magento setup:static-content:deploybin/magento indexer:reindex

Was bei der Installation erstellt wird

Während der Installation erstellt das Modul:

• den Produkttyp blog_post,
• das Attributset Blog Post,
• redaktionelle Attribute des Beitrags,
• die Konfiguration im Magento-Panel,
• Frontend-Blöcke,
• Templates für Liste, Beitrag, Sidebar und strukturierte Daten.

Vorbereitung der Blog-Kategorie

1. Gehen Sie zu:

Catalog > Categories

2. Erstellen Sie eine Kategorie, die als Startseite des Blogs dient, z. B.:

Blog

3. Erstellen Sie unter dieser Kategorie Blog-Unterkategorien, z. B.:

Blog / PoradnikiBlog / AktualnościBlog / SEO

4. Stellen Sie sicher, dass die Kategorien aktiv sind und korrekte url_key haben.

Modulkonfiguration

Die Konfiguration befindet sich unter:

Stores > Configuration > Kowal > Blog

Die Konfiguration ist in drei Bereiche unterteilt:

• General,
• Design,
• Sidebar.

General

Enabled

Aktiviert oder deaktiviert das Modul im Frontend.

Werte:

• Yes - das Modul ist aktiv,
• No - das Modul fügt kein Blog-Verhalten hinzu.

Blog Root Category

Gibt die Hauptkategorie des Blogs an.

Die ausgewählte Kategorie erfüllt zwei Rollen:

• sie ist die Startseite des Blogs,
• sie ist die Root-Kategorie für Blog-Unterkategorien.

Beispiel:

Default Category / Blog

Unterkategorien, die sich unter dieser Kategorie befinden, werden als Blog-Kategorien behandelt.

Posts Per Page

Anzahl der Beiträge, die auf einer Listing-Seite angezeigt werden.

Beispiel:

12

Der Wert muss eine Zahl größer als null sein.

Post List Display Mode

Legt fest, wie die Liste der Blogbeiträge dargestellt wird.

Verfügbare Werte:

• List - klassische Beitragsliste,
• Grid - 2 Columns - Raster mit 2 Spalten,
• Grid - 3 Columns - Raster mit 3 Spalten,
• Grid - 4 Columns - Raster mit 4 Spalten.

Jede Variante zeigt das Beitragsbild, den Titel, das Veröffentlichungsdatum, den Autor, den Lead und den Link zum Beitrag.

Show Future Posts

Legt fest, ob Beiträge mit einem Veröffentlichungsdatum in der Zukunft in Listen sichtbar sein sollen.

Werte:

• Yes - zukünftige Beiträge sind sichtbar,
• No - zukünftige Beiträge sind ausgeblendet.

Empfehlung für die Produktion:

No

Design

Blog Category Page Layout

Erzwingt das Seitenlayout für die Blog-Startseite und Blog-Kategorien.

Verfügbare Werte:

• Use Magento Default,
• 1 Column,
• 2 Columns with Left Sidebar,
• 2 Columns with Right Sidebar.

Wenn Sie ein zweispaltiges Layout auswählen, wird die Blog-Sidebar entsprechend der ausgewählten Seite gerendert.

Blog Post Page Layout

Erzwingt das Seitenlayout für einen Blogbeitrag.

Verfügbare Werte:

• Use Magento Default,
• 1 Column,
• 2 Columns with Left Sidebar,
• 2 Columns with Right Sidebar.

Diese Einstellung ist nützlich, wenn Blogbeiträge ein anderes Layout als normale Produkte haben sollen.

Remove Blocks on Blog Categories

Liste der Layout-Blöcke, die auf Blog-Kategorieseiten entfernt werden sollen.

Geben Sie pro Zeile einen Blocknamen ein.

Beispiel:

catalog.compare.sidebarwishlist_sidebar

Verwenden Sie dieses Feld, wenn externe Module typische Produktelemente zu Blog-Kategorien hinzufügen.

Remove Blocks on Blog Posts

Liste der Layout-Blöcke, die auf Blogbeitragsseiten entfernt werden sollen.

Geben Sie pro Zeile einen Blocknamen ein.

Beispiel:

catalog.compare.sidebarwishlist_sidebarproduct.info.upsellcatalog.product.relatedproduct.info.reviewproduct.info.social

Dieses Feld ist nützlich, um Elemente auszublenden wie:

• Produktvergleich,
• Wunschliste,
• verknüpfte Produkte,
• Produktbewertungen,
• Anbietersymbole,
• Lieferzeit,
• Lagerinformationen,
• andere Blöcke aus Produktmodulen.

Sidebar

Show Blog Categories

Aktiviert den Block mit Blog-Kategorien in der Sidebar.

Der Block zeigt Kategorien an, die sich unter der konfigurierten Blog-Root-Kategorie befinden.

Show Recent Posts

Aktiviert den Block mit den neuesten Beiträgen in der Sidebar.

Die Beiträge werden nach Veröffentlichungsdatum sortiert.

Recent Posts Limit

Legt die Anzahl der neuesten Beiträge fest, die in der Sidebar sichtbar sind.

Beispiel:

5

Show Tags

Aktiviert den Tag-Block in der Sidebar.

Die Tags stammen aus dem Attribut:

blog_tags

Dies ist ein Attribut vom Typ multiselect.

Beitrag erstellen

1. Gehen Sie zu:

Catalog > Products

2. Erstellen Sie ein neues Produkt des Typs:

Blog Post

3. Wählen Sie das Attributset aus:

Blog Post

4. Füllen Sie die grundlegenden Felder aus:

• Name - Beitragstitel,
• SKU - technischer Identifikator,
• URL Key - URL-Adresse,
• Short Description - Lead,
• Description - vollständiger Inhalt,
• Image - Hauptbild,
• Meta Title,
• Meta Description.

5. Füllen Sie die Blog-Felder aus:

• Published At,
• Author Name,
• Post Format,
• Tags,
• Reading Level, falls verwendet,
• Featured, falls der Beitrag hervorgehoben werden soll.

6. Weisen Sie den Beitrag einer Kategorie zu, die sich unter der Blog-Root-Kategorie befindet.

SEO-Empfehlungen

Titel und Metadaten

Jeder Beitrag sollte eindeutige Werte haben für:

• Name,
• URL Key,
• Meta Title,
• Meta Description.

Lead und Inhalt

Das Feld Short Description sollte ein kurzer, eindeutiger Lead sein und keine Kopie des ersten Inhaltsabsatzes.

Das Feld Description sollte den vollständigen Inhalt des Beitrags mit einer logischen Überschriftenstruktur enthalten.

Bilder

Das Beitragsbild sollte ein aussagekräftiges Label haben, da das Modul dieses als alt und title verwendet. Wenn kein Bildlabel gesetzt ist, wird der Beitragsname als Fallback verwendet.

Das Modul rendert Bilder mit den Attributen:

• alt,
• title,
• width,
• height.

Links Weiterlesen

Links vom Typ Read more in Listen sind gekennzeichnet als:

rel='nofollow'

Der wichtigste indexierbare Link bleibt der Beitragstitel.

Überprüfung nach der Konfiguration

Prüfen Sie nach Installation und Konfiguration:

• ob die Blog-Root-Kategorie die Beitragsliste anzeigt,
• ob Blog-Unterkategorien die richtigen Beiträge anzeigen,
• ob normale Shop-Kategorien keine Blogbeiträge anzeigen,
• ob der Beitrag keinen Preis, Warenkorb oder Lagerbestand anzeigt,
• ob die Sidebar die erwarteten Blöcke anzeigt,
• ob die strukturierten Daten vom Typ BlogPosting und nicht Product sind,
• ob Sitemap und URL rewrites korrekt funktionieren,
• ob der Cache nach einer Konfigurationsänderung nicht das alte Layout anzeigt.

Nach Änderungen an der Konfiguration empfiehlt es sich, auszuführen:

bin/magento cache:clean config layout block_html full_page