Wie verwende ich die WP_Query-Klasse in WordPress?

Wie können Sie WP_Query nutzen?

Jetzt wissen Sie, was WP_Query ist und was genau es tut. Lassen Sie uns verschiedene Fallszenarien untersuchen, in denen Sie dieses leistungsstarke Tool nutzen können.

1. Erstellen Sie eine Schleife in WP_Query

Zunächst sollten Sie verstehen, was Loop ist. Es ist ein Teil von WordPress, der sehr reaktionsschnell ist, um Beitragsdaten aus den Daten abzurufen und auf Ihrer Website anzuzeigen. Der Schwerpunkt liegt hauptsächlich auf der Entscheidung, wie Ihre Inhalte basierend auf den Vorlagen Ihres Themes aussehen.

Was kann der Loop auf der Website anzeigen?

Abhängig von den von Ihnen gewählten Einstellungen kann der Loop Folgendes anzeigen:

• Benutzerdefinierte Beitragstypen und benutzerdefinierte Felder
• Veröffentlichen Sie Titel und kurze Beschreibungen auf Ihrer Homepage
• Der Inhalt und die Kommentare eines einzelnen Beitrags
• Inhalte einzelner Seiten mithilfe von Template-Tags

Zum besseren Verständnis finden Sie unten eine einfache Struktur von Loop.

Beispiel für eine einfache Schleife

<?php
if ( have_posts() ) :
while ( have_posts() ) : the_post();
// Display post content
endwhile;
endif;
?>

• Hier prüft die Funktion have_posts() , ob Beiträge verfügbar sind.
• while ( have_posts() ) : the_post(); : Wenn Beiträge vorhanden sind, wird diese Schleife für jeden Beitrag ausgeführt und dessen Inhalt angezeigt.

Anpassen der Schleife mit WP_Query

Manchmal möchten Sie nicht alle Ihre Beiträge anzeigen. Sie können WP_Query verwenden, um anzupassen, was angezeigt wird:

<?php
// The Query
$the_query = new WP_Query( $args );

// The Loop
if ( $the_query->have_posts() ) {
echo '<ul>';
while ( $the_query->have_posts() ) {
$the_query->the_post();
echo '<li>' . get_the_title() . '</li>';
}
echo '</ul>';
} else {
// No posts found
}
/* Restore original Post Data */
wp_reset_postdata();
?>


So funktioniert diese benutzerdefinierte Schleife

• Einrichten der Abfrage : $the_query = new WP_Query( $args ); erstellt eine benutzerdefinierte Abfrage basierend auf den von Ihnen festgelegten Parametern (wie Beitragstyp, Kategorie usw.).
• Ausführen der Schleife : if ( $the_query->have_posts() ) { ... } prüft, ob Beiträge vorhanden sind, die Ihrer Abfrage entsprechen. Wenn dies der Fall ist, wird der Titel jedes Beitrags in einer Liste angezeigt.
• Beitragsdaten zurücksetzen : wp_reset_postdata(); Stellt sicher, dass die ursprünglichen Beitragsdaten wiederhergestellt werden, nachdem die benutzerdefinierte Schleife ausgeführt wurde.

Anpassungsoptionen

Mit WP_Query können Sie:

• Zeigen Sie Beiträge aus einer bestimmten Kategorie, einem bestimmten Autor oder einem bestimmten Datumsbereich an
• Zeigen Sie Beiträge mit bestimmten Tags oder benutzerdefinierten Feldern an

2. WP_Query-Argumente

Wenn Sie bestimmte Beiträge von Ihrer WordPress-Site erhalten möchten, müssen Sie WP_Query erstellen und dafür vier grundlegende Teile einbinden:

• Abfrageargument : Teilt WordPress mit, welche Daten abgerufen werden sollen.
• Die Abfrage : Verwendet das Argument, um die Daten abzurufen.
• Die Schleife : Verarbeitet und zeigt jeden Beitrag an.
• Post Data Reset : Setzt die Daten zurück, nachdem die Schleife ausgeführt wurde.

Eine der wichtigsten Komponenten von WP_Query ist jedoch das Argument (oft als WP_Query-Argumente bezeichnet), das für das Extrahieren des spezifischen Beitrags, den Sie abrufen möchten, aus der Datenbank verantwortlich ist.

Es ist so wichtig, dass das Argument nicht alle Beiträge anzeigt, sondern Bedingungen festlegt, um nur bestimmte Beiträge anzuzeigen.

