Title: ACF Recent Posts Widget
Author: magicoders
Published: <strong>14 במרץ 2015</strong>
Last modified: 20 בנובמבר 2023

---

חיפוש תוספים

![](https://ps.w.org/acf-recent-posts-widget/assets/banner-772x250.png?rev=2945083)

תוסף זה **לא נבדק ב-3 הגרסאות הראשיות האחרונות של וורדפרס**. ייתכן והתוסף כבר לא
מתוחזק או נתמך על ידי יוצריו, וייתכן שיהיו לו בעיות תאימות בגרסות וורדפרס עדכניות
יותר.

![](https://ps.w.org/acf-recent-posts-widget/assets/icon-256x256.png?rev=2945083)

# ACF Recent Posts Widget

 מאת [magicoders](https://profiles.wordpress.org/patopaiar/)

[הורדה](https://downloads.wordpress.org/plugin/acf-recent-posts-widget.5.9.4.zip)

 * [פרטים](https://he.wordpress.org/plugins/acf-recent-posts-widget/#description)
 * [סקירות](https://he.wordpress.org/plugins/acf-recent-posts-widget/#reviews)
 *  [התקנה](https://he.wordpress.org/plugins/acf-recent-posts-widget/#installation)
 * [פיתוח](https://he.wordpress.org/plugins/acf-recent-posts-widget/#developers)

 [תמיכה](https://wordpress.org/support/plugin/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:

 * כותרת יישומון
 * 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 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:

 * טקסט
 * אזור טקסט
 * מספר
 * דוא"ל
 * סיסמה
 * Wysiwg Editor
 * תמונה
 * קובץ

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

#### שורטקוד

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)

#### אופן שימוש

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](https://he.wordpress.org/plugins/acf-recent-posts-widget/?output_format=md#acf-support))

#### 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](http://www.advancedcustomfields.com/) (optional)
 * [Widget Base Class](https://github.com/gicolek/Widget-Base-Class) (included)
 * [Shortcode popups generator](https://github.com/gicolek/shortcode-popups) (included)

#### סדר

 * [Online Demo](http://acfrpw-demo.wp-doin.com/)
 * [Plugin site and Docs](http://wp-doin.com/portfolio/acfrpw/)
 * [Plugin Development Survey](http://wp-doin.com/2015/10/21/acf-recent-posts-widget-survey/)

#### Languages Supported

 * English (default)
 * Polish (since May 11 2015)
 * French (since June 29 2015), by [wolforg](https://wordpress.org/support/profile/wolforg),
   [standalone source](http://www.wptrads.com/extension/acf-recent-posts-widget/)
 * Spanish (since July 30 2023)

## צילומי מסך

 * [[
 * Installing the plugin
 * [[
 * Meta Key placement (found at the bottom of each post / page edit screen)
 * [[
 * ACF Field Name placement (found under Custom Fields section with ACF enabled)
 * [[
 * First widget screen
 * [[
 * Second widget screen
 * [[
 * Third widget screen
 * [[
 * שורטקוד button
 * [[
 * שורטקוד creator screen
 * [[
 * Custom templates placement

## התקנה

This section describes how to install the plugin and get it working.

 1. Upload and unpack `acf-widget.zip` to the `/wp-content/plugins/` directory
 2. יש להפעיל את התוסף דרך התפריט ’תוספים‘ בוורדפרס
 3. Drag and Drop the ACF Recent Posts Widget to the sidebar area

## שאלות נפוצות

### Does the Plugin require Advanced Custom Fields?

No it doesn't. Some functionalities will be missing though and a notification will
be shown to the user on Plugins dashboard page.

### What ACF version does it support?

The plugin supports the latest ACF 6.X.X version.

### Does the Widget support author display?

No it doesn't. We're considering this as an update.

### Does the Plugin support shortcodes, or custom posts function?

Yes, the plugin does support shortcodes since version 4.4.

### Does the Widget come with any pre made classes to wrap the HTML with?

No it doesn't.

### The widget styles are messy and the thumbnail doesn't adjust its position ?

Please make sure to have the default styles checkbox checked.

## סקירות

![](https://secure.gravatar.com/avatar/94985294124b45683f4e7ab1f4290f76067fc8ab25b2c6884ecb3d3f7853edea?
s=60&d=retro&r=g)

### 󠀁[Works fine and no glitches so far](https://wordpress.org/support/topic/works-fine-and-no-glitches-so-far/)󠁿

 [AlwaysEnthusiast](https://profiles.wordpress.org/alwaysenthusiast/) 16 במרץ 2023
1 reply

I have been using another similar plugin that started to behave illogical after 
that plugin was updated. The glitch was not fixed so I looked around for other plugins
and found this. It does what I want with lots of optional settings. Thanks!

![](https://secure.gravatar.com/avatar/17378ad6e353efdd39b24fedae2730f405bd27bc3a6258075165cd38db222c25?
s=60&d=retro&r=g)

### 󠀁[Super Great Plugin](https://wordpress.org/support/topic/super-great-plugin-6/)󠁿

 [christianholy](https://profiles.wordpress.org/christianholy/) 19 בדצמבר 2019 1
reply

Showing upcoming Events-Post in the Sidebar as Widget – solved with this plugin 
and this support answer: https://wordpress.org/support/topic/hook-to-show-future-
posts/

![](https://secure.gravatar.com/avatar/96c0bd02cdbe7097f218dfd9b1de952a392538ba5c709474346f26eb810d26d7?
s=60&d=retro&r=g)

### 󠀁[One of the most essential plugins around](https://wordpress.org/support/topic/one-of-the-most-essential-plugins-around/)󠁿

 [mindfulcreative](https://profiles.wordpress.org/mindfulcreative/) 25 בנובמבר 2019
1 reply

This plugin does exactly what it's meant to do. If you're looking to create custom
feeds of custom post-types, custom taxonomies, etc. using your custom fields, this
is the only plugin you need. The fantastic support is a plus too!

![](https://secure.gravatar.com/avatar/8e5fb1e3f3e6938d9e9610960a967f1501bdadaff574f5b489fd6799b06082f6?
s=60&d=retro&r=g)

### 󠀁[Great plugin, works like a charm](https://wordpress.org/support/topic/great-plugin-works-like-a-charm-18/)󠁿

 [dexdeckers](https://profiles.wordpress.org/dexdeckersgmailcom/) 18 באוקטובר 2019
1 reply

Friendly dev also, 5/5 stars for this one 🙂

![](https://secure.gravatar.com/avatar/6773458ccc57eec21ce50b8c78080ad18d3275abf47594e192f09ebb5c740240?
s=60&d=retro&r=g)

### 󠀁[Must have!](https://wordpress.org/support/topic/must-have-378/)󠁿

 [rmizrah1](https://profiles.wordpress.org/rmizrah1/) 1 במאי 2018 1 reply

Thank you for the great plugin (:

![](https://secure.gravatar.com/avatar/2ac8c126d529788177e4cf51b918b67fe29212c18eb21541d9a1e0f684d5c761?
s=60&d=retro&r=g)

### 󠀁[Game changing widget and great support and response](https://wordpress.org/support/topic/game-changing-widget-and-great-support-and-response/)󠁿

 [Eric Greenspan](https://profiles.wordpress.org/tothemoonsb/) 6 במרץ 2017

This widget works and it does so much. Give it some time to learn and tweak but 
it can truly do amazing things with advanced custom fields and recent posts. Love
it!

 [ קראו את כל 12 הסקירות ](https://wordpress.org/support/plugin/acf-recent-posts-widget/reviews/)

## מפתחים

"ACF Recent Posts Widget" הוא תוסף קוד פתוח. האנשים הבאים תרמו ליצירת התוסף הזה.

תורמים

 *   [ magicoders ](https://profiles.wordpress.org/patopaiar/)
 *   [ Rafał Gicgier ](https://profiles.wordpress.org/gicolek/)

“ACF Recent Posts Widget” תורגם ל-2 שפות. תודה רבה ל[מתרגמים](https://translate.wordpress.org/projects/wp-plugins/acf-recent-posts-widget/contributors)
על תרומתם.

[ניתן לתרגם את "ACF Recent Posts Widget" לשפה שלך.](https://translate.wordpress.org/projects/wp-plugins/acf-recent-posts-widget)

### מעוניינים בפיתוח?

[עיינו בקוד](https://plugins.trac.wordpress.org/browser/acf-recent-posts-widget/),
ראו את הקוד ב-[SVN repository](https://plugins.svn.wordpress.org/acf-recent-posts-widget/),
או הירשמו ל[לוג פיתוח](https://plugins.trac.wordpress.org/log/acf-recent-posts-widget/)
באמצעות [RSS](https://plugins.trac.wordpress.org/log/acf-recent-posts-widget/?limit=100&mode=stop_on_copy&format=rss).

## שינויים

#### 5.9.4

** Ensured compatibility with 6.4.1 WordPress Core

#### 5.9.3

 * Added Spanish language support.
 * Ensured compatibility with ACF 6

#### 5.9.2

** Ensured compatibility with 6.2.2 WordPress Core

#### 5.9

** Ensured compatibilty with the Block Widget editor

#### 5.2.5

** Add ability to specify text for no posts found **
 * Introduced a new textarea
field allowing one to specify empty query results HTML *

#### 5.2.3, 5.2.4

** Compatbility Fix and Language Pack Updatess **

 * Fix language packs *
 * Ensured compatiblity with latest WP

#### 4.6.2

** Compatbility Fix and Check **

 * Fix issues with ACF image and file fields
 * Ensured compatiblity with latest WP

#### 4.6.1

**Shortcode improvement fix**

 * Add an ability to use {meta} and {acf} fields within the shortcode, by changing
   the surrounding wrapper from [] to {}
    to avoid built in shortcode conflicts
 * Fix some PHP warnings and different case scenarios *

#### 4.6

**Compatibility release**

 * assure plugin is stable with the latest WordPress version

#### 4.5

 * Remove survey settings tab – introduce options tab
 * Add option to disable the shortcode button
 * Add option to disable the "Missing ACF" notice
 * Fix shortcode button styles in correspondence to other media buttons
 * Add more descriptive text to the "Display Thumbnail" setting

#### 4.4

 * fixed meta compare bugs
 * made all thumbnails post links
 * introduced shortcode builder to embed the posts inside any post or page supporting
   Visual Editor

#### 4.3

 * introduce customizable plugin templates
 * tweak a bug with similar name for two widget arguments causing a conflict

#### 4.2.1

 * revisit the plugin menu page

#### 4.2

**Compatbility release**

 * make sure the plugin is compatible with the latest WordPress version
 * add plugin page (with a survey question)

#### 4.1.6

**Bug Fixes**

 * make sure the date can be hidden
 * make sure the thumbnail can be hidden

**ACF Pro Beta Support**

 * add option to print post modified date

#### 4.1.5

**ACF Pro Beta Support**

ACF Pro is supported from now on. However due to possible differences between ACF
4
 there is no guarantee of its support

**Bug Fixes**

 * make sure there are no strict standards errors while printing the excerpt
 * fix read more button not appearing due to sticky posts conflict
 * make sure ignore sticky posts option works

#### 4.1.4

**Bug Fixes**

 * Make sure there are no wrong constants used
 * Fix undefined index issue in a number of cases

**New language support**

 * French, by: wolforg / http://www.wptrads.com/extension/acf-recent-posts-widget/

#### 4.1.3

**Meta Key options**

 * add meta_compare query parameter
 * add meta_value query parameter
 * add ability to specify date shortcode inside the meta_value box

**Introduce plugin filters**

 * add ability to filter the query using add_filter function

**Revamp the readme file**

**Introduce polish version**

#### 4.1.2

**Small bug fixes**

 * fix issue with plugin not enqueueing default styles in certain cases
 * fix issue with date being displayed all the time
 * improve readme

#### 4.1.1

**Plugin first release**

## מטא

 *  גרסה: **5.9.3**
 *  Last updated **לפני 2 שנים**
 *  Active installations **500+**
 *  WordPress version ** 4.6 ומעלה **
 *  Tested up to **6.2.9**
 *  Languages
 * [English (US)](https://wordpress.org/plugins/acf-recent-posts-widget/), [German](https://de.wordpress.org/plugins/acf-recent-posts-widget/),
   ו[Swedish](https://sv.wordpress.org/plugins/acf-recent-posts-widget/).
 *  [תרגם לשפה שלך](https://translate.wordpress.org/projects/wp-plugins/acf-recent-posts-widget)
 * Tags
 * [acf](https://he.wordpress.org/plugins/tags/acf/)[posts](https://he.wordpress.org/plugins/tags/posts/)
   [recent](https://he.wordpress.org/plugins/tags/recent/)[widget](https://he.wordpress.org/plugins/tags/widget/)
 *  [תצוגה מתקדמת](https://he.wordpress.org/plugins/acf-recent-posts-widget/advanced/)

## דרוגים

 5 out of 5 stars.

 *  [  12 5-star reviews     ](https://wordpress.org/support/plugin/acf-recent-posts-widget/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/acf-recent-posts-widget/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/acf-recent-posts-widget/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/acf-recent-posts-widget/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/acf-recent-posts-widget/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/acf-recent-posts-widget/reviews/#new-post)

[הצג הכל](https://wordpress.org/support/plugin/acf-recent-posts-widget/reviews/)

## תורמים

 *   [ magicoders ](https://profiles.wordpress.org/patopaiar/)
 *   [ Rafał Gicgier ](https://profiles.wordpress.org/gicolek/)

## תמיכה

יש לך משהו לומר? זקוק לעזרה?

 [פורום תמיכה](https://wordpress.org/support/plugin/acf-recent-posts-widget/)

## תרומה

האם ברצונך לקדם את התוסף הזה?

 [ לתרום לתוסף זה ](https://www.paypal.com/donate/?business=MP9PGN5BG65SL&no_recurring=1&item_name=Donate+to+the+development+of+ACF+Recent+Posts&currency_code=USD)