Comment Créer des Plugins¶

Controllers du Plugin¶

Les controllers pour notre plugin ContactManager seront stockés dans /app/Plugin/ContactManager/Controller/. Puisque la principale chose que nous souhaitons faire est la gestion des contacts, nous aurons besoin de créer un ContactsController pour ce plugin.

Ainsi, nous mettons notre nouveau ContactsController dans /app/Plugin/ContactManager/Controller et il ressemblerait à cela:

// app/Plugin/ContactManager/Controller/ContactsController.php
class ContactsController extends ContactManagerAppController {
    public $uses = array('ContactManager.Contact');

    public function index() {
        //...
    }
}

Si vous souhaitez accéder à ce que nous avons obtenu jusqu’à présent, visitez /contact_manager/contacts. Vous devriez obtenir une erreur « Missing Model » parce que nous n’avons pas un model Contact déjà défini.

Models du Plugin¶

Les Models pour le plugin sont stockés dans /app/Plugin/ContactManager/Model. Nous avons déjà défini un ContactsController pour ce plugin, donc créons le model pour ce controller, appelé Contact:

// /app/Plugin/ContactManager/Model/Contact.php:
class Contact extends ContactManagerAppModel {
}

Visiter /contact_manager/contacts maintenant (Etant donné, que vous avez une table dans votre base de données appelée “contacts”) devrait nous donner une erreur « Missing View ». Créons la ensuite.

Par exemple:

// /app/Plugin/ContactManager/Model/Contact.php:
class Contact extends ContactManagerAppModel {
    public $hasMany = array('ContactManager.AltName');
}

Si vous préférez que les clés du tableau pour l’association n’aient pas le préfixe du plugin sur eux, utilisez la syntaxe alternative:

// /app/Plugin/ContactManager/Model/Contact.php:
class Contact extends ContactManagerAppModel {
    public $hasMany = array(
        'AltName' => array(
            'className' => 'ContactManager.AltName'
        )
    );
}

Vues du Plugin¶

Les Vues se comportent exactement comme elles le font dans les applications normales. Placez-les juste dans le bon dossier à l’intérieur du dossier /app/Plugin/[PluginName]/View/. Pour notre plugin ContactManager, nous aurons besoin d’une vue pour notre action ContactsController::index(), ainsi incluons ceci aussi:

// /app/Plugin/ContactManager/View/Contacts/index.ctp:
<h1>Contacts</h1>
<p>Ce qui suit est une liste triable de vos contacts</p>
<!-- Une liste triable de contacts irait ici....-->

/app/View/Plugin/ContactManager/Contacts/index.ctp

Assets du Plugin¶

Les assets web du plugin (mais pas les fichiers de PHP) peuvent être servis à travers le répertoire “webroot” du plugin, tout comme les assets de l’application principale:

app/Plugin/ContactManager/webroot/
                                    css/
                                    js/
                                    img/
                                    flash/
                                    pdf/

Vous pouvez mettre tout type de fichier dans tout répertoire, juste comme un webroot habituel.

Mais garder à l’esprit que la gestion des assets statiques, comme les images, le Javascript et les fichiers CSS des plugins à travers le Dispatcher est incroyablement inefficace. Il est grandement recommandé de les symlinker pour la production. Par exemple comme ceci:

ln -s app/Plugin/YourPlugin/webroot/css/yourplugin.css app/webroot/css/yourplugin.css

<?php echo $this->Html->css("ContactManager.style"); ?>

Components, Helpers et Behaviors¶

Un plugin peut avoir des Components, Helpers et Behaviors tout comme une application CakePHP classique. Vous pouvez soit créer des plugins qui sont composés seulement de Components, Helpers ou Behaviors ce qui peut être une bonne façon de construire des Components réutilisables qui peuvent être facilement déplacés dans tout projet.

Construire ces components est exactement la même chose que de les construire à l’intérieur d’une application habituelle, avec aucune convention spéciale de nommage.

Faire référence avec votre component, depuis l’intérieur ou l’extérieur de votre plugin nécessite seulement que vous préfixiez le nom du plugin avant le nom du component. Par exemple:

// Component défini dans le plugin 'ContactManager'
class ExampleComponent extends Component {
}

// dans vos controllers:
public $components = array('ContactManager.Example');

La même technique s’applique aux Helpers et aux Behaviors.

// Déclarez le use de AppHelper pour le Helper de votre Plugin
App::uses('AppHelper', 'View/Helper');

Etendez votre Plugin¶

Cet exemple est un bon début pour un plugin, mais il y a beaucoup plus à faire. En règle général, tout ce que vous pouvez faire avec votre application, vous pouvez le faire à l’intérieur d’un plugin à la place.

Continuez, incluez certaines librairies tierces dans “Vendor”, ajoutez de nouveaux shells à la console de cake, et n’oubliez pas de créer des cas de test ainsi les utilisateurs de votre plugin peuvent automatiquement tester les fonctionnalités de votre plugin!

Dans notre exemple ContactManager, nous pourrions créer des actions add/remove/edit/delete dans le ContactsController, intégrer la validation dans le model Contact, et intégrer la fonctionnalité à laquelle on pourrait s’attendre quand on gère ses contacts. A vous de décider ce qu’il faut intégrer dans vos plugins. N’oubliez juste pas de partager votre code avec la communauté afin que tout le monde puisse bénéficier de votre component génial et réutilisable!

Astuces pour les Plugins¶

Une fois qu’un plugin a été installé dans /app/Plugin/, vous pouvez y accéder à l’URL /nom_plugin/nom_controller/action. Dans notre exemple de plugin ContactManager, nous accédons à notre ContactsController à l’adresse /contact_manager/contacts.

Quelques astuces de fin lorsque vous travaillez avec les plugins dans vos applications CakePHP:

• Si vous n’avez pas un [Plugin]AppController et [Plugin]AppModel, vous aurez des erreurs de type get missing Controller lorsque vous essayez d’accéder à un controller d’un plugin.

• Vous pouvez définir vos propres layouts pour les plugins, dans le dossier app/Plugin/[Plugin]/View/Layouts. Sinon, les plugins utiliseront les layouts du dossier /app/View/Layouts par défaut.

• Vous pouvez établir une communication inter-plugin en utilisant $this->requestAction('/plugin_name/controller_name/action'); dans vos controllers.

• Si vous utilisez requestAction, assurez-vous que les noms des controllers et des models sont aussi uniques que possibles. Sinon, vous aurez des erreurs PHP de type « redefined class … ».

• Quand vous ajoutez des routes avec des extensions à votre plugin, assurez-vous d’utilisez Router::setExtensions() pour ne pas devoir surcharger le routing de l’application.

Publiez votre Plugin¶

Vous pouvez ajouter votre plugin sur plugins.cakephp.org ou le proposer à la liste awesome-cakephp.

Aussi, vous pouvez créer un fichier composer.json et publier votre plugin sur packagist.org. De cette façon, il peut être facilement utilisé avec Composer.

Choisissez un nom de package avec une sémantique qui a du sens. Il devra idéalement être préfixé avec la dépendance, dans ce cas « cakephp » comme le framework. Le nom de vendor sera habituellement votre nom d’utilisateur sous GitHub. N’utilisez pas le namespace CakePHP (cakephp) puisqu’il est reservé aux plugins appartenant à CakePHP. La convention est d’utiliser les lettres en minuscule et les tirets en séparateur.

Donc si vous créez un plugin « Logging » avec votre compte GitHub « FooBar », un bon nom serait foo-bar/cakephp-logging. Et le plugin « Localized » appartenant à CakePHP peut être trouvé dans cakephp/localized.