Plugin flexweg-archives

Le plugin génère des pages d'archives statiques groupées par année — et optionnellement par mois ou semaine ISO — sous . C'est l'alternative static-friendly à la pagination : au lieu de , les

Le plugin flexweg-archives génère des pages d'archives statiques groupées par année — et optionnellement par mois ou semaine ISO — sous /archives/. C'est l'alternative static-friendly à la pagination : au lieu de ?page=2, les visiteurs naviguent par période.

Il injecte aussi un lien « Voir les archives complètes » sur la home et les listings de catégorie pour que le point d'entrée soit découvrable sans travail manuel sur les menus.

Ce qu'il génère

Page Path sur Flexweg Contenu
Index /archives/index.html Chaque période (année, optionnellement mois/semaine) avec les compteurs de posts
Année /archives/2026/index.html Tous les posts en ligne créés en 2026
Mois /archives/2026/03/index.html Tous les posts en ligne créés en mars 2026
Semaine /archives/2026/W12/index.html Tous les posts en ligne créés en semaine ISO 12 de 2026

Chaque page rend via le template category du thème actif (via archive si le thème en fournit un — fallback category), donc l'apparence matche le reste du site sans travail par thème.

Réglages

/settings/plugin/flexweg-archives expose :

  • Granularitéyear (par défaut), month, ou week. Plus la granularité est fine, plus il y a de pages générées.
  • Format de date — chaîne format pour les labels (compatible avec Intl.DateTimeFormat). Défaut : "long" (« mars 2026 », « semaine 12, 2026 »).
  • Lien dans home / category — toggle pour injecter le lien « Voir les archives complètes » dans le template home et chaque CategoryTemplate.
  • Force regenerate — wipe /archives/ puis re-construit tout.

Le hook lifecycle

Sur publish.complete, post.unpublished, post.deleted, le plugin :

  1. Détermine la période impactée (année + optionnellement mois/semaine)
  2. Re-construit uniquement les pages de cette période
  3. Re-construit l'index (peu coûteux)

Les pages d'archives d'autres périodes restent intactes.

Wipe complet via Force regenerate

Le bouton Force regenerate dans la page de réglages :

  1. deleteFolder("/archives/") — supprime tout le sous-dossier
  2. Recalcule toutes les périodes depuis le corpus actuel
  3. Re-uploade chaque page

Utile après un changement de granularité (year → month) qui rend les anciennes pages obsolètes.

Limites

  • Pas de search dans les archives — c'est juste un listing chronologique. Pour la recherche, voir flexweg-search.
  • Pas de pagination intra-période — si vous avez 1000 posts en 2026, /archives/2026/index.html les liste tous sur une page. Considerez la granularité month pour réduire.
  • Pas d'archives par auteur — pas d'objectif explicite. Vous pouvez créer un plugin custom qui s'en charge.

Désactivation

Désactiver le plugin ne supprime PAS /archives/. Utilisez Force regenerate avec une granularité différente, ou supprimez manuellement via le file manager Flexweg.

Pour purger : désactivez, puis allez dans la console Flexweg → File manager → supprimez /archives/.

Cas multilang

flexweg-archives n'a pas (encore) d'intégration native avec flexweg-multilang. Les archives sont rendues uniquement en langue primaire. Pour des archives par langue, ce serait un plugin custom à écrire.

Utilisation typique

Pour un blog éditorial :

  • Granularité : month
  • Lien dans home / category : ON
  • Force regenerate après les premières publications, puis laisse le lifecycle gérer

Pour un site corporate ou portfolio :

  • Granularité : year
  • Lien dans home / category : OFF (les archives ne sont pas une UX principale)