Ticket #7143: 7143-missed-hooks.diff

src/bp-blogs/bp-blogs-activity.php

@@ -624 +624 @@
         if ( ! $is_private && ! $no_activity && bp_blogs_is_blog_trackable( $recorded_blog->blog_id, $recorded_blog->user_id ) ) {
                 bp_blogs_record_activity( array(
                         'user_id'      => $recorded_blog->user_id,
+
+                        /**
+                         * Filters the activity created blog primary link.
+                         *
+                         * @since 1.1.0
+                         *
+                         * @param string $value Blog primary link.
+                         * @param int    $value Blog ID.
+                         */
                         'primary_link' => apply_filters( 'bp_blogs_activity_created_blog_primary_link', bp_blogs_get_blogmeta( $recorded_blog->blog_id, 'url' ), $recorded_blog->blog_id ),
                         'type'         => 'new_blog',
                         'item_id'      => $recorded_blog->blog_id

src/bp-blogs/bp-blogs-functions.php

@@ -65 +65 @@
                 $r['include_blog_ids']
         );
 
-        // Filter and return.
+        /**
+         * Filters a set of blogs.
+         *
+         * @since 1.2.0
+         *
+         * @param array $blogs Array of blog data.
+         * @param array $r     Parsed query arguments.
+         */
         return apply_filters( 'bp_blogs_get_blogs', $blogs, $r );
 }
 
@@ -246 +253 @@
  */
 function bp_blogs_is_blog_recordable( $blog_id, $user_id = 0 ) {
 
+        /**
+         * Filters whether or not a blog is globally activity stream recordable.
+         *
+         * @since 1.7.0
+         *
+         * @param bool $value   Whether or not recordable. Default true.
+         * @param int  $blog_id Current blog ID.
+         */
         $recordable_globally = apply_filters( 'bp_blogs_is_blog_recordable', true, $blog_id );
 
         if ( !empty( $user_id ) ) {
+                /**
+                 * Filters whether or not a blog is globally activity stream recordable for user.
+                 *
+                 * @since 1.7.0
+                 *
+                 * @param bool $recordable_globally Whether or not recordable.
+                 * @param int  $blog_id             Current blog ID.
+                 * @param int  $user_id             Current user ID.
+                 */
                 $recordable_for_user = apply_filters( 'bp_blogs_is_blog_recordable_for_user', $recordable_globally, $blog_id, $user_id );
         } else {
                 $recordable_for_user = $recordable_globally;
@@ -275 +299 @@
  */
 function bp_blogs_is_blog_trackable( $blog_id, $user_id = 0 ) {
 
+        /**
+         * Filters whether or not a blog is globally trackable.
+         *
+         * @since 1.7.0
+         *
+         * @param bool $value Whether or not trackable.
+         * @param int  $blog_id Current blog ID.
+         */
         $trackable_globally = apply_filters( 'bp_blogs_is_blog_trackable', bp_blogs_is_blog_recordable( $blog_id, $user_id ), $blog_id );
 
         if ( !empty( $user_id ) ) {
+
+                /**
+                 * Filters whether or not a blog is globally trackable for user.
+                 *
+                 * @since 1.7.0
+                 *
+                 * @param bool $value   Whether or not trackable.
+                 * @param int  $blog_id Current blog ID.
+                 * @param int  $user_id Current user ID.
+                 */
                 $trackable_for_user = apply_filters( 'bp_blogs_is_blog_trackable_for_user', $trackable_globally, $blog_id, $user_id );
         } else {
                 $trackable_for_user = $trackable_globally;
@@ -344 +386 @@
         bp_blogs_update_blogmeta( $recorded_blog->blog_id, 'thread_comments_depth', $thread_depth );
 
         $is_private = !empty( $_POST['blog_public'] ) && (int) $_POST['blog_public'] ? false : true;
+
+        /**
+         * Filters whether or not a new blog is public.
+         *
+         * @since 1.5.0
+         *
+         * @param bool $is_private Whether or not blog is public.
+         */
         $is_private = !apply_filters( 'bp_is_new_blog_public', !$is_private );
 
         /**
@@ -844 +894 @@
  * @return string
  */
 function bp_blogs_get_allowed_roles() {
+
+        /**
+         * Filters the allowed roles a member must have to be recorded into bp_user_blogs pointer table.
+         *
+         * @since 2.1.0
+         *
+         * @param array $value Array of potential roles user needs.
+         */
         return apply_filters( 'bp_blogs_get_allowed_roles', array( 'contributor', 'author', 'editor', 'administrator' ) );
 }
 

src/bp-blogs/bp-blogs-template.php

@@ -645 +645 @@
                 /**
                  * Filters the last active date of the current blog in the loop.
                  *
-                 * @since
+                 * @since 1.2.0
                  *
                  * @param string $last_activity Last active date.
                  * @param array  $r             Array of parsed args used to determine formatting.
@@ -1402 +1402 @@
 
                 $output = '<li id="blog-create-nav">' . $create_blog_button . '</li>';
 
+                /**
+                 * Filters the Create A Site nav item output.
+                 *
+                 * @since 2.2.0
+                 *
+                 * @param string $output Nav item output.
+                 */
                 return apply_filters( 'bp_get_blog_create_nav_item', $output );
         }
 

src/bp-blogs/classes/class-bp-blogs-blog.php

@@ -75 +75 @@
         public function save() {
                 global $wpdb;
 
+                /**
+                 * Filters the blog user ID before save.
+                 *
+                 * @since 1.0.0
+                 *
+                 * @param int $value User ID.
+                 * @param int $value Site ID.
+                 */
                 $this->user_id = apply_filters( 'bp_blogs_blog_user_id_before_save', $this->user_id, $this->id );
+
+                /**
+                 * Filters the blog blog ID before save.
+                 *
+                 * @since 1.0.0
+                 *
+                 * @param int $value Blog ID.
+                 * @param int $value Site ID.
+                 */
                 $this->blog_id = apply_filters( 'bp_blogs_blog_id_before_save', $this->blog_id, $this->id );
 
                 /**