Stand: 30.12.2008 04:56 aktuelle Version auf phpBB.de

Apache At Work Communities Community Building Informationen und Hinweise Installation/Konfiguration/Update MySQL PHP phpBB-Optimierungen phpBB3 Rechtliches Server & Technik Snippets Templates und Mods

Knowledge Base Offline -> Templates und Mods -> MODs - FAQ

MODs - FAQ
Autor: AWSW
Stand: 30.12.2008 04:56
Neuste Version unter: http://www.phpbb.de/doku/kb/modsfaq

### MODs - FAQ

##### Antworten auf viele Fragen zum Thema MODs, z.B: Was ist ein Mod?, Einbau von MODs, Wie sind die Anleitungen aufgebaut?

1. Was ist ein MOD?
2. Wo finde ich MODs?
3. Wie füge ich einen MOD in mein phpBB ein ?
4. Wie sind die Anleitungen der MODs aufgebaut ?
5. Versionsangaben der MODs
6. Neue MODs in ein bereits gemoddetes Forum einbauen
7. Die zu suchenden Texte werden nicht gefunden, wenn z.B. ein anderes Template/Design verwendet wird
8. Sollte ich diesen oder jenen MOD einbauen ?
9. Was muss ich noch beim Einbau eines MODs beachten ?
10. Debug Mode
11. FTP - CHMOD / 777 wie geht das ?
12. SQL & phpMyAdmin
13. Lokale Server
14. Womit kann man die Dateien bearbeiten / Editoren
15. Fragen zu MODs stellen
16. Hinweis zu diesem Text

1.: Was ist ein MOD ? nach oben
Ein MOD stellt eine Modifikation des phpBB dar. Gemeint ist damit eine Änderung des im Standard vorhandenen phpBB von phpbb.com. Also ist im Prinzip jede kleinste, dokumentierte Änderung an einem phpBB auch ein MOD. MODs können verschiedene Funktionen ermöglichen. Sie können das Design des phpBB ergänzen oder sie können komplett neue Funktionen in das phpBB integrieren. Nicht zu verwechseln ist die Abkürzung MOD mit der hier im Forum ebenfalls gleich lautenden Abkürzung für Moderatoren. Ob es sich dabei nun um eine Modifikation oder einen Moderator handelt, sollte aus dem Zusammenhang des Textes erkennbar sein.

2.: Wo finde ich MODs ? nach oben
Links zu MODs findest Du zum Beispiel in diesem Artikel: Gesucht, gefunden - Mods & Co für phpBB2. Die auf phpbb.de enthaltenen MODs sind in der MOD-Datenbank zu finden.

3.: Wie füge ich einen MOD in mein phpBB ein ? nach oben
Um einen neuen MOD in Dein Forum einzubauen kann die nachfolgende Vorgehensweise hilfreich sein, damit es reibungslos klappt:
- Jedem MOD liegt eine Textdatei bei, die meistens auf den Namen install.txt oder auch manchmal install.mod lautet. Darin stehen die Anweisungen zum Einbau des MODs.
- Ein wichtiger Hinweis, der zwar in so ziemlich jeder Anleitung der MODs steht, aber manchmal gerne überlesen wird, ist die Anmerkung alle zu ändernden Dateien und/oder die Datenbank des Forums vor dem Einbau zu sichern. Diese Aktion sollte man aber immer vor jeder Änderung bedenken, damit man nicht nach Einbau mehrerer MODs mit einem Fehler konfrontiert wird und dann nicht mehr auf die Sicherungsdateien zurückgreifen kann. Dies kann sehr ärgerlich sein und wenn das Forum schon online gestellt ist, zu einem dann selbst verschuldeten Ausfall führen. Deshalb hier noch mal der eindringliche und gut gemeinte Hinweis: Vor dem Einbau des MODs sollten die zu ändernden Dateien und auch ggf. die Datenbank gesichert werden. Das Sichern der Dateien kann durch simples Kopieren der Dateien in einen Ordner auf Deiner Festplatte durchgeführt werden. Die Sicherung der Datenbank kann man entweder durch ein Sicherungsscript (Beispiel in diesem Artikel) ausgeführt werden oder mit dem weit verbreiteten Datenbanktool phpMyAdmin erfolgen. Die im phpBB mitgelieferte Datenbanksicherungsfunktion im Administrationsbereich (ACP) ist leider nur eingeschränkt zu verwenden, da dabei nur die im Standard enthaltenen Tabellen gesichert werden und die Sicherung deshalb unvollständig sein kann. Weitere Informationen zu den verschiedenen Backupmöglichkeiten: MySQL Backup. Wenn diese 2 Sicherungsaktionen dann durchgeführt sind, kann der Einbau des MODs erfolgen, der im nachfolgenden Text näher beschrieben wird.

