Créer des modules pour Blogotext

Dans les versions >3.3 de Blogotext, il est possible d’ajouter des modules complémentaires. La portée des modules est pour le moment restreinte à l’affichage public du blog (pas le panel admin).
Pour le moment, il n’est question que de manipulations simples.

Le fonctionnement est assez simple : dans un fichier addons/votre_addon.php, il faut dire à Blogotext de remplacer une balise de votre thème par du HTML. Un add-ons fonctionne donc de paire avec votre theme. Le HTML est celui qu’une fonction dans votre add-on aura produit.

Exemple : ajouter l’année courante en bas de la page

On veut un module qui affiche l’année en cours en bas du blog.

Pour cela on va créer une balise {plugin_annee} et on va la placer dans le thème, par exemple dans le fichier list.html.

Maintenant, dans un fichier module de Blogotext, il faut :

Dans notre cas, notre fichier annee.php est placé dans le dossier addons et contient ceci :

<?php

// include this addon
$GLOBALS['addons'][] = array(
	'tag' => '{plugin_annee}',
	'callback_function' => 'addon_anneecourante'
);

// returns HTML
function addon_anneecourante() {
	$html = '<em>'.date('Y').'</em>';
	return $html;
}

Et c’est tout !

Votre fonction peut renvoyer tout le HTML que vous voulez. Vous pouvez même faire des requêtes à la base de donnée et utiliser le contenu retourné.