Invision Power Board bridge
Full Invision Power Board integration, including User system and Comment system. If activated - Invision Power Board will take over full management of users and comments.
Description
This plug-in provides user integration between Vivvo CMS and Invision Power Board forum. After integration, IPB takes over managing users and comments and this integration allows a single log-in feature which means that users will be logged-in to both sytems at the same time. Users will have to register only once and they will have only one profile and one user account.
The article's corresponding thread in IPB forum is created automatically when someone posts the first comment to any Vivvo article and comments from IPB forum are displayed within an article's page.
Requirements
- Vivvo v4.5+
- Invision Power Board v3.0.+
Both scripts have to be installed on the same domain.
Pre-installation Steps
IPB bridge works properly only if Invision Power Board forum is set to UTF-8 (ADMIN CP >> System >> Tools & Settings >> System Settings >> Server Environment >> Document Character Set >> UTF-8).
In case your forum is installed in Vivvo subdirectory, it is necessary to place .htaccess into this folder in order to make forum functional.
.htaccess content:
<IfModule mod_rewrite.c> RewriteEngine Off </IfModule>
After you have completed this pre-installation step, you can install the plug-in.
How to Install?
To install IPB integration plug-in you need to click on the install icon on the right side of the plug-ins name.
This will take you to the page with the following fields. Just fill-in the values of corresponding parameters:
- IPB url - You should enter the full URL address of your website, http://www.example.com/forum (http:// prefix and slash are mandatory)
- IPB FS root - In this box you should placed a local path on your server where IPB is installed
If you are unsure about the path you should do the following:
- open index.php file located in your forums' folder
- put the following line right after <?php tag
echo dirname(__FILE__);
- save the file and reupload to your server
- open forums' index page in your browser - the path should be displayed on the top of page
When you got your forums path you should revert all changes to index.php file.
Do not go any further in the installation until you have both url and root added. After you enter these required fields, press the Next button to proceed with the installation.
On the next step, all you need to do is add some parameters in the form shown bellow:
- IPB User ID - The option is used for ArticleBot to generate comments thread for respective articles
- IPB Forum ID - This indicates forum that will store auto-generated threads
Example:
After you have created a Forum that will store threads from your Vivvo site open it in your favorite browser and look at the URL.
As you may see, in our case, forums ID is 2.
The similar way you can get user ID. Just click on the username that will act like a bot (thread creator) and look at the URL:
Next, you will be informed that the plug-in was successfully installed and configured. Also the important notice will appear:
The plug-in was successfully installed and configured.
IMPORTANT: From this point on, IPB will manage User Management and Comment Management of the system. After this step you will be logged out and you must login into Vivvo using your IPB administrator credentials.
Choosing the finish task will log you out and provide you to administration log-in page. Now you should log-in using IPB administrator account. If you enter the correct credentials you'll be logged in to both systems.
Actions
After IPB bridge installation Vivvo will inherit forums users and usergroups. You should set them Vivvo permissions in Users section in Vivvo administration panel as explained in Add/edit usergroup chapter of this User manual.
Users need to log in via Log-in form using IPB username and password. If the user credentials are right, they will pass validation and will be logged to both systems.
If the validation fails user will be redirected to the IPB login page.
To log out from the system through the frontend/backend use the Log out link. This will take effect on the site as well as on the forums.
