Instalacja i konfiguracja modułu Kowal Blog

Ten dokument opisuje instalację modułu Kowal_Blog oraz znaczenie pól konfiguracyjnych dostępnych w panelu Magento.

Wymagania

Moduł jest przeznaczony dla Magento 2.4.x.

Wymagane moduły Magento:

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

Moduł jest instalowany jako paczka Composer:

kowal/module-blog

Instalacja przez Composer

Dodaj repozytorium Composer:

Dane dostępowe do repozytorium Composer (adres e-mail klienta i token licencyjny) otrzymasz e-mailem po zakupie. Są również dostępne w panelu klienta po zalogowaniu na kowal.store. Zastąp TWOJ_EMAIL_KLIENTA adresem e-mail swojego konta, a TWOJ_TOKEN otrzymanym tokenem. Polecenia wykonaj w katalogu głównym Magento.

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

Skonfiguruj dane dostępowe do repozytorium Composer Kowal:

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

Zainstaluj moduł:

composer require kowal/module-blog

Włącz moduł:

bin/magento module:enable Kowal_Blog

Uruchom upgrade:

bin/magento setup:upgrade

Wyczyść cache:

bin/magento cache:flush

W trybie produkcyjnym wykonaj dodatkowo:

bin/magento setup:di:compile
bin/magento setup:static-content:deploy
bin/magento indexer:reindex

Co tworzy instalacja

Podczas instalacji moduł tworzy:

• typ produktu blog_post,
• zestaw atrybutów Blog Post,
• atrybuty redakcyjne posta,
• konfigurację w panelu Magento,
• bloki frontendu,
• szablony listy, posta, sidebaru i danych strukturalnych.

Przygotowanie kategorii bloga

1. Przejdź do:

Catalog > Categories

2. Utwórz kategorię, która będzie stroną główną bloga, np.:

Blog

3. Pod tą kategorią utwórz podkategorie bloga, np.:

Blog / Poradniki
Blog / Aktualności
Blog / SEO

4. Upewnij się, że kategorie są aktywne i mają poprawne url_key.

Konfiguracja modułu

Konfiguracja znajduje się w:

Stores > Configuration > Kowal > Blog

Konfiguracja jest podzielona na trzy sekcje:

• General,
• Design,
• Sidebar.

General

Enabled

Włącza lub wyłącza moduł na frontendzie.

Wartości:

• Yes - moduł działa,
• No - moduł nie dodaje blogowego zachowania.

Blog Root Category

Wskazuje główną kategorię bloga.

Wybrana kategoria pełni dwie role:

• jest stroną główną bloga,
• jest rootem dla podkategorii blogowych.

Przykład:

Default Category / Blog

Podkategorie znajdujące się pod tą kategorią będą traktowane jako kategorie bloga.

Posts Per Page

Liczba postów wyświetlanych na jednej stronie listingu.

Przykład:

12

Wartość musi być liczbą większą od zera.

Post List Display Mode

Określa sposób prezentacji listy wpisów blogowych.

Dostępne wartości:

• List - klasyczna lista wpisów,
• Grid - 2 Columns - siatka w 2 kolumnach,
• Grid - 3 Columns - siatka w 3 kolumnach,
• Grid - 4 Columns - siatka w 4 kolumnach.

Każdy wariant pokazuje obraz posta, tytuł, datę publikacji, autora, lead i link do wpisu.

Show Future Posts

Decyduje, czy posty z datą publikacji w przyszłości mają być widoczne na listach.

Wartości:

• Yes - przyszłe posty są widoczne,
• No - przyszłe posty są ukryte.

Rekomendacja dla produkcji:

No

Design

Blog Category Page Layout

Wymusza układ strony dla strony głównej bloga i kategorii blogowych.

Dostępne wartości:

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

Jeśli wybierzesz układ dwukolumnowy, sidebar bloga zostanie wyrenderowany zgodnie z wybraną stroną.

Blog Post Page Layout

Wymusza układ strony dla wpisu blogowego.

