get_privacy_policy_url(): string

Retrieves the URL to the privacy policy page.

Contents

Return
Source
Hooks
Related
- Uses
- Used By
Changelog
User Contributed Notes

Return

string The URL to the privacy policy page. Empty string if it doesn't exist.

Source

File: wp-includes/link-template.php. View all references

function get_privacy_policy_url() {
	$url            = '';
	$policy_page_id = (int) get_option( 'wp_page_for_privacy_policy' );

	if ( ! empty( $policy_page_id ) && get_post_status( $policy_page_id ) === 'publish' ) {
		$url = (string) get_permalink( $policy_page_id );
	}

	/**
	 * Filters the URL of the privacy policy page.
	 *
	 * @since 4.9.6
	 *
	 * @param string $url            The URL to the privacy policy page. Empty string
	 *                               if it doesn't exist.
	 * @param int    $policy_page_id The ID of privacy policy page.
	 */
	return apply_filters( 'privacy_policy_url', $url, $policy_page_id );
}

View on Trac View on GitHub

Hooks

apply_filters( 'privacy_policy_url', string $url, int $policy_page_id )

Filters the URL of the privacy policy page.

Uses

Uses
Uses	Description
get_post_status() wp-includes/post.php	Retrieves the post status based on the post ID.
get_permalink() wp-includes/link-template.php	Retrieves the full permalink for the current post or post ID.
apply_filters() wp-includes/plugin.php	Calls the callback functions that have been added to a filter hook.
get_option() wp-includes/option.php	Retrieves an option value based on an option name.

Show 2 more uses Hide more uses

Used By

Used By
Used By	Description
_wp_privacy_send_erasure_fulfillment_notification() wp-includes/user.php	Notifies the user when their erasure request is fulfilled.
get_the_privacy_policy_link() wp-includes/link-template.php	Returns the privacy policy link with formatting, when applicable.
Walker_Nav_Menu::start_el() wp-includes/class-walker-nav-menu.php	Starts the element output.

Changelog

Changelog
Version	Description
4.9.6	Introduced.

User Contributed Notes

2

Contributed by Oscar Abad Folgueira — 5 years ago

/* Basic example */
/* Get the privacy policy page link*/
// We store the privacy policy link in a variable
$privacy_policy_page_link = get_the_privacy_policy_link();

// Our variable will contain something like this
// <a class="privacy-policy-link" href="http://www.wpdev.local/politica-privacidad/">Política de privacidad</a>
// Now we can work with this link

Skip to note 2 content

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

Contributed by Muhammad Ayoub — 2 years ago
Example usage
```
<a href="<?php echo esc_attr( esc_url( get_privacy_policy_url() ) ); ?>"><?php esc_html_e( 'Cookie Policy', 'text-domain' ) ?></a>
```
Log in to add feedback

0

Contributed by Alberuni Azad. — 2 years ago

// Save privacy page info into separate variables
$policy_page_title  = '';
$policy_page_url    = '';
$policy_page_id     = (int) get_option( 'wp_page_for_privacy_policy' );

if ( $policy_page_id && get_post_status( $policy_page_id ) === 'publish' ) {
    $policy_page_title  = get_the_title( $policy_page_id );
    $policy_page_url    = get_permalink( $policy_page_id );
}

// Example Uses:
<?php if($policy_page_id): ?>
<a href="<?php echo esc_url(get_permalink($policy_page_id)) ?>" target="_blank"><?php echo esc_html(get_the_title($policy_page_id)); ?></a>
<?php endif; ?>

You must log in before being able to contribute a note or feedback.