Documentation Dotclear 2.6:resources:plugins

2.6:resources:plugins:admin

Wed, 16 Oct 2013 09:56:41 +0200

1379364839		Version actuelle
Ligne 30:		Ligne 30:
	Un lien vers la page d'administration apparaît dans le sous-menu Extensions de la page d'administration :		Un lien vers la page d'administration apparaît dans le sous-menu Extensions de la page d'administration :

-	{{:2.0:resources:plugins:admin:menu_item.png\|}}	+	{{:2.6:resources:plugins:admin:menu_item.png\|}}

	<note tip>		<note tip>
Ligne 67:		Ligne 67:
	Voici le résultat :		Voici le résultat :

-	{{:2.0:resources:plugins:admin:page.png?300\|}}	+	{{:2.6:resources:plugins:admin:page.png\|}}

2.6:resources:plugins:antispam

Wed, 16 Oct 2013 09:56:41 +0200

	Version actuelle
Ligne 1:	Ligne 1:
	+	====== Création de filtres antispam ======

	+	===== Généralités =====
	+
	+	La création de filtres supplémentaires pour le plugin antispam n'est pas compliquée, elle consiste à faire un plugin tout simple contenant une classe de filtrage. Cette classe va prendre en charge la reconnaissance du message comme un spam, l'entraînement éventuel du filtre, l'affichage d'une possible interface de configuration et l'affichage de messages d'information concernant le spam.
	+
	+	Nous allons ici voir comment réaliser un filtre tout simple.
	+
	+	===== Définition du plugin =====
	+
	+	Comme d'habitude, tout commence par un répertoire dans vos plugins, contenant un fichier _define.php :
	+
	+	<code php>
	+	<?php
	+	if (!defined('DC_RC_PATH')) { return; }
	+
	+	$this->registerModule(
	+	/* Name */ "FooFilter",
	+	/* Description*/ "Foo Spam Filter",
	+	/* Author */ "Peter McAlloway",
	+	/* Version */ '1.0',
	+	/* Permissions */ 'usage,contentadmin',
	+	/* Priority */ 200
	+	);
	+	?>
	+	</code>
	+
	+	<note>Spécifiez toujours une priorité supérieure à 10 sinon votre filtre ne va pas fonctionner.</note>
	+
	+	Maintenant, nous devons déclarer notre nouveau filtre à $core. Nous allons faire ceci dans un fichier _prepend.php :
	+
	+	<code php>
	+	<?php
	+	if (!defined('DC_RC_PATH')) { return; }
	+
	+	global $__autoload, $core;
	+	$__autoload['dcFilterFoo'] = dirname(__FILE__).'/class.dc.filter.foo.php';
	+	$core->spamfilters[] = 'dcFilterFoo';
	+	?>
	+	</code>
	+
	+	Ce fichier indique au système de chargement automatique de classes où trouver la classe de filtrage puis ajoute le filtre (le nom de la classe) aux autres filtres dans $core->spamfilters.
	+
	+	===== Création du filtre =====
	+
	+	Nous avons déclaré une classe de filtrage mais celle-ci n'existe pas, c'est un peu dommage. Nous allons donc de ce pas créer un fichier class.dc.filter.foo.php dans notre plugin :
	+
	+	==== La classe de filtrage ====
	+
	+	<code php>
	+	<?php
	+	class dcFilterFoo extends dcSpamFilter
	+	{
	+	public $name = 'Foo Filter';
	+	public $has_gui = false;
	+
	+	protected function setInfo()
	+	{
	+	$this->description = __('My new foo spam filter');
	+	}
	+	}
	+	?>
	+	</code>
	+
	+	<note important>
	+	Votre classe de filtre doit impérativement être enfant de dcSpamFilter sinon elle ne sera même pas chargée.
	+	</note>
	+
	+	Nous venons de réaliser un filtre dont le nom est "Foo Filter", avec une description qui sera affichée dans la liste des filtres. Le paramètre $has_gui = false indique que notre filtre n'a pas d'écran de configuration.
	+
	+	<note tip>
	+	La classe ainsi créée dispose d'une propriété $this->core permettant d'accéder à tous les objets utiles de Dotclear (base de données, blog en cours, permissions...).
	+	</note>
	+
	+	==== La méthode isSpam ====
	+
	+	Notre filtre est pour le moment parfaitement inutile puisqu'il ne contient pas de méthode pour reconnaître un spam. Cette méthode s'appelle isSpam, nous allons l'ajouter (dans le corps de la classe donc) :
	+
	+	<code php>
	+	<?php
	+	...
	+	public function isSpam($type,$author,$email,$site,$ip,
	+	$content,$post_id,&$status)
	+	{
	+	$status = 'Filtered';
	+	return true;
	+	}
	+	...
	+	</code>
	+
	+	Ici, notre méthode va déclarer que tous les commentaires sont du spam et assigner le status "Filtered" à celui-ci.
	+
	+	Cette méthode prend les paramètres suivants :
	+
	+	* $type : le type de commentaire (//comment// ou //trackback//)
	+	* $author : le nom de l'auteur
	+	* $email : l'adresse email de l'auteur
	+	* $site : l'URL du site de l'auteur
	+	* $ip : l'adresse IP de l'auteur
	+	* $content : le contenu du commentaire
	+	* $post_id : l'ID du billet sur lequel le commentaire a été posté
	+
	+	La dernière variable $status doit bien être déclarée en référence (&$status) puisqu'elle permet de transmettre le statut du commentaire si celui-ci est marqué comme spam.
	+
	+	Cette méthode doit renvoyer true si le message est un spam et null si on ne sait pas.
	+
	+	<note warning>
	+	Si la méthode renvoie false le message sera immédiatement reconnu comme non spam quel que soit les résultats des autres filtres. Ça peut-être utile dans certains cas mais faites attention à ne pas vous tromper.
	+	</note>
	+
	+	==== La méthode getStatusMessage ====
	+
	+	Cette méthode doit renvoyer une chaîne contenant une information sur le pourquoi du filtrage. Elle sera affichée après chaque commentaire dans les listes ou dans la page d'édition de ceux-ci.
	+
	+	Pour notre filtre, voici ce que nous pouvons indiquer (toujours en ajoutant cette méthode dans le corps de la classe) :
	+
	+	<code php>
	+	<?php
	+	...
	+	public function getStatusMessage($status,$comment_id)
	+	{
	+	return sprintf(__('Filtered by %s.'),$this->guiLink());
	+	}
	+	...
	+	?>
	+	</code>
	+
	+	Chaque commentaire filtré par votre plugin indiquera "Filtré par Foo Filter". Vous n'êtes pas obligé de créer cette méthode. Dans ce cas, vous aurez une indication par défaut : "Filtré par Foo Filter (raison)".
	+
	+	==== La méthode trainFilter ====
	+
	+	Si votre filtre nécessite qu'on lui apprenne à reconnaître un spam ou un non-spam, cette méthode peut être nécessaire. Elle sera appelée dans les cas suivants :
	+
	+	* On passe un commentaire qui n'est pas un spam en spam
	+	* On publie un commentaire qui est un spam
	+
	+	Dans ces deux cas, les méthodes trainFilter de chaque filtre seront appelées.
	+
	+	La méthode prend les paramètres suivants :
	+
	+	* $status : Statut du commentaire (//spam// si on déclare un spam, //ham// si on déclare un non spam)
	+	* $filter : Filtre qui a été appliqué sur le commentaire si celui-ci était un spam
	+	* $type : Type de commentaire (//comment// ou //trackback//)
	+	* $author : Nom de l'auteur
	+	* $email : Adresse email de l'auteur
	+	* $site : URL du site de l'auteur
	+	* $ip : Adresse IP de l'auteur
	+	* $content : Contenu du commentaire
	+	* $rs : Objet de type record contenant d'autres informations sur le commentaire
	+
	+	Votre méthode se déclare donc comme ceci :
	+
	+	<code php>
	+	<?php
	+	...
	+	public function trainFilter($status,$filter,$type,$author,
	+	$email,$site,$ip,$content,$rs)
	+	{
	+	// Choses à faire pour entraîner le filtre
	+	}
	+	...
	+	?>
	+	</code>
	+
	+	==== La méthode gui ====
	+
	+	La methode gui($url) permet de créer l'interface de configuration de votre filtre. Pour que celle-ci soit active, vous devez spécifier public $has_gui = true; au début de votre classe.
	+
	+	Cette méthode prend un seul paramètre : l'URL de configuration du filtre.
	+
	+	Par exemple, une interface toute simple de votre filtre :
	+
	+	<code php>
	+	<?php
	+	...
	+	public function gui($url)
	+	{
	+	return '<p>My filter GUI</p>';
	+	}
	+	...
	+	?>
	+	</code>
	+
	+	<note>
	+	Le paramètre $url contient des caractères spéciaux, pensez à l'afficher dans la page avec html::escapeHTML($url). Vous n'avez par contre pas besoin de faire ça, si vous faites une redirection vers $url.
	+	</note>
	+
	+	===== Conclusion =====
	+
	+	Vous avez pu voir que faire un filtre antispam n'est pas bien compliqué. Afin d'approfondir ce court tutoriel, vous êtes encouragés à lire le code des filtres intégrés dans le plugin antispam (dans le répertoire "filters" de celui-ci).
	+
	+	===== Modèle de code pour une classe de filtrage =====
	+
	+	Voici un modèle de classe pour réaliser un filtre. Pensez à changer le nom de la classe.
	+
	+	<code php>
	+	<?php
	+	class dcFilterFirst extends dcSpamFilter
	+	{
	+	public $name = 'Filter Name'; // The name of your filter
	+	public $has_gui = true; // Has your filter a GUI?
	+
	+	// Set here the localized description of your filter
	+	protected function setInfo()
	+	{
	+	$this->description = __('My first spam filter');
	+	}
	+
	+	/*
	+	You may need this method or let parent method do its job.
	+	public function getStatusMessage($status,$comment_id)
	+	{
	+	return sprintf(__('Filtered by %s.'),$this->guiLink());
	+	}
	+	*/
	+
	+	public function isSpam($type,$author,$email,
	+	$site,$ip,$content,$post_id,&$status)
	+	{
	+	/*
	+	return true and set $status if message is a spam
	+	return null if you don't know (not false)
	+	*/
	+	}
	+
	+	/*
	+	Only if you need to train your filter
	+	public function trainFilter($status,$filter,$type,
	+	$author,$email,$site,$ip,$content,$rs)
	+	{
	+	}
	+	*/
	+
	+	// A totaly useless GUI
	+	public function gui($url)
	+	{
	+	return '<p>'.__('My filter GUI').'</p>';
	+	}
	+	}
	+	?>
	+	</code>

2.6:resources:plugins:auto-install

Wed, 16 Oct 2013 09:56:41 +0200

	Version actuelle
Ligne 1:	Ligne 1:
	+	====== Ajouter une procédure d'installation de plugin ======

	+	===== Introduction =====
	+
	+	Parfois, un plugin peut avoir besoin de paramètres supplémentaires ou de modifier le schéma de la base de données. Cette étape est couverte par la procédure d'installation automatique. En réalité cette procédure est semi-automatique laissant une assez grande flexibilité au développeur pour réaliser une procédure d'installation et de mise à jour de son travail.
	+
	+	===== Le fichier _install.php =====
	+
	+	Toute la procédure d'installation et mise à jour automatique passe par le fichier _install.php contenu dans votre plugin. Si un tel fichier existe, il sera appelé à chaque fois qu'un utilisateur se rendra sur le tableau de bord de son blog dans l'interface d'administration.
	+
	+	Le contenu de ce fichier est un code PHP indiquant son statut de trois manières :
	+
	+	* return true : le plugin a été installé
	+	* return : rien à faire, aucun message (à utiliser quand rien n'est nécessaire)
	+	* throw new Exception('message erreur') : en cas d'erreur
	+
	+	Voyons un exemple simple. Notre plugin s'appelle toto et va enregistrer sa version dans la table des versions.
	+
	+	<code php>
	+	<?php
	+	if (!defined('DC_CONTEXT_ADMIN')) { return; }
	+
	+	# On lit la version du plugin
	+	$m_version = $core->plugins->moduleInfo('toto','version');
	+
	+	# On lit la version du plugin dans la table des versions
	+	$i_version = $core->getVersion('toto');
	+
	+	# La version dans la table est supérieure ou égale à
	+	# celle du module, on ne fait rien puisque celui-ci
	+	# est installé
	+	if (version_compare($i_version,$m_version,'>=')) {
	+	return;
	+	}
	+
	+	# La procédure d'installation commence vraiment là
	+	$core->setVersion('toto',$m_version);
	+	?>
	+	</code>
	+
	+	Attention, le nom passé à l'appel à //moduleInfo// n'est pas forcément le nom du plugin défini dans //_define.php//: il s'agit du nom du répertoire où se trouve votre plugin !
	+
	+	===== Créer de nouvelles préférences =====
	+
	+	Votre plugin peut avoir besoin de préférences pour fonctionner. Utiliser l'auto-installation pour les créer est une bonne idée.
	+
	+	Voici un exemple d'un système d'installation automatique ajoutant une préférence globale :
	+
	+	<code php>
	+	<?php
	+	if (!defined('DC_CONTEXT_ADMIN')) { return; }
	+
	+	$m_version = $core->plugins->moduleInfo('toto','version');
	+
	+	$i_version = $core->getVersion('toto');
	+
	+	if (version_compare($i_version,$m_version,'>=')) {
	+	return;
	+	}
	+
	+	# Création du setting (s'il existe, il ne sera pas écrasé)
	+	$core->blog->settings->addNamespace('toto');
	+	$settings->toto->put('toto_setting',true,'boolean','toto setting',false,true);
	+
	+	$core->setVersion('toto',$m_version);
	+	?>
	+	</code>
	+
	+	<note>Le paramètre de addNamespace() ne doit contenir que des chiffres ou des lettres sans accent.
	+
	+	Permis : [a-zA-Z][a-zA-Z0-9]
	+
	+	Le paramètre $type de put peut-être 'string', 'integer', 'float', 'boolean' ou 'null'.
	+	Si $type est 'null' et que setting existe, le type courant sera conservé.
	+	En dehors, le type 'string' sera appliqué.</note>
	+
	+	Voyez la documentation sur les [[.:settings\|paramètres]] pour utiliser les paramètres après l'installation.
	+
	+	===== Modifier le schéma de la base de données =====
	+
	+	Une des possibilités les plus intéressantes du système d'installation est de pouvoir très facilement modifier le schéma de la base de données. Vous pouvez donc facilement créer de nouvelles tables, ajouter un champ dans une table existante, créer des index ou des références.
	+
	+	==== UDBS ====
	+
	+	UDBS signifie "Universal DataBase Schema". Ce système permet de définir un schéma de base de données puis le comparer avec celui existant pour éventuellement le mettre à jour.
	+
	+	Du fait de sa capacité à travailler avec plusieurs types de bases de données, UDBS présente quelques limites :
	+
	+	* Aucun champ ne sera supprimé. UDBS ne fait que des création ou des mise à jour.
	+	* UDBS peut renommer un index ou en changer les champs mais pas les deux en même temps (il créera un nouvel index).
	+	* Seuls un certain nombre de types de données sont permis.
	+
	+
	+	==== Types de données autorisés ====
	+
	+	Devant fonctionner à la fois avec MySQL, PostgreSQL et SQLite, UDBS ne permet qu'un certain nombre de types de données :
	+
	+	\| smallint \| Entier signé de 2 octets \|
	+	\| integer \| Entier signé de 4 octets \|
	+	\| bigint \| Entier signé de 8 octets \|
	+	\| real \| Nombre flottant de 4 octets \|
	+	\| float \| Nombre flottant de 8 octets \|
	+	\| numeric \| Valeur numérique exacte \|
	+	\| date \| Date calendaire (jour, moins, année) \|
	+	\| time \| Heure de la journée \|
	+	\| timestamp \| Date et heure \|
	+	\| char \| Une chaîne de longueur fixe de n caractères \|
	+	\| varchar \| Une chaîne de longueur variable de n caractères \|
	+	\| text \| Un texte de longueur variable \|
	+
	+	==== Instance d'un objet dbStruct ====
	+
	+	En créant une instance de dbStruct vous allez pouvoir définir un schéma (complet ou partiel).
	+
	+	<code php>
	+	$s = new dbStruct($core->con,$core->prefix);
	+	</code>
	+
	+	La classe prend un objet de type connexion et les préfixes que l'on souhaite utiliser. Dans l'exemple précédent et les suivants, nous utiliserons les objets disponibles avec Dotclear.
	+
	+	==== Définir une table ====
	+
	+	dbStruct et dbStructTable proposent des particularités bien pratiques.
	+
	+	* La plupart des méthodes renvoient $this ce qui permet de les chaîner entre elles.
	+	* Tout appel à une propriété inexistante de dbStruct revient à créer un objet dbStructTable s'il n'existe pas et à récupérer l'instance.
	+	* Tout appel à une méthode inexistante de dbStructTable revient à appeler la méthode field qui ajoute un champ dans la table.
	+
	+	Voici un exemple classique n'utilisant pas les propriétés avancées de dbStruct :
	+
	+	<code php>
	+	$s = new dbStruct($core->con,$core->prefix);
	+
	+	$t = $s->table('matable');
	+	$t->field('champ1','varchar',255,false,"'-'");
	+	$t->field('champ2','smallint',0,true);
	+	</code>
	+
	+	Dans cet exemple, nous définissons la table matable à laquelle nous ajoutons deux champs :
	+
	+	* champ1, de type varchar de longueur 255 ne pouvant être nul et ayant la valeur par défaut '-'
	+	* champ2, de type smallint pouvant être nul et n'ayant pas de valeur par défaut.
	+
	+	Ce premier exemple fonctionne très bien mais voici également comment on peut l'écrire pour faire exactement la même chose :
	+
	+	<code php>
	+	$s = new dbStruct($core->con,$core->prefix);
	+
	+	$s->matable
	+	->champ1('varchar',255,false,"'-'")
	+	->champ2('smallint',0,true)
	+	;
	+	</code>
	+
	+	C'est tout de même plus pratique.
	+
	+	==== Ajouter un index ====
	+
	+	Pour ajouter un index à votre extension du schéma :
	+
	+	<code php>
	+	$s->matable->index('idx_matable_champ1','btree','champ2');
	+	</code>
	+
	+	La méthode index prend comme paramètres : le nom de l'index, le type ("btree" uniquement) et au moins un nom de champ concerné. Vous pouvez ajouter d'autres champs comme paramètres supplémentaires à la méthode.
	+
	+	==== Ajouter une clé primaire à une table ====
	+
	+	<code php>
	+	$s->matable->primary('pk_matable','champ1');
	+	</code>
	+
	+	Comme pour la méthode index, cette méthode peut prendre plus de deux paramètres si la clé est réalisée sur plusieurs champs de la table.
	+
	+	==== Ajouter une clé unique ====
	+
	+	<code php>
	+	$s->matable->unique('uk_matable','champ2');
	+	</code>
	+
	+	Comme pour la méthode index, cette méthode peut prendre plus de deux paramètres si la clé est réalisée sur plusieurs champs de la table.
	+
	+	==== Ajouter une référence à une autre table ====
	+
	+	Les références permettent d'indiquer si le champ d'une table est lié à celui d'une autre. Elles permettent d'assurer l'intégrité des données et d'automatiser certains processus tels que la suppression ou la mise à jour. On les appelle aussi "clés étrangères".
	+
	+	<code php>
	+	$s->category->reference('fk_category_blog','blog_id','blog','blog_id','cascade','cascade');
	+	</code>
	+
	+	Cet exemple crée la référence fk_category_blog sur le champ blog_id de la table category référençant le champ blog_id de la table blog. Les deux derniers paramètres sont les actions possibles dans les cas respectifs de mise à jour et de suppression d'une valeur référencée.
	+
	+	==== Synchronisation du schéma ====
	+
	+	Une fois un schéma écrit, il est nécessaire de le synchroniser. Voici comment faire avec le code précédent :
	+
	+	<code php>
	+	$s = new dbStruct($core->con,$core->prefix);
	+
	+	$s->matable
	+	->champ1('varchar',255,false,"'-'")
	+	->champ2('smallint',0,true)
	+	;
	+
	+	$si = new dbStruct($core->con,$core->prefix);
	+	$changes = $si->synchronize($s);
	+	</code>
	+
	+	Comme vous le voyez, on crée une nouvelle instance de dbStruct puis on appelle la méthode synchronize en lui passant l'instance de dbStruct précédente. Cette méthode va retourner le nombre de changements réalisés.
	+
	+	==== Interaction avec le plugin Import/Export ====
	+
	+	* [[http://tips.dotaddict.org/fiche/Sauvez-sauvez-il-en-restera-toujours-quelque-chose\|Sauvegarder la table lors de l'export d'un blog]]

2.6:resources:plugins:behaviors

Wed, 16 Oct 2013 09:56:41 +0200

	Version actuelle
Ligne 1:	Ligne 1:
	+	{{{pagetoc
	+	.:behaviors
	+	}}}

	+	====== Comportements ======
	+
	+	Les comportements sont des actions appelées à des emplacements précis. Ils sont ajoutés par des plugins qui peuvent ainsi étendre la manière dont DotClear effectue certaines actions, ou l'affichage de certaines parties de l'interface d'administration.
	+
	+
	+
	+
	+
	+	===== Principe =====
	+
	+	Un plugin //foo// veut réaliser une action avant qu'un billet soit modifié. Il faut d'abord définir une fonction qui sera enregistrée ensuite comme comportement :
	+
	+	<code php>
	+	class fooBehaviors
	+	{
	+	public static function beforePostUpdate(&$cur,$post_id) {
	+	$cur->post_title = 'titre foo';
	+	}
	+	}
	+	</code>
	+
	+	Cette fonction va changer le titre du billet, avant qu'il soit inséré en base de donnée, par "titre foo". On déclare maintenant le comportement :
	+
	+	<code php>
	+	$core->addBehavior('adminBeforePostUpdate',array('fooBehaviors','beforePostUpdate'));
	+	</code>
	+
	+	Le premier argument de cette méthode est le nom du comportement, le second est la fonction de callback appelée lors de l'événement.
	+
	+
	+	===== Behavior Admin =====
	+
	+	==== adminAfterBlogCreate ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminAfterBlogCreate',$cur,$blog_id,$settings);</code>
	+	Cet événement est appelé après la création d'un blog.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| cur \| cursor \| curseur sur le blog \|
	+	\| blog_id \| integer \| identifiant du blog \|
	+	\| settings \| dcSettings \| référence à l'objet settings du blog \|
	+
	+	Exemple de signature
	+	<code php>
	+	function adminAfterBlogCreate($cur,$blog_id,$settings)
	+	</code>
	+
	+	==== adminAfterBlogUpdate ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminAfterBlogUpdate',$cur,$blog_id);</code>
	+	Cet événement est appelé après la mise à jour d'un blog.
	+
	+	<note warning>En cas de mise-à-jour de l'identifiant du blog, ''$blog_id'' contient l'ancien identifiant. Le nouvel identifiant est disponible dans ''$cur->blog_id''.</note>
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| cur \| cursor \| curseur sur le blog \|
	+	\| blog_id \| integer \| identifiant du blog \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminAfterBlogUpdate($cur, $blog_id)
	+	</code>
	+
	+	==== adminAfterCategoryCreate ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminAfterCategoryCreate',$cur,$cat_id);</code>
	+	Cet événement est appelé après la création d'une catégorie.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| cur \| cursor \| curseur sur la catégorie \|
	+	\| cat_id \| integer \| identifiant de la catégorie \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminAfterCategoryCreate($cur, $cat_id)
	+	</code>
	+
	+	==== adminAfterCategoryUpdate ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminAfterCategoryUpdate',$cur,$cat_id);</code>
	+	Cet événement est appelé après la mise à jour d'une catégorie.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| cur \| cursor \| curseur sur la catégorie \|
	+	\| cat_id \| integer \| identifiant de la catégorie \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminAfterCategoryUpdate($cur, $cat_id)
	+	</code>
	+
	+	==== adminAfterCommentDesc ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminAfterCommentDesc', $rs);</code>
	+	Cet événement permet d'afficher des informations supplémentaires après la description d'un commentaire.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| rs \| record \| record sur le commentaire \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminAfterCommentDesc($rs)
	+	</code>
	+
	+	==== adminAfterCommentCreate ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminAfterCommentCreate',$cur,$comment_id);</code>
	+	Cet événement est appelé après la création d'un nouveau commentaire sur l'interface d'administration.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| cur \| cursor \| curseur sur le commentaire \|
	+	\| comment_id \| integer \| ID du commentaire \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminAfterCommentCreate($cur,$comment_id)
	+	</code>
	+
	+	==== adminAfterCommentUpdate ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminAfterCommentUpdate',$cur,$comment_id);</code>
	+	Cet événement est appelé après la mise à jour d'un commentaire sur l'interface d'administration.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| cur \| cursor \| curseur sur le commentaire \|
	+	\| comment_id \| integer \| ID du commentaire \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminAfterCommentUpdate($cur,$comment_id)
	+	</code>
	+
	+	==== adminAfterPostCreate ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminAfterPostCreate',$cur,$return_id);</code>
	+	Cet événement est appelé après la création d'un post.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| cur \| cursor \| curseur sur le post \|
	+	\| return_id \| integer \| identifiant du post \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminAfterPostCreate($cur, $return_id)
	+	</code>
	+
	+	==== adminAfterPostUpdate ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminAfterPostUpdate',$cur,$post_id);</code>
	+	Cet événement est appelé après la mise à jour d'un post.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| cur \| cursor \| curseur sur le post \|
	+	\| post_id \| integer \| identifiant du post \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminAfterPostUpdate($cur, $post_id)
	+	</code>
	+
	+	==== adminAfterUserCreate ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminAfterUserCreate',$cur,$new_id);</code>
	+	Cet événement est appelé après la création d'un utilisateur.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| cur \| cursor \| curseur sur l'utilisateur \|
	+	\| new_id \| integer \| identifiant de l'utilisateur \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminAfterUserCreate($cur, $new_id)
	+	</code>
	+
	+	==== adminAfterUserUpdate ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminAfterUserUpdate',$cur,$new_id);</code>
	+	Cet événement est appelé après la mise à jour d'un utilisateur.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| cur \| cursor \| curseur sur l'utilisateur \|
	+	\| new_id \| integer \| identifiant de l'utilisateur \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminAfterUserUpdate($cur, $new_id)
	+	</code>
	+
	+	==== adminBeforeBlogSettingsUpdate ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminBeforeBlogSettingsUpdate',$blog_settings);</code>
	+	Cet événement est appelé avant la mise à jour des settings d'un blog.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| blog_settings \| dcSettings \| objet contenant les settings du blog \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminBeforeBlogSettingsUpdate($blog_settings)
	+	</code>
	+
	+	==== adminBeforeBlogCreate ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminBeforeBlogCreate',$cur,$blog_id);</code>
	+	Cet événement est appelé avant la création d'un blog.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| cur \| cursor \| curseur sur le blog \|
	+	\| blog_id \| integer \| identifiant du blog \|
	+
	+	Exemple de signature
	+	<code php>
	+	function adminBeforeBlogCreate($cur,$blog_id)
	+	</code>
	+
	+	==== adminBeforeBlogUpdate ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminBeforeBlogUpdate',$cur,$blog_id);</code>
	+	Cet événement est appelé avant la mise à jour d'un blog.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| cur \| cursor \| curseur sur le blog \|
	+	\| blog_id \| integer \| identifiant du blog \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminBeforeBlogUpdate($cur, $blog_id)
	+	</code>
	+
	+
	+	==== adminBeforeCategoryCreate ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminBeforeCategoryCreate',$cur);</code>
	+	Cet événement est appelé avant la création d'une catégorie.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| cur \| cursor \| curseur sur la catégorie\|
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminBeforeCategoryCreate($cur)
	+	</code>
	+
	+	==== adminBeforeCategoryUpdate ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminBeforeCategoryUpdate',$cur,$cat_id);</code>
	+	Cet événement est appelé avant la mise à jour d'une catégorie.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| cur \| cursor \| curseur sur la catégorie \|
	+	\| cat_id \| integer \| identifiant de la catégorie \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminBeforeCategoryUpdate($cur, $cat_id)
	+	</code>
	+
	+	==== adminBeforeCommentCreate ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminBeforeCommentCreate',$cur);</code>
	+	Cet événement est appelé avant la création d'un nouveau commentaire sur l'interface d'administration.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| cur \| cursor \| curseur sur le commentaire \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminBeforeCommentCreate($cur)
	+	</code>
	+
	+	==== adminBeforeCommentUpdate ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminBeforeCommentUpdate',$cur,$comment_id);</code>
	+	Cet événement est appelé avant la mise à jour d'un commentaire sur l'interface d'administration.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| cur \| cursor \| curseur sur le commentaire \|
	+	\| comment_id \| integer \| ID du commentaire \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminBeforeCommentUpdate($cur,$comment_id)
	+	</code>
	+
	+	==== adminBeforePostCreate ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminBeforePostCreate',$cur);</code>
	+	Cet événement est appelé avant la création d'un post.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| cur \| cursor \| curseur sur le post\|
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminBeforePostCreate($cur)
	+	</code>
	+
	+
	+
	+	==== adminBeforePostUpdate ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminBeforePostUpdate',$cur,$post_id);</code>
	+	Cet événement est appelé avant la mise à jour d'un post.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| cur \| cursor \| curseur sur le post \|
	+	\| post_id \| integer \| identifiant du post \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminBeforePostUpdate($cur, $post_id)
	+	</code>
	+
	+	==== adminBeforePostDelete ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminBeforePostDelete',$post_id);</code>
	+	Cet événement est appelé avant la suppression d'un post.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| post_id \| integer \| identifiant du post \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminBeforePostDelete($post_id)
	+	</code>
	+
	+	==== adminBeforeUserCreate ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminBeforeUserCreate',$cur);</code>
	+	Cet événement est appelé avant la création d'un utilisateur.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| cur \| cursor \| curseur sur l'utilisateur \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminBeforeUserCreate($cur)
	+	</code>
	+
	+	==== adminBeforeUserDelete ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminBeforeUserDelete',$u);</code>
	+	Cet événement est appelé avant la suppression d'un utilisateur.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| u \| integer \| identifiant de l'utilisateur \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminBeforeUserDelete($user_id)
	+	</code>
	+
	+	==== adminBeforeUserUpdate ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminBeforeUserUpdate',$cur,$user_id);</code>
	+	Cet événement est appelé avant la mise à jour d'un utilisateur.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| cur \| cursor \| curseur sur l'utilisateur \|
	+	\| user_id \| integer \| identifiant de l'utilisateur \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminBeforeUserUpdate($cur, $user_id)
	+	</code>
	+
	+	==== adminBlogPreferencesForm ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminBlogPreferencesForm',$core);</code>
	+	Permet d'ajouter des éléments au formulaire d'édition de préférences du blog.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| core \| dcCore \| référence vers l'objet core \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminBlogPreferencesForm(&$core)
	+	</code>
	+
	+	==== adminBlogPreferencesHeaders ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminBlogPreferencesHeaders').</code>
	+	Permet d'ajouter des éléments au header de la page de préférences du blog.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminBlogPreferencesHeaders()
	+	</code>
	+
	+
	+	==== adminPageHTMLHead ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminPageHTMLHead');</code>
	+	Permet d'ajouter des éléments au header de toute page de l'administration.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminPageHTMLHead()
	+	</code>
	+
	+
	+	==== adminPostForm ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminPostForm',isset($post) ? $post : null);</code>
	+	Permet d'ajouter des éléments au formulaire dans post.php (en dessous des notes)
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| post \| record \| record représentant le post \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminPostForm($post)
	+	</code>
	+
	+
	+	==== adminPostFormSidebar ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminPostFormSidebar',isset($post) ? $post : null);</code>
	+	Permet d'afficher des éléments dans la sidebar (colonne de droite) de la page post.php
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| post \| record \| record représentant le post \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminPostFormSidebar($post)
	+	</code>
	+
	+	Exemple d'utilisation :
	+	<code php>
	+	$core->addBehavior('adminPostFormSidebar',
	+	array('myBehavior','adminPostFormSidebar'));
	+
	+	class myBehavior
	+	{
	+	public static function adminPostFormSidebar(&$post)
	+	{
	+	# ne rien afficher si c'est un nouveau billet
	+	if (!isset($post->post_title)) {return;}
	+
	+	echo
	+	'<div>'.'<h3>'.__('Post title').'</h3>'.
	+	'<p>'.
	+	sprintf(__('This post title is <strong>%s</strong>'),
	+	$post->post_title).
	+	'</p>'.
	+	'</div>';
	+	}
	+	}
	+	</code>
	+
	+	==== adminPostNavLinks ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminPostNavLinks',isset($post) ? $post : null);</code>
	+	Permet d'afficher des éléments dans la zone de navigation (suivant/précédent) de la page post.php
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| post \| record \| record représentant le post \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminPostNavLinks($post)
	+	</code>
	+
	+	==== adminPostHeaders ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminPostHeaders').</code>
	+	Permet d'ajouter des headers à la page d'admin post.php.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminPostHeaders()
	+	</code>
	+
	+	==== adminCommentsHeaders ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminCommentsHeaders').</code>
	+	Permet d'ajouter des headers à la page d'admin comments.php.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminCommentsHeaders()
	+	</code>
	+
	+	==== adminPostsActions ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminPostsActions',$core,$posts,$action,$redir);</code>
	+	Permet d'ajouter le traitement d'une action définie par 'adminPostsActionsCombo' sur un post.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| core \| dcCore \| référence vers l'objet core \|
	+	\| posts \| record \| record décrivant le post \|
	+	\| action \| string \| identifiant de l'action \|
	+	\| redir \| string \| adresse de redirection après le traitement \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminPostsActions(&$core,$posts,$action,$redir)
	+	</code>
	+
	+	==== adminPostsActionsCombo ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminPostsActionsCombo',array(&$combo_action));</code>
	+	Permet d'ajouter des éléments dans la combo box d'action sur les posts.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| combo_action \| array \| le premier élément de ce tableau contient un tableau associatif des items (label => id) \|
	+
	+	Exemple de code :
	+	<code php>
	+	public static function adminPostsActionsCombo(&$args)
	+	{
	+	$args[0][__('add tags')] = 'tags';
	+	}
	+	</code>
	+
	+	==== adminPostsActionsContent ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminPostsActionsContent',$core,$action,$hidden_fields);</code>
	+	Permet d'afficher un formulaire pour l'action sur le post.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| core \| dcCore \| référence vers l'objet core \|
	+	\| action \| string \| identifiant de l'action \|
	+	\| hidden_fields \| string \| champs cachés à ajouter au formulaire
	+
	+	Exemple de code :
	+	<code php>
	+	public static function adminPostsActionsContent($core,$action,$hidden_fields)
	+	{
	+	if ($action == 'tags')
	+	{
	+	echo
	+	'<h2>'.__('Add tags to entries').'</h2>'.
	+	'<form action="posts_actions.php" method="post">'.
	+	'<p><label class="area">'.__('Tags to add:').' '.
	+	form::textarea('new_tags',60,3).
	+	'</label> '.
	+
	+	$hidden_fields.
	+	form::hidden(array('action'),'tags').
	+	'<input type="submit" value="'.__('save').'" /></p>'.
	+	'</form>';
	+	}
	+	}
	+	</code>\|
	+
	+	==== adminPreferencesForm ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminPreferencesForm',$core);</code>
	+	Cet événement permet d'ajouter des éléments au formulaire de la page preferences.php de l'admin.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| core \| dcCore \| référence vers l'objet core \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminPreferencesForm(&$core);
	+	</code>
	+
	+	==== adminPreferencesHeaders ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminPreferencesHeaders')</code>
	+	Cet événement est appelé lors de la génération des headers de la page preferences.php de l'admin. Ceci permet d'ajouter des headers à cette page.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminPreferencesHeaders();
	+	</code>
	+
	+	==== adminUserForm ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminUserForm',isset($rs) ? $rs : null);</code>
	+	Cet événement permet d'ajouter des éléments au formulaire de la page user.php de l'admin.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| rs \| record \| référence vers l'utilisateur courant \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminUserForm(&$rs);
	+	</code>
	+
	+	==== adminDashboardCommentDesc ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminDashboardCommentDesc', $core,array(&$str_comments_opt));</code>
	+	Cet événement permet d'ajouter des informations dans la description des commentaires sur le tableau de bord. Le dernier paramètre est un tableau contenant une référence vers une chaîne. Il faut concaténer à la fin de cette chaîne.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| core \| core \| référence à l'objet core \|
	+	\| param \| array \| tableau contenant une référence vers une chaîne à compléter \|
	+	Exemple de signature :
	+	<code php>
	+	function dashboard($core, $param)
	+	</code>
	+
	+	==== adminUserHeaders ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminUserHeaders')</code>
	+	Cet événement est appelé lors de la génération des headers de la page user.php de l'admin. Ceci permet d'ajouter des headers à cette page.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminUserHeaders();
	+	</code>
	+	==== adminBeforeLangInput ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('adminBeforeLangInput', $id, $default, array(&$return), $tabindex)</code>
	+	Ce behavior est appelé avant l'affichage d'un élément de saisie de langue. Il permet de surcharger la saisie de langue par défaut.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| id \| string \| id de l'input à générer \|
	+	\| default \| string \| élément par défaut \|
	+	\| return \| string \| référence vers la valeur de retour \|
	+	\| tabindex \| integer \| tabindex \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function adminBeforeLangInput($nid, $default, $input, $tabindex = '');
	+	</code>
	+
	+
	+	===== Behavior Core =====
	+
	+	==== coreBeforeCommentCreate ====
	+	Appel du behavior :
	+	<code php>$this->core->callBehavior('coreBeforeCommentCreate',$blog,$cur);</code>
	+	Cet événement est appelé avant la création d'un commentaire.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| blog \| dcBlog \| référence à l'objet blog \|
	+	\| cur \| cursor \| curseur sur le commentaire \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function coreBeforeCommentCreate(&$blog, &$cur);
	+	</code>
	+
	+
	+	==== coreAfterCommentCreate ====
	+	Appel du behavior :
	+	<code php>$this->core->callBehavior('coreAfterCommentCreate',$blog,$cur);</code>
	+	Cet événement est appelé après la création d'un commentaire.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| blog \| dcBlog \| référence à l'objet blog \|
	+	\| cur \| cursor \| curseur sur le commentaire \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function coreAfterCommentCreate(&$blog, &$cur);
	+	</code>
	+
	+
	+	==== coreAfterCommentUpdate ====
	+	Appel du behavior :
	+	<code php>$this->core->callBehavior('coreAfterCommentUpdate',$this,$cur,$rs);</code>
	+	Cet événement est appelé après la mise à jour d'un commentaire.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| blog \| dcBlog \| référence à l'objet blog \|
	+	\| cur \| cursor \| curseur sur le commentaire \|
	+	\| rs \| record \| record sur le commentaire \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function coreAfterCommentUpdate(&$blog, &$cur, $rs);
	+	</code>
	+
	+	==== coreBeforeCommentUpdate ====
	+	Appel du behavior :
	+	<code php>$this->core->callBehavior('coreBeforeCommentUpdate',$this,$cur,$rs);</code>
	+	Cet événement est appelé avant la mise à jour d'un commentaire.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| blog \| dcBlog \| référence à l'objet blog \|
	+	\| cur \| cursor \| curseur sur le commentaire \|
	+	\| rs \| record \| record sur le commentaire \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function coreBeforeCommentUpdate(&$blog, &$cur, $rs);
	+	</code>
	+
	+
	+	==== coreBlogConstruct ====
	+	Appel du behavior :
	+	<code php>$this->core->callBehavior('coreBlogConstruct',$this);</code>
	+	Cet événement est appelé à la création de l'objet dcBlog.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| blog \| dcBlog \| référence à l'objet blog \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function coreBlogConstruct(&$blog);
	+	</code>
	+
	+
	+	==== coreBlogGetComments ====
	+	Appel du behavior :
	+	<code php>$this->core->callBehavior('coreBlogGetComments',$rs);</code>
	+	Cet événement est appelé à chaque fois que l'on appelle $blog->getComments. L'événement est lancé à la fin de la méthode et permet d'étendre les informations renvoyées par getComments.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| rs \| recordSet \| Référence à un objet recordSet \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function coreBlogGetComments(&$rs);
	+	</code>
	+
	+	==== coreBlogGetPosts ====
	+	Appel du behavior :
	+	<code php>$this->core->callBehavior('coreBlogGetPosts',$rs);</code>
	+	Cet événement est appelé à chaque fois que l'on appelle $blog->getPosts. L'événement est lancé à la fin de la méthode et permet d'étendre les informations renvoyées par getPosts.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| rs \| recordSet \| Référence à un objet recordSet \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function coreBlogGetPosts(&$rs);
	+	</code>
	+
	+	==== coreInitWikiComment ====
	+	Appel du behavior :
	+	<code php>$this->callBehavior('coreInitWikiComment',$this->wiki2xhtml);</code>
	+	Cet événement est appelé lors de l'initialisation de wiki2xhtml pour un commentaire.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| wiki2xhtml \| wiki2xhtml \| Référence à l'objet wiki2xhtml \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function coreInitWikiComment(&$wiki2xhtml);
	+	</code>
	+
	+
	+
	+	==== coreInitWikiSimpleComment ====
	+	Appel du behavior :
	+	<code php>$this->callBehavior('coreInitWikiSimpleComment',$this->wiki2xhtml);</code>
	+	Cet événement est appelé lors de l'initialisation de wiki2xhtml pour un commentaire simple (syntaxe basique).
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| wiki2xhtml \| wiki2xhtml \| Référence à l'objet wiki2xhtml \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function coreInitWikiSimpleComment(&$wiki2xhtml);
	+	</code>
	+
	+
	+	==== corePostSearch ====
	+	Appel du behavior:
	+	<code php>$this->core->callBehavior('corePostSearch',$this->core,array(&$words,&$strReq,&$params))</code>
	+	Cet événement est appelé lorsque des paramètres de recherche de billet sont passés à dcBlog::getPosts().
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| core \| dcCore \| Référence à l'instance $core \|
	+	\| p \| array \| Tableau contenant des références aux variables $words, $strReq et $params de la méthode dcBlog::getPosts(). $words doit être vidé à la fin de cette fonction. \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function corePostSearch(&$core,$p)
	+	</code>
	+
	+	==== coreWikiPostInit ====
	+	Appel du behavior :
	+	<code php>$this->callBehavior('coreInitWikiPost',$this->wiki2xhtml);</code>
	+	Cet événement est appelé lors de l'initialisation de wiki2xhtml pour un post.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| wiki2xhtml \| wiki2xhtml \| Référence à l'objet wiki2xhtml \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function coreInitWikiPost(&$wiki2xhtml);
	+	</code>
	+
	+	==== coreAfterPostContentFormat ====
	+	Appel du behavior :
	+	<code php>
	+	$content = array('excerpt' => &$excerpt, 'content' => &$content, 'excerpt_xhtml' => &$excerpt_xhtml, 'content_xhtml' => &$content_xhtml);
	+	$core->callBehavior('coreAfterPostContentFormat', $content);
	+	</code>
	+	Cet événement est appelé sur le contenu d'un post, après le passage du formateur et du filtre xhtml. Le tableau associatif en paramètre possède des références vers les différents éléments constitutifs du post.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| $content \| array \| Tableau associatif\|
	+
	+	Exemple de signature :
	+	<code php>
	+	function reformat($content);
	+	</code>
	+
	+	===== Behavior Plugin Import/Export =====
	+
	+	==== exportFull ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('exportFull',$core,$exp);</code>
	+	Cet événement est appelé lors de l'un export complet.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| core \| dcCore \| Référence à l'objet core \|
	+	\| exp \| dbExport \| Référence à l'objet dbExport \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function exportSingle(&$core,$exp);
	+	</code>
	+
	+	==== exportSingle ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('exportSingle',$core,$exp,$blog_id);</code>
	+	Cet événement est appelé lors de l'un export simple (par opposition à un export complet).
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| core \| dcCore \| Référence à l'objet core \|
	+	\| exp \| dbExport \| Référence à l'objet dbExport \|
	+	\| blog_id \| string \| identifiant du blog \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function exportSingle(&$core,$exp, $blog_id);
	+	</code>
	+
	+
	+	==== importFull ====
	+	Appel du behavior :
	+	<code php>$this->core->callBehavior('importFull',$line,$this,$this->core);</code>
	+	Cet événement est appelé lors de l'un import complet sur chaque ligne de l'import.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| line \| backupFileItem \| objet représentant une ligne de fichier de backup \|
	+	\| import \| dcImport \| Référence à l'objet dcImport \|
	+	\| core \| dcCore \| Référence à l'objet core \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function importFull($line,$import,$core);
	+	</code>
	+
	+	==== importInit ====
	+	Appel du behavior :
	+	<code php>$this->core->callBehavior('importInit',$this,$this->core);</code>
	+	Cet événement est appelé lors de l'initialisation d'un import.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| import \| dcImport \| Référence à l'objet dcImport \|
	+	\| core \| dcCore \| Référence à l'objet core \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function importInit($import,$core);
	+	</code>
	+
	+	==== importPrepareDC12 ====
	+	Appel du behavior :
	+	<code php>$this->core->callBehavior('importPrepareDC12',$line,$this,$this->core);</code>
	+	Cet événement est appelé lors de l'import d'une archive de blog DC12 sur chaque ligne de l'import.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| line \| backupFileItem \| objet représentant une ligne de fichier de backup \|
	+	\| import \| dcImport \| Référence à l'objet dcImport \|
	+	\| core \| dcCore \| Référence à l'objet core \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function importPrepareDC12($line,$import,$core);
	+	</code>
	+	==== importSingle ====
	+	Appel du behavior :
	+	<code php>$this->core->callBehavior('importSingle',$line,$this,$this->core);</code>
	+	Cet événement est appelé lors de l'import d'une archive de blog simple (par opposition à une archive complète) sur chaque ligne de l'import.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| line \| backupFileItem \| objet représentant une ligne de fichier de backup \|
	+	\| import \| dcImport \| Référence à l'objet dcImport \|
	+	\| core \| dcCore \| Référence à l'objet core \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function importSingle($line,$import,$core);
	+	</code>
	+
	+	===== Behavior Plugin Widgets =====
	+
	+
	+	==== initDefaultWidgets ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('initDefaultWidgets',$__widgets,$__default_widgets);</code>
	+	Cet événement est appelé lors de l'initialisation des widgets par défaut
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| widgets \| dcWidgets \| objet gérant les widgets du blog \|
	+	\| default_widgets \| array \| tableau contenant les informations relatives aux widgets par défaut \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function initWidgets(&$widgets, &$default_widgets);
	+	</code>
	+
	+
	+	==== initWidgets ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('initWidgets',$__widgets);</code>
	+	Cet événement est appelé lors de l'initialisation des widgets
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| widgets \| dcWidgets \| objet gérant les widgets du blog \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function initWidgets(&$__widgets);
	+	</code>
	+
	+	===== Behavior Page Login =====
	+
	+	==== loginPageHTMLHead ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('loginPageHTMLHead');</code>
	+
	+	Cet événement est appelé lors de la génération du html de la page de login
	+
	+	Exemple de signature :
	+	<code php>
	+	function loginPageHTMLHead();
	+	</code>
	+
	+	===== Behavior Plugins =====
	+
	+	==== pluginAfterDelete ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('pluginsAfterDelete', $plugin);</code>
	+
	+	Cet événement est appelé après la suppression d'un plugin.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| plugin \| array \| Tableau associatif représentant le plugin \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function pluginsAfterDelete($plugin);
	+	</code>
	+
	+	==== pluginBeforeDelete ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('pluginsBeforeDelete', $plugin);</code>
	+
	+	Cet événement est appelé avant la suppression d'un plugin.
	+	^ Paramètre ^ Type ^ Description ^
	+	\| plugin \| array \| Tableau associatif représentant le plugin \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function pluginsBeforeDelete($plugin);
	+	</code>
	+
	+	==== pluginsToolsTabs ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('pluginsToolsTabs',$core);</code>
	+
	+	Cet événement est appelé lors de l'affichage de FIXME
	+	^ Paramètre ^ Type ^ Description ^
	+	\| core \| dcCore \| Référence à l'objet core \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function pluginsToolsTabs(&$core);
	+	</code>
	+
	+	===== Behavior Public =====
	+
	+
	+
	+	==== publicHeadContent ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('publicHeadContent',$core,$_ctx);</code>
	+	Cet événement est appelé à la fin de l'en-tête HTML des pages publiques.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| core \| dcCore \| Object core \|
	+	\| _ctx \| context \| Pile de contexte \|
	+
	+	Cet événement se trouve dans un template, la signature sera par exemple :
	+	<code>{{tpl:SysBehavior behavior="publicHeadContent"}}</code>
	+
	+	==== publicAfterCommentCreate ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('publicAfterCommentCreate',$cur,$comment_id);</code>
	+
	+
	+	Cet événement est appelé après la création d'un commentaire.
	+	^ Paramètre ^ Type ^ Description ^
	+	\| cur \| cursor \| Curseur sur le commentaire \|
	+	\| comment_id \| integer \| Identifiant du commentaire \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function publicAfterCommentCreate(&$cur, $comment_id);
	+	</code>
	+
	+	==== publicAfterDocument ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('publicAfterDocument',$core);</code>
	+
	+	Cet événement est appelé après la génération de la page.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| core \| dcCore \| Référence à l'objet core \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function publicAfterDocument(&$core);
	+	</code>
	+
	+	==== publicAfterTrackbackCreate ====
	+	Appel du behavior :
	+	<code php>$this->core->callBehavior('publicAfterTrackbackCreate',$cur,$comment_id);</code>
	+
	+	Cet événement est appelé après la création d'un trackback.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| cur \| cursor \| Curseur sur le commentaire \|
	+	\| comment_id \| integer \| Identifiant du commentaire \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function publicAfterTrackbackCreate(&$cur, $comment_id);
	+	</code>
	+
	+	==== publicBeforeCommentCreate ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('publicBeforeCommentCreate',$cur);</code>
	+
	+	Cet événement est appelé avant la création d'un commentaire.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| cur \| cursor \| Curseur sur le commentaire \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function publicBeforeCommentCreate(&$cur);
	+	</code>
	+
	+	==== publicBeforeDocument ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('publicBeforeDocument',$core);</code>
	+
	+	Cet événement est appelé avant la génération de la page.
	+	^ Paramètre ^ Type ^ Description ^
	+	\| core \| dcCore \| Référence à l'objet core \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function publicBeforeDocument(&$core);
	+	</code>
	+
	+	==== publicBeforeTrackbackCreate ====
	+	Appel du behavior :
	+	<code php>$this->core->callBehavior('publicBeforeTrackbackCreate',$cur);</code>
	+
	+	Cet événement est appelé avant la création d'un trackback.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| cur \| cursor \| Curseur sur le commentaire \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function publicBeforeTrackbackCreate(&$cur);
	+	</code>
	+
	+
	+
	+	==== publicPrepend ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('publicPrepend',$core);</code>
	+
	+	Cet événement est appelé lors de l'exécution du prepend public.
	+	FIXME expliquer le principe du prepend
	+	^ Paramètre ^ Type ^ Description ^
	+	\| core \| dcCore \| Référence à l'objet core \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function publicPrepend(&$core);
	+	</code>
	+
	+
	+	==== publicBeforeLangDisplay ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('publicBeforeLangDisplay',$code,array(&$disp_lang));</code>
	+	Cet événement est appelé avant l'affichage d'une langue côté public. Il permet de surcharger l'affichage des langues.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| code \| string \| code de langue ISO 639-1 \|
	+	\| disp_lang \| string \| référence vers la chaîne à afficher \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function publicBeforeLangDisplay($code, $disp_lang)
	+	</code>
	+
	+	===== Behavior Templates =====
	+
	+	==== templateBeforeBlock ====
	+	Appel du behavior :
	+	<code php>$res = $this->core->callBehavior('templateBeforeBlock',$this->core,$b,$attr);</code>
	+
	+	Cet événement est lancé avant tout block dans le système de template.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| core \| dcCore \| Référence à l'objet core \|
	+	\| b \| string \| Identifiant du bloc \|
	+	\| attr \| array \| Tableau associatif des attributs \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function templateBeforeBlock(&$core,$b,$attr);
	+	</code>
	+
	+
	+
	+	==== templateBeforeValue ====
	+	Appel du behavior :
	+	<code php>$res = $this->core->callBehavior('templateBeforeValue',$this->core,$v,$attr);</code>
	+
	+	Cet événement est lancé avant toute valeur dans le système de template. FIXME ??
	+	^ Paramètre ^ Type ^ Description ^
	+	\| core \| dcCore \| Référence à l'objet core \|
	+	\| v \| string \| Valeur \|
	+	\| attr \| array \| Tableau associatif des attributs \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function templateBeforeValue(&$core,$v,$attr);
	+	</code>
	+
	+
	+	==== tplBeforeData ====
	+	Appel du behavior :
	+	<code php>$res = $this->core->callBehavior('tplBeforeData',$this->core);</code>
	+
	+	Cet événement est lancé avant toute donnée dans le système de template. FIXME ??
	+	Il peut être utilisé conjointement à tplAfterData pour réaliser facilement un système de cache.
	+	^ Paramètre ^ Type ^ Description ^
	+	\| core \| dcCore \| Référence à l'objet core \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function tplBeforeData(&$core);
	+	</code>
	+
	+
	+	==== tplAfterData ====
	+	Appel du behavior :
	+	<code php>$res = $this->core->callBehavior('tplAfterData',$this->core,$r);</code>
	+
	+	Cet événement est lancé après toute donnée dans le système de template. FIXME ??
	+	^ Paramètre ^ Type ^ Description ^
	+	\| core \| dcCore \| Référence à l'objet core \|
	+	\| r \| string \| Donnée de retour du système de template \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function tplAfterData(&$core, $r);
	+	</code>
	+
	+	===== Behavior Theme =====
	+
	+	==== themeAfterDelete ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('themeAfterDelete',$theme);</code>
	+	Cet événement est appelé après la suppression d'un thème.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| theme \| array \| Tableau associatif contenant les informations du thème \|
	+
	+	Exemple de signature
	+	<code php>
	+	function themeAfterDelete($theme);
	+	</code>
	+
	+
	+	==== themeBeforeDelete ====
	+	Appel du behavior :
	+	<code php>$core->callBehavior('themeBeforeDelete',$theme);</code>
	+	Cet événement est appelé avant la suppression d'un thème.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| theme \| array \| Tableau associatif contenant les informations du thème \|
	+
	+	Exemple de signature
	+	<code php>
	+	function themeBeforeDelete($theme);
	+	</code>
	+
	+	===== Behavior XML-RPC =====
	+
	+	==== xmlrpcAfterEditPost ====
	+	Appel du behavior :
	+	<code php>$this->core->callBehavior('xmlrpcAfterEditPost',$this,$post_id,$cur,$content,$struct,$publish);</code>
	+
	+	Cet événement est lancé après toute édition de post par xmlrpc.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| x \| dcXmlRpc \| Référence vers la classe xmlrpc \|
	+	\| post_id \| integer \| Identifiant du post \|
	+	\| cur \| cursor \| Curseur sur le post \|
	+	\| content \| string \| Contenu du post \|
	+	\| struct \| array \| Tableau associatif contenant les métadonnées du post \|
	+	\| publish \| boolean \| Post publié? \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function xmlrpcAfterEditPost($x,$post_id,&$cur,$content,$struct,$publish);
	+	</code>
	+
	+	==== xmlrpcAfterNewPost ====
	+	Appel du behavior :
	+	<code php>$this->core->callBehavior('xmlrpcAfterNewPost',$this,$post_id,$cur,$content,$struct,$publish);</code>
	+
	+	Cet événement est lancé après toute création de post par xmlrpc.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| x \| dcXmlRpc \| Référence vers la classe xmlrpc \|
	+	\| post_id \| integer \| Identifiant du post \|
	+	\| cur \| cursor \| Curseur sur le post \|
	+	\| content \| string \| Contenu du post \|
	+	\| struct \| array \| Tableau associatif contenant les métadonnées du post \|
	+	\| publish \| boolean \| Post publié? \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function xmlrpcAfterNewPost($x,$post_id,&$cur,$content,$struct,$publish);
	+	</code>
	+
	+	==== xmlrpcAfterPublishPost ====
	+	Appel du behavior :
	+	<code php>$this->core->callBehavior('xmlrpcAfterPublishPost',$this,$post_id);</code>
	+
	+	Cet événement est lancé après toute publication de post par xmlrpc.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| x \| dcXmlRpc \| Référence vers la classe xmlrpc \|
	+	\| post_id \| integer \| Identifiant du post \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function xmlrpcAfterPublishPost(&$x,$post_id);
	+	</code>
	+
	+	==== xmlrpcBeforeEditPost ====
	+	Appel du behavior :
	+	<code php>$this->core->callBehavior('xmlrpcBeforeEditPost',$this,$post_id,$cur,$content,$struct,$publish);</code>
	+
	+	Cet événement est lancé avant toute édition de post par xmlrpc.
	+	^ Paramètre ^ Type ^ Description ^
	+	\| x \| dcXmlRpc \| Référence vers la classe xmlrpc \|
	+	\| post_id \| integer \| Identifiant du post \|
	+	\| cur \| cursor \| Curseur sur le post \|
	+	\| content \| string \| Contenu du post \|
	+	\| struct \| array \| Tableau associatif contenant les métadonnées du post \|
	+	\| publish \| boolean \| Post publié? \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function xmlrpcBeforeEditPost($x,$post_id,&$cur,$content,$struct,$publish);
	+	</code>
	+
	+	==== xmlrpcBeforeNewPost ====
	+	Appel du behavior :
	+	<code php>$this->core->callBehavior('xmlrpcBeforeNewPost',$this,$cur,$content,$struct,$publish);</code>
	+
	+	Cet événement est lancé avant toute création de post par xmlrpc.
	+	^ Paramètre ^ Type ^ Description ^
	+	\| x \| dcXmlRpc \| Référence vers la classe xmlrpc \|
	+	\| cur \| cursor \| Curseur sur le post \|
	+	\| content \| string \| Contenu du post \|
	+	\| struct \| array \| Tableau associatif contenant les métadonnées du post \|
	+	\| publish \| boolean \| Post publié? \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function xmlrpcBeforeNewPost($x,&$cur,$content,$struct,$publish);
	+	</code>
	+
	+	==== xmlrpcBeforePublishPost ====
	+	Appel du behavior :
	+	<code php>$this->core->callBehavior('xmlrpcBeforePublishPost',$this,$post_id);</code>
	+
	+	Cet événement est lancé avant toute publication de post par xmlrpc.
	+	^ Paramètre ^ Type ^ Description ^
	+	\| x \| dcXmlRpc \| Référence vers la classe xmlrpc \|
	+	\| post_id \| integer \| Identifiant du post \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function xmlrpcBeforePublishPost(&$x,$post_id);
	+	</code>
	+
	+	==== xmlrpcGetPostInfo ====
	+	Appel du behavior :
	+	<code php>$this->core->callBehavior('xmlrpcGetPostInfo',$this,$type,array(&$res));</code>
	+
	+	Ajout de métadonnées dans la structure décrivant un post. Ces métadonnées sont ajoutées dans le paramètre res.
	+	Cet événement est appelé à chaque fois qu'un client demande des informations sur un post.
	+
	+	^ Paramètre ^ Type ^ Description ^
	+	\| x \| dcXmlRpc \| Référence vers la classe xmlrpc \|
	+	\| type \| string \| Type d'api ('blogger', 'mt' ou 'mw') \|
	+	\| res \| array \| Contient la référence à un tableau associatif contenant les infos d'un post \|
	+
	+	Exemple de signature :
	+	<code php>
	+	function xmlrpcGetPostInfo(&$x,$type,&$res);
	+	</code>

2.6:resources:plugins:changelogs

Wed, 23 Oct 2013 22:41:13 +0200

1382259102		Version actuelle
Ligne 1:		Ligne 1:
	====== Notes de changements de version pour les plugins ======		====== Notes de changements de version pour les plugins ======

		+	===== Dotclear 2.6 =====
		+
		+	Sortie : à venir.
		+
		+	[[playground:2-5-to-2-6#les-nouveautes-de-25-a-26\|Les nouveautés de 2.5 à 2.6]]
	===== Dotclear 2.5 =====		===== Dotclear 2.5 =====

2.6:resources:plugins:columns

Wed, 16 Oct 2013 09:56:41 +0200

	Version actuelle
Ligne 1:	Ligne 1:
	+	FIXME

	+	À effacer.
	+
	+	Voir [[.:admin:columns\|columns]].

2.6:resources:plugins:dashboard

Wed, 16 Oct 2013 09:56:41 +0200

	Version actuelle
Ligne 1:	Ligne 1:
	+	====== Ajouter une icône au tableau de bord ======
	+
	+	===== Introduction =====
	+
	+	Parfois, un plugin peut avoir besoin d'afficher directement dans le tableau de bord des informations relatives à son fonctionnement. Par exemple, le plugin daInstaller ajoute une icône de couleur orange lorsque des mises à jour sont disponibles. Cette page va vous expliquer comment procéder pour arriver à ce résultat.
	+
	+	===== Ajout d'une icône de favori =====
	+
	+	Dotclear 2.3 introduit une nouvelle interface utilisateur qui laisse aux utilisateurs la possibilité de définir leurs propres icônes favorites. Voici comment un plugin peut ajouter une icône à la liste des icônes disponibles :
	+
	+	Dans le fichier ''_admin.php'' du plugin :
	+
	+	<code php>
	+	$core->addBehavior('adminDashboardFavs',array('myPluginBehaviors','dashboardFavs'));
	+
	+	class myPluginBehaviors
	+	{
	+	public static function dashboardFavs($core,$favs)
	+	{
	+	$favs['myplugin'] = new ArrayObject(array(
	+	'myplugin',
	+	__('My Plugin'),
	+	'plugin.php?p=myplugin',
	+	'index.php?pf=myplugin/icon.png',
	+	'index.php?pf=myplugin/icon-big.png',
	+	'usage,contentadmin',
	+	null,
	+	null));
	+	}
	+	}
	+	</code>
	+
	+	Les arguments à fournir lors de l'appel à la fonction ''dashboardFavs()'' sont, dans l'ordre :
	+
	+	* Identificateur du favori (sans espace, accents, …), doit être unique
	+	* Libellé du favori
	+	* URL du favori (ça peut être à peu près n'importe quoi)
	+	* URL de l'icône en 16x16 pixels
	+	* URL de l'icône en 64x64 pixels
	+	* Permissions (mettre null pour superadmin seulement, mettre '*' pour autoriser tout le monde)
	+	* id (optionnel) ajouté sur l'item du menu favori (à gauche)
	+	* class (optionnel) ajouté sur l'item du menu favori (à gauche)
	+
	+	Un plugin peut inscrire autant de favoris qu'il le souhaite. Les icônes utilisées par Dotclear sont issues d'un lot d'icônes dessiné spécialement pour Dotclear, voir [[http://fr.dotclear.org/blog/post/2011/11/13/Dotclear-2.4\|le billet d'annonce de Dotclear 2.4]] pour davantage d'informations.
	+
	+	De plus le plugin peut personnaliser le titre, la petite ou la grande icône d'un favori inscrit et affiché sur le tableau de bord. Voici comment :
	+
	+	Dans le fichier ''_admin.php'' du plugin :
	+
	+	<code php>
	+	$core->addBehavior('adminDashboardFavsIcon',array('myPluginBehaviors','dashboardFavsIcon'));
	+
	+	class myPluginBehaviors
	+	{
	+	public static function dashboardFavsIcon($core,$name,$icon)
	+	{
	+	if ($name == 'myplugin')
	+	{
	+	$icon[0] = __('My plugin');
	+	$icon[1] = 'plugin.php?p=myplugin';
	+	$icon[2] = 'index.php?pf=myplugin/icon-big.png';
	+	}
	+	}
	+	}
	+	</code>
	+
	+	Les arguments fournis lors de l'appel à la fonction ''dashboardFavsIcon()'' sont, dans l'ordre :
	+
	+	* Identificateur du favori (sans espace, accents, …), correspond à celui fourni lors de l'inscription
	+	* Un tableau contenant :
	+	* Le titre du favori
	+	* L'URL du favori
	+	* URL de l'icône en 64x64 pixels
	+
	+	Le nom du lien, l'URL et l'image peuvent être modifiées en fonction des tests ajoutés dans la fonction ''dashboardFavsIcon()''
	+
	+
	+	<note related>
	+	Le plugin [[admin#telecharger-un-plugin-exemple\|adminExample]] montre un exemple d’utilisation de ce code.
	+	</note>

2.6:resources:plugins:files

Thu, 31 Oct 2013 15:06:06 +0200

1381910201		Version actuelle
Ligne 11:		Ligne 11:
	* _xmlrpc.php : interface xmlrpc du plugin.		* _xmlrpc.php : interface xmlrpc du plugin.
	* [[services#creation-du-service\|_services.php]] : contiendra tous les services //Ajax// utilisés par le plugin		* [[services#creation-du-service\|_services.php]] : contiendra tous les services //Ajax// utilisés par le plugin
-	* [[admin#structure-minimale\|index.php]] : contiendra la page d'administration du plugin.	+	* [[admin#indexphp\|index.php]] : contiendra la page d'administration du plugin.
	* style.css : contiendra les éventuelles règles CSS du plugin		* style.css : contiendra les éventuelles règles CSS du plugin
	* icon.png : l'icône du plugin.		* icon.png : l'icône du plugin.

2.6:resources:plugins:help

Wed, 16 Oct 2013 09:56:41 +0200

1379364841		Version actuelle
Ligne 7:		Ligne 7:
	Exemple avec l'onglet plié :		Exemple avec l'onglet plié :

-	{{:2.0:resources:plugins:help:folded.png?300\|}}	+	{{:2.6:resources:plugins:help:folded.png?760\|}}

	Et déplié :		Et déplié :

-	{{:2.0:resources:plugins:help:unfolded.png?300\|}}	+	{{:2.6:resources:plugins:help:unfolded.png?760\|}}

	==== Mise en place ====		==== Mise en place ====
Ligne 89:		Ligne 89:
	===== Aide intégrée =====		===== Aide intégrée =====

-	{{:2.0:resources:plugins:help:form-note.png\|}}	+	{{:2.6:resources:plugins:help:form-note.png\|}}

	Pour intégrer de l'aide aux formulaires, on peut utiliser la classe ''form-note'' pour les paragraphes :		Pour intégrer de l'aide aux formulaires, on peut utiliser la classe ''form-note'' pour les paragraphes :

2.6:resources:plugins:jstoolbar

Wed, 16 Oct 2013 09:56:41 +0200

	Version actuelle
Ligne 1:	Ligne 1:
	+	====== Ajouter un élément aux barres d'outils des billets ======

	+	===== Introduction =====
	+
	+	Il existe trois format de saisie par défaut dans Dotclear et donc trois barre d'outils d’édition. Mais des plugins peuvent y ajouter leurs propres syntaxes et auront donc leurs propres barre d'outils.
	+
	+	Vous pouvez ajouter à l'une ou l'autre de ces barres d'outils des boutons et des combo-box qui agiront sur le contenu du billets, ou sur ses contenus annexes.
	+
	+	===== Structure minimale =====
	+
	+	==== _admin.php ====
	+
	+	Un behavior doit être déclaré dans le fichier ''_admin.php'' du plugin, pour charger votre script js dans la page post.php :
	+
	+	<code php>
	+	$core->addBehavior('adminPostHeaders','postHeaders');
	+
	+	function postHeaders() {
	+	return '<script type="text/javascript" src="index.php?pf=monSuperPlugin/post.js"></script>';
	+	}
	+	</code>
	+
	+	==== js/post.js ====
	+
	+	<code javascript>
	+	jsToolBar.prototype.elements.monSuperPluginSpace = {
	+	type: 'space',
	+	context = 'post',
	+	format:{ wiki:true }
	+	};
	+
	+	jsToolBar.prototype.elements.truc = {
	+	type: 'button',
	+	context: 'post',
	+	title: 'Truc',
	+	icon: 'index.php?pf=monSuperPlugin/img/truc.png',
	+	fn: {
	+	wiki: function() {
	+	this.encloseSelection('','',function(str) {
	+	if (str == '') {
	+	window.alert(dotclear.msg.no_selection);
	+	return '';
	+	}
	+	if (str.indexOf(',') != -1) {
	+	return str;
	+	} else {
	+	window.dc_tag_editor.addMeta(str);
	+	return '['+str+'\|monSuperPlugin:'+str+']';
	+	}
	+	});
	+	}
	+	}
	+	};
	+	</code>
	+
	+	===== Explication =====
	+
	+	==== Espaceur ====
	+
	+	La plupart du temps vous ajouterez votre bouton à la suite d'autre, on commence donc par mettre un espaceur.
	+	<code javascript>
	+	jsToolBar.prototype.elements.monSuperPluginSpace
	+	</code>
	+	Le type //space// pour créer un espace.\\
	+	On choisit le context //post// pour afficher notre espace uniquement dans les billets.\\
	+	Le format //wiki// pour que l'espace s'affiche sur la barre d'outil en syntaxe wiki uniquement.\\
	+
	+	==== Button ====
	+
	+	Ensuite on peux ajouter notre bouton appeler "truc".
	+	<code javascript>
	+	jsToolBar.prototype.elements.truc
	+	</code>
	+	On choisit le context //post// pour afficher notre bouton uniquement dans les billets.\\
	+	Le type //bouton//.\\
	+	Le title qui s'affichera au survole.
	+	Un icon indispensable pour un bouton.
	+	Et fn est la fonction qui s’exécutera quand on cliquera sur le bouton.
	+
	+	Tout cela sera détaillé pas plus tard que maintenant
	+
	+	===== Button =====
	+
	+	Pour déclaré un bouton il faut le faire de cette manière.
	+	<code javascript>
	+	jsToolBar.prototype.elements.truc = {};
	+	</code>
	+
	+	On déclare ensuite les différents attributs :
	+
	+	type = button
	+
	+	title : apparait au survole.
	+
	+	icon: Indispensable pour illustré le bouton.
	+	L'url doit être de cette forme :
	+	<code>
	+	index.php?pf=dossier_du_plugin/icon.png
	+	</code>
	+
	+	context : Permet de choisir le type d'entrée ou apparaitra le bouton, post ou page.
	+
	+	disabled : false ou true pour désactivé le bouton dans certaine condition.
	+
	+	fn :
	+
	+	///
	+
	+	==== type ====
	+
	+	Trois type sont disponible :
	+	* button - Permet de créer un bouton.
	+	* combo - Permet de créer une combo-box.
	+	* space - Permet de créer un espace.

2.6:resources:plugins:prefs

Wed, 16 Oct 2013 09:56:41 +0200

	Version actuelle
Ligne 1:	Ligne 1:
	+	====== Les préférences utilisateurs ======

	+	===== Enregistrer une préférence =====
	+
	+	Il faut d'abord sélectionner le //workspace// (espace de travail) des préférences grâce à la fonction ''addWorkSpace()'' :
	+
	+	<code php>
	+	$core->auth->user_prefs->addWorkSpace('example');
	+	</code>
	+
	+	<note>Le paramètre de addWorkspace() ne doit contenir que des chiffres ou des lettres sans accent.
	+
	+	Permis : [a-zA-Z][a-zA-Z0-9]
	+
	+	Il est conseillé d'utiliser le nom du plugin comme //workspace// pour éviter que 2 plugins n'aient le même //workspace//.</note>
	+
	+	Pour sauvegarder une préférence on utilise la fonction ''put()'', dont les paramètres sont :
	+	- le nom de la préférence (une chaîne de caractères contenant uniquement des chiffres ou des lettres sans accent et ''_'')
	+	- sa valeur
	+	- son type (une chaîne de caractères) (facultatif mais recommandé pour éviter les ambiguïtés)
	+	- son label (une chaîne de caractères) (facultatif)
	+	- un booléen : écraser l'ancienne valeur (valeur par défaut : oui) (facultatif)
	+	- un booléen : le paramètre est global (valeur par défaut : non) (facultatif)
	+
	+	==== Example avec une chaîne de caractères avec un label ====
	+
	+	<code php>
	+	# création du workspace
	+	$core->auth->user_prefs->addWorkSpace('example');
	+	# l'objet $core->auth->user_prefs->example a été créé
	+
	+	# enregistrement de la préférence dans le workspace example
	+	$core->auth->user_prefs->example->put('pref_name', __('Hello World!'), 'string', 'My label');
	+	</code>
	+
	+	Il est possible d'utiliser [[http://php.net/manual/fr/language.references.php\|l'assignation par référence]] pour faciliter l'accès aux préférences :
	+
	+	<code php>
	+	# création du workspace
	+	$core->auth->user_prefs->addWorkSpace('example');
	+
	+	# assignation par référence, $example_prefs pointe vers le workspace nouvellement créé
	+	$example_prefs =& $core->auth->user_prefs->example;
	+
	+	# enregistrement de la préférence
	+	$example_prefs->put('pref_name', __('Hello World!'), 'string', 'My label');
	+	</code>
	+
	+	==== Les différents types de préférence ====
	+
	+	Enregistrer un nombre flottant :
	+
	+	<code php>
	+	$core->auth->user_prefs->example->put('pi', 3.14159265, 'float');
	+	</code>
	+
	+	Enregistrer un nombre entier :
	+
	+	<code php>
	+	$core->auth->user_prefs->example->put('nb_entries', 217, 'integer');
	+	</code>
	+
	+	Enregistrer un booléen :
	+
	+	<code php>
	+	$core->auth->user_prefs->example->put('is_valid', true, 'boolean');
	+	</code>
	+
	+	Enregistrer une chaîne de caractères :
	+
	+	<code php>
	+	$core->auth->user_prefs->example->put('title', __('Hello World!'), 'string');
	+	</code>
	+
	+	<note warning>
	+	Pour stocker une chaîne de caractères avec plusieurs lignes, utilisez la fonction ''[[http://fr.php.net/manual/fr/function.base64-encode.php\|base64_encode()]]'' lors de l'enregistrement et ''[[http://fr.php.net/manual/fr/function.base64-decode.php\|base64_decode()]]'' lors de la lecture du paramètre. Ceci préservera les retours à la ligne lors de l'édition de [[:2.0:admin:aboutconfig\|about:config]].
	+	</note>
	+
	+	===== Lire une préférence =====
	+
	+	Une préférence est assignée à la variable $core->auth->user_prefs->nom du workspace->nom de la préférence, par exemple :
	+
	+	<code php>
	+	$string = $core->auth->user_prefs->example->title;
	+	</code>
	+
	+	===== Effacer une préférence =====
	+
	+	Il faut utiliser la fonction ''drop()'' avec l'identifiant de la préférence comme argument :
	+
	+	<code php>
	+	$core->auth->user_prefs->addWorkspace('example');
	+
	+	# création de la préférence
	+	$core->auth->user_prefs->example->put('title', __('Hello World!'), 'string');
	+
	+	# suppression de la préférence
	+	$core->auth->user_prefs->example->drop('title');
	+	</code>

2.6:resources:plugins:public-page

Wed, 16 Oct 2013 09:56:41 +0200

1379364841		Version actuelle
Ligne 14:		Ligne 14:
	/* Author */ 'Dotclear Documentation',		/* Author */ 'Dotclear Documentation',
	/* Version */ '0.1',		/* Version */ '0.1',
-	/* Permissions */ 'usage,contentadmin'	+	*/ Properties / array(*
		+	/* Permissions / 'permissions' =>* 'usage,contentadmin',
		+	*/ Configuration / 'standalone_config' => false,*
		+	*/ Type / 'type' => 'plugin'*
		+	)
	);		);
	?>		?>

2.6:resources:plugins:public

Wed, 16 Oct 2013 09:56:41 +0200

	Version actuelle
Ligne 1:	Ligne 1:
	+	FIXME

	+	À effacer.
	+
	+	Voir [[.:public-page\|public-page]].

2.6:resources:plugins:services

Wed, 16 Oct 2013 09:56:41 +0200

	Version actuelle
Ligne 1:	Ligne 1:
	+	====== Créer un service Ajax ======

	+	===== Qu'est ce qu'un service Ajax? =====
	+
	+	Un service Ajax permet de collecter et retourner des données sous forme d'un fichier XML. Ce service sera appelé via une requête Ajax de façon dynamique et sera ensuite traité par du Javascript pour mettre à jour une partie d'une page de l'administration de Dotclear. C'est par exemple ce qui est utilisé pour afficher la liste des tags lors de la rédaction d'un billet. Lors du clic sur le lien __//Voir les tags//__, le service Ajax associé est appelé, retourne la liste des tags qui est ensuite affichée à l'utilisateur.
	+
	+	===== Pré-requis =====
	+
	+	Pour créer un service Ajax, il faut :
	+	* Avoir créer une fonction PHP publique et statique. C'est cette fonction qui va faire en sorte de retourner les résultats attendus
	+	* Déclarer le nouveau service auprès de Dotclear
	+	* Appeler le service et traiter les données par du javascript
	+
	+	<note>Pour la suite, nous supposerons que nous voulons créer un service pour afficher dynamiquement, sur la page de rédaction de billet, le temps qu'il reste avant qu'un billet programmé ne soit en ligne.</note>
	+
	+	===== Création du service =====
	+
	+	Le nom de la fonction sera l'identifiant du service. Il faut donc le choisir de manière à ne pas le confondre avec un autre. Dans notre cas, nous l'appellerons //getPostRemainingTime//
	+
	+	<code php>
	+	<?php
	+
	+	class myPluginRestMethods
	+	{
	+	public static function getPostRemainingTime($core,$get)
	+	{
	+
	+	}
	+	}
	+
	+	?>
	+	</code>
	+
	+	<note>Par soucis de convention, nous allons écrire le code de nos services dans le fichier [[files#structure-generale-d-un-plugin\|_services.php]] à la racine du plugin. Si vous souhaitez proposer plusieurs services, ils peuvent tous être écris ici.</note>
	+
	+	Pour obtenir l'information voulue, il nous faut l'id du billet en cours. Nous allons le récupérer grâce au paramètre id qui sera passé dans l'url. Il nous faut également l'objet <php>$core</php> pour récupérer le billet associé à cet id. Pour cela nous allons utiliser les paramètres de la méthode définie plus tôt :
	+
	+	<code php>
	+	$id = isset($get['id']) ? $get['id'] : null;
	+
	+	$rs = $core->blog->getPost(array('post_id' => $id));
	+
	+	$date = strtotime($rs->post_dt);
	+
	+	# Différence en secondes entre maintenant et la date de publication
	+	$delta = $date - time();
	+	</code>
	+
	+	Maintenant que nous avons l'information voulue, il est possible de la transformer pour qu'elle adopte le format de votre choix. On peut par exemple imaginer passer en paramètre dans l'url le format souhaité et convertir le <php>$delta</php> en fonction. Il faut ensuite retourner cette valeur sous forme XML. Pour cela Dotclear possède une classe spéciale //xmlTags// permettant de créer très simplement ce type de structure. Par convention, nos réponses seront encapsulées dans un noeud //rsp// :
	+
	+	<code php>
	+	# Création de l'enveloppe
	+	$rsp = new xmlTag();
	+	# Ajout du noeud "value" dans le noeud "rsp" contenant la variable $delta
	+	$rsp->value($delta);
	+
	+	# On retourne le tout
	+	return $rsp;
	+	</code>
	+
	+	Le fichier XML généré sera donc de cette forme :
	+
	+	<code xml>
	+	<rsp status="ok">
	+	<value>65765432456</value>
	+	</rsp>
	+	</code>
	+
	+	<note>Il est bien sur possible d'ajouter des attribut aux noeuds, faire des combinaisons. Pour plus de détails, vous pouvez regardez les différents plugins utilisants ce système ou Dotclear lui même</note>
	+	===== Déclaration du service =====
	+
	+	Dotclear possède son propre //dispacher// générique de service au travers du fichier //services.php//. Pour l'utiliser, il faut déclarer le service auprès de Dotclear par la méthode suivante :
	+
	+	<code php>
	+	$core->rest->addFunction('getPostRemainingTime',array('myPluginRestMethods','getPostRemainingTime'));
	+	</code>
	+
	+	Ce code est a placer dans le fichier [[files#structure-generale-d-un-plugin\|_prepend.php]] du plugin. Maintenant que notre service est déclaré, il est accessible via l'URL //ADMIN_URL/services.php?f=getPostRemainingTime&id=1//. Testez par vous-même si il fonctionne correctement, si il retourne les bonnes valeurs avant de passer à la suite.
	+
	+	<note>Il ne faut pas oublier de charger le fichier _service.php avant la déclaration du service.</note>
	+
	+	===== Traitement des données =====
	+
	+	C'est maintenant que nous allons aborder la partie //Ajax// du service. Le code javascript décrit ici va permettre d'aller interroger le service et d'afficher la réponse sur la page sans rechargement de celle-ci. Nous allons utiliser //jQuery// fourni par défaut avec Dotclear
	+
	+	<code javascript>
	+	$(function(){
	+	$('#remaining-time').click(function(){
	+	$.get('services.php',
	+	{f: 'getPostRemainingTime',id: $('#id').val()},
	+	function(rsp){
	+	$('#remaining-time-display').html('<p>Temps restant avant la publication :'+$(rsp).find('value').text()+'</p>');
	+	});
	+	});
	+	});
	+	</code>
	+
	+	Lors du clic sur l'élément ayant pour id remaining-time, une requête est faite auprès du service getPostRemainingTime en passant en paramètre le service que l'on veut utiliser + l'id du billet en cours récupéré via le champ caché du formulaire ayant pour id id. La réponse est alors affiché dans le conteneur ayant pour id remaining-time-display.
	+
	+	===== Gestion des erreurs =====
	+
	+	Le code ci-dessus ne prend pas en compte les erreurs qui peuvent survenir lors de l'interrogation du service. L'avantage d'être passé par la classe //xmlTags// pour générer le fichier XML est que si une exception est levée, l'XML résultant sera de la forme :
	+
	+	<code xml>
	+	<rsp status="err">
	+	<message>Message d'exception</message>
	+	</rsp>
	+	</code>
	+
	+	Par exemple pour notre service, si aucun id n'est passé en paramètre, on va lever une exception afin d'en informer l'utilisateur
	+
	+	<code php>
	+	$id = isset($_GET['id']) ? $_GET['id'] : null;
	+
	+	if ($id === null) {
	+	throw new Exception(__('No ID given'));
	+	}
	+	</code>
	+
	+	Il est donc très facile d'intercepter ce type d'XML pour le traiter différemment. Par exemple :
	+
	+	<code javascript>
	+	$(function(){
	+	$('#remaining-time').click(function(){
	+	$.get('services.php',
	+	{f: 'getPostRemainingTime',id: $('#id').val()},
	+	function(data){
	+	var rsp = $(data).children('rsp')[0];
	+	if (rsp.attributes[0].value == 'ok') {
	+	$('#remaining-time-display').html('<p>Temps restant avant la publication :'+$(rsp).find('value').text()+'</p>');
	+	} else {
	+	alert($(rsp).find('message').text());
	+	}
	+	});
	+	});
	+	});
	+	</code>
	+
	+	Ce code informera l'utilisateur via un //alert()// qu'une erreur est survenue lors de la requête ou du traitement par le service.

2.6:resources:plugins:settings

Wed, 16 Oct 2013 09:56:41 +0200

	Version actuelle
Ligne 1:	Ligne 1:
	+	====== Les paramètres des plugins ======

	+	===== Enregistrer un paramètre =====
	+
	+	Il faut d'abord sélectionner le //namespace// (espace de nom) des paramètres grâce à la fonction ''addNameSpace()'' :
	+
	+	<code php>
	+	$core->blog->settings->addNameSpace('example');
	+	</code>
	+
	+	<note>Le paramètre de addNamespace() ne doit contenir que des chiffres ou des lettres sans accent.
	+
	+	Permis : [a-zA-Z][a-zA-Z0-9]
	+
	+	Il est conseillé d'utiliser le nom du plugin comme //namespace// pour éviter que 2 plugins n'aient le même //namespace//.</note>
	+
	+	Pour sauvegarder un paramètre on utilise la fonction ''put()'', dont les paramètres sont :
	+	- le nom du paramètre (une chaîne de caractères contenant uniquement des chiffres ou des lettres sans accent et ''_'')
	+	- sa valeur
	+	- son type (une chaîne de caractères) (facultatif mais recommandé pour éviter les ambiguïtés)
	+	- son label (une chaîne de caractères) (facultatif)
	+	- un booléen : écraser l'ancienne valeur (valeur par défaut : oui) (facultatif)
	+	- un booléen : le paramètre est global (valeur par défaut : non) (facultatif)
	+
	+	==== Example avec une chaîne de caractères avec un label ====
	+
	+	<code php>
	+	# création du namespace
	+	$core->blog->settings->addNameSpace('example');
	+	# l'objet $core->blog->settings->example a été créé
	+
	+	# enregistrement du paramètre dans le namespace example
	+	$core->blog->settings->example->put('setting_name', __('Hello World!'), 'string', 'My label');
	+	</code>
	+
	+	Il est possible d'utiliser [[http://php.net/manual/fr/language.references.php\|l'assignation par référence]] pour faciliter l'accès aux paramètres :
	+
	+	<code php>
	+	# création du namespace
	+	$core->blog->settings->addNameSpace('example');
	+
	+	# assignation par référence, $example_settings pointe vers le namespace nouvellement créé
	+	$example_settings =& $core->blog->settings->example;
	+
	+	# enregistrement du paramètre
	+	$example_settings->put('setting_name', __('Hello World!'), 'string', 'My label');
	+	</code>
	+
	+	==== Les différents types de paramètres ====
	+
	+	Enregistrer un nombre flottant :
	+
	+	<code php>
	+	$core->blog->settings->example->put('pi', 3.14159265, 'float');
	+	</code>
	+
	+	Enregistrer un nombre entier :
	+
	+	<code php>
	+	$core->blog->settings->example->put('nb_entries', 217, 'integer');
	+	</code>
	+
	+	Enregistrer un booléen :
	+
	+	<code php>
	+	$core->blog->settings->example->put('is_valid', true, 'boolean');
	+	</code>
	+
	+	Enregistrer une chaîne de caractères :
	+
	+	<code php>
	+	$core->blog->settings->example->put('title', __('Hello World!'), 'string');
	+	</code>
	+
	+	<note warning>
	+	Pour stocker une chaîne de caractères avec plusieurs lignes, utilisez la fonction ''[[http://fr.php.net/manual/fr/function.base64-encode.php\|base64_encode()]]'' lors de l'enregistrement et ''[[http://fr.php.net/manual/fr/function.base64-decode.php\|base64_decode()]]'' lors de la lecture du paramètre. Ceci préservera les retours à la ligne lors de l'édition de [[:2.0:admin:aboutconfig\|about:config]].
	+	</note>
	+
	+	===== Lire un paramètre =====
	+
	+	Un paramètre est assigné à la variable $core->blog->settings->nom du namespace->nom du paramètre, par exemple :
	+
	+	<code php>
	+	$string = $core->blog->settings->example->title;
	+	</code>
	+
	+	===== Effacer un paramètre =====
	+
	+	Il faut utiliser la fonction ''drop()'' avec l'identifiant du paramètre comme argument :
	+
	+	<code php>
	+	$core->blog->settings->addNamespace('example');
	+
	+	# création du paramètre
	+	$core->blog->settings->example->put('title', __('Hello World!'), 'string');
	+
	+	# suppression du paramètre
	+	$core->blog->settings->example->drop('title');
	+	</code>

2.6:resources:plugins:tpl

Wed, 16 Oct 2013 09:56:41 +0200

	Version actuelle
Ligne 1:	Ligne 1:
	+	FIXME

	+	À effacer.
	+
	+	Voir [[2.0:resources:tpl\|tpl]].

2.6:resources:plugins:translate

Wed, 16 Oct 2013 09:56:41 +0200

	Version actuelle
Ligne 1:	Ligne 1:
	+	====== Localisation d'un plugin ======

	+	Cette page est destiné à la localisation d'un plugin, c'est à dire à la création d'un dossier locales puis d'un sous dossier par langue et enfin du fichier ''main.po'' qui contiendra la traduction dans une langue d'un plugin.
	+
	+	===== Guide d'utilisation des fichiers de localisation =====
	+
	+	==== Mécanique générale ====
	+
	+	Chaque plugin contient du texte qui ne doit pas être inscrit en dur dans le code mais doit pouvoir être adapté pour toutes les langues. Pour ce faire, les fichiers avec l'extension "po" sont ajoutés. Ce sont ces fichiers qui, une fois interprétés par le moteur de dotclear2, vont remplacer, en façade de votre blog, les codes tels que <code php><?php echo __('Maintenance'); ?></code> par le mot ou la phrase associée dans la langue du blog. Pour ceci, il faut que le plugin dispose d'une traduction dans la langue souhaitée. Vous trouverez ci-dessous le détail des différents fichiers.
	+
	+	==== Organisation des fichiers ====
	+
	+	=== Le dossier locales ===
	+
	+	Nommé locales, ce dossier accueille les dossiers contenant les langues vers lesquelles le plugin est traduit. Par exemple il peut contenir :
	+
	+	* un dossier fr qui contiendra les fichiers pour la traduction en français
	+	* un dossier en qui lui sera pour la version anglaise (facultatif)
	+	* etc.
	+
	+	==== Le fichier main.po ====
	+
	+	Exemple de localisation :
	+
	+	<code>
	+	# French translation of DotClear
	+	# Copyright (C) 2006.
	+	# Olivier Meunier <olivier@dotclear.net>, 2006.
	+	#
	+	msgid ""
	+	msgstr "Content-Type: text/plain; charset=UTF-8\n"
	+	...
	+	#: plugins/maintenance/index.php:74
	+	#, php-format
	+	msgid "Indexing entry %d to %d."
	+	msgstr "Index des billets %d à %d"
	+	...
	+	</code>
	+
	+	Les 3 premières lignes contiennent les commentaires du traducteur.
	+
	+	* La langue de traduction,
	+	* La licence associée au fichier,
	+	* Le nom, le mail de l'auteur ainsi que la date de traduction du fichier.
	+
	+	Décomposons ce code pour définir les fonctions de chaque ligne utilisée :
	+
	+	<code>
	+	msgid ""
	+	msgstr "Content-Type: text/plain; charset=UTF-8\n"
	+	</code>
	+
	+	Ces deux lignes permettent de définir le format du fichier ainsi que la méthode de codage des caractères. Ici, il est de type texte et utilise l'encodage UTF-8.
	+	(pour plus d'information sur les encodages : [[http://www.w3.org/International/O-HTTP-charset.fr.php\|Site du W3C]])
	+
	+	<code>
	+	#: plugins/maintenance/index.php:74
	+	</code>
	+
	+	Cette ligne indique le fichier dans lequel est appelé la traduction et à quelle ligne elle est appelée.
	+
	+	Si il y a plusieurs appels d'une même traduction, il suffit d'indiquer toutes les lignes comme dans l'exemple suivant :
	+
	+	<code>
	+	#: plugins/maintenance/index.php:87 plugins/maintenance/index.php:111
	+	</code>
	+
	+	Si les appels sont nombreux, vous pouvez également utiliser une syntaxe qui tient sur plusieurs lignes, comme dans cet autre exemple :
	+
	+	<code>
	+	#: inc//core/class.dc.blog.php:1497 inc//core/class.dc.blog.php:1503
	+	#: inc//core/class.dc.blog.php:1565
	+	msgid "No such comment ID"
	+	msgstr "Identifiant du commentaire inconnu"
	+	</code>
	+
	+	Optionnellement, on peut indiquer que la traduction contient des variables PHP :
	+
	+	<code>
	+	#, php-format
	+	</code>
	+
	+	Dans notre cas, le %d est une variable PHP de type numérique.
	+
	+	<code>
	+	msgid "Indexing entry %d to %d."
	+	</code>
	+
	+	<note warning>
	+	Notez que d'autres types de variables existent. Par exemple, pour passer une variable de type texte, il faut utiliser %s à la place de %d. Pour en savoir plus sur les types de variables et comment les utiliser, lisez [[http://fr.php.net/manual/en/function.sprintf.php\|la documentation PHP sur la fonction sprintf]].
	+	</note>
	+
	+	Le mot-clé msgid associe un identifiant unique à la traduction. Il est donc important de ne jamais donner deux traductions différentes au même identifiant.
	+
	+	<code>
	+	msgstr "Index des billets %d à %d"
	+	</code>
	+
	+	Enfin le mot-clé msgstr contient la traduction tant attendue.
	+
	+
	+	Si on regarde dans le fichier index.php comme indiqué, à la ligne 74... heu 77 ;-)
	+
	+	<code php>
	+	echo '<p>'.sprintf(__('Indexing entry %d to %d.'),$start,$start+$limit).'</p>';
	+	</code>
	+
	+	Voici donc l'appel de la traduction. À la place de "%d to %d", elle contiendra le contenu des variables $start et $start+$limit.
	+
	+	<note tip>
	+	Comme le montre cet exemple, le commentaire concernant la ligne associée à la traduction n'est plus correct, il semblerait que 3 lignes ont été ajoutées depuis au début du fichier index.php du plugin. Il est donc pertinent de mettre à jours son fichier de traduction quand on apporte des modifications aux fichiers qui contiennent des textes à traduire.
	+	</note>
	+
	+	À noter également :
	+	* Le mot-clé msgid ne peut se terminer par un espace, exemple "Ma chaine" sera trouvée et remplacée par sa traduction mais pas "Ma chaine "
	+	* Un script shell permettant de créer un squelette existe voir [[http://dev.dotclear.net/2.0/browser/QA/po_update.sh\|po_update.sh]]
	+	* Un petit billet de Zeiram membre du forum existe aussi sur l'utilisation de gettext ([[http://mudry.org/blog/post/2006/12/31/342-traduction-d-un-plugin-dotclear2\|voir ici]])
	+	* L'existence d'un plugin de traduction [[http://lab.dotclear.org/wiki/plugin/translater\|Translater]]
	+
	+	==== Le fichier public.po ====
	+
	+	Il s'écrit de la même manière que le fichier main.po et traduira les chaines qui apparaissent du côté public du blog.
	+
	+	<note warning>
	+	Ne pas oublier de rajouter l10n::set(dirname(__FILE__).'/locales/'.$_lang.'/public'); dans le fichier _public.php du thème/plugin.
	+	</note>
	+
	+	<note related>
	+	* [[http://tips.dotaddict.org/fiche/Ajouter-des-traductions-dans-les-th%C3%A8mes\|Ajouter des traductions dans les thèmes (Tips DotAddict)]]
	+	</note>
	+
	+	===== Les exceptions de certains plugins =====
	+
	+	Certains plugins préfèrent utiliser les anciennes méthodes utilisées par Dotclear 1 ou encore faire un mélange des deux méthodes. Ces méthodes sont à proscrire donc nous ne ferons qu'effleurer le sujet.
	+
	+	==== Méthode Dotclear 1 ====
	+
	+	Peut être dans le but d'une adaptation rapide vers Dotclear2 tel que le plugin newsletter,
	+
	+	=== Le fichier main.lang.php ===
	+
	+	Même principe que pour Dotclear 2 sauf que tout est réuni en une ligne et qu'on ne sait pas quels sont les fichiers qui l'appellent.
	+
	+	<code>$GLOBALS['__l10n']['Newsletter'] = 'Lettre d\'informations';</code>
	+
	+	<note tip>Les fichiers ''.lang.php'' sont traités plus rapidement que les fichiers ''.po''. Il est possible de créer les traductions dans un fichier ''.po'' puis de générer un fichier ''.lang.php'' correspondant.</note>
	+
	+	==== Méthode Dotclear 1 & 2 ====
	+
	+	Ils utilisent à la fois le fichier "main.po" et le fichier "main.lang.php" qui sont redondants tel que les plugins ThemeSwitcher, gallery, CSScompress, minialbum.
	+
	+	<note tip>Il faut savoir que c'est le fichier "main.lang.php" qui a la priorité sur le fichier "main.po". Si l'un des deux n'est pas présent Dotclear2 prend l'autre sinon il prend main.lang.php.</note>
	+
	+	==== Sans traduction ====
	+
	+	Ou encore d'autres ne les utilisent pas. Cette méthode est à proscrire bien entendu.

2.6:resources:plugins:tutorial

Wed, 06 Nov 2013 09:24:23 +0200

1381910201		Version actuelle
Ligne 65:		Ligne 65:

	<note>		<note>
-	Un fichier peut contenir plusieurs classes. Dans ce cas là, il vous suffit d'inclure qu'une seule fois le fichier avec pour clé du tableau $__autoload la première classe présente dans le fichier en question. Les autres classes seront alors automatiquement chargées	+	Un fichier peut contenir plusieurs classes. Dans ce cas là, il vous suffit de n'inclure qu'une seule fois le fichier avec pour clé du tableau $__autoload la première classe présente dans le fichier en question. Les autres classes seront alors automatiquement chargées
	</note>		</note>

2.6:resources:plugins:widgets

Wed, 16 Oct 2013 09:56:41 +0200

	Version actuelle
Ligne 1:	Ligne 1:
	+	====== Création de widgets ======

	+	===== Introduction =====
	+
	+	Les widgets Dotclear sont des petits bouts de code très simples permettant d'afficher diverses informations dans les bandeaux latéraux d'un blog.
	+
	+	Nous allons voir ici comment réaliser un widget très simple.
	+
	+	===== Conception du plugin =====
	+
	+	==== Définition ====
	+
	+	Comme toujours, on commence par créer un répertoire dans le répertoire des plugins et on crée un fichier _define.php :
	+
	+	<code php>
	+	<?php
	+	if (!defined('DC_RC_PATH')) { return; }
	+
	+	$this->registerModule(
	+	/* Name */ "My first widget",
	+	/* Description*/ "This is my first widget",
	+	/* Author */ "Peter McAlloway",
	+	/* Version */ '1.0',
	+	/* Permissions */ 'admin'
	+	);
	+	?>
	+	</code>
	+
	+	==== Création du widget et administration ====
	+
	+	Ceci fait, nous allons faire un fichier particulier appelé _widgets.php dans lequel nous allons écrire le code suivant :
	+
	+	<code php>
	+	<?php
	+	if (!defined('DC_RC_PATH')) { return; }
	+
	+	global $core;
	+
	+	$core->addBehavior('initWidgets',
	+	array('myWidgetBehaviors','initWidgets'));
	+
	+	class myWidgetBehaviors
	+	{
	+	public static function initWidgets($w)
	+	{
	+	$w->create('MyWidget',__('My first widget'),
	+	array('publicMyWidget','myWidget'));
	+	}
	+	}
	+	?>
	+	</code>
	+
	+	Ce premier code est très simple. La première ligne appelle le comportement initWidgets et indique d'appeler la méthode statique initWidgets de la classe myWidgetBehaviors. La classe est définie juste en dessous et la méthode en question se contente de créer le widget.
	+
	+	La fonction initWidgets reçoit l'objet contenant les widgets en argument. L'unique ligne de cette méthode lance la création du widget.
	+
	+	La méthode create de l'objet passé en argument prend les paramètres suivants :
	+
	+	* L'identifiant du widget
	+	* Le nom du widget
	+	* Un callback valide pour l'affichage du widget sur la partie publique du blog.
	+
	+	En clair nous disons ici : créer un widget identifié par MyWidget, nommé My first widget et appelant la méthode statique myWidget de la classe publicMyWidget.
	+
	+	<note important>
	+	Attention à ne pas réutiliser l'identifiant d'un widget déjà existant. Vous pouvez cependant le faire si vous tenez explicitement à remplacer un widget déjà existant.
	+	</note>
	+
	+	Nous allons maintenant rendre ce widget disponible dans l'administration du blog. Pour ce faire, il suffit d'éditer le fichier _admin.php, en y ajoutant les lignes suivantes :
	+	<code php>
	+	<?php
	+	if (!defined('DC_CONTEXT_ADMIN')) { return; }
	+
	+	require dirname(__FILE__).'/_widgets.php';
	+	?>
	+	</code>
	+
	+	Vous pouvez dès lors voir votre widget dans la liste des widgets disponibles. Il nous manque encore cependant un élément essentiel : ce que fait le widget sur la partie publique du blog.
	+
	+	==== Affichage du widget ====
	+
	+	Nous créons un fichier _public.php dans lequel nous allons écrire le code suivant :
	+
	+	<code php>
	+	<?php
	+	if (!defined('DC_RC_PATH')) { return; }
	+
	+	require dirname(__FILE__).'/_widgets.php';
	+
	+	class publicMyWidget
	+	{
	+	public static function myWidget($w)
	+	{
	+	return '<p><strong>Hello World!</strong></p>';
	+	}
	+	}
	+	?>
	+	</code>
	+	<note>
	+	L'inclusion du fichier _widgets.php dans le fichier _public.php permet d'inclure ce widget directement dans les fichiers template, via le marqueur <tpl:Widget>. Cette fonctionnalité est disponible depuis la version 2.1 de dotclear.
	+	</note>
	+
	+	===== Paramètres avancés du Widget =====
	+
	+	Le widget que nous venons de créer ne sert pas à grand chose et il serait bon de lui ajouter quelques options ou paramètres.
	+
	+	==== Ajout d'options ====
	+
	+	Nous reprenons le code du fichier _widgets.php et le changeons par :
	+
	+	<code php>
	+	<?php
	+	if (!defined('DC_RC_PATH')) { return; }
	+
	+	global $core;
	+
	+	$core->addBehavior('initWidgets',
	+	array('myWidgetBehaviors','initWidgets'));
	+
	+	class myWidgetBehaviors
	+	{
	+	public static function initWidgets($w)
	+	{
	+	$w->create('MyWidget',__('My first widget'),
	+	array('publicMyWidget','myWidget'));
	+
	+	$w->MyWidget->setting('title',__('Title:'),
	+	'default value','text');
	+
	+	$w->MyWidget->setting('checked',__('checkbox'),
	+	true,'check');
	+
	+	$w->MyWidget->setting('text',__('Text:'),
	+	'','textarea');
	+
	+	$w->MyWidget->setting('option',__('Options:'),
	+	null,'combo',array('opt1' => 1, 'opt2' => 2));
	+	}
	+	}
	+	?>
	+	</code>
	+
	+	Vous aurez remarqué la présence de 4 nouvelles lignes dans le code. Chacune ajoute une option différente au widget MyWidget. Pour ajouter une option à un widget on appelle la méthode $w->MyWidget->setting() ou MyWidget est l'identifiant du widget. Voici ce que font ces quatres lignes :
	+
	+	* On ajoute une option title nommée "Title:" ayant pour valeur par défaut "default value" et de type text (champ texte simple).
	+	* On ajoute une option checked nommée "checkbox", cochée par défaut et de type check (case à cocher).
	+	* On ajoute une option text nommée "Text:" avec aucune valeur par défaut et de type textarea (champs de texte long).
	+	* On ajoute une option option nommée "Options:" n'ayant pas de valeur par défaut et de type combo (liste de choix).
	+
	+	Ce code donne tous les types d'options possibles pour un widget.
	+
	+	<note>
	+	La méthode setting() du widget prend un paramètre supplémentaire contenant les données quand elle est de type combo.
	+	</note>
	+
	+	==== Utilisation des options côté admin ====
	+
	+	Maintenant que nous avons un widget paramétrable, nous allons pouvoir changer le fichier _public.php par ceci :
	+
	+	<code php>
	+	<?php
	+	if (!defined('DC_RC_PATH')) { return; }
	+
	+	require dirname(__FILE__).'/_widgets.php';
	+
	+	class publicMyWidget
	+	{
	+	public static function myWidget($w)
	+	{
	+	return '<p><strong>Title: '.$w->title.'</strong></p>';
	+	}
	+	}
	+	?>
	+	</code>
	+
	+	Vous l'aurez compris, pour obtenir la valeur d'une option d'un widget, il suffit d'appeler $w->identifiant_option. Dans notre cas, nous pourrions appeler $w->checked, $w->text, $w->option.
	+
	+	Vous savez maintenant (presque) tout. Bons widgets !