Beispiel für ein Argument

• Die $args -Zeile : Hier fügen Sie Ihr Abfrageargument ein.
• Struktur : Sie fügen bestimmte Parameter in ein Array ein. Hier ist ein einfaches Beispiel:

$args = array(
'parameter1' => 'value',
'parameter2' => 'value',
'parameter3' => 'value'
);

Spezifisches Beispiel

Wenn Sie Beiträge mit dem Tag „WordPress-Fehler“ anzeigen möchten, richten Sie Ihr Abfrageargument wie folgt ein:

$query = new WP_Query( array( 'tag' => 'WordPress Errors' ) );

Warum das Argument wichtig ist

• Kein Argument, kein Inhalt : Wenn Sie kein WP_Query-Argument angeben, weiß WordPress nicht, welche Beiträge angezeigt werden sollen. Ihre Abfrage ruft keinen Inhalt aus der Datenbank ab.

3. Legen Sie die WP_query-Parameter fest

Parameter machen WP_Query nützlich und leistungsstark. Aufgrund der Vielfalt der verfügbaren Datenbanken ist es für jeden einfacher geworden, die Datenbanksuchen herauszufiltern.

Wenn Sie beispielsweise bestimmte Beiträge auf Ihrer WordPress-Site anzeigen möchten, verwenden Sie WP_Query und um sicherzustellen, dass Sie den richtigen Beitrag erhalten, können Sie Parameter festlegen. Möglicherweise haben Sie eine weitere Frage im Kopf: Was sind die Parameter?

Nun, Parameter sind wie Anweisungen, die WordPress mitteilen, welche Art von Beiträgen aus der Datenbank abgerufen werden sollen.

Beispiele für allgemeine Parameter

Hier sind einige allgemeine Parameter, die Sie verwenden können:

• cat : Zeigt Beiträge aus bestimmten Kategorien an.
• Autor : Zeigt Beiträge eines oder mehrerer bestimmter Autoren an.
• post_status : Zeigt Beiträge an, die gerade bearbeitet, geplant, veröffentlicht oder gelöscht werden.
• orderby : Sortiert Beiträge nach Autor, Beitragstyp, Datum usw.
• posts_per_page : Legt die Anzahl der anzuzeigenden Beiträge fest.
• Tag : Zeigt Beiträge mit bestimmten Tags an.
• order : Sortiert Beiträge in aufsteigender oder absteigender Reihenfolge.
• post_type : Definiert, ob Beiträge, Seiten oder benutzerdefinierte Beitragstypen angezeigt werden.

So verwenden Sie Parameter

Wenn Sie Beiträge aus einer bestimmten Kategorie anzeigen möchten, können Sie den Parameter category_name verwenden. Hier ist ein Beispiel:

$query = new WP_Query( array( 'category_name' => 'WordPress' ) );

Dadurch werden alle Beiträge in der Kategorie „Mitarbeiter“ und allen Unterkategorien angezeigt.

Komplexeres Beispiel

In diesem Beispiel zeigen wir, wie Sie mehrere Werte in verschiedenen Argumenten verwenden können, um eine komplexe und benutzerdefinierte Abfrage zu erstellen, um genau die gewünschten Beiträge abzurufen.

Wir rufen Beiträge ab, die zu bestimmten Kategorien gehören, bestimmte Tags haben, von bestimmten Autoren verfasst wurden und in absteigender Reihenfolge nach Datum sortiert sind.

$args = array(
'category__in' => array(5, 10), // Categories with IDs 5 and 10
'tag__in' => array('featured', 'popular'), // Posts tagged with 'featured' or 'popular'
'author__in' => array(1, 2), // Authors with IDs 1 and 2
'orderby' => 'date', // Order by date
'order' => 'DESC', // In descending order
'posts_per_page' => 10 // Limit to 10 posts
);

$query = new WP_Query($args);

// The Loop
if ($query->have_posts()) {
while ($query->have_posts()) {
$query->the_post();
// Display post content
the_title('<h2>', '</h2>');
the_excerpt();
}
} else {
// No posts found
echo 'No posts found';
}

// Restore original Post Data
wp_reset_postdata();