4.: Wie sind die Anleitungen der MODs aufgebaut ? nach oben

Die meisten Anleitungen für MODs sind nur in englischer Sprache verfügbar, da sie die meisten Leute erreicht. Es gibt nur wenige MODs, die ebenfalls eine deutsche Anleitung enthalten, um Euch den Einbau zu erleichtern. Die meisten englischen Anleitungen sind aber meist leicht zu verstehen:

Begriff | Erklärung
COPY | Dateien in vorgesehene Verzeichnisse kopieren
SQL | Datenbankänderungen ausführen (s.u.)
OPEN | Dateien öffnen
DIY INSTRUCTIONS | Do It Yourself Anweisungen müssen vor der Installation des Mods ausgeführt werden
FIND | jeweiligen Codebereich finden
AFTER, ADD | den neuen Code nach dem zu findenen Code einfügen (in der nächsten Zeile)
BEFORE, ADD | den neuen Code vor dem zu findenen Code einfügen (in der vorigen Zeile)
REPLACE WITH | den zu findenen Code mit dem neuen Code ersetzen
IN-LINE FIND | in dem zuvor zu findenen Code den expliziten Code finden
IN-LINE AFTER, ADD | den neuen Code direkt nach dem zu findenen Code einfügen
IN-LINE BEFORE, ADD | den neuen Code direkt vor dem zu findenen Code einfügen
IN-LINE REPLACE WITH | den zu findenen Code direkt mit dem neuen Code ersetzen
DELETE | den zu findenen Code löschen
SAVE/CLOSE ALL FILES | alle geänderten Dateien speichern/schliessen

5.: Versionsangaben der MODs: nach oben

Bei fast allen MOD Anleitungen steht am Anfang die Version des MODs und auch meist im nachfolgenden Text, mit welcher Version des phpBB der Autor diesen MOD getestet hat.

## Mod Title: File Attachment Mod v2
## Mod Version: 2.3.8
## Author: Acyd Burn < acyd.burn@gmx.de > - Meik Sievertsen - http://www.opentools.de/attach_mod/
## Description:
## This Mod adds the ability to attach files in phpBB2.
## This Version is Tested and works with phpBB 2.0.5.
## This Version will NOT work with phpBB2 Modules designed for *Nuke Portals.

Beide Angaben sollten vor dem Einbau beachtet werden. Bei der Angabe der Version des MODs sollte kontrolliert werden, ob dies auch die aktuellste Version ist, also ob es nicht schon weitere neuere Versionen dieser Modifikation auf der Seite des Autors oder unter den oben genannten Adressen gibt. Dadurch kann besser vermieden werden, dass man ein vielleicht noch fehlerhafte frühe Version des MODs einbaut. Die zweite Angabe des Autors "Version des phpBB" ist nicht ganz so entscheidend, da es nicht unbedingt heissen muss, dass der jeweilige MOD, der vom Autor z.B. als "getestet mit phpBB 2.0.3" aufgeführt wird, nicht auch in der aktuellsten phpBB-Version. Ein umgekehrter Fall ist auch denkbar, wenn Du noch eine ältere Version des phpBB verwendest und einen MOD einbauen möchtest, der vom Autor für eine aktuellere phpBB Version angegeben wird. Dies kann man eigentlich nur dadurch herausfinden, wenn man vor dem Einbau nach der aktuellsten Version des MODs gesucht hat und dann den MOD Testweise einbaut. Klappt der MOD und alle Funktionen des Forums anschließend noch, sollte der MOD demnach kompatibel sein. Falls das Forum nach dem Einbau nicht mehr wie gewünscht funktioniert, kommen die unter Punkt 3. erwähnten Sicherungen eventuell wieder zum tragen, wenn eine rasche Funktion des Forums wieder gewünscht ist. Findest Du den Fehler selbst nicht, sollte in der Regel der "Debug Mode" (siehe unten) weitere Auskunft bei auftauchenden Fehlermeldungen geben. Meist hilft es, wenn man die gesicherten Dateien wiederherstellt, dann noch mal neu editiert und den MOD so noch einmal einbaut. So kann man relativ gut eigene Einbaufehler finden. Findest Du den Fehler dann immer noch nicht, dann kannst Du Dein Problem hier gern im Forum posten. Hinweise dazu weiter unten.

