Instalación y configuración del módulo Kowal Blog
Este documento describe la instalación del módulo Kowal_Blog y el significado de los campos de configuración disponibles en el panel de Magento.
Requisitos
El módulo está destinado a Magento 2.4.x.
Módulos de Magento requeridos:
Magento_Catalog,Magento_CatalogUrlRewrite,Magento_Eav,Magento_Store.
El módulo se instala como paquete Composer:
kowal/module-blogInstalación mediante Composer
Añade el repositorio Composer:
composer config repositories.kowal composer https://repo.kowal.storeSi el repositorio es privado, añade el token de GitHub:
composer config http-basic.repo.kowal.store Instala el módulo:
composer require kowal/module-blogActiva el módulo:
bin/magento module:enable Kowal_BlogEjecuta el upgrade:
bin/magento setup:upgradeLimpia la caché:
bin/magento cache:flushEn modo producción, ejecuta además:
bin/magento setup:di:compilebin/magento setup:static-content:deploybin/magento indexer:reindexQué crea la instalación
Durante la instalación, el módulo crea:
- el tipo de producto
blog_post, - el conjunto de atributos
Blog Post, - atributos editoriales de la entrada,
- configuración en el panel de Magento,
- bloques de frontend,
- plantillas para la lista, la entrada, el sidebar y los datos estructurados.
Preparación de la categoría del blog
- Ve a:
Catalog > Categories- Crea una categoría que será la página principal del blog, por ejemplo:
Blog- Debajo de esta categoría, crea subcategorías del blog, por ejemplo:
Blog / PoradnikiBlog / AktualnościBlog / SEO- Asegúrate de que las categorías estén activas y tengan un
url_keycorrecto.
Configuración del módulo
La configuración se encuentra en:
Stores > Configuration > Kowal > BlogLa configuración se divide en tres secciones:
General,Design,Sidebar.
General
Enabled
Activa o desactiva el módulo en el frontend.
Valores:
Yes- el módulo funciona,No- el módulo no añade el comportamiento de blog.
Blog Root Category
Indica la categoría principal del blog.
La categoría seleccionada cumple dos funciones:
- es la página principal del blog,
- es la raíz para las subcategorías del blog.
Ejemplo:
Default Category / BlogLas subcategorías ubicadas bajo esta categoría se tratarán como categorías del blog.
Posts Per Page
Número de entradas mostradas en una página de listado.
Ejemplo:
12El valor debe ser un número mayor que cero.
Post List Display Mode
Define la forma de presentar la lista de entradas del blog.
Valores disponibles:
List- lista clásica de entradas,Grid - 2 Columns- cuadrícula en 2 columnas,Grid - 3 Columns- cuadrícula en 3 columnas,Grid - 4 Columns- cuadrícula en 4 columnas.
Cada variante muestra la imagen de la entrada, el título, la fecha de publicación, el autor, la entradilla y el enlace a la entrada.
Show Future Posts
Determina si las entradas con fecha de publicación futura deben ser visibles en las listas.
Valores:
Yes- las entradas futuras son visibles,No- las entradas futuras están ocultas.
Recomendación para producción:
NoDesign
Blog Category Page Layout
Fuerza el layout de página para la página principal del blog y las categorías del blog.
Valores disponibles:
Use Magento Default,1 Column,2 Columns with Left Sidebar,2 Columns with Right Sidebar.
Si seleccionas un layout de dos columnas, el sidebar del blog se renderizará según la página elegida.
Blog Post Page Layout
Fuerza el layout de página para la entrada del blog.
Valores disponibles:
Use Magento Default,1 Column,2 Columns with Left Sidebar,2 Columns with Right Sidebar.
Esta configuración es útil cuando las entradas del blog deben tener un layout diferente al de los productos habituales.
Remove Blocks on Blog Categories
Lista de bloques de layout que deben eliminarse en las páginas de categorías del blog.
Introduce un nombre de bloque por línea.
Ejemplo:
catalog.compare.sidebarwishlist_sidebarUtiliza este campo si módulos externos añaden elementos típicos de producto a las categorías del blog.
Remove Blocks on Blog Posts
Lista de bloques de layout que deben eliminarse en las páginas de entradas del blog.
Introduce un nombre de bloque por línea.
Ejemplo:
catalog.compare.sidebarwishlist_sidebarproduct.info.upsellcatalog.product.relatedproduct.info.reviewproduct.info.socialEste campo es útil para ocultar elementos como:
- comparador,
- lista de deseos,
- productos relacionados,
- reseñas de producto,
- iconos de proveedores,
- plazo de preparación del pedido,
- información de stock,
- otros bloques procedentes de módulos de producto.
Sidebar
Show Blog Categories
Activa el bloque de categorías del blog en el sidebar.
El bloque muestra las categorías situadas bajo la categoría raíz del blog configurada.
Show Recent Posts
Activa el bloque de últimas entradas en el sidebar.
Las entradas se ordenan por fecha de publicación.
Recent Posts Limit
Define el número de últimas entradas visibles en el sidebar.
Ejemplo:
5Show Tags
Activa el bloque de etiquetas en el sidebar.
Las etiquetas proceden del atributo:
blog_tagsEs un atributo de tipo multiselect.
Creación de una entrada
- Ve a:
Catalog > Products- Crea un nuevo producto de tipo:
Blog Post- Selecciona el conjunto de atributos:
Blog Post- Completa los campos básicos:
Name- título de la entrada,SKU- identificador técnico,URL Key- URL,Short Description- entradilla,Description- contenido completo,Image- imagen principal,Meta Title,Meta Description.
- Completa los campos del blog:
Published At,Author Name,Post Format,Tags,Reading Level, si se utiliza,Featured, si la entrada debe destacarse.
- Asigna la entrada a una categoría situada bajo la categoría raíz del blog.
Recomendaciones SEO
Títulos y metadatos
Cada entrada debe tener valores únicos en:
Name,URL Key,Meta Title,Meta Description.
Entradilla y contenido
El campo Short Description debe ser una entradilla breve y única, no una copia del primer párrafo del contenido.
El campo Description debe contener el contenido completo de la entrada con una estructura lógica de encabezados.
Imágenes
La imagen de la entrada debe tener una etiqueta significativa, ya que el módulo la utiliza como alt y title. Si la etiqueta de la imagen no está configurada, el fallback es el nombre de la entrada.
El módulo renderiza imágenes con los atributos:
alt,title,width,height.
Enlaces Leer más
Los enlaces de tipo Read more en las listas se marcan como:
rel='nofollow'El enlace principal indexable sigue siendo el título de la entrada.
Verificación después de la configuración
Tras la instalación y configuración, comprueba:
- si la categoría raíz del blog muestra la lista de entradas,
- si las subcategorías del blog muestran las entradas correctas,
- si las categorías habituales de la tienda no muestran entradas del blog,
- si la entrada no muestra precio, carrito ni estado de stock,
- si el sidebar muestra los bloques esperados,
- si los datos estructurados son de tipo
BlogPostingy noProduct, - si el sitemap y los URL rewrites funcionan correctamente,
- si la caché no muestra el layout antiguo después de cambiar la configuración.
Después de cambios en la configuración, conviene ejecutar:
bin/magento cache:clean config layout block_html full_page










