Changeset 10776

Timestamp:

03/05/2021 12:42:40 AM (4 years ago)

Author:

coffee2code

Message:

Handbooks, Admin Notices: Outputs notice atop imported handbook listing indicating that handbook is imported.

Also links to manifest and states import interval.

File:

• sites/trunk/wordpress.org/public_html/wp-content/plugins/handbook/inc/admin-notices.php (modified) (2 diffs)

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

@@ -15 +15 @@
     public static function init() {
         add_action( 'admin_notices', [ __CLASS__, 'show_new_handbook_message' ] );
+        add_action( 'admin_notices', [ __CLASS__, 'show_imported_handbook_notice' ] );
     }
 
@@ -61 +62 @@
     }
 
+    /**
+     * Outputs admin notice indicating the handbook is an imported handbook, if applicable.
+     *
+     * @access public
+     */
+    public static function show_imported_handbook_notice() {
+        global $wp_query;
+
+        // Bail if handbook importer is not available.
+        if ( ! class_exists( 'WPorg_Handbook_Importer' ) ) {
+            return;
+        }
+
+        $current_screen = get_current_screen();
+
+        // Only show message in listing of handbook posts when no posts are present yet.
+        if (
+            $current_screen
+        &&
+            'edit' === $current_screen->base
+        &&
+            in_array( $current_screen->post_type, wporg_get_handbook_post_types() )
+        &&
+            WPorg_Handbook_Importer::is_handbook_imported( $current_screen->post_type )
+        ) {
+            $handbook_config = WPorg_Handbook_Init::get_handbooks_config( $current_screen->post_type );
+
+            $handbook = WPorg_Handbook_Init::get_handbook( $current_screen->post_type );
+            if ( ! $handbook ) {
+                return;
+            }
+
+            $importer = $handbook->get_importer();
+            $interval = $importer ? $importer->get_cron_interval() : false;
+            $interval_display = ! empty( $interval['display'] ) ? strtolower( $interval['display'] ) : __( 'DISABLED', 'wporg' );
+
+            echo '<div class="notice notice-info"><p>';
+            printf(
+                /* translators: 1: URL to remote manifest. 2: cron interval. */
+                __( '<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' ),
+                $handbook_config['manifest'],
+                $interval_display
+            );
+            echo "</p></div>\n";
+        }
+    }
+
 }