Gestor de subtítulos: configuración y ayuda

Sube el ZIP en Módulos > "Module Manager" > "Upload a module". Instálalo y haz clic en "Configure". Abre "Improve" > Subtítulos SEO. Usa Subtítulos para reglas de contenido, Plantillas para la colocación y Ajustes > Configuración para valores predeterminados.

Requiere PrestaShop 1.6.1 o posterior y PHP 7.1 o posterior.

La colocación en la tienda usa plantillas Smarty y displayMprSubtitle. La inyección automática requiere que el proceso PHP pueda escribir en el archivo .tpl del tema seleccionado.

Abre Ajustes > Configuración.

Guarda los cambios. Las clases base mpr-subtitle y mpr-subtitle-{type} se añaden independientemente de tu clase personalizada.

Abre Subtítulos y añade una regla.

El selector admite grupos como productos específicos, todos los productos, productos de categorías, de fabricantes y de proveedores. Las condiciones de exclusión de productos pueden retirar productos individuales o coincidencias de categoría.

Los subtítulos también admiten páginas de detalle de fabricantes y proveedores. El editor principal de reglas está configurado para seleccionar productos, categorías y CMS. Comprueba los controles disponibles en el selector antes de planificar reglas de fabricantes o proveedores.

Para productos puedes usar {name}, {category}, {manufacturer}, {price} y {reference}. Los marcadores de características y atributos usan el nombre de la característica o grupo en el idioma actual:

{name} by {manufacturer} - {feature:Material}, available from {price}
{name} - {attribute:Color}

Los valores de atributos proceden de la combinación predeterminada del producto. No siguen automáticamente cada cambio de combinación en el cliente. Los datos ausentes pueden producir valores vacíos; inspecciona la frase completa.

Para las entidades admitidas distintas de productos, {name} usa el nombre de la entidad actual o el título CMS. Por ejemplo:

{name} - buying information

Abre Plantillas y escanea el tema activo. Revisa la página detectada, Archivo y Línea antes de inyectar. Conserva una copia de los archivos del tema que modifiques.

El control Etiqueta de la tarjeta de escaneo establece una sobrescritura opcional de renderizado. Su valor predeterminado es la etiqueta del subtítulo/predeterminada. En línea tiene Desactivado por defecto y controla si la inserción queda en la misma línea de plantilla que el encabezado. El perfil de página está activo por defecto; desactivar Activado impide la salida del subtítulo para ese perfil detectado.

El mecanismo de colocación guarda una etiqueta de encabezado, una de renderizado, parámetros del hook y la preferencia inline. Sus valores habituales son h1 para buscar el encabezado, sobrescritura de renderizado vacía, parámetros de hook vacíos e inline desactivado. Estos nombres guardados no son todos etiquetas de ajustes visibles separadas en la tarjeta de escaneo.

La inyección escribe un marcador eliminable:

{* MPR_SUBTITLE_INJECT *}{hook h='displayMprSubtitle'}{* /MPR_SUBTITLE_INJECT *}

Puedes colocar el hook tú mismo después del encabezado correspondiente:

{hook h='displayMprSubtitle'}

Para una tarjeta de producto, pasa el ID del producto y una etiqueta opcional:

{hook h='displayMprSubtitle' id_product=$product.id tag='h3'}

También puedes proporcionar una clase personalizada:

{hook h='displayMprSubtitle' tag='h3' css_class='category-subtitle'}

La etiqueta de renderizado de un perfil activo tiene prioridad sobre el parámetro tag del hook. El parámetro de clase del hook puede sustituir la clase personalizada preparada. Las plantillas muy personalizadas o los encabezados generados por JavaScript pueden requerir colocación manual.

Guarda un subtítulo activo para un producto y ábrelo en la tienda. Confirma que el texto aparece donde está el hook. Repite en otro idioma. Abre una página no seleccionada y confirma que la regla no se aplica allí.

Si coinciden varias reglas, "Single subtitle" devuelve el resultado de mayor prioridad. "Multiple subtitles" devuelve los resultados coincidentes por prioridad descendente. Sin un subtítulo activo coincidente no hay salida.

Un resultado normal puede ser:

<h2 class="mpr-subtitle mpr-subtitle-product mpr-seo-subtitle">Product information</h2>

Puedes dar estilo a las clases en la hoja de estilos personalizada del tema:

.mpr-subtitle {
  margin-top: 0;
  margin-bottom: .5rem;
  font-weight: 400;
  color: #666;
  line-height: 1.4;
}
.mpr-subtitle-product.category-subtitle {
  font-size: 1rem;
  color: #444;
}

El módulo muestra un texto visible independiente. No cambia el nombre de la entidad ni su metatítulo, metadescripción o URL.

Comprueba Activo, selección, texto por idioma, prioridad y "Display Mode". Confirma que el archivo correcto del tema contiene displayMprSubtitle y que el perfil de página detectado está activado. Vacía la caché del tema compilado o de páginas tras cambiar la colocación. La creación, actualización, eliminación, cambios de estado y operaciones masivas de reglas vacían la caché de plantillas del hook del módulo.

Si los marcadores están vacíos, comprueba el campo de origen y el nombre traducido de la característica o grupo de atributos. Si un listado muestra el texto del producto equivocado, pasa su id_product real al hook.

Después de actualizar el tema, comprueba el estado de inyección registrado y vuelve a escanear. El gestor de plantillas permite explorar, inspeccionar, editar, inyectar y eliminar las plantillas de tema admitidas. La escritura requiere acceso a esos archivos.

Si la toma de control de subtítulos de SEO Revolution está activada, este módulo independiente no devuelve subtítulos intencionadamente. Revisa esa configuración antes de diagnosticar renderizadores duplicados o ausentes.

Desactiva el módulo o reglas individuales para detener temporalmente la visualización.

La desinstalación conserva el contenido de los subtítulos y los perfiles. Sin SEO Revolution, la desinstalación independiente elimina las inyecciones de hooks registradas. Si SEO Revolution está instalado, la desinstalación requiere que su toma de control de subtítulos esté activada, registrada y funcionando; de lo contrario el módulo bloquea la eliminación con un mensaje explicativo. Si la toma de control está lista, conserva las inyecciones para el renderizador sustituto.

La desinstalación elimina el menú independiente, los ajustes y las preferencias administrativas. Revisa después los archivos de plantilla, especialmente las llamadas al hook que hayas insertado manualmente.