'xyz123', // unique id for this pointer * 'screen' => 'page', // this is the page hook we want our pointer to show on * 'target' => '#element-selector', // the css selector for the pointer to be tied to, best to use ID's * 'title' => 'My ToolTip', * 'content' => 'My tooltips Description', * 'position' => array( * 'edge' => 'top', //top, bottom, left, right * 'align' => 'middle' //top, bottom, left, right, middle * ) * ) * // more as needed * ); * //Now we instantiate the class and pass our pointer array to the constructor * $myPointers = new WP_Help_Pointer($pointers); * } * * * @package AviaPointer * @version 0.1 * @author Tim Debo * @copyright Copyright (c) 2012, Raw Creative Studios * @link https://github.com/rawcreative/wp-help-pointers * @license http://www.gnu.org/licenses/old-licenses/gpl-2.0.html */ class AviaPointer { public $screen_id; public $valid; public $pointers; public function __construct( $pntrs = array() ) { // Don't run on WP < 3.3 if ( get_bloginfo( 'version' ) < '3.3' || !function_exists('get_current_screen')) return; $screen = get_current_screen(); $this->screen_id = isset($screen->id) ? isset($screen->id) : false; $this->register_pointers($pntrs); add_action( 'admin_enqueue_scripts', array( &$this, 'add_pointers' ), 1000 ); add_action( 'admin_head', array( &$this, 'add_scripts' ) ); } public function register_pointers( $pntrs ) { foreach( $pntrs as $ptr ) { if( $ptr['screen'] == $this->screen_id ) { $pointers[$ptr['id']] = array( 'screen' => $ptr['screen'], 'target' => $ptr['target'], 'options' => array( 'content' => sprintf( '

%s

%s

', __( $ptr['title'] , 'plugindomain' ), __( $ptr['content'], 'plugindomain' ) ), 'position' => $ptr['position'] ) ); } } if(!empty($pointers)) $this->pointers = $pointers; } public function add_pointers() { $pointers = $this->pointers; if ( ! $pointers || ! is_array( $pointers ) ) return; // Get dismissed pointers $dismissed = explode( ',', (string) get_user_meta( get_current_user_id(), 'dismissed_wp_pointers', true ) ); $valid_pointers = array(); // Check pointers and remove dismissed ones. foreach ( $pointers as $pointer_id => $pointer ) { // Make sure we have pointers & check if they have been dismissed if ( in_array( $pointer_id, $dismissed ) || empty( $pointer ) || empty( $pointer_id ) || empty( $pointer['target'] ) || empty( $pointer['options'] ) ) continue; $pointer['pointer_id'] = $pointer_id; // Add the pointer to $valid_pointers array $valid_pointers['pointers'][] = $pointer; } // No valid pointers? Stop here. if ( empty( $valid_pointers ) ) return; $this->valid = $valid_pointers; wp_enqueue_style( 'wp-pointer' ); wp_enqueue_script( 'wp-pointer' ); } public function add_scripts() { $pointers = $this->valid; if( empty( $pointers ) ) return; $pointers = json_encode( $pointers ); echo << jQuery(document).ready( function($) { var WPHelpPointer = {$pointers}; $.each(WPHelpPointer.pointers, function(i) { wp_help_pointer_open(i); }); function wp_help_pointer_open(i) { pointer = WPHelpPointer.pointers[i]; options = $.extend( pointer.options, { close: function() { $.post( ajaxurl, { pointer: pointer.pointer_id, action: 'dismiss-wp-pointer' }); } }); $(pointer.target).pointer( options ).pointer('open'); } }); HTML; } } // end class