{"data":{"markdownRemark":{"html":"

Suite à la création d'un site internet via le CMS Croogo basé sur CakePHP 3, nous avons été amené à devoir surcharger des plugins. En effet ce CMS est intégralement composé de plugins (au sens CakePHP du terme).

\n

La documentation officielle (de CakePHP), bien que très complète, ne couvrant absolument pas cette partie, nous avons dû faire un petit tour dans le cœur de la bête afin de comprendre ce mécanisme et arriver à combler notre besoin.

\n

\"coeur\"

\n

Template

\n

Les premiers éléments que l'on souhaite surcharger, sur un CMS, sont bien entendu, les templates de vue. Pour cela nous avons donc dû comprendre sur quoi CakePHP se basait pour trouver le bon fichier dans notre arborescence.

\n

Après une petite aventure de quelques minutes, le résultat tombe.

\n

\"Aventure\"

\n

Pour surcharger le template d'un plugin il suffit de créer un fichier du même nom dans src/Template/Plugin/{PluginName}/{ControllerName}/{ActionName}.ctp.

\n

Avec un exemple concret :

\n

Si je veux surcharger la méthode \"view\" du controleur \"Users\" mon plugin \"SuperPlugin\" je vais créer le fichier src/Template/Plugin/SuperPlugin/Users/view.ctp.

\n

Controllers

\n

Surcharger un template c'est bien, mais parfois il sera nécessaire de modifier un comportement. On devra donc surcharger un controleur. Malheurement, pas de solution miracle à base de fichier dans un dossier \"Plugin\", non, nous allons devoir surcharger ses routes (rien de bien compliqué cependant mais il va falloir modifier notre fichier routes.php).

\n

Modifier le chargement des routes

\n

Par défaut, le fichier routes.php charge en premier les routes des plugins avant les nôtres, cela pose donc un problème : dans cet état il est impossible de les surcharger car une fois une route trouvée, les autres sont ignorées. Il faut donc modifier notre fichier routes.php comme ceci.

\n
<?php\nRouter::scope('/', function (RouteBuilder $routes) {\n // vos routes\n});\n\n// Chargement des routes de vos plugins\nPlugin::routes();
\n

Surcharger la route d'un plugin

\n

Maintenant que nos plugins sont chargés, après il va être très facile de surcharger leurs routes. En effet il suffira de la reécrire en passant l'option plugin à false.

\n

Par exemple pour la route de plugin :

\n
// si notre plugin d'appelle \"myplugin\" son url sera \"/myplugin/user/:username\"\n$routes->connect(\n\t'/user/:username', \n\t ['controller' => 'Users', 'action' => 'view'],\n\t ['pass' => ['username']]\n);
\n

Nous devrons déclarer la route suivante dans le scope /

\n
Router::scope('/', function (RouteBuilder $routes) {\n\t$routes->connect(\n\t\t'myplugin/user/:username', \n\t\t['controller' => 'Users', 'action' => 'view', 'plugin' => false],\n\t\t['pass' => ['username']]\n\t);\n});
\n

Modèles

\n

Afin de surcharger les modèles d'un plugin vous devrez surcharger la méthode initialize de votre AppController.

\n

Dans les exemples ci-dessous le but sera de surcharger la table users du plugin MyPlugin

\n\n
// src/AppController.php\n\npublic function initialize()  \n{\n\tTableRegistry::config('MyPlugin.Users', ['entityClass' => 'App\\Model\\Entity\\User']);\n}
\n\n
// src/AppController.php\n\npublic function initialize()  \n{\n\tTableRegistry::config('MyPlugin.Users', [\n\t 'className' => 'App\\Model\\Table\\UsersTable', \n\t 'entityClass' => 'App\\Model\\Entity\\User'\n\t ]);\n}
\n\n
// src/AppController.php\n\npublic function initialize()  \n{\n\tTableRegistry::config('MyPlugin.Users', [\n\t 'className' => 'App\\Model\\Table\\UsersTable', \n\t 'entityClass' => 'MyPlugin\\Model\\Entity\\User'\n\t ]);\n}
\n

Helpers

\n

Pour terminer il ne nous reste plus que les helpers. Au contraire des modèles, vous devrez cette fois-ci modifier la méthode beforeRender de votre AppController.

\n

Par exemple pour surcharger le helper UserHelper du plugin MyPlugin vous devez ajouter dans votre AppController

\n
public function beforeRender(Event $event)\n{\n\t$this->viewBuilder()->setHelpers(['Users']);\n}
\n

Bonus

\n

Comme chez commit42 on est des gens formidables, nous avons développé pour vous (et aussi pour nous), un petit plugin pour vous faciliter la vie : cakephp-override

\n

En reprenant les exemples précédents, on pourrait écrire grâce au plugin le fichier de configuration suivant :

\n
// config/overrides.php\n\n<?php return ['Overrides' => [\n\t'routes' => [\n\t\t'myplugin/user/:username' => [\n\t\t\t'route' => ['controller'  =>  'Users',  'action'  =>  'view',  'plugin'  =>  false],\n\t\t\t'options' => ['pass'  =>  ['username']],\n\t\t]\n\t ],\n\t 'models' => [\n\t\t 'MyPlugin.Users' => [\n\t\t\t 'className' => 'App\\Model\\Table\\UsersTable', \n\t\t\t 'entityClass' => 'App\\Model\\Entity\\User'\n\t\t ]\n\t ],\n\t 'helpers' => [\n\t\t 'MyPlugin.Users' => [\n\t\t\t 'className' => 'Users',\n\t\t\t 'controllers' => true, // true if you want override for all Controllers, an array or a string otherwise\n\t\t ]\n\t ]\n]];
","excerpt":"Suite à la création d'un site internet via le CMS Croogo basé sur CakePHP 3, nous avons été amené à devoir surcharger des plugins. En effet…","timeToRead":3,"fields":{"slug":"/blog/surcharger-un-plugin-avec-cakephp-3/"},"frontmatter":{"date":"2019-01-09T15:40:00.000Z","tags":["cakephp","plugin"],"title":"Surcharger un plugin avec CakePHP 3","author":null,"thumbnail":null}}},"pageContext":{"isCreatedByStatefulCreatePages":false,"slug":"/blog/surcharger-un-plugin-avec-cakephp-3/"}}