| Total Complexity | 72 |
| Total Lines | 594 |
| Duplicated Lines | 0 % |
| Changes | 0 | ||
Complex classes like WP_Font_Awesome_Settings often do a lot of different things. To break such a class down, we need to identify a cohesive component within that class. A common approach to find such a component is to look for fields/methods that share the same prefixes, or suffixes.
Once you have determined the fields that belong together, you can apply the Extract Class refactoring. If the component makes sense as a sub-class, Extract Subclass is also a candidate, and is often faster.
While breaking up the class, it is a good idea to analyze how other classes use WP_Font_Awesome_Settings, and based on these observations, apply Extract Interface, too.
| 1 | <?php |
||
| 36 | class WP_Font_Awesome_Settings { |
||
| 37 | |||
| 38 | /** |
||
| 39 | * Class version version. |
||
| 40 | * |
||
| 41 | * @var string |
||
| 42 | */ |
||
| 43 | public $version = '1.0.14'; |
||
| 44 | |||
| 45 | /** |
||
| 46 | * Class textdomain. |
||
| 47 | * |
||
| 48 | * @var string |
||
| 49 | */ |
||
| 50 | public $textdomain = 'font-awesome-settings'; |
||
| 51 | |||
| 52 | /** |
||
| 53 | * Latest version of Font Awesome at time of publish published. |
||
| 54 | * |
||
| 55 | * @var string |
||
| 56 | */ |
||
| 57 | public $latest = "5.8.2"; |
||
| 58 | |||
| 59 | /** |
||
| 60 | * The title. |
||
| 61 | * |
||
| 62 | * @var string |
||
| 63 | */ |
||
| 64 | public $name = 'Font Awesome'; |
||
| 65 | |||
| 66 | /** |
||
| 67 | * Holds the settings values. |
||
| 68 | * |
||
| 69 | * @var array |
||
| 70 | */ |
||
| 71 | private $settings; |
||
| 72 | |||
| 73 | /** |
||
| 74 | * WP_Font_Awesome_Settings instance. |
||
| 75 | * |
||
| 76 | * @access private |
||
| 77 | * @since 1.0.0 |
||
| 78 | * @var WP_Font_Awesome_Settings There can be only one! |
||
| 79 | */ |
||
| 80 | private static $instance = null; |
||
| 81 | |||
| 82 | /** |
||
| 83 | * Main WP_Font_Awesome_Settings Instance. |
||
| 84 | * |
||
| 85 | * Ensures only one instance of WP_Font_Awesome_Settings is loaded or can be loaded. |
||
| 86 | * |
||
| 87 | * @since 1.0.0 |
||
| 88 | * @static |
||
| 89 | * @return WP_Font_Awesome_Settings - Main instance. |
||
| 90 | */ |
||
| 91 | public static function instance() { |
||
| 107 | } |
||
| 108 | |||
| 109 | /** |
||
| 110 | * Initiate the settings and add the required action hooks. |
||
| 111 | * |
||
| 112 | * @since 1.0.8 Settings name wrong - FIXED |
||
| 113 | */ |
||
| 114 | public function init() { |
||
| 115 | $this->settings = $this->get_settings(); |
||
| 116 | |||
| 117 | // check if the official plugin is active and use that instead if so. |
||
| 118 | if ( ! defined( 'FONTAWESOME_PLUGIN_FILE' ) ) { |
||
| 119 | |||
| 120 | if ( $this->settings['type'] == 'CSS' ) { |
||
| 121 | |||
| 122 | if ( $this->settings['enqueue'] == '' || $this->settings['enqueue'] == 'frontend' ) { |
||
| 123 | add_action( 'wp_enqueue_scripts', array( $this, 'enqueue_style' ), 5000 ); |
||
| 124 | } |
||
| 125 | |||
| 126 | if ( $this->settings['enqueue'] == '' || $this->settings['enqueue'] == 'backend' ) { |
||
| 127 | add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_style' ), 5000 ); |
||
| 128 | } |
||
| 129 | |||
| 130 | } else { |
||
| 131 | |||
| 132 | if ( $this->settings['enqueue'] == '' || $this->settings['enqueue'] == 'frontend' ) { |
||
| 133 | add_action( 'wp_enqueue_scripts', array( $this, 'enqueue_scripts' ), 5000 ); |
||
| 134 | } |
||
| 135 | |||
| 136 | if ( $this->settings['enqueue'] == '' || $this->settings['enqueue'] == 'backend' ) { |
||
| 137 | add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_scripts' ), 5000 ); |
||
| 138 | } |
||
| 139 | } |
||
| 140 | |||
| 141 | // remove font awesome if set to do so |
||
| 142 | if ( $this->settings['dequeue'] == '1' ) { |
||
| 143 | add_action( 'clean_url', array( $this, 'remove_font_awesome' ), 5000, 3 ); |
||
| 144 | } |
||
| 145 | } |
||
| 146 | |||
| 147 | } |
||
| 148 | |||
| 149 | /** |
||
| 150 | * Adds the Font Awesome styles. |
||
| 151 | */ |
||
| 152 | public function enqueue_style() { |
||
| 153 | // build url |
||
| 154 | $url = $this->get_url(); |
||
| 155 | |||
| 156 | wp_deregister_style( 'font-awesome' ); // deregister in case its already there |
||
| 157 | wp_register_style( 'font-awesome', $url, array(), null ); |
||
| 158 | wp_enqueue_style( 'font-awesome' ); |
||
| 159 | |||
| 160 | // RTL language support CSS. |
||
| 161 | if ( is_rtl() ) { |
||
| 162 | wp_add_inline_style( 'font-awesome', $this->rtl_inline_css() ); |
||
| 163 | } |
||
| 164 | |||
| 165 | if ( $this->settings['shims'] ) { |
||
| 166 | $url = $this->get_url( true ); |
||
| 167 | wp_deregister_style( 'font-awesome-shims' ); // deregister in case its already there |
||
| 168 | wp_register_style( 'font-awesome-shims', $url, array(), null ); |
||
| 169 | wp_enqueue_style( 'font-awesome-shims' ); |
||
| 170 | } |
||
| 171 | } |
||
| 172 | |||
| 173 | /** |
||
| 174 | * Adds the Font Awesome JS. |
||
| 175 | */ |
||
| 176 | public function enqueue_scripts() { |
||
| 177 | // build url |
||
| 178 | $url = $this->get_url(); |
||
| 179 | |||
| 180 | $deregister_function = 'wp' . '_' . 'deregister' . '_' . 'script'; |
||
| 181 | call_user_func( $deregister_function, 'font-awesome' ); // deregister in case its already there |
||
| 182 | wp_register_script( 'font-awesome', $url, array(), null ); |
||
| 183 | wp_enqueue_script( 'font-awesome' ); |
||
| 184 | |||
| 185 | if ( $this->settings['shims'] ) { |
||
| 186 | $url = $this->get_url( true ); |
||
| 187 | call_user_func( $deregister_function, 'font-awesome-shims' ); // deregister in case its already there |
||
| 188 | wp_register_script( 'font-awesome-shims', $url, array(), null ); |
||
| 189 | wp_enqueue_script( 'font-awesome-shims' ); |
||
| 190 | } |
||
| 191 | } |
||
| 192 | |||
| 193 | /** |
||
| 194 | * Get the url of the Font Awesome files. |
||
| 195 | * |
||
| 196 | * @param bool $shims If this is a shim file or not. |
||
| 197 | * |
||
| 198 | * @return string The url to the file. |
||
| 199 | */ |
||
| 200 | public function get_url( $shims = false ) { |
||
| 224 | } |
||
| 225 | |||
| 226 | /** |
||
| 227 | * Try and remove any other versions of Font Awesome added by other plugins/themes. |
||
| 228 | * |
||
| 229 | * Uses the clean_url filter to try and remove any other Font Awesome files added, it can also add pseudo-elements flag for the JS version. |
||
| 230 | * |
||
| 231 | * @param $url |
||
| 232 | * @param $original_url |
||
| 233 | * @param $_context |
||
| 234 | * |
||
| 235 | * @return string The filtered url. |
||
| 236 | */ |
||
| 237 | public function remove_font_awesome( $url, $original_url, $_context ) { |
||
| 259 | } |
||
| 260 | |||
| 261 | /** |
||
| 262 | * Register the database settings with WordPress. |
||
| 263 | */ |
||
| 264 | public function register_settings() { |
||
| 265 | register_setting( 'wp-font-awesome-settings', 'wp-font-awesome-settings' ); |
||
| 266 | } |
||
| 267 | |||
| 268 | /** |
||
| 269 | * Add the WordPress settings menu item. |
||
| 270 | * @since 1.0.10 Calling function name direct will fail theme check so we don't. |
||
| 271 | */ |
||
| 272 | public function menu_item() { |
||
| 273 | $menu_function = 'add' . '_' . 'options' . '_' . 'page'; // won't pass theme check if function name present in theme |
||
| 274 | call_user_func( $menu_function, $this->name, $this->name, 'manage_options', 'wp-font-awesome-settings', array( |
||
| 275 | $this, |
||
| 276 | 'settings_page' |
||
| 277 | ) ); |
||
| 278 | } |
||
| 279 | |||
| 280 | /** |
||
| 281 | * Get the current Font Awesome output settings. |
||
| 282 | * |
||
| 283 | * @return array The array of settings. |
||
| 284 | */ |
||
| 285 | public function get_settings() { |
||
| 286 | |||
| 287 | $db_settings = get_option( 'wp-font-awesome-settings' ); |
||
| 288 | |||
| 289 | $defaults = array( |
||
| 290 | 'type' => 'CSS', // type to use, CSS or JS or KIT |
||
| 291 | 'version' => '', // latest |
||
| 292 | 'enqueue' => '', // front and backend |
||
| 293 | 'shims' => '0', // default OFF now in 2020 |
||
| 294 | 'js-pseudo' => '0', // if the pseudo elements flag should be set (CPU intensive) |
||
| 295 | 'dequeue' => '0', // if we should try to remove other versions added by other plugins/themes |
||
| 296 | 'pro' => '0', // if pro CDN url should be used |
||
| 297 | 'kit-url' => '', // the kit url |
||
| 298 | ); |
||
| 299 | |||
| 300 | $settings = wp_parse_args( $db_settings, $defaults ); |
||
|
|
|||
| 301 | |||
| 302 | /** |
||
| 303 | * Filter the Font Awesome settings. |
||
| 304 | * |
||
| 305 | * @todo if we add this filer people might use it and then it defeates the purpose of this class :/ |
||
| 306 | */ |
||
| 307 | return $this->settings = apply_filters( 'wp-font-awesome-settings', $settings, $db_settings, $defaults ); |
||
| 308 | } |
||
| 309 | |||
| 310 | |||
| 311 | /** |
||
| 312 | * The settings page html output. |
||
| 313 | */ |
||
| 314 | public function settings_page() { |
||
| 315 | if ( ! current_user_can( 'manage_options' ) ) { |
||
| 316 | wp_die( __( 'You do not have sufficient permissions to access this page.', 'font-awesome-settings' ) ); |
||
| 317 | } |
||
| 318 | |||
| 319 | // a hidden way to force the update of the version number via api instead of waiting the 48 hours |
||
| 320 | if ( isset( $_REQUEST['force-version-check'] ) ) { |
||
| 321 | $this->get_latest_version( $force_api = true ); |
||
| 322 | } |
||
| 323 | |||
| 324 | if ( ! defined( 'FONTAWESOME_PLUGIN_FILE' ) ) { |
||
| 325 | ?> |
||
| 326 | <style> |
||
| 327 | .wpfas-kit-show { |
||
| 328 | display: none; |
||
| 329 | } |
||
| 330 | |||
| 331 | .wpfas-kit-set .wpfas-kit-hide { |
||
| 332 | display: none; |
||
| 333 | } |
||
| 334 | |||
| 335 | .wpfas-kit-set .wpfas-kit-show { |
||
| 336 | display: table-row; |
||
| 337 | } |
||
| 338 | </style> |
||
| 339 | <div class="wrap"> |
||
| 340 | <h1><?php echo $this->name; ?></h1> |
||
| 341 | <form method="post" action="options.php" class="fas-settings-form"> |
||
| 342 | <?php |
||
| 343 | settings_fields( 'wp-font-awesome-settings' ); |
||
| 344 | do_settings_sections( 'wp-font-awesome-settings' ); |
||
| 345 | $kit_set = $this->settings['type'] == 'KIT' ? 'wpfas-kit-set' : ''; |
||
| 346 | ?> |
||
| 347 | <table class="form-table wpfas-table-settings <?php echo esc_attr( $kit_set ); ?>"> |
||
| 348 | <tr valign="top"> |
||
| 349 | <th scope="row"><label |
||
| 350 | for="wpfas-type"><?php _e( 'Type', 'font-awesome-settings' ); ?></label></th> |
||
| 351 | <td> |
||
| 352 | <select name="wp-font-awesome-settings[type]" id="wpfas-type" |
||
| 353 | onchange="if(this.value=='KIT'){jQuery('.wpfas-table-settings').addClass('wpfas-kit-set');}else{jQuery('.wpfas-table-settings').removeClass('wpfas-kit-set');}"> |
||
| 354 | <option |
||
| 355 | value="CSS" <?php selected( $this->settings['type'], 'CSS' ); ?>><?php _e( 'CSS (default)', 'font-awesome-settings' ); ?></option> |
||
| 356 | <option value="JS" <?php selected( $this->settings['type'], 'JS' ); ?>>JS</option> |
||
| 357 | <option |
||
| 358 | value="KIT" <?php selected( $this->settings['type'], 'KIT' ); ?>><?php _e( 'Kits (settings managed on fontawesome.com)', 'font-awesome-settings' ); ?></option> |
||
| 359 | </select> |
||
| 360 | </td> |
||
| 361 | </tr> |
||
| 362 | |||
| 363 | <tr valign="top" class="wpfas-kit-show"> |
||
| 364 | <th scope="row"><label |
||
| 365 | for="wpfas-kit-url"><?php _e( 'Kit URL', 'font-awesome-settings' ); ?></label></th> |
||
| 366 | <td> |
||
| 367 | <input class="regular-text" id="wpfas-kit-url" type="url" |
||
| 368 | name="wp-font-awesome-settings[kit-url]" |
||
| 369 | value="<?php echo esc_attr( $this->settings['kit-url'] ); ?>" |
||
| 370 | placeholder="<?php echo 'https://kit.font';echo 'awesome.com/123abc.js'; // this won't pass theme check :(?>"/> |
||
| 371 | <span><?php |
||
| 372 | echo sprintf( |
||
| 373 | __( 'Requires a free account with Font Awesome. %sGet kit url%s', 'font-awesome-settings' ), |
||
| 374 | '<a rel="noopener noreferrer" target="_blank" href="https://fontawesome.com/kits"><i class="fas fa-external-link-alt"></i>', |
||
| 375 | '</a>' |
||
| 376 | ); |
||
| 377 | ?></span> |
||
| 378 | </td> |
||
| 379 | </tr> |
||
| 380 | |||
| 381 | <tr valign="top" class="wpfas-kit-hide"> |
||
| 382 | <th scope="row"><label |
||
| 383 | for="wpfas-version"><?php _e( 'Version', 'font-awesome-settings' ); ?></label></th> |
||
| 384 | <td> |
||
| 385 | <select name="wp-font-awesome-settings[version]" id="wpfas-version"> |
||
| 386 | <option |
||
| 387 | value="" <?php selected( $this->settings['version'], '' ); ?>><?php echo sprintf( __( 'Latest - %s (default)', 'font-awesome-settings' ), $this->get_latest_version() ); ?> |
||
| 388 | </option> |
||
| 389 | <option value="6.1.0" <?php selected( $this->settings['version'], '6.1.0' ); ?>> |
||
| 390 | 6.1.0 |
||
| 391 | </option> |
||
| 392 | <option value="6.0.0" <?php selected( $this->settings['version'], '6.0.0' ); ?>> |
||
| 393 | 6.0.0 |
||
| 394 | </option> |
||
| 395 | <option value="5.15.4" <?php selected( $this->settings['version'], '5.15.4' ); ?>> |
||
| 396 | 5.15.4 |
||
| 397 | </option> |
||
| 398 | <option value="5.6.0" <?php selected( $this->settings['version'], '5.6.0' ); ?>> |
||
| 399 | 5.6.0 |
||
| 400 | </option> |
||
| 401 | <option value="5.5.0" <?php selected( $this->settings['version'], '5.5.0' ); ?>> |
||
| 402 | 5.5.0 |
||
| 403 | </option> |
||
| 404 | <option value="5.4.0" <?php selected( $this->settings['version'], '5.4.0' ); ?>> |
||
| 405 | 5.4.0 |
||
| 406 | </option> |
||
| 407 | <option value="5.3.0" <?php selected( $this->settings['version'], '5.3.0' ); ?>> |
||
| 408 | 5.3.0 |
||
| 409 | </option> |
||
| 410 | <option value="5.2.0" <?php selected( $this->settings['version'], '5.2.0' ); ?>> |
||
| 411 | 5.2.0 |
||
| 412 | </option> |
||
| 413 | <option value="5.1.0" <?php selected( $this->settings['version'], '5.1.0' ); ?>> |
||
| 414 | 5.1.0 |
||
| 415 | </option> |
||
| 416 | <option value="4.7.0" <?php selected( $this->settings['version'], '4.7.0' ); ?>> |
||
| 417 | 4.7.1 (CSS only) |
||
| 418 | </option> |
||
| 419 | </select> |
||
| 420 | </td> |
||
| 421 | </tr> |
||
| 422 | |||
| 423 | <tr valign="top"> |
||
| 424 | <th scope="row"><label |
||
| 425 | for="wpfas-enqueue"><?php _e( 'Enqueue', 'font-awesome-settings' ); ?></label></th> |
||
| 426 | <td> |
||
| 427 | <select name="wp-font-awesome-settings[enqueue]" id="wpfas-enqueue"> |
||
| 428 | <option |
||
| 429 | value="" <?php selected( $this->settings['enqueue'], '' ); ?>><?php _e( 'Frontend + Backend (default)', 'font-awesome-settings' ); ?></option> |
||
| 430 | <option |
||
| 431 | value="frontend" <?php selected( $this->settings['enqueue'], 'frontend' ); ?>><?php _e( 'Frontend', 'font-awesome-settings' ); ?></option> |
||
| 432 | <option |
||
| 433 | value="backend" <?php selected( $this->settings['enqueue'], 'backend' ); ?>><?php _e( 'Backend', 'font-awesome-settings' ); ?></option> |
||
| 434 | </select> |
||
| 435 | </td> |
||
| 436 | </tr> |
||
| 437 | |||
| 438 | <tr valign="top" class="wpfas-kit-hide"> |
||
| 439 | <th scope="row"><label |
||
| 440 | for="wpfas-pro"><?php _e( 'Enable pro', 'font-awesome-settings' ); ?></label></th> |
||
| 441 | <td> |
||
| 442 | <input type="hidden" name="wp-font-awesome-settings[pro]" value="0"/> |
||
| 443 | <input type="checkbox" name="wp-font-awesome-settings[pro]" |
||
| 444 | value="1" <?php checked( $this->settings['pro'], '1' ); ?> id="wpfas-pro"/> |
||
| 445 | <span><?php |
||
| 446 | echo sprintf( |
||
| 447 | __( 'Requires a subscription. %sLearn more%s %sManage my allowed domains%s', 'font-awesome-settings' ), |
||
| 448 | '<a rel="noopener noreferrer" target="_blank" href="https://fontawesome.com/referral?a=c9b89e1418">', |
||
| 449 | ' <i class="fas fa-external-link-alt"></i></a>', |
||
| 450 | '<a rel="noopener noreferrer" target="_blank" href="https://fontawesome.com/account/cdn">', |
||
| 451 | ' <i class="fas fa-external-link-alt"></i></a>' |
||
| 452 | ); |
||
| 453 | ?></span> |
||
| 454 | </td> |
||
| 455 | </tr> |
||
| 456 | |||
| 457 | <tr valign="top" class="wpfas-kit-hide"> |
||
| 458 | <th scope="row"><label |
||
| 459 | for="wpfas-shims"><?php _e( 'Enable v4 shims compatibility', 'font-awesome-settings' ); ?></label> |
||
| 460 | </th> |
||
| 461 | <td> |
||
| 462 | <input type="hidden" name="wp-font-awesome-settings[shims]" value="0"/> |
||
| 463 | <input type="checkbox" name="wp-font-awesome-settings[shims]" |
||
| 464 | value="1" <?php checked( $this->settings['shims'], '1' ); ?> id="wpfas-shims"/> |
||
| 465 | <span><?php _e( 'This enables v4 classes to work with v5, sort of like a band-aid until everyone has updated everything to v5.', 'font-awesome-settings' ); ?></span> |
||
| 466 | </td> |
||
| 467 | </tr> |
||
| 468 | |||
| 469 | <tr valign="top" class="wpfas-kit-hide"> |
||
| 470 | <th scope="row"><label |
||
| 471 | for="wpfas-js-pseudo"><?php _e( 'Enable JS pseudo elements (not recommended)', 'font-awesome-settings' ); ?></label> |
||
| 472 | </th> |
||
| 473 | <td> |
||
| 474 | <input type="hidden" name="wp-font-awesome-settings[js-pseudo]" value="0"/> |
||
| 475 | <input type="checkbox" name="wp-font-awesome-settings[js-pseudo]" |
||
| 476 | value="1" <?php checked( $this->settings['js-pseudo'], '1' ); ?> |
||
| 477 | id="wpfas-js-pseudo"/> |
||
| 478 | <span><?php _e( 'Used only with the JS version, this will make pseudo-elements work but can be CPU intensive on some sites.', 'font-awesome-settings' ); ?></span> |
||
| 479 | </td> |
||
| 480 | </tr> |
||
| 481 | |||
| 482 | <tr valign="top"> |
||
| 483 | <th scope="row"><label |
||
| 484 | for="wpfas-dequeue"><?php _e( 'Dequeue', 'font-awesome-settings' ); ?></label></th> |
||
| 485 | <td> |
||
| 486 | <input type="hidden" name="wp-font-awesome-settings[dequeue]" value="0"/> |
||
| 487 | <input type="checkbox" name="wp-font-awesome-settings[dequeue]" |
||
| 488 | value="1" <?php checked( $this->settings['dequeue'], '1' ); ?> |
||
| 489 | id="wpfas-dequeue"/> |
||
| 490 | <span><?php _e( 'This will try to dequeue any other Font Awesome versions loaded by other sources if they are added with `font-awesome` or `fontawesome` in the name.', 'font-awesome-settings' ); ?></span> |
||
| 491 | </td> |
||
| 492 | </tr> |
||
| 493 | |||
| 494 | </table> |
||
| 495 | <div class="fas-buttons"> |
||
| 496 | <?php |
||
| 497 | submit_button(); |
||
| 498 | ?> |
||
| 499 | <p class="submit"><a href="https://fontawesome.com/referral?a=c9b89e1418" class="button button-secondary"><?php _e('Get 14,000+ more icons with Font Awesome Pro','font-awesome-settings'); ?> <i class="fas fa-external-link-alt"></i></a></p> |
||
| 500 | |||
| 501 | </div> |
||
| 502 | </form> |
||
| 503 | |||
| 504 | <div id="wpfas-version"><?php echo sprintf(__( 'Version: %s (affiliate links provided)', 'font-awesome-settings' ), $this->version ); ?></div> |
||
| 505 | </div> |
||
| 506 | |||
| 507 | <style> |
||
| 508 | .fas-settings-form .submit{ |
||
| 509 | display: inline; |
||
| 510 | padding-right: 5px; |
||
| 511 | } |
||
| 512 | |||
| 513 | .fas-settings-form .fas-buttons{ |
||
| 514 | margin: 15px 0; |
||
| 515 | } |
||
| 516 | #wpfas-version{ |
||
| 517 | margin-top: 30px; |
||
| 518 | color: #646970; |
||
| 519 | } |
||
| 520 | </style> |
||
| 521 | <?php |
||
| 522 | } |
||
| 523 | } |
||
| 524 | |||
| 525 | /** |
||
| 526 | * Check a version number is valid and if so return it or else return an empty string. |
||
| 527 | * |
||
| 528 | * @param $version string The version number to check. |
||
| 529 | * |
||
| 530 | * @since 1.0.6 |
||
| 531 | * |
||
| 532 | * @return string Either a valid version number or an empty string. |
||
| 533 | */ |
||
| 534 | public function validate_version_number( $version ) { |
||
| 535 | |||
| 536 | if ( version_compare( $version, '0.0.1', '>=' ) >= 0 ) { |
||
| 537 | // valid |
||
| 538 | } else { |
||
| 539 | $version = '';// not validated |
||
| 540 | } |
||
| 541 | |||
| 542 | return $version; |
||
| 543 | } |
||
| 544 | |||
| 545 | |||
| 546 | /** |
||
| 547 | * Get the latest version of Font Awesome. |
||
| 548 | * |
||
| 549 | * We check for a cached version and if none we will check for a live version via API and then cache it for 48 hours. |
||
| 550 | * |
||
| 551 | * @since 1.0.7 |
||
| 552 | * @return mixed|string The latest version number found. |
||
| 553 | */ |
||
| 554 | public function get_latest_version( $force_api = false ) { |
||
| 555 | $latest_version = $this->latest; |
||
| 556 | |||
| 557 | $cache = get_transient( 'wp-font-awesome-settings-version' ); |
||
| 558 | |||
| 559 | if ( $cache === false || $force_api ) { // its not set |
||
| 560 | $api_ver = $this->get_latest_version_from_api(); |
||
| 561 | if ( version_compare( $api_ver, $this->latest, '>=' ) >= 0 ) { |
||
| 562 | $latest_version = $api_ver; |
||
| 563 | set_transient( 'wp-font-awesome-settings-version', $api_ver, 48 * HOUR_IN_SECONDS ); |
||
| 564 | } |
||
| 565 | } elseif ( $this->validate_version_number( $cache ) ) { |
||
| 566 | if ( version_compare( $cache, $this->latest, '>=' ) >= 0 ) { |
||
| 567 | $latest_version = $cache; |
||
| 568 | } |
||
| 569 | } |
||
| 570 | |||
| 571 | return $latest_version; |
||
| 572 | } |
||
| 573 | |||
| 574 | /** |
||
| 575 | * Get the latest Font Awesome version from the github API. |
||
| 576 | * |
||
| 577 | * @since 1.0.7 |
||
| 578 | * @return string The latest version number or `0` on API fail. |
||
| 579 | */ |
||
| 580 | public function get_latest_version_from_api() { |
||
| 581 | $version = "0"; |
||
| 582 | $response = wp_remote_get( "https://api.github.com/repos/FortAwesome/Font-Awesome/releases/latest" ); |
||
| 583 | if ( ! is_wp_error( $response ) && is_array( $response ) ) { |
||
| 584 | $api_response = json_decode( wp_remote_retrieve_body( $response ), true ); |
||
| 585 | if ( isset( $api_response['tag_name'] ) && version_compare( $api_response['tag_name'], $this->latest, '>=' ) >= 0 && empty( $api_response['prerelease'] ) ) { |
||
| 586 | $version = $api_response['tag_name']; |
||
| 587 | } |
||
| 588 | } |
||
| 589 | |||
| 590 | return $version; |
||
| 591 | } |
||
| 592 | |||
| 593 | /** |
||
| 594 | * Inline CSS for RTL language support. |
||
| 595 | * |
||
| 596 | * @since 1.0.13 |
||
| 597 | * @return string Inline CSS. |
||
| 598 | */ |
||
| 599 | public function rtl_inline_css() { |
||
| 603 | } |
||
| 604 | |||
| 605 | /** |
||
| 606 | * Show any warnings as an admin notice. |
||
| 607 | * |
||
| 608 | * @return void |
||
| 609 | */ |
||
| 610 | public function admin_notices(){ |
||
| 630 | </div> |
||
| 631 | <?php |
||
| 632 | } |
||
| 633 | } |
||
| 634 | } |
||
| 635 | |||
| 636 | } |
||
| 637 | |||
| 638 | } |
||
| 639 | |||
| 644 | } |