PHP-Funktion add_rewrite_var(): Alles, was Sie wissen müssen

Als WordPress-Entwickler müssen Sie möglicherweise eine benutzerdefinierte Query-Variable für die Verwendung mit Rewrite-Regeln registrieren. Die Funktion add_rewrite_var() ist eine WordPress-API-Funktion, mit der Sie eine neue Query-Variable zur Liste der erkannten Rewrite-Query-Variablen hinzufügen können. In diesem Artikel werfen wir einen detaillierten Blick auf die Funktion add_rewrite_var() und ihre Verwendung.

Was ist die add_rewrite_var() Funktion?

Die Funktion add_rewrite_var() ist eine WordPress-Funktion, die eine benutzerdefinierte Query-Variable registriert. Dadurch wird die Variable für die Verwendung in WordPress-Rewrite-Regeln und der Query-Parserstellung verfügbar gemacht.

Verwendung der add_rewrite_var() Funktion

Die Verwendung der Funktion add_rewrite_var() ist unkompliziert. Sie akzeptiert einen einzelnen Parameter: den Namen der Query-Variable. Hier ist die Syntax:

Syntax

add_rewrite_var( string $name ): void

Da WordPress Funktionen früh im Anforderungslebenszyklus lädt, rufen Sie diese Funktion normalerweise innerhalb eines Callbacks auf, das an die init-Aktion gebunden ist. Hier ist ein korrektes Verwendungsbeispiel:

Beispiel

function my_custom_query_var() {
    add_rewrite_var( 'my_custom_var' );
}
add_action( 'init', 'my_custom_query_var' );

In diesem Beispiel registrieren wir eine neue Query-Variable mit dem Namen my_custom_var. Sobald sie registriert ist, können Sie ihren Wert in Ihrem Theme oder Plugin über get_query_var( 'my_custom_var' ) abrufen.

Fazit

Die Funktion add_rewrite_var() ist ein nützliches WordPress-Tool zum Registrieren benutzerdefinierter Query-Variablen für Rewrite-Regeln. Durch das Verständnis der Ein-Parameter-Syntax und der korrekten Hook-Verwendung können Sie die WordPress-Query-Parserstellung ganz einfach erweitern. Wir hoffen, dass dieser Artikel informativ und hilfreich war, um die Funktion add_rewrite_var() zu verstehen.

Praxis

Was macht die Funktion add_rewrite_var() in PHP?

Es fügt eine URL-Query-Variable zum globalen Array der Rewrite-Query-Variablen hinzu.Es löscht eine URL-Query-Variable aus dem globalen Array der Rewrite-Query-Variablen.Es ermöglicht das Übergeben zusätzlicher Query-Variablen über die URL.Es blockiert zusätzliche Query-Variablen von der URL.