Instalação e configuração do módulo Kowal Blog
Este documento descreve a instalação do módulo Kowal_Blog e o significado dos campos de configuração disponíveis no painel Magento.
Requisitos
O módulo destina-se a Magento 2.4.x.
Módulos Magento necessários:
Magento_Catalog,Magento_CatalogUrlRewrite,Magento_Eav,Magento_Store.
O módulo é instalado como pacote Composer:
kowal/module-blogInstalação através do Composer
Adicione o repositório Composer:
composer config repositories.kowal composer https://repo.kowal.storeSe o repositório for privado, adicione o token GitHub:
composer config http-basic.repo.kowal.store Instale o módulo:
composer require kowal/module-blogAtive o módulo:
bin/magento module:enable Kowal_BlogExecute o upgrade:
bin/magento setup:upgradeLimpe a cache:
bin/magento cache:flushNo modo de produção, execute adicionalmente:
bin/magento setup:di:compilebin/magento setup:static-content:deploybin/magento indexer:reindexO que a instalação cria
Durante a instalação, o módulo cria:
- o tipo de produto
blog_post, - o conjunto de atributos
Blog Post, - atributos editoriais da publicação,
- configuração no painel Magento,
- blocos de frontend,
- templates de lista, publicação, sidebar e dados estruturados.
Preparação da categoria do blog
- Aceda a:
Catalog > Categories- Crie uma categoria que será a página inicial do blog, por exemplo:
Blog- Sob esta categoria, crie subcategorias do blog, por exemplo:
Blog / PoradnikiBlog / AktualnościBlog / SEO- Certifique-se de que as categorias estão ativas e têm
url_keycorretos.
Configuração do módulo
A configuração encontra-se em:
Stores > Configuration > Kowal > BlogA configuração está dividida em três secções:
General,Design,Sidebar.
General
Enabled
Ativa ou desativa o módulo no frontend.
Valores:
Yes- o módulo funciona,No- o módulo não adiciona o comportamento de blog.
Blog Root Category
Indica a categoria principal do blog.
A categoria selecionada desempenha duas funções:
- é a página inicial do blog,
- é a raiz das subcategorias do blog.
Exemplo:
Default Category / BlogAs subcategorias que se encontram sob esta categoria serão tratadas como categorias de blog.
Posts Per Page
Número de publicações apresentadas numa única página de listagem.
Exemplo:
12O valor deve ser um número superior a zero.
Post List Display Mode
Define a forma de apresentação da lista de publicações do blog.
Valores disponíveis:
List- lista clássica de publicações,Grid - 2 Columns- grelha em 2 colunas,Grid - 3 Columns- grelha em 3 colunas,Grid - 4 Columns- grelha em 4 colunas.
Cada variante mostra a imagem da publicação, o título, a data de publicação, o autor, a introdução e o link para a publicação.
Show Future Posts
Determina se as publicações com data de publicação futura devem estar visíveis nas listas.
Valores:
Yes- as publicações futuras ficam visíveis,No- as publicações futuras ficam ocultas.
Recomendação para produção:
NoDesign
Blog Category Page Layout
Força o layout da página para a página inicial do blog e para as categorias do blog.
Valores disponíveis:
Use Magento Default,1 Column,2 Columns with Left Sidebar,2 Columns with Right Sidebar.
Se selecionar um layout de duas colunas, a sidebar do blog será renderizada de acordo com o lado escolhido.
Blog Post Page Layout
Força o layout da página para uma publicação de blog.
Valores disponíveis:
Use Magento Default,1 Column,2 Columns with Left Sidebar,2 Columns with Right Sidebar.
Esta definição é útil quando as publicações de blog devem ter um layout diferente dos produtos normais.
Remove Blocks on Blog Categories
Lista de blocos de layout que devem ser removidos nas páginas de categorias do blog.
Introduza um nome de bloco por linha.
Exemplo:
catalog.compare.sidebarwishlist_sidebarUtilize este campo se módulos externos adicionarem elementos típicos de produto às categorias do blog.
Remove Blocks on Blog Posts
Lista de blocos de layout que devem ser removidos nas páginas de publicações do blog.
Introduza um nome de bloco por linha.
Exemplo:
catalog.compare.sidebarwishlist_sidebarproduct.info.upsellcatalog.product.relatedproduct.info.reviewproduct.info.socialEste campo é útil para ocultar elementos como:
- comparador,
- lista de desejos,
- produtos relacionados,
- avaliações de produto,
- ícones de fornecedores,
- prazo de entrega da encomenda,
- informações de stock,
- outros blocos provenientes de módulos de produto.
Sidebar
Show Blog Categories
Ativa o bloco de categorias do blog na sidebar.
O bloco mostra as categorias que se encontram sob a categoria raiz do blog configurada.
Show Recent Posts
Ativa o bloco de publicações recentes na sidebar.
As publicações são ordenadas pela data de publicação.
Recent Posts Limit
Define o número de publicações recentes visíveis na sidebar.
Exemplo:
5Show Tags
Ativa o bloco de tags na sidebar.
As tags provêm do atributo:
blog_tagsEste é um atributo do tipo multiselect.
Criação de uma publicação
- Aceda a:
Catalog > Products- Crie um novo produto do tipo:
Blog Post- Selecione o conjunto de atributos:
Blog Post- Preencha os campos básicos:
Name- título da publicação,SKU- identificador técnico,URL Key- endereço URL,Short Description- introdução,Description- conteúdo completo,Image- imagem principal,Meta Title,Meta Description.
- Preencha os campos do blog:
Published At,Author Name,Post Format,Tags,Reading Level, se utilizado,Featured, se a publicação deve ser destacada.
- Atribua a publicação a uma categoria localizada sob a categoria raiz do blog.
Recomendações SEO
Títulos e meta dados
Cada publicação deve ter valores únicos para:
Name,URL Key,Meta Title,Meta Description.
Introdução e conteúdo
O campo Short Description deve ser uma introdução curta e única, e não uma cópia do primeiro parágrafo do conteúdo.
O campo Description deve conter o conteúdo completo da publicação com uma estrutura lógica de cabeçalhos.
Imagens
A imagem da publicação deve ter uma etiqueta significativa, porque o módulo utiliza-a como alt e title. Se a etiqueta da imagem não estiver definida, o fallback é o nome da publicação.
O módulo renderiza imagens com os atributos:
alt,title,width,height.
Links Ler mais
Os links do tipo Read more nas listas são marcados como:
rel='nofollow'O principal link indexável continua a ser o título da publicação.
Verificação após a configuração
Após a instalação e configuração, verifique:
- se a categoria raiz do blog apresenta a lista de publicações,
- se as subcategorias do blog mostram as publicações corretas,
- se as categorias normais da loja não mostram publicações de blog,
- se a publicação não mostra preço, carrinho nem estado de stock,
- se a sidebar mostra os blocos esperados,
- se os dados estruturados são do tipo
BlogPostinge nãoProduct, - se o sitemap e os URL rewrites funcionam corretamente,
- se a cache não mostra o layout antigo após a alteração da configuração.
Após alterações na configuração, recomenda-se executar:
bin/magento cache:clean config layout block_html full_page