Dostępne wartości:

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

To ustawienie jest przydatne, gdy wpisy blogowe mają mieć inny układ niż zwykłe produkty.

Remove Blocks on Blog Categories

Lista bloków layoutu, które mają być usunięte na stronach kategorii bloga.

Wpisuj jedną nazwę bloku w jednej linii.

Przykład:

catalog.compare.sidebar
wishlist_sidebar

Użyj tego pola, jeśli zewnętrzne moduły dodają elementy typowo produktowe do kategorii bloga.

Remove Blocks on Blog Posts

Lista bloków layoutu, które mają być usunięte na stronach wpisów blogowych.

Wpisuj jedną nazwę bloku w jednej linii.

Przykład:

catalog.compare.sidebar
wishlist_sidebar
product.info.upsell
catalog.product.related
product.info.review
product.info.social

To pole jest przydatne do ukrywania elementów takich jak:

• porównywarka,
• lista życzeń,
• produkty powiązane,
• recenzje produktowe,
• ikony dostawców,
• czas realizacji zamówienia,
• informacje magazynowe,
• inne bloki pochodzące z modułów produktowych.

Sidebar

Show Blog Categories

Włącza blok kategorii bloga w sidebarze.

Blok pokazuje kategorie znajdujące się pod skonfigurowaną kategorią root bloga.

Show Recent Posts

Włącza blok ostatnich postów w sidebarze.

Posty są sortowane po dacie publikacji.

Recent Posts Limit

Określa liczbę ostatnich postów widocznych w sidebarze.

Przykład:

5

Show Tags

Włącza blok tagów w sidebarze.

Tagi pochodzą z atrybutu:

blog_tags

Jest to atrybut typu multiselect.

Tworzenie posta

1. Przejdź do:

Catalog > Products

2. Utwórz nowy produkt typu:

Blog Post

3. Wybierz zestaw atrybutów:

Blog Post

4. Uzupełnij podstawowe pola:

• Name - tytuł posta,
• SKU - techniczny identyfikator,
• URL Key - adres URL,
• Short Description - lead,
• Description - pełna treść,
• Image - obraz główny,
• Meta Title,
• Meta Description.

5. Uzupełnij pola blogowe:

• Published At,
• Author Name,
• Post Format,
• Tags,
• Reading Level, jeśli używany,
• Featured, jeśli wpis ma być wyróżniony.

6. Przypisz wpis do kategorii znajdującej się pod kategorią root bloga.

Zalecenia SEO

Tytuły i meta dane

Każdy post powinien mieć unikalne:

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

Lead i treść

Pole Short Description powinno być krótkim, unikalnym leadem, a nie kopią pierwszego akapitu treści.

Pole Description powinno zawierać pełną treść posta z logiczną strukturą nagłówków.

Obrazy

Obraz posta powinien mieć sensowną etykietę, ponieważ moduł używa jej jako alt i title. Jeśli etykieta obrazu nie jest ustawiona, fallbackiem jest nazwa posta.

Moduł renderuje obrazy z atrybutami:

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

Linki Czytaj więcej

Linki typu Read more na listach są oznaczone jako:

rel="nofollow"

Głównym linkiem indeksowalnym pozostaje tytuł wpisu.

Weryfikacja po konfiguracji

Po instalacji i konfiguracji sprawdź:

• czy kategoria root bloga wyświetla listę postów,
• czy podkategorie bloga pokazują właściwe wpisy,
• czy zwykłe kategorie sklepu nie pokazują wpisów blogowych,
• czy wpis nie pokazuje ceny, koszyka ani stanu magazynowego,
• czy sidebar pokazuje oczekiwane bloki,
• czy dane strukturalne są typu BlogPosting, a nie Product,
• czy sitemap i URL rewrites działają poprawnie,
• czy cache nie pokazuje starego układu po zmianie konfiguracji.

Po zmianach w konfiguracji warto wykonać:

bin/magento cache:clean config layout block_html full_page