Lorsque j’ai démarré ce blog avec WordPress, j’ai développé un petit bout de code permettant d’afficher les archives de façon plus condensée. Il s’agissait de regrouper les articles par année, puis par mois, en fonction d’une année pivot. A la demande d’un certain nombre d’entre vous, transformer ce morceau de code en plugin.
EG-Archives propose un widget, ainsi qu’une template tag, vous permettant d’afficher les archives dans ce mode mixte, à la fois annuel et mensuel.

Présentation

Le widget standard de WordPress n’accepte que très peu de paramètres. Nous pouvons spécifier:

  • le titre,
  • s’il faut afficher le nombre d’articles ou pas.

Avec le widget proposé par le plugin EG-Archives, vous pouvez choisir:

  • le titre,
  • le format de la liste (liste simple, ou liste déroulante),
  • le type: annuel, mensuel, hebdomadaire, quotidien, …

EG-Archives ajoute un type à la liste des types standards: le type « annuel/mensuel mixte ». Dans ce cas, les archives sont regroupées annuellement, puis mensuellement, en fonction d’une date pivot spécifiée. Ce type d’affichage permet de raccourcir la liste mensuelle habituellement utilisée. Il est particulièrement utile dans le cas ou vous ne publiez pas trop d’articles par an.

Liste des archives

Liste des archives

Installation

Le plugin s’installe en suivant la méthode habituelle:

  1. EG-Archives est disponible sur le repository de WordPress,
  2. Une fois téléchargé, décompresser le fichier eg-archives.zip,
  3. Copier les fichiers obtenus dans un sous-répertoire du répertoire plugins (en général wp-content/plugins sur votre plateforme WordPress,
  4. Activer le plugin via le menu approprié dans l’interface d’administration.

Avec WordPress 2.7, vous pouvez effectuer l’installation directement depuis l’interface d’administration, en utilisant les fonctionnalités de cette version.

Utilisation

EG-Archives propose un widget, ainsi qu’une fonction (template tag).

Le widget

Le widget s’utilise comme un widget standard

  • Aller dans le menu Apparence / Widgets,
  • Activer le widget appelé EG-Archives,
  • Configurer ce widget, par la méthode habituelle.
Configuration du widget

Configuration du widget

Template tag

Le plugin fournit donc une fonction supplémentaire, eg_get_archives, utilisable dans d’autres plugins, ou dans les templates de votre thème.

Les arguments acceptés par la fonction sont les mêmes que ceux de la fonction standard wp_get_archives.

  • type (chaîne de caractères) Type de la liste à afficher: yearly, monthly, daily, weekly, postbypost. Valeur par défaut: monthly,
  • limit (entier) Nombre maximum de liens à afficher. Par défaut, il n’y a pas de limite,
  • format (chaîne de caractères) Format de la liste. Les valeurs possibles sont:
    • html – liste HTML simple (ul/li). Il s’agit de la valeur par défaut,
    • option – liste déroulante (select/option),
    • link – les archives sont affichés à l’intérieur des balises <link>,
    • custom – Liste personalisée. Ce mode utilise les paramètres before et after.
  • before (chaîne de caractères) Texte placé avant le lien. Utilisé avec les modes html et custom,
  • after (chaîne de caractères) Texte placé après le lien. Utilisé avec les modes html et custom,
  • show_post_count (booléen) Affiche (1 – true), ou n’affichage pas (0 – false), le nombre d’articles correspondant à l’archive. Paramètre utilisable avec tous les types, sauf  ‘postbypost’. La valeur par défaut est 0,
  • echo (booléen) Affiche (1 – true) or retourne (0 – false) la liste. La valeur par défaut est 1.

La fonction eg_get_archives accepte un argument supplémentaire:

  • pivot (entier) L’année « pivot ». Avant cette date, les archives sont regroupées par année. Après cette date, les archives sont regroupées par mois. Par défaut, l’année pivot est l’année courante (2009).

F.A.Q

Rien pour l’instant.