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

Timestamp:

03/11/2021 11:48:52 PM (5 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.
          *