=== Dynamics Sidebars ===

Contributors: alyssonweb
Tags: sidebar, custom, dynamic, widget, different
Requires at least: 3.0
Tested up to: 3.4.1
Stable tag: 1.0.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=J3AJV4ZZ4WKYQ&lc=NZ&item_name=WordPress%20Dynamics%20Sidebars&currency_code=NZD&bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHosted

Create a custom widget area (sidebar) for pages, posts and custom post types.


== Description ==

**Please Note**

* Requires at least wp version: 3.0


**Install**

1. Unzip the dynamics-sidebars.zip file.
1. Upload the the dynamics-sidebars folder (not just the files in it!) to your wp-contents/plugins folder. If you're using FTP, use 'binary' mode.


**Activate**

1. In your WordPress administration, go to the Plugins page
1. Activate the Dynamics Sidebars plugin.


**Usage**

1. After activating the plugin
1. Go to the Pages/Posts/CTP > Add new or Edit and you should see the "Sidebar" metabox on the side (if not showing up try active "Sidebar" under 'Screen Options' on the top-right handside and make sure "Sidebar" is ticked )
1. Enter the name for your sidebar area (recommend to use same as your page title)
1. Go to the Appearance > Widgets and place anything onto your new widget area
1. On either files page.php, sidebar.php, sidebar-{custom}.php or custom-template.php just add the following code:

`<?php
	dynamic_sidebar( get_the_sidebar() );
?>`


**Checking if sidebar is active**

`<?php
	$sidebar = get_the_sidebar();
	if ( is_active_sidebar( $sidebar ) ) {
		dynamic_sidebar( $sidebar );
	}
?>`

**Check the new API**

`<?php
	// get the current page/post/cpt sidebar with fallback (sidebar id or name) if needed, set ECHO to true to echo out the sidebar name
	// the_sidebar( $fallback = '', $echo = false )

	// get current page/post/cpt sidebar, $post_id is optional
	// get_the_sidebar( $post_id = 0 )

	// get all custom sidebars (custom only)
	// get_custom_sidebars()

	// get all registered sidebars
	// get_all_sidebars()
?>`

And many filters and actions to hook on to.


**Changing before_widget and after_widget**

On your functions.php file just add the following code. (don't forget to change 'function to return my sidebar items' to your own function name
`<?php
	add_filter( 'ds_sidebar_args', 'function to return my sidebar items' );
?>`

***Here is an example:***


`<?php
	add_filter( 'ds_sidebar_args', 'my_sidebar_args' );

	function my_sidebar_args( $defaults ) {
		$args = array(
			'description'   => 'My widget area',
			'before_widget' => '<li id="%1$s" class="widget-container %2$s">',
			'after_widget'  => '</li>', 'after_widget',
			'before_title'  => '<h3 class="widget-title">',
			'after_title'   => '</h3>', 'after_title',
		);

		return $args;
	}
?>`


== Installation ==

**Please Note**

* Requires at least: 3.0


**Install**

1. Unzip the dynamics-sidebars.zip file.
1. Upload the the dynamics-sidebars folder (not just the files in it!) to your wp-contents/plugins folder. If you're using FTP, use 'binary' mode.


**Activate**

1. In your WordPress administration, go to the Plugins page
1. Activate the Dynamics Sidebars plugin.


== Screenshots ==

1. Pages/Posts/Custom Post Types Edit Page
2. Quick Edit
3. Bulk Edit

== Frequently Asked Questions ==

No FAQ yet.

== Changelog ==

= 1.0.0 =

* Added bulk edit
* Added quick edit
* Added select box with all registered sidebars and a text input for registering a new one
* Added save via ajax
* Added save via publich/update/save draft
* Added API:
* the_sidebar( $fallback = '', $echo = false )
* get_the_sidebar( $post_id = 0 )
* get_custom_sidebars()
* get_all_sidebars()
* Added FILTERS:
* the_sidebar
* ds_save_permissions
* ds_save_ajax_message
* ds_save_ajax
* ds_sidebar_args
* Added ACTIONS
* ds_plugin_install
* ds_plugin_uninstall
* ds_construct
* ds_add_metabox
* ds_render_metabox
* ds_save
* Added CONSTANTS
* DS_PLUGIN_FOR_PAGES, to render or not "Sidebar" metabox for pages
* DS_PLUGIN_FOR_POSTS, to render or not "Sidebar" metabox for posts
* DS_PLUGIN_FOR_FRONT_PAGE, to render or not "Sidebar" metabox for front page "page_on_front" (if set)
* DS_PLUGIN_FOR_POSTS_PAGE, to render or not "Sidebar" metabox for posts page "page_for_posts" (if set)
* Added .POT file for Internationalization (i18n)

= 0.1.2 =

* Added install and uninstall functions
* Changes to 'readme.txt'
* Requires at least: 3.0
* Tested up to: 3.4.1

= 0.1 =

* First release.

== Upgrade Notice ==

= 1.0.0 =

* Added bulk edit
* Added quick edit
* Added select box with all registered sidebars and a text input for registering a new one
* Added save via ajax
* Added save via publich/update/save draft
* Added API:
* the_sidebar( $fallback = '', $echo = false )
* get_the_sidebar( $post_id = 0 )
* get_custom_sidebars()
* get_all_sidebars()
* Added FILTERS:
* the_sidebar
* ds_save_permissions
* ds_save_ajax_message
* ds_save_ajax
* ds_sidebar_args
* Added ACTIONS
* ds_plugin_install
* ds_plugin_uninstall
* ds_construct
* ds_add_metabox
* ds_render_metabox
* ds_save
* Added CONSTANTS
* DS_PLUGIN_FOR_PAGES, to render or not "Sidebar" metabox for pages
* DS_PLUGIN_FOR_POSTS, to render or not "Sidebar" metabox for posts
* DS_PLUGIN_FOR_FRONT_PAGE, to render or not "Sidebar" metabox for front page "page_on_front" (if set)
* DS_PLUGIN_FOR_POSTS_PAGE, to render or not "Sidebar" metabox for posts page "page_for_posts" (if set)
* Added .POT file for Internationalization (i18n)

= 0.1.2 =

* Added install and uninstall functions
* Changes to 'readme.txt'
* Requires at least: 3.0
* Tested up to: 3.4.1

= 0.1 =

* First release.

== Internationalization (i18n) ==

This plugin has been translated into the languages listed below:

* pt_BR - Portuguese Brazil.

If you're interested in doing a translation into your language, please let me know.