API editeur : Différence entre versions

Version du 22 décembre 2006 à 14:16

Fonctions à remplacer

bab_editor($content, $editname, $formname, $heightpx=300, $what=3)

cette fonction retourne du html

bab_editor_record(&$str)

Cette fonction est appelée au moment de la récupération des données soumises par l'éditeur

bab_replace_ref(&$str)

cette fonction est appelée au moment de l'affichage du texte enregistré par l'éditeur.

Nouvelle API pour implémenter un éditeur

Pour le HTML nécessaire à l'éditeur, un objet sera utilisé :

$editor = new bab_editor();
$editor->setRequestFieldName('textarea_name');
$editor->setContent($str);
$editor->setFormName('form_id');
$editor->setHeight(300);
$editor->setParameter('key', 'value');
$editor->getTemplateHtml();
$editor->getContentStore();
$editor->getContentHtml();

Pour afficher l'éditeur au moment de la création d'un texte :

$editor = new bab_editor();
$editor->setRequestFieldName('textarea_name');
$editor->setFormName('form_id');
$html = $editor->getTemplateHtml();

Avec la méthode setParameter il est possible de définir des paramètres qui serons envoyés à l'événement chargé de gérer les fonctionnalités externes qui permettent d'insérer du code html dans l'éditeur. Les 2 paramètres sont des chaînes de caractères.

Pour récupérer le texte soumis par l'utilisateur après le POST ou le GET avant de l'enregistrer dans la base :

$editor = new bab_editor();
$editor->setRequestFieldName('textarea_name');
$db_content = $editor->getContentStore();

Pour afficher du contenu qui a été enregistré avec l'éditeur à partir de $db_html :

$editor = new bab_editor();
$editor->setContent($db_content);
$html = $editor->getContentHtml();

API pour créer un module éditeur

Des événements serons définis pour permettre de fournir un éditeur à partir d'un module