wordpress/php-fpm/wordpress_files/plugins/polylang/include/pointer.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
	}
}