wp_register() — описание функции WordPress на русском

Сигнатура

wp_register( string $before = '<li>', string $after = '</li>', bool $display = true ): void|string

Описание

Отображает ссылку, позволяющую пользователю перейти на страницу регистрации, если он не вошёл в систему и регистрация включена, или в консоль, если вход выполнен.

Оригинал (английский)

Display a link which allows the user to navigate to the registration page if not logged in and registration is enabled or to the dashboard if logged in.

Параметры

$before string необязательный = '<li>'

Текст для вывода перед ссылкой. Значение по умолчанию

.

$after string необязательный = '</li>'

Текст для вывода после ссылки. Значение по умолчанию .

$display bool необязательный = true

По умолчанию ссылка выводится, а не возвращается.

Возвращаемое значение

void|string

$display $display

Исходный код

wp-includes/general-template.php:705

function wp_register( $before = '<li>', $after = '</li>', $display = true ) {
	if ( ! is_user_logged_in() ) {
		if ( get_option( 'users_can_register' ) ) {
			$link = $before . '<a href="' . esc_url( wp_registration_url() ) . '">' . __( 'Register' ) . '</a>' . $after;
		} else {
			$link = '';
		}
	} elseif ( current_user_can( 'read' ) ) {
		$link = $before . '<a href="' . admin_url() . '">' . __( 'Site Admin' ) . '</a>' . $after;
	} else {
		$link = '';
	}

	/**
	 * Filters the HTML link to the Registration or Admin page.
	 *
	 * Users are sent to the admin page if logged-in, or the registration page
	 * if enabled and logged-out.
	 *
	 * @since 1.5.0
	 *
	 * @param string $link The HTML code for the link to the Registration or Admin page.
	 */
	$link = apply_filters( 'register', $link );

	if ( $display ) {
		echo $link;
	} else {
		return $link;
	}
}

История изменений

Версия	Описание
1.5.0	Introduced.