Installation ↑ Back to top
WooSidebars is available for download directly through WooDojo.
If you would prefer to install the plugin manually, please use the following directions:
- Download the plugin to your computer
- Login to your WordPress admin panel, and click Plugins > Add New
- Using the “Upload” option, click “Choose File” and browse to where you downloaded the WooSidebars plugin.
- Click “Install Now” and then activate the WooSidebars plugin to complete installation.
Getting Started ↑ Back to top
WooSidebars adds a “Widget Areas” menu item under the “Appearance” menu in your WordPress administration area. This is where all WooSidebars interaction takes place.
Adding a Widget Area ↑ Back to top
On the “Widget Areas” screen, a list of all currently stored widget areas is displayed. To get started, click the “Add New” link next to the “Widget Areas” title on the screen, to add your first widget area.
Adding a widget area consists of several fields: a title, description, the sidebar to be replaced and the conditions for replacing the sidebar (we’ll discuss conditions in more detail below).
Title ↑ Back to top
The title is the name of the widget area, as it displays on the “Appearance > Widgets” screen. This should be kept short and relevant (for example, “About Page – Primary” for replacing the “Primary” sidebar on the “About” page).
Description ↑ Back to top
If necessary, this provides more details for where and when the sidebar is used. This text displays inside the sidebar, in its display on the “Appearance > Widgets” screen.
Sidebar To Replace ↑ Back to top
WooSidebars works by overriding a widget area from the active theme, with a custom widget area, if certain conditions are met. This field is where you would choose which of the theme’s sidebars is to be replaced by the sidebar you’re creating here.
Conditions ↑ Back to top
WooSidebars comes bundled with an advanced conditions management system, where by it is possible to choose under which conditions the sidebar is replaced with the custom sidebar (for example, on certain pages, categories, tags or internal WordPress screens).
By default, only “Pages” is available. More advanced conditions can be made available by clicking the “Advanced” tab inside the “Conditions” box.
Conditions ↑ Back to top
By default, WooSidebars comes bundled with conditions for pages, which displays by default. Clicking the “Advanced” tab inside the “Conditions” box opens up a range of extra tabs, for additional conditions.
Other conditions include:
- Specific page templates (if the active theme contains page templates)
- Post types (for the post type archives and to display on all posts of a specific post type)
- Taxonomy archives (categories, tags, etc, for all registered taxonomies on the installation)
- Taxonomy terms (specific categories, tags, etc, for all registered taxonomies on the installation)
- WordPress Template Hierarchy
- All pages
- Search results
- Default “Your Latest Posts” screen
- Front page
- Single entries
- All archives
- Author archives
- Date archives
- 404 error screens
- Shop page
- Product categories
- Product tags
- Cart page
- Checkout page
- Account pages
Note: The ‘Posts’ tab in the image above will only be visible if you enable Custom Sidebars on individual posts, as described below.
Conditions for specific entries ↑ Back to top
With WooSidebars, it’s possible to create custom sidebars for specific entries in a post type. By default, the “post” post type supports this and, if WooCommerce is active, the “product” post type supports this as well.
To create a widget area for a specific blog post, simply go to Posts > All Posts and click the check mark next to the desired blog post.
To add support for this to other post types, please add the following to your theme’s “functions.php” file or to your custom plugin that you’re developing, inside PHP tags:
add_post_type_support( 'post_type', 'woosidebars' );
In the above example, please replace “post_type” with the desired post type.
Adding this code, adds checkmark-style buttons to the “List” screen for that post type in the WordPress admin. Here, you can click the button for each entry you’d like to be able to create a custom sidebar for.
Non-active Sidebars ↑ Back to top
WooSidebars detects which sidebars are active in the current theme, and notifies you of which of your custom sidebars don’t apply to the current theme.
Those sidebars do, however, remain in the system, in case you are switching regularly between themes that use different registered sidebars.
Video Overview ↑ Back to top
Video courtesy of Jamie Marsland at PootlePress.