6.: Neue MODs in ein bereits gemoddetes Forum einbauen: nach oben
Falls Du einen neuen MOD in ein bereits gemoddetes Forum (z.b. phpBBPlus) einbauen möchtest, ist dies durchaus möglich. Ein gemoddetes Forum ist im Prinzip auch nichts anderes, als ein normales Standard-phpBB mit schon darin eingefügten MODs. Von daher spielt dies an sich keine Rolle, ob Du nun die MODs vorher in ein solches Forum eingebaut hast oder dies schon jemand anderes vorher erledigt hat.
Es gibt beim Einbau eines MODs dann aber ein paar Besonderheiten, die man beachten sollte. Beim Einbau in ein solches phpBB muss man mehr aufpassen, dass man vorhandene MODs nicht durch das Verändern des Codes in Ihren Funktionen stört. Besonders kann dies der Fall sein, wenn man nach der Anleitung des MODs Zeilen im Code ersetzen soll. Dabei sollte man gut aufpassen, dass die zu suchende Zeile genau übereinstimmt. Nur dann ist gewährleistet, dass die Funktion, wie vom Autor gedacht geändert wird.

7.: Die zu suchenden Texte werden nicht gefunden, wenn z.B. ein anderes Template/Design verwendet wird: nach oben
Bei den meisten MODs wird nur das im Standard enthaltene subSilver Template in den Anleitungen der MODs erwähnt. Das heißt nicht, dass der MOD nicht auch in anderen Templates funktioniert. Bei einigen MODs kann es daher sein, dass Du den MOD in das subSilver ohne weiteres einfügen konntest, aber in einem anderen Template, die laut der Anleitung zu suchenden Texte einfach nicht mehr finden kannst. In diesem Fall findet man die zu suchenden Passagen in den .tpl Dateien dann meist am besten, wenn man nur nach einem Teil des zu suchenden Codes sucht. Gleiches gilt auch in den .php Dateien selbst. Meist findet man eine zu suchende Zeile nicht mehr, weil sie ein anderer MOD schon verändert hat. In diesem Fall sollte man dann besondere Vorsicht beim Ersetzen (REPLACE WITH) von Code walten lassen, da man dann auch die Funktion des anderen zuvor eingebauten MODs stören könnte.

8.: Sollte ich diesen oder jenen MOD einbauen ? nach oben
Das bleibt im Endeffekt Dir selbst überlassen. Ob du den entsprechenden MOD wirklich brauchst, kannst eigentlich nur Du selbst entscheiden, da niemand außer Dir besser weiß, wie Du Dein Forum nutzen willst. Bei einigen MODs liegen Demolinks oder Screenshots bei, damit man sich vorher das Ergebnis ansehen kann.

9.: Was muss ich noch beim Einbau eines MODs beachten ? nach oben
In den Anleitungen steht oft ein gut gemeinter Hinweis, dass man sich beim Einbau Zeit nehmen soll und die Anleitung so genau wie möglich zu beachten. Dies sollte man IMHO auch tun, denn um so weniger besteht dann die Gefahr, dass man selbst Fehler beim Einbau mit einbringt.

10.: Debug Mode: nach oben
Wie schon zuvor beschrieben, kann in der Regel der "Debug Mode" weitere Auskunft bei auftauchenden Fehlermeldungen geben. Beschrieben wird die Aktivierung in diesem Beitrag zum Debug Mode.

11.: FTP - CHMOD / 777 wie geht das ? nach oben
In manchen MOD Anleitungen wird erwähnt, dass man einen Ordner oder eine Datei per CHMOD auf 777 setzen soll. Falls Du nicht genau weißt, wie das geht, schau bitte in diesen Beitrag.

12.: SQL & phpMyAdmin: nach oben

Für einige MODs muss die SQL-Datenbank des phpBB erweitert werden, damit die Funktion des MODs ermöglicht werden kann. Manchen MODs liegt dabei eine vom Autor beigefügte .php-Datei bei, die man einmal ausführen und danach wieder löschen muss und so die Änderungen erledigen kann. Bei vielen MODs stehen die notwendigen Änderungen aber nur als Befehle in der Anleitung, wie in dem rechten Beispiel.

