Linea21

{{>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 externes et dela classe _culture_, 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> de mon plugin :

<pre><code class="php">

global $dispatcher;

global $plug;

function NewsRemoveTitle(sfEvent $event, $a)

{

  $ar[0] = ''; // 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>