Tutorial für MOD-Erstellung phpBB3

[nixnox]

Hi,

irgendwie kreise ich immer umher und finde nix - ich möchte ein Mod für PHPBB3 erstellen und benötige ein Tutorial zum Einstieg.

Mit http://startrekguide.com/community/view ... =50&t=2361 komme ich auch nur bis zu den Fehlermeldungen "Parse error: parse error, unexpected ')' in...."

Die Seiten http://wiki.phpbb.com/display/MODDOCS/M ... rs+Library und http://wiki.phpbb.com/display/MODDOCS/T ... ng+modules bringt nicht gerade erschöpfende Antworten...


Es sollte doch nicht so schwer sein, im Adminbereich ein paar Daten anzeigen zu lassen.


Dank für Hilfe!

nixnox

[femu]

Probier mal hier im Abschnitt MOD Authors.

[nixnox]

Hi femu,

der Artikel zum sauberen Code ist nett und http://wiki.phpbb.com/display/DEV/Using ... ule+System ein Ansatz, aber berauschend ist dasleider nicht...

Steckt die Doku noch so in den Kinderschuhen?

Gruss nixnox

[Frank1604]

der Artikel zum sauberen Code ist nett und http://wiki.phpbb.com/display/DEV/Using ... ule+System ein Ansatz, aber berauschend ist dasleider nicht...

Ich glaube du verwechselst da gerade Module mit MODifikationen (MODS).

Was genau willst du denn wissen? Im Prinzip kannst du frei drauflos proggen, allerdings immer unter Beachtung von: http://code.phpbb.com/svn/phpbb/branche ... lines.html

Hier noch ein paar Grundlagen: http://www.phpbb.com/mods/author-introduction/

Eine Hilfe dabei ist sicherlich auch das hier: https://www.phpbb.de/infos/3.0/xref/nav.html?index.html

Und wenn du alles fertig hast, verpakst du das ganze in ein schnuggeliges Mod-Paket. Dabei hilft dir sicher das hier: http://www.phpbb.com/mods/modx/

[nixnox]

Hallo Frank

Ich glaube du verwechselst da gerade Module mit MODifikationen (MODS).

das kann sein, dass ich in dem Sprachgebrauch noch nicht ganz drinn bin - ich gehe mal zurück auf "Start":

Ich möchte ein "Mxxxx" erstellen, welches wie das Mod aus der 2.xer Zeit alle User als Tabelle auflistet und dabei verschiedene Infos mit angibt und sortierbar ist. Das Ding hieß "Admin Userlist" und wird für 3.x nicht adaptiert.

Das Ganze möchte ich für den/die Admin(s) im Adminbereich als "Modul" (System > Modul-Konfiguration > Admin-Bereich) einbinden - ob das "Modul" nun als "MOD" eingeklinkt werden soll/muss sei mal dahingestellt...

Im Prinzip kannst du frei drauflos proggen, allerdings immer unter Beachtung von: http://code.phpbb.com/svn/phpbb/branche ... lines.html

Na eben nur im Prinzip! Ich will am Core nix verändern - von dem "Suche in Datei x Zeile y und ersezte mit Code z"-Sch...e habe ich die Nase voll. Das hat mit "Programmierung" nicht viel gemein.

Zur konkreten Frage:
* welche Dateien benötige ich
* wo liegen die Dateien bzw. wo müssen die hin
* welche "magic" Infos müssen rein (Dateinamen, Klassenbezeichnungen usw.)
* wie müssen die Dateien in das System eingebunden werden

Das "foo-Dummy-Paket" aus dem ersten Link wäre schon prima gewesen, wenn es funktionieren würde bzw. nachvollziehbar wäre, warum es die im dem Thread aufgeführten Fehlermeldungen erzeugt.

Die andrer Methode wäre sicher "nimm eine ähnliche Mxxx und hoffe auf Dokumentation im Quelltext und bete, dass du den Code verstehst um ihn zu verändern"...

gruss nixnox

[Frank1604]

Hallo nixnox,

Na eben nur im Prinzip! Ich will am Core nix verändern

Die Coding Guidelines gelten auch wenn du ein eigenes Modul erstellen willst. Es ist einfach nur eine Richtlinie, um den in phpBB verwendeten Code in gewissen Regeln laufen zu lassen.

von dem "Suche in Datei x Zeile y und ersezte mit Code z"-Sch...e habe ich die Nase voll. Das hat mit "Programmierung" nicht viel gemein.

