WordPress.org
Get WordPress

Making WordPress.org


Ignore:
File:
1 edited

Legend:

Unmodified
Added
Removed

  • sites/trunk/wordpress.org/public_html/wp-content/plugins/handbook/inc/admin-notices.php

    r10836 r9636  
    99
    1010    /**
    11      * Initializes functionality.
     11     * Constructor.
    1212     *
    1313     * @access public
    1414     */
    15     public static function init() {
    16         add_action( 'admin_notices', [ __CLASS__, 'show_new_handbook_message' ] );
    17         add_action( 'admin_notices', [ __CLASS__, 'show_imported_handbook_notice' ] );
    18         add_action( 'admin_notices', [ __CLASS__, 'show_imported_handbook_config_errors' ] );
     15    public function __construct() {
     16        add_action( 'admin_notices', array( $this, 'show_new_handbook_message' ) );
    1917    }
    2018
    … …  
    2624     * @access public
    2725     */
    28     public static function show_new_handbook_message() {
     26    public function show_new_handbook_message() {
    2927        global $wp_query;
    3028
    … …  
    3331        // Only show message in listing of handbook posts when no posts are present yet.
    3432        if (
    35             $current_screen
    36         &&
    3733            'edit' === $current_screen->base
    3834        &&
    … …  
    4036        &&
    4137            0 === $wp_query->post_count
    42         &&
    43             ( empty( $wp_query->query_vars['post_status'] ) || 'publish' === $wp_query->query_vars['post_status'] )
    4438        ) {
    4539            echo '<div class="notice notice-success"><p>';
    46 
    47             $suggested_slugs = array_unique( [
    48                 str_replace( '-handbook', '', $current_screen->post_type ),
    49                 'welcome',
    50                 $current_screen->post_type,
    51                 'handbook',
    52             ] );
    53             $suggested_slugs = array_map( function( $x ) { return "<code>{$x}</code>"; }, $suggested_slugs );
    54 
    5540            printf(
    5641                /* translators: 1: example landing page title that includes post type name, 2: comma-separated list of acceptable post slugs */
    57                 __( '<strong>Welcome to your new handbook!</strong> It is recommended that the first post you create is the landing page for the handbook. You can title it anything you like (suggestions: <code>%1$s</code> or <code>Welcome</code>). However, you must ensure that it has one of the following slugs: %2$s. The slug will ultimately be omitted from the page&#8216;s permalink URL, but will still appear in the permalinks for sub-pages.', 'wporg' ),
     42                __( '<strong>Welcome to your new handbook!</strong> It is recommended that the first post you create is the landing page for the handbook. You can title it anything you like (suggestions: <code>%1$s</code> or <code>Welcome</code>). However, you must ensure that it has one of the following slugs: %2$s.', 'wporg' ),
    5843                WPorg_Handbook::get_name( $current_screen->post_type ),
    59                 implode( ', ', $suggested_slugs )
     44                '<code>' . str_replace( '-handbook', '', $current_screen->post_type ) . '</code>, <code>welcome</code>, <code>' . $current_screen->post_type . '</code>, <code>handbook</code>'
    6045            );
    6146            echo "</p></div>\n";
    … …  
    6348    }
    6449
    65     /**
    66      * Outputs admin notice indicating the handbook is an imported handbook, if applicable.
    67      *
    68      * @access public
    69      */
    70     public static function show_imported_handbook_notice() {
    71         global $wp_query;
    72 
    73         // Bail if handbook importer is not available.
    74         if ( ! class_exists( 'WPorg_Handbook_Importer' ) ) {
    75             return;
    76         }
    77 
    78         $current_screen = get_current_screen();
    79 
    80         // Only show message in listing of handbook posts when no posts are present yet.
    81         if (
    82             $current_screen
    83         &&
    84             'edit' === $current_screen->base
    85         &&
    86             in_array( $current_screen->post_type, wporg_get_handbook_post_types() )
    87         &&
    88             WPorg_Handbook_Importer::is_handbook_imported( $current_screen->post_type )
    89         ) {
    90             $handbook_config = WPorg_Handbook_Init::get_handbooks_config( $current_screen->post_type );
    91 
    92             $handbook = WPorg_Handbook_Init::get_handbook( $current_screen->post_type );
    93             if ( ! $handbook ) {
    94                 return;
    95             }
    96 
    97             $importer = $handbook->get_importer();
    98             $interval = $importer ? $importer->get_cron_interval( false ) : [];
    99             $interval_display = ! empty( $interval['display'] ) ? strtolower( $interval['display'] ) : __( 'DISABLED', 'wporg' );
    100 
    101             echo '<div class="notice notice-info"><p>';
    102             printf(
    103                 /* translators: 1: URL to remote manifest. 2: cron interval. */
    104                 __( '<strong>This is an imported handbook!</strong> This handbook is imported according to a <a href="%1$s">remote manifest</a>. Any local changes will be overwritten during the next import, so make any changes at the remote location. Import interval: <strong>%2$s</strong>.', 'wporg' ),
    105                 $handbook_config['manifest'],
    106                 $interval_display
    107             );
    108             echo "</p></div>\n";
    109         }
    110     }
    111 
    112     /**
    113      * Outputs admin error notice(s) for any misconfigured imported handbooks.
    114      *
    115      * @access public
    116      */
    117     public static function show_imported_handbook_config_errors() {
    118         global $wp_query;
    119 
    120         // Bail if handbook importer is not available.
    121         if ( ! class_exists( 'WPorg_Handbook_Importer' ) ) {
    122             return;
    123         }
    124 
    125         $current_screen = get_current_screen();
    126 
    127         // Only show message in listing of handbook posts when no posts are present yet.
    128         if (
    129             $current_screen
    130         &&
    131             'edit' === $current_screen->base
    132         &&
    133             in_array( $current_screen->post_type, wporg_get_handbook_post_types() )
    134         &&
    135             WPorg_Handbook_Importer::is_handbook_imported( $current_screen->post_type )
    136         ) {
    137             $handbook_config = WPorg_Handbook_Init::get_handbooks_config( $current_screen->post_type );
    138 
    139             $handbook = WPorg_Handbook_Init::get_handbook( $current_screen->post_type );
    140             if ( ! $handbook ) {
    141                 return;
    142             }
    143 
    144             $handbook_config = $handbook->get_config();
    145             $cron_intervals = wp_get_schedules();
    146             $interval_display = $handbook_config[ 'cron_interval' ] ?? '';
    147 
    148             if ( ! empty( $cron_intervals[ $interval_display ] ) ) {
    149                 return;
    150             }
    151 
    152             echo '<div class="notice notice-warning"><p>';
    153             printf(
    154                 /* translators: %s: cron interval. */
    155                 __( '<strong>Misconfigured cron interval!</strong> This imported handbook has a misconfigured cron interval. The config defines an interval of <strong>%s</strong>, which has not been defined. The fallback import interval shown in a notice above includes the default cron interval currently in use.', 'wporg' ),
    156                 $interval_display
    157             );
    158             echo "</p></div>\n";
    159         }
    160     }
    16150}
    16251
    163 add_action( 'plugins_loaded', [ 'WPorg_Handbook_Admin_Notices', 'init' ] );
     52$admin_notices = new WPorg_Handbook_Admin_Notices();
Note: See TracChangeset for help on using the changeset viewer.