Table of Contents
Plugin General Details
- Description: Description of the plugin
- Full Path to Software: The complete server path to the directory vBulletin is installed. For example, /var/www/vbulletin or C:\web\htdocs\vbulletin
- Full URL to Software: Full URL to vBulletin like http://yoursite.com/vbulletin
- Allow vB SEF urls (vB4 only): vB4 features some basic SEF built in. Enabling this will enable JFusion to do some basic SEF rewriting of direct vB urls in JFusion's various modules and plugins such as the login module, activity module, search plugin, etc.
Database Options
- Database Type (ie mysql): Enter mysql or mysqli
- Database Host: Host storing vB's database
- Database Name: Name of vB's database
- Database Username: Username to vB's database
- Database Password: Password to vB's database
- Table Prefix: Prefix before all columns in vB's database. vBulletin usually defaults to vb_ unless you changed it during installation.
- Database Character set Character set for the database. Leave as UTF8 for the most compatibility.
Login Options
- Login Identifier: Through JFusion, you have the option to use a user's username, email, or either one as an identifier to use when logging in through Joomla. This is especially handy if you have an email-only plugin set as master but want to keep existing usernames in vBulletin. In that case, choose Email. Usually you will want Username selected though.
- Cookie Domain The domain for the login cookies that will be created. For the most compatibility, this should be .mydomain.com
- Cookie Path Should be the same as the Cookie Path set in vBulletin's options. Usually this is just /
- Cookie Prefix By default, this is bb unless changed in vBulletin's config file
- Cookie Salt This string is regenerated every time you download a new package from vB's site and install it. It must be updated every time you update. Running the wizard should automatically obtain this for you. However, if it fails, you can get it by opening includes/functions.php and it will be near the top. This must be correct in order for dual login to work!!
- Cookie Expiration Time The amount of time a cookie expires. Set to 0 to set the cookie as a session cookie
- Secure Creates a secure cookie (https)
- HTTP only Creates a http cookie
User Options
- Profile field to use as user's name This will use the selected custom field as the user's “real name.” Note it will not sync between Joomla! Enabling this may cause some drastic performance issues if you have a very large forum.
- Usergroup Management: Here you may have two options for usergroup management, simple and advanced. If vB is set as the master, then you can only use simple mode. Simple mode will allow for a single selection of a Default Usergroup that each new user created by JFusion is assigned to (after they have been activated if activation is enabled). Once the group is assigned, it is never changed by JFusion. However, you have the option to enable the advanced mode if vBulletin is set as a slave. In advanced mode, you can assign a Default Group, Display Group, and/or Member Groups (secondary groups) to each of the master plugin's groups. If the group is changed in the master, JFusion will automatically update the groups of vBulletin to that which is paired to the master group when the user logs in. So for example, you let's say you have vBulletin's group Registered Users paired with Joomla's Registered and vBulletin's Administrator paired with Joomla's Administrator. If a user is in Joomla's Registered group and is changed to an Administrator, they will automatically be made part of the Administrator group in vBulletin. (Note, that even though a user may belong to the Administrator group in vBulletin, you must manually set permissions for each Administrator via vBulletin's admincp in order for the user to function as an admin.)
- Usergroup for users awaiting activation: Choose the group to place newly created users into while they are awaiting activation (only applicable if you have activation required enabled for the master plugin)
- Usergroup for banned users: Choose the group to place banned users into
- Ban COPPA Users If vB is master, you can choose to return COPPA users as banned so that they are not given access to the other softwares.
- Auto Update Activation: If set to yes and vBulletin is set as slave, vB's user's activation status will automatically be updated to that of the masters.
- Auto Update Bans: If set to yes and vBulletin is set as slave, vB's user's ban status will automatically be updated to that of the masters.
- Custom Block Message Message presented to users when they are blocked by JFusion
- Auto Update Email: If set to yes and vBulletin is set as slave, vB's user's email will automatically be updated to that of the masters.
- Create new user in this software for inactive users If set to no, users from the master that are inactive will not be created in vBulletin
- Create new user in this software for blocked users If set to no, users from the master that are blocked will not be created in vBulletin
- Allow user deletion: If set to yes, the user will be deleted from vB if deleted from Joomla
Mod/Plugin Options
*Frameless integration and the Redirect plugin are only supported in vB 3.x*
- Menu Item for Redirection: Choose a JFusion menu item to be used to generate correct URLs for the Frameless Integration and Redirect Plugin. Required if enabling the Frameless Integration or Redirect Plugins.
- Redirect Plugin Filter List filenames or keywords in filenames to be ignored by the redirect plugin. Separate each filename or keyword with a comma (,). Note that you must reinstall the redirect plugin and reset vB's cache each time you change this value.
- Custom moderator directories If for security reasons you renamed the moderator directories, you need to enter the appropriate directory names for Administrator CP and Moderator CP. The default is admincp and modcp.
- Frameless Integration Plugin: This must be installed if you plan on using Frameless integration for vBulletin. Note: If you change the menu item, toggle SEF and or SEF mode, you must reinstall this plugin. Please read the Frameless Guide before attempting to use vB in frameless mode.
- Redirect Plugin: This plugin redirects users who browse directly to the forum to Joomla's frameless equivalent. Note: This will not work for wrapper integration as it will cause a never ending loop. If you change the menu item, toggle SEF and or SEF mode, you must reinstall this plugin.
- Dual Login Plugin: Enable this if you want users to be able to use vBulletin's login forms to also log in to/out of Joomla and subsequent JFusion plugins.
If you enable, disable, or reinstall any of the above plugins, you must refresh vB's cache. You can do this by logging into vB's admincp then select Plugins & Products → Plugin Manager. At the bottom of the page, click the 'Save Active Status' button. This will regenerate vB's cache.
Frameless Integration Options
- SEF Mode: Note: JFusion is only compatible with Joomla's standard SEF. Choose which SEF format you want displayed for vB's frameless URLs. This means. sh404sef is NOT supported. (joomla plugin) - Discuss in Forums:http://www.jfusion.org/index.php/forums/viewtopic.php?f=14&t=3070 Workaround: http://www.jfusion.org/index.php/forums/viewtopic.php?p=18195#p18195
- Frameless Optimization: Optimizing vB will help with both performance and functionality. If you choose to optimize, relative URLs for smilies, avatars, icons, and the default forum icon will be changed to absolute URLs. This is especially needed if you have AJAX enabled.
- Parse CSS: vB dynamically adds its CSS descriptors to the header of vBulletin. If you find that your forum's template is messed up when you are viewing it framelessly, change this to Yes. Note that this will decrease performance as all CSS must be parsed. Read the Frameless Guide for vBulletin for more information and troubleshooting.
- Custom Lost Password URL URL to a custom lost password page. Useful if you use another software to manage users.
- Custom Registration URL URL to a custom registration page. Useful if you use another software to manage users.
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Noncommercial-Share Alike 3.0 Unported







