How to install a MOD
Posted: 04 Mar 2010, 21:46
How to install a MOD
Written by Stoker
This guide will tell you how to install a modification, also called MOD, for your phpBB3 board.
If you are installing a mod for the first time it can be confusing. I hope this guide will clarify everything for you.
Backup
It is very important that you backup up your files and database before installing a MOD.
If anything goes wrong you can restore backed up files.
Opening the installation instructions
You have downloaded a mod and placed it on your desktop.
Unzip the file, find the install file and open it in your browser.
Rightclick on the install file and choose: Open with
Open it with your browser.
Additional MODX Files
Most mods come with extra instruction files for the templates (prosilver, subsilver2)
To complete the installation of the mod you will need to follow these instructions too.
Most of the times there will be this info if extra install instructions are included.
Copying files to their right location
If extra files is included in the mod, you need to upload them to their right location:
The instructions tells you where to find the file and where you should place it.
Doing SQL changes
Some mods acquires database changes. They can be done either by running some SQL in phpMyAdmin or by running an installer.
This part will be about running SQL in phpMyAdmin.
You will see this in the MOD instruction:
Go to your phpMyAdmin controlpanel. Choose the database you are going to modify.
Click on the SQL tab:
Copy the SQL from the instruction. In this case it was this:
Insert it in the phpMyAdmin textarea and click Go:
If everything is done correct, you will get a confirmation screen that looks like this:
If you get any errors it is important to write these errors down and ask for help in the MOD topic.
Note that INSERT INTO phpbb_config could be different in your database.
If your tables is named something else than phpbb you will need to edit this before running the SQL.
Doing the file edits
A modification can have few or many file edits. Its important that you do them all.
In the example you are instructed to open posting.php, find a piece of code and add some code AFTER.
But in other examples it could be BEFORE or INLINE.
Obviously BEFORE means that you should add the code before.
INLINE means that the code should be added on the same line after a specific word/sign.
Doing the DIY instructions
The DIY instructions is the last thing you need to do before the mod is working.
It can be several different things, but the most common is this:
Save and upload changed files, purge cache in ACP.
Another example is this:
In this case there is four things that we need to pay attention to.
I hope this guide is usefull to you. I will update it with more info if necessary.
Enjoy :winky:
Written by Stoker
This guide will tell you how to install a modification, also called MOD, for your phpBB3 board.
If you are installing a mod for the first time it can be confusing. I hope this guide will clarify everything for you.
Backup
It is very important that you backup up your files and database before installing a MOD.
If anything goes wrong you can restore backed up files.
Opening the installation instructions
You have downloaded a mod and placed it on your desktop.
Unzip the file, find the install file and open it in your browser.
Rightclick on the install file and choose: Open with
Open it with your browser.
- install.PNG (10.92 KiB) Viewed 7270 times
Additional MODX Files
Most mods come with extra instruction files for the templates (prosilver, subsilver2)
To complete the installation of the mod you will need to follow these instructions too.
- modx.png (6.29 KiB) Viewed 7270 times
Copying files to their right location
If extra files is included in the mod, you need to upload them to their right location:
- install6.png (5.65 KiB) Viewed 7270 times
Doing SQL changes
Some mods acquires database changes. They can be done either by running some SQL in phpMyAdmin or by running an installer.
This part will be about running SQL in phpMyAdmin.
You will see this in the MOD instruction:
- install2.png (6.96 KiB) Viewed 7270 times
Click on the SQL tab:
Code: Select all
INSERT INTO phpbb_config (config_name, config_value) VALUES ('link_days', '5');
INSERT INTO phpbb_config (config_name, config_value) VALUES ('link_posts', '5');
INSERT INTO phpbb_config (config_name, config_value) VALUES ('sig_link_days', '10');
INSERT INTO phpbb_config (config_name, config_value) VALUES ('sig_link_posts', '10');Note that INSERT INTO phpbb_config could be different in your database.
If your tables is named something else than phpbb you will need to edit this before running the SQL.
Doing the file edits
A modification can have few or many file edits. Its important that you do them all.
In the example you are instructed to open posting.php, find a piece of code and add some code AFTER.
But in other examples it could be BEFORE or INLINE.
Obviously BEFORE means that you should add the code before.
INLINE means that the code should be added on the same line after a specific word/sign.
Doing the DIY instructions
The DIY instructions is the last thing you need to do before the mod is working.
It can be several different things, but the most common is this:
- install8.png (5.78 KiB) Viewed 7270 times
Another example is this:
- install9.png (8.98 KiB) Viewed 7270 times
This means that there are some extra install files that we need to open and follow.Next make sure to follow the template edits inside the /templates folder.
This means that there is an installer included that needs to be run. It will make sure that the database changes are made.Run the included installer at http://yoursite.com/phpBB/install/index.php
This means that there are some directories/folders that needs some speciel permission/CHMOD settings. Do them with your FTP program or in your CPanel.Make sure the following directories are CHMOD to 0755: arcade/, arcade/gamedata/, arcade/games/, arcade/install/ (Some servers require 0777 not 0755)
This means that you need to remove/delete the installer.Once done make sure to remove install folder from your server.
I hope this guide is usefull to you. I will update it with more info if necessary.
Enjoy :winky:
