/*
Theme Name: Tu Tema Child
Template: tu-tema-padre
Version: 1.0
*/

🚨 Backup primero: Antes de activar tema hijo, haz backup completo de tu sitio. Si algo falla, puedes restaurar.

<?php
function aiseo_breadcrumbs() {
    // Configuración
    $home_title = 'Inicio';
    $separator = ' › ';
    $home_url = home_url('/');
    
    // No mostrar en homepage
    if (is_front_page()) return;
    
    // Iniciar breadcrumbs array para schema
    $breadcrumbs_schema = array();
    $position = 1;
    
    // HTML output
    echo '<nav class="breadcrumbs" aria-label="Breadcrumb">';
    echo '<ol class="breadcrumb-list">';
    
    // Inicio siempre primero
    echo '<li><a href="' . $home_url . '">' . $home_title . '</a></li>';
    $breadcrumbs_schema[] = array(
        '@type' => 'ListItem',
        'position' => $position++,
        'name' => $home_title,
        'item' => $home_url
    );
    
    if (is_category() || is_single()) {
        $categories = get_the_category();
        if ($categories) {
            $category = $categories[0];
            
            // Si categoría tiene padre, mostrar jerarquía
            if ($category->parent != 0) {
                $parent_cats = array();
                $parent_id = $category->parent;
                
                while ($parent_id) {
                    $parent_cat = get_category($parent_id);
                    $parent_cats[] = $parent_cat;
                    $parent_id = $parent_cat->parent;
                }
                
                $parent_cats = array_reverse($parent_cats);
                
                foreach ($parent_cats as $parent) {
                    echo '<li>' . $separator . '<a href="' . get_category_link($parent->term_id) . '">' . $parent->name . '</a></li>';
                    $breadcrumbs_schema[] = array(
                        '@type' => 'ListItem',
                        'position' => $position++,
                        'name' => $parent->name,
                        'item' => get_category_link($parent->term_id)
                    );
                }
            }
            
            // Categoría actual
            echo '<li>' . $separator . '<a href="' . get_category_link($category->term_id) . '">' . $category->name . '</a></li>';
            $breadcrumbs_schema[] = array(
                '@type' => 'ListItem',
                'position' => $position++,
                'name' => $category->name,
                'item' => get_category_link($category->term_id)
            );
        }
    }
    
    if (is_single()) {
        echo '<li>' . $separator . '<span>' . get_the_title() . '</span></li>';
        $breadcrumbs_schema[] = array(
            '@type' => 'ListItem',
            'position' => $position++,
            'name' => get_the_title(),
            'item' => get_permalink()
        );
    }
    
    if (is_page()) {
        $parent_id = wp_get_post_parent_id(get_the_ID());
        if ($parent_id) {
            $parent_pages = array();
            while ($parent_id) {
                $page = get_post($parent_id);
                $parent_pages[] = $page;
                $parent_id = $page->post_parent;
            }
            
            $parent_pages = array_reverse($parent_pages);
            
            foreach ($parent_pages as $parent) {
                echo '<li>' . $separator . '<a href="' . get_permalink($parent->ID) . '">' . $parent->post_title . '</a></li>';
                $breadcrumbs_schema[] = array(
                    '@type' => 'ListItem',
                    'position' => $position++,
                    'name' => $parent->post_title,
                    'item' => get_permalink($parent->ID)
                );
            }
        }
        
        echo '<li>' . $separator . '<span>' . get_the_title() . '</span></li>';
        $breadcrumbs_schema[] = array(
            '@type' => 'ListItem',
            'position' => $position++,
            'name' => get_the_title(),
            'item' => get_permalink()
        );
    }
    
    if (is_search()) {
        echo '<li>' . $separator . '<span>Resultados de búsqueda para: ' . get_search_query() . '</span></li>';
    }
    
    if (is_404()) {
        echo '<li>' . $separator . '<span>Error 404</span></li>';
    }
    
    echo '</ol>';
    echo '</nav>';
    
    // Generar schema BreadcrumbList
    $schema = array(
        '@context' => 'https://schema.org',
        '@type' => 'BreadcrumbList',
        'itemListElement' => $breadcrumbs_schema
    );
    
    echo '<script type="application/ld+json">' . json_encode($schema, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE) . '</script>';
}
?>

✅ Qué hace esta función:

• Genera breadcrumbs HTML visuales con enlaces
• Crea schema BreadcrumbList JSON-LD automáticamente
• Maneja jerarquías de categorías y páginas
• Adapta output según tipo de página (post, página, categoría, búsqueda, 404)

<?php
add_action('generate_before_content', 'aiseo_breadcrumbs');
?>

💡 Tip: Si no estás seguro dónde añadir el código, usa Opción B (header.php). Es universal y funciona en todos los temas.

.breadcrumbs {
  font-size: 0.9rem;
  padding: 1rem 0;
  margin-bottom: 1.5rem;
  border-bottom: 1px solid #e5e7eb;
}

.breadcrumb-list {
  list-style: none;
  padding: 0;
  margin: 0;
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  gap: 0.25rem;
}

.breadcrumb-list li {
  display: inline-flex;
  align-items: center;
}

.breadcrumb-list a {
  color: #3b82f6;
  text-decoration: none;
  transition: color 0.2s;
}

.breadcrumb-list a:hover {
  color: #1d4ed8;
  text-decoration: underline;
}

.breadcrumb-list span {
  color: #2d3748;
  font-weight: 500;
}

/* Responsive: ocultar en móviles pequeños si es muy largo */
@media (max-width: 640px) {
  .breadcrumbs {
    font-size: 0.85rem;
  }
}

✅ Verificación visual: Accede a cualquier artículo. Deberías ver breadcrumbs con enlaces azules, último elemento sin enlace, separados por «›».