{{{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>