• Category__in : Hilft bei der Angabe, dass wir Beiträge aus Kategorien mit den IDs 5 und 10 wünschen.
• tag__in : Gibt an, dass Beiträge entweder mit „Featured“ oder „Popular“ getaggt werden sollen.
• author__in : Gibt an, dass wir Beiträge von Autoren mit den IDs 1 und 2 wünschen.
• orderby : Gibt an, dass wir die Beiträge nach dem Datum ihrer Veröffentlichung sortieren möchten.
• order : Gibt an, dass die Beiträge in absteigender Reihenfolge angezeigt werden sollen (neueste zuerst).
• posts_per_page : Begrenzt die Anzahl der abgerufenen Beiträge auf 10.

4. Ändern Sie Objekte mit Methoden und Klasseneigenschaften

In WordPress ist WP_Query eine spezielle PHP-Klasse, die zum Abrufen von Beiträgen aus der Datenbank verwendet wird. Betrachten Sie es als ein Tool, das Ihnen dabei hilft, genau die Beiträge zu erhalten, die Sie auf Ihrer Website anzeigen möchten.

Was sind Klasseneigenschaften und -methoden?

In PHP kann eine Klasse Eigenschaften (wie Variablen) und Methoden (wie Funktionen) haben. Hier ist eine einfache Möglichkeit, sie zu verstehen:

• Eigenschaften : Dies sind wie Behälter, die Informationen enthalten. Im Zusammenhang mit WP_Query können Eigenschaften Dinge wie die Liste der Beiträge oder die Anzahl der gefundenen Beiträge umfassen.
• Methoden : Hierbei handelt es sich um Werkzeuge oder Aktionen, die Sie ausführen können. In WP_Query können Methoden Ihnen dabei helfen, zu überprüfen, ob Beiträge vorhanden sind, den Titel eines Beitrags abzurufen oder die Abfrage zurückzusetzen.

Können Sie Eigenschaften direkt ändern?

Nein, Sie können Eigenschaften nicht direkt ändern, auch Entwickler raten dringend davon ab, aber Sie können alternativ Methoden verwenden.

Methoden sind wie offizielle Werkzeuge oder Befehle, die Ihnen helfen, den richtigen Weg zu gehen. Dies ist genau das, was wie die Funktionen funktioniert. Wenn Sie bestimmte Änderungen an den Methoden von WP_Query vornehmen, können Sie auch die abgerufenen Daten anpassen.

Beispiel für die Verwendung von Methoden in WP_Query

In diesem Beispiel kann eine Funktion „reset_postdata()“ ein entscheidender Schritt beim Schreiben Ihrer WP_Query sein. Diese Methode setzt die Eigenschaften für $current_post und $post zurück.

<?php
// Create a new query with specific arguments
$the_query = new WP_Query(array(
'post_type' => 'post',
'posts_per_page' => 5,
'category_name' => 'news',
));
?>

<?php if ($the_query->have_posts()) : ?>
<!-- Display the posts -->
<?php while ($the_query->have_posts()) : $the_query->the_post(); ?>
<h2><?php the_title(); ?></h2>
<p><?php the_excerpt(); ?></p>
<?php endwhile; ?>
<!-- Reset the post data to avoid conflicts -->
<?php wp_reset_postdata(); ?>
<?php else : ?>
<p><?php _e('Sorry, no posts matched your criteria.'); ?></p>
<?php endif; ?>


Abbauen:

• Erstellen einer Abfrage :
  • $the_query = new WP_Query($args); : Es erstellt ein neues WP_Query Objekt mit den von Ihnen angegebenen Argumenten.
• Nach Beiträgen suchen :
  • if ($the_query->have_posts()) : Es prüft, ob basierend auf Ihrer Anfrage Beiträge angezeigt werden können.
• Durch Beiträge blättern :
  • while ($the_query->have_posts()) : $the_query->the_post(); : Richtet die Beitragsdaten so ein, dass Sie sie anzeigen können.
• Beiträge anzeigen :
  • the_title(); und the_excerpt(); : Zeigt den Titel und den Auszug des aktuellen Beitrags an.
• Beitragsdaten zurücksetzen :
  • wp_reset_postdata(); : Die globalen Beitragsdaten werden auf den Beitrag der Hauptabfrage zurückgesetzt. Dies ist wichtig, um zu vermeiden, dass andere Teile Ihrer Seite durcheinander gebracht werden.

Gängige Methoden, die Sie verwenden können

Hier sind einige gängige Methoden in WP_Query , die Sie zum Arbeiten mit Ihrer Abfrage verwenden können:

