- Extend [publishpress_authors_data] shortcode to return authors user object publishpress#697

Author: ojopaul

src/core/Plugin.php

@@ -1753,9 +1753,10 @@ public function shortcodeAuthorsBox($attributes)
      */
     public function shortcodeAuthorsData($attributes)
     {
-        $field      = 'display_name';
-        $post_id   = false;
-        $separator = ',';
+        $field         = 'display_name';
+        $post_id      = false;
+        $separator    = ',';
+        $user_objects = false;
 
 
         if (isset($attributes['post_id'])) {
@@ -1772,7 +1773,11 @@ public function shortcodeAuthorsData($attributes)
             $field = $attributes['field'];
         }
 
-        return $this->get_authors_data($post_id, $field, $separator);
+        if (isset($attributes['user_objects'])) {
+            $user_objects = $attributes['user_objects'] === 'true' || (int)$attributes['user_objects'] === 1;
+        }
+
+        return $this->get_authors_data($post_id, $field, $separator, $user_objects);
     }
 
     /**

src/core/Traits/Author_box.php

@@ -270,13 +270,15 @@ protected function get_author_box_markup(
      * @param int $post_id
      * @param string $field
      * @param mixed $separator
+     * @param mixed $user_objects
      *
      * @return string
      */
     protected function get_authors_data(
         $post_id = false,
         $field = 'display_name',
-        $separator = ','
+        $separator = ',',
+        $user_objects = false
     ) {
         global $post;
 
@@ -294,13 +296,16 @@ protected function get_authors_data(
 
         $authors = get_post_authors($post_id, true, false);
 
-        if (!empty($authors)) {
-            foreach ($authors as $author) {
-                $author = Author::get_by_term_id($author->term_id);
-                $output[] = isset($author->$field) ? $author->$field : $author->display_name;
+        if (!$user_objects) {
+            if (!empty($authors)) {
+                foreach ($authors as $author) {
+                    $output[] = isset($author->$field) ? $author->$field : $author->display_name;
+                }
             }
+            $output  = array_filter($output);
+            $authors = join($separator, $output);
         }
 
-        return join($separator, $output);
+        return $authors;
     }
 }

src/modules/multiple-authors/multiple-authors.php

@@ -901,6 +901,18 @@ private function settings_ppma_shortcodes($shortcodes = []) {
                             'publishpress-authors'
                         ),
                     ],
+                    'option_5' => [
+                        'shortcode'   => '[publishpress_authors_data user_objects="true"]',
+                        'description' => sprintf(
+                            esc_html__(
+                                'You can also decide to return array lists of authors for custom use or formatting by using %1s which will return all authors object data as array. You can check full details and sample usage %2s in this guide %3s',
+                                'publishpress-authors'
+                            ),
+                            '<code class="color-red">user_objects="true"</code>',
+                            '<a href="https://publishpress.com/knowledge-base/authors-data-backup/">',
+                            '</a>'
+                        ),
+                    ],
                 ],
             ];