Das was du meinst ist lediglich die Einbauanleitung, um eine fertig "programmierte" Modifikation an den Mann zu bringen.

Ich möchte ein "Mxxxx" erstellen, welches wie das Mod aus der 2.xer Zeit alle User als Tabelle auflistet und dabei verschiedene Infos mit angibt und sortierbar ist. Das Ding hieß "Admin Userlist" und wird für 3.x nicht adaptiert.

Jetzt müsste man nur wissen was für Informationen die Liste ausgeben soll, weil auf diese Beschreibung passt auch die Mitgliederliste im Forum

Evtl. ist es aber auch das Support Toolkit (STK), was du suchst.

[nixnox]

Hallo nixnox,
Die Coding Guidelines gelten auch wenn du ein eigenes Modul erstellen willst. Es ist einfach nur eine Richtlinie, um den in phpBB verwendeten Code in gewissen Regeln laufen zu lassen.

... so habe ich das auch verstanden...

Das was du meinst ist lediglich die Einbauanleitung, um eine fertig "programmierte" Modifikation an den Mann zu bringen.

... was ich meine:
* "Du benötigst folgende Dateien an folgendem Speicherort..."
* "Der grundsätzliche Aufbau ist..."
* "Zum Aktivieren folgendes durchführen..."

?? kann man hier nix hochladen? sonst hätte ich mein Dummy mal zur Ansicht gestellt...

Jetzt müsste man nur wissen was für Informationen die Liste ausgeben soll, weil auf diese Beschreibung passt auch die Mitgliederliste im Forum

ich möchte _nur_ für den Admin sichtbar z.B. Name, Vorname, Nicname, Anmeldedatum, Firma, Ort, Abteilung, eMail....

Evtl. ist es aber auch das Support Toolkit (STK), was du suchst.

... etwas "oversized" - hier würde ggf. "Profile List: An advanced memberlist which allows you to easily filter users." am Nähesten kommen

gruss nixnox

[Frank1604]

?? kann man hier nix hochladen? sonst hätte ich mein Dummy mal zur Ansicht gestellt...

Doch, das geht. Dafür ist das PasteBin da.

... was ich meine:
* "Du benötigst folgende Dateien an folgendem Speicherort..."
* "Der grundsätzliche Aufbau ist..."
* "Zum Aktivieren folgendes durchführen..."

So wie ich das verstanden habe möchtest du ein eigenes Modul erstellen, das vom Adminbereich aus aufrufbar ist, und dir die gewünschten Informationen darstellt.
Dazu brauchst du mindestens 4 Dateien:

Die Infodatei, die die wichtigsten Informationen über dein Modul an das System liefert, wie Modulname, Berechtigungen usw.:
acp_deinmodul.php -> /includes/acp/info/

Hier das Beispiel - Example 1.8. A sample info file


Dann das Modul selber. Hier führst du deine Abfragen aus, filterst, stellst die Daten für das Template bereit.. was auch immer du machen möchtest.
acp_deinmodul.php -> /includes/acp/

Hier das Beispiel - 1.5.2.3. The Module Class

Dann wäre da noch das Template. Hier werden die von deinem Modul generierten Daten ausgegeben, bzw. Auswahlfelder zur Verfügung gestellt usw..
acp_deinmodul.html -> /adm/style/

Hier das Beispiel - 1.5.2.4. Templates


Und zu guter Letzt, die Sprachdatei. Hier liegen die Sprachvariablen für alles was Ausgegeben werden soll.
info_deinmodul.php -> /language/de/mods/

Hier das Beispiel - 1.5.2.5. Language

Wenn du alle Dateien fertig und an ihrem Ort hast, kannst du das Modul im Adminbereich unter System -> Administrationsbereich hinzufügen.

[nixnox]

Hi Frank,

Pastebin: danke für die Info... bin schon bei der ersten Datei gescheitert

"Die Dateierweiterung html ist nicht erlaubt
Du hast kein Code eingefügt oder keine gültige Datei zum Upload ausgewählt."

... obwohl HTML als Syntax ausgewählt.

Zip geht schon garnicht...


hier die Dateien all-in-one: https://www.phpbb.de/support/pastebin.p ... view&s=473


nixnox

[Frank1604]

Ok, sieht doch auf den ersten Blick schonmal brauchbar aus. Was genau passiert denn wenn du das Modul im Adminbereich unter System -> Administrationsbereich hinzufügen möchtest?