Bloc-notes de Darathor

Description

Ce plugin permet de générer automatiquement des listes d’articles de votre site selon divers critères (tags, catégories, auteur, date, etc). Ces listes peuvent être soit intégrées à la un article (via un la balise ShortCode wlist), soit être intégrées à une barre latérale (via un Widget).

Téléchargement

Post-lister v0.1

Compatibilité

Testé sur WordPress en version 2.5.1.

Langues disponibles

• Français

Historique

• 0.1 (2008-07-09) : version initiale inspirée du plugin Query inside post de k-ny

Installation

1. Télécharger et décompresser le plugin.
2. Uploader les fichiers dans le dossier wp-content/plugin de votre site WordPress.
3. Activer le plugin dans la section “plugins” du panneau d’administration de votre site.
4. Pour intégrer une liste à la barre latérale, rendez-vous dans la section “widgets” et pour intégrer une liste à un article, utilisez la balise ShortCode wlist (cf plus bas).

Utilisation de la balise ShortCode

Paramètres disponibles

• request : Vide par défaut. Pour les utilisateurs experimentés, permet d’envoyer sa propre requête. Exemple :
  Code

  [wlist request="tag=google&showposts=5"]
• cat : Vide par défaut. Permet de preciser l’ID de la catégorie. Exemples :
  Code

  [wlist cat=5]
[wlist cat="5,6,7"]
[wlist cat=-5]
• category_name : Vide par défaut. Permet de préciser le nom de la catégorie. Exemple :
  Code

  [wlist category_name="Web Design"]
• tag : Vide par défaut. Permet de préciser le nom du tag. Exemples :
  Code

  [wlist tag=vie-personelle]
[wlist tag="vie-personelle,photos"]
[wlist tag="vie-personelle+photos"]
• order : “desc” par défaut. Permet de préciser l’ordre de tri. Exemples :
  Code

  [wlist order=asc]
[wlist order=desc]
• orderby : “post_date” par défaut. Permet de préciser le paramètre de tri. Exemples :
  Code

  [wlist orderby=post_title]
[wlist orderby=post_date]
[wlist orderby=random]
• author : Vide par défaut. Permet de préciser l’ID de l’auteur. Exemples :
  Code

  [wlist author=1]
[wlist author=1,2]
[wlist author=-1]
• author_name : Vide par défaut. Permet de préciser le nom de l’auteur. Exemple :
  Code

  [wlist author_name="Julien"]
• showposts : 5 par défaut. Permet de préciser le nombre d’éléments a retourner. Exemple :
  Code

  [wlist showposts=10]
• offset : Vide par défaut. Permet de préciser l’offset. Exemple :
  Code

  [wlist offset=3]
• beforelist : <ul class=”wlist”> par défaut. Permet de préciser la tag se trouvant au début de la liste. Exemple :
  Code

  [wlist beforelist="<ol>"]
• afterlist : </ul> par défaut. Permet de préciser la tag se trouvant à la fin de la liste. Exemple :
  Code

  [wlist afterlist="</ol>"]
• beforeitem : <li> par défaut. Permet de préciser la tag se trouvant au début de chaque élément. Exemple :
  Code

  [wlist beforeitem="<li><p>"]
• afteritem : </li> par défaut. Permet de préciser la tag se trouvant à la fin de chaque élément. Exemple :
  Code

  [wlist afteritem="</p></li>"]
• showauthor : ‘false’ par défaut. Permet d’afficher ou non l’auteur des messages listés. Exemple :
  Code

  [wlist showauthor=true]
• showdate : ‘false’ par défaut. Permet d’afficher ou la date des messages listés. Exemple :
  Code

  [wlist showdate=true]
• showcommentcount : ‘false’ par défaut. Permet d’afficher ou le nombre de commentaires des messages listés. Exemple :
  Code

  [wlist showcommentcount=true]

Remarques complémentaires

• Chaque attribut est facultatif.
• On peut evidement cumuler les attributs. Exemple :
  Code

  [wlist tag=google showposts=5]
• N’utilisez pas l’attribut “cat” en même temps que l’attribut “tag” (bug wordpress), c’est ou l’un ou l’autre.
• Vous pouvez également afficher une liste de liens directement dans votre thème via la fonction :
  Code

  <?php echo PostLister::getInstance()->executeQuery($request, $beforeList, $afterList, $beforeItem, $afterItem, $showAuthor, $showDate, $showCommentCount); ?>