Changeset 10815 for sites/trunk/wordpress.org/public_html/wp-content/plugins/handbook/inc/importer.php

Timestamp:

03/11/2021 11:48:52 PM (4 years ago)

Author:

coffee2code

Message:

Handbooks, Importer: Assign 'wordpressdotorg' as the default post author for all imported posts, if it exists.

Also adds handbooks_import_default_author_slug filter to customize or disable the default post author.

File:

• sites/trunk/wordpress.org/public_html/wp-content/plugins/handbook/inc/importer.php (modified) (3 diffs)

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

@@ -19 +19 @@
 
     /**
+     * Memoized user ID of default import post author.
+     *
+     * @var int
+     */
+    protected static $import_user_id;
+
+    /**
      * The slug base.
      *
@@ -118 +125 @@
         add_action( "handbook_{$post_type_base}_import_all_markdown", [ $this, 'import_all_markdown' ] );
         add_filter( 'display_post_states',                            [ $this, 'display_post_states' ], 10, 2 );
+        add_filter( 'wporg_markdown_post_data_pre_insert',            [ $this, 'assign_post_author' ] );
 
         $editor = new Editor( $this );
@@ -190 +198 @@
 
     /**
+     * Adds user as the default post author for imported posts that don't have
+     * a post author already assigned.
+     *
+     * By default, assigns all imported posts to the 'wordpressdotorg' user if
+     * it exists. Use {@see 'handbooks_import_default_author_slug'} to filter
+     * the default imported post author. Otherwise, no post author is assigned.
+     *
+     * @param array $post_data Post data.
+     * @return array
+     */
+    public static function assign_post_author( $post_data ) {
+        // Bail early if the post already has a post author specified.
+        if ( isset( $post_data['post_author'] ) ) {
+            return $post_data;
+        }
+
+        // Get the default import author if not already memoized.
+        if ( ! self::$import_user_id ) {
+            /**
+             * Filters the slug of the user to be assigned as the post
+             * author for all imported posts.
+             *
+             * @param string $slug Slug of user to assign as imported post author.
+             *                     Use empty string or false to prevent a post author
+             *                     from being assigned. Default 'wordpressdotorg'.
+             * @return string
+             */
+            $default_user_slug = apply_filters( 'handbooks_import_default_author_slug', 'wordpressdotorg' );
+
+            if ( $default_user_slug ) {
+                $user = get_user_by( 'slug', $default_user_slug );
+                if ( $user ) {
+                    self::$import_user_id = $user->ID;
+                }
+            }
+        }
+
+        // Add the default import author if it was found.
+        if ( self::$import_user_id ) {
+            $post_data['post_author'] = self::$import_user_id;
+        }
+
+        return $post_data;
+    }
+
+    /**
      * Indicates if the specified handbook is imported.
      *