Project

General

Profile

Extension de fonctionnalités » History » Version 3

Simon, 05/03/2012 04:23 PM

1 1 Simon
{{>toc}}
2
3
4
h2. Généralités
5
 
6
7
Le système de plugins est conçu autour du composant "Event Dispatcher du framework symfony":http://components.symfony-project.org/event-dispatcher/documentation.
8
9
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)
10
11
Remarque : L'événement créé par Linea21 se nomme *[nom_de_la_class].extensible_function*.
12
13
Exemple d'implémentation sur le module News (qui gère l'actualité) :
14
15
16 2 Simon
<pre><code class="php">
17 1 Simon
/**
18
*** news::CheckDataIntegrity()
19
*** Vérification intégrité des données
20
*** @access public
21
*** @param array $table : contient les composants Nécessaires d'une news
22
*** @return boolean true
23
*** si verifié, sinon string 'message d'erreur'
24
   */
25
26
  public function [[CheckDataIntegrity]]($table)
27
  {
28
    $event = new sfEvent($this, 'news.before_data_check');
29
    $this->dispatcher->filter($event, $table);
30
31
    $table = $event->getReturnValue();
32
    
33
    
34
    if (strlen($tabler0) < 3) return _t('news','no_title');
35
    if (strlen($tabler1) < 3) return _t('news','no_header');
36
    if (strlen($tabler2) < 3) return _t('news','no_body');
37
    if ($tabler3 <= 0 || !is_numeric($tabler3)) return _t('news','no_theme');
38
    if ($tabler4 <= 0 || !is_numeric($tabler4)) return _t('news','no_scale');
39
    if ($tabler6 <= 0 || !is_numeric($tabler6)) return _t('news','no_template');
40
41
    return true;
42
  }
43 2 Simon
</code>
44 1 Simon
</pre>
45
46 3 Simon
Dans le <code>__init__.php</code> de mon plugin :
47 1 Simon
48
49 2 Simon
<pre><code class="php">
50 1 Simon
global $dispatcher;
51
global $plug;
52
53
function [[NewsRemoveTitle]](sfEvent $event, $a)
54
{
55
  $ar0 = _; // Exemple : on supprime le titre. Cela doit lever une erreur
56
57
  return $a; // On renvoie le résultat de l'opération
58
}
59
60
$dispatcher->connect('news.before_data_check', 'FilterTestLinea21'); // connexion de l'évenement
61 2 Simon
</code>
62 1 Simon
</pre>