vb.org Archive - Forum Home Enhancements

Installing v2.0.x is much simpler than any previous version of TFH to install, first, you want to remove the following files and revert changes from previous versions to the templates. Note: You may want to keep the tab's data for reference later.

Step 1: Make Reverts

The first step is to revert your forum to not include any tabs, this will be a clean slate for TFH and improve the quality of the installation instructions. Listed below is template edits, file edits, and uploaded files for you to remove and change back to the original. For full reverts needed, please look at the install docs for version 1.0x located in the download package.

1.0x
1. FORUMHOME - template edits
2. index.php - file edits; the easiest way to revert this is to download the vBulletin package that corresponds to your version and upload index.php overwriting your changes.
3. /forum_root/tabs/* - added files, remove directory and files within.
4. /index_tab.php - An edited copy of index.php if is still there, remove it.
5. /index_*.php - the backup file the install docs instructed you to change, you may either remove this or rename it back to index.php. This may not correspond to your current version, so your best bet would be the step described in #2.
1.5.0 Beta
1. clientscript/tabs/ajaxtabs.css - added file, delete.
2. clientscript/tabs/ajaxtabs.js - added file, delete.
3. clientscript/tabs/loading.gif - added file, delete.
4. /tabforumhome.php - added file, delete.
5. FORUMHOME - template edits, see install doc for v1.5.0 for full changes.
6. forumhome_forumbit_level1_post - template edits, see install doc for v1.5.0 for full changes.
7. forumhome_forumbit_level1_nopost - template edits, see install doc for v1.5.0 for full changes.
8. FORUMHOMETAB - remove the template; clicking [Revert] on the custom template should remove this

Now that you have reverted changes from previous versions, the installation of v2.0 comes next.

Step 2: File Uploads

You want to upload the following files to your server into the corresponding directory on your server. These files are found in the "UPLOAD" folder of the package. Note: The Uploads folder has a syntax of sorting files into sub-folders. These folders correspond to the default names for folders in a vBulletin installation. The files directly found within the "UPLOAD" folder signify the forum root.

Upload the following files:

/tabindex.php
/tab_blog.php - Note: This is used by the default vBulletin Blog Module. This requires vBulletin Blog to be installed and activated to work.
/tab_blog_entry.php - Note: This is not used by the default vBulletin Blog Module. This requires vBulletin Blog to be installed and activated to work. To set the blog module to use this file, use the "Edit Module Functionality" to set the file name to this file.
/tab_pt.php - Note: This file is not currently being shipped with Beta 1 - it will ship with Beta 2! This file will be used for the default Project Tools module and requires vBulletin Project Tools to be installed and activated to work.
/clientscript/yui/tabview/* - Upload the directory tabview and all files inside of it.
/clientscript/yui/elements/* - Upload the directory elements and all files inside of it.
/clientscript/yui/fonts/* - Upload the directory fonts and all files inside of it.
/clientscript/yui/utilities/* - Upload the directory utilities and all files inside of it.
/includes/xml/cpnav_tfh.xml
/admincp/tfh.php
/admincp/tfh_fixes.php
/admincp/tfh_impex.php
/admincp/tfh_modules.php

Step 3: Product Import

To do the bulk of the installation, all you need to do is import the file called product_bobster_tfh.xml by following entering the ACP and following this set of links:

ACP -> Plugins & Products -> Manage Products -> [Add/Import Product]

Once you import the product, it will add a template called "FORUMHOMETAB" to all your styles. This template includes the default template data located within the FORUMHOME template's  comments.

Step 4: Template Edits

Template: FORUMHOME

Find:

HTML Code:

</head>

Add Before that line:

HTML Code:

<!-- Tabbed Forum Home Header Code -->        

<!-- Dependencies -->

<!-- TFH Skin CSS for TabView -->

<link rel="stylesheet" type="text/css" href="clientscript/yui/tabview/assets/tabview.css" />

<link rel="stylesheet" type="text/css" href="clientscript/yui/tabview/assets/skin-tfh.css" />



<!-- JavaScript Dependencies for Tabview: -->

<script type="text/javascript" src="clientscript/yui/utilities/utilities.js"></script>

<script type="text/javascript" src="clientscript/yui/element/element-beta-min.js"></script>



<!-- Source file for TabView -->

<script type="text/javascript" src="clientscript/yui/tabview/tabview-min.js"></script>



<!-- Source file for Dispatcher -->

<script type="text/javascript" src="clientscript/yui/tabview/dispatcher.js"></script>



<!-- /Tabbed Forum Home Header Code -->

If you have a custom FORUMHOME template, follow Option 2 instead of Option 1.

OPTION 1:
Find:

HTML Code:

<!-- main -->

<table class="tborder" cellpadding="$stylevar[cellpadding]" cellspacing="$stylevar[cellspacing]" border="0" width="100%" align="center">

<thead>

        <tr align="center">

          <td class="thead">&nbsp;</td>

          <td class="thead" width="100%" align="$stylevar[left]">$vbphrase[forum]</td>

          <td class="thead">$vbphrase[last_post]</td>

          <td class="thead">$vbphrase[threads]</td>

          <td class="thead">$vbphrase[posts]</td>

          <if condition="$vboptions['showmoderatorcolumn']">

          <td class="thead">$vbphrase[moderator]</td>

          </if>

        </tr>

</thead>

$forumbits

<tbody>

        <tr>

                <td class="tfoot" align="center" colspan="<if condition="$vboptions['showmoderatorcolumn']">6<else />5</if>"><div class="smallfont"><strong>

                        <a href="forumdisplay.php?$session[sessionurl]do=markread" rel="nofollow">$vbphrase[mark_forums_read]</a>

                        <if condition="$vboptions['forumleaders']">&nbsp; &nbsp;

                        <a href="showgroups.php$session[sessionurl_q]">$vbphrase[view_forum_leaders]</a></if>

                </strong></div></td>

        </tr>

</tbody>

</table>

$forumhome_markread_script

<!-- /main -->

Replace with:

HTML Code:

<!-- main -->



<!-- Tabbed Forum Home -->

<div id="forumhome_container">

</div>



<script type="text/javascript">

                $tfh

</script>

<!-- /Tabbed Forum Home  -->

        

<!-- /main -->

OPTION 2 - This is for boards with custom FORUMHOME templates.
Find (This is the default template, yours will vary.):

HTML Code:

<!-- main -->

<table class="tborder" cellpadding="$stylevar[cellpadding]" cellspacing="$stylevar[cellspacing]" border="0" width="100%" align="center">

<thead>

        <tr align="center">

          <td class="thead">&nbsp;</td>

          <td class="thead" width="100%" align="$stylevar[left]">$vbphrase[forum]</td>

          <td class="thead">$vbphrase[last_post]</td>

          <td class="thead">$vbphrase[threads]</td>

          <td class="thead">$vbphrase[posts]</td>

          <if condition="$vboptions['showmoderatorcolumn']">

          <td class="thead">$vbphrase[moderator]</td>

          </if>

        </tr>

</thead>

$forumbits

<tbody>

        <tr>

                <td class="tfoot" align="center" colspan="<if condition="$vboptions['showmoderatorcolumn']">6<else />5</if>"><div class="smallfont"><strong>

                        <a href="forumdisplay.php?$session[sessionurl]do=markread" rel="nofollow">$vbphrase[mark_forums_read]</a>

                        <if condition="$vboptions['forumleaders']">&nbsp; &nbsp;

                        <a href="showgroups.php$session[sessionurl_q]">$vbphrase[view_forum_leaders]</a></if>

                </strong></div></td>

        </tr>

</tbody>

</table>

$forumhome_markread_script

<!-- /main -->

Copy your custom modifications and replace the contents of the template "FORUMHOMETAB" with your custom modifications - nothing will be lost from TFH as the template FORUMHOMETAB is just a copy of the default code within  and .

After you have copied your code, replace the code you copied above (in the FORUMHOME template) with:

HTML Code:

<!-- main -->



<!-- Tabbed Forum Home -->

<div id="forumhome_container">

</div>



<script type="text/javascript">

                $tfh

</script>

<!-- /Tabbed Forum Home  -->

        

<!-- /main -->

Template: forumhome_forumbit_level1_nopost, forumhome_forumbit_level1_post

Add this code to the beginning of the template:

HTML Code:

<if condition="(THIS_SCRIPT == 'indexTAB' AND in_array($forum['forumid'], $GLOBALS[tabcats]) OR in_array('all',$GLOBALS[tabcats])) OR THIS_SCRIPT == 'forumdisplay'">

Add this code to the end of the template:

HTML Code:

</if>

Template: forumhome_forumbit_level1_nopost

Find:

HTML Code:

<a style="float:$stylevar[right]" href="#top" onclick="return toggle_collapse('forumbit_$forumid')"><img id="collapseimg_forumbit_$forumid" src="$stylevar[imgdir_button]/collapse_tcat{$collapseimg_forumid}.gif" alt="" border="0" /></a>

Replace with:

HTML Code:

                        <a style="float:$stylevar[right]" href="#top" onclick="return toggle_collapse('forumbit_$forumid$GLOBALS[tabID]')"><img id="collapseimg_forumbit_$forumid$GLOBALS[tabID]" src="$stylevar[imgdir_button]/collapse_tcat{$collapseimg_forumid}.gif" alt="" border="0" /></a>

Find:

HTML Code:

<tbody id="collapseobj_forumbit_$forumid" style="{$collapseobj_forumid}">

Replace with:

HTML Code:

<tbody id="collapseobj_forumbit_$forumid$GLOBALS[tabID]" style="{$collapseobj_forumid}">

X vBulletin 3.8.12 by vBS Debug Information
Page Generation 0.01444 seconds Memory Usage 1,812KB Queries Executed 10 (?)
More Information
Template Usage: (1)ad_footer_end (1)ad_footer_start (1)ad_header_end (1)ad_header_logo (1)ad_navbar_below (2)bbcode_code_printable (12)bbcode_html_printable (1)bbcode_quote_printable (1)footer (1)gobutton (1)header (1)headinclude (6)option (1)pagenav (1)pagenav_curpage (2)pagenav_pagelink (1)pagenav_pagelinkrel (1)post_thanks_navbar_search (1)printthread (10)printthreadbit (1)spacer_close (1)spacer_open Phrase Groups Available: global postbit showthread	Included Files: ./printthread.php ./global.php ./includes/init.php ./includes/class_core.php ./includes/config.php ./includes/functions.php ./includes/class_hook.php ./includes/modsystem_functions.php ./includes/class_bbcode_alt.php ./includes/class_bbcode.php ./includes/functions_bigthree.php Hooks Called: init_startup init_startup_session_setup_start init_startup_session_setup_complete cache_permissions fetch_threadinfo_query fetch_threadinfo fetch_foruminfo style_fetch cache_templates global_start parse_templates global_setup_complete printthread_start pagenav_page pagenav_complete bbcode_fetch_tags bbcode_create bbcode_parse_start bbcode_parse_complete_precache bbcode_parse_complete printthread_post printthread_complete
Messages: