admin panel

Admin -Panel

Framework Agnostic Admin Panel.

Ziel

versuchen, es so minimal wie möglich zu machen. Sie können mehrere Seiten mit unterschiedlichen Typen (Tabelle, Form) erstellen. ohne viel mit Ihrer Codebasis einzugreifen.

PS: Sie müssen noch Ihre Routen, die Authentifizierung usw. einrichten ...

Antwort

Wir ermöglichen mehreren Antworten, als Standard -PHP -Ansichten, aber wir haben als Beispiel für Laravel -Benutzer gedacht, dass sie stattdessen blade verwenden würden, sodass eine mögliche Lösung darin besteht, einen anderen Renderer zu erstellen.

Im Moment haben wir zwei Standard Renderers :

• DefaultRenderer Dies gibt nur ein Array als Ausgabe zurück
• JsonRenderer Dies gibt JSON Output zurück

Um einen Renderer zu erstellen, erweitert er AecodesAdminPanelResponsesRenderer . Fügen Sie es dann zur Konfiguration hinzu.

Derzeit unterstützte Layouts

• Tabelle (nimmt eine Array von TD, jeder TD kann individuell gerendert werden)
• Form (nimmt eine Reihe von Feldern)
• DIV (der einzige Anwendungsfall besteht darin, maßgeschneiderte Wrapper zu haben)
• Es ist möglich, Ihre eigenen Widgets zu erstellen.

PS: Widgets implementiert Widget -Schnittstelle.

Derzeit unterstützte Formularfelder

• Eingabe (Text, Passwort, E -Mail, Nummer, ...)
• Radio
• Wählen
• Textbereich
• Kontrollkästchen
• Bild (einzelnes Bild hochladen)

Wie man einstellt

1. mit Komponist installieren
2. Erstellen Sie eine Konfigurationsdatei mit config/panel.php als Ausgangspunkt.
3. Create (Singleton) Instanz der Dashboard -Klasse, stellen Sie sicher, dass Sie die Konfiguration als Array übergeben.

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

So erstellen Sie eine Administratorseite

1. Erstellen Sie eine neue Klasse, die die Panel erweitert
2. Legen Sie die Immobilien für $name & $description des Panels (auf der Seite sichtbar) fest.
3. Erstellen Sie eine query , die das Datenarray zurückgibt.

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

4. Erstellen Sie eine render -Methode, die eine Reihe von Widgets zurückgibt.

• Um eine Tabelle zu erstellen

 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 ' ),
        ])
        // ...
    ];
}

• ein Formular erstellen

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

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

5. Zum Abschluss des Rückrufs Ihrer Route geben Sie einfach eine neue Instanz der von Ihnen erstellten Klasse zurück.

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

Erweiterbarkeit

Layouts

Beim Erweiterung der Panel können Sie die $layout -Eigenschaft angeben.

Ansichten

Dies versendet nicht mit einer View -Ebene. Sie können die Standardpakete (bald) Views verwenden.

Konfiguration

Die Standardkonfiguration lautet:

 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 [];
	}

];