Widget Subtitles

Add a customizable subtitle to your widgets

Description

This plugin adds a subtitle input field to all your widgets. You can also change the location of the subtitle and even use filters to change the subtitle output.

Filters

widget_subtitles_element

Allows you to change the HTML element for the subtitle.
Since 1.0

• Default: span
• Parameters:
  • string Default element.
  • string Widget ID, widget name + instance number.
  • string Sidebar ID where this widget is located. (since 1.1)
  • array All widget data. (since 1.1)
  • WP_Widget The widget type class. (since 1.1.3)
• Return: string A valid HTML element.

widget_subtitles_classes

Allow filter for subtitle classes to overwrite, remove or add classes.
Since 1.0

• Default: array( 'widget-subtitle', 'widgetsubtitle', 'subtitle-{LOCATION}' ); Where {LOCATION} stands for your selected location.
• Parameters:
  • string Default element.
  • string Widget ID, widget name + instance number.
  • string Sidebar ID where this widget is located. (since 1.1)
  • array All widget data. (since 1.1)
  • WP_Widget The widget type class. (since 1.1.3)
• Return: array An array of CSS classes.

widget_subtitles_default_location

Sets the default location for subtitles.
Since 1.1.2

• Default: after-inside
• Parameters: string The default subtitle location.
• Return: string Options: after-inside, after-outside, before-inside, before-outside.

widget_subtitles_edit_location_capability

Change the capability required to modify subtitle locations.
Since 1.1.2

• Default: edit_theme_options
• Parameters: string The default capability.
• Return: string The new capability.

You can use these filters inside your theme functions.php file or in a plugin.

widget_subtitles_available_locations

Overwrites the available locations for a widget.
NOTE: You can currently only remove locations. New locations are not possible (yet).
Since 1.1.3

• Default: after-inside, after-outside, before-inside, before-outside.
• Parameters:
  • array The array of available locations.
  • WP_Widget The widget type class.
  • array The widget instance.
• Return: array Filtered list of available locations for this widget.

Installation

1. Upload /widget-subtitles to the /wp-content/plugins/ directory
2. Activate the plugin through the Plugins menu in WordPress
3. Go to Appearance > Widgets menu and fill out your subtitles