El motivo por el que tu código falló es un conflicto tipográfico básico. Las herramientas de IA y los procesadores de texto generan frecuentemente "comillas inteligentes" (comillas curvas como “ y ”). Los shortcodes de WordPress y los lenguajes de programación principales requieren estrictamente "comillas rectas" (como " y '). Cuando Gutenberg encuentra comillas curvas dentro de un shortcode, no puede interpretarlo como código y falla al renderizarlo.

Además, al copiar y pegar completamente destruiste las tablas en la documentación, convirtiéndolas en bloques de texto ilegibles. Copiar y pegar texto sin cuidado degrada los datos estructurales.

He limpiado tu texto. Convertí toda la tipografía a comillas rectas, envolví tus shortcodes en formato de código para que Gutenberg no intente ejecutarlos y reconstruí tus tablas destruidas en un Markdown adecuado. Si pegas esto directamente en Gutenberg, debería generar automáticamente los encabezados, tablas y bloques de código correctos.

Aquí está la versión estructuralmente correcta:

---

TruePaws — Guía Completa del Usuario

¿Qué es TruePaws?

TruePaws es un sistema de gestión de criaderos que funciona dentro de tu sitio web WordPress. Ayuda a los criadores profesionales a gestionar sus animales, rastrear la crianza y los embarazos, manejar contactos de compradores, generar documentos oficiales (como certificados de pedigrí y paquetes de entrega) e incluso mostrar cachorros/gatitos disponibles en tu sitio web público.

Parte 1: Requisitos Previos (Lo que Necesitas Antes de Instalar)

1. Un Sitio Web WordPress

• Necesitas un sitio WordPress autohospedado (el tipo que instalas en tu propio hosting, no un blog gratuito de WordPress.com).
• Se requiere WordPress versión 5.0 o más reciente.

2. Requisitos de Alojamiento

• PHP 7.4 o más reciente (la mayoría de los hosts modernos ofrecen PHP 8.0+).
• Base de datos MySQL (estándar en todos los hosts de WordPress).
• La API REST de WordPress debe estar habilitada (lo está por defecto, solo se desactiva si alguien la desactiva deliberadamente).

3. Opcional (pero Recomendado)

• Una clave API de Google Gemini si deseas usar las funciones impulsadas por IA (consejos de cuidado, alertas de salud, generación de biografías de marketing). Puedes obtener una gratis en Google AI Studio.
• Una cuenta de Zapier o Make si deseas enviar notificaciones automatizadas a servicios externos.

Parte 2: Instalación del Plugin

Paso 1 — Subir el Plugin

1. Inicia sesión en el panel de administración de WordPress (generalmente yourwebsite.com/wp-admin).
2. En la barra lateral izquierda, ve a Plugins → Añadir nuevo.
3. Haz clic en el Subir plugin botón en la parte superior.
4. Haz clic Seleccionar Archivo y selecciona el truepaws.zip archivo que recibiste.
5. Haz clic Instalar Ahora y espera a que termine.

Paso 2 — Activar el Plugin

1. Después de que se complete la instalación, haz clic en el Activar Plugin botón.
2. El plugin creará automáticamente todas las tablas de la base de datos que necesita.
3. Verás un nuevo TruePaws elemento del menú aparecer en la barra lateral de WordPress.

Parte 3: Configuración Inicial (¡Haz Esto Primero!)

Después de activarlo, ve a TruePaws → Configuración en la barra lateral de WordPress. Verás varias pestañas en la parte superior. Trabaja en cada una.

Pestaña 1: Configuración General

Configuración	Qué hace	Ejemplo
Especie Predeterminada	El tipo de animal que crías principalmente. Opciones: Perro, Gato, Caballo, Conejo, Cobaya, Hurón, Pájaro.	Perro
Prefijo del Criador	Un código corto (máx. 5 caracteres) utilizado al nombrar automáticamente cachorros/gatitos de las camadas.	TP
Duración del Embarazo — Perros	Cuántos días dura el embarazo de un perro. El valor predeterminado es 63. Solo cambia si sabes lo contrario.	63
Duración del Embarazo — Gatos	Cuántos días dura el embarazo de un gato. El valor predeterminado es 65.	65
Instrucciones de Alimentación	Texto que aparecerá en los documentos de entrega que das a los nuevos compradores. Escribe qué come el animal, con qué frecuencia y cualquier instrucción especial.	"Alimentar 3 veces al día con comida para cachorros Royal Canin…"
Clave API de Gemini	Pega aquí tu clave API de Google Gemini para habilitar las funciones de IA. Déjalo en blanco si no deseas funciones de IA.	(tu clave)
URL del Webhook	Si usas Zapier o Make para automatización, pega aquí la URL del webhook. Déjalo en blanco en caso contrario.	(tu URL de webhook)

Haz clic Guardar Configuración cuando termines.

Pestaña 2: Información del Criador

Completa tus detalles profesionales. Esta información aparece en los PDF generados (certificados de pedigrí, paquetes de entrega).

Campo	Qué Ingresar
Nombre del Criador	Tu nombre completo como criador
Nombre del Negocio	Nombre de su criadero o gatil
Número de licencia	Su número de licencia de cría (si aplica)
Teléfono	Número de teléfono de su negocio
Correo Electrónico	Dirección de correo electrónico de su negocio

Haz clic Guardar Configuración cuando termines.

Pestaña 3: Razas

Aquí es donde gestionas la lista de razas disponibles en los menús desplegables del plugin. TruePaws viene precargado con 20 razas comunes de perros y 20 razas comunes de gatos.

• Para agregar una raza: Escribe el nombre de la raza en el cuadro de texto y haz clic en Agregar Raza.
• Para eliminar una raza: Haz clic en el botón de eliminar junto a cualquier raza en la lista.

Consejo: Añade todas las razas con las que trabajas ahora. Siempre puedes añadir más más tarde.

Pestaña 4: Comunicación

Completa tu dirección postal y la URL de tu página de contacto. Esto se utiliza para funciones públicas y shortcodes.

Campo	Qué Ingresar
Dirección	Dirección de su criadero
Ciudad	Ciudad
Estado/Provincia	Estado o provincia
Código postal	Código postal
País	País
URL de contacto/consulta	La URL de la página de contacto de tu sitio web (utilizada como enlace predeterminado en los botones "Contactar al Criador")

Haz clic Guardar Configuración cuando termines.

Pestaña 5: Informes de Ventas

Esta pestaña es de solo lectura: muestra tus estadísticas de ventas una vez que comiences a registrarlas. Verás:

• Ingresos totales generados
• Número total de ventas
• Precio promedio de venta
• Una tabla desglosada mensual
• Una tabla de principales compradores

Parte 4: El Panel de Control

Cuando haces clic en TruePaws en la barra lateral, llegas al Panel de Control. Esta es tu base de operaciones. Aquí es lo que verás:

Tarjetas de Estadísticas

• Total de animales: cuántos animales hay en su sistema
• Camadas activas: gestaciones en seguimiento actualmente
• Contactos: total de compradores y entradas en lista de espera
• Próximos eventos: eventos que ocurrirán pronto (vacunas, fechas de parto, etc.)

Acciones Rápidas

• Añadir animal: ir directamente al formulario de nuevo animal
• Registrar apareamiento: registrar un nuevo cruce
• Añadir contacto: añadir un nuevo comprador o entrada en lista de espera

Lista de Inicio

• Una lista de verificación útil que lo guía a través de la configuración inicial.

Últimos Eventos

• Una línea de tiempo de los eventos más recientes en todos sus animales (vacunas, visitas al veterinario, controles de peso, etc.).

Gráficos

• Distribución de razas — un gráfico de dona que muestra cuántos animales tienes de cada raza.
• Resumen de ventas — un gráfico de barras que muestra los ingresos mensuales.

Mapa de Calor de Actividad

• Un mapa de calor estilo GitHub que muestra qué tan activo ha estado tu criadero cada día durante el último año. Los cuadrados más oscuros = más eventos registrados ese día.

Parte 5: Agregar y Gestionar Animales

Cómo Añadir un Nuevo Animal

1. Ir a TruePaws → Animales (o haz clic en 'Añadir Animal' en el Panel de Control).
2. Haz clic en el Añadir Nuevo Animal botón.
3. Completa el formulario:

Campo	¿Obligatorio?	Descripción
Nombre	Sí	El nombre registrado/oficial del animal
Nombre de Llamada	No	El nombre con el que realmente lo llamas en casa
Número de Registro	No	Número de registro oficial de tu registro de raza
ID del Microchip	No	El número del microchip (debe ser único)
Raza	No	Selecciona de tu lista de razas
Sexo	Sí	Macho o Hembra
Padre (Sire)	No	Selecciona entre los animales machos existentes en tu sistema
Madre (Dam)	No	Selecciona entre los animales hembras existentes en tu sistema
Fecha de Nacimiento	No	Fecha en que nació el animal
Estado	No	Activo, Retirado, Vendido, Fallecido o Co-propiedad (por defecto Activo)
Color/Marcas	No	Describe la apariencia del animal
Descripción	No	Cualquier nota adicional sobre el animal
Imagen Destacada	No	Haz clic para abrir la Biblioteca de Medios de WordPress y seleccionar una foto

4. Haz clic Guardar Animal.

Consejo para la configuración inicial: Comienza añadiendo primero tus animales reproductores adultos (sementales y hembras). De esta manera, cuando añadas animales más jóvenes o cachorros, podrás seleccionar a sus padres desde los menús desplegables.

La Página de Perfil del Animal

Después de guardar, haz clic en el nombre de cualquier animal para ver su página de perfil. Esta es la página con más funciones del plugin. Aquí está todo lo que puedes hacer:

Ver Información

• Ver todos los detalles que ingresaste, más una insignia de estado (por ejemplo, 'Activo' en verde, 'Vendido' en azul).
• La imagen destacada se muestra de manera prominente, con una silueta de respaldo si no se cargó ninguna foto.

Galería de Fotos

• Sube múltiples fotos haciendo clic en 'Añadir Fotos'.
• Arrastra y suelta fotos para reordenarlas.
• Haz clic en una foto para establecerla como imagen destacada.
• Elimina las fotos que ya no necesites.

Línea de Tiempo y Eventos

La línea de tiempo muestra una historia cronológica de todo lo que le ha sucedido a este animal. Para añadir un nuevo evento:

1. Haz clic en el Agregar Evento botón.
2. Elige el tipo de evento: Nacimiento, Vacuna, Celo, Emparejamiento, Parto, Peso, Visita al Veterinario o Nota.
3. Ingresa la fecha y un título/descripción.
4. Para eventos de peso, ingresa el valor del peso.
5. Haz clic Guardar.

Árbol Genealógico

• Muestra un árbol genealógico de 3 generaciones mostrando padres, abuelos y bisabuelos. (Solo funciona si has ingresado las relaciones parentales).
• Haz clic Descargar PDF de Pedigrí para generar un certificado imprimible.

Gráfico de Crecimiento de Peso

• Si has registrado eventos de peso, aparece un gráfico de línea mostrando el peso del animal a lo largo del tiempo.

Funciones de IA (requiere clave API de Gemini)

• Consejos de Cuidado con IA — genera recomendaciones de cuidado personalizadas basadas en la raza, edad e historial del animal.
• Biografía de Marketing con IA — escribe una descripción atractiva para tu sitio web o publicaciones en redes sociales.
• Alertas de Salud con IA — analiza el historial de eventos y señala posibles problemas de salud.

Vender un Animal

1. En el perfil del animal, haz clic Vender / Reservar.
2. Selecciona al comprador de tu lista de contactos.
3. Ingresa la fecha de venta y el precio.
4. Añade cualquier nota (opcional).
5. Haz clic Confirmar Venta.
6. El estado del animal cambia a "Vendido".
7. Haz clic Generar PDF de Entrega para crear un documento profesional de entrega.

Copiar Código Corto

En la parte inferior del perfil, verás un shortcode como

. Haz clic para copiarlo. Puedes pegarlo en cualquier página o entrada de WordPress para mostrar el perfil de este animal en tu sitio web público.

Parte 6: Gestión de Cría y Camadas

Registrar un Nuevo Apareamiento

1. Ir a TruePaws → Camadas.
2. Haz clic Registrar Nuevo Apareamiento.
3. Completa el formulario:

Campo	¿Obligatorio?	Descripción
Padre (Sire)	Sí	Selecciona el macho entre tus animales
Madre (Dam)	Sí	Selecciona la hembra de tus animales
Fecha de apareamiento	Sí	La fecha en que ocurrió la cría
Método	No	Inseminación Natural o Artificial (IA)
Notas	No	Cualquier nota sobre el apareamiento

4. Haz clic GuardarEl sistema calcula automáticamente la fecha esperada de parto según tus configuraciones de duración del embarazo.

Seguimiento del Embarazo

Cada camada activa muestra una Seguimiento de Embarazo tarjeta con:

• Una barra de progreso que muestra cuánto ha avanzado el embarazo.
• Indicador de trimestre (Temprano / Medio / Tardío).
• Días restantes hasta el parto esperado.
• Próximos hitos (Implantación, Latido, Ultrasonido, etc.)

Registrar el Nacimiento (Parto)

1. Ir a TruePaws → Camadas.
2. Encuentra la camada y haz clic Parto de la camada.
3. Paso 1 — Registrar el Nacimiento: Ingresa la fecha real del parto, número de crías macho/hembra y vista previa de nombres generados automáticamente.
4. Paso 2 — Confirmación: Revisa el resumen y haz clic en Enviar. El sistema crea automáticamente registros individuales para cada cría, asigna padres, registra el evento de nacimiento y establece su estado como Activo.

Parte 7: Gestión de Contactos (Compradores y Lista de Espera)

Añadir un Contacto

1. Ir a TruePaws → Contactos.
2. Haz clic Agregar Nuevo Contacto.
3. Completa el formulario:

Campo	¿Obligatorio?	Descripción
Nombre	Sí	Nombre del comprador
Apellido	No	Apellido del comprador
Correo Electrónico	Sí	Dirección de correo electrónico del comprador
Teléfono	No	Número de teléfono
Dirección	No	Dirección postal
Estado	No	Lista de espera, Reservado, Comprador o Inactivo
Notas	No	Cualquier nota privada sobre este contacto

4. Haz clic Guardar Contacto.

Funciones de la Lista de Contactos

• Filtrar por estado — mostrar solo contactos en Lista de Espera, Reservados, Compradores o Inactivos.
• Exportar a CSV — descargar todos los contactos como un archivo de hoja de cálculo para herramientas de marketing por correo electrónico.

Parte 8: Mostrar Animales en tu Sitio Web (Shortcodes)

Los shortcodes son códigos especiales que pegas en páginas o entradas de WordPress para mostrar contenido de TruePaws en tu sitio web público.

1. Mostrar un Solo Animal

[truepaws_animal id="7"]

(Reemplaza 123 con el número de ID real del animal)

Configuraciones opcionales que puedes añadir:

Parámetro	Qué hace	Predeterminado
contact_url="https://..."	Enlace personalizado para el botón "Contactar al Criador"	URL de tus configuraciones
show_ai="true" o "false"	Mostrar u ocultar información sobre el cuidado de IA	verdadero
show_pedigree="true" o "false"	Mostrar u ocultar el árbol genealógico	verdadero
show_inquiry_form="true" o "false"	Incrustar un formulario de consulta debajo del animal	falso
show_gallery="true" o "false"	Mostrar u ocultar la galería de fotos	verdadero
gallery_columns="3"	Número de columnas para la galería (2 a 6)	4

Ejemplo con opciones:

[truepaws_animal id="45" show_inquiry_form="true" gallery_columns="3" show_ai="false"]

2. Mostrar una Camada

[truepaws_litter id="1"]

Esto muestra la información de la camada, incluyendo los padres, la fecha de nacimiento y una cuadrícula de cachorros/gatitos disponibles con sus fotos y etiquetas de estado.

3. Mostrar Todos los Cachorros/Gatitos Disponibles

[truepaws_available_puppies]

Esto muestra una cuadrícula de todos los animales con estado 'Activo'.

Configuraciones opcionales:

Parámetro	Qué hace	Predeterminado
limit="6"	Número máximo de animales a mostrar	12
breed="Golden Retriever"	Mostrar solo animales de esta raza	(todas las razas)
show_images="true" o "false"	Mostrar u ocultar fotos	verdadero

Ejemplo:

[truepaws_available_puppies breed="Labrador Retriever" limit="8"]

4. Mostrar un Formulario de Consulta

[truepaws_inquiry_form]

Esto muestra un formulario de contacto que los visitantes pueden llenar para preguntar sobre tus animales.

Configuraciones opcionales:

Parámetro	Qué hace	Predeterminado
animal_id="123"	Vincular la consulta a un animal específico	(ninguno)
title="Interested? Get in Touch!"	Título personalizado del formulario	"Enviar una consulta"

Parte 9: Documentos PDF

TruePaws puede generar dos tipos de documentos profesionales en PDF:

1. Certificado de Pedigrí

Generado desde la página de perfil de cualquier animal. Contiene el nombre del animal, detalles de registro, un árbol genealógico de 3 generaciones y el nombre del criador.

2. Paquete de Entrega

Generado desde el perfil de un animal vendido. Contiene detalles del animal, vista previa del pedigrí, historial de salud completo, instrucciones de alimentación, recomendaciones de cuidado, contrato/términos e información del criador.

Nota: Para obtener la mejor calidad en PDF, solicite a su proveedor de hosting que asegure que la biblioteca PHP TCPDF o Dompdf esté instalada.

Parte 10: Notificaciones Automatizadas por Correo Electrónico

TruePaws realiza una verificación diaria y envía recordatorios por correo electrónico para:

• Recordatorios de Parto: Enviado 7 días antes de la fecha esperada de parto.
• Recordatorios de Vacunación: Te recuerda en hitos clave (6 semanas, 9 semanas, 12 semanas, 16 semanas, 1 año, 2 años, 3 años).

Importante: Estos correos electrónicos se envían a la dirección que ingresó en Configuración → Información del Criador → Correo Electrónico.

Parte 11: Flujo de Trabajo Recomendado (Paso a Paso)

Configuración Inicial

1. Instala y activa el plugin.
2. Ve a Configuración y completa todas las pestañas.
3. Añade tus razas personalizadas.

Construyendo Tu Base de Datos

1. Primero añade todos tus animales adultos de cría (machos y hembras).
2. Sube fotos y completa los datos de registro.
3. Establece relaciones parentales para construir árboles genealógicos.
4. Añade eventos históricos para construir la línea de tiempo de cada animal.

Uso Diario

1. Cuando ocurra un apareamiento, regístralo en Camadas.
2. Haz seguimiento de los embarazos y usa el Asistente de Parto cuando ocurran los nacimientos.
3. Actualiza los perfiles de las crías a medida que crecen.
4. Añade compradores a la lista de Contactos.

Ventas

1. Cuando un animal sea vendido, usa la función Vender/Reservar en su perfil.
2. Generar el PDF de entrega.
3. Monitorear informes de ventas.

Sitio Web Público

1. Crear una página de "Cachorros Disponibles" usando: truepaws_available_puppies shortcode
2. Crear páginas individuales usando truepaws_animal id="..." shortcode
3. Agregar truepaws_inquiry_form shortcode a tu página de contacto.

Parte 12: Consejos y Trucos

• Usa el Mapa de Calor de Actividad en el Panel de Control para detectar lagunas en tu registro.
• Exporta contactos a CSV regularmente para mantener tu lista de correo actualizada.
• La Biografía de Marketing con IA puede ahorrarte tiempo al escribir anuncios.
• Registra pesos semanalmente para los cachorros y usa la tabla de crecimiento para detectar problemas temprano.
• Usa el animal_id parámetro en los formularios de consulta para rastrear solicitudes específicas de animales.
• Usa el estado "Co-Propiedad" para animales compartidos entre criadores.