Feature A Page Widget

Description

Feature A Page Widget provides a “just works” solution for showcasing a Page, Post, or custom post type in any widget area (aka sidebar). It leverages core WordPress features, a simple set of options, and a sleek UI for selecting one of three widget layouts.

How to Use the Widget

1. Install and activate the plugin.
2. Edit the page you want to feature.
3. Fill out the Excerpt and select a Featured Image on that page.
4. Go to Appearance > Widgets or Customize > Widgets.
5. Add an instance of the “Feature a Page Widget” to the widget area (Sidebar, Footer, etc.) of your choosing.
6. Select the page, choose a layout, and optionally give the widget a title.
7. Save the widget!
8. Admire your handiwork.

This plugin enables Featured Images (aka “Post Thumbnails”) and Excerpts for Pages and Posts (by default) with the ability to support custom post types. If you don’t see one or both of those fields, they may be hidden in the “Screen Options” (top-right corner) while editing a Page or Post.

Important Note: Image Sizes

This plugin creates multiple custom image sizes. If you use images that were uploaded to the media library before you installed this plugin, you may need to use a plugin like Regenerate Thumbnails to create the correctly-sized images.

Customizing the Widget

There are multiple ways to modify the widget based on your needs:

1. Prewritten CSS selectors in /css/fpw_starter_styles.css to help you get started with custom CSS styles in a child theme or the Custom CSS Customizer field
2. Three default overridable templates and the ability to create custom templates
3. Eight filters to modify most parts of the widget output (Title, Read More, Image sizes, etc.)
4. Interested in commissioning a custom layout just for your site? Get in touch.

See the FAQs for links to code snippets with inline documentation.

Like the Plugin?

• We love 5-star ratings!
• Donations accepted

Available Languages

Please help translate Feature A Page Widget. Users have contributed translations in the following languages:

English (default), German (de_DE), Serbian (sr_RS), Polish (pl_PL), Spanish (es_ES), Italian (it_IT), Dutch (nl_NL)

Other Plugins by @MRWweb

• MRW Web Design Simple TinyMCE – Get rid of bad and obscure TinyMCE buttons. Move the rest to a single top row. Comes with a bit of help for adding custom CSS classes too.
• Post Status Menu Items – Adds post status links–e.g. “Draft” (7)–to post type admin menus.
• Post Type Archive Description – Enables an editable description for a post type to display at the top of the post type archive page.
• Hawaiian Characters – Adds the correct characters with diacriticals to the WordPress editor Character Map for Hawaiian

Screenshots

FAQ

Full Version 2.0 Documentation

Is this plugin compatible with WordPress 5.0 / “Gutenberg”?

Yes.

Because this is a widget, there is no direct integration with the WordPress post editor and the basic features of this plugin are uneffected. However, if you are using the new editor, note the new location of the Excerpt field in the sidebar.

How do I set the widget image?

The widget gets its image from the “Featured Image” field on the page you are featuring.

1. Go to the page you’re featuring.
2. In the right sidebar, look for the “Set Featured Image” link.
3. Use the media picker to find the image and then select “Use as Featured Image.”
4. Update the page and you’re ready to go.

How do I set the widget text?

The widget gets its text from the “Excerpt” field on the page you are featuring. See also: “Can I use HTML or a WYSIWYG/TinyMCE Editor with the Excerpt Field?”

1. Go to the page you want to featured.
2. Below the body field, look for the “Excerpt” field.
3. Fill it in.
4. Update the page.

Where do I find the Featured Image or Excerpt fields? I don’t see them.

The Featured Image and Excerpt fields are found on the Page editing screen of the Page you want to feature. If you don’t see them:

1. In the top right corner of any Page, click “Screen Options.”
2. From the menu that slides down, make sure the “Excerpt” and “Featured Image” are both checked.
3. WordPress will remember this choice on all pages.

Can I feature Custom Post Types?

Indeed! Pages and Posts are feature-able by default. Use fpw_post_types filter to add support for custom post types or remove Posts or Pages.

How can I modify the widget design or output?

