
面向WordPress用户的MAMP Pro终极指南
wp_set_auth_cookie ( $user_id, $remember = false, $secure = '', $token = '' )
wp_set_auth_cookie: 这是一个WordPress的函数,用来为用户设置一个认证cookie。它允许你设置一个cookie,当用户返回网站时可以用来验证他们的身份。
根据用户ID来设置认证cookie。
$remember参数增加了cookie的保存时间。默认情况下,不记名的cookie保存时间为两天: 当$remember被设置后,cookie将被保存14天或两周。
function wp_set_auth_cookie( $user_id, $remember = false, $secure = '', $token = '' ) { if ( $remember ) { /** * Filters the duration of the authentication cookie expiration period. * * @since 2.8.0 * * @param int $length Duration of the expiration period in seconds. * @param int $user_id User ID. * @param bool $remember Whether to remember the user login. Default false. */ $expiration = time() + apply_filters( 'auth_cookie_expiration', 14 * DAY_IN_SECONDS, $user_id, $remember ); /* * Ensure the browser will continue to send the cookie after the expiration time is reached. * Needed for the login grace period in wp_validate_auth_cookie(). */ $expire = $expiration + ( 12 * HOUR_IN_SECONDS ); } else { /** This filter is documented in wp-includes/pluggable.php */ $expiration = time() + apply_filters( 'auth_cookie_expiration', 2 * DAY_IN_SECONDS, $user_id, $remember ); $expire = 0; } if ( '' === $secure ) { $secure = is_ssl(); } // Front-end cookie is secure when the auth cookie is secure and the site's home URL uses HTTPS. $secure_logged_in_cookie = $secure && 'https' === parse_url( get_option( 'home' ), PHP_URL_SCHEME ); /** * Filters whether the auth cookie should only be sent over HTTPS. * * @since 3.1.0 * * @param bool $secure Whether the cookie should only be sent over HTTPS. * @param int $user_id User ID. */ $secure = apply_filters( 'secure_auth_cookie', $secure, $user_id ); /** * Filters whether the logged in cookie should only be sent over HTTPS. * * @since 3.1.0 * * @param bool $secure_logged_in_cookie Whether the logged in cookie should only be sent over HTTPS. * @param int $user_id User ID. * @param bool $secure Whether the auth cookie should only be sent over HTTPS. */ $secure_logged_in_cookie = apply_filters( 'secure_logged_in_cookie', $secure_logged_in_cookie, $user_id, $secure ); if ( $secure ) { $auth_cookie_name = SECURE_AUTH_COOKIE; $scheme = 'secure_auth'; } else { $auth_cookie_name = AUTH_COOKIE; $scheme = 'auth'; } if ( '' === $token ) { $manager = WP_Session_Tokens::get_instance( $user_id ); $token = $manager->create( $expiration ); } $auth_cookie = wp_generate_auth_cookie( $user_id, $expiration, $scheme, $token ); $logged_in_cookie = wp_generate_auth_cookie( $user_id, $expiration, 'logged_in', $token ); /** * Fires immediately before the authentication cookie is set. * * @since 2.5.0 * @since 4.9.0 The `$token` parameter was added. * * @param string $auth_cookie Authentication cookie value. * @param int $expire The time the login grace period expires as a UNIX timestamp. * Default is 12 hours past the cookie's expiration time. * @param int $expiration The time when the authentication cookie expires as a UNIX timestamp. * Default is 14 days from now. * @param int $user_id User ID. * @param string $scheme Authentication scheme. Values include 'auth' or 'secure_auth'. * @param string $token User's session token to use for this cookie. */ do_action( 'set_auth_cookie', $auth_cookie, $expire, $expiration, $user_id, $scheme, $token ); /** * Fires immediately before the logged-in authentication cookie is set. * * @since 2.6.0 * @since 4.9.0 The `$token` parameter was added. * * @param string $logged_in_cookie The logged-in cookie value. * @param int $expire The time the login grace period expires as a UNIX timestamp. * Default is 12 hours past the cookie's expiration time. * @param int $expiration The time when the logged-in authentication cookie expires as a UNIX timestamp. * Default is 14 days from now. * @param int $user_id User ID. * @param string $scheme Authentication scheme. Default 'logged_in'. * @param string $token User's session token to use for this cookie. */ do_action( 'set_logged_in_cookie', $logged_in_cookie, $expire, $expiration, $user_id, 'logged_in', $token ); /** * Allows preventing auth cookies from actually being sent to the client. * * @since 4.7.4 * * @param bool $send Whether to send auth cookies to the client. */ if ( ! apply_filters( 'send_auth_cookies', true ) ) { return; } setcookie( $auth_cookie_name, $auth_cookie, $expire, PLUGINS_COOKIE_PATH, COOKIE_DOMAIN, $secure, true ); setcookie( $auth_cookie_name, $auth_cookie, $expire, ADMIN_COOKIE_PATH, COOKIE_DOMAIN, $secure, true ); setcookie( LOGGED_IN_COOKIE, $logged_in_cookie, $expire, COOKIEPATH, COOKIE_DOMAIN, $secure_logged_in_cookie, true ); if ( COOKIEPATH != SITECOOKIEPATH ) { setcookie( LOGGED_IN_COOKIE, $logged_in_cookie, $expire, SITECOOKIEPATH, COOKIE_DOMAIN, $secure_logged_in_cookie, true ); } } endif; if ( ! function_exists( 'wp_clear_auth_cookie' ) ) : /** * Removes all of the cookies associated with authentication. * * @since 2.5.0 */
在WordPress中,你可以使用 add_action
函数添加一个钩子函数。钩子函数是在特定事件发生时自动触发的函数。
add_action
函数的第一个参数是钩子名称,第二个参数是要执行的函数名,第三个参数是函数的优先级(可选)。
例如,添加一个在文章保存后执行的钩子函数的代码如下:
function my_save_post_function( $post_ID, $post ) { // 执行你的代码 } add_action( 'save_post', 'my_save_post_function', 10, 2 );
这里, save_post
是钩子名称, my_save_post_function
是要执行的函数名,10是函数的优先级,2是传递给钩子函数的参数数量。
wp_reset_query()
函数用于重置WordPress的查询。在自定义查询或修改查询参数之后,你可能需要使用这个函数来重置到默认的查询。例如:
// 自定义查询 $args = array( 'post_type' => 'product', 'posts_per_page' => 10, ); $custom_query = new WP_Query($args); // 重置查询 wp_reset_query();
创建自定义的WordPress插件需要以下步骤:
使用 get_post
和 get_page
获取单个文章或页面的详细信息:
// 获取文章或页面的ID $post_id = get_the_ID(); // 获取文章或页面的详细信息 $post = get_post($post_id); // 获取文章或页面的标题 $title = $post->post_title; // 获取文章或页面的内容 $content = $post->post_content;
wp_enqueue_script
和 wp_enqueue_style
函数的使用:
wp_enqueue_script()
:此函数位于wp-includes/script-loader.php文件中。它会将JavaScript文件添加到WordPress网站的页脚中。您可以在主题的functions.php文件中调用此函数,以添加自定义的JavaScript文件。wp_enqueue_style()
:此函数位于wp-includes/script-loader.php文件中。它会将CSS文件添加到WordPress网站的部分中。您可以在主题的functions.php文件中调用此函数,以添加自定义的CSS文件。使用 wp_head
和 wp_footer
在主题中添加自定义内容:
wp_head()
:此函数位于wp-includes/general-template.php文件中。它会在文档的部分中输出内容。您可以在主题的header.php文件中调用此函数,以在部分中添加自定义内容。wp_footer()
:此函数位于wp-includes/general-template.php文件中。它会在文档的部分中输出内容。您可以在主题的footer.php文件中调用此函数,以在部分中添加自定义内容。