2.x/Modificatie installeren

Uit phpBB.nl Wiki
Ga naar: navigatie, zoeken
!! Let op: vanaf 1 januari 2009 wordt phpBB2 niet meer ondersteund door phpBB.nl en phpBB.com.

Deze pagina's dienen uitsluitend als archief.

!!


Het installeren van een MOD is op zich best simpel. Bij iedere mod zit een instructiebestand, waarin staat, wat je precies moet doen. In dit bestand staan allemaal instructies, die een bepaalde betekenis hebben. Deze zullen hier stuk voor stuk worden toegelicht. MODs kan je ook met EasyMOD installeren. Echter werkt deze vaak alleen met subSilver, en als je geen andere MODs hebt geinstalleerd. Daarom behandelen we die hier niet.

De MODtemplate

Het MOD template is een standaard van het phpBB MOD team, waarin bepaalde acties staan beschreven. Dat kan zijn in het veel gebruikte tekst-template, of in het relatief nieuwe MODX. Elke actie wordt hieronder uitgebreid besproken. Een actie ziet er als volgt uit:

#
#-----[ ACTIE ]------------------------------------------
#
Waar bij dit voorbeeld actie staat, staat normaal een van de hieronder vermelde acties.

De bovenkant

De bovenkant ziet er als volgt uit:
##############################################################
## MOD Title: mod_titel_hier
## MOD Author: phpBB.com_gebruikersnaam < emailadres > (echte_naam) websiteadres
## MOD Description: een_omschrijving_komt_hier
## MOD Version: x.x.x
##
## Installation Level: (Easy/Intermediate/Advanced)
## Installation Time: x Minutes
## Files To Edit: file_1,
##      file_2,
##      file_3,
##      etc
## Included Files: (N/A, or list of included files)
## License: http://opensource.org/licenses/gpl-license.php GNU General Public License v2
##############################################################
## For security purposes, please check: http://www.phpbb.com/mods/
## for the latest version of this MOD. Although MODs are checked
## before being allowed in the MODs Database there is no guarantee
## that there are no security problems within the MOD. No support
## will be given for MODs not found within the MODs Database which
## can be found at http://www.phpbb.com/mods/
##############################################################
## Author Notes:
##
##############################################################
## MOD History:
##
##   JJJJ-MM-DD - Version x.x.x
##      - version notes go here
##
##############################################################
## Before Adding This MOD To Your Forum, You Should Back Up All Files Related To This MOD
############################################################## 
De eerste 4 regels gaan over welke MOD het is, de beschrijving, de auteur en de versie. Dit spreekt aardig voor zich.

Hierna komt het installatie-level. Dit geeft aan, hoe moeilijk de mod is om te installeren. Daarna volgt een lijst met aan te passen bestanden en nieuwe bestanden. Deze moet je straks gaan aanpassen/uploaden. Na deze lijst staat de licentie, normaal gesproken gewoon de GPL, en hierna een korte disclaimer met betrekking tot veiligheid en de MOD. Hierna wat dingetjes, die de MOD-auteur nog kwijt wil; deze moet je vaak goed lezen, voordat je begint, omdat er regelmatig belangrijke dingen instaan! Als laatste nog de MOD-geschiedenis, met de wijzingen in welke versie.

De mod-acties

De volgende mod-acties zijn er allemaal:
SQL
COPY
DIY INSTRUCTIONS
OPEN
FIND
REPLACE WITH
AFTER, ADD
BEFORE, ADD
INCREMENT
IN-LINE FIND
IN-LINE AFTER, ADD
IN-LINE BEFORE, ADD
IN-LINE REPLACE WITH
Deze zullen hieronder allemaal besproken worden. Helemaal aan het eind zul je trouwens een "speciale" mod-actie vinden, namelijk de EOM (End Of Mod) instructie. Deze is bedoeld voor easymod, om te laten zien, dat dit het einde is.
#
#-----[ SAVE/CLOSE ALL FILES ]------------------------------------------
#
# EoM
Ook geeft het aan, dat je alle bestanden moet opslaan en uiteraard uploaden!

COPY