The widget offers three ways to customize its design and output. The right method for you depends on what you want to accomplish and what you’re comfortable doing technically.

1. Write your own CSS rules. The plugin’s CSS selectors have as low a priority as possible, so you should be able to override styles easily. See /css/fpw_start_styles.css for a starter stylesheet you can copy and modify.
2. Filter the Title, Excerpt, or Image. Version 1.0 included the fpw_page_title, fpw_excerpt, and fpw_featured_image filters. Version 2.0 adds new filters fpw_post_types, fpw_widget_templates, fpw_read_more_text, and fpw_image_size.
3. Override the Widget’s output template. Each widget layout can be overridden by a template in any parent or child theme. Create an /fpw2_views/ in the active theme’s folder and copy any layout files from /wp-content/plugins/feature-a-page-widget/fpw2_views/ into the new folder to modify.
4. Create a custom layout. See this example for using the fpw_widget_templates filter. You can add new custom layouts or remove installed ones. Using the filter to only return a single layout removes the layout option from the widget and automatically uses the remaining layout.

Can I use HTML or a WYSIWYG/TinyMCE Editor with the Excerpt Field?

Install the Rich Text Excerpts plugin or Advanced Excerpt plugins. Either plugin should take note and display your nicely formatted excerpt.

Can I change the “Read More…” text?

Use the fpw_read_more_text filter.

How do I change the image’s size?

Use the fpw_image_size filter.

Can I use an auto-generated Excerpt if I haven’t filled one in?

There’s a filter for that too. See fpw_auto_excerpt.

What are those icons in the “Select Page” drop down?

When selecting the page to feature in the widget settings, the list of pages includes two icons. The first icon is the featured image, and the second is the excerpt. If the icon is “lit-up,” that means that page has that piece of information. If both are lit-up, the page is ready for optimal use in the widget. See this interface in the “Screenshots” tab.

This widget isn’t what I want…

This widget is intended to be straightforward and avoid melting into “option soup.” However, that means it might not be perfect for what you need.

If you think the widget is almost right, double-check that can’t use the one of the plugin’s filters or the widget view template (see “I want to modify how the widget looks/works”). If that doesn’t work, submit some feedback for future versions of the plugins. And of course, there’s always the support forum.

If this plugin is more than a little off, you might be looking for a different plugin like Posts in Sidebar or Genesis Featured Page Advanced (Genesis only).

Reviews

Excellent widget plugin!

Roy182 October 22, 2021 1 reply

Brilliant plugin with great support, I have used it on several sites and it makes for pretty and functional widgets in the sidebar. After the recent Wordpress update to 5.8 introduced the stupid block editor, you couldn’t select a page/post in the plugin. The workaround is to just opt out of that new interface by installing the official Classic Widgets plugin then all is good again ??

Works perfectly with WP5.2!

mlg4035 May 18, 2019

This plugin is just what I was looking for! Thanks!

Easy to handle and configure to adapt to needs.

Valérie March 13, 2019 1 reply

Well explained documentation. Very good plugin. Thank you !

Works Great!

Sparkey November 14, 2018 1 reply

So simple and front end display is seamless, our nonprofit thanks you for all you do! Randy

So easy, so powerful

kelliwise July 26, 2018 1 reply

What a great little plugin. Does exactly what I needed and it’s very customizable for custom themes. Documentation and examples on filters were easy to understand and incorporate.

5 Stars all the way

venustarot October 25, 2017 2 replies

WOW is all i can say this widget was super easy to set up and it took my theme to the next level. I was hand-coding what this widget already accomplishes so much better. Along with this I installed relevanassi for search, so I could add my featured snippet to each page on my site. Now I can feature a widget the proper way, with a pic and a snippet! Thanks to this plugin my site is complete! You guys are awesome… im donating some $$

Contributors & Developers

Changelog

2.2.0 (August 12, 2020)

• Support for WordPress 5.5
• Fix deprecated use of jQuery.live(). Props, Roy!
• Upgrade Chosen to 1.8.7 (supports jQuery 3.X)

Full Changelog