Wordpress add_rewrite_endpoint ()

Agregue un punto final, como / trackback /.

Descripción

Agregar un punto final crea reglas de reescritura adicionales para cada uno de los lugares coincidentes especificados por la máscara de bits proporcionada. Por ejemplo:

add_rewrite_endpoint( 'json', EP_PERMALINK | EP_PAGES );

agregará una nueva regla de reescritura que termina con “json (/(.*))?/?$” para cada permastruct que describa un enlace permanente (publicación) o página. Esto se reescribe a “json = $ match” donde $ match es la parte de la URL que coincide con la expresión regular del punto final (por ejemplo, “foo” en “[permalink]/ json / foo / “).

También se creará una nueva variable de consulta con el mismo nombre que el punto final.

Al especificar $ places, asegúrese de que está usando las constantes EP_ * (o una combinación de ellas usando el operador OR bit a bit) ya que no se garantiza que sus valores permanezcan estáticos (especialmente EP_ALL).

Asegúrese de eliminar las reglas de reescritura, consulte flush_rewrite_rules (), cuando su complemento se active y desactive.

Parámetros

$ nombre

(cuerda) (Requerido) Nombre del punto final.

$ lugares

(En t) (Requerido) Máscara de punto final que describe los lugares donde se debe agregar el punto final. Acepta una máscara de:

• EP_ALL
• EP_NONE
• EP_ALL_ARCHIVES
• EP_ATTACHMENT
• EP_AUTHORS
• EP_CATEGORIES
• EP_COMMENTS
• EP_DATE
• EP_DAY
• EP_MONTH
• EP_PAGES
• EP_PERMALINK
• EP_ROOT
• EP_SEARCH
• EP_TAGS
• EP_YEAR

$ query_var

(cuerda|bool) (Opcional) Nombre de la variable de consulta correspondiente. Aprobar false para omitir el registro de query_var para este punto final. Predeterminado al valor de $name.

Valor predeterminado: verdadero

Más información

Esto agrega el punto final a todos los tipos de enlaces indicados (por ejemplo, publicaciones, páginas, categoría, autor, búsqueda) y luego template-loader.php incluye el archivo controlador relevante.

El nombre del punto final se agrega como variable de consulta y esto obtiene como valor cualquier texto presente después del nombre del punto final, separado del nombre con una ‘/’. los template_redirect action hook debería probar esta variable de consulta.

Esto se puede usar para todo tipo de cosas:

• controlador ajax
• controlador de envío de formularios
• manejador de notificaciones alternativo

Fuente

Archivo: wp-includes / rewrite.php

function add_rewrite_endpoint( $name, $places, $query_var = true ) {
	global $wp_rewrite;
	$wp_rewrite->add_endpoint( $name, $places, $query_var );
}

Relacionado

Usos

Registro de cambios