2021-02-21 09:50:23 +00:00
< ? php
/**
* Includes the main Class of the Plugin .
*
* @ filesource
2021-02-21 18:40:04 +00:00
* @ package footnotes
2021-02-21 09:50:23 +00:00
* @ since 1.5 . 0 12.09 . 14 10 : 56
*
* @ lastmodified 2021 - 02 - 19 T2031 + 0100
*
* @ since 1.6 . 5 Bugfix : Improve widgets registration , thanks to @ felipelavinz code contribution .
* @ since 1.6 . 5 Update : Fix for deprecated PHP function create_function (), thanks to @ psykonevro @ daliasued bug reports , thanks to @ felipelavinz code contribution .
2021-02-21 12:20:46 +00:00
* @ since 2.0 . 0 Update : Tooltips : fix disabling bug by loading jQuery UI library , thanks to @ rajinderverma @ ericcorbett2 @ honlapdavid @ mmallett bug reports , thanks to @ vonpiernik code contribution .
2021-02-21 09:50:23 +00:00
*
* @ since 2.0 . 3 add versioning of public . css for cache busting 2020 - 10 - 29 T1413 + 0100
2021-02-21 12:20:46 +00:00
* @ since 2.0 . 4 add jQuery UI from WordPress 2020 - 11 - 01 T1902 + 0100
2021-02-21 09:50:23 +00:00
* @ since 2.1 . 4 automate passing version number for cache busting 2020 - 11 - 30 T0646 + 0100
* @ since 2.1 . 4 optionally enqueue an extra stylesheet 2020 - 12 - 04 T2231 + 0100
*
* @ since 2.5 . 5 Update : Stylesheets : increase speed and energy efficiency by tailoring stylesheets to the needs of the instance , thanks to @ docteurfitness design contribution .
* @ since 2.5 . 5 Bugfix : Stylesheets : minify to shrink the carbon footprint , increase speed and implement best practice , thanks to @ docteurfitness issue report .
* @ since 2.5 . 5 Bugfix : Libraries : optimize processes by loading external and internal scripts only if needed , thanks to @ docteurfitness issue report .
2021-02-21 12:20:46 +00:00
* @ since 2.5 . 6 Bugfix : Reference container : optional alternative expanding and collapsing without jQuery for use with hard links , thanks to @ hopper87it @ pkverma99 issue reports .
2021-02-21 09:50:23 +00:00
*/
/**
* Entry point of the Plugin . Loads the Dashboard and executes the Task .
*
* @ since 1.5 . 0
*/
class MCI_Footnotes {
/**
* Reference to the Plugin Task object .
*
* @ since 1.5 . 0
* @ var null | MCI_Footnotes_Task
*/
public $a_obj_task = null ;
/**
2021-02-21 12:20:46 +00:00
* Idenfifies whether tooltips are enabled . Actual value depends on settings .
2021-02-21 09:50:23 +00:00
*
* @ var bool
2021-02-21 12:20:46 +00:00
*/
public static $a_bool_tooltips_enabled = false ;
/**
* Idenfifies whether alternative tooltips are enabled . Actual value depends
* on settings .
2021-02-21 09:50:23 +00:00
*
2021-02-21 12:20:46 +00:00
* @ var bool
2021-02-21 09:50:23 +00:00
*/
public static $a_bool_alternative_tooltips_enabled = false ;
/**
* Executes the Plugin .
*
* @ since 1.5 . 0
*
*
* - Bugfix : Improve widgets registration , thanks to @ felipelavinz code contribution .
*
* @ since 1.6 . 5
*
* @ contributor @ felipelavinz
* @ link https :// github . com / media - competence - institute / footnotes / commit / 87173 d2980c7ff90e12ffee94ca7153e11163793
*
* @ see self :: initialize_widgets ()
*/
public function run () {
// Register language.
MCI_Footnotes_Language :: register_hooks ();
// Register Button hooks.
MCI_Footnotes_WYSIWYG :: register_hooks ();
// Register general hooks.
MCI_Footnotes_Hooks :: register_hooks ();
// Initialize the Plugin Dashboard.
$this -> initialize_dashboard ();
// Initialize the Plugin Task.
$this -> initialize_task ();
// Register all Public Stylesheets and Scripts.
add_action ( 'init' , array ( $this , 'register_public' ) );
// Enqueue all Public Stylesheets and Scripts.
add_action ( 'wp_enqueue_scripts' , array ( $this , 'register_public' ) );
// Register all Widgets of the Plugin..
add_action ( 'widgets_init' , array ( $this , 'initialize_widgets' ) );
}
/**
* Initializes all Widgets of the Plugin .
*
* @ since 1.5 . 0
*
*
* - Update : Fix for deprecated PHP function create_function (), thanks to @ psykonevro @ daliasued bug reports , thanks to @ felipelavinz code contribution
*
* @ since 1.6 . 5
*
* @ contributor @ felipelavinz
* @ link https :// github . com / media - competence - institute / footnotes / commit / 87173 d2980c7ff90e12ffee94ca7153e11163793
*
* @ reporter @ psykonevro
* @ link https :// wordpress . org / support / topic / bug - function - create_function - is - deprecated /
* @ link https :// wordpress . org / support / topic / deprecated - function - create_function - 14 /
*
* @ reporter @ daliasued
* @ link https :// wordpress . org / support / topic / deprecated - function - create_function - 14 / #post-13312853
*
* create_function () was deprecated in PHP 7.2 . 0 and removed in PHP 8.0 . 0.
* @ link https :// www . php . net / manual / en / function . create - function . php
*
* The fix is to move add_action () above into run (),
* and use the bare register_widget () here .
* @ see self :: run ()
*
* Also , the visibility of initialize_widgets () is not private any longer .
*/
public function initialize_widgets () {
register_widget ( 'MCI_Footnotes_Widget_Reference_container' );
}
/**
* Initializes the Dashboard of the Plugin and loads them .
*
* @ since 1.5 . 0
*/
private function initialize_dashboard () {
new MCI_Footnotes_Layout_Init ();
}
/**
* Initializes the Plugin Task and registers the Task hooks .
*
* @ since 1.5 . 0
*/
private function initialize_task () {
$this -> a_obj_task = new MCI_Footnotes_Task ();
$this -> a_obj_task -> register_hooks ();
}
/**
* Registers and enqueues scripts and stylesheets to the public pages .
*
* @ since 1.5 . 0
*
2021-02-21 12:20:46 +00:00
* @ since 2.0 . 0 Update : Tooltips : fix disabling bug by loading jQuery UI library , thanks to @ rajinderverma @ ericcorbett2 @ honlapdavid @ mmallett bug reports , thanks to @ vonpiernik code contribution .
2021-02-21 09:50:23 +00:00
* @ since 2.0 . 3 add versioning of public . css for cache busting 2020 - 10 - 29 T1413 + 0100
2021-02-21 12:20:46 +00:00
* @ since 2.0 . 4 add jQuery UI from WordPress 2020 - 11 - 01 T1902 + 0100
2021-02-21 09:50:23 +00:00
* @ since 2.1 . 4 automate passing version number for cache busting 2020 - 11 - 30 T0646 + 0100
* @ since 2.1 . 4 optionally enqueue an extra stylesheet 2020 - 12 - 04 T2231 + 0100
*/
public function register_public () {
/**
* Enqueues external scripts .
*
* - Bugfix : Libraries : optimize processes by loading external and internal scripts only if needed , thanks to @ docteurfitness issue report .
*
* @ since 2.5 . 5
* @ reporter @ docteurfitness
* @ link https :// wordpress . org / support / topic / simply - speed - optimisation /
*
* The condition about tooltips was missing , only the not - alternative - tooltips part was present .
*/
// Set conditions re-used for stylesheet enqueuing:.
2021-02-21 11:38:21 +00:00
self :: $a_bool_tooltips_enabled = MCI_Footnotes_Convert :: to_bool ( MCI_Footnotes_Settings :: instance () -> get ( MCI_Footnotes_Settings :: C_BOOL_FOOTNOTES_MOUSE_OVER_BOX_ENABLED ) );
2021-02-21 09:50:23 +00:00
self :: $a_bool_alternative_tooltips_enabled = MCI_Footnotes_Convert :: to_bool ( MCI_Footnotes_Settings :: instance () -> get ( MCI_Footnotes_Settings :: C_BOOL_FOOTNOTES_MOUSE_OVER_BOX_ALTERNATIVE ) );
2021-02-21 11:38:21 +00:00
$l_str_script_mode = MCI_Footnotes_Settings :: instance () -> get ( MCI_Footnotes_Settings :: C_STR_FOOTNOTES_REFERENCE_CONTAINER_SCRIPT_MODE );
2021-02-21 09:50:23 +00:00
/**
2021-02-21 12:20:46 +00:00
* Enqueues the jQuery library registered by WordPress .
2021-02-21 09:50:23 +00:00
*
2021-02-21 12:20:46 +00:00
* - Bugfix : Reference container : optional alternative expanding and collapsing without jQuery for use with hard links , thanks to @ hopper87it @ pkverma99 issue reports .
2021-02-21 09:50:23 +00:00
*
* @ since 2.5 . 6
*
* @ reporter @ hopper87it
* @ link https :// wordpress . org / support / topic / footnotes - wp - rocket /
*
2021-02-21 12:20:46 +00:00
* jQuery is also used for animated scrolling , so it was loaded by default .
2021-02-21 09:50:23 +00:00
* The function wp_enqueue_script () avoids loading the same library multiple times .
2021-02-21 12:20:46 +00:00
* After adding the alternative reference container , jQuery has become optional ,
2021-02-21 09:50:23 +00:00
* but still enabled by default .
*/
2021-02-21 11:57:56 +00:00
if ( 'jquery' === $l_str_script_mode || ( self :: $a_bool_tooltips_enabled && ! self :: $a_bool_alternative_tooltips_enabled ) ) {
2021-02-21 09:50:23 +00:00
wp_enqueue_script ( 'jquery' );
}
if ( self :: $a_bool_tooltips_enabled && ! self :: $a_bool_alternative_tooltips_enabled ) {
/**
2021-02-21 12:20:46 +00:00
* Enqueues the jQuery Tools library shipped with the plugin .
2021-02-21 09:50:23 +00:00
*
2021-02-21 12:20:46 +00:00
* Redacted jQuery . browser , completed minification ;
2021-02-21 09:50:23 +00:00
* see full header in js / jquery . tools . js
* added versioning 2020 - 11 - 18 T2150 + 0100
2021-02-21 12:20:46 +00:00
* not use '-js' in the handle , is appended automatically .
2021-02-21 09:50:23 +00:00
*/
wp_enqueue_script (
'mci-footnotes-jquery-tools' ,
plugins_url ( 'footnotes/js/jquery.tools.min.js' ),
array (),
2021-02-21 12:20:46 +00:00
'1.2.7.redacted.2' ,
true
2021-02-21 09:50:23 +00:00
);
/**
2021-02-21 12:20:46 +00:00
* Enqueues some jQuery UI libraries registered by WordPress .
2021-02-21 09:50:23 +00:00
*
2021-02-21 12:20:46 +00:00
* @ since 2.0 . 4 add jQuery UI from WordPress 2020 - 11 - 01 T1902 + 0100
2021-02-21 09:50:23 +00:00
* If alternative tooltips are enabled , these libraries are not needed .
*/
wp_enqueue_script ( 'jquery-ui-core' );
wp_enqueue_script ( 'jquery-ui-widget' );
wp_enqueue_script ( 'jquery-ui-position' );
wp_enqueue_script ( 'jquery-ui-tooltip' );
}
/**
* Enables enqueuing a new - scheme stylesheet .
*
* @ since 2.5 . 5
* @ date 2021 - 02 - 14 T1512 + 0100
*
* Enables enqueuing the formatted individual stylesheets if false .
* WARNING : This facility is designed for development and must NOT be used in production .
*
* The Boolean may be set at the bottom of the plugin’ main PHP file .
* @ see footnotes . php
*/
if ( C_BOOL_CSS_PRODUCTION_MODE === true ) {
/**
* Enqueues a minified united external stylesheet in production .
*
* - Update : Stylesheets : increase speed and energy efficiency by tailoring stylesheets to the needs of the instance , thanks to @ docteurfitness design contribution .
* - Bugfix : Stylesheets : minify to shrink the carbon footprint , increase speed and implement best practice , thanks to @ docteurfitness issue report .
*
* @ since 2.5 . 5
* @ date 2021 - 02 - 14 T1543 + 0100
*
* @ contributor @ docteurfitness
* @ link https :// wordpress . org / support / topic / simply - speed - optimisation /
*
* @ reporter @ docteurfitness
* @ link https :// wordpress . org / support / topic / simply - speed - optimisation /
*
* The dashboard stylesheet is minified as - is .
* @ see class / dashboard / layout . php
*
* @ since 2.0 . 3 add versioning of public . css for cache busting .
* @ date 2020 - 10 - 29 T1413 + 0100
* Plugin version number is needed for busting browser caches after each plugin update .
* @ since 2.1 . 4 automate passing version number for cache busting .
* @ date 2020 - 11 - 30 T0646 + 0100
* The constant C_STR_FOOTNOTES_VERSION is defined at start of footnotes . php .
*
* The media scope argument 'all' is the default .
* No need to use '-css' in the handle , as this is appended automatically .
*/
// Set tooltip mode for use in stylesheet name:.
if ( self :: $a_bool_tooltips_enabled ) {
if ( self :: $a_bool_alternative_tooltips_enabled ) {
$l_str_tooltip_mode = 'al' ;
2021-02-21 11:38:21 +00:00
$l_str_tcomplement = 'ternative-tooltips' ;
2021-02-21 09:50:23 +00:00
} else {
$l_str_tooltip_mode = 'jq' ;
2021-02-21 11:38:21 +00:00
$l_str_tcomplement = 'uery-tooltips' ;
2021-02-21 09:50:23 +00:00
}
} else {
$l_str_tooltip_mode = 'no' ;
2021-02-21 11:38:21 +00:00
$l_str_tcomplement = '-tooltips' ;
2021-02-21 09:50:23 +00:00
}
// Set basic responsive page layout mode for use in stylesheet name:.
$l_str_page_layout_option = MCI_Footnotes_Settings :: instance () -> get ( MCI_Footnotes_Settings :: C_STR_FOOTNOTES_PAGE_LAYOUT_SUPPORT );
switch ( $l_str_page_layout_option ) {
case 'reference-container' :
$l_str_layout_mode = '1' ;
break ;
case 'entry-content' :
$l_str_layout_mode = '2' ;
break ;
case 'main-content' :
$l_str_layout_mode = '3' ;
break ;
case 'none' :
default :
$l_str_layout_mode = '0' ;
break ;
}
// Enqueue the tailored united minified stylesheet:.
wp_enqueue_style (
'mci-footnotes-' . $l_str_tooltip_mode . $l_str_tcomplement . '-pagelayout-' . $l_str_page_layout_option ,
plugins_url (
MCI_Footnotes_Config :: C_STR_PLUGIN_NAME . '/css/footnotes-' . $l_str_tooltip_mode . 'ttbrpl' . $l_str_layout_mode . '.min.css'
),
array (),
C_STR_FOOTNOTES_VERSION ,
'all'
);
} else {
/**
* Enqueues external stylesheets , ONLY in development now .
*
* @ since 2.1 . 4 optionally enqueue an extra stylesheet .
* @ date 2020 - 12 - 04 T2231 + 0100
*
* This optional layout fix is useful by lack of layout support .
*/
wp_enqueue_style ( 'mci-footnotes-common' , plugins_url ( MCI_Footnotes_Config :: C_STR_PLUGIN_NAME . '/css/dev-common.css' ), array (), C_STR_FOOTNOTES_VERSION );
wp_enqueue_style ( 'mci-footnotes-tooltips' , plugins_url ( MCI_Footnotes_Config :: C_STR_PLUGIN_NAME . '/css/dev-tooltips.css' ), array (), C_STR_FOOTNOTES_VERSION );
wp_enqueue_style ( 'mci-footnotes-alternative' , plugins_url ( MCI_Footnotes_Config :: C_STR_PLUGIN_NAME . '/css/dev-tooltips-alternative.css' ), array (), C_STR_FOOTNOTES_VERSION );
$l_str_page_layout_option = MCI_Footnotes_Settings :: instance () -> get ( MCI_Footnotes_Settings :: C_STR_FOOTNOTES_PAGE_LAYOUT_SUPPORT );
2021-02-21 11:57:56 +00:00
if ( 'none' !== $l_str_page_layout_option ) {
2021-02-21 09:50:23 +00:00
wp_enqueue_style (
'mci-footnotes-layout-' . $l_str_page_layout_option ,
plugins_url (
MCI_Footnotes_Config :: C_STR_PLUGIN_NAME . '/css/dev-layout-' . $l_str_page_layout_option . '.css'
),
array (),
C_STR_FOOTNOTES_VERSION ,
'all'
);
}
}
}
}
