El motivo por el que tu código falló es un conflicto tipográfico fundamental. Las herramientas de IA y los procesadores de texto a menudo generan "comillas inteligentes" (comillas curvas como “ y ”). Los shortcodes de WordPress y los lenguajes de programación básicos requieren estrictamente "comillas rectas" (como " y '). Cuando Gutenberg detecta comillas curvas dentro de un bracket de shortcode, no lo reconoce como código y rompe la renderización.

Además, al copiar y pegar, destruiste completamente las tablas en la documentación, convirtiéndolas en bloques de texto ilegibles. Copiar y pegar texto crudo sin revisar 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í tienes 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 criadores profesionales a manejar sus animales, rastrear crías y embarazos, gestionar contactos con 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 que instalas en tu propio hosting, no un blog gratuito de WordPress.com).
• Se requiere la versión 5.0 o más reciente de WordPress.

2. Requisitos de alojamiento

• PHP 7.4 o superior (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 lo hizo deliberadamente).

3. Opcional (pero Recomendado)

• Una clave de API de Google Gemini si deseas usar las funciones con IA (consejos de cuidado, alertas de salud, generación de biografías para 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. Una vez completada 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 activar, 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, Ave.	Perro
Prefijo del criador	Un código corto (máx. 5 caracteres) usado para nombrar automáticamente cachorros/gatitos de las camadas.	TP
Duración de la gestación — Perros	Cuántos días dura el embarazo de una perra. 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 una gata. 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.	"Alimenta 3 veces al día con comida para cachorros Royal Canin…"
Clave de API de Gemini	Pega aquí tu clave de 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 datos profesionales. Esta información aparece en los PDF generados (certificados de pedigrí, paquetes de entrega).

Campo	Qué ingresar
Nombre del criador	Su 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	Su número de teléfono comercial
Correo electrónico	Su dirección de correo electrónico comercial

Haz clic Guardar Configuración cuando termines.

Pestaña 3: Razas

Aquí 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 añadir una raza: Escribe el nombre de la raza en el cuadro de texto y haz clic en Añadir Raza.
• Para eliminar una raza: Haz clic en el botón de eliminar junto a cualquier raza de la lista.

Consejo: Agrega todas las razas con las que trabajas ahora. Siempre puedes añadir más después.

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 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 los mejores compradores

Parte 4: El Panel de Control

Cuando hagas clic en TruePaws en la barra lateral, llegarás al Panel de Control. Esta es tu base operativa. Aquí verás:

Tarjetas de Estadísticas

• Animales totales — cuántos animales hay en tu sistema
• Camadas activas — embarazos que se están monitoreando actualmente
• Contactos — compradores totales y entradas en lista de espera
• Eventos próximos — 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 te guía en la configuración inicial.

Eventos Recientes

• Una línea de tiempo de los eventos más recientes entre todos tus 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 la actividad de tu criadero cada día durante el último año. Los cuadrados más oscuros = más eventos registrados ese día.

Parte 5: Añadir y Gestionar Animales

Cómo Agregar un Nuevo Animal

1. Ir a TruePaws → Animales (o haz clic en "Agregar Animal" en el Panel de Control).
2. Haz clic en el Agregar 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 su registro de raza
ID del microchip	No	El número del microchip (debe ser único)
Raza	No	Seleccione de su lista de razas
Sexo	Sí	Macho o Hembra
Padre (Sire)	No	Seleccione de los machos existentes en su sistema
Madre (Dam)	No	Seleccione de las hembras existentes en su sistema
Fecha de Nacimiento	No	Fecha en que nació el animal
Estado	No	Activo, Jubilado, Vendido, Fallecido o en Copropiedad (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 Multimedia 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 (padres y madres). De esta manera, cuando añadas animales más jóvenes o cachorros, podrás seleccionar 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 características del plugin. Aquí está todo lo que puedes hacer:

Ver Información

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

Galería de Fotos

• Sube varias fotos haciendo clic en "Agregar Fotos".
• Arrastra y suelta las 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 un historial cronológico 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, Apareamiento, 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 que incluye padres, abuelos y bisabuelos. (Solo funciona si has ingresado 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, aparecerá un gráfico de líneas que muestra el peso del animal a lo largo del tiempo.

Características 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 listados 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 en 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 Shortcode

Al final 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 Emparejamiento.
3. Completa el formulario:

Campo	¿Obligatorio?	Descripción
Padre (Sire)	Sí	Selecciona el macho de tus animales
Madre (Dam)	Sí	Selecciona la hembra de tus animales
Fecha de Apareamiento	Sí	La fecha en que ocurrió el apareamiento
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 basándose en 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 qué tan avanzado está el embarazo.
• Indicador de trimestre (Temprano / Medio / Tardío).
• Días restantes hasta el parto esperado.
• Próximos hitos (Implantación, Latido del corazón, Ultrasonido, etc.).

Registrar el Nacimiento (Parto)

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

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

Agregar un Contacto

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

Campo	¿Obligatorio?	Descripción
Nombre	Sí	Nombre del comprador
Apellido	No	Apellido del comprador
Correo electrónico	Sí	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	Notas privadas 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 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 las páginas o entradas de WordPress para mostrar contenido de TruePaws en tu sitio web público.

1. Mostrar un Animal Individual

[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 configuración
show_ai="true" o "false"	Mostrar u ocultar información de 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 (de 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 los cachorros/gatitos disponibles con sus fotos y estados.

3. Mostrar Todos los Cachorros/Gatitos Disponibles

[truepaws_available_puppies]

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

Opciones de configuración:

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 completar para preguntar sobre tus animales.

Opciones de configuración:

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 PDF profesionales:

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 tu nombre como 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 y tu información como criador.

Nota: Para la mejor calidad en PDF, asegúrate de que tu proveedor de alojamiento web tenga instalada la biblioteca PHP TCPDF o Dompdf.

Parte 10: Notificaciones Automáticas por Correo Electrónico

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

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

Importante: Estos correos se envían a la dirección que ingresaste 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. Realiza un seguimiento de los embarazos y usa el Asistente de Parto cuando ocurran 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. Genera el PDF de Entrega.
3. Monitorea los Informes de Ventas.

Sitio Web Público

1. Crea una página de "Cachorros Disponibles" usando: truepaws_available_puppies shortcode
2. Crea páginas individuales usando truepaws_animal id="..." shortcode
3. Añadir 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 gráfica 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-Poseído" para animales compartidos entre criadores.