=== Plugin Name ===
Contributors: t31os_
Tags: editor, shortcode, tabs, jquery, jquery-ui, post, page, custom-post-types
Requires at least: 3.1.0
Tested up to: 3.6
Stable tag: 1.0.7

Create jQuery tabs inside your posts, pages or post types using simple shortcodes inside the post editor. 

== Description ==

Show off your post content inside stylish jQuery powered tabs using one of 25 different themes or create your own styling to suit.

== Installation ==

1. Upload the `put`(post-ui-tabs) folder to the `/wp-content/plugins/` directory
1. Activate the plugin through the Plugins menu in WordPress
1. Visit the plugin configuration screen under **WordPress Admin > Settings > Post UI Tabs** and set your preferences
1. Create posts using the easy to use shortcode and watch the magic happen

== Frequently Asked Questions ==

= So how do i create tabs? =

Please use the following format for creating tab sets.
`
[tab name="Your tab name 1"]Your tab content[/tab] 
[tab name="Your tab name 2"]Your tab content[/tab]
[tab name="Your tab name 3"]Your tab content[/tab]
[end_tabset]
`
**NOTE:** 
It is essential all tab sets end with the `[end_tabset]` shortcode, the tabs will not appear without the shortcode.  
Please also be aware that tabs can not be placed on the same line, this is a limitation of shortcode functionality in WordPress(and i do not wish to bloat this plugin with extra code to work around it).

= Can i use HTML inside the tabs? =

You may use any HTML the WordPress content editor usually allows inside the tab content, but not inside the tab names(which are sanitized seperately).

= Can i use tabs in pages? =

The plugin is not restricted to a particular kind of content, so yes pages, posts or custom post types(or at least any type that supports using the content editor).

= Can i use other shortcodes inside the tab content? =

Yes you should be able to, it has not been tested, but if you have any problems feel free to start a support topic right here in the WordPress.org forums.

= Why do the tabs not look the same when i view them on the front facing side of my site? =

It is possible your theme's stylesheet is applying CSS to some of the tabs elements, please feel free to start a support topic if you need help making adjustments.

= How can i remove the UI classes from the next and previous links? =

Add the following to your theme's **functions.php** file.
`
add_filter( 'post_ui_tabs_class', '__return_empty_array' );
`
= When using text nav links how i can change the link text? =

You can modify the previous and next link text using the following in your theme's **functions.php** file.
`
// Remove the UI classes(used by default to display nav icons)
add_filter( 'post_ui_tabs_class', '__return_empty_array' );

// Hook callback functions to the filters
add_filter( 'post_ui_tabs_next', 'put_nav_next_text' );
add_filter( 'post_ui_tabs_prev', 'put_nav_prev_text' );

// Callback to change the 'Next' text
function put_nav_next_text() { return 'Your next text'; }

// Callback to change the 'Previous' text
function put_nav_prev_text() { return 'Your previous text'; }
`
= How do i include my own CSS in place of one of the jQuery UI themes? =

**Method one:**  
*Using a stylesheet in your theme's directory(will work for child themes to)*
`
add_filter( 'put_stylesheet_uri', 'my_custom_put_stylesheet' );

function my_custom_put_stylesheet( $uri ) {
	return get_stylesheet_directory_uri() . '/mycustom.css';
}
`
**Method two:**
*Adding a filter from inside your own plugin file*
`
add_filter( 'put_stylesheet_uri', 'my_plugin_put_stylesheet' );

function my_plugin_put_stylesheet( $uri ) {
	
	// If the stylesheet is in the plugin's main directory
	return plugins_url( '', __FILE__ ) . '/mycustom.css';
	
	// If the stylesheet is in a subdirectory of the plugin
	return plugins_url( 'dir', __FILE__ ) . '/mycustom.css';
}
`
**Method three:**  
Check the **Disable skins** option on the Post UI Tabs settings page.

Then do either of the following..

* Add your own CSS to your theme's stylesheet(typically **style.css**).  
* Call `wp_enqueue_style` on the `put_enqueue_styles` action, ie. the regular WP enqueuing method.

== Filters ==

The plugin provides various filters to aid users, they are as follows

* `put_decide_has_tabs`: (bool) true/false value that determines whether to run the tabs script(runs inside a filter on `the_content`)
* `put_theme_dir`: (string) passes the theme directory uri
* `put_stylesheet`: (string) name of the stylesheet to use for tabs CSS
* `put_skins`: (array) passes the array of skins available to the plugin
* `put_stylesheet_uri`: (string) the full stylesheet uri used (easier hook for custom stylesheets)
* `put_prev_text`: (string) the text used for previous tab navigation(text not shown by default)
* `put_next_text`: (string) the text used for next tab navigation(text not shown by default)
* `put_nav_class`: (string) the classes applied to the prev and next navigation(second arg indicates prev or next text)

A couple of actions are also available for when you'd rather just turn off skins and enqueue your own stylesheet

* `put_enqueue_css`: runs on front facing pages with tab sets when the *Disable skins* is enabled
* `put_admin_enqueue_css`: runs on the plugin settings page when the *Disable skins* is enabled

== Screenshots ==

1. A post with 2 jQuery UI tab sets
2. The plugin administration page

== Changelog ==

= 1.0.7 =
* Added two new filters `put_decide_has_tabs` and `put_stylesheet_uri`. 
* Switched the filter names(sorry) to use a more consistent and descriptive naming scheme - all hooks are now use the `put_` prefix.
* Change example code in readme and added a list of all the available plugin hooks

= 1.0.6 =
* Update jQuery functions inline with jQuery UI updates, ie. replace calls to deprecated functions
* Removed cookie support(removed from jQuery UI) - alternative to be provided later on
* Moved some filters that were not working correctly
* Added some new action hooks for users to disable jQuery UI css and enqueue their own
* Improved some jQuery to better handle previous and next navigation when there are disabled tabs

= 1.0.5 =
* Changed the `has_tabs` variable to public

= 1.0.4 =
* Update to jQuery UI 1.8.15 (for skins)
* Add option to display tab titles and content in feeds
* Rearrange markup for feeds so titles and content does not bunch together
* Move enqueues to more appropriate action

= 1.0.3 =
* Rename cookie javascript, possible fix for unknown problem with 404s to cookie script
* Remove shortcode content from feeds(was never intended to be output in feeds)

= 1.0.2 =
* Fix style/script versions
* Add proper plugin version to plugin(whoops)
* Add more to readme.txt