Want to skyrocket the popularity of your plugin and reach millions of eager users? Look no further than WP Hive. Gain credibility through in-depth reviews, drive conversions with targeted email marketing, and boost visibility with strategic social promotion and exposure
Sorry, pal! The plugin couldn’t pass all our tests. No hard feelings, right?
Tests done by WP Hive test script Results
Minimal impact on memory usage The memory usage of this plugin is less than the average memory usage of other plugins on WordPress.org + 200KB. Check FAQ for more.
Minimal impact on pagespeed The impact of this plugin on PageSpeed is less than the average impact of other plugins on WordPress.org + 1000 milliseconds
No PHP errors, warning, notices WP Hive automated test found no PHP error while activating this plugin on our server
No Javascript issues WP Hive automated test found no JavaScrip error while activating this plugin on our server
Latest PHP 8.1.12 compatible WP Hive automated test found the plugin fully compatible with the latest version of PHP
Latest WordPress 6.2.2 compatible WP Hive automated test found the plugin fully compatible with the latest version of WordPress
Optimized database footprint The plugin creates less than 50 database tables
No activation errors WP Hive automated test found no activation error while activating this plugin on our server
No resource errors WP Hive automated test found no resource error/s while trying this plugin on our server
Frequently updated The plugin was not updated at least once in the last 90 days
All the plugins are tested on the same server with exactly same configuration via test script that automatically activates and logs the data WP Hive shows.
All the scripts run on a VPS with 8 CPU cores and 8 GB of RAM.
The test sites are hosted on Google Cloud VM instances, one site/plugin per instance. The machine type is n1-standard-1. The server is a 8 core CPU with 8GB of RAM.
The test sites are hosted on Apache/2 server and they are tested on PHP 8.1.12 & WordPress 6.2.2.
The database server is MySQL 10.6.10 and the default PHP memory limit is 512M.
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....
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)
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 written and tested with ACF 4 (Free). Since version 4.1.5 ACF Pro is also supported,
but there’s no guarantee to the code – it’s a Beta phase and will be kept as long as ACF Pro will not have any bigger
differences between the ACF Free.
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.
Template files
There are 3 main template files:
loop-after.php (which displays the markup after each of the posts and closes the markup container)
loop-before.php (which displays the markup before each of the posts and opens the markup container)
loop-inner.php (which is enqueued for each of the posts separatelly and contains the markup of every single post)
Usage
The usage is quite advanced hence each template file contains a quite detailed documentation on how to use it.
First of all the template files mustn’t have the global variables removed. Each of these variables stores the widget settings, which are then used to generate the code.
Second of all the variable names are unobvious, loop-inner.php template file contains a list of all the names used, which are then extracted and available as php variables.
Different template per widget / sidebar
The templates allow one to adjust the markup of each single widget. One needs first to verify the widget id used, which may then be referenced.
The variable which stores the widget id is $acf_rpw_args[‘widget_id’]. Dumping the value in the template is the best way to find out which automatic id has been created for your widget.
The best way to handle the templates is to learn from their code. My personal suggestion is to copy over the templates to the current theme and work directly on them, doing one change at a time.
The templates require learning curve to use and there’s no single answer to everyones problem.
Complex usage
This section covers plugin complex usage for advanced user willing to have more control over the behavior of the plugin as well as explains uncommon functionalities.
Using the HTML textarea fields
These sections might not be obvious. The HTML or text before / after the whole loop setting is an area where you can specify custom HTML markup to be added before / after the whole posts list.
The HTML or text before / after each post is an area where you can not only specify custom HTML, but you are also given an ability to print any meta key or certain ACF fields (see ACF supported fields)
Meta Key Name / ACF Usage
These fields need to be wrapped inside the {meta name} or {acf field_name} tags (which are similar to shortcodes). The plugin will then parse these fields and print their according value. Say we have a custom ACF field of type text, for which the Field Name is “text”.
To print its value one has to use [acf text] inside the befoe / after each post textarea. A similar solution applies to the meta key.
Meta Value Usage
The Meta Value field supports an array of elements, so that all of the meta_compare parameters could be used. To do so, please specify the two parameters separated by semicolon, for instance: 1234;12345.
The plugin will convert these into an array and apply the proper operation for the two. Whatsmore the [date] shortcode can be used here. It takes the timestamp paramater as an argument, which is required – the possible arguments are the same as for
the function described here: http://php.net/manual/pl/function.strtotime.php. For instance [date +1 day] would generate the tomorrow date in “Ymd” format.
This can be used with custom meta field date.
Plugin Filters
The are several filters that can be used to enchance the plugin programatically:
‘acf_rwp_query’ which gives one the ability to filter the query applied to each widget.
‘acp_rwp_before’ which gives on the ability to filter the Front End output of the plugin before each post. There are two hooks attached here already which allow usage of the [acf] and [meta] shortcodes.
‘acp_rwp_after’ which gives on the ability to filter the Front End output of the plugin after each post. There are two hooks attached here already which allow usage of the [acf] and [meta] shortcodes.
‘acf_meta_value’ which filters the meta_value query parameter.
Check the acf_widget_widget file for the arguments and use cases.
Dependencies
ACF (optional)
Widget Base Class (included)
Shortcode popups generator (included)
Other
Online Demo
Plugin site and Docs
Plugin Development Survey
Languages Supported
English (default)
Polish (since May 11 2015)
French (since June 29 2015), by wolforg, standalone source
Sponsors
Sponsored By: Infolinks, Smart Ads for WordPress sites.
Want to skyrocket the popularity of your plugin and reach millions of eager users? Look no further than WP Hive. Gain credibility through in-depth reviews, drive conversions with targeted email marketing, and boost visibility with strategic social promotion and exposure
Speed Test Benchmark
Learn more how we collect the data
Memory Usage Benchmark
Learn more how we collect the data
Stats
More
Email Subscription Request
Be Part of the Conversation with WordPress Enthusiasts
Using ACF Recent Posts Widget? Great, join the conversation now!
Let’s talk about overall quality, ease of use, stellar support, unbeatable value, and the amazing experience ACF Recent Posts Widget brings to you.