add_query_arg函数是WordPress中的一个常用函数,用于向当前URL添加或替换查询参数。它的详细用法如下:

1. 添加查询参数:
add_query_arg( $param1, $value, $url );

参数说明:
- $param1:要添加的查询参数的名称。
- $value:要添加的查询参数的值。
- $url(可选):要添加查询参数的URL,默认为当前URL。

示例:

$new_url = add_query_arg( 'param1', 'value1' );

这个例子中,add_query_arg函数将会在当前URL中添加一个查询参数param1,并设置其值为value1。返回的$new_url就是添加了查询参数的新URL。

2. 替换查询参数:
add_query_arg( $params, $url );

参数说明:
- $params:要替换的查询参数数组,格式为array( 'param1' => 'value1', 'param2' => 'value2' )。
- $url(可选):要替换查询参数的URL,默认为当前URL。

示例:

$new_url = add_query_arg( array( 'param1' => 'new_value1', 'param2' => 'new_value2' ) );

这个例子中,add_query_arg函数将会在当前URL中替换查询参数param1和param2的值为new_value1和new_value2。返回的$new_url就是替换了查询参数的新URL。

3. 获取当前URL的查询参数:
add_query_arg函数也可以用于获取当前URL的查询参数。

示例:

$params = add_query_arg();

这个例子中,add_query_arg函数将会返回当前URL的查询参数数组。

总结:
add_query_arg函数可以方便地向URL添加或替换查询参数,非常实用。在开发WordPress主题或插件时,经常会用到该函数来处理URL。