Verificación de Sitio
Verifica la propiedad de un sitio para su uso con motores de búsqueda añadiendo meta tags o sirviendo archivos de verificación.
site_verify
Instalar
composer require 'drupal/site_verify:^3.0'
Overview
El módulo Site Verification simplifica el proceso de autenticación de propiedad del sitio/dominio para motores de búsqueda y otros servicios externos. Proporciona una interfaz administrativa limpia para gestionar los métodos de verificación requeridos por servicios como Google Search Console, Bing Webmaster Tools y Yandex Webmaster.
El módulo soporta dos métodos de verificación: meta tags que se incluyen automáticamente en la página principal del sitio, y archivos de texto/HTML servidos directamente desde la raíz del sitio. Esto elimina la necesidad de subir archivos manualmente vía FTP o acceso al servidor, así como modificaciones en las plantillas del tema para los meta tags.
Cada verificación se almacena como una entidad de configuración, haciéndola exportable y desplegable entre entornos usando el sistema de gestión de configuración de Drupal. El módulo incluye validación robusta para prevenir nombres de archivo duplicados y proporciona funcionalidad de activar/desactivar para desactivación temporal sin eliminación.
Features
- Verificación por meta tag: Añade automáticamente meta tags de verificación solo en la página principal del sitio, soportando servicios como Google, Bing y Yandex
- Verificación basada en archivos: Sirve archivos de verificación de texto o HTML directamente desde la raíz del sitio mediante rutas generadas dinámicamente
- Tres modos de entrada: Entrada manual de detalles de verificación, pegar un meta tag completo para análisis automático, o subir un archivo de verificación
- Almacenamiento en entidad de configuración: Todas las verificaciones se almacenan como entidades de configuración, permitiendo exportar/importar mediante la gestión de configuración de Drupal
- Funcionalidad activar/desactivar: Desactiva temporalmente verificaciones sin eliminarlas, útil para pruebas o mantenimiento
- Reconstrucción automática de rutas: Las rutas se reconstruyen automáticamente cuando se añaden, modifican o eliminan verificaciones basadas en archivos
- Control de acceso basado en permisos: Permisos separados para gestión de meta tags y gestión de verificaciones basadas en archivos
- Restricciones de validación: Aplicación de nombres de archivo únicos para verificaciones basadas en archivos y sanitización de entrada
- Ruta de actualización: Migración automática desde almacenamiento en base de datos heredado (rama 2.x) a almacenamiento en entidad de configuración (rama 3.x)
Use Cases
Verificación de Google Search Console
Para verificar tu sitio con Google Search Console: 1) Inicia sesión en Google Search Console y añade tu propiedad. 2) Selecciona el método de verificación 'Etiqueta HTML' o 'Archivo HTML'. 3) Copia el código de verificación proporcionado. 4) En Drupal, ve a Admin > Configuración > Búsqueda y metadatos > Verificaciones > Añadir. 5) Para meta tags, elige 'Pegar un meta tag' y pega el meta tag completo. Para archivos, elige 'Subir un archivo' y sube el archivo de verificación descargado. 6) Guarda y verifica en Google Search Console.
Despliegue Multi-entorno
Dado que las verificaciones se almacenan como entidades de configuración, pueden exportarse usando drush config:export y desplegarse entre entornos. Crea verificaciones en desarrollo, exporta la configuración e importa en staging/producción. Las verificaciones de archivo funcionan inmediatamente después del despliegue ya que las rutas se reconstruyen automáticamente.
Desactivación Temporal de Verificación
Durante migraciones de sitio o pruebas, puede que necesites desactivar temporalmente verificaciones sin perder la configuración. Usa la operación Desactivar desde la lista de verificaciones para desactivar una verificación. La configuración se preserva y puede reactivarse después con un solo clic.
Gestión de Múltiples Motores de Búsqueda
Crea verificaciones separadas para cada motor de búsqueda (Google, Bing, Yandex, etc.). Usa etiquetas descriptivas como 'Google Search Console Producción' y descripciones indicando la cuenta o propósito. Todas las verificaciones meta se muestran juntas en la página principal.
Verificación de Servicios de Terceros
Muchos servicios más allá de los motores de búsqueda usan métodos de verificación similares, incluyendo Pinterest, verificación de dominio de Facebook, y varias herramientas SEO. Cualquier servicio que verifique mediante meta tags o archivos servidos puede usar este módulo.
Tips
- Usa etiquetas y descripciones descriptivas para identificar fácilmente para qué servicio es cada verificación, especialmente cuando gestionas múltiples motores de búsqueda
- El modo de entrada 'Pegar un meta tag' es la forma más rápida de añadir verificaciones - simplemente copia el meta tag completo desde la interfaz del motor de búsqueda
- Las verificaciones de archivo pueden servir cualquier contenido como texto plano, haciéndolas útiles para varios servicios de verificación más allá de motores de búsqueda
- Exporta verificaciones usando gestión de configuración para desplegarlas fácilmente entre entornos de desarrollo, staging y producción
- Usa la función desactivar en lugar de eliminar cuando necesites remover temporalmente una verificación, como durante migraciones de sitio
- El tipo de verificación por defecto puede preestablecerse via parámetro URL: /admin/config/search/verifications/add?type=file o ?type=meta
Technical Details
Admin Pages 6
/admin/config/search/verifications
Lista todas las entidades de verificación del sitio con su estado, tipo y nombre. Proporciona operaciones para editar, activar/desactivar o eliminar cada verificación. Las verificaciones basadas en archivos muestran enlaces clicables a sus URLs servidas.
/admin/config/search/verifications/add
Crea una nueva verificación de sitio usando uno de tres métodos de entrada: entrada manual de tipo/nombre/contenido, análisis de un meta tag pegado, o subida de un archivo de verificación.
/admin/config/search/verifications/{site_verification}/edit
Modifica una verificación de sitio existente. El formulario es idéntico al formulario de añadir pero pre-rellenado con los valores existentes.
/admin/config/search/verifications/{site_verification}/delete
Página de confirmación para eliminar permanentemente una verificación de sitio.
/admin/config/search/verifications/{site_verification}/enable
Diálogo de confirmación (modal) para activar una verificación de sitio desactivada.
/admin/config/search/verifications/{site_verification}/disable
Diálogo de confirmación (modal) para desactivar una verificación de sitio activa sin eliminarla.
Permisos 2
Hooks 2
hook_page_attachments
Añade verificaciones de meta tag a la página principal. Solo se ejecuta en la ruta de la página principal y adjunta meta tags para todas las verificaciones de tipo Meta habilitadas.
hook_help
Proporciona texto de ayuda en la página de colección de verificaciones y formulario de añadir, explicando los dos métodos de verificación y cómo usarlos.
Troubleshooting 6
Las verificaciones basadas en archivos requieren reconstrucción de rutas. Limpia caches usando drush cr o la página de administración de Rendimiento. Si el problema persiste, verifica que la verificación está habilitada (Status = Sí) y que el nombre de archivo no conflictúa con rutas existentes.
Los meta tags solo aparecen en la página principal configurada del sitio, no en /node u otras rutas. Verifica que: 1) La verificación está habilitada, 2) El tipo está configurado como 'Meta', 3) Estás viendo la URL real de la página principal. Limpia caches después de hacer cambios.
La opción de tipo File solo está disponible para usuarios con el permiso 'Gestionar verificaciones de sitio de tipo archivo'. Verifica que tu rol tiene este permiso en la página de administración de Permisos.
La funcionalidad de subida de archivos requiere que el módulo File del core esté instalado. Habilita el módulo File, luego regresa al formulario de verificación.
Cada verificación basada en archivo debe tener un nombre de archivo único. Verifica las verificaciones existentes buscando una que use el mismo nombre de archivo. Si es necesario, elimina o modifica la verificación existente primero.
Ejecuta las actualizaciones de base de datos usando drush updb o el script update.php. El hook post-update migrará automáticamente las verificaciones de la tabla de base de datos a entidades de configuración. Revisa el registro por cualquier error de migración.
Security Notes 4
- El permiso 'Gestionar verificaciones de sitio de tipo archivo' está restringido porque las verificaciones de archivo pueden servir contenido arbitrario desde la raíz del sitio, lo cual podría potencialmente ser explotado
- Las verificaciones de archivo se sirven con Content-Type: text/plain para prevenir potenciales ataques XSS
- Ambos permisos tienen 'restrict access: TRUE' lo que significa que solo deberían otorgarse a roles de administrador de confianza
- El contenido de verificación se valida para prevenir caracteres de control y contenido multilínea en descripciones y nombres de archivo