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

Сигнатура

wp_add_privacy_policy_content( string $plugin_name, string $policy_text )

Описание

Плагины и темы должны предлагать текст для включения в политику конфиденциальности сайта.
Предлагаемый текст должен содержать информацию о любой функциональности, влияющей на конфиденциальность пользователей, и будет показан на экране руководства по политике конфиденциальности.
Плагин или тема может использовать эту функцию несколько раз, если это поможет лучше представить предлагаемое содержимое политики. Например, модульные плагины, такие как WooCommerse или Jetpack, могут добавлять или убирать предлагаемое содержимое в зависимости от включённых модулей/расширений.
Подробнее см. в справочнике по плагинам: https://developer.wordpress.org/plugins/privacy/suggesting-text-for-the-site-privacy-policy/.
HTML-содержимое $policy_text поддерживает использование специального CSS-класса .privacy-policy-tutorial, с помощью которого можно предоставить дополнительную информацию. Любое содержимое внутри HTML-элементов с применённым CSS-классом .privacy-policy-tutorial будет исключено из буфера обмена при копировании содержимого раздела.
Предназначено для использования с действием 'admin_init'.

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

Plugins and themes should suggest text for inclusion in the site’s privacy policy.
The suggested text should contain information about any functionality that affects user privacy, and will be shown on the Privacy Policy Guide screen.

A plugin or theme can use this function multiple times as long as it will help to better present the suggested policy content. For example modular plugins such as WooCommerse or Jetpack can add or remove suggested content depending on the modules/extensions that are enabled.
For more information see the Plugin Handbook: https://developer.wordpress.org/plugins/privacy/suggesting-text-for-the-site-privacy-policy/.

The HTML contents of the $policy_text supports use of a specialized .privacy-policy-tutorial CSS class which can be used to provide supplemental information. Any content contained within HTML elements that have the .privacy-policy-tutorial CSS class applied will be omitted from the clipboard when the section content is copied.

Intended for use with the 'admin_init' action.

Параметры

$plugin_name string обязательный

Имя плагина или темы, предлагающих содержимое для политики конфиденциальности сайта.

$policy_text string обязательный

Предлагаемое содержимое для включения в политику.

Исходный код

wp-admin/includes/plugin.php:2410

function wp_add_privacy_policy_content( $plugin_name, $policy_text ) {
	if ( ! is_admin() ) {
		_doing_it_wrong(
			__FUNCTION__,
			sprintf(
				/* translators: %s: admin_init */
				__( 'The suggested privacy policy content should be added only in wp-admin by using the %s (or later) action.' ),
				'<code>admin_init</code>'
			),
			'4.9.7'
		);
		return;
	} elseif ( ! doing_action( 'admin_init' ) && ! did_action( 'admin_init' ) ) {
		_doing_it_wrong(
			__FUNCTION__,
			sprintf(
				/* translators: %s: admin_init */
				__( 'The suggested privacy policy content should be added by using the %s (or later) action. Please see the inline documentation.' ),
				'<code>admin_init</code>'
			),
			'4.9.7'
		);
		return;
	}

	if ( ! class_exists( 'WP_Privacy_Policy_Content' ) ) {
		require_once ABSPATH . 'wp-admin/includes/class-wp-privacy-policy-content.php';
	}

	WP_Privacy_Policy_Content::add( $plugin_name, $policy_text );
}

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

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