A jQuery plugin to make picking icon fonts in WordPress a breeze
JavaScript PHP CSS
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 8 commits ahead, 15 commits behind bradvin:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
css
fonts
js
.gitignore
LICENSE
README.md
icon-picker-example-plugin.php
icon-picker-plugin.jpg
icon-picker-popup.jpg

README.md

icon-picker

A jQuery plugin that makes it easy to select the perfect glyph from three popular Wordpress icon fonts

icon-picker

THE FONTS

The icon fonts are not included, because you may already have them:

## INSTALLATION ##

First, you need to make sure the icon fonts and scripts are are enqueued on the admin screen:

function your_settings_icon_picker_scripts() {
 /* On WP 3.8+ dashicons do not need to be enqueued in the admin area   
    $font1 = plugin_dir_url( __FILE__ ) . 'fonts/dashicons/css/dashicons.css';
 	wp_enqueue_script( 'dashicons', $font1, '', '');
 */    
    $font2 = plugin_dir_url( __FILE__ ) . 'fonts/font-awesome/css/font-awesome.css';
    wp_enqueue_style( 'font-awesome', $font2,'','');

	$font3 = plugin_dir_url( __FILE__ ) . 'fonts/genericons/genericons.css';
	wp_enqueue_style( 'genericons', $font3, '', '');
    
    $css = plugin_dir_url( __FILE__ ) . '/css/icon-picker.css';
    wp_enqueue_style( 'dashicons-picker', $css, array( 'dashicons' ), '1.0' );
    
    $js = plugin_dir_url( __FILE__ ) . '/js/icon-picker.js';
    wp_enqueue_script( 'dashicons-picker', $js, array( 'jquery' ), '1.0' );
}
// Make sure we only enqueue on our options page //
global $pagenow;
if ($pagenow=="options-general.php" && isset( $_GET['page'] ) && $_GET['page'] == 'your_settings_page'  ) {
add_action( 'admin_enqueue_scripts', 'your_settings_icon_picker_scripts' );

Note the check for what page we are on! Without this check if you have multiple plugins that invoke the Icon Picker you would get multiple instances of it on each select button click. Multiple instances don't stop it from functioning, but there's no reason to create multiple picker dialogs.

In order to actually display the icons on the front-end of your blog you also need to enqueue them there (either in your plugin or theme functions)

function frontend_icon_picker_scripts() {
	// $font1 (assuming WP 3.8+ that already has dashicons //
	wp_enqueue_style( 'dashicons');
    $font2 = plugin_dir_url( __FILE__ ) . 'fonts/font-awesome/css/font-awesome.css';
    wp_enqueue_style( 'font-awesome', $font2,'','');
	$font3 = plugin_dir_url( __FILE__ ) . 'fonts/genericons/genericons.css';
	wp_enqueue_style( 'genericons', $font3, '', '');
}
add_action( 'wp_enqueue_scripts', 'frontend_icon_picker_scripts' );

Options Page

In the HTML of your plugin Options/Settings page just include the class of "icon-picker" and include a data-target attribute which stores the selector. You can show the stored value as a text input if you like, but the preferred display is to use the button itself to SHOW the selected icon:

	<input class="regular-text" type="hidden" id="icon_picker_example_icon1" name="icon_picker_settings[icon1]" value="<?php if( isset( $options['icon1'] ) ) { echo esc_attr( $options['icon1'] ); } ?>"/>
	<div id="preview_icon_picker_example_icon1" data-target="#icon_picker_example_icon1" class="button icon-picker <?php if( isset( $options['icon1'] ) ) { $v=explode('|',$options['icon1']); echo $v[0].' '.$v[1]; } ?>"></div>

If you prefer to use a class-based settings that utilizes the WP Settings API it would look like this (format from weDevs Settings API wrapper class by Tareq Hasan @ http://tareq.weDevs.com):

    function callback_icon( $args ) {
    	$value = esc_attr( $this->get_option( $args['id'], $args['section'], $args['std'] ) );
    	$size = isset( $ars['size'] ) && !is_null( $args['size'] ) ? $args['size'] : 'regular';
 		if ($value != '') { $preview = explode('|',$value); } else { $preview = array('','');};
    	
    	$html = sprintf( '<input class="%1$s-text" id="%2$s_%3$s" name="%2$s[%3$s]" type="hidden" value="'.$value.'"  />', $size, $args['section'], $args['id'], $value );
		$html .= sprintf( '<div id="preview_%2$s_%3$s" class="button icon-picker '.$preview[0].' '.$preview[1].'" data-target="#%2$s_%3$s"></div>',$size, $args['section'], $args['id'], $value);

    	echo $html;
    }

Notice that the value is being exploded! The selection is stored as a pipe-separated list such as "fa|fa-inbox" and needs to be exploded into an array:

	$value = explode('|',$value); //--> array([0]=>'fa',[1]=>'fa-inbox');
	$font = $value[0];
	$icon = $value[1];

Plugin Example

icon-picker-plugin

Download this entire repo as a zip, and install it like you would any other plugin. A new settings page called "Icon Picker Example" will be available where you can play with. This is just an example to show you how it works. To include the Icon Picker in your own plugin just drop the entire "icon-picker" folder into YOUR plugin's directory and enqueue the scripts and stylesheets as shown above. Again, note that this example does NOT include the actual fonts! Download them at the links above, drop them into the "icon-picker/fonts/" directory and enqueue them from there on both your Admin area and the front-end.

Thanks

Adapted from Dashicons Picker by Brad Vincent @ http://themergency.com)