[Summary view] [Print] [Text view]

   1  <?php
   2  /**
   3   * Deprecated functions
   4   *
   5   * @package BuddyPress
   6   * @subpackage Core
   7   * @deprecated 2.2.0
   8   */
   9  
  10  // Exit if accessed directly.
  11  defined( 'ABSPATH' ) || exit;
  12  
  13  /**
  14   * Detect a change in post status, and initiate an activity update if necessary.
  15   *
  16   * Posts get new activity updates when (a) they are being published, and (b)
  17   * they have not already been published. This enables proper posting for
  18   * regular posts as well as scheduled posts, while preventing post bumping.
  19   *
  20   * See #4090, #3746, #2546 for background.
  21   *
  22   * @since 2.0.0
  23   * @deprecated 2.2.0
  24   *
  25   * @todo Support untrashing better.
  26   *
  27   * @param string $new_status New status for the post.
  28   * @param string $old_status Old status for the post.
  29   * @param object $post Post data.
  30   */
  31  function bp_blogs_catch_transition_post_status( $new_status, $old_status, $post ) {
  32      _deprecated_function( __FUNCTION__, '2.2', 'bp_activity_catch_transition_post_type_status()' );
  33      bp_activity_catch_transition_post_type_status( $new_status, $old_status, $post );
  34  }
  35  
  36  /**
  37   * Record a new blog post in the BuddyPress activity stream.
  38   *
  39   * @deprecated 2.2.0
  40   *
  41   * @param int $post_id ID of the post being recorded.
  42   * @param object $post The WP post object passed to the 'save_post' action.
  43   * @param int $user_id Optional. The user to whom the activity item will be
  44   *        associated. Defaults to the post_author.
  45   * @return bool|null Returns false on failure.
  46   */
  47  function bp_blogs_record_post( $post_id, $post, $user_id = 0 ) {
  48      _deprecated_function( __FUNCTION__, '2.2', 'bp_activity_post_type_publish()' );
  49      bp_activity_post_type_publish( $post_id, $post, $user_id );
  50  }
  51  
  52  /**
  53   * Updates a blog post's corresponding activity entry during a post edit.
  54   *
  55   * @since 2.0.0
  56   * @deprecated 2.2.0
  57   *
  58   * @see bp_blogs_catch_transition_post_status()
  59   *
  60   * @param WP_Post $post
  61   */
  62  function bp_blogs_update_post( $post ) {
  63      _deprecated_function( __FUNCTION__, '2.2', 'bp_activity_post_type_update()' );
  64      bp_activity_post_type_update( $post );
  65  }
  66  
  67  /**
  68   * Clear cache when a new blog is created.
  69   *
  70   * @since 1.0.0
  71   * @deprecated 2.2.0
  72   *
  73   * @param BP_Blogs_Blog $recorded_blog_obj The recorded blog, passed by
  74   *        'bp_blogs_new_blog'.
  75   */
  76  function bp_blogs_format_clear_blog_cache( $recorded_blog_obj ) {
  77      _deprecated_function( __FUNCTION__, '2.2', 'bp_blogs_clear_blog_object_cache()' );
  78      bp_blogs_clear_blog_object_cache( false, $recorded_blog_obj->user_id );
  79  }
  80  
  81  /**
  82   * Format 'new_member' activity actions.
  83   *
  84   * @since 2.0.0
  85   * @deprecated 2.2.0
  86   *
  87   * @param string $action Static activity action.
  88   * @param object $activity Activity object.
  89   * @return string
  90   */
  91  function bp_xprofile_format_activity_action_new_member( $action, $activity ) {
  92      _deprecated_function( __FUNCTION__, '2.2', 'bp_members_format_activity_action_new_member()' );
  93  
  94      $action = apply_filters( 'bp_xprofile_format_activity_action_new_member', $action, $activity );
  95      return bp_members_format_activity_action_new_member( $action, $activity );
  96  }
  97  
  98  /**
  99   * Add 'bp' to global group of network wide catchable objects.
 100   *
 101   * @since 1.1.0
 102   * @deprecated 2.2.0
 103   */
 104  function bp_core_add_global_group() {
 105      _deprecated_function( __FUNCTION__, '2.2', 'This function has no replacement' );
 106  }
 107  
 108  /**
 109   * Add a piece of message metadata.
 110   *
 111   * @deprecated 2.2.2
 112   */
 113  function bp_message_add_meta( $message_id, $meta_key, $meta_value, $unique = false ) {
 114      _deprecated_function( __FUNCTION__, '2.3.0', 'bp_messages_add_meta()' );
 115      return bp_messages_add_meta( $message_id, $meta_key, $meta_value, $unique );
 116  }