// Mapeo de campos:
Tokko Field → WordPress Agent Field
producer_id → fave_agent_id
producer_name → post_title
producer_email → fave_agent_email
producer_phone → fave_agent_phone
producer_cell → fave_agent_mobile
producer_photo → fave_agent_image
producer_description → post_content
producer_role → fave_agent_role

// Habilitada:
// - Descarga foto del agente desde Tokko
// - La guarda en WordPress media library
// - La asigna como featured image

// Deshabilitada:
// - Solo guarda la URL de la foto
// - No ocupa espacio en tu servidor

Tamaño máximo: 500x500px
Calidad: 90%
Formato: JPEG o PNG según original

// Habilitada:
// Número móvil se trata como WhatsApp
// Frontend muestra botón de WhatsApp
// URL: https://wa.me/{numero}?text=Consulta

// Deshabilitada:
// Móvil es solo número telefónico
// Se muestra como enlace tel:

// En tu plantilla
if ( function_exists('get_agent_whatsapp_link') ) {
  $whatsapp_link = get_agent_whatsapp_link($agent_id);
  echo '<a href="' . $whatsapp_link . '">
    <i class="fab fa-whatsapp"></i> WhatsApp
  </a>';
}

// Configura el ID de agente por defecto
thi_auto_assign_agent_id = 'producer_id_123'

// Cada propiedad nueva se asigna a este agente
// Si la propiedad viene con agente en Tokko,
// ese agente tiene prioridad

// Campo meta usado:
fave_property_agent_id = 'producer_id_123'

// Durante sincronización:
1. Lee agente asignado de la propiedad en Tokko
2. Busca el agente correspondiente en WordPress
3. Actualiza meta fave_property_agent_id
4. Actualiza contador de propiedades del agente

// Meta field:
fave_agent_property_count = 15

// Se actualiza automáticamente cada sincronización
// Útil para mostrar "Agente con 15 propiedades"

/agente/{nombre-agente}/
// Ejemplo:
/agente/juan-martinez/
/agente/maria-garcia/

Perfil del Agente
├── Foto de perfil
├── Nombre y rol
├── Descripción/biografía
├── Información de contacto
│   ├── Email
│   ├── Teléfono
│   ├── WhatsApp (si está habilitado)
│   └── Redes sociales
├── Propiedades activas
└── Formulario de contacto

// archivo: single-agent.php
<?php
get_header();

while ( have_posts() ) {
  the_post();

  // Mostrar información del agente
  $agent_id = get_the_ID();
  $agent_email = get_post_meta($agent_id, 'fave_agent_email', true);
  $agent_image = get_the_post_thumbnail($agent_id);

  echo $agent_image;
  echo '<h1>' . get_the_title() . '</h1>';
  the_content();
  echo '<a href="mailto:' . $agent_email . '">Contactar</a>';

  // Mostrar sus propiedades
  get_template_part('template-parts/agent-properties');
}

get_footer();
?>

// Agentes sin propiedades después de N sincronizaciones
// (configurable en thi_orphaned_agent_threshold)

// Habilitada:
// - Agentes sin propiedades se marcan como borrador
// - No se eliminan, solo se ocultan

// Deshabilitada:
// - Agentes permanecen visibles
// - Útil para mantener historial de agentes pasados

/agentes/
├── Listado de todos los agentes
├── Foto y nombre
├── Número de propiedades
├── Botón de contacto
└── Búsqueda por nombre

// Shortcode:
[tokko_agents_directory]

// Parámetros:
[tokko_agents_directory columns="3" per_page="12"]

// En template:
<div class="agents-grid" data-columns="3">
  <?php
  $agents = get_posts([
    'post_type' => 'agent',
    'posts_per_page' => 12,
    'orderby' => 'meta_value',
    'meta_key' => 'fave_agent_property_count'
  ]);

  foreach ( $agents as $agent ) {
    echo '<div class="agent-card">';
    echo get_the_post_thumbnail($agent->ID);
    echo '<h3>' . $agent->post_title . '</h3>';
    echo '</div>';
  }
  ?>
</div>

fave_agent_email      // Email profesional
fave_agent_phone      // Teléfono fijo
fave_agent_mobile     // Celular/WhatsApp
fave_agent_website    // Sitio web personal
fave_agent_facebook   // URL Facebook
fave_agent_instagram  // URL Instagram
fave_agent_linkedin   // URL LinkedIn

// Verifica:
1. thi_download_agent_images esté habilitada
2. El servidor tenga permisos en /wp-content/uploads/
3. Espacio disponible en servidor
4. URLs de imágenes en Tokko sean válidas