=== Section Widget === Contributors: oltdev, godfreykfc Tags: text, html, conditional, selective, widget, section, per page Requires at least: 2.8 Tested up to: 2.8.1 Stable tag: 2.03 Display arbitrary text or HTML on certain sections of your site. An improved version of the text widget with scope selection. == Description == This plugin is basically an improved version of the built-in text widget. It allows you to display some arbitrary text or HTML on your site - but instead of showing it everywhere on your site, it allows you to limit its display to certain section(s) of your site, including fine-grained per-page control. This plugin features an easy-to-use widget interface and there is no coding involved (check out the screenshots). In terms of functionality, this is similar to Alan Trewartha's [Widget Logic][1] and Matt Gibbs's [Widget Block][2] plugin, but this plugin does not require any knowledge about WordPress' conditional tags. This is especially great for multiuser sites because giving out access to the theme editor or allowing arbitrary PHP code is often undesirable. Currently, you can choose to display the widget on any combinations of the following: * The front page * Author pages * Any/all posts * Any/all pages * Pages/posts with comments enabled * Pages/posts in certain categories, and (optionally) the corresponding archive pages * Pages/posts with certain tags, and (optionally) the corresponding archive pages * All date-based archive pages **Please note: the admin interface requires JavaScript to display correctly.** **This plugin will only run on Wordpress 2.8+. If you need to run it on Wordpress 2.7, see the FAQ for a workaround.** [1]: http://wordpress.org/extend/plugins/widget-logic [2]: http://wordpress.org/extend/plugins/widget-block == Installation == Extract the zip file and just drop the contents in the wp-content/plugins/ directory of your WordPress installation and then activate the Plugin from Plugins page. == Frequently Asked Questions == **What does "Display title" do?** When it is checked, the title of the widget will be displayed before the widget's content, just like the regular text widget. When unchecked, it will hide the title when displaying the widget, which allows more flexibility when styling the widget. **What exactly is the "front page"?** Depending on your *Reading Settings*, this could be either your more recent blog posts or a static page of your choice. This is determined by the [is\_front\_page()][1] wordpress function. **Can I use PHP code in the content?** No. **Can I use JavaScript in the content?** See below. **Is the HTML code filtered?** It depends. Unless the user who edited the widget has the [unfiltered\_html][2] capabilities (this means Administrators and Editors on the default settings), all "non-safe" HTML elements will be stripped. **How do I style the widget?** If you have access to the theme CSS files, you can give the content of the widget an id or a class, and then style it from there. Otherwise, you can always use inline CSS styling. **Does it work on 2.7?** The version we hosted on wordpress.org requires 2.8+ to run. If you absolutely need to run it on wordpress 2.7 here is a [workaround][3]. Please note this method is not supported and its use is discouraged. [1]: http://codex.wordpress.org/Conditional_Tags#The_Front_Page [2]: http://codex.wordpress.org/Roles_and_Capabilities#unfiltered_html [3]: http://blogs.ubc.ca/support/plugins/section-widget/running-section-widget-on-wordpress-27/ == Screenshots == 1. The section widget admin interface. 2. A simple section widget. 3. Using HTML in section widget. 4. A fancy section widget. 5. Selecting arbitrary pages. == Changelog == * Version 2.01: first public release. * Version 2.02: fixed minor JavaScript bug. * Version 2.03: added install instructions for Wordpress 2.7. ==Readme Generator== This Readme file was generated using wp-readme, which generates readme files for WordPress Plugins.