ACF Recent Posts Widget

ACFRPW adds a new widget to the Appearance -> Widgets -> ACF Recent Posts Widget. Most of the fields are quite obvious, you can choose from a set of settings to display the posts from.
Each setting alters the amount and type of posts listed in the sidebar.

Available Settings

The widget supports the following settings:

• Widget Title
• Custom Widget container CSS class
• Option to ignore sticky posts
• Search keyword query
• Id based post exclusion
• Date Display, Date Modified, Relative and Custom Date Format specifiaction
• Listing posts from specific date period (start and end)
• Listing posts with specific password, listing password protected posts only or excluding these
• Post Type selection
• Post Formats selection
• Post Statuses selection
• Listing posts limited to author via author id
• Order specifiaction (ASC or DESC)
• Orderby specification (ID, Author, Title, Date, Modified, Random, Comment Count, Menu Order, Meta Value, Meta Value Numeric)
• Meta Key specifiaction (if Meta Value or Meta Value Numeric were chosen as orderby rule)
• Meta Comparison selection
• Meta Value Specification (for the Meta Comparison selection)
• Category limitation
• Tag limitation
• Id based custom taxonomy limitation
• Operator specifiaction for the above rules
• Number of posts to show
• Number of posts to skip
• Thumbnail display, thumbnail size (width, height), thumbnail alignment, default thumbnail
• Excerpt display, its word limit, its readmore text (occurs only if the amount of words exceeds the limit)
• Custom HTML to display before the loop
• Custom HTML to display after the loop
• Custom HTML to display before each posts. It supports custom meta keys and ACF fields
• Custom HTML to display after each posts. It supports custom meta keys and ACF fields
• Custom HTML to display for no posts found
• Custom and default CSS
• Custom HTML templates

ACF supported fields

The plugin has been tested with ACF 6 (Free and Pro).

The plugin supports the following ACF fields:

• Text
• Textarea
• Number
• Email
• Password
• Wysiwg Editor
• Image
• File

No other fields have been tested and are supported at the moment.

Shortcode

From version 4.4 the plugin supports shortcode embeds. Given the amount of options and their specific names (as in shortcode attributes) the shorcode builder has been introduced
see 7th and 8th screenshots for the reference.

You’ll see a popup once clicked on ACFRPW button which gives one an ability to automatically set up the shortcode code for you. The rest follows all of the options specified here.

To use the shortcode one needs to have the WordPress editor enabled for the current page / post type. In case it was disabled (say via ACF) the button won’t appear.

Creating Custom Templates

From version 4.3 the plugin supports custom templates. To make usage of these one needs to make a copy of all the files found
in the acf-recent-posts-widget/templates directory and copy them over to the active template directory to acfrpw subdirectory.
The approach is similar to the way WooCommerce plugin works and has it’s drawbacks. With every new feature the files may be outdated.

Similarly to the widget template files, a separate, custom markup can be created for the shortcode build post listing. Copy the acf-recent-posts-widget/template files
to acfrpw-blog directory created inside your active theme directory.

Read the full description on the official page →