Ruta personalizada de plugin en WordPress

Necesitas hacer tres cosas importantes:

1. Crear una regla de reescritura personalizada para convertir partes del URI en valores pasados a index.php.
2. Añadir myroute y myargument a la lista blanca de variables de consulta de WordPress, para que WordPress no las ignore cuando aparezcan en una cadena de consulta.
3. Vaciar las reglas de reescritura.

En primer lugar, voy a recomendar que en lugar de http://www.example.org/myroute/myargument, utilices algún tipo de prefijo o sufijo especial para denotar cuándo el URI debe considerarse una de estas "rutas" especiales. Para este ejemplo, he elegido el prefijo api, por lo que sería http://www.example.org/api/myroute/myargument. Elegí api porque cuando hice algo RESTful, como lo que pareces estar trabajando, era para una API.

El Código

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() si nuestras reglas aún no están incluidas
function my_flush_rules() {
    $rules = get_option( 'rewrite_rules' );

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

// Añadiendo una nueva regla
function my_insert_rewrite_rules( $rules ) {
    $newrules = array();
    $newrules['api/(.*?)/(.+?)'] = 'index.php?myroute=$matches[1]&myargument=$matches[2]';
    return $newrules + $rules;
}

// Añadiendo la variable id para que WordPress la reconozca
function my_insert_query_vars( $vars ) {
    array_push( $vars, 'myroute', 'myargument' );
    return $vars;
}

Desglose rápido

Es bastante sencillo. El patrón regex se añade a una lista de todas las reglas de reescritura en WordPress, y tu patrón personalizado está en la parte superior de la lista. Cuando el patrón coincide, WordPress dejará de buscar en la lista de reglas de reescritura y usará los valores capturados por el regex en lugar de las referencias ($matches[1] y $matches[2]) en la cadena de consulta pasada a index.php.

Añadir las variables de consulta myroute y myargument a la lista blanca hace que WordPress les preste atención en lugar de descartarlas.

Forma alternativa de 'agrupar' tu ruta personalizada

Si quisieras evitar usar /api/ como prefijo, podrías usar una variable/campo de cadena de consulta en su lugar. Para hacer algo así, cambiarías el regex a algo como (.*?)/(.+?)\\?api=1 y luego añadirías api como un parámetro adicional a la llamada array_push() hecha en my_insert_query_vars().

Eso cambiaría la ruta personalizada para que se active cada vez que api=1 sea el primer elemento de la cadena de consulta, por ejemplo, se activaría para http://example.com/anytext/anytext?api=1.

Ignora el uso del término 'agrupar' - solo lo usé por brevedad.

Si no 'agrupas' con un prefijo o un sufijo, terminarás con patrones de URI que colisionan. Esto se debe a que WordPress no tendrá forma de distinguir tu patrón personalizado de uno destinado a ser una entrada o página. ¿Cómo sabría WordPress que myroute no es una taxonomía, término o una página padre?

Espero que esto ayude.