Dans Bloginus, les articles sont dépendants de la catégorie dans laquelle ils ont été ajoutés depuis le module "p" du backoffice.
Comme pour les catégories, vous pouvez gérer deux types de données liées aux articles : un article unique ou une liste d'articles.
Les articles
Les articles ont tous un identifiant unique composé de 3 symboles (lettres et chiffres). Cet identifiant est à utiliser dans les fonctions de l'API.
La fonction post_get_infos($id) retourne un tableau des propriétés de l'article ayant $id comme identifiant. Ces propriétés sont :
- $article["id"] => contient l'identifiant de l'article, à utiliser dans l'API de Bloginus.
- $article["label"] => contient le titre de l'article. Ce n'est que du texte, sans mise en forme HTML possible.
- $article["text"] => contient le texte associé à l'article. Ce champ contient du code HTML pour la mise en forme du texte saisi dans le module "p" du backoffice.
- $article["published"] => booléen indiquant si ll'article est public ou ne doit pas être affichée sur le site.
- $article["timestamp"] => contient la date et l'heure de dernière mise à jour de l'article (en temps Unix, donc utilisable par la fonction date() de PHP).
- $article["seo"] => indique si la page de l'article doit être indexée par les moteurs de recherche. Ce champ peut prendre trois valeurs :
- true => la page est indexable
- false => la page n'est pas indexable
- "" => la valeur booléenne de config_getvar("seo_p") doit être appliquée à cet article (true pour indexable, false pour non indexable)
N'utilisez ces informations qu'en lecture dans vos thèmes. Pour les plugins, c'est une autre histoire.
Les listes d'articles
Les listes d'articles sont récupérables en appelant la fonction post_get_liste($categorie_id) qui retournera la liste des articles de la catégorie $categorie_id ou post_get_liste_feed() qui retourne la liste de tous les articles du site.
Cette liste est un tableau des articles trouvés. Les éléments de ce tableau sont eux aussi des tableaux ayant les propriétés suivantes:
- $liste[$i]["id"] => identifiant de l'article de rang $i dans la liste $liste
- $liste[$i]["published"] => indique si l'article de rang $i dans la liste $liste est public ou privée. C'est un booléen.
- $liste[$i]["timestamp"] => date/heure en format Unix de la dernière modification de l'article
Les fonctions de l'API liées aux articles
Bloginus fourni une API pour accéder aux différents éléments de la base de données. Il vous suffit de les appeler dans vos thèmes pour les afficher ou les retraiter à l'écran.
A ce jour, 4 fonctions concernant les articles peuvent être utilisées dans les thèmes :
- post_url($id) => retourne l'adresse internet permettant d'afficher la page liée à l'article $id
- post_get_infos($id) => retourne le tableau des propriétés de l'article $id
- post_get_liste($categorie_id) => retourne la liste des articles de la catégorie $categorie_id
- post_get_liste_feed() => retourne la liste de tous les articles du site
- post_get_category_id($id) = retourne l'identifiant de la catégorie dans laquelle se trouve l'article $id
Même si vous trouvez d'autres fonctions dans les sources de Bloginus, ne les utilisez pas : elle peuvent être changées à tout moment alors que celles indiquées ci-dessus seront maintenues en l'état pour les versions futures du logiciel.