PrestaShop Product SEO Subtitles — Documentación
Añade subtítulos SEO específicos después del encabezado principal en páginas de producto, categoría, CMS, fabricante y proveedor. En lugar de cambiar el nombre de su producto o categoría, puede añadir una segunda línea, como un beneficio, una frase long-tail, un detalle de tamaño, material, marca o mensaje de campaña.
Subtítulos SEO de producto
Cada página importante de su tienda tiene un título principal, pero ese único título a menudo no puede incluir todas las frases que buscan los clientes. SEO Subtitles le ofrece un registro de subtítulo separado que puede mostrarse directamente después del H1 de la página, usando un elemento HTML real como h2, h3, p, span o div.
El módulo no se limita a un único campo de producto codificado de forma fija. Gestiona reglas de subtítulos en una sección dedicada del Back Office, donde cada subtítulo puede tener su propio texto, selección de destino, etiqueta HTML, clase CSS, prioridad y estado activo.
Tipos de página/entidad compatibles en el código del módulo:
product
category
cms
manufacturer
supplier
Compatibilidad: PrestaShop 1.6 a 9.0 (latest), PHP 7.1+. Seguimos dando soporte a las próximas versiones de PrestaShop.
Cómo funciona
Después de la instalación, el módulo añade un nuevo menú SEO Subtitles en el Back Office. Desde ahí puede crear registros de subtítulos y decidir dónde deben aparecer.
Un registro de subtítulo contiene:
Subtitle Text
Name
Target Entities
HTML Tag
CSS Class
Priority
Active
El subtítulo se renderiza mediante el hook del módulo:
{hook h='displayMprSubtitle'}
Para listados de productos o ubicaciones personalizadas del tema, el hook también puede recibir un ID de producto y opciones de visualización:
{hook h='displayMprSubtitle' id_product=$product.id}
{hook h='displayMprSubtitle' id_product=$product.id tag='h3'}
{hook h='displayMprSubtitle' tag='h3' css_class='category-subtitle'}
La salida en la tienda es un elemento HTML real con clases CSS del módulo:
<h2 class="mpr-subtitle mpr-subtitle-product mpr-seo-subtitle">
Walk-in shower tray with anti-slip stone resin surface
</h2>
Si no existe ningún subtítulo activo que coincida, no se muestra nada y la página conserva su diseño normal.
Instalación
- En su Back Office, vaya a Modules → Module Manager
- Haga clic en Upload a module y seleccione el archivo ZIP
- Instale el módulo
- Abra SEO Subtitles en el menú del Back Office
- Use Templates para escanear su tema y añadir el hook del subtítulo donde sea necesario
- Cree su primer subtítulo en Subtitles
Configuración
Ajustes predeterminados
El módulo guarda sus ajustes principales en su tabla de configuración usando estas claves:
default_tag = h2
default_class = mpr-seo-subtitle
display_mode = single
La pantalla de configuración incluye:
Default HTML Tag
Default CSS Class
Display Mode
Etiqueta HTML
Puede elegir la etiqueta usada para un subtítulo. Los valores permitidos son:
h2
h3
h4
h5
h6
p
span
div
Para la mayoría de páginas de producto y categoría, h2 es el mejor punto de partida, porque el título principal de la página normalmente ya es el h1.
Ejemplo de subtítulo usando la etiqueta de encabezado predeterminada:
Ultra-slim shower tray, stone resin finish, easy-clean surface
Ejemplo en el que resulta más adecuada una etiqueta de encabezado más pequeña:
HTML Tag: h3
Subtitle Text: Compatible with low-profile walk-in shower installation
Modo de visualización
El módulo puede mostrar un solo subtítulo o varios subtítulos coincidentes.
single = show only the highest-priority matching subtitle
all = show all matching subtitles, sorted by priority
La prioridad se ordena de mayor a menor:
Priority 100 → shown before priority 10
Priority 10 → default priority
Clase CSS
Cada subtítulo siempre recibe las clases base del módulo:
mpr-subtitle
mpr-subtitle-product
mpr-subtitle-category
mpr-subtitle-cms
mpr-subtitle-manufacturer
mpr-subtitle-supplier
Su clase personalizada se añade después de esas clases. Ejemplo:
CSS Class: homepage-product-subtitle
Resultado en una página de producto:
<h2 class="mpr-subtitle mpr-subtitle-product homepage-product-subtitle">
Made-to-measure shower screen in clear safety glass
</h2>
Template Manager
El módulo incluye un Template Manager que escanea las plantillas de su tema activo, detecta ubicaciones de encabezados y puede insertar el hook del subtítulo después del encabezado seleccionado.
Los hooks insertados se envuelven con marcadores para que puedan rastrearse y eliminarse más tarde:
{* MPR_SUBTITLE_INJECT *}{hook h='displayMprSubtitle'}{* /MPR_SUBTITLE_INJECT *}
El gestor revisa los archivos de plantilla del tema dentro del directorio themes de la tienda y solo trabaja con archivos .tpl. Si encuentra un hook displayMprSubtitle existente sin marcador en el mismo archivo, lo informa en lugar de añadir un duplicado.
Smart Tags
El texto del subtítulo admite placeholders. Son útiles cuando una regla de subtítulo debe adaptarse automáticamente a cada producto.
Placeholders de producto comunes:
{name}
{reference}
{ean13}
{price}
{manufacturer}
{category}
{feature:Feature name}
{attribute:Attribute group name}
Ejemplos:
{name} from {manufacturer} — available from {price}
{category} product with reference {reference}
{feature:Material} shower tray with {attribute:Color} finish
Para páginas de categoría, CMS, fabricante y proveedor, {name} se resuelve como el nombre de la entidad actual:
{name} — selected products and practical buying information
Segmentación de subtítulos
Al crear un subtítulo, use Target Entities para decidir dónde aparece. El módulo admite segmentación de entidades específicas y reglas de selección más amplias.
Un subtítulo de producto individual puede usarse para un solo producto:
Target: specific product
Subtitle Text: Low-profile shower tray with stone resin surface
HTML Tag: h2
Priority: 10
Active: Yes
Una regla de producto más amplia puede aplicarse a productos por categoría, fabricante o proveedor cuando los datos del selector usan esas condiciones. El resolver también admite exclusiones, por lo que una regla puede aplicarse de forma amplia mientras omite productos seleccionados.
Métodos de segmentación de producto compatibles en el resolver:
all
specific
by_category
by_manufacturer
by_supplier
Exclusiones compatibles:
specific
by_category
Ejemplos prácticos
Subtítulo de producto
Product name:
Shower Tray 90x90
Subtitle:
Ultra-slim stone resin tray with easy-clean anti-slip surface
Subtítulo de categoría
Category name:
Walk-in Shower Screens
Subtitle:
Frameless glass panels for modern wetroom and walk-in shower layouts
Subtítulo de página CMS
CMS page:
Delivery Information
Subtitle:
Shipping times, carrier options and delivery notes for bathroom products
Subtítulo dinámico de producto
{name} by {manufacturer} — {feature:Material}, available from {price}
Consejos
- Use el subtítulo para añadir información que no encaja de forma natural en el título de la página: material, tamaño, tipo de instalación, acabado, compatibilidad o una frase de búsqueda long-tail.
- Evite repetir palabra por palabra el nombre del producto o de la categoría. El subtítulo debe añadir contexto útil.
- Mantenga los subtítulos de producto lo bastante concisos para que se lean bien en pantallas móviles.
- Use placeholders para patrones repetibles en muchos productos.
- Use la prioridad cuando varias reglas de subtítulos puedan coincidir con la misma página.
- Empiece por sus páginas de producto y categoría más importantes y luego amplíe a reglas más generales.
Preguntas frecuentes
¿El subtítulo cambiará el nombre de mi producto?
No. El subtítulo se muestra por separado. No cambia el nombre del producto, la categoría, la página CMS, el fabricante ni el proveedor.
¿El subtítulo cambia mi meta title?
No. El módulo renderiza contenido de subtítulo en la página. No reescribe el meta title de la página.
¿Puedo dejar subtítulos vacíos en algunas páginas?
Sí. Si ningún subtítulo activo coincide con una página, el módulo no devuelve ninguna salida.
¿Puedo usar subtítulos diferentes en distintos idiomas?
Sí. El texto del subtítulo es multilingüe, por lo que puede introducir un texto diferente para cada idioma de su tienda.
¿Puedo mostrar más de un subtítulo en la misma página?
Sí. Configure el modo de visualización en all. Con el modo predeterminado single, solo se muestra el subtítulo coincidente con mayor prioridad.
¿Funcionará con mi tema actual?
El módulo usa un hook Smarty e incluye un Template Manager para colocar ese hook después del encabezado de la página. Los temas estándar de PrestaShop deberían funcionar normalmente. Los temas personalizados pueden necesitar el Template Manager o una colocación manual del hook.
¿Qué hook usa el módulo?
El hook principal es:
{hook h='displayMprSubtitle'}
También hay un alias de compatibilidad para temas que usan:
{hook h='displayProductSubtitle'}