Percorso personalizzato per plugin in WordPress

Devi fare tre cose importanti:

1. Creare una regola di riscrittura personalizzata per trasformare parti dell'URI in valori passati a index.php.
2. Aggiungere myroute e myargument alla whitelist delle variabili di query di WordPress, in modo che WordPress non le ignori quando compaiono in una stringa di query.
3. Svuotare le regole di riscrittura (flush rewrite rules).

Innanzitutto, ti consiglio di usare un prefisso o suffisso speciale per indicare quando l'URI deve essere considerato una di queste "route" speciali, anziché usare semplicemente http://www.example.org/myroute/myargument. Per questo esempio, ho scelto il prefisso api, quindi sarà http://www.example.org/api/myroute/myargument. Ho scelto api perché quando ho implementato qualcosa di RESTful, come sembra tu stia facendo, era per un'API.

Il Codice

add_filter( 'rewrite_rules_array', 'my_insert_rewrite_rules' );
add_filter( 'query_vars', 'my_insert_query_vars' );
add_action( 'wp_loaded', 'my_flush_rules' );

// flush_rules() se le nostre regole non sono ancora incluse
function my_flush_rules() {
    $rules = get_option( 'rewrite_rules' );

    if ( ! isset( $rules['api/(.*?)/(.+?)'] ) ) {
        global $wp_rewrite;
        $wp_rewrite->flush_rules();
    }
}

// Aggiunta di una nuova regola
function my_insert_rewrite_rules( $rules ) {
    $newrules = array();
    $newrules['api/(.*?)/(.+?)'] = 'index.php?myroute=$matches[1]&myargument=$matches[2]';
    return $newrules + $rules;
}

// Aggiunta della variabile id in modo che WP la riconosca
function my_insert_query_vars( $vars ) {
    array_push( $vars, 'myroute', 'myargument' );
    return $vars;
}

Spiegazione rapida

È tutto abbastanza semplice. Il pattern regex viene aggiunto a un elenco di tutte le regole di riscrittura in WordPress, e il tuo pattern personalizzato si trova in cima alla lista. Quando il pattern corrisponde, WordPress smetterà di scorrere l'elenco delle regole di riscrittura e utilizzerà i valori catturati dalla regex al posto dei riferimenti ($matches[1] e $matches[2]) nella stringa di query passata a index.php.

Aggiungere le variabili di query myroute e myargument alla whitelist fa sì che WordPress le consideri anziché scartarle.

Modo alternativo per "namespacing" della tua route personalizzata

Se vuoi evitare di usare /api/ come prefisso, puoi usare invece una variabile/campo nella query string. Per fare ciò, dovresti cambiare la regex in qualcosa come (.*?)/(.+?)\\?api=1 e poi aggiungere api come parametro aggiuntivo nella chiamata array_push() fatta in my_insert_query_vars().

Questo modificherebbe la route personalizzata in modo che venga attivata ogni volta che api=1 è il primo elemento della query string, ad esempio verrebbe attivata per http://example.com/anytext/anytext?api=1.

Ignora l'uso del termine "namespacing" – l'ho usato solo per brevità.

Se non usi un prefisso o un suffisso per identificare la tua route, finirai con pattern di URI in conflitto. Questo perché WordPress non avrà modo di distinguere il tuo pattern personalizzato da uno destinato a un post o una pagina. Come farebbe WordPress a sapere che myroute non è una tassonomia, un termine o una pagina genitore?

Spero che questo ti sia utile.