Project

General

Profile

Extension de fonctionnalités » History » Revision 5

Revision 4 (Simon, 05/03/2012 04:29 PM) → Revision 5/10 (Simon, 07/03/2012 07:01 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 externes et dela classe des classes _culture_, _plugin_ et _config_file_, les classes peuvent être étendues par le système de plugin et la fonction magique __call(). 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>