CREATE TABLE phpbb_attach_quota (
user_id mediumint(8) unsigned NOT NULL default '0',
group_id mediumint(8) unsigned NOT NULL default '0',
quota_type smallint(2) NOT NULL default '0',
quota_limit_id mediumint(8) unsigned NOT NULL default '0',
KEY quota_type (quota_type)
);
ALTER TABLE phpbb_forums ADD auth_download TINYINT(2) DEFAULT '0' NOT NULL;
ALTER TABLE phpbb_auth_access ADD auth_download TINYINT(1) DEFAULT '0' NOT NULL;
INSERT INTO phpbb_quota_limits (quota_limit_id, quota_desc, quota_limit) VALUES (1, 'Low', 262144);
INSERT INTO phpbb_quota_limits (quota_limit_id, quota_desc, quota_limit) VALUES (2, 'Medium', 2097152);
INSERT INTO phpbb_quota_limits (quota_limit_id, quota_desc, quota_limit) VALUES (3, 'High', 5242880);

Wie oben schon erwähnt gibt es das Datenbanktool phpMyAdmin, welches sehr nützlich im Umgang mit dem phpBB sein kann. Die Installation und Verwendung wird hier in diesem Artikel näher erklärt. Wenn Du bei der Installation des MODs diese SQL-Änderungen selbst erledigen musst, solltest Du auf den sogenannten Tabellenpräfix achten. Dieser ist in diesem Beispiel "phpbb_", wie auch in einem standardmäßig installierten phpBB. Kontrollieren kannst Du den von Dir verwendeten Präfix entweder über einen Aufruf des phpMyAdmins oder indem Du Deine config.php öffnest. Dort ist der verwendete Tabellenpräfix gespeichert. Sollte Dein Präfix "phpbb_" von dem der einzugebenden SQL-Befehle abweichen, musst du die Befehle entsprechend anpassen. Vor der Anwendung sollte aber wie oben schon mehrfach erwähnt die Datenbank gesichert werden.

13.: Lokale Server: nach oben
Sehr hilfreich zum Testen von MODs kann ein lokaler Webserver sein, da man so einen MOD erst mal lokal einbauen kann, ohne sein Liveforum mit den Tests belasten zu müssen. Eine Anleitung dazu findest Du hier in diesem Artikel. Ich selbst nutze unter Windows XP diese Variante.

14.: Womit kann man die Dateien bearbeiten / Editoren: nach oben
Eine häufig im Forum gestellte Frage ist die nach einem geeigneten Editor, um die phpBB Dateien bearbeiten zu können. Da ich ausschließlich Windows verwende, kann ich hier nur Tipps für dieses Betriebssystem geben. Windows XP liefert im Standard dazu 2 brauchbare Texteditoren mit, die man zum Einbau verwenden kann. Zum einen das Programm "Wordpad" (write.exe) und das wohl bekanntere Programm "Notepad" auch als "Editor" bezeichnet (notepad.exe). Es gibt aber auch nette Zusatzprogramme und Tools, die bei häufigerem Einsatz sicherlich sinnvoll sein können, da sie mehr Funktionen bieten, wie zum Beispiel das Programm "Proton", welches ich selbst auch meist verwende.

15.: Fragen zu MODs stellen: nach oben
Falls Ihr Fragen zu MODs hier im Forum stellen wollt, bedenkt bitte die folgenden Dinge:
- beachtet zunächst den kleinen phpBB.de-Knigge
- postet falls verfügbar den Downloadlink zum MOD, denn nicht jeder kennt alle MODs und deren Funktionen
- postet bitte eventuell auftretende Fehlermeldungen mit aktiviertem Debug Mode
- formuliere Deine Fragen bitte so genau wie möglich, da der Leser nicht wissen kann, womit Du Dich gerade beschäftigst
- poste bitte keine kompletten Dateien oder ellenlange Codes in einem Beitrag, sondern verlinke diese als .txt oder noch besser als .zip von Deinem Webspace aus, sonst kann man die Beiträge an sich nur noch schlecht lesen
- viele Fragen wurden aber auch schon mal im Forum gestellt, deshalb könnte ein Blick in die Suche vielleicht auch hilfreich sein.

Hinweis zu diesem Text: nach oben
Ich hoffe Euch mit diesen Hinweisen weiter zu helfen. Wenn Ihr Verbesserungen zum Text habt, sendet sie bitte per PN an einen der Moderatoren. Fragen zum Einbau von MODs können wir aus zeitlichen Gründen leider nicht per PN, Mail oder außerhalb dieses Forums beantworten.

Knowledge Base Offline -> Templates und Mods -> MODs - FAQ

| phpBB.de Knowledge Base (Offline-Version) ©2005 Sascha Carlin und das phpBB.de-Team - Impressum Das Kopieren von Artikeln (auch auszugsweise) ist nur nach ausdrücklicher Genehmigung erlaubt! phpBB.de: Infos | Forum | Downloads | Dokumentation |