* @license GPL-2.0+
* @link http://wordpress.org/plugins/better-font-awesome
* @copyright 2017 Mickey Kay
*
* @wordpress-plugin
* Plugin Name: Better Font Awesome
* Plugin URI: http://wordpress.org/plugins/better-font-awesome
* Description: The ultimate Font Awesome icon plugin for WordPress.
* Version: 2.0.4
* Author: Mickey Kay
* Author URI: mickeyskay@gmail.com
* License: GPLv2+
* Text Domain: better-font-awesome
* Domain Path: /languages
* GitHub Plugin URI: https://github.com/MickeyKay/better-font-awesome
*/
add_action( 'init', 'bfa_start', 5 );
/**
* Initialize the Better Font Awesome plugin.
*
* Start up Better Font Awesome early on the init hook, priority 5, in
* order to load it before any other plugins that might also use the Better Font
* Awesome Library.
*
* @since 0.9.5
*/
function bfa_start() {
global $better_font_awesome;
$better_font_awesome = Better_Font_Awesome_Plugin::get_instance();
}
/**
* Better Font Awesome plugin class
*
* @since 0.9.0
*/
class Better_Font_Awesome_Plugin {
/**
* Plugin slug.
*
* @since 0.9.0
*
* @var string
*/
const SLUG = 'better-font-awesome';
/**
* Plugin version.
*
* @since 2.0.0
*
* @var string
*/
const VERSION = '2.0.4';
/**
* The Better Font Awesome Library object.
*
* @since 0.1.0
*
* @var Better_Font_Awesome_Library
*/
private $bfa_lib;
/**
* Path to the Better Font Awesome Library main file.
*
* @since 0.1.0
*
* @var Better_Font_Awesome_Library
*/
private $bfa_lib_file_path;
/**
* Plugin display name.
*
* @since 0.9.0
*
* @var string
*/
private $plugin_display_name;
/**
* Plugin option name.
*
* @since 0.9.0
*
* @var string
*/
protected $option_name;
/**
* Plugin options.
*
* @since 0.9.0
*
* @var string
*/
protected $options;
/**
* Default options.
*
* Used for setting uninitialized plugin options.
*
* @since 0.9.0
*
* @var array
*/
protected $option_defaults = array(
'include_v4_shim' => '',
'remove_existing_fa' => '',
'hide_admin_notices' => '',
);
/**
* Instance of this class.
*
* @since 0.9.0
*
* @var Better_Font_Awesome_Plugin
*/
protected static $instance = null;
/**
* Returns the instance of this class, and initializes the instance if it
* doesn't already exist.
*
* @param array $args Args to instantiate BFA object.
*
* @return Better_Font_Awesome The BFA object.
*/
public static function get_instance( $args = array() ) {
// If the single instance hasn't been set, set it now.
// phpcs:ignore WordPress.PHP.StrictComparisons.LooseComparison
if ( null == self::$instance ) {
self::$instance = new self( $args );
}
return self::$instance;
}
/**
* Better Font Awesome Plugin constructor.
*
* @since 0.9.0
*/
protected function __construct() {
// Perform plugin initialization actions.
$this->initialize();
// Stop if the Better Font Awesome Library isn't included.
if ( ! $this->bfal_exists() ) {
add_action( 'admin_init', array( $this, 'deactivate' ) );
return false;
}
// Include required files.
$this->includes();
// Initialize the Better Font Awesome Library.
$this->initialize_better_font_awesome_library( $this->options );
// Load the plugin text domain.
$this->load_text_domain();
// Set up the admin settings page.
add_action( 'admin_menu', array( $this, 'add_settings_page' ) );
add_action( 'admin_init', array( $this, 'add_settings' ) );
add_action( 'admin_enqueue_scripts', array( $this, 'admin_enqueue_scripts' ) );
// Handle saving options via AJAX.
add_action( 'wp_ajax_bfa_save_options', array( $this, 'save_options' ) );
}
/**
* Do necessary initialization actions.
*
* @since 0.10.0
*/
private function initialize() {
// Set display name.
$this->plugin_display_name = __( 'Better Font Awesome', 'better-font-awesome' );
// Set options name.
$this->option_name = self::SLUG . '_options';
// Set up main Better Font Awesome Library file path.
$this->bfa_lib_file_path = plugin_dir_path( __FILE__ ) . 'vendor/mickey-kay/better-font-awesome-library/better-font-awesome-library.php';
// Get plugin options, and populate defaults as needed.
$this->initialize_options( $this->option_name );
}
/**
* Get class prop.
*
* @since 1.7.0
*
* @param string $prop Prop to fetch.
*
* @return mixed Value of the prop.
*/
public function get( $prop ) {
return $this->$prop;
}
/**
* Check if the Better Font Awesome Library is included.
*
* @since 0.10.0
*/
public function bfal_exists() {
if ( ! is_readable( $this->bfa_lib_file_path ) ) {
return false;
} else {
return true;
}
}
/**
* Get BFAL instance.
*
* @since 2.0.0
*
* @return Object BFAL instance.
*/
public function get_bfa_lib_instance() {
return $this->bfa_lib;
}
/**
* Deactivate and display an error if the BFAL isn't included.
*
* @since 0.10.0
*/
public function deactivate() {
deactivate_plugins( plugin_basename( __FILE__ ) );
$message = '
' . __( 'Better Font Awesome', 'better-font-awesome' ) . '
';
$message .= '
' . __( 'It appears that Better Font Awesome is missing it\'s core library, which typically occurs when cloning the Git repository and failing to run composer install. Please refer to the plugin\'s installation instructions for details on how to properly install Better Font Awesome via Git. If you installed from within WordPress, or via the wordpress.org repo, then chances are the install failed and you can try again. If the issue persists, please create a new topic on the plugin\'s support forum or file an issue on the Github repo.', 'better-font-awesome' ) . '