PDF rausgenommen
This commit is contained in:
aschwarz
201
msd2/wordpress/wp-admin/includes/class-wp-internal-pointers.php
Normal file
201
msd2/wordpress/wp-admin/includes/class-wp-internal-pointers.php
Normal file
@ -0,0 +1,201 @@
|
||||
<?php
|
||||
/**
|
||||
* Administration API: WP_Internal_Pointers class
|
||||
*
|
||||
* @package WordPress
|
||||
* @subpackage Administration
|
||||
* @since 4.4.0
|
||||
*/
|
||||
|
||||
/**
|
||||
* Core class used to implement an internal admin pointers API.
|
||||
*
|
||||
* @since 3.3.0
|
||||
*/
|
||||
final class WP_Internal_Pointers {
|
||||
/**
|
||||
* Initializes the new feature pointers.
|
||||
*
|
||||
* @since 3.3.0
|
||||
*
|
||||
* All pointers can be disabled using the following:
|
||||
* remove_action( 'admin_enqueue_scripts', array( 'WP_Internal_Pointers', 'enqueue_scripts' ) );
|
||||
*
|
||||
* Individual pointers (e.g. wp390_widgets) can be disabled using the following:
|
||||
* remove_action( 'admin_print_footer_scripts', array( 'WP_Internal_Pointers', 'pointer_wp390_widgets' ) );
|
||||
*
|
||||
* @param string $hook_suffix The current admin page.
|
||||
*/
|
||||
public static function enqueue_scripts( $hook_suffix ) {
|
||||
/*
|
||||
* Register feature pointers
|
||||
*
|
||||
* Format:
|
||||
* array(
|
||||
* hook_suffix => pointer callback
|
||||
* )
|
||||
*
|
||||
* Example:
|
||||
* array(
|
||||
* 'themes.php' => 'wp390_widgets'
|
||||
* )
|
||||
*/
|
||||
$registered_pointers = array(
|
||||
'index.php' => 'wp496_privacy',
|
||||
);
|
||||
|
||||
// Check if screen related pointer is registered
|
||||
if ( empty( $registered_pointers[ $hook_suffix ] ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$pointers = (array) $registered_pointers[ $hook_suffix ];
|
||||
|
||||
/*
|
||||
* Specify required capabilities for feature pointers
|
||||
*
|
||||
* Format:
|
||||
* array(
|
||||
* pointer callback => Array of required capabilities
|
||||
* )
|
||||
*
|
||||
* Example:
|
||||
* array(
|
||||
* 'wp390_widgets' => array( 'edit_theme_options' )
|
||||
* )
|
||||
*/
|
||||
$caps_required = array(
|
||||
'wp496_privacy' => array(
|
||||
'manage_privacy_options',
|
||||
'export_others_personal_data',
|
||||
'erase_others_personal_data',
|
||||
),
|
||||
);
|
||||
|
||||
// Get dismissed pointers
|
||||
$dismissed = explode( ',', (string) get_user_meta( get_current_user_id(), 'dismissed_wp_pointers', true ) );
|
||||
|
||||
$got_pointers = false;
|
||||
foreach ( array_diff( $pointers, $dismissed ) as $pointer ) {
|
||||
if ( isset( $caps_required[ $pointer ] ) ) {
|
||||
foreach ( $caps_required[ $pointer ] as $cap ) {
|
||||
if ( ! current_user_can( $cap ) ) {
|
||||
continue 2;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// Bind pointer print function
|
||||
add_action( 'admin_print_footer_scripts', array( 'WP_Internal_Pointers', 'pointer_' . $pointer ) );
|
||||
$got_pointers = true;
|
||||
}
|
||||
|
||||
if ( ! $got_pointers ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Add pointers script and style to queue
|
||||
wp_enqueue_style( 'wp-pointer' );
|
||||
wp_enqueue_script( 'wp-pointer' );
|
||||
}
|
||||
|
||||
/**
|
||||
* Print the pointer JavaScript data.
|
||||
*
|
||||
* @since 3.3.0
|
||||
*
|
||||
* @param string $pointer_id The pointer ID.
|
||||
* @param string $selector The HTML elements, on which the pointer should be attached.
|
||||
* @param array $args Arguments to be passed to the pointer JS (see wp-pointer.js).
|
||||
*/
|
||||
private static function print_js( $pointer_id, $selector, $args ) {
|
||||
if ( empty( $pointer_id ) || empty( $selector ) || empty( $args ) || empty( $args['content'] ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
?>
|
||||
<script type="text/javascript">
|
||||
(function($){
|
||||
var options = <?php echo wp_json_encode( $args ); ?>, setup;
|
||||
|
||||
if ( ! options )
|
||||
return;
|
||||
|
||||
options = $.extend( options, {
|
||||
close: function() {
|
||||
$.post( ajaxurl, {
|
||||
pointer: '<?php echo $pointer_id; ?>',
|
||||
action: 'dismiss-wp-pointer'
|
||||
});
|
||||
}
|
||||
});
|
||||
|
||||
setup = function() {
|
||||
$('<?php echo $selector; ?>').first().pointer( options ).pointer('open');
|
||||
};
|
||||
|
||||
if ( options.position && options.position.defer_loading )
|
||||
$(window).bind( 'load.wp-pointers', setup );
|
||||
else
|
||||
$(document).ready( setup );
|
||||
|
||||
})( jQuery );
|
||||
</script>
|
||||
<?php
|
||||
}
|
||||
|
||||
public static function pointer_wp330_toolbar() {}
|
||||
public static function pointer_wp330_media_uploader() {}
|
||||
public static function pointer_wp330_saving_widgets() {}
|
||||
public static function pointer_wp340_customize_current_theme_link() {}
|
||||
public static function pointer_wp340_choose_image_from_library() {}
|
||||
public static function pointer_wp350_media() {}
|
||||
public static function pointer_wp360_revisions() {}
|
||||
public static function pointer_wp360_locks() {}
|
||||
public static function pointer_wp390_widgets() {}
|
||||
public static function pointer_wp410_dfw() {}
|
||||
|
||||
/**
|
||||
* Display a pointer for the new privacy tools.
|
||||
*
|
||||
* @since 4.9.6
|
||||
*/
|
||||
public static function pointer_wp496_privacy() {
|
||||
$content = '<h3>' . __( 'Personal Data and Privacy' ) . '</h3>';
|
||||
$content .= '<h4>' . __( 'Personal Data Export and Erasure' ) . '</h4>';
|
||||
$content .= '<p>' . __( 'New <strong>Tools</strong> have been added to help you with personal data export and erasure requests.' ) . '</p>';
|
||||
$content .= '<h4>' . __( 'Privacy Policy' ) . '</h4>';
|
||||
$content .= '<p>' . __( 'Create or select your site’s privacy policy page under <strong>Settings > Privacy</strong> to keep your users informed and aware.' ) . '</p>';
|
||||
|
||||
if ( is_rtl() ) {
|
||||
$position = array(
|
||||
'edge' => 'right',
|
||||
'align' => 'bottom',
|
||||
);
|
||||
} else {
|
||||
$position = array(
|
||||
'edge' => 'left',
|
||||
'align' => 'bottom',
|
||||
);
|
||||
}
|
||||
|
||||
$js_args = array(
|
||||
'content' => $content,
|
||||
'position' => $position,
|
||||
'pointerClass' => 'wp-pointer arrow-bottom',
|
||||
'pointerWidth' => 420,
|
||||
);
|
||||
self::print_js( 'wp496_privacy', '#menu-tools', $js_args );
|
||||
}
|
||||
|
||||
/**
|
||||
* Prevents new users from seeing existing 'new feature' pointers.
|
||||
*
|
||||
* @since 3.3.0
|
||||
*
|
||||
* @param int $user_id User ID.
|
||||
*/
|
||||
public static function dismiss_pointers_for_new_users( $user_id ) {
|
||||
add_user_meta( $user_id, 'dismissed_wp_pointers', 'wp496_privacy' );
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user