• get_posts :
  • Was es tut : Ruft eine Liste von Beiträgen ab.
  • Beispiel : PHPCopy-Code $posts = get_posts(array('category' => 'news'));
• have_posts :
  • Was es tut : Überprüft, ob Beiträge angezeigt werden müssen.
  • Beispiel : phpCode kopieren if ($the_query->have_posts()) { // There are posts to show }
• the_post :
  • Was es tut : Richtet die aktuellen Beitragsdaten ein.
  • Beispiel : phpKopieren Sie den Code $the_query->the_post();
• fill_query_vars :
  • Was es bewirkt : Vervollständigt fehlende Abfragedetails.
  • Beispiel : PHPKopieren Sie den Code $the_query->fill_query_vars($args);

Indem Sie WP_Query mit den richtigen Informationen versorgen, können Sie es anpassen, um verschiedene Aufgaben auszuführen. Diese Methode ist eine flexible und sichere Möglichkeit, die Klasseneigenschaften anzupassen.

WP_Query Vs query_posts(): Welches ist vorzuziehen?

Nachfolgend finden Sie eine detaillierte Vergleichstabelle von WP_Query vs. query_posts() in WordPress, einschließlich einiger der wichtigsten Punkte, die Ihnen helfen können zu verstehen, warum WP_Query im Allgemeinen gegenüber query_posts() bevorzugt wird:

Einige Beispiele für die Verwendung von WP_Query

Um WP_Query und seine praktische Verwendung besser zu verstehen, sehen Sie sich einige der unten aufgeführten Beispiele an:

1. Zeigen Sie die neuesten Beiträge an, die diese Woche veröffentlicht wurden

Wenn Sie über eine gute Nutzerbasis oder eine anständige Menge an Web-Traffic verfügen, bedeutet das, dass Ihren Besuchern Ihre Inhalte gefallen und sie die neuesten auf Ihrer Website veröffentlichten Artikel lesen möchten.

Während Sie Ihre Website entwerfen, können Sie aktuelle Beiträge in einem speziellen Bereich der Webseite präsentieren. Glücklicherweise können Sie mit WP_Query ganz einfach Beiträge anhand von Datumsparametern finden. Mal sehen, wie.

<?php
$arguments = array(
"date_query" => array(
array(
"year" => date( "Y" ),
"week" => date( "W" ),
)
)
);
$posts = new WP_Query($arguments);
?>


In diesem Beispiel erstellen wir eine WP_Query, um in der aktuellen Woche veröffentlichte Beiträge zu finden. Wir verwenden einen speziellen Teil von WP_Query namens date_query , um unsere Suchkriterien anzugeben.

Der Hauptzweck der Abfrage bestand darin, Beiträge zu finden, die in der aktuellen Woche veröffentlicht wurden. Und dafür haben wir den Parameter date_query verwendet, um nach Beiträgen basierend auf Datumsangaben zu suchen. Es benötigt eine Reihe datumsbezogener Argumente.

Wenn Sie also den Parameter date_query anpassen, können Sie Beiträge abrufen und anzeigen, die kürzlich veröffentlicht wurden. Sie können jedoch auch benutzerdefinierte Werte angeben, um die Abfrage effektiver zu gestalten und die neuesten Artikel der letzten Woche hervorzuheben.

2. Zeigen Sie den neuesten Beitrag in einer bestimmten Kategorie an

Ihre Website-Besucher suchen möglicherweise häufig nach den neuesten Informationen. Um das Engagement und die Seitenaufrufe zu steigern, empfiehlt es sich, einige weitere verwandte Beiträge vorzuschlagen, die ihnen gefallen könnten.

Obwohl es viele Möglichkeiten gibt, verwandte Beiträge in WordPress zu verlinken, ist WP_Query eine der effizientesten Möglichkeiten, dies zu tun. Besonders eine tolle Möglichkeit für die Website, immer aktuelle Inhalte zu veröffentlichen.

Wenn jemand beispielsweise einen Artikel über WordPress-Fehler liest, kann WP_Query dabei helfen, andere ähnliche und aktuelle Artikel anzuzeigen.

Wenn Sie also die neuesten Beiträge in einer bestimmten Kategorie abrufen möchten, verwenden Sie diese WP_query und nehmen Sie kleine Änderungen vor, die Ihre Site-Informationen umfassen:

<?php

// Get the current post id.
$current_post_id = get_the_ID();

// Get the current post's category (first one if there's more than one).
$current_post_cats = get_the_category();
$current_post_first_cat_id = $current_post_cats[ 0 ]->term_id;

// Setup arguments.
$args = array(
// Get category's posts.
'cat' => $current_post_first_cat_id,
// Exclude current post.
'post__not_in' => array( $current_post_id )
);

// Instantiate new query instance.
$my_query = new WP_Query( $args );

?>

3. Zeigen Sie die Beiträge desselben Autors und in derselben Kategorie an

Wenn dem Besucher Ihre Inhalte gefallen, ist es sehr wahrscheinlich, dass ihm die Ansichten, der Schreibstil und die Wahrnehmung des Autors gefallen.

Zu diesem Zweck können Sie WP_Query verwenden, um Ihren Lesern ähnliche Beiträge desselben Autors vorzuschlagen. Die Abfrage sucht nach Beiträgen desselben Autors für dieselbe Kategorie wie der aktuelle Beitrag.

Dazu müssen wir einen speziellen WP_Query-String erstellen, der nach Beiträgen mit ähnlichen Autoren und derselben Kategorie Ausschau hält.

Hier ist der Code:

<?php
$arguments = array(
"author_name" => "Rahul",
"category_name" => "WordPress",
"posts_per_page" => 3,
);
$posts = new WP_Query($arguments);
?>


Im obigen Code müssen Sie „Rahul“ durch den Namen des Autors und „WordPress“ durch den Kategorienamen ersetzen.

4. Zeigen Sie Ihre beliebtesten Beiträge an

Genau wie die neuesten oder aktuellsten Beiträge, die Sie Ihren Lesern angezeigt haben. Vielleicht möchten Sie auch Beiträge zu Themen zeigen, die Ihren Lesern gefallen und die sie besonders interessieren. Um dies zu erreichen, können Sie den Parameter orderby verwenden und ihn an das Argument comment_count übergeben.

<?php
$arguments = array(
"category_name" => "WordPress Errors",
"orderby" => "comment_count",
"posts_per_page" => 5,
);
$posts = new WP_Query($arguments);
?>

Die obige WP_Query sucht nach Beiträgen in der Kategorie „WordPress-Fehler“ und filtert die Ergebnisse nach der Anzahl der Kommentare, die jeder Beitrag hat.

Die Ausgabe zeigt fünf Beiträge mit den meisten Kommentaren in absteigender Reihenfolge von links nach rechts an, beginnend mit dem Beitrag mit dem höchsten Engagement und endend mit dem niedrigsten.

Abschluss

Jetzt haben Sie gesehen, wie leistungsstark WP_Query ist und wie es Ihnen die Durchführung von Datenbankanfragen in WordPress erleichtert. Bieten Sie außerdem die Flexibilität, Ihre Website individuell anzupassen und den Besuchern ein einzigartiges Erlebnis zu bieten.

Um WP_Query zu verwenden, können Sie:

• Erstellen Sie eine Schleife: Zeigen Sie Ihre Beiträge an.
• Verwenden Sie Abfrageargumente: Passen Sie Ihre Suchen an.
• Spezifische Parameter festlegen: Filtern Sie Ihre Ergebnisse.
• Klasseneigenschaften ändern: Abfrageergebnisse mit Methoden anpassen.

Wenn Sie alle diese Techniken beherrschen, können Sie bestimmte Beiträge basierend auf verschiedenen Faktoren wie Beliebtheit und Datum problemlos empfehlen.

Diese Technik trägt dazu bei, das Engagement des Benutzers zu steigern, das Benutzererlebnis zu verbessern und Ihren treuen Besuchern dabei zu helfen, relevantere Inhalte zu finden.

Wenn Sie immer noch Zweifel an WP_Query haben oder weitere Inhalte hinzufügen möchten, die wir möglicherweise übersehen haben. Bitte lassen Sie es uns im Kommentarbereich unten wissen.

Rahul

Rahul Kumar ist ein Web-Enthusiast und Content-Stratege, der sich auf WordPress und Webhosting spezialisiert hat. Mit jahrelanger Erfahrung und seinem Engagement, über Branchentrends auf dem Laufenden zu bleiben, entwickelt er effektive Online-Strategien, die den Traffic steigern, das Engagement steigern und die Conversions steigern. Rahuls Liebe zum Detail und seine Fähigkeit, überzeugende Inhalte zu erstellen, machen ihn zu einer wertvollen Bereicherung für jede Marke, die ihre Online-Präsenz verbessern möchte.