Installation Walkthrough for "Bumpit" -- Forum Social Bookmarking Plugin
-
There are two methods to install the PHPBB plugin: with the help of EasyMOD and manually
-
Method 1. Installing The Bumpal Plugin Using EasyMOD
-
IMPORTANT NOTE: By convention all phpbb's plugins/mods are made to work with
the default subSilver template. EasyMOD will do just that. It will
install a plugin into the subSilver template. If you have a different
template you will have to manually install the mod
-
As the name suggests this is by far the easiest method. EasyMod is a special kind of mod that allows you to install other mods.plugins with minimum effort. If you don’t already have EasyMOD installed, download it from here:
http://sourceforge.net/projects/easymod/
-
You can find detailed instructions about how to install EasyMOD here:
http://easymod.sourceforge.net/readme/#g_install_EM
-
Installing the Bumpal plugin with EasyMOD (EM)
Theoretically, EM should be able to install any single plugin currently in the MODs database at www.phpbb.com. However, plugin authors do not currently write their plugins to prevent compatibility issues with other plugins. The Bumpal plugin doesn’t have any known conflicts with other mods or plugins, but such a thing can occur especially if you have many mods installed. If such a thing happens please don’t hesitate to contact us using the form below and describe exactly how this incompatibility manifests and what steps have brought you to this specific situation. We value your feedback and we will do our best to solve the problems appeared.
-
Installation steps:
-
1. Connect to the server via the FTP to where the Bumpal plugin is to be installed
-
2. Go to the forum folder and then to admin/mods/ folder
-
3. Create a new folder named Bumpal
-
note: the directory you create cannot have any spaces or single quotes (')
note: All MODs should have their own directory
example (correct): admin/mods/Bumpal_plugin
example (incorrect): admin/mods/ Bumpal plugin
-
4. Upload all the files in the archive to the new created folder.
-
5. Visit the forum where the plugin is to be installed, log in as an
-
Administrator, and enter the Administration Panel.
-
6. Click on "Install MODs" under the "MOD Center" header in the left-hand-side
panel.
-
7. Enter the password for EasyMOD that you first set at installation (or on
the "EasyMOD Settings" page).
-
8. EM will list all the MODs it detects (see below for troubleshooting). Find the Bumpal plugin in the list of MODs and just click the "Process" button to the right of it.
-
9. Confirm that EasyMOD has detected and correctly interpreted all steps in the MOD and then click the "Next Step" button.
-
10. EasyMOD will now make changes to your database if you command it to. Any SQL with a check next to it will be performed by EM. If you are reinstalling a MOD, you probably do not want to run the SQL a second time, so be careful!
-
Click the "Complete Installation" button when your done.
-
11. Check to make sure that the MOD installed correctly.
note: in most of the cases (settings) you won't have to worry about that,
but if you had chosen "download" or "on screen" method for writing or
"manually load" for moving then you will need to move backups and other files
to places shown in the tables.
-
Method 2. install Bumpit manually
-
Before engaging into any manual installation it is widely recommended that you backup your current files. So here are the steps you must make in order to install the Bumpal plugin manually.
-
1. Connect to the server via FTP
-
2. Open the archive that contains the and then open the file install.mod with a text processor
-
3. Search [ COPY ] in the install.mod file. You will have to copy all the .GIF images in the archive to the location that is showed in there. For example bumpal.gif will have to be copied to templates/subSilver/images/bumpal/bumpal.gif. Please observe that this assumes that you are using the subSilver template, if you use another one change the location of these files to a location like templates/TemplateName/images/bumpal/bumpal.gif
-
4. After this step, you will see a series of [OPEN], [FIND], [REPLACE WITH], [AFTER, ADD], [BEFORE ADD] commands.
[OPEN] this will tell you which file you have to open in order to edit it, please see the attached note below.
[FIND] this will point out the area where you will have to edit. It contains the approximate line of code and code snippet you have to find. After finding the code snippet one of the three commands will follow.- (1) REPLACE WITH - you will have to replace the code snippet you found with the one provided.
- (2) AFTER, ADD - you will have to insert the provided code exactly below the code snippet you found
- (3) BEFORE, ADD - you will have to insert the provided code exactly above the code snippet you found
-
IMPORTANT: If you are using a different template than subSilver, you will have to edit the filed associated with it, instead of the ones shown in the OPEN command. For example the [OPEN] command:
templates/subSilver/subSilver.cfg
should be replaced with
templates/templatename/templatename.cfg
and
templates/subSilver/viewtopic_body.tpl
should be replaced with
templates/templatename/viewtopic_body.tpl
-
FINAL NOTE:
-
Always remember to backup the changes made. If you encounter any problem please don't hesitate to contact us using the form below
-
License: http://opensource.org/licenses/gpl-license.php GNU General Public License v2
