mirror of
https://git.sindominio.net/estibadores/wordpress.git
synced 2024-11-14 23:21:07 +01:00
114 lines
3.6 KiB
PHP
114 lines
3.6 KiB
PHP
<?php
|
|
|
|
/**
|
|
* A class to manage WP pointers
|
|
* offers the possibility to have customized buttons
|
|
*
|
|
* @since 1.7.7
|
|
* @deprecated 2.3.9
|
|
*/
|
|
class PLL_Pointer {
|
|
protected $args;
|
|
|
|
/**
|
|
* Constructor
|
|
* enqueues the pointer script
|
|
*
|
|
* List of parameters accepted in $args:
|
|
*
|
|
* pointer => required, unique identifier of the pointer
|
|
* id => required, the pointer will be attached to this html id
|
|
* position => optional array, if used both sub parameters are required
|
|
* edge => 'top' or 'bottom'
|
|
* align => 'right' or 'left'
|
|
* width => optional, the width in px
|
|
* title => required, title
|
|
* content => required, content
|
|
* buttons => optional array of arrays, by default the pointer uses the standard dismiss button offered by WP
|
|
* label => the label of the button
|
|
* link => optional link for the button. By default, the button just dismisses the pointer
|
|
*
|
|
* @since 1.7.7
|
|
*
|
|
* @param array $args
|
|
*/
|
|
public function __construct( $args ) {
|
|
trigger_error( 'The class PLL_Pointer has been deprecated since Polylang 2.3.9 and will be removed in a future version.', E_USER_ERROR ); // phpcs:ignore WordPress.PHP.DevelopmentFunctions
|
|
|
|
$this->args = $args;
|
|
add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_scripts' ) );
|
|
}
|
|
|
|
/**
|
|
* Enqueue javascripts and styles if the pointer has not been dismissed
|
|
*
|
|
* @since 1.7.7
|
|
*/
|
|
public function enqueue_scripts() {
|
|
$dismissed = explode( ',', get_user_meta( get_current_user_id(), 'dismissed_wp_pointers', true ) );
|
|
if ( in_array( $this->args['pointer'], $dismissed ) || ! current_user_can( 'manage_options' ) ) {
|
|
return;
|
|
}
|
|
|
|
// Add pointer javascript
|
|
add_action( 'admin_print_footer_scripts', array( $this, 'print_js' ) );
|
|
|
|
wp_enqueue_style( 'wp-pointer' );
|
|
wp_enqueue_script( 'wp-pointer' );
|
|
}
|
|
|
|
/**
|
|
* Adds the javascript of our pointer to the page
|
|
*
|
|
* @since 1.7.7
|
|
*/
|
|
public function print_js() {
|
|
|
|
// Add optional buttons
|
|
if ( ! empty( $this->args['buttons'] ) ) {
|
|
$b = "
|
|
var widget = pointer.pointer( 'widget' );
|
|
var buttons = $( '.wp-pointer-buttons', widget );
|
|
$( 'a.close', widget ).remove();"; // removes the WP button
|
|
|
|
// All the buttons use the standard WP ajax action to remember the pointer has been dismissed
|
|
foreach ( $this->args['buttons'] as $button ) {
|
|
$b .= sprintf(
|
|
"$( '<a>' ).addClass( '%s' ).html( '%s' ).css( 'margin-left', '10px' ).click( function() {
|
|
$.post( ajaxurl, {
|
|
pointer: '%s',
|
|
action: 'dismiss-wp-pointer'
|
|
}, function( response ) {
|
|
%s
|
|
} );
|
|
} ).appendTo( buttons );",
|
|
empty( $button['link'] ) ? 'button' : 'button button-primary',
|
|
esc_html( $button['label'] ),
|
|
$this->args['pointer'],
|
|
empty( $button['link'] ) ? "pointer.pointer( 'close' )" : sprintf( "location.href = '%s'", $button['link'] )
|
|
);
|
|
}
|
|
}
|
|
|
|
$js = sprintf(
|
|
"//<![CDATA[
|
|
jQuery( document ).ready( function( $ ) {
|
|
var pointer = $( '#%s' ).pointer( {
|
|
content: '%s',
|
|
%s
|
|
%s
|
|
} );
|
|
pointer.pointer( 'open' );
|
|
%s
|
|
} );
|
|
// ]]>",
|
|
$this->args['id'],
|
|
sprintf( '<h3>%s</h3><p>%s</p>', esc_html( $this->args['title'] ), esc_html( $this->args['content'] ) ),
|
|
empty( $this->args['position'] ) ? '' : sprintf( 'position: {edge: "%s", align: "%s",},', $this->args['position']['edge'], $this->args['position']['align'] ),
|
|
empty( $this->args['width'] ) ? '' : sprintf( 'pointerWidth: %d,', $this->args['width'] ),
|
|
empty( $b ) ? '' : $b
|
|
);
|
|
echo '<script type="text/javascript">' . $js . '</script>'; // phpcs:ignore WordPress.Security.EscapeOutput
|
|
}
|
|
}
|