Installation und Konfiguration des Moduls Kowal Blog
Dieses Dokument beschreibt die Installation des Moduls Kowal_Blog sowie die Bedeutung der im Magento-Panel verfügbaren Konfigurationsfelder.
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:
composer config repositories.module.kowal.blog vcs https://github.com/kowalco/blog
Wenn das Repository privat ist, fügen Sie ein GitHub-Token hinzu:
composer config --global --auth github-oauth.github.com
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 die Installation erstellt
Während der Installation erstellt das Modul:
- den Produkttyp
blog_post, - das Attributset
Blog Post, - redaktionelle Beitragsattribute,
- die Konfiguration im Magento-Panel,
- Frontend-Blöcke,
- Templates für Liste, Beitrag, Sidebar und strukturierte Daten.
Vorbereitung der Blog-Kategorie
- Gehen Sie zu:
Catalog > Categories
- Erstellen Sie eine Kategorie, die als Startseite des Blogs dient, z. B.:
Blog
- Erstellen Sie unter dieser Kategorie Blog-Unterkategorien, z. B.:
Blog / PoradnikiBlog / AktualnościBlog / SEO
- 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
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
Legt die Hauptkategorie des Blogs fest.
Die ausgewählte Kategorie erfüllt zwei Rollen:
- Sie ist die Startseite des Blogs,
- sie ist der Root 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
Bestimmt die Darstellung der Liste von Blog-Beiträgen.
Verfügbare Werte:
List - klassische Beitragsliste,Grid - 2 Columns - Grid mit 2 Spalten,Grid - 3 Columns - Grid mit 3 Spalten,Grid - 4 Columns - Grid mit 4 Spalten.
Jede Variante zeigt Beitragsbild, Titel, Veröffentlichungsdatum, Autor, Teaser und 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 wählen, wird die Blog-Sidebar gemäß der ausgewählten Seite gerendert.
Blog Post Page Layout
Erzwingt das Seitenlayout für einen Blog-Beitrag.
Verfügbare Werte:
Use Magento Default,1 Column,2 Columns with Left Sidebar,2 Columns with Right Sidebar.
Diese Einstellung ist nützlich, wenn Blog-Beiträge ein anderes Layout haben sollen als normale Produkte.
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 produktbezogene Elemente zu Blog-Kategorien hinzufügen.
Remove Blocks on Blog Posts
Liste der Layout-Blöcke, die auf Blog-Beitragsseiten 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 wie die folgenden auszublenden:
- Vergleichsfunktion,
- Wunschliste,
- verwandte Produkte,
- Produktbewertungen,
- Lieferanten-Icons,
- Lieferzeit,
- Lagerinformationen,
- andere Blöcke aus Produktmodulen.
Show Blog Categories
Aktiviert den Block für 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 für neueste Beiträge 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
Aktiviert den Tag-Block in der Sidebar.
Die Tags stammen aus dem Attribut:
blog_tags
Dies ist ein Attribut vom Typ multiselect.
Beitrag erstellen
- Gehen Sie zu:
Catalog > Products
- Erstellen Sie ein neues Produkt des Typs:
Blog Post
- Wählen Sie das Attributset:
Blog Post
- Füllen Sie die grundlegenden Felder aus:
Name - Beitragstitel,SKU - technischer Bezeichner,URL Key - URL,Short Description - Teaser,Description - vollständiger Inhalt,Image - Hauptbild,Meta Title,Meta Description.
- Füllen Sie die Blog-Felder aus:
Published At,Author Name,Post Format,Tags,Reading Level, falls verwendet,Featured, wenn der Beitrag hervorgehoben werden soll.
- Weisen Sie den Beitrag einer Kategorie zu, die sich unter der Blog-Root-Kategorie befindet.
SEO-Empfehlungen
Jeder Beitrag sollte eindeutige Werte haben für:
Name,URL Key,Meta Title,Meta Description.
Teaser und Inhalt
Das Feld Short Description sollte ein kurzer, einzigartiger Teaser sein und keine Kopie des ersten Inhaltsabsatzes.
Das Feld Description sollte den vollständigen Beitrag mit einer logischen Überschriftenstruktur enthalten.
Bilder
Das Beitragsbild sollte ein sinnvolles Label haben, da das Modul es als alt und title verwendet. Wenn kein Bild-Label gesetzt ist, dient der Beitragsname als Fallback.
Das Modul rendert Bilder mit den Attributen:
Links Weiterlesen
Links vom Typ Read more in Listen sind gekennzeichnet als:
rel='nofollow'
Der wichtigste indexierbare Link bleibt der Beitragstitel.
Prü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 Blog-Beiträge anzeigen,
- ob der Beitrag keinen Preis, keinen Warenkorb und keinen 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 kein altes Layout anzeigt.
Nach Änderungen an der Konfiguration empfiehlt es sich, Folgendes auszuführen:
bin/magento cache:clean config layout block_html full_page
WhatsApp
+48608012047
