Metatag
Proporciona meta tags estructurados para las entidades de contenido de Drupal para mejorar el SEO y el intercambio en redes sociales.
metatag
Install
composer require 'drupal/metatag:^2.2'
composer require 'drupal/metatag:^2.1'
Overview
El módulo Metatag permite a los constructores de sitios proporcionar automáticamente metadatos estructurados (meta tags) sobre el sitio y las páginas individuales. Estos metadatos ayudan a los motores de búsqueda a comprender el contenido de la página, mejoran el posicionamiento en búsquedas y controlan cómo aparece el contenido cuando se comparte en redes sociales como Facebook, Twitter y LinkedIn.
El módulo utiliza un sistema jerárquico de valores predeterminados donde los meta tags globales pueden sobrescribirse a nivel de tipo de entidad, nivel de bundle y finalmente a nivel de entidad individual. El soporte de Token permite la inserción dinámica de valores desde campos de entidad e información del sitio.
El módulo proporciona una arquitectura basada en plugins con más de 300 meta tags individuales disponibles a través de varios submódulos que cubren Open Graph Protocol, Twitter Cards, Dublin Core, favicons, configuraciones móviles y más. Se pueden añadir meta tags personalizados a través del sistema de plugins.
Features
- Sistema jerárquico de valores predeterminados con configuración de meta tags global, por tipo de entidad, por bundle y por entidad
- Sustitución dinámica de valores basada en Token para el llenado automático de meta tags
- Tipo de campo para almacenar sobrescrituras de meta tags por entidad con soporte para traducción y revisiones
- Soporte para más de 300 meta tags a través de submódulos que cubren Open Graph, Twitter Cards, Dublin Core y más
- Arquitectura basada en plugins para añadir fácilmente meta tags personalizados mediante módulos contribuidos
- Integración con Views para añadir meta tags a páginas de Views
- Soporte de migración desde Drupal 6 Nodewords y módulos Drupal 7 Metatag
- Integración con JSON API / REST para exponer meta tags a través de servicios web
- Integración con Search API para indexar valores de meta tags
- Configuración para limitar qué grupos de meta tags aparecen en los formularios de entidad
- Recorte de valores de meta tags con longitudes máximas configurables
- Página de informe que muestra todos los meta tags disponibles y sus proveedores
- Configuraciones especiales de meta tags para la página principal, páginas de error 403 y 404
- Configuraciones del widget para ubicación en barra lateral y contenedores con desplazamiento
Use Cases
Optimización SEO para sitios de contenido
Configura meta tags predeterminados con tokens como [node:title] y [node:summary] para generar automáticamente meta descripciones amigables para SEO. Configura valores predeterminados por tipo de contenido para diferentes patrones de descripción.
Optimización para compartir en redes sociales
Instala los submódulos metatag_open_graph y metatag_twitter_cards para controlar cómo aparece el contenido cuando se comparte en Facebook, Twitter, LinkedIn y Pinterest. Configura tokens og:image y twitter:image para usar imágenes destacadas de artículos.
SEO para sitios multilingües
Usa el submódulo metatag_hreflang para generar automáticamente etiquetas hreflang para contenido traducido, ayudando a los motores de búsqueda a servir la versión del idioma correcta a los usuarios.
Páginas de productos de comercio electrónico
Usa metatag_open_graph_products para añadir meta tags específicos de productos para compartido social enriquecido incluyendo información de precio, disponibilidad y categoría de producto.
Verificación de sitio
Usa el submódulo metatag_verification para añadir meta tags de verificación para Google Search Console, Bing Webmaster Tools y otros servicios sin modificar plantillas del tema.
Páginas de destino personalizadas
Usa el submódulo metatag_routes para configurar meta tags para rutas personalizadas que no son páginas de entidad, como páginas de Views o controladores personalizados.
Control de permisos empresarial
Instala metatag_extended_perms para dar a diferentes roles de usuario acceso a diferentes meta tags. Permite a los editores de contenido establecer descripciones mientras se restringe el acceso a la etiqueta robots a los administradores.
Tips
- Usa tokens como [node:title] | [site:name] para patrones de meta tags automáticos y consistentes en todo el contenido
- Añade campos separados para título SEO y descripción si quieres una edición de contenido más simple, luego referencia esos campos mediante tokens en los valores predeterminados globales
- Instala solo los submódulos que realmente necesites - menos etiquetas significa formularios más rápidos y menos complejidad
- Usa la función de grupos de meta tags en la configuración para ocultar etiquetas irrelevantes de los editores de contenido
- Configura el recorte para etiquetas de descripción para mantenerte dentro de los límites de caracteres recomendados (155-160 para descripciones, 55-65 para títulos)
- El campo Metatag solo es necesario cuando se requiere personalización por entidad; los valores predeterminados manejan la mayoría de los casos automáticamente
- Usa el informe de plugins en /admin/reports/metatag-plugins para ver todas las etiquetas disponibles y qué módulo las proporciona
Technical Details
Admin Pages 6
/admin/config/search/metatag
Gestiona las configuraciones predeterminadas de meta tags para el sitio. Muestra una lista jerárquica de todas las configuraciones predeterminadas incluyendo Global, Página principal, páginas de error 403/404 y sobrescrituras específicas por tipo de entidad/bundle. Cada configuración muestra los valores de meta tags definidos y permite editar, eliminar o revertir a los valores predeterminados.
/admin/config/search/metatag/add
Crea una nueva configuración predeterminada de meta tags para un tipo de entidad o bundle específico. Selecciona entre los tipos de entidad y bundles disponibles que aún no tienen valores predeterminados personalizados configurados.
/admin/config/search/metatag/{metatag_defaults}
Edita una configuración predeterminada de meta tags existente. Modifica los valores de meta tags usando texto directo o tokens. Navegador de tokens disponible para ver los patrones de reemplazo disponibles.
/admin/config/search/metatag/settings
Configura los ajustes de todo el módulo incluyendo qué grupos de meta tags aparecen en los formularios de entidad, recorte de valores de meta tags y opciones de visualización del widget.
/admin/reports/metatag-plugins
Página de informe que muestra todos los plugins de meta tags disponibles en el sitio. Lista cada etiqueta agrupada por grupo de meta tags con detalles incluyendo ID del plugin, tipo, peso, módulo proveedor y descripción.
/admin/config/search/metatag/custom/create
Crea valores predeterminados de meta tags para rutas/paths personalizados. Proporcionado por el submódulo Metatag Custom Routes.
Permissions 1
Hooks 5
hook_metatag_route_entity
Permite a los módulos proporcionar una entidad para la generación de meta tags en rutas personalizadas que no se detectan automáticamente.
hook_metatags_alter
Altera los valores de meta tags antes del reemplazo de tokens y el renderizado. Permite modificar o eliminar meta tags según el contexto.
hook_metatags_attachments_alter
Altera los adjuntos de meta tags renderizados antes de que se añadan a la página. Se llama después del reemplazo de tokens.
hook_metatag_migrate_metatagd7_tags_map_alter
Altera el mapeo de nombres de etiquetas de Drupal 7 Metatag a IDs de etiquetas de Drupal 8/9/10 durante la migración.
hook_metatag_migrate_nodewordsd6_tags_map_alter
Altera el mapeo de nombres de etiquetas de Drupal 6 Nodewords a IDs de etiquetas de Drupal 8/9/10 durante la migración.
Troubleshooting 5
Asegúrate de que el html.html.twig del tema muestre {{ page }} no {{ page.content }}. Verifica que el sitio no esté en modo mantenimiento. Verifica que los valores predeterminados globales estén habilitados en /admin/config/search/metatag.
Elimina todos los campos Metatag de los bundles de entidad antes de desinstalar. Verifica /admin/modules/uninstall para el campo específico que bloquea la eliminación.
Asegúrate de que el módulo Token esté instalado. Verifica que el tipo de token correcto esté disponible para el contexto (ej., [node:*] solo funciona en páginas de node).
Usa /admin/config/search/metatag/settings para limitar qué grupos de meta tags aparecen en cada bundle de entidad. Solo muestra los grupos realmente necesarios para ese tipo de contenido.
Metatag elimina automáticamente las etiquetas duplicadas añadidas por core. Si persisten los duplicados, verifica código personalizado u otros módulos que añadan las mismas etiquetas.
Security Notes 4
- El permiso 'administer meta tags' está marcado como acceso restringido y solo debe otorgarse a roles de confianza
- Los valores de meta tags se sanitizan antes de la salida para prevenir ataques XSS
- Algunos meta tags marcados como 'secure' solo se mostrarán en conexiones HTTPS
- El submódulo de permisos extendidos permite control granular sobre qué usuarios pueden editar qué meta tags