admin panel

Panneau d'administration

Panneau d'administration agnostique du cadre.

But

essayer de le rendre aussi minime que possible. Il vous permet de créer plusieurs pages avec différents types (table, formulaire). sans intervenir beaucoup avec votre base de code.

PS: Vous devez toujours configurer vos itinéraires, l'authentification, etc.

Réponse

Nous permettons à plusieurs types de réponses, comme par défaut, nous avons utilisé des vues PHP, mais nous avons pensé aux utilisateurs de Laravel comme exemple, utiliserait à la place blade , donc une solution possible consiste à créer un Renderer différent.

Pour l'instant, nous avons deux Renderers par défaut:

• DefaultRenderer cela renvoie juste un tableau en tant que sortie
• JsonRenderer Ce renvoie la sortie JSON

Pour créer un rendu, il étend AecodesAdminPanelResponsesRenderer . puis ajoutez-le à config.

Dispositions actuellement prises en charge

• Tableau (prend la table de TD, chaque TD peut être rendu sur mesure)
• Forme (prend une gamme de champs)
• Div (le seul cas d'utilisation est d'avoir des emballages personnalisés)
• Il est possible de créer vos propres widgets.

PS: les widgets implémentent l'interface Widget .

Champs de formulaire actuellement pris en charge

• Entrée (texte, mot de passe, e-mail, numéro, ...)
• Radio
• Sélectionner
• Textarea
• Cocher
• Image (télécharger une seule image)

Comment configurer

1. installer avec compositeur
2. Créez un fichier de configuration à l'aide config/panel.php comme point de départ.
3. Créer une instance (singleton) de la classe Dashboard , assurez-vous de passer la configuration en tant que tableau.

 $ config = require ' ./config/panel.php ' ;
Aecodes  AdminPanel Dashboard:: setup ( $ config );

Comment créer une page d'administration

1. créer une nouvelle classe étendant la classe Panel
2. Pour plus de commodité, définissez les propriétés pour $name et $description du panneau (visible sur la page).
3. Créez une méthode query qui renvoie le tableau de données.

 function query (): array {
    // get data from database.
    return Page:: all ()-> toArray ();
}

4. Créez une méthode render qui renvoie un tableau de widgets.

• Pour créer une table

 function render (): array {
    return [
        Table:: make ([
            // (label, name) both are optional
            TD :: make ( ' # ' , ' id ' ),
            // it's also possible to use Table::column
            Table:: column ( ' Title ' , ' title ' ),
        ])
        // ...
    ];
}

• Pour créer un formulaire

 function render (): array {
    return [
        Form:: make ([
            Input:: make ( ' title ' )-> title ( ' Title ' ),

            // form submit
            Action:: button ( ' Save ' ),
        ])
        -> action ( ' # ' )
        -> method ( ' post ' ),
        // ...
    ];
}

5. Pour terminer, dans le rappel de votre itinéraire, renvoyez simplement une nouvelle instance de la classe que vous avez créée.

 // callback for some route
public function index () {
    // PagesTable extends Panel
    return ( new Response ( new PagesTable ))-> render ();
}

Extensibilité

Disposition

Lors de l'extension de la classe Panel , vous pouvez spécifier la propriété $layout .

Vues

Cela n'en est pas expédié avec une couche de vue. Vous pouvez utiliser les packages de vues par défaut (bientôt).

Configurer

La configuration par défaut est:

 return [
    // current renderer.
	' renderer ' => ' default ' ,

    // add new renderer here.
	' renderers ' => [
		' json '    => Aecodes  AdminPanel  Responses JsonRenderer::class,
		' default ' => Aecodes  AdminPanel  Responses DefaultRenderer::class,
	],

    // default classes for button and a tag.
	' classes ' => [
		' link '   => '' ,
		' button ' => '' ,
	],

    // global menus, can be and array or callback
	' menu ' => function () {
		return [];
	},

    // input old value.
	' old_value ' => function ( $ name , $ default ) {
		return $ default ;
	},

    // global errors (i.e: validation errors)
	' errors ' => function () {
		return [];
	}

];