Extension de fonctionnalités » History » Revision 3
Revision 2 (Simon, 05/03/2012 04:18 PM) → Revision 3/10 (Simon, 05/03/2012 04:23 PM)
{{>toc}}
h2. Généralités
Le système de plugins est conçu autour du composant "Event Dispatcher du framework symfony":http://components.symfony-project.org/event-dispatcher/documentation.
A l'exception des classes systèmes et des classes _culture_, _plugin_ et _config_file_, les classes peuvent être étendues par le système de plugin et la fonction magique call(). (voir "documentation":http://components.symfony-project.org/event-dispatcher/trunk/book/02-Recipes#chapter_02_adding_methods_to_a_class)
Remarque : L'événement créé par Linea21 se nomme *[nom_de_la_class].extensible_function*.
Exemple d'implémentation sur le module News (qui gère l'actualité) :
<pre><code class="php">
/**
*** news::CheckDataIntegrity()
*** Vérification intégrité des données
*** @access public
*** @param array $table : contient les composants Nécessaires d'une news
*** @return boolean true
*** si verifié, sinon string 'message d'erreur'
*/
public function [[CheckDataIntegrity]]($table)
{
$event = new sfEvent($this, 'news.before_data_check');
$this->dispatcher->filter($event, $table);
$table = $event->getReturnValue();
if (strlen($tabler0) < 3) return _t('news','no_title');
if (strlen($tabler1) < 3) return _t('news','no_header');
if (strlen($tabler2) < 3) return _t('news','no_body');
if ($tabler3 <= 0 || !is_numeric($tabler3)) return _t('news','no_theme');
if ($tabler4 <= 0 || !is_numeric($tabler4)) return _t('news','no_scale');
if ($tabler6 <= 0 || !is_numeric($tabler6)) return _t('news','no_template');
return true;
}
</code>
</pre>
Dans le <code>__init__.php</code> !+init+.php de mon plugin :
<pre><code class="php">
global $dispatcher;
global $plug;
function [[NewsRemoveTitle]](sfEvent $event, $a)
{
$ar0 = _; // Exemple : on supprime le titre. Cela doit lever une erreur
return $a; // On renvoie le résultat de l'opération
}
$dispatcher->connect('news.before_data_check', 'FilterTestLinea21'); // connexion de l'évenement
</code>
</pre>