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( "$( '' ).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( "//", $this->args['id'], sprintf( '

%s

', 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 ''; // phpcs:ignore WordPress.Security.EscapeOutput } }