Installazione e configurazione del modulo Kowal Blog

Questo documento descrive l'installazione del modulo Kowal_Blog e il significato dei campi di configurazione disponibili nel pannello Magento.

Requisiti

Il modulo è destinato a Magento 2.4.x.

Moduli Magento richiesti:

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

Il modulo viene installato come pacchetto Composer:

kowal/module-blog

Installazione tramite Composer

Aggiungi il repository Composer:

Riceverai via e-mail i dati di accesso al repository Composer, ossia l'indirizzo e-mail del cliente e il token di licenza, dopo l'acquisto. Sono disponibili anche nel pannello cliente dopo l'accesso su kowal.store. Sostituisci TWOJ_EMAIL_KLIENTA con l'indirizzo e-mail del tuo account e TWOJ_TOKEN con il token ricevuto. Esegui i comandi nella directory principale di Magento.

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

Configura i dati di accesso al repository Composer Kowal:

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

Installa il modulo:

composer require kowal/module-blog

Abilita il modulo:

bin/magento module:enable Kowal_Blog

Esegui l'upgrade:

bin/magento setup:upgrade

Svuota la cache:

bin/magento cache:flush

In modalità produzione esegui inoltre:

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

Cosa crea l'installazione

Durante l'installazione il modulo crea:

• il tipo di prodotto blog_post,
• il set di attributi Blog Post,
• gli attributi editoriali del post,
• la configurazione nel pannello Magento,
• i blocchi frontend,
• i template per elenco, post, sidebar e dati strutturati.

Preparazione della categoria del blog

1. Vai a:

Catalog > Categories

2. Crea una categoria che sarà la homepage del blog, ad esempio:

Blog

3. Sotto questa categoria crea le sottocategorie del blog, ad esempio:

Blog / PoradnikiBlog / AktualnościBlog / SEO

4. Assicurati che le categorie siano attive e abbiano un url_key corretto.

Configurazione del modulo

La configurazione si trova in:

Stores > Configuration > Kowal > Blog

La configurazione è suddivisa in tre sezioni:

• General,
• Design,
• Sidebar.

General

Enabled

Abilita o disabilita il modulo sul frontend.

Valori:

• Yes - il modulo funziona,
• No - il modulo non aggiunge il comportamento del blog.

Blog Root Category

Indica la categoria principale del blog.

La categoria selezionata svolge due ruoli:

• è la homepage del blog,
• è il root per le sottocategorie del blog.

Esempio:

Default Category / Blog

Le sottocategorie presenti sotto questa categoria saranno trattate come categorie del blog.

Posts Per Page

Numero di post visualizzati su una singola pagina di listing.

Esempio:

12

Il valore deve essere un numero maggiore di zero.

Post List Display Mode

Definisce il modo in cui viene presentato l'elenco dei post del blog.

Valori disponibili:

• List - elenco classico dei post,
• Grid - 2 Columns - griglia a 2 colonne,
• Grid - 3 Columns - griglia a 3 colonne,
• Grid - 4 Columns - griglia a 4 colonne.

Ogni variante mostra l'immagine del post, il titolo, la data di pubblicazione, l'autore, il lead e il link al post.

Show Future Posts

Determina se i post con data di pubblicazione futura devono essere visibili negli elenchi.

Valori:

• Yes - i post futuri sono visibili,
• No - i post futuri sono nascosti.

Raccomandazione per la produzione:

No

Design

Blog Category Page Layout

Forza il layout della pagina per la homepage del blog e le categorie del blog.

Valori disponibili:

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

Se scegli un layout a due colonne, la sidebar del blog verrà renderizzata in base al lato selezionato.

Blog Post Page Layout

Forza il layout della pagina per il post del blog.

Valori disponibili:

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

Questa impostazione è utile quando i post del blog devono avere un layout diverso rispetto ai normali prodotti.

Remove Blocks on Blog Categories

Elenco dei blocchi di layout da rimuovere sulle pagine delle categorie del blog.

Inserisci un nome di blocco per riga.

Esempio:

catalog.compare.sidebarwishlist_sidebar

Usa questo campo se moduli esterni aggiungono elementi tipici dei prodotti alle categorie del blog.

Remove Blocks on Blog Posts

Elenco dei blocchi di layout da rimuovere sulle pagine dei post del blog.

Inserisci un nome di blocco per riga.

Esempio:

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

Questo campo è utile per nascondere elementi come:

• comparatore,
• wishlist,
• prodotti correlati,
• recensioni prodotto,
• icone dei fornitori,
• tempi di evasione dell'ordine,
• informazioni di magazzino,
• altri blocchi provenienti da moduli prodotto.

Sidebar

Show Blog Categories

Abilita il blocco delle categorie del blog nella sidebar.

Il blocco mostra le categorie presenti sotto la categoria root del blog configurata.

Show Recent Posts

Abilita il blocco degli ultimi post nella sidebar.

I post sono ordinati per data di pubblicazione.

Recent Posts Limit

Definisce il numero di ultimi post visibili nella sidebar.

Esempio:

5

Show Tags

Abilita il blocco dei tag nella sidebar.

I tag provengono dall'attributo:

blog_tags

È un attributo di tipo multiselect.

Creazione di un post

1. Vai a:

Catalog > Products

2. Crea un nuovo prodotto di tipo:

Blog Post

3. Seleziona il set di attributi:

Blog Post

4. Compila i campi di base:

• Name - titolo del post,
• SKU - identificatore tecnico,
• URL Key - indirizzo URL,
• Short Description - lead,
• Description - contenuto completo,
• Image - immagine principale,
• Meta Title,
• Meta Description.

5. Compila i campi del blog:

• Published At,
• Author Name,
• Post Format,
• Tags,
• Reading Level, se utilizzato,
• Featured, se il post deve essere in evidenza.

6. Assegna il post a una categoria situata sotto la categoria root del blog.

Raccomandazioni SEO

Titoli e metadati

Ogni post dovrebbe avere elementi unici:

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

Lead e contenuto

Il campo Short Description dovrebbe essere un lead breve e unico, non una copia del primo paragrafo del contenuto.

Il campo Description dovrebbe contenere l'intero contenuto del post con una struttura logica dei titoli.

Immagini

L'immagine del post dovrebbe avere un'etichetta significativa, perché il modulo la utilizza come alt e title. Se l'etichetta dell'immagine non è impostata, il fallback è il nome del post.

Il modulo renderizza le immagini con gli attributi:

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

Link Leggi di più

I link di tipo Read more negli elenchi sono contrassegnati come:

rel='nofollow'

Il link principale indicizzabile resta il titolo del post.

Verifica dopo la configurazione

Dopo l'installazione e la configurazione, verifica:

• se la categoria root del blog mostra l'elenco dei post,
• se le sottocategorie del blog mostrano i post corretti,
• se le normali categorie del negozio non mostrano post del blog,
• se il post non mostra prezzo, carrello o disponibilità di magazzino,
• se la sidebar mostra i blocchi previsti,
• se i dati strutturati sono di tipo BlogPosting e non Product,
• se sitemap e URL rewrites funzionano correttamente,
• se la cache non mostra il vecchio layout dopo una modifica della configurazione.

Dopo le modifiche alla configurazione è consigliabile eseguire:

bin/magento cache:clean config layout block_html full_page