ACF Recent Posts Widget

Beschreibung

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:

  • Titel des Widget
  • 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
  • Anzahl anzuzeigender Einträge
  • 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
  • Individuelles HTML zur Anzeige von nicht gefundenen Beiträgen
  • 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:

  • Textzeile
  • Text-Bereich.
  • Nummer
  • E-Mail
  • Kennwort
  • Wysiwg Editor
  • Bild
  • Datei

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

Kurzwahlnummer

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)

Verwendung

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.

Komplexe Nutzung

Dieser Abschnitt behandelt die komplexe Nutzung des Plugins für fortgeschrittene Benutzer, die mehr Kontrolle über das Verhalten des Plugins haben möchten, und erklärt ungewöhnliche Funktionalitäten.

Verwendung der HTML-Textarea-Felder

Diese Abschnitte sind vielleicht nicht offensichtlich. Die Einstellung HTML oder Text vor/nach der gesamten Schleife ist ein Bereich, in dem du individuelles HTML-Markup angeben kannst, das vor/nach der gesamten Beitragsliste hinzugefügt werden soll.
Das HTML oder der Text vor/nach jedem Beitrag ist ein Bereich, in dem man nicht nur individuelles HTML angeben kann, sondern in dem man auch die Möglichkeit hat, jeden Metaschlüssel oder bestimmte ACF-Felder zu drucken (siehe ACF-unterstützte Felder)

Meta-Schlüsselname/ACF-Verwendung

Diese Felder müssen in die {meta name} oder {acf field_name}-Tags (die den Shortcodes ähnlich sind) eingeschlossen werden. Das Plugin wird dann diese Felder parsen und ihren entsprechenden Wert ausgeben. Angenommen, wir haben ein individuelles ACF-Feld vom Typ Text, für das der Feldname „text“ ist.
Um seinen Wert auszudrucken, muss man [acf text] innerhalb der vor/nach jeder Beitrags-Textarea verwenden. Eine ähnliche Lösung gilt für den Metaschlüssel.

Verwendung von Metawerten

Das Feld Metawert unterstützt eine Reihe von Elementen, sodass alle Meta_compare-Parameter verwendet werden können. Dazu gebe bitte die beiden Parameter durch Semikolon getrennt an, zum Beispiel: 1234;12345.
Das Plugin wandelt diese in ein Array um und wendet die richtige Operation für die beiden an. Außerdem kann hier der [date]-Shortcode verwendet werden. Er nimmt den Zeitstempel-Parameter als Argument, der erforderlich ist – die möglichen Argumente sind die gleichen wie bei der
hier beschriebene Funktion: http://php.net/manual/pl/function.strtotime.php. Zum Beispiel würde [date +1 day] das Datum von morgen im „Ymd“-Format erzeugen.
Dies kann mit dem individuellen Metafeld date verwendet werden.

Plugin-Filter

Es gibt verschiedene Filter, die verwendet werden können, um das Plugin programmatisch zu verbessern:

  • ‚acf_rwp_query‘, bietet die Möglichkeit, die auf jedes Widget angewandte Abfrage zu filtern.
  • ‚acp_rwp_before‘, die die Möglichkeit bietet, die Frontend-Ausgabe des Plugins vor jedem Beitrag zu filtern. Hier sind bereits zwei Hooks angebracht, die die Verwendung der Shortcodes [acf] und [meta] ermöglichen.
  • ‚acp_rwp_after‘, der die Möglichkeit bietet, die Frontend-Ausgabe des Plugins nach jedem Beitrag zu filtern. Hier sind bereits zwei Hooks angebracht, die die Verwendung der Shortcodes [acf] und [meta] ermöglichen.
  • ‚acf_meta_value‘, der den Abfrageparameter ‚meta_value‘ filtert.

Überprüfe die acf_widget_widget Datei für die Argumente und Anwendungsfälle.

Dependencies

Sonstige

Languages Supported

Sponsoren

Gesponsert von: Infolinks, Smart Ads for WordPress Websites.

Screenshots

  • 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
  • Kurzwahlnummer button
  • Kurzwahlnummer creator screen
  • Custom templates placement

Installation

In diesem Abschnitt wird beschrieben, wie du das Plugin installieren kannst und wie es arbeitet.

  1. Upload and unpack acf-widget.zip to the /wp-content/plugins/ directory
  2. Aktiviere das Plugin über das Menü „Plugins“ in WordPress
  3. Drag and Drop the ACF Recent Posts Widget to the sidebar area

FAQ

Does the Plugin require Advanced Custom Fields?

Nein, tut es nicht. Einige Funktionalitäten werden jedoch fehlen und eine Benachrichtigung wird dem Benutzer auf der Dashboard-Seite des Plugins angezeigt.

What ACF version does it support?

Das Plugin unterstützt die neueste Version ACF 4.X.X, derzeit befindet sich ACF 5 in der Beta-Phase und wird nicht vollständig unterstützt. Das Plugin sollte jedoch gut funktionieren, solange es keine großen Unterschiede zwischen den beiden Versionen gibt. Wenn du den Hinweis loswerden möchtest, siehe: https://wordpress.org/support/topic/acf-5-compatibility-2

Does the Widget support author display?

Nein, das tut es nicht. Wir betrachten dies als eine Aktualisierung.

Unterstützt das Plugin Shortcodes oder individuelle Beiträge?

Ja, das Plugin unterstützt seit Version 4.4 Shortcodes.

Wird das Widget mit vorgefertigten Klassen geliefert, mit denen man das HTML umschließen kann?

Nein, das tut es nicht.

Die Stile der Widgets sind unordentlich und das Vorschaubild passt seine Position nicht an?

Bitte stelle sicher, dass das Kontrollkästchen „Standard-Stile“ aktiviert ist.

Rezensionen

19. Dezember 2019
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/
25. November 2019
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!
Lies alle 11 Rezensionen

Mitwirkende & Entwickler

„ACF Recent Posts Widget“ ist Open-Source-Software. Folgende Menschen haben an diesem Plugin mitgewirkt:

Mitwirkende

„ACF Recent Posts Widget“ wurde in 2 Sprachen übersetzt. Danke an die Übersetzerinnen und Übersetzer für ihre Mitwirkung.

Übersetze „ACF Recent Posts Widget“ in deine Sprache.

Interessiert an der Entwicklung?

Durchstöbere den Code, sieh dir das SVN Repository an oder abonniere das Entwicklungsprotokoll per RSS.

Änderungsprotokoll

5.2.5

** Add ability to specify text for no posts found **
* Introduce 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 *
  • assure compatiblity with latest WP

4.6.2

** Compatbility Fix and Check **

  • Fix issues with ACF image and file fields
  • assure 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