Register Members List Search Today's Posts Mark Forums Read

Reply
 
Mod Options
AJAX Tabs Content Script v2 Details »
AJAX Tabs Content Script v2
Mod Version: 2.0, by bobster65 (Member) bobster65 is offline
Developer Last Online: Nov 2013 I like it Show Printable Version Email this Page

This modification is in the archives.
vB Version: 3.6.x Rating: (16 votes - 4.94 average) Installs: 108
Released: 26 Oct 2007 Last Update: Never Downloads: 1018
Not Supported Additional Files Translations  

AJAX Tabs Content Script - Version 2.0

Note: Altho this "How To" is written for implementation within vbadvanced CMPS, this can also be easily implemented anywhere within vB , ie on custom vB pages or within current vB pages.

Description/Whats changed within this release?: This new version (based on the AJAX Tabs Content Script (v 2.0) written by Dynamic Drive - http://www.dynamicdrive.com/dynamici...tent/index.htm) is a versatile Ajax script that lets you display content pulled from external files inside a DIV and organized via CSS tabs. A fully unobtrusive, CSS and HTML based script, it supports practical features such as persistence of the active tab (ie: when page is reloaded), an "IFRAME" mode, a "slideshow" mode, ability to expand/contract arbitrary DIVs on the page at the same time, nested tabs, and much more. Below lists the features of this script that together make it highly adaptable in the real world:

Here's a quick outline of the script features:
  • Fetch and display an external page (from the same domain) inside a container when a tab is clicked on via Ajax.
  • (v 2.0) Apart from Ajax, an external page can also be fetched and displayed via the IFRAME element instead. This is useful for external pages that either contain JavaScript/ CSS code that doesn't run properly when fetched via Ajax, or the page is from an outside domain.
  • Add a "default" content inside the container to either be shown while no tabs are selected, or to be associated with a specific tab. The default content is added inline on the page and not fetched via Ajax, to avoid unnecessary fetching of external pages.
  • Supports session only persistence, so the last tab user clicked on is remembered if he/she returns to the page within the same browser session.
  • (v 2.0) Supports auto "slideshow" mode, in which script automatically cycles through and selects each tab periodically until a tab is explicitly selected.
  • (v 2.0) Ability to also expand/contract arbitrary DIVs on the page as the tabbed content is expanded/ contracted.
  • (v 2.0) Ability to dynamically select a tab either based on its position within its peers, or its ID attribute.
  • (v 2.0) Ability to directly load a different external page into the content container, either via Ajax or IFRAME.
  • (v 2.0) Ability to set where the CSS class "selected" get assigned when a tab is clicked on- either on the tab link itself (its "a" element), or its parent instead (ie: "li" element). This makes the script adaptable to both CSS Tabs that are styled at the "A" level itself, or its parent container instead.
  • (v 2.0) Supports nested Ajax Tabs! In other words, you can have an external page fetched via Ajax contain in itself Ajax Tabs that show their own contents when clicked on as well. This is made possible using the "onajaxpageload" custom event handler (see documentation).
  • Supports multiple Ajax Tabs Contents on the same page.
  • Fully unobtrusive, search engine friendly design. For search engines or browsers with JavaScript disabled, the external contents will just load as actual pages (instead of via Ajax).

Reminder: Due to security limitations, the external pages loaded via each tab using Ajax must reside on the same domain as the script itself. This limitation doesn't apply if you use the "IFRAME" option to fetch and show the external page instead.

This is what I've done so far to implement AJAX Tabs functionality for my websites and others. I hope that its easy to follow along, answers your questions and meets your needs. If you are reading this and wondering what a tabbed content is, check out the screen shots for a visual.

CMPS Version Note: Coded for CMPS v3.0. Modifications can be made to the php files (Require Back-End) to work with CMPS v2.x

CMPS Module Type: TEMPLATE w/Alternative Module Wrapper Template
Templates: adv_portal_Tab_Block_Main, adv_portal_alt_module_wrapper (optional)
Files: ajaxtabs.js, ajaxtabs.css, Sample Content Files, images

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

Step 1. Upload the ajaxtabs directory (located in the attached Zip File) to the FORUMS Root.
This directory contains the ajaxtabs.js file & the ajaxtabs.css file
path example: /www/forums/ajaxtabs/ajaxtabs.js


Step 2. Modify CSS file.
Use Attached Sample CSS file - Sample name: ajaxtabs.css
Change paths to images to reflect your domain and forum root (2 lines)...

Note: Additional Modifications to this file can be made once you get the initial sample system up and running.


Step 3. Create, Name and Upload Multiple "Content" files.
Use attached Sample PHP "Content" file - Sample name: tabexternal.php (I've included working samples in the attached Zip File).

NOTE: Please read the Instructions TXT File for the edits that need to be made in order for them to work on your site.

The location I chose for these was the FORUMS root.
path example: /www/forums
You can name these files anything you want. For example, I chose a naming convention - tabexternal.htm, tabexternal2.php, tabrecentnews.php, tabvbookie.php, ..etc etc

Note: Further Modifications to these files can be made once you get the initial system up and running.


Step 4. (optional) Create an Alternative Module Wrapper Template.
Use attached Sample Alternative Module Wrapper Template - Sample name: adv_portal_alt_module_wrapper

I chose to do this, because I didn't want to use the standard Module Wrapper that comes default with vBadvanced.

NOTE: Use the default wrapper if you choose not to create your own custom one.


Step 5. Create a new Template.
Use attached sample Custom Template Sample name: adv_portal_Tab_Block_Main

This template will be the one that you include with the module that you will create in Step 6. I've included the code for the sample template in the attached file, HOWEVER, there are some edits that you will need to make to the code based upon steps 1-3 above.

EDITS NEEDED TO THE ATTACHED SAMPLE TEMPLATE:

EDIT 1 - Path location of the ajaxtabs.css file created in step 2. Simply edit this line in the template to the correct path.

Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.

EDIT 2 - Path location of the ajaxtabs.js file in step 1. Simply edit this line in the template to the correct path where you uploaded the ajaxtabs.js file.

Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.

EDIT 3 - Path location of the "Content" file(s) created in step 3. Simply edit the line(s) in the template to the correct path where you uploaded the PHP file(s).

Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.


Step 6. Create a new CMPS TEMPLATE Module.
Name it what ever you like. Include the template that you created in Step 5 above. Make sure that you either use the Module Wrapper Template OR the Alternative Module Wrapper Template that you created in optional Step 4 above. Give permission(s) to the user groups that you want to be able to view this.


Step 7. Add the Module to a CMPS page.
Add the module created in Step 6 above to any CMPS page (make a test page if you want to)...


Step 8. Load the CMPS page that you added the module to.
If you performed the above steps correctly, the result will be a tabbed block module with 4 tabs named Tab 1, Tab 2, Tab 3, Tab 4. The content for Tab 1 will say "Congrats USERNAME! You have successfully added AJAX Tab Content to your Site."


CUSTOMIZATION

Style: Modify CSS File in Step 2 to match the Style of your site. The Sample CSS Files comes with 3 different styles of Tab Layouts. Choose the one that best suits your needs and further modify the CSS to match your sites Style(s)....

Tab Names: Modify Template created in Step 5 to change the NAME of the tabs themselves - ie.. from Tab 1 to Announcements (see below)


Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.


Content: Modify "Content" File(s) created in Step 3 to generate content. You can add static content or Dynamic Content. Below is a very very basic sample of what can be done.

Sample mix of static and dynamic content

Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.

NOTE: You can get as creative as you want to with content (Both static and Dynamic). For example, I took code from the recentthreads.php file, modified it and included that as tabbed content to display recent threads within a tab on my site (as seen in the screen shots attached in Post 1 of this thread). (I've included samples with instructions of this within the zip file. Side Note: use/modify these samples at your own risk)


Turning on "slideshow" mode

You can have the tabs within your Ajax Tabs Content automatically rotate every x seconds until a user explicitly clicks on a tab. To enable "slideshow" mode on your Tab Content, just pass in an integer when calling instance.init() to initialize your script: This is located at the bottom of the Template you created in step 5


Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.

Notice the integer in red, which is in units of milliseconds. With one defined, the script will rotate through the tabs every x milliseconds (so 15000=15 seconds).


ADDING MORE TABS

To add more tabs, you will need to modify the template created in Step 5 and create a new "content" file for each new tab (as explained in Step 3).

Step 1. Add the following line of code to the Template that you created in Step 5 for each new Tab that you want to appear. Its a good idea when you add the lines that you keep them in order with the other lines currently in the file.


Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.

Example:

Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.

Step 2. Upload the newly created "Content" file (as explained in Step 3) to your FORUMS root.


Additional Enhancements

Please see post 2 of this thread for additional enhancements.

If you want to read up on AJAX Tabs, check out the Ajax Tabs Content script over at Dynamic Drive (http://www.dynamicdrive.com/dynamici...tent/index.htm)

....thats it in a nutshell.... I do hope that I explained things well enough to at least get a head start on AJAX Tabbed Content. Let me know if you have any problems or need further explanation on anything...

Thanks and enjoy Bobster

Screen Shots Explained:

The 1st is an example of "Slideshow" Mode
The 2nd is an example of some dynamic content based on the user.
The 3rd is an example of modified recentthreads.php used within a tab.
The 4th is an example of using modified vbarticles within a tab.
The 5th is an examples of custom dynamic content within a tab.

Download Now

Only licensed members can download files, Click Here for more information.

Screenshots

Click image for larger version

Name:	tab-slide.gif
Views:	2979
Size:	32.9 KB
ID:	71573   Click image for larger version

Name:	tab1.jpg
Views:	3370
Size:	149.2 KB
ID:	71574   Click image for larger version

Name:	tab2.jpg
Views:	3296
Size:	196.5 KB
ID:	71575   Click image for larger version

Name:	tab3.jpg
Views:	2473
Size:	213.1 KB
ID:	71576  

Click image for larger version

Name:	tab6.jpg
Views:	2504
Size:	144.1 KB
ID:	71577  

Show Your Support

  • To receive notifications regarding updates -> Click to Mark as Installed.
  • If you like this modification support the author by donating.
  • This modification may not be copied, reproduced or published elsewhere without author's permission.
Similar Mod
Mod Developer Type Replies Last Post
Add-On Releases AJAX Tabs Content Script - Version 3.0 (YUI) bobster65 vBulletin 3.8 Add-ons 252 21 Aug 2012 11:42
Forum Home Enhancements Flipped tabs = Swivel tabs = INVERTED TABS Deepdog009 vBulletin 3.7 Add-ons 29 20 Jan 2010 10:39

Comments
  #2  
Old 26 Oct 2007, 19:59
bobster65's Avatar
bobster65 bobster65 is offline
 
Join Date: Mar 2006
Real name: Bob
Additional Enhancements

** Coming Soon ** (Adding on the fly lol)

Different Tab Layout Styles

The attached CSS file contains CSS for 3 different layout styles. To change the inverted style that is preset with the sample, edit the adv_portal_TAB_BLOCK_MAIN template (or what ever you named it) to one of the below samples.. both samples below have the tabs on the top.

This layout is for the shadetabs CSS


Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.

This layout is for the indentmenu CSS


Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.



Dynamically selecting a tab anywhere on your page

After your Ajax Tab script is initialized and displayed, you can dynamically select any of its tabs either based the tab's position relative to its peers, or its ID attribute (you have to assign it one first). The method to call is the following:


Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.

The parameter entered should either a string representing the tab link's ID attribute (you need to first assign one to that tab), or an integer corresponding to that tab's position relative to its peers, to select. For the later, the counting starts at 0 (ie: 0=1st tab). For example:


Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.


Dynamically loading an external page using Ajax

You can dynamically load an external page into the Ajax Tabs content container via Ajax, such as by using a link on the page. It's done with the below method:


Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.

"pageurl" should be the full URL or path to the external file on your server. You cannot use this method to load a page from an outside domain, due to Ajax domain restrictions:


Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.

The selected tab in this case doesn't change when you load a new page directly into the content container using this method.

Dynamically loading an external page using IFRAME

You can also load an external page into the Ajax Tabs content container via IFRAME. What this does is erase whatever previous content was inside the content container, add an IFRAME tag into it, and load the desired page into the IFRAME:

Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.

"pageurl" should be the full URL or path to the external file on your server or beyond. Since the external page is loaded via IFRAME, the page can be either from your domain or outside as well (ie: http://www.google.com):


Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.

In case you're wondering, the IFRAME tag that's added to the content container always carries the CSS class name "tabcontentiframe" and a name attribute of "_ddajaxtabsiframe-contentdivid", where "contentdivid" is the ID of the content container (ie: "countrydivcontainer"). You can further use this information to either style the IFRAME using CSS, or manipulate it somehow by directly accessing it via its name attribute.

Nesting Tabs..

It's possible to have nested Ajax Tabs. That is to say, the external page fetched by one of the tabs can in itself contain a new Ajax Tabs Content instance that loads other content when clicked on. The key is to enlist the help of the custom event handler "instance.onajaxpageload" on your main page to initialize the tabs that are on the external page.

Main Tab Template:


Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.

Nested Template:


Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.

Notice the code in red- this is code that originally should appear inside "nested template", but since the tabs in question are on an external page and being called dynamically via Ajax as nested tabs, the code to invoke it needs to be moved to the main page instead and called via the "onajaxpageload" event handler. This event handler basically fires whenever a tab fetching Ajax content has completed loading the external page in question:


Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.


Use the parameter "pageurl" to determine which tab exactly is being clicked on based on its href attribute value, and only fire your custom code for the correct tab. In this case, since I only want to call my custom code to initialize the nested tabs when the 3rd tab is clicked on, I'm testing for:


Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.

here, or the "href" attribute of the 3rd tab.

Use the above technique to set up nested tabs whenever the nested tabs are contained in an external page and fetched via the Ajax option. If the external page is fetched via IFRAME, the above will not work and is unnecessary anyhow, as the nested tab's invocation code should simply appear within the external page itself.

Last edited by bobster65; 27 Oct 2007 at 15:45.
Reply With Quote
  #3  
Old 26 Oct 2007, 20:00
bobster65's Avatar
bobster65 bobster65 is offline
 
Join Date: Mar 2006
Real name: Bob
Enhanced Recent Threads Layout

See this post - >> http://www.vbulletin.org/forum/showp...5&postcount=29


** ADDITIONAL CONTENT FILES **

This Post will be used to identify member submitted content files and enhancements as well as additional content files that I release.

Attached to this Post:

**UPDATED** RECENT THREADS 09-01-2008 - tabrecentthreadsexp2.php - This file includes Post ICON Column and the ability to set a specific Thread Title Character cut off amount. The UPDATE includes both database thread marking and cookie based thread marking. Various settings at the top of the file make install/Setup a breeze.

**UPDATED** RECENT THREADs with THUMBNAIL 09-01-2008 - tabthumbs.php - This file is the same as tabrecentthreadsexp2.php with the addition of displaying a thumbnail in place of the post ICON if there is a image attached to the first post. You can see an example of this @ www.veggieblogs.com specifically the RECIPES or Cookbooks Tabs. The UPDATE includes both database thread marking and cookie based thread marking. Various settings at the top of the file make install/Setup a breeze.

NEW vB Blogs 02-07-2008 - tab_blog.php - This content file is for use with vbulletins blog system. It is a BASIC recent blogs layout. The File contains 2 Layout Styles (Wide and Small). Wide is the default. To use small (for skinny Tab Layouts) remark out the 2 Wide Layout Areas and uncomment out the 2 ALT Layout Areas. Both display Title, Name, Data and Views.

NEW vBa Links 02-08-2008 - tab_latestlinks.php & tab_latestlinksexp.php - These 2 files are for displaying data from vba links directory (you must have vba links installed for this to work)

Member Submitted Enhancements:

Date - Attachment name - Description - Member Name

NEW GARS 02-07-2008 - http://www.vbulletin.org/forum/showp...&postcount=113 - GARS Content File - ZiG


What to make your own?
Here is an example of how I replicate the User CP CMPS Block in a Tab


Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.



...
Attached Files
File Type: php tab_blog.php (3.4 KB, 34 views)
File Type: php tab_latestlinks.php (3.9 KB, 25 views)
File Type: php tab_latestlinksexp.php (4.2 KB, 22 views)
File Type: php tabrecentthreadsexp2.php (9.8 KB, 22 views)
File Type: php tabthumb.php (10.4 KB, 17 views)

Last edited by bobster65; 01 Sep 2008 at 23:06. Reason: added new content file for vba links
Reply With Quote
  #4  
Old 26 Oct 2007, 20:44
CrossBones's Avatar
CrossBones CrossBones is offline
 
Join Date: Oct 2004
OMG, this is totally RAD...***INSTALLED***

Nice job bobster!

::walk awzy in amazement::
Reply With Quote
  #5  
Old 26 Oct 2007, 21:34
FreshFroot's Avatar
FreshFroot FreshFroot is offline
 
Join Date: Aug 2005
Just amazing.. I wanted to do something like this too. Glad someone else got it done

I vote MOTM!
Reply With Quote
  #6  
Old 26 Oct 2007, 22:53
Strike3ForumsMH Strike3ForumsMH is offline
 
Join Date: May 2005
Looks great, I am going to have to try this out one of these days.
__________________
If you have a passion for the game of baseball, check out BaseballSlant.com
Reply With Quote
  #7  
Old 26 Oct 2007, 22:59
bobster65's Avatar
bobster65 bobster65 is offline
 
Join Date: Mar 2006
Real name: Bob
Originally Posted by Strike3ForumsMH View Post
Looks great, I am going to have to try this out one of these days.
Hey Mission... I'll hook ya up Bro

RZ
Reply With Quote
  #8  
Old 27 Oct 2007, 01:54
Endurer's Avatar
Endurer Endurer is offline
 
Join Date: Sep 2006
Wow, sweet. Definitely installed.
Reply With Quote
  #9  
Old 27 Oct 2007, 01:57
Hornstar's Avatar
Hornstar Hornstar is offline
 
Join Date: Jun 2005
Real name: Matt
Very nice work, I will be keeping this in mind that is for sure.
Reply With Quote
  #10  
Old 27 Oct 2007, 07:53
rapidphim rapidphim is offline
 
Join Date: Feb 2007
I got this error

Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.

how to fix it, please!
Reply With Quote
  #11  
Old 27 Oct 2007, 09:05
TheMilkCarton TheMilkCarton is offline
 
Join Date: Jan 2007
I'm confused... I just downloaded a "non-enhanced" version a few days ago over at vBadvanced...

So what has changed since then? Everything denoted with "v2.0"? I was under the impression that Nested Tabs worked on the version I downloaded.
Reply With Quote
  #12  
Old 27 Oct 2007, 09:07
TheMilkCarton TheMilkCarton is offline
 
Join Date: Jan 2007
Originally Posted by rapidphim View Post
I got this error

Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.

how to fix it, please!
Just delete the references to that file in all the tabexternal*.PHP files.

This was talked about over at vBadvanced, I suggest anyone with problems go read the several pages about this mod over there.
Reply With Quote
  #13  
Old 27 Oct 2007, 13:35
projectego's Avatar
projectego projectego is offline
 
Join Date: Feb 2006
Location: UK
Real name: Steve
/me clicks install
__________________
Reply With Quote
  #14  
Old 27 Oct 2007, 15:22
bobster65's Avatar
bobster65 bobster65 is offline
 
Join Date: Mar 2006
Real name: Bob
Originally Posted by TheMilkCarton View Post
I'm confused... I just downloaded a "non-enhanced" version a few days ago over at vBadvanced...

So what has changed since then? Everything denoted with "v2.0"? I was under the impression that Nested Tabs worked on the version I downloaded.
Yes, everything denoted with (v2.0) is new in this version. Nested tabs were possible, but there were some issues in order to get them to work. Nested tabs function a lot different (and better) with the newer version.
Reply With Quote
  #15  
Old 27 Oct 2007, 15:42
bobster65's Avatar
bobster65 bobster65 is offline
 
Join Date: Mar 2006
Real name: Bob
Added the steps to achieve different layout styles... they are located at the beginning of the 2nd post.
Reply With Quote
Reply


Currently Active Users Viewing This Thread: 1 (0 members and 1 guests)
 
Mod Options

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off


New To Site? Need Help?

All times are GMT. The time now is 23:21.

Layout Options | Width: Wide Color: