';
echo '
' . esc_html__( 'The Font Awesome plugin caught a fatal error', 'font-awesome' );
if ( is_string( $context_message ) && '' !== $context_message ) {
echo ': ' . esc_html( $context_message );
} else {
echo '.';
}
echo '
';
if ( ! is_a( $e, 'Exception' ) && ! is_a( $e, 'Error' ) ) {
esc_html_e( 'No error message available.', 'font-awesome' );
} else {
self::emit_error_output_to_console( $e );
if ( boolval( $e->getMessage() ) ) {
echo esc_html( $e->getMessage() );
}
}
echo '
';
}
}
/**
* Internal use only.
*
* @ignore
* @internal
* @param Error|Exception
*/
public static function emit_error_output_to_console( $e ) {
global $wp_version;
if ( ! is_a( $e, 'Exception' ) && ! is_a( $e, 'Error' ) ) {
return;
}
$wp_error = null;
if ( method_exists( $e, 'get_wp_error' ) ) {
$wp_error = $e->get_wp_error();
}
$additional_diagnostics = '';
$additional_diagnostics .= 'php version: ' . phpversion() . "\n";
$additional_diagnostics .= "WordPress version: $wp_version\n";
$additional_diagnostics .= 'multisite: ' . ( is_multisite() ? 'true' : 'false' ) . "\n";
$additional_diagnostics .= 'is_network_admin: ' . ( is_network_admin() ? 'true' : 'false' ) . "\n";
echo '';
}
/**
* Internal use only, not part of this plugin's public API.
*
* @internal
* @ignore
* @return escaped string, or '' if the argument is not a string
*/
public static function escape_error_output( $content ) {
if ( ! is_string( $content ) ) {
return '';
}
$result = $content;
// JavaScript unicode escapes.
$result = preg_replace( '/\\\\x/', '\x5Cx', $result );
$result = preg_replace( '/\\\\u/', '\x5Cu', $result );
// Other stuff.
$result = preg_replace( '/\'/', "\\'", $result );
$result = preg_replace( '/\"/', '\\"', $result );
$result = preg_replace( '/\n/', '\\n', $result );
return $result;
}
/**
* Initializes the Font Awesome plugin's options.
*
* If multiple installations of the plugin are installed, such as by
* composer dependencies in multiple plugins, this will ensure that the
* plugin is not re-initialized.
*
* If the plugin's options are empty, this will initialize with defaults.
* Otherwise, it will leave them alone.
*
* Any theme or plugin that uses this plugin as a composer dependency
* should call this method from its own activation hook. For example:
*
* ```php
* register_activation_hook(
* __FILE__,
* 'FortAwesome\FontAwesome_Loader::initialize'
* );
* ```
*
* @since 4.0.0
*/
public static function initialize() {
$initialization_failed_msg = __( 'A theme or plugin tried to initialize Font Awesome, but failed.', 'font-awesome' );
try {
self::instance()->select_latest_version_plugin_installation();
require_once self::$loaded['path'] . 'includes/class-fontawesome-activator.php';
FontAwesome_Activator::initialize();
} catch ( Exception $e ) {
self::emit_admin_error_output( $e, $initialization_failed_msg );
exit;
} catch ( Error $e ) {
self::emit_admin_error_output( $e, $initialization_failed_msg );
exit;
}
}
/**
* Runs uninstall logic for the plugin, but only if its invocation
* represents the last plugin installation trying to clean up.
*
* Deletes options records in the database.
*
* If there would be other remaining installations previously added to this
* loader via {@link \FortAwesome\font_awesome_load()}, it does not delete the plugin options,
* since one of those others will end up becoming active and relying on the options data.
*
* Any theme or plugin that includes this Font Awesome plugin as a library
* dependency should call this from its own uninstall hook. For example:
*
* ```php
* register_uninstall_hook(
* __FILE__,
* 'FortAwesome\FontAwesome_Loader::maybe_uninstall'
* );
* ```
*
* @since 4.0.0
*/
public static function maybe_uninstall() {
if ( count( self::$data ) === 1 ) {
// If there's only installation in the list, then it's
// the one that has invoked this function and is is about to
// go away, so it's safe to clean up.
require_once trailingslashit( self::$data[0]['path'] ) . 'includes/class-fontawesome-deactivator.php';
FontAwesome_Deactivator::uninstall();
}
}
/**
* Deactivates, cleaning up temporary data, such as transients, if this
* represents the last installed copy of the Font Awesome plugin being deactivated.
*
* However, if this loader is aware of any remaining installations, it does
* not clean up temporary data, since one of those other Font Awesome plugin
* installations, if active, will be promoted and end up relying on the data.
*
* Any theme or plugin that includes this Font Awesome plugin as a library
* dependency should call this from its own uninstall hook. For example:
*
* ```php
* register_deactivation_hook(
* __FILE__,
* 'FortAwesome\FontAwesome_Loader::maybe_deactivate'
* );
* ```
*
* @since 4.0.0
*/
public static function maybe_deactivate() {
if ( count( self::$data ) === 1 ) {
require_once trailingslashit( self::$data[0]['path'] ) . 'includes/class-fontawesome-deactivator.php';
FontAwesome_Deactivator::deactivate();
}
}
/**
* Creates and/or returns the static instance for this Singleton.
*
* It is probably not necessary for a theme or plugin that depends upon
* the Font Awesome plugin to invoke this. It's probably more convenient
* to access the Loader's functionality through the its public static methods.
*
* @return \FortAwesome\FontAwesome_Loader
* @see FontAwesome_Loader::initialize()
* @see FontAwesome_Loader::maybe_deactivate()
* @see FontAwesome_Loader::maybe_uninstall()
* @since 4.0.0
*/
public static function instance() {
if ( null === self::$instance ) {
self::$instance = new self();
}
return self::$instance;
}
/**
* Stores plugin version and details for an installation that is being
* registered with this loader.
*
* This method is not part of this plugin's public API.
*
* @param string $data other information.
* @param string|bool $version framework version.
*
* @ignore
* @internal
* @return $this
*/
public function add( $data = '', $version = false ) {
if ( file_exists( trailingslashit( $data ) . 'index.php' ) ) {
if ( false === $version ) {
$args = get_file_data( trailingslashit( $data ) . 'index.php', array( 'version' => 'Version' ) );
$version = ( isset( $args['version'] ) && ! empty( $args['version'] ) ) ? $args['version'] : $version;
}
array_push(
self::$data,
array(
'version' => $version,
'path' => trailingslashit( $data ),
)
);
}
return $this;
}
}
endif; // ! class_exists
if ( ! function_exists( 'FortAwesome\font_awesome_load' ) ) {
/**
* Adds plugin installation path to be managed by this loader.
*
* @param string $plugin_installation_path
* @param bool $version
* @ignore
* @internal
* @since 4.0.0
*/
function font_awesome_load( $plugin_installation_path = __DIR__, $version = false ) {
FontAwesome_Loader::instance()
->add( $plugin_installation_path, $version );
}
}
if ( function_exists( 'FortAwesome\font_awesome_load' ) ) {
font_awesome_load( __DIR__ );
}