云策 WordPress 开发者社区

钩子文档

register_url

查看官方原文 ↗
💡 云策文档标注

概述

register_url 是一个 WordPress 过滤器，用于修改用户注册 URL。它允许开发者自定义 wp_registration_url() 函数返回的注册链接，例如重定向到自定义注册页面。

关键要点

  • register_url 过滤器应用于 wp_registration_url() 函数返回的 URL。
  • 默认 URL 由 site_url('wp-login.php?action=register', 'login') 生成。
  • 通过 add_filter 可以修改此 URL，实现自定义注册页面。

代码示例

add_filter( 'register_url', 'change_my_register_url' );
function change_my_register_url( $url ) {
    if( is_admin() ) {
        return $url;
    }
    return "/custom-register-url/";
}

注意事项

  • 在修改 URL 时，建议检查 is_admin() 以避免影响后台功能。
  • 此过滤器自 WordPress 3.6.0 版本引入。
📄 原文内容

Filters the user registration URL.

Parameters

$registerstring
The user registration URL.

More Information

register_url is a filter applied to the URL returned by the function wp_registration_url() which allows you to have that function direct users to a specific (different) URL for registration.

The URL that is passed to this filter is generated by site_url()  using the ‘login’ $scheme:

site_url( 'wp-login.php?action=register', 'login' )

Source

return apply_filters( 'register_url', site_url( 'wp-login.php?action=register', 'login' ) );

View all references View on Trac View on GitHub

Used by Description
wp_registration_url()wp-includes/general-template.php

Returns the URL that allows the user to register on the site.

Changelog

Version Description
3.6.0 Introduced.

User Contributed Notes

  1. Skip to note 2 content


    Abdul Wahab


    You must log in to vote on the helpfulness of this noteVote results for this note: 4You must log in to vote on the helpfulness of this note

    Do you want to use a custom registration page? Modify the registration page URL using register_url.
    Update the link with your actual registration page URL.

    add_filter( 'register_url', 'change_my_register_url' );
function change_my_register_url( $url ) {
    if( is_admin() ) {
        return $url;
    }
    return "/custom-register-url/";
}