Seite 1 von 3

Tutorial für MOD-Erstellung phpBB3

Verfasst: 24.05.2010 22:27
von 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

Re: Tutorial für MOD-Erstellung phpBB3

Verfasst: 25.05.2010 08:11
von femu
Probier mal hier im Abschnitt MOD Authors.

Re: Tutorial für MOD-Erstellung phpBB3

Verfasst: 25.05.2010 14:16
von 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

Re: Tutorial für MOD-Erstellung phpBB3

Verfasst: 25.05.2010 22:35
von Frank1604
nixnox hat geschrieben: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/

Re: Tutorial für MOD-Erstellung phpBB3

Verfasst: 26.05.2010 08:58
von nixnox
Hallo Frank
Frank1604 hat geschrieben: 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...
Frank1604 hat geschrieben: 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"... :wink:

gruss nixnox

Re: Tutorial für MOD-Erstellung phpBB3

Verfasst: 26.05.2010 09:46
von Frank1604
Hallo nixnox,
nixnox hat geschrieben: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.
nixnox hat geschrieben: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.
nixnox hat geschrieben: 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.

Re: Tutorial für MOD-Erstellung phpBB3

Verfasst: 26.05.2010 10:12
von nixnox
Frank1604 hat geschrieben: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...
Frank1604 hat geschrieben: 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...
Frank1604 hat geschrieben: 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....
Frank1604 hat geschrieben: 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

Re: Tutorial für MOD-Erstellung phpBB3

Verfasst: 26.05.2010 10:37
von Frank1604
nixnox hat geschrieben:?? kann man hier nix hochladen? sonst hätte ich mein Dummy mal zur Ansicht gestellt...
Doch, das geht. Dafür ist das PasteBin da.
nixnox hat geschrieben:... 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.

Re: Tutorial für MOD-Erstellung phpBB3

Verfasst: 26.05.2010 11:03
von 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

Re: Tutorial für MOD-Erstellung phpBB3

Verfasst: 26.05.2010 11:17
von 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?