Documentación

Documentación de Alt Audit

Guía completa para integrar Alt Audit en tu flujo de trabajo con configuración del plugin de WordPress, integración de API y mejores prácticas.

Primeros Pasos

Inicio Rápido

Empieza a usar Alt Audit en menos de 5 minutos:

  1. Crea tu cuenta gratuita (25 créditos incluidos)
  2. Instala el plugin de WordPress u obtén tu clave API
  3. Empieza a generar texto alternativo perfecto automáticamente

Configuración de la Cuenta

Tu cuenta de Alt Audit viene con todo lo que necesitas para empezar:

  • 25 créditos gratis - Sin tarjeta de crédito requerida
  • Acceso al plugin de WordPress - Disponible inmediatamente
  • Acceso a la API - Genera tokens desde tu panel
  • Análisis de uso - Sigue tus mejoras de accesibilidad

Cómo Funcionan los Créditos

Entendiendo el sistema de créditos:

  • 1 1 crédito = 1 imagen procesada - Simple y transparente
  • ✓ Los créditos se restablecen mensualmente para los planes de suscripción
  • ∞ Los paquetes de créditos únicos nunca caducan

Configuración del Plugin de WordPress

Descargar Plugin

Descarga la última versión del plugin de WordPress de Alt Audit desde WordPress.org:

Descargar desde WordPress.org

Compatible con WordPress 6.2+ • PHP 7.4+

Pasos de Instalación

Paso 1: Instalar el Plugin

  1. Descarga el archivo alt-audit.zip
  2. Ve a tu panel de administración de WordPress
  3. Navega a Plugins > Añadir Nuevo
  4. Haz clic en "Subir Plugin" y selecciona el archivo zip
  5. Haz clic en "Instalar Ahora" y luego en "Activar"

Paso 2: Conectar Tu Cuenta

  1. Ve a Ajustes > Alt Audit en tu administración de WordPress
  2. Introduce tu dirección de correo electrónico de Alt Audit
  3. Haz clic en "Conectar Cuenta"
  4. Sigue el proceso de verificación (revisa tu correo)
  5. Tu clave API se configurará automáticamente

Paso 3: Configurar Ajustes

Personaliza el comportamiento del plugin:

  • Generar automáticamente al subir - Procesar automáticamente nuevas imágenes
  • Procesar imágenes existentes - Procesar masivamente tu biblioteca de medios
  • Detección inteligente - Solo procesar imágenes públicas

Características del Plugin

Procesamiento Automático

  • • Texto alternativo generado al subir la imagen
  • • Funciona con cargas de la biblioteca de medios
  • • Compatible con constructores de páginas
  • • Soporta cargas de arrastrar y soltar

Procesamiento Masivo

  • • Procesar biblioteca de medios existente
  • • Filtrar por rango de fechas
  • • Omitir imágenes con texto alternativo existente
  • • Seguimiento de progreso e informes

Detección Inteligente

  • • Identifica imágenes públicas vs privadas
  • • Omite imágenes de administración/backend
  • • Optimiza el uso de créditos
  • • Reglas de detección personalizables

Seguimiento de Uso

  • • Panel de uso de créditos
  • • Historial de procesamiento
  • • Estado de procesamiento de imágenes
  • • Informes de uso mensuales

Solución de Problemas

Problemas del Plugin de WordPress

La activación del plugin falla

  • Asegúrate de tener la versión 5.0 o superior de WordPress
  • Verifica la versión de PHP (se requiere 7.4+)
  • Verifica los permisos de escritura en wp-content/plugins/
  • Desactiva plugins conflictivos temporalmente

Las imágenes no se procesan automáticamente

  • Verifica la conexión API en Ajustes > Alt Audit
  • Verifica que tienes créditos restantes
  • Asegúrate de que "Auto-generar" esté habilitado
  • Verifica si las imágenes son accesibles públicamente

El procesamiento masivo se atasca

  • Actualiza la página y verifica el progreso
  • Reduce el tamaño del lote en la configuración
  • Verifica los límites de tiempo de espera del servidor
  • Contacta con soporte si el problema persiste

Problemas de Integración de API

Errores de autenticación

  • Verifica que el token API sea correcto y esté activo
  • Verifica el formato del encabezado de autorización
  • Regenera el token API si es necesario
  • Asegúrate de que el token tenga permisos suficientes

Problemas de URL de imagen

  • Asegúrate de que las URL de las imágenes sean accesibles públicamente
  • Verifica los requisitos de HTTPS
  • Verifica el formato de imagen (JPG, PNG, GIF, WebP)
  • Confirma los límites de tamaño de imagen (máx 10MB)

Límite de velocidad

  • Implementa retroceso exponencial
  • Verifica los encabezados de límite de velocidad en la respuesta
  • Considera mejorar el plan para límites más altos
  • Agrupa las solicitudes cuando sea posible

¿Necesitas Más Ayuda?

¿No encuentras la solución que buscas?

Contactar Soporte

Mejores Prácticas

Calidad del Texto Alt

✅ Buenas Prácticas

  • • Mantén las descripciones concisas pero descriptivas
  • • Céntrate en el propósito y contexto de la imagen
  • • Incluye palabras clave relevantes de forma natural
  • • Revisa el texto generado por IA para mayor precisión
  • • Considera el contenido circundante

❌ Evita Esto

  • • Empezar con "Imagen de..." o "Foto de..."
  • • Descripciones excesivamente largas
  • • Relleno de palabras clave
  • • Describir solo elementos visuales obvios
  • • Usar texto de marcador de posición genérico

Optimización de Créditos

  • 1 Habilita la detección inteligente para evitar procesar imágenes de administración/backend
  • 2 Revisa el texto alt existente antes del procesamiento masivo para evitar duplicados
  • 3 Usa el procesamiento selectivo para imágenes que realmente necesitan texto alt
  • 4 Monitoriza el uso a través del panel para rastrear el consumo de créditos

Optimización SEO

Integración de Palabras Clave

Alt Audit incluye automáticamente palabras clave relevantes, pero puedes mejorar el SEO:

  • Revisando el texto alt generado para palabras clave de marca
  • Añadiendo términos específicos de ubicación cuando sea relevante
  • Incluyendo nombres de productos y números de modelo
  • Asegurando la consistencia con el contenido de la página

Cumplimiento de Accesibilidad

Asegúrate de que tu texto alt cumpla con los estándares de accesibilidad:

  • Mantén las descripciones por debajo de 125 caracteres cuando sea posible
  • Céntrate en el propósito de la imagen, no solo en la apariencia
  • Usa texto alt vacío (alt="") para imágenes decorativas
  • Prueba con lectores de pantalla cuando sea posible

¿Todavía tienes preguntas? ¡Estamos aquí para ayudar!

Contactar Soporte