3.x/Modificatie installeren

Uit phpBB.nl Wiki
Ga naar: navigatie, zoeken
Next.png Zie ook het artikel Modificatie installeren (phpBB2) voor een uitleg hoe je een modificatie moet installeren voor phpBB2.0.x


Een modificatie installeren is niet zo heel moeilijk. Als je dit artikeltje hebt doorgelezen, is de kans groot dat het lukt.

XML bestanden

Je krijgt een .zip bestand dat je uitpakt naar bv mijn documenten/mods/. Vervolgens open je {modnaam}.xml in je browser. Let wel dat je alle bestanden uitpakt, dus ook het stijl bestand met de extensie .xsl. En wat je daarna moet doen, is alle mod acties uit voeren. 'Vergeet geen backups te maken van alle bestanden die je moet wijzigen EN de database!

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. Nadat je alle commando's hebt uitgevoerd moet je natuurlijk ook alles opslaan en 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 root/foo.php to foo.php
copy root/includes/foo.php to includes/foo.php
copy root/images/*.gif to images/*.gif
copy root/images/* to images/*

Ze betekenen allemaal eigenlijk hetzelfde. De eerste betekent: kopieer foo.bar vanuit de root 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.

Veel succes!

En als het echt niet lukt...

... dan is er het Service Team, die het voor je kan installeren. Je kan deze hulp aanvragen door een nieuw onderwerp te openen in het forum phpBB.nl Service.

Dit artikel is een beginnetje. U wordt uitgenodigd op bewerk te klikken om uw kennis aan dit artikel toe te voegen. Crystal txt.png