=== Widgets Control === Contributors: itthinx Donate link: http://www.itthinx.com/plugins/widgets-control/ Tags: widget, sidebar, context, visibility, theme, widgets, appearance, conditional, control, customize, display, hide, logic, placement, restrict, restrict content, shortcode, show, view Requires at least: 4.0 Tested up to: 4.8 Stable tag: 2.0.2 License: GPLv3 A Widget toolbox that adds visibility management and helps to control where widgets, sidebars and content are shown efficiently. == Description == _Widgets Control_ is a toolbox that features visibility management for all widgets, sidebars, sections of content and content blocks. It allows to show widgets and sidebars based on conditions - you can choose to show them only on certain pages or exclude them from being displayed. Sections of content can also be restricted by using this plugin's `[widgets_control]` shortcode. You can also define new WYSIWYG Content Blocks that can be used in widgets, sidebars and with shortcodes. For each widget and sidebar, you can decide where it should be displayed: - show it on all pages - show it on some pages - show it on all except some pages ... you can target small, medium or large screens for mobile, tablet and desktop users. To include or exclude pages, the plugin allows you to indicate page ids, titles or slugs and tokens that identify the front page, categories, tags, etc. In addition to page ids, titles and slugs, these tokens can be used to determine where a widget should or should not be displayed: [home] [front] [single] [page] [category] ... On sites using [WPML](http://wpml.org), widgets can be shown conditionally based on the language viewed. The `[widgets_control]` shortcode is used to embed content and show it conditionally similar to the visibility options used for widgets and sidebars. For example, `[widgets_control conditions="{archive}"]This text is shown only when the content is displayed on an archive page.[/widgets_control]`. _Widgets Control_ also provides __flexible WYSIWYG Content Blocks__ and a proper widget that can be used to place them in sidebars, the `[widgets_control_content]` shortcode to embed freely created blocks anywhere on your pages and API functions that allow to include these blocks in PHP templates of your theme. For even more flexible control, use [Widgets Control Pro](http://www.itthinx.com/shop/widgets-control-pro/) which provides freely definable additional sidebars. Use display conditions to show or hide content on devices with small, medium or large displays, useful to adapt the display to __mobile, tablet and desktop__ viewers. See the [documentation](http://docs.itthinx.com/document/widgets-control/) for more details. _Widgets Control_ works with virtually any widget. It is compatible with lots of plugins, among these it has been tested with: - [Groups](http://wordpress.org/plugins/groups/) - [Affiliates](http://wordpress.org/plugins/affiliates/) - [Decent Comments](http://wordpress.org/plugins/decent-comments/) - [WooCommerce](http://wordpress.org/plugins/woocommerce/) - [Events Manager](http://wordpress.org/plugins/events-manager/) - [BuddyPress](http://buddypress.org) - [bbPress](http://wordpress.org/plugins/bbpress/) - [Ninja Forms](http://wordpress.org/plugins/ninja-forms) - [Gravity Forms](http://gravityforms.com/) - [Jetpack](http://wordpress.org/plugins/jetpack/) - [WPML](http://wpml.org) - [NextGEN Gallery](http://wordpress.org/plugins/nextgen-gallery/) - [Image Widget](http://wordpress.org/plugins/image-widget/) - [MailChimp for WordPress](http://wordpress.org/plugins/mailchimp-for-wp/) - [The Events Calendar](http://wordpress.org/plugins/the-events-calendar/) - [MailPoet Newsletters](http://wordpress.org/plugins/wysija-newsletters) ### Widgets Control Pro ### Our [Widgets Control Pro](http://www.itthinx.com/shop/widgets-control-pro/) provides additional features: - Conditions based on the viewed __post type__. For example, show a widget only on posts with `[type:post]` or only on product pages with `[type:product]` - Show or hide widgets on full __page hierarchies__, where conditions are based on a parent page and all its child pages: `some-page/*` - Show or hide widgets based on user __roles__. For example, show a widget to subscribers and customers only: `[role:subscriber,customer]` - Show or hide widgets based on a user's __group membership__ with [Groups](http://wordpress.org/plugins/groups/). For example, show a widget only to registered users with `[group:Registered]` or show a widget only to users in a Premium group using `[group:Premium]` - Show or hide widgets for archive pages of a specific post type. For example, `[archive:product]` can be used to show widgets for the WooCommerce shop page and product archives only. - Allows to specify exclusions. For example, to show a widget only on pages, but exclude it from being shown on one or more specific pages. - Provides additional __sidebar features__ that allow to define any number of __custom sidebars__, flexible placement based on common locations, including above and below content, the comment form, menus and other sidebars, the `[widgets_control_sidebar]` shortcode to embed them in content on your pages and API functions to use them in your theme's templates. ### Feedback ### Feedback is welcome! If you need help, have problems, want to leave feedback or want to provide constructive criticism, please do so here at the [Widgets Control](http://www.itthinx.com/plugins/widgets-control/) plugin page. Please try to solve problems there before you rate this plugin or say it doesn't work. There goes a _lot_ of work into providing you with quality plugins! Please help with your feedback and we're also grateful if you help spread the word about this plugin. **Thanks!** #### Twitter #### Follow [@itthinx](http://twitter.com/itthinx) on Twitter for updates on this and other plugins. == Installation == = Dashboard = Log in as an administrator and go to Plugins > Add New. Type Widgets Control in the search field and click Search Plugins, locate the Widgets Control plugin by itthinx and install it by clicking Install Now. Now activate the plugin to have the widget placement features available. = FTP = You can install the plugin via FTP, see [Manual Plugin Installation](http://codex.wordpress.org/Managing_Plugins#Manual_Plugin_Installation). == Screenshots == 1. Widget visibility example I. 2. Widget visibility example II. 3. Widget visibility example III. 4. Sidebar visibility example. 5. Shortcode usage examples to restrict sections of content. == Frequently Asked Questions == = Where is the documentation for this plugin? = You can find the documentation on the [Widgets Control](http://docs.itthinx.com/document/widgets-control/) documentation pages. == Changelog == = 2.0.2 = * Fixed wrong description on PHP code for content blocks. * Updated the German translation. = 2.0.1 = * Added the widgets_control_content() API function. * Fixed PHP code shown for content blocks. = 2.0.0 = * Added a new post type to support Content Blocks and related features. * Added the [widgets_control_content] shortcode. * Added the Content Block widget. * Replaced the usage of language domain constant with string. * Added the notice class. * Added support for display conditions for mobile, tablet and desktop (small, medium and large) screen sizes. * German translation updated. == Upgrade Notice == = 2.0.2 = * This release adds new features that allow to work with Content Blocks, including a new widget and shortcode to display them. * New display conditions have been added to show or hide content on devices with small, medium or large displays, useful to adapt the display to mobile, tablet or desktop users. * This update fixes a description related to content blocks and updates the German translation.