Segunda descripción de categoría: configuración y ayuda

Sube el ZIP en Módulos > "Module Manager" > "Upload a module". Instálalo y haz clic en "Configure". Abre "Improve" > Segunda descripción de categoría para acceder al panel, a Plantillas y a Configuración.

Requiere PrestaShop 1.6 o posterior y PHP 7.1 o posterior.

La instalación crea estas tablas con el prefijo de tu base de datos:

mprscd_description
mprscd_description_lang
mprscd_injection
mprscd_profile

Elige el contexto de tienda correcto, abre "Catalog" > Categorías y edita una categoría. Rellena Segunda descripción de categoría debajo de la descripción estándar. Introduce contenido para cada idioma necesario y guarda.

En versiones de PrestaShop anteriores a 1.7.7, usa el formulario de categoría antiguo para introducir la descripción.

Las descripciones se guardan por categoría y tienda, con registros separados por idioma. Una traducción vacía no recurre automáticamente al idioma predeterminado. Una página sin contenido guardado para su categoría, idioma y tienda no devuelve ningún bloque.

Puedes estructurar el contenido con encabezados, párrafos, listas y enlaces. Por ejemplo:

<h2>Buying guide for this category</h2>
<p>Explain how to choose between the products in this category.</p>
<h3>What to compare before ordering</h3>
<ul>
  <li>Size or dimensions</li>
  <li>Material or finish</li>
  <li>Compatibility with the rest of the order</li>
</ul>
<h3>Related categories</h3>
<p>Add relevant links to related categories.</p>

Abre Segunda descripción de categoría > Configuración > General.

Guarda los cambios. El panel Ubicación de la plantilla enlaza con Abrir administrador de plantillas e indica si hay una inyección registrada activa.

Usa el hook del pie de categoría

"Default (inside column)" y "Full width (CSS breakout)" muestran el contenido mediante displayFooterCategory. Inspecciona la plantilla de categoría para confirmar que el hook aparezca donde quieres el bloque.

El ancho completo añade mprscd-fullwidth. Es una expansión mediante CSS que puede seguir limitada por la estructura del tema que la rodea.

Usa la inyección en plantillas

Abre Plantillas y analiza el tema activo. Revisa el archivo y la posición propuestos. Guarda una copia del archivo del tema antes de modificarlo y después inserta el hook registrado. Selecciona "Template injection" en "Display Mode".

El marcador del hook insertado es:

{* MPRSCD_INJECT *}{hook h='displayMprSecondCatDesc'}{* /MPRSCD_INJECT *}

También puedes colocar {hook h='displayMprSecondCatDesc'} manualmente. Este hook personalizado solo muestra contenido cuando "Display Mode" es "Template injection". Muestra el bloque a ancho completo.

En modo de inyección, una inserción registrada activa muestra la descripción en la posición insertada y la oculta en el pie de categoría habitual. Sin una inserción registrada activa, la descripción puede seguir apareciendo en el pie de categoría. Comprueba si hay descripciones duplicadas si combinas una inserción manual con la posición habitual del pie.

Después de actualizar o sustituir un tema, comprueba el estado de la inyección y vuelve a analizarlo. El gestor puede eliminar las inserciones registradas.

Abre una categoría con contenido guardado. Comprueba que aparezca en la posición esperada del pie o de la inyección. Comprueba otro idioma y, en multitienda, otro contexto de tienda. Abre una categoría sin descripción guardada y confirma que no aparezca un bloque vacío.

Con "First Page Only" activado, abre la página 2 y comprueba que el bloque esté oculto. El ajuste usa el número page de la URL de categoría. Si tu tema usa otro formato de paginación, comprueba que el bloque siga oculto en las páginas siguientes.

El contenedor normal es:

<div class="mprscd-description">
  <div class="mprscd-content">
    <!-- your saved description -->
  </div>
</div>

El modo de ancho completo añade mprscd-fullwidth a la lista de clases externas. Ajusta los estilos en tu tema si es necesario:

.mprscd-description {
  margin-top: 2rem;
  background: #fff;
}
.mprscd-description .mprscd-content {
  line-height: 1.7;
}
.mprscd-description.mprscd-fullwidth .mprscd-content {
  max-width: 1170px;
  margin-left: auto;
  margin-right: auto;
}

Si sustituyes "CSS Class", actualiza los selectores CSS según corresponda.

Confirma que "Enable Module" esté en Sí, que la categoría sea correcta y que haya contenido guardado para la tienda y el idioma actuales. Comprueba "First Page Only" antes de diagnosticar una página posterior de la paginación.

Si falta contenido en el modo "Default", confirma que el tema muestre displayFooterCategory. Si falta en el modo "Template injection", confirma que el hook personalizado insertado esté presente en la plantilla activa. Este hook no devuelve nada en otros modos de visualización ni fuera de las páginas de categoría.

Si el contenido aparece dos veces, comprueba si hay tanto un hook manual como una posición activa en el pie. Usa posiciones registradas y comprueba el estado de la inyección del módulo después de cambiar el tema.

Vacía la caché de página o de plantillas pertinente después de editar. Usa la página "Integrity" del módulo para comprobar la infraestructura requerida. El panel muestra cuántas categorías tienen descripción.

Las descripciones permanecen en el módulo y no se copian al campo nativo de descripción adicional de categoría. Los ajustes no incluyen una herramienta de migración.

Usa "Enable Module" = No para ocultar las descripciones sin eliminarlas.

Antes de desinstalar, exporta las descripciones que quieras conservar. La desinstalación elimina las tablas del módulo, incluidas las descripciones guardadas, los registros de inyección y los perfiles. Al eliminar una categoría también se eliminan los registros de descripción correspondientes del módulo.

La desinstalación intenta primero eliminar las inyecciones registradas en las plantillas. Si la limpieza falla, puede continuar y registrar el fallo. Inspecciona después las plantillas del tema modificadas y elimina las llamadas manuales o registradas a hooks que queden, si es necesario.