How to Modulentwicklung [Teil 3]

Wie lege ich im Admin einen eigenen Menüpunkt “Fragen & Antworten” an?

Die Menüpunkte für den Admin sind in der Datei menu.xml hinterlegt, um unseren eigenen Menüpunkt hinzuzufügen legen wir innerhalb unseres Moduls eine eigene menu.xml Datei an.

Für unser Modul möchten wir gerne unter dem Adminmenüpunkt -> Artikel verwalten -> Alle Bewertungen unseren eigenen Menüpunkt Fragen und Antworten definieren.

 

Das OXID Framework besitzt an vielen Stellen seine Ecken und Kanten. Dies ist nun so eine. Um den Hauptmenüpunkt Artikel verwalten um einen eigenen Menüpunkt erweitern zu können müssen wir in der Original Datei menu.xml den Block suchen der diesen Hauptmenüpunkt enthält und kopieren diesen in unsere im Modulverzeichnis angelegte menu.xml Datei.

Wir fügen unsere eigenen Menüpunkt unter dem letzten SUBMENU ein.

In unserem Submenu haben wir nun einen allgemeinen Controller bisquestionanswer_listofquestions definiert. Dieser Controller würde schon ausreichen um ein eigenes Template für unseren Menüpunkt zu definieren und zu verwenden.

Da wir uns am OXID Admin Design Aufbau orientieren möchten haben wir noch einen eigenen Listenansicht Controller bisquestionanswer_listofquestions_List und für unseren Haupttab den Controller bisquestionAnswer_listofquestions_main definiert.

metadata.php um unsere Einträge erweitern

Zu allererst erweitern wir unsere bisherige metadata.php um die neuen Einträge für unsere eigenen Admin Controller im files Array und Admin Views im neu definierten Array Eintrag templates.

Eigene Sprachkonstanten definieren

Für unsere eigenen Sprachkonstanten legen wir in unseren Modul das Unterverzeichnis /modules/bisQuestionAnswer/views/admin/de/ an. Innerhalb des Unterverzeichnis legen wir die Sprachdatei bisquestionanswer_lang.php an.

Eigene Admin Controller anlegen

Für unseren eigenen Adminmenüpunkt Fragen und Antworten legen wir das Admin Controller Verzeichnis /modules/bisQuestionAnswer/application/controllers/admin/ an.

Unsere 3 eigene Admin Controller

  • Controller von unseren eigenen Adminmenüpunkt
    bisQuestionAnswer_ListofQuestions
  • Controller für OXID Admin Listenansicht
    bisQuestionAnswer_ListofQuestions_List
  • Controller für OXID Admin Detailansicht
    bisQuestionAnswer_ListofQuestions_Main

Eigene Admin Views anlegen

In unseren Admin Controllern haben wir 3 eigene Admin Templates den Controllern zugewiesen. Für unsere 3 Admin Templates legen wir das Verzeichnis tpl innerhalb des Verzeichnisses /modules/bisQuestionAnswer/views/admin/tpl/ an.

Unsere 3 eigene Admin Views

  • View von unseren eigenen Adminmenüpunkt, welcher die Listen- und Detailansicht einbindet
    list_of_questions.tpl
  • View für OXID Admin Listenansicht
    list_of_questions_list.tpl
  • View für OXID Admin Detailansicht
    list_of_questions_main.tpl

Die Admin View Templates sind vorerst reine Rohvorlagen und werden später um Quellcode ergänzt. Tüftle an wieder verwendbaren Snippets. Lasst euch überraschen! Fortsetzung folgt.

Fortsetzung

Im 4. Teil der Modulentwicklung geht es nächste Woche weiter mit:
Wie definiere ich eine eigene Datenbanktabelle, designe die Admin Templates und hinterlege die Funktionalität?

Key Learnings

  • Eigenen Admin Menüpunkt anlegen
  • Eigene Sprachkonstanten definieren
  • Eigene Listen- und Detailansicht Controller erstellen
  • Eigene Listen- und Detailansicht Views erstellen

0 Antworten

Hinterlassen Sie einen Kommentar

Wollen Sie an der Diskussion teilnehmen?
Feel free to contribute!

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind markiert *