The Arcive of Official vBulletin Modifications Site.It is not a VB3 engine, just a parsed copy! |
|
AJAX Tabs Content Script v2 Details »» | |||||||||||||||||||||||||
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:
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. Code:
<link rel="stylesheet" type="text/css" href="/forums/ajaxtabs/ajaxtabs.css" /> Code:
<script type="text/javascript" src="/forums/ajaxtabs/ajaxtabs.js"> Code:
<li class="selected"><a href="http://www.domain.com/forums/tabexternal.php" rel="ajaxcontentarea">Tab 1</a></li> <li><a href="http://www.domain.com/forums/tabexternal2.php" rel="ajaxcontentarea">Tab 2</a></li> <li><a href="http://www.domain.com/forums/tabexternal3.php" rel="ajaxcontentarea">Tab 3</a></li> <li><a href="http://www.domain.com/forums/tabexternal4.php" rel="ajaxcontentarea">Tab 4</a></li> 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) Code:
<li><a href="http://www.domain.com/forums/tabexternal.php" rel="ajaxcontentarea">Announcements</a></li> 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 PHP Code:
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 Code:
<script type="text/javascript"> var mytabs=new ddajaxtabs("maintab", "ajaxcontentarea") mytabs.setpersist(true) mytabs.setselectedClassTarget("link") //"link" or "linkparent" mytabs.init(15000) </script> </body> </td></tr> 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. Code:
<li><a href="http://www.domain.com/forums/CONTENT FILE" rel="ajaxcontentarea">TAB NAME</a></li> Code:
<li><a href="http://www.domain.com/forums/tabcontent5.php" rel="ajaxcontentarea">Sports News</a></li> 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. Show Your Support
|
Comments |
#2
|
||||
|
||||
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 Code:
<ul id="tabs" class="shadetabs"> <li><a href="tabexternal.php" rel="tabcontainer" class="selected">Tab 1</a></li> <li><a href="tabexternal2.php" rel="tabcontainer">Tab 2</a></li> <li><a href="tabexternal3.php" rel="tabcontainer">Tab 3</a></li> <li><a href="tabexternal4.php" rel="tabcontainer">Tab 4</a></li> </ul> <div id="divcontainer" style="border:1px solid gray; width:450px; margin-bottom: 1em; padding: 10px"> </div> <script type="text/javascript"> var mytabs=new ddajaxtabs("tabs", "divcontainer") mytabs.setpersist(true) mytabs.setselectedClassTarget("link") //"link" or "linkparent" mytabs.init() </script> Code:
<div id="tabs" class="indentmenu"> <ul> <li><a href="tabexternal.php" rel="tabcontainer" class="selected">Tab 1</a></li> <li><a href="tabexternal2.php" rel="tabcontainer">Tab 2</a></li> <li><a href="tabexternal3.php" rel="tabcontainer">Tab 3</a></li> <li><a href="tabexternal4.php" rel="tabcontainer">Tab 4</a></li> </ul> <br style="clear: left" /> </div> <div id="divcontainer" style="border:1px solid gray; width:550px; height: 150px; padding: 5px; margin-bottom:1em"> </div> <script type="text/javascript"> var mytabs=new ddajaxtabs("tabs", "divcontainer") mytabs.setpersist(false) mytabs.setselectedClassTarget("link") mytabs.init() </script> 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: Code:
instance.expandit(tabid_or_position) Code:
<p><a href="javascript: countries.expandit(2)">Select 3rd Tab</a></p> <p><a href="javascript: countries.expandit('favorite')">Select Tab with ID "favorite"</a></p> 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: Code:
instance.loadajaxpage(pageurl) Code:
<p><a href="javascript: countries.loadajaxpage('external5.htm')">Load "external5.htm" into content container via Ajax</a></p> <p><a href="javascript: countries.loadajaxpage('http://www.mysite.com/content/external5.htm')">Load into "external5.htm" content container via Ajax</a></p> 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: Code:
instance.loadiframepage(pageurl) Code:
<p><a href="javascript: countries.loadiframepage('external5.htm')">Load "external5.htm" into content container via IFRAME</a></p> <p><a href="javascript: countries.loadiframepage('http://www.google.com')">Load Google Homepage into content container via IFRAME</a></p> 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: Code:
<ul id="countrytabs" class="shadetabs"> <li><a href="external1.htm" rel="countrycontainer" class="selected">Tab 1</a></li> <li><a href="external2.htm" rel="countrycontainer">Tab 2</a></li> <li><a href="externalnested.htm" rel="countrycontainer">Tab 3</a></li> </ul> <div id="countrydivcontainer" style="border:1px solid gray; width:450px; margin-bottom: 1em; padding: 10px"> </div> <script type="text/javascript"> var countries=new ddajaxtabs("countrytabs", "countrydivcontainer") countries.setpersist(true) countries.setselectedClassTarget("link") //"link" or "linkparent" countries.init() countries.onajaxpageload=function(pageurl){ if (pageurl.indexOf("externalnested.htm")!=-1){ var provinces=new ddajaxtabs("provincetabs", "provincedivcontainer") provinces.setpersist(true) provinces.setselectedClassTarget("link") //"link" or "linkparent" provinces.init() } } </script> Code:
<ul id="provincetabs" class="shadetabs"> <li><a href="external1.htm" rel="provincedivcontainer">Tab 1</a></li> <li><a href="external2.htm" rel="provincedivcontainer">Tab 2</a></li> <li><a href="external3.htm" rel="provincedivcontainer">Tab 3</a></li> </ul> <div id="provincedivcontainer" style="padding: 10px; border-top: 1px solid gray;"> </div> Code:
instance.onajaxpageload=function(pageurl){ //if (pageurl=="href_attribute_value_of_tab"){ //run custom 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: Code:
if (pageurl.indexOf("externalnested.htm")!=-1){ " " } 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. |
#3
|
||||
|
||||
Enhanced Recent Threads Layout
See this post - >> https://vborg.vbsupport.ru/showpost....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 - https://vborg.vbsupport.ru/showpost....&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 PHP Code:
... |
#4
|
||||
|
||||
OMG, this is totally RAD...***INSTALLED***
Nice job bobster! :up: ::walk awzy in amazement:: |
#5
|
||||
|
||||
Just amazing.. I wanted to do something like this too. Glad someone else got it done
I vote MOTM! |
#6
|
|||
|
|||
Looks great, I am going to have to try this out one of these days.
|
#7
|
||||
|
||||
Quote:
RZ |
#8
|
|||
|
|||
Wow, sweet. Definitely installed.
|
#9
|
|||
|
|||
Very nice work, I will be keeping this in mind that is for sure.
|
#10
|
|||
|
|||
I got this error
Code:
Warning: array_merge() [function.array-merge]: Argument #1 is not an array in /includes/vba_cmps_include_template.php on line 47 Congrats Admin! You have successfully added AJAX Tab Content to your Site. |
|
|
X vBulletin 3.8.12 by vBS Debug Information | |
---|---|
|
|
More Information | |
Template Usage:
Phrase Groups Available:
|
Included Files:
Hooks Called:
|