Add-On Releases - AJAX Tabs Content Script - Version 3.0 (YUI)

AJAX Tabs Content Script - Version 3.0 (YUI)

This is written for implementation within both vBa CMPS AND within vbulletin (can add to any existing vbulletin template or custom template for use on custom vB pages)

Description/Whats changed within this new release?: This newest released version is based on YUI TabView http://developer.yahoo.com/yui/tabview/.

NOTE: This is an initial release with some of the basic features of YUI TabView. More Powerful Enhancements Addons/Enhanced Configuration settings will be released as soon as I write them up. I already have multiple enhancements underway. All Content Files that have been release with previous versions still work.

Note: I've included sample content files in the attached Zip File to use with the step by step how to.


THE BASICS TO GET YOU STARTED

The Following 5 easy steps will get the base system installed. Once you have the base system installed and tested, then move onto the Advanced Customization Steps.

Step 1. Upload the clientscript directory (located in the attached Zip File) to your vbulletin root directory (This will add all the new YUI files to the existing vbulletin clientscript/yui directory).

Step 2. EDIT and Upload the 3 sample content files (located in the SAMPLE CONTENT FILES FOLDER within the attached Zip File) to your vbulletin root directory.

NOTE: Edit the 3 sample content files to change the MODIFICATION CONTROL OPTIONS (starting at line 31) for your testing (mainly the ForumIDs so you can see sample result data)

NOTE 2: For those of you that have used previous versions, you can use your existing content files. (simple edit the template in step 4 to use your existing content files to test instead of the samples)

Step 3. Add the below code to the end of your HEADINCLUDE TEMPLATE.

<!-- YUI 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/tabview-skin.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-min.js"></script>

STEPS 4 and 5 are for vBa CMPS Use Only.... Skip these steps and follow the ALT Step for vB Pages.

Step 4 (FOR vBa CMPS ONLY). Create a new TEMPLATE Module.

Module Title: What ever you want to name it.(ie, Tab Content)
Template to Include: What ever you want to name it (ie, Tab_Content_Main)
Select the Styles you want it added to.
Template Content: Paste the below code into the box.
Use Module Wrapper Template: NO
Usergroup Permissions: Set your perms to your liking

<!-- YUI Tabs Display Start -->

<div id="tab_container"></div>

<script type="text/javascript">
var tabView = new YAHOO.widget.TabView();

	YAHOO.plugin.Dispatcher.delegate( new YAHOO.widget.Tab({ label: 'tab 1', dataSrc: 'tabsample1.php', cacheData: false, active: true }), tabView);
	YAHOO.plugin.Dispatcher.delegate( new YAHOO.widget.Tab({ label: 'tab 2', dataSrc: 'tabsample2.php', cacheData: false }), tabView);
   	YAHOO.plugin.Dispatcher.delegate( new YAHOO.widget.Tab({ label: 'tab 3', dataSrc: 'tabsample3.php', cacheData: false }), tabView);
   	tabView.appendTo('tab_container');

</script>

<!-- YUI Tabs Display End  -->

Step 5 (FOR vBa CMPS ONLY). Add the New Module to a page and test it out. You should have a Tabbed Module with 3 Tabs (tab 1, tab 2 and tab 3) and all 3 should display a layout similar to the Recent Threads Module (unless you used your own custom content modules).


ALT Step for vB Pages(To Use on any vB Page). Simply add the following code to any vBulletin Template for where you want Tabs to display.

<!-- YUI Tabs Display Start -->

<div id="tab_container"></div>

<script type="text/javascript">
var tabView = new YAHOO.widget.TabView();

	YAHOO.plugin.Dispatcher.delegate( new YAHOO.widget.Tab({ label: 'tab 1', dataSrc: 'tabsample1.php', cacheData: false, active: true }), tabView);
	YAHOO.plugin.Dispatcher.delegate( new YAHOO.widget.Tab({ label: 'tab 2', dataSrc: 'tabsample2.php', cacheData: false }), tabView);
   	YAHOO.plugin.Dispatcher.delegate( new YAHOO.widget.Tab({ label: 'tab 3', dataSrc: 'tabsample3.php', cacheData: false }), tabView);
   	tabView.appendTo('tab_container');

</script>

<!-- YUI Tabs Display End  -->

Now that you have added the code to a template, test the page out. You should have a Tabbed Layout with 3 Tabs (tab 1, tab 2 and tab 3) and all 3 should display a layout similar to the Recent Threads Module (unless you used your own custom content modules)



ADVANCED CUSTOMIZATION

Now that you have the new base system installed, its time to Customize the Tabs. Customization includes CSS to match your style(s), Controlling the Tabs and Custom Content for each Tab


TABS

To control the tabs, you will need to modify the template created in Step 4.

Lets examine a tab (the line of code in the template for each tab). The first example is for the ACTIVE tab (the one that is launched when the page is first displayed). The 2nd is for all other tabs since you only have one active tab.

