Standard Widget Extensions (Standard WE) is extension for WordPress standard themes, Twenty Twelve/Twenty Eleven/Twenty Ten. It’s also effective for themes which use widgets in a standard manner. Available in the WordPress.org repository.
Current version of the plugin offers following two features. You can individually turn on and off these features.
- Accordion Widgets
- Sticky Sidebar
This site is a showcase of the plugin. Look at the sidebar of this page. Twenty Twelve/Twenty Eleven users can use this plugin out of the box. You can find options for the plugin by selecting a menu ‘Settings’ – ‘Standard WE’. Twenty Ten and other theme users have to change ID and class name. See ‘Settings’ section.
Below is widgets of Twenty Twelve/Twenty Eleven/Twenty Ten after activating Standard WE. Twenty Eleven is using custom icons for headings.
Here are explanations for each setting option. Please push the ‘Show Expert Options’ button in the settings page on your site if you want check all options.
Settings for WordPress standard themes are here.
- ID of Your Main Column
- An ID of a div element for the main content in your theme. Use ‘primary’ for Twenty Twelve and Twenty Eleven. Use ‘container’ for Twenty Ten.
- ID of Your Sidebar
An ID of a div element for the sidebar in your theme. ‘Sticky Sidebar’ makes an effect on corresponding div.
Use ‘secondary’ for Twenty Twelve and Twenty Eleven. For Twenty Ten, use ‘primary’ and make the secondary widget area empty.
- Class of Widgets
- A class of widgets in your theme. ‘Accordion Widgets’ makes an effect on widgets of this class in a div corresponding to ‘ID of Your Sidebar’.
- Readable .js File
- If you want to include the readable .js file instead of minimized one, enable this option.
- Accordion Widgets
- Use ‘Enable’ for enabling ‘Accordion Widgets’ feature, whereas ‘Disable’ for disabling the feature.
- Icon for Heading
- Icons for heading of widgets. Default icon is a pair of a plus sign and a minus sign. You can use custom icon by selecting ‘Custom’ and filling two URL boxes. URLs have to begin with ‘http://’ or ‘https://’. (ex. ‘http://example.com/path/plus.png’)
- Include Default CSS
- As a default behavior, some CSS (style tag) is included to display icons when you set ‘Icon for Heading’ other than ‘None’, You can disable this behavior by setting this parameter to ‘No’.
- Single Expansion Mode
- You can limit only one widget to be expanded at a time by enabling this option.
- Slide Duration
- A number to determine how long the collapsing/expanding animation will run. Higher values indicate slower animations. Given in milliseconds.
- Selector for Headings
- A selector for headings where you click to expand/collapse. (default: ‘h3′)
- Widget area IDs in which AW is effective (optional)
If your sidebar has multiple widget areas and you want only some of them to be collapsible, you can assign widget area IDs to be.
Use comma delimited values to assign multiple areas.
If your theme uses a widget area as a sidebar, keep this field empty and just set ‘ID of Your Sidebar’.
- Custome Widget Selectors
- You can directly write selectors to pick up widget. If you set this, the default selector generated by IDs is cancelled.
- Sticky Sidebar
- Use ‘Enable’ for enabling ‘Sticky Sidebar’ feature, whereas ‘Disable’ for disabling the feature.
- Quick Switchback Mode
- If you enable this option, SWE behaves differently from original movement when it changes scroll direction. Can you tell the difference?
- Recalc Timer
- If you have dynamic content in the sidebar, you would need to make Standard WE calculate content sizes after the content are initialized. You can do it by setting this option which is a timer starting from loading the plugin. Standard WE will calculate the size after this timer has expired. Given in seconds. Assigning 0 will disable this behavior.
- Ignore Footer
If you enable this option, the sidebar wouldn’t move when the footer comes. This is useful for infinite scroll pages.
- Proportional Sidebar
If your sidebar width is defined in percent, please set this value as same as it to keep proper proportion while resizing browsers. Reading CSS files is difficult for Standard WE so please provide your width manually.
If your sidebar has fixed-width, enter zero.
- Disable if window width is less than
- The minimum window width to use ‘Sticky Sidebar’. Use ’0′ for disabling this feature. With this parameter, Standard WE works well with responsive designed web pages.
- Options for the Second Sidebar/dt>
- You can identify 2nd sidebar and set parameters for it same as the main sidebar.
For theme developers
This plugin is mainly for standard themes. So there are limitations as follows.
- Keep styles of the sidebar div and the content div to be ‘padding: 0; border: 0;’.
- Make widget content to be a single element and just next to the heading.
- Use same margin-top (margin-bottom) for the sidebar div and the content div.
- As a default behavior, some CSS hacks are included if you enable accordion widget. This can be disabled with the option in admin settings page.
Please also see FAQs in the wordpress.org plugin page.