Créer ses premiers contrôleurs sur OctoberCMS

Création de votre premier contrôleur

Pour créer un premier contrôleur dans un nouveau plugin, il vous suffis de créer un fichier qui étends de la class \Backend\Classes\Controller dans le dossier controllers de votre plugin.

Ce fichier contiendras la déclaration de la class de votre contrôleur:

namespace Acme\Blog\Controllers;

class Articles extends \Backend\Classes\Controller {

    public function index()    // <=== Méthode d'une action
    {

    }

}

Les vues sont jumelées

Pour chaque action créer dans votre class, un fichier de vue, contenu dans un sous-dossier au nom de votre contrôleur sera appelé par défaut.

Ainsi un fichier index.htm placé dans le dossier plugins/acme/blog/controllers/articles sera appelé automatiquement et affiché à l'utilisateur:

<h1>Bonjour le monde</h1>

Et voilà, vous avez votre premier contrôleur!

Afin d'éviter le travail répétitif de génération d'un contrôleur, une méthode en ligne de commande existe aussi, vous la retrouverez dans la section patrons de la documentation

C'est tout aussi simple d'y passer des variables!

Parcequ'un exemple vaut souvent un long discours, découvrez comment passer des variables directement à la vue du contrôleur:

// Depuis votre contrôleur
namespace Acme\Blog\Controllers;

class Articles extends \Backend\Classes\Controller {

    public function index()
    {
        $this->vars['simplicime'] = "C'est beaucoup trop simple!"
    }

}

<!-- Dans votre fichier vue correspondant, ici index.htm -->
<h1>Bonjour le monde</h1>
<p> Découvrez à quel point il est facile de passer des données dans vos vues: <?= $simplicime ?>

Effectuer un appel AJAX:

Comme sur la partie front-end, il est très facile d'effectuer des appels AJAX depuis la vue. Le même framework AJAX est intégré dans la back-end :

<button type="button" data-request="onCreerUnDevis">
    Sauvegarder le devis
</button>

public function onCreerUnDevis()
{
    // [...] Créez la logique de sauvegarde du devis

    // Retournez un message flash
    if ($success) {
        Flash::success('Devis sauvegardé.')
    } else {
        Flash::error("Une erreur s'est produite !")
    }
}

Retrouvez la documentation traduite

Evidemment, vos contrôleurs peuvent faire bien plus de chose que cela, à vous d'en créer la logique!

Pour en apprendre plus sur comment créer votre premier contrôleur : retrouvez tous les détails de la création de contrôleur dans la section Contrôleurs back-end et AJAX de la documentation