wp_get_referer(): string|false

Description

Return

string|false

Referer URL on success, false on failure.

Uses · 4

• wp_get_raw_referer()Retrieves unvalidated referer from the '_wp_http_referer' URL query variable or the HTTP referer.
• wp_unslash()Removes slashes from a string or recursively removes slashes from strings within an array.
• home_url()Retrieves the URL for the current site where the front end is accessible.
• wp_validate_redirect()Validates a URL for use in a redirect.

Used by · 13

• WP_Customize_Manager::get_return_url()Gets URL to link the user to when closing the Customizer.
• WP_Recovery_Mode::handle_exit_recovery_mode()Handles a request to exit Recovery Mode.
• WP_Terms_List_Table::column_name()
• WP_Terms_List_Table::handle_row_actions()Generates and displays row action links.
• _admin_notice_post_locked()Outputs the HTML for the notice to say that someone else is editing or has taken over editing of this post.
• auth_redirect()Checks if a user is logged in, if not it redirects them to the login page.
• check_admin_referer()Ensures intent by verifying that a user was referred from another admin page with the correct security nonce.
• redirect_post()Redirects to previous page.
• set_screen_options()Saves option for number of rows when listing posts, pages, comments, etc.
• the_block_editor_meta_box_post_form_hidden_fields()Renders the hidden form required for the meta boxes form.
• wp_media_attach_action()Encapsulates the logic for Attach/Detach actions.
• wp_nonce_ays()Displays "Are You Sure" message to confirm the action being taken.

Source

View on Trac ↗View on GitHub ↗

1975function wp_get_referer() {1976	// Return early if called before wp_validate_redirect() is defined.1977	if ( ! function_exists( 'wp_validate_redirect' ) ) {1978		return false;1979	}1980 1981	$ref = wp_get_raw_referer();1982 1983	if ( $ref && wp_unslash( $_SERVER['REQUEST_URI'] ) !== $ref1984		&& home_url() . wp_unslash( $_SERVER['REQUEST_URI'] ) !== $ref1985	) {1986		return wp_validate_redirect( $ref, false );1987	}1988 1989	return false;1990}

History

Introduced in 2.0.4. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.9.7 tag, from src/wp-includes/functions.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.