What you need to be concerned with is what is inside the {} (I've highlited this in RED)

lable: This is the Display Name of the Tab
dataSrc: This is the content file associated with the specific tab
cacheData: This allows you to control whether the content from the dataSrc is to be cached or to be called each time the tab is selected. Set this to false if you want the data to be updated when you click on the tab. Set it to True if you want the data to be cached upon page launch
active: true .. only use this for the first tab.

ACTIVE TAB EXAMPLE

YAHOO.plugin.Dispatcher.delegate( new YAHOO.widget.Tab({ label: 'tab 1', dataSrc: 'tabsample1.php', cacheData: false, active: true }), tabView);

NON ACTIVE TAB EXAMPLE

YAHOO.plugin.Dispatcher.delegate( new YAHOO.widget.Tab({ label: 'tab 2', dataSrc: 'tabsample2.php', cacheData: false }), tabView);

CSS

You will probably notice that there are TWO CSS Files that are being called in the HEADINCLUDE template (tabview.css & tabview-skin.css). I broke the CSS into two files so that the control elements that SHOULD NOT be edited are contained in one file (tabview.css) and the control elements that CAN be edited are in the other (tabview-skin.css).

I made plenty of comments in the tabview-skin.css file that should help you change the tab colors to match your style. Just simply look for the Color Elements and match them to the color elements of your Styles CSS. I am FAR from a CSS guru.. I learned by playing around with the settings

The tabview-skin.css file is located in: clientscript/yui/tabview/assets/tabview-skin.css


Content Files

Please see posts 2&3 of this thread for additional enhancements. Members are encourage to provide their custom content file for inclusion in Post 3.

[TheInsaneManiac]

Originally Posted by bobster65

If you are talking about TFH (Tabbed Forum Home) then NO this is something different .. TFH V2 (BETA) will be released sometime in the next few days... HOWEVER, if you know what you are doing, you can use parts of this to pull it off (you can use the backbone of this to convert TFH v2 from the dynamic drive AJAX JS to YUI .....I see a few that have already done so) .. however, this is NOT a replacement for TFH..... this is an update to a MOD that has been through multiple phases over the past few years now for displaying Tabbed External Content.

I'd rather wait until you get everything worked out.

[bobster65]

Originally Posted by TheInsaneManiac

I'd rather wait until you get everything worked out.

If you are only wanting to do Tabbed Forum Home, its best to wait for that specific MOD.. however, the new TFH will also be able to use any content files made for this as well

[TimberFloorAu]

Originally Posted by bobster65

That would be something built into that specific content file. I'll look into that. You MIGHT take a quick look at the "news" content file as it sorta has some of that functionality built in (the dynamic creation of the create new thread button for the specific forum that the news item resides in..

Have had a look Bob, and looks very good. Will wait until you can rovide some instruction on implementation

Ste

[Trana]

Originally Posted by bobster65

I have built over 100 custom content files for various sites so far lol..

Can you share what some of them do? I know all the basic ones, just wondering what other sites have done with this.

Thanks!

[karlm]

On one of the demonstration pages you supplied (I forgot the link at this moment), it has a rotating image which holds an image if you hover the mouse of that tab... is that what this is? If not, could you point me in the direction of where to acquire a similar finish. Because that is something I'm kind of looking for.

[bobster65]

Originally Posted by Trana

Can you share what some of them do? I know all the basic ones, just wondering what other sites have done with this.

Thanks!

I'll put together a full list one of these days.. lots of different variations of recent threads and news (to the clients specifications).. same thing with the blogs.. just did a blog on yesterday that looks similar to recent threads with a snippet of the Blog Text under the title (see the Blogs Tab here: http://www.usafacommunity.com/). I've done a lot of custom recent threads with Thumbnails (which I believe you have).. I've got a few variations of vBa Links Directory stuff, 5 or 6 different Photo Album ones, Just about every CMPS Module I have custom versions of.. lots of stuff for the forum home page like the whos online area tabbed out with some of the more popular addons from Paul and Cyb.. A bunch of different vBookie ones... some sports ones.. the list is pretty extensive lol... I've done so many that I can't remember them all.. those are just ones that involve vbulletin.. I've got a ton that do dynamic external stuff integrated with vB as well..

Won't even go into the simple static HTML files that are beyond easy for anyone to knock out lol

[gfxhelp.com]

I think I'll waiting til the beta is finished, but looks like it will be great. For the people who've integrated it into their site, can you post a link so the rest of us can check it out?

[romanticyao]

Installed, btw bobster65 , I sent u a pm regarding some custom work hope u have time to check it out

[4x4 Mecca]

I may be dumb, and in the last three pages, I might have missed it, but i get the error for CMPS
so I took out the line require_once('./includes/vba_cmps_global.php'); and it loads the tab, but it doesn't show any content, just a thin line saying "Title, Username, Date Last Post Replies Views"
My site is www.socaloffroading.com but I'll probably have it changed or fixed by the time you reply, lol I usually do.

[4x4 Mecca]

never mind, this is over my head, i can't get it working. I even read that this was an update, so I went back and installed v2 and now neither one work