De COPY actie betekent, dat je nieuwe bestanden moet uploaden via je FTP naar je webhost. De notatie van de copy actie is als volgt:
copy foo.php to foo.php
copy includes/foo.php to includes/foo.php
copy images/*.gif to images/*.gif
copy images/* to images/*

Ze betekenen allemaal eigenlijk hetzelfde. De eerste betekent: kopieer foo.bar vanuit de root van de map van de mod, naar de root van het forum op de FTP. De tweede betekent hetzelfde, alleen nu vanuit een submap: includes. De derde betekent: kopieer alle bestanden, die in de map "images" staan en op .gif eindigen, naar de "images"-map op de FTP, met dezelfde naam. De laatste betekent: kopieer de gehele images-map met alle bestanden daarin naar de FTP.

SQL

Een SQL query is een database-opdracht. Omdat hier o.a. alle onderwerpen, gebruikers en instellingen staan opgeslagen, is het belangrijk, dat je voorzichtig te werk gaat. Maak dus altijd van te voren een back-up!

De actie ziet er bijvoorbeeld zo uit:
#
#-----[ SQL ]------------------------------------------
#
ALTER TABLE `phpbb_banlist` ADD reason TEXT;
ALTER TABLE `phpbb_banlist` ADD by_id INT(10) default '-1';
ALTER TABLE `phpbb_banlist` ADD cookie_time INT(10);
ALTER TABLE `phpbb_banlist` ADD ban_cookie INT(10);
ALTER TABLE `phpbb_banlist` ADD cookie_id VARCHAR(64);
ALTER TABLE `phpbb_banlist` ADD reason_private TEXT ;
UPDATE phpbb_banlist SET by_id = '-1' WHERE by_id <= 1;

Om deze uit te voeren, ga je naar phpMyAdmin. Daar klik je bovenin op het vakje SQL:

Sql tab.gif

In het vak, dat je nu te zien krijgt, kopieer je deze queries. Je kan ze allemaal tegelijkertijd kopieëren; haal wel eerst het oude weg, wat er stond!

Sql query 2.gif

Naast deze heb je ook nog een iets andere soort. In deze staat een bestandsnaam. In dit bestand staan dan een aantal php-codes, welke de benodigde query's uitvoeren. Je dient dit bestand dan ook te uploaden naar je webhost via je FTP, erheen te gaan in de browser, en daarna het bestand weer te verwijderen.

DIY INSTRUCTIONS

Dit zijn bepaalde instructies, die goed gelezen moeten worden en daarna met de hand worden uitgevoerd. Dit kan variëren van iets chmodden, tot een backup maken van een bepaald bestand. Vaak zeggen de instructies in dit blok genoeg over wat je moet doen, maar vergeet zeker niet òm het te doen. Vaak zijn ze erg belangrijk voor een goede werking van de mod!

OPEN

Dit betekent, dat je een bestand moet openen om te bewerken. Nadat je hem hebt geopend (eventueel eerst downloaden van je webhost; live bewerken kun je beter nooit doen!), ga je door naar de volgende stap.

FIND

Deze instructie betekent, dat je een bepaald stuk code in het bestand, dat je bij het vorige open block hebt geopend, moet zoeken. Soms staan er meerdere achter elkaar. Dan moet je ze één voor één opzoeken. De volgende actie, die je tegenkomt, moet je alleen uitvoeren op de laatste FIND-instructie! Soms wordt er maar een gedeelte van een regel weergegeven in een find-block. Echter, je moet bij de volgende actie altijd van de gehele regel uitgaan!

REPLACE WITH

De replace with instructie komt na een FIND-instructie. Het betekent, dat je het vorige FIND-block moet vervangen met de code, die in de REPLACE WITH block staat. Wanneer dit block leeg is, dien je dat stuk code, dat je moest zoeken, te verwijderen!

AFTER, ADD en BEFORE, ADD

Deze acties betekenen, dat je er iets VÓÓR (BEFORE) of ACHTER (AFTER) moet toevoegen. Wanneer de zoekactie maar een klein deel van de regel betrof, dien je deze op de VORIGE regel (bij BEFORE), of de VOLGENDE regel (bij AFTER) te zetten. Nooit zomaar halverwege een regel zetten!

INCREMENT

De increment actie is een van de moeilijkste acties. Hij ziet er als volgt uit:
#
#-----[ FIND ]------------------------------------------
#
Powered by <a href="http://www.phpbb.com/" target="_phpbb" class="copyright">phpBB</a> © 2001, {%:1} phpBB Group<br />{TRANSLATION_INFO}</span></div>
#
#-----[ INCREMENT ]-------------------------------------
#
%:1 +10
Zoals je ziet, is in de FIND-actie
{%:1}
opgenomen. Dit staat normaal voor een stukje code in die regel.

Het is de bedoeling, dat deze code, met de increment actie verhoogd of verlaagd gaat worden. In dit voorbeeld verhoogd, bij %:1 dient 10 te worden opgeteld. Laten we zeggen: er staat op de plek van {%:1} 2000, en we moeten die 10 erbij optellen, dan komt er daarna dus 2010 te staan. Deze actie wordt vaak gebruikt bij colspans of rowspans.

IN-LINE FIND

De in-line find actie is ervoor om een bepaald deel in de regel te zoeken. Deze actie komt altijd na minimaal één FIND-actie. Alle volgende acties na een IN-LINE FIND kunnen enkel met INLINE beginnen. Deze moet je dan ook direct na de INLINE-FIND doen, en dus niet op de vorige/volgende regel, zoals bij de FIND!

IN-LINE AFTER, ADD IN-LINE BEFORE, ADD en IN-LINE REPLACE WITH

Deze 3 zijn de INLINE varianten van de normale, en werken ook op diezelfde manier; echter dien je het nu direct voor of na de IN-LINE FIND uit te voeren. Bij IN-LINE REPLACE dien je hetgeen je bij IN-LINE FIND moest zoeken, te vervangen.

Kan het bestand niet openen

Sommige MODs hebben als bestandextensie .mod, wat door Windows als een film begrepen wordt. Het zal dus waarschijnlijk met Windows Media Player openen. Om dit te vermijden druk je Rechtermuisklik > Openen Met > ... Een andere mogelijkheid is om het bestand naar .txt te hernoemen, zodat het standaard met een teksteditor opent.