vBulletin® integration

Description

vBulletin® integration plug-in provide you full vBulletin integration, including User system and Comment system.

This is an easy solution to integrating vBulletin forum software with your Vivvo system. If activated, vBulletin will take over full management of users and comments. A single registration works for the site as well as for the forums. It means that users are registered on the both systems at the same time, and when they log-in, they're logged to both systems at the same time.

vBulletin is a professional forum solution and this plug-in has capability of smoothly integration vBulletin into Vivvo CMS software.

vB Integration is created and tested with version 3.6.x of vBulletin forum.

How to Install?

You need to access the Plug-ins section. Click on Plug-ins link which is located in Main menu at the top of your administration panel.

menu

A list of all plug-ins currently registered to the system is displayed on the right hand side of the screen.

right menu

To install vBulletin® integration plug-in you need to click on the install icon on the right side of the plug-ins name.

vBulletin install

This will take you to the page with the following fields. Just fill-in the values of corresponding parameters:

vBulletin install step 1

Vb url

You should enter the full URL address of your website, www.example.com/forum ('http://' prefix and slash are mandatory)

Vb FS root

In this box you should placed a local path on your server where vBulletin® is installed

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.

In the next step, all you need to do is add some parameters in the form shown bellow:

vBulletin install step 2

Vb User id

The option is used for ArticleBot to generate comments thread for respective articles

Vb Forum id

This indicates where to store auto-generated threads

vBulletin install step 2a

Select admin groups

Use this field to select an appropriate vBulletin® group to suit a Vivvo admin group

vBulletin install step 2b

Select editor groups

Use this field to select an appropriate vBulletin® group to suit a Vivvo editor group

vBulletin install step 2c

Select trusted writer groups

Use this field to select an appropriate vBulletin® group to suit a Vivvo trusted writer group

vBulletin install step 2d

Select writer groups

Use this field to select an appropriate vBulletin® group to suit a Vivvo writer group

vBulletin install step 2e

Select premium member groups

Use this field to select an appropriate vBulletin® group to suit a Vivvo premium member group

vBulletin install step 2f

Select member groups

Use this field to select appropriate a vBulletin® group to suit a Vivvo member group

vBulletin install step 3

Next, you will be informed that the plug-in was successfully installed and configured. Also the important notice will appear:

“From this point on, vBulletin® 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 vBulletin® administrator credentials.”

Choosing the finish task will print a message saying you should login into Vivvo.

After the vBulletin bridge installation, it is necessary to set 'Vivvo comments' option in Vivvo administration - Layout & modules - Modules to 'No'

How to Uninstall?

To uninstall vBulletin® integration plug-in you need to click on the uninstall icon on the right side of the plug-in name.

vBulletin uninstall

This will take you to the page with the link for uninstall: Click here to Uninstall the plug-in

vBulletin uninstall step 1

You will be informed that the plug-in was successfully uninstalled. After clicking on a logout link Click here to logout, you will be taken back to the main login screen. From this point on you can login into Vivvo only by using your Vivvo credentials.

vBulletin uninstall step 2

After the vbulletin bridge de-installation, it is necessary to set 'Vivvo comments' option in Vivvo administration - Layout & modules - Modules to 'Yes'

After the deinstallation return the Vivvo comment template (comments.tpl instead of vb_comments.tpl)

Access

The path to the vBulletin® integration plug-in:

Click on the Plug-ins link (which is located in Main menu at the top of your administration panel).

Choose vBulletin® integration plug-in from the list of all installed plug-ins (on the left side of the screen).

User level

This plug-in can be accessed only by users with administrator-level privileges.

Actions

vBulletin log in

You need to log in via Log in form with your username and password. If the user credentials are right, you will pass the validation and after this you’ll be logged to both systems.

vBulletin logged in

To log out from the system, use the Log out form. This will take effect on the site as well as on the forums.

This plug-in requires editing one code line in the template file. In order to add this functionality and activate vBulletin® integration module you should make the required change:

Open /xhtml/article/default.tpl file and instead of this code line:

<vte:include file="{VIVVO_TEMPLATE_DIR}box/comments.tpl" /> (around line 47)

place the following:

<vte:include file="{VIVVO_TEMPLATE_DIR}box/vb_comments.tpl" />