=== Archive Isotope Filter ===
Contributors: votreNom
Tags: archive, isotope, filter, masonry, load more, ajax, categories
Requires at least: 5.8
Tested up to: 6.5
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Filtre dynamique Isotope pour les pages d'archives WordPress avec Load More AJAX, filtres hiérarchiques et options d'administration complètes.

== Description ==

**Archive Isotope Filter** transforme vos pages d'archives WordPress en expériences de navigation modernes et fluides grâce à Isotope.js.

= Fonctionnalités principales =

* **Filtres dynamiques Isotope** sur catégories, tags, et Custom Post Types
* **Filtres hiérarchiques** parents / enfants avec sous-groupes dépliables
* **Load More AJAX** ou **Défilement infini** (configurable)
* **Masonry layout** optionnel ou grille régulière
* **Filtrage combiné** Catégorie + Tag
* **Compatible Gutenberg et Elementor**
* **Administration complète** via le back-office WordPress
* **CSS/JS optimisé** pour 200+ articles

= Structure des fichiers =

```
archive-isotope-filter/
├── archive-isotope-filter.php   # Fichier principal du plugin
├── includes/
│   ├── class-aif-settings.php   # Page d'options admin
│   ├── class-aif-assets.php     # Chargement des scripts/styles
│   ├── class-aif-filters.php    # Rendu des boutons de filtres
│   ├── class-aif-ajax.php       # Gestionnaire AJAX Load More
│   └── class-aif-hooks.php      # Hooks thème (classes, grille, pagination)
├── assets/
│   ├── js/
│   │   └── archive-isotope-filter.js  # JS principal (Isotope + Load More)
│   └── css/
│       └── archive-isotope-filter.css # CSS complet (grille, boutons, responsive)
└── languages/                   # Fichiers de traduction
```

= Intégration avec votre thème =

Le plugin injecte automatiquement les classes nécessaires sur vos articles existants :

* `archive-post` — classe de base requise par Isotope
* `cat-{slug}` — une classe par catégorie (et catégorie parente)
* `tag-{slug}` — une classe par tag

Il enveloppe automatiquement votre boucle dans `.archive-posts.aif-grid`.

= Personnalisation CSS =

Toutes les couleurs et dimensions sont des variables CSS facilement modifiables :

```css
:root {
  --aif-primary:       #0073aa;  /* Couleur principale */
  --aif-card-bg:       #fff;     /* Fond des cartes */
  --aif-card-radius:   8px;      /* Arrondi des cartes */
  --aif-gap:           24px;     /* Espacement entre cartes */
  --aif-thumb-ratio:   56.25%;   /* Ratio image (16:9 par défaut) */
}
```

Vous pouvez aussi ajouter du CSS personnalisé directement depuis **Réglages → Archive Filter → Avancé**.

== Installation ==

1. Téléchargez le plugin et extrayez le dossier `archive-isotope-filter`
2. Uploadez-le dans `/wp-content/plugins/`
3. Activez le plugin dans **Extensions** → **Extensions installées**
4. Configurez via **Réglages** → **Archive Filter**

== Frequently Asked Questions ==

= Le plugin fonctionne-t-il avec tous les thèmes ? =

Oui. Le plugin s'intègre à votre HTML existant sans le remplacer. Il ajoute les classes Isotope aux éléments `<article>` générés par WordPress.

= Puis-je personnaliser le rendu des cartes AJAX ? =

Oui, via le filtre WordPress :
```php
add_filter( 'aif_post_card_html', function( $html, $post_id ) {
    // Retournez votre propre HTML
    return $html;
}, 10, 2 );
```

= Compatible avec WooCommerce ? =

Le plugin peut fonctionner avec les archives WooCommerce mais n'est pas testé spécifiquement avec les produits. Pour les archives produits, utilisez les filtres natifs WooCommerce.

== Changelog ==

= 1.0.0 =
* Version initiale

== Upgrade Notice ==

= 1.0.0 =
Première version stable.
