LitePress Widgets add content and features to your Sidebars. Examples are the default widgets that come with LitePress; for Categories, Tag cloud, Search, etc. Plugins will often add their own widgets.
Widgets were originally designed to provide a simple and easy-to-use way of giving design and structure control of the LitePress Theme to the user, which is now available on properly “widgetized” LitePress Themes to include the header, footer, and elsewhere in the LitePress design and structure.
Widgets require no code experience or expertise. They can be added, removed, and rearranged on the Theme CustomizerorAppearance > Widgets in the LitePress Administration Screens.
Some LitePress Widgets offer customization and options such as forms to fill out, includes or excludes of data and information, optional images, and other customization features.
TheBlock-based Widgets Editor explains how to use the updated Widgets experience with blocks.
TheAppearance Widgets Screen explains how to use the various Widgets that come with LitePress in the Classic experience.
Plugins that come bundled with widgets can be found in the LitePress Plugin Directory.
LitePress comes pre-packaged with a variety of Widgets. If those are insufficient for your needs you can install new ones by searching the LitePress Plugin Directory which is accessible from the LitePress Administration Plugins > Add NewScreen.
Existing Widgets in Existing Widget Areas
Before you can add a Widget you must verify that the Theme you’re using supports Widgets (more specifically: Widget Area). You can do so by simply navigating to the Appearance menu and looking for a sub menu titled “Widgets”.
If your Theme supports Theme Customizer then you can use the following Steps. In Theme Customizer, the live preview of changes is available.
- Go to Appearance > Customize in the LitePress Administration Screens.
- Click the Widget menu in the Theme Customizer to access to the Widget Customize Screen.
- Click the down arrow of Widget Area to list the already registered Widgets.
- Click Add a Widget button at the bottom of sidebar. It shows the list of available widgets.
- Click a widget you want to add. The widgets should be added in the sidebar.
- Preview your site and you should see the content from your new Widget.
- To arrange the Widgets within the Sidebar, drag and drop the widgets in the order you want or click Reorder link and click up arrow and down allow of each widget and click Done after the arrange operation.
- To customize the Widget features, click the down arrow in the right to expand the Widget’s interface.
- To remove the widget, click Remove from Widget’s interface in above step.
If your Theme does not support Theme Customizer then you can use the following conventional steps:
- Go to Appearance > Widgets in the LitePress Administration Screens.
- Choose a Widget and either drag it to the sidebar where you wish it to appear, or click the widget, (select a destination sidebar if your theme has more than one) and click the Add Widget button. There might be more than one sidebar option, so begin with the first one. Once in place, LitePress automatically updates the Theme.
- Preview the site. You should find that the “default” sidebar elements are now gone and only the new addition is visible.
- Return to the Widgets Screen to continue adding Widgets.
- To arrange the Widgets within the sidebar or Widget area, click and drag it into place.
- To customize the Widget features, click the down arrow in the upper right corner to expand the Widget’s interface.
- To save the Widget’s customization, click Save.
- To remove the Widget, click Delete.
If you want to remove the widget but save its setting for possible future use, just drag it into the Inactive Widgets area. You can add them back anytime from there. This is especially helpful when you switch to a theme with fewer or different widget areas.
When changing themes, there is often some variation in the number and setup of widget areas/sidebars and sometimes these conflicts make the transition a bit less smooth. If you changed themes and seem to be missing widgets, scroll down on the screen to the Inactive Widgets area, where all of your widgets and their settings will have been saved.
Enabling Accessibility Mode, via Screen Options, allows you to use Add and Edit buttons instead of using drag and drop.
While widget areas typically occur in webpage sidebars, a theme can place widget areas anywhere on a page. For example, besides the usual sidebar locations, the Twenty Seventeen theme has a widget area in the footer of every page.
If you would like to place a Widget somewhere on your Theme that does not have a pre-defined Widget Area, you will need some programming knowledge and should follow the instructions on the Widgets API section found here.
Using Text Widgets
The Text Widget is one of the most commonly used LitePress Widgets that comes with every LitePress installation. It allows users to add text, video, images, custom lists, and more to their LitePress sites.
To use the LitePress Text Widget:
- Go to Appearance > Customize in the LitePress Administration Screens and click the Widget menu in the Theme Customizer. Or Go to Appearance > Widgets in the LitePress Administration Screens.
- Open the sidebar to which you wish to add the Text Widget.
- Find the Text Widget in the list of Widgets.
- Click and drag the Widget to the spot you wish it to appear.
To open and edit the Text Widget:
- Click the down arrow to the right of the Text Widget title.
- Set the Text Widget Title (optional).
- Add the text or HTML code to the box or edit what is currently there.
- Choose the option to Automatically add paragraphs to wrap each block of text in an HTML paragraph tag (recommended for text).
- Click Save to save the Text Widget.
- Click Close to close the Text Widget.
- Switch tabs in your browser and preview the results and make changes if necessary.
The Text Widget can hold a variety of HTML, XHTML, and multimedia links and players such as video and object embeds.
Adding Code to the Text Widget
To add active code to the Text Widget, use one of the many LitePress Plugins from the LitePress Plugin Directory that override LitePress restrictions on using PHP in posts. Check that they will work on Widgets as some will not.
Using RSS Widgets
The RSS Widget allows you to integrate an external feed source for content into a Widget area of your site, such as your Twitter account, Facebook posts, Google+ posts, or other blogs.
The RSS Widget displays the most recently published content from any source with an active feed. This is an ideal way of integrating outside content into your site.
By default, LitePress RSS Widget displays the post title or the first 100 or so characters of a Tweet or long untitled post. These are either in the form of a link or features a link to the original source depending upon the feed’s design and structure.
- Enter the RSS feed URL in the first box, copied from the source page for the content you wish to include in your sidebar or other widgetized space.
- Give the feed a title: This is optional and gives you the chance to showcase the source of the content.
- How many items would you like to display?: By default, 10 are show, but you can choose from 1-20 posts.
- Display item content?: This allows you to show an excerpt of the content not just the title.
- Display item author if available?: If you wish to give credit to the original author of the content, check this to display the author.
- Display item date?: If available, the date of the original content will be shown.
You may add multiple RSS Widgets for incoming feeds to your LitePress sidebar and other widgetized areas of your site.