wp_get_referer()

Retrieve referer from ‘_wp_http_referer’ or HTTP referer.

Description

If it’s the same as the current request URL, will return false.

Return

(false|string) False on failure. Referer URL on success.

Source

File: wp-includes/functions.php 

function wp_get_referer() {
	if ( ! function_exists( 'wp_validate_redirect' ) ) {
		return false;
	}

	$ref = wp_get_raw_referer();

	if ( $ref && $ref !== wp_unslash( $_SERVER['REQUEST_URI'] ) && $ref !== home_url() . wp_unslash( $_SERVER['REQUEST_URI'] ) ) {
		return wp_validate_redirect( $ref, false );
	}

	return false;
}

Expand Source Code View on GitHub

Related

Uses

Uses
Uses Description
wp-includes/pluggable.php: wp_validate_redirect()

Validates a URL for use in a redirect.
wp-includes/link-template.php: home_url()

Retrieves the URL for the current site where the front end is accessible.
wp-includes/formatting.php: wp_unslash()

Remove slashes from a string or array of strings.
wp-includes/functions.php: wp_get_raw_referer()

Retrieves unvalidated referer from ‘_wp_http_referer’ or HTTP referer.

Used By

Used By
Used By Description
wp-includes/pluggable.php: auth_redirect()

Checks if a user is logged in, if not it redirects them to the login page.
wp-includes/pluggable.php: check_admin_referer()

Makes sure that a user was referred from another admin page.
wp-includes/class-wp-customize-manager.php: WP_Customize_Manager::get_return_url()

Get URL to link the user to when closing the Customizer.
wp-includes/functions.php: wp_nonce_ays()

Display “Are You Sure” message to confirm the action being taken.
wp-includes/functions.php: wp_original_referer_field()

Retrieve or display original referer hidden field for forms.
wp-admin/includes/misc.php: set_screen_options()

Saves option for number of rows when listing posts, pages, comments, etc.
wp-admin/includes/media.php: wp_media_attach_action()

Encapsulate logic for Attach/Detach actions
wp-admin/includes/post.php: redirect_post()

Redirect to previous page.
wp-admin/includes/post.php: _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.
wp-admin/includes/class-wp-terms-list-table.php: WP_Terms_List_Table::column_name()
wp-admin/includes/class-wp-terms-list-table.php: WP_Terms_List_Table::handle_row_actions()

Generates and displays row action links.
Show 6 more used by Hide more used by

Changelog

Changelog
Version Description
WP-2.0.4 Introduced.