ACF Recent Posts Widget

Beschreibung

ACFRPW fügt ein neues Widget zum Design -> Widgets -> ACF Recent Posts Widget hinzu. Die meisten der Felder sind ziemlich offensichtlich, du kannst aus einer Reihe von Einstellungen wählen, um die Beiträge anzuzeigen.
Jede Einstellung verändert die Anzahl und Art der Beiträge, die in der Seitenleiste aufgelistet werden.

Verfügbare Einstellungen

Das Widget unterstützt die folgenden Einstellungen:

• Titel des Widget
• Individuelle Widget-Container CSS-Klasse
• Option um oben gehaltene Beiträge zu ignorieren
• Suchbegriff-Abfrage
• Id basierter Beitrags-Ausschluss
• Datumsanzeige, Änderungsdatum, relatives und individuelles Datumsformat spezifizieren
• Auflistung von Beiträgen aus einem bestimmten Datumszeitraum (Start und Ende)
• Beiträge mit spezifischem Passwort auflisten, nur passwortgeschützte Beiträge auflisten oder diese ausschließen
• Beitragstyp Auswahl
• Auswahl der Beitragsformate
• Auswahl Beitrags-Status
• Auflistung von Beiträgen begrenzt auf Autor über Autor-ID
• Sortier-Spezifikation (ASC oder DESC)
• Sortierung-nach-Angabe (ID, Autor, Titel, Datum, Geändert, Zufällig, Kommentaranzahl, Menüreihenfolge, Meta-Wert, Meta-Wert Numerisch)
• Meta-Schlüssel-Spezifikation (wenn Meta-Wert oder Meta-Wert-Numerisch als ordne-nach-Regel gewählt wurde)
• Meta-Vergleich-Selektion
• Meta-Wert Spezifikation (für die Meta Vergleichsauswahl)
• Kategorie-Begrenzung
• Schlagwort-Begrenzung
• Id-basierte individuelle Taxonomie Einschränkung
• Operator-Spezifikation für die obigen Regeln
• Anzahl anzuzeigender Einträge
• Anzahl der zu überspringenden Beiträge
• Vorschaubild-Anzeige, Größe der Vorschaubilder (Breite, Höhe), Ausrichtung der Vorschaubilder, Standard Vorschaubilder
• Text-Auszugsanzeige, ihr Wortlimit, ihr Readmore-Text (erscheint nur, wenn die Anzahl der Wörter das Limit überschreitet)
• Individuelles HTML zur Anzeige vor der Schleife
• Individuelles HTML zur Anzeige nach der Schleife
• Individuelles HTML, das vor jedem Beitrag angezeigt wird. Es unterstützt individuelle Metaschlüssel und ACF-Felder
• Individuelles HTML zur Anzeige nach jedem Beitrag. Es unterstützt individuelle Metaschlüssel und ACF-Felder
• Individuelles HTML zur Anzeige von nicht gefundenen Beiträgen
• Individuelles und Standard-CSS
• Individuelle HTML-Templates

ACF-unterstützte Felder

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

Das Plugin unterstützt die folgenden ACF-Felder:

• Textzeile
• Textbereich
• Nummer
• E-Mail
• Kennwort
• Wysiwg Editor
• Bild
• Datei

Andere Felder wurden noch nicht getestet und werden derzeit nicht unterstützt.

Kurzwahlnummer

Ab Version 4.4 unterstützt das Plugin Shortcode-Einbettungen. Angesichts der Menge der Optionen und ihrer spezifischen Namen (wie in den Shortcode-Attributen) wurde der Shortcode-Builder eingeführt
siehe 7. und 8. Screenshots für die Referenz.

Wenn man auf den ACFRPW-Button klickt, erscheint ein Popup-Fenster, in dem man den Shortcode-Code automatisch einrichten kann. Der Rest folgt allen hier angegebenen Optionen.

Um den Shortcode verwenden zu können, muss der WordPress-Editor für die aktuelle Seiten-/Beitragsart aktiviert sein. Falls er deaktiviert wurde (z.B. über ACF), wird der Button nicht angezeigt.

Individuelle Templates erstellen

Ab Version 4.3 unterstützt das Plugin individuelle Templates. Um diese nutzen zu können, muss man eine Kopie aller der
Im Verzeichnis acf-recent-posts-widget/templates gefundenen Dateien erstellen und sie im aktiven Template-Verzeichnis in das Unterverzeichnis acfrpw einfügen.
Der Ansatz ist ähnlich der Arbeitsweise des WooCommerce-Plugins und hat seine Nachteile. Mit jeder neuen Funktion können die Dateien veraltet sein.

Ähnlich wie bei den Widget Template-Dateien kann ein separates, benutzerdefiniertes Markup für den Shortcode Build-Post-Listing erstellt werden. Kopiere die acf-recent-posts-widget-/Template-Dateien
in das Verzeichnis acfrpw-blog, das innerhalb des aktiven Theme-Verzeichnisses erstellt wurde.

Template-Dateien

Es gibt 3 Haupt-Template-Dateien:

• loop-after.php (die das Markup nach jedem Beitrag anzeigt und den Markup-Container schließt)
• loop-before.php (die das Markup vor jedem der Beiträge anzeigt und den Markup-Container öffnet)
• loop-inner.php (die für jeden einzelnen Beitrag separat aufgerufen wird und das Markup jedes einzelnen Beitrags enthält)

Verwendung

Die Verwendung ist recht fortschrittlich, daher enthält jede Template-Datei eine recht ausführliche Dokumentation über ihre Anwendung.

Zunächst einmal dürfen in den Template-Dateien die globalen Variablen nicht entfernt werden. Jede dieser Variablen speichert die Widget-Einstellungen, die dann zur Generierung des Codes verwendet werden.
Zweitens sind die Variablennamen nicht offensichtlich, die Template-Datei loop-inner.php enthält eine Liste aller verwendeten Namen, die dann extrahiert werden und als php-Variablen zur Verfügung stehen.

Unterschiedliches Template pro Widget/Seitenleiste

Die Templates erlauben es, das Markup jedes einzelnen Widgets anzupassen. Zuerst muss die verwendete Widget-ID überprüft werden, die dann referenziert werden kann.
Die Variable, die die Widget-ID speichert, lautet $acf_rpw_args[‚widget_id‘]. Das Dumping des Wertes im Template ist der beste Weg, um herauszufinden, welche automatische ID für das Widget erstellt wurde.

Der beste Weg, mit den Templates umzugehen, ist, von ihrem Code zu lernen. Mein persönlicher Vorschlag ist, die Templates in das aktuelle Theme zu kopieren und direkt daran zu arbeiten, indem man eine Änderung nach der anderen vornimmt.
Die Verwendung der Vorlagen erfordert eine Lernkurve, und es gibt keine Patentlösung für jedermanns 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.

Abhängigkeiten

• ACF (optional)
• Widget Basisklasse (enthalten)
• Shortcode-Popup-Generator (enthalten)

Sonstige

• Online Demo
• Plugin Website und Docs
• Befragung zur Plugin-Entwicklung

Unterstützte Sprachen

• Englisch – Standard
• Polnisch (seit 11. Mai 2015)
• Französisch (seit 29. Juni 2015), von wolforg, Einzelquelle
• Spanish (since July 30 2023)