wp_set_post_tags

The timeline below displays how wordpress function wp_set_post_tags has changed across different WordPress versions. If a version is not listed, refer to the next available version below.

WordPress Version: 6.1

/**
 * Sets the tags for a post.
 *
 * @since 2.3.0
 *
 * @see wp_set_object_terms()
 *
 * @param int          $post_id Optional. The Post ID. Does not default to the ID of the global $post.
 * @param string|array $tags    Optional. An array of tags to set for the post, or a string of tags
 *                              separated by commas. Default empty.
 * @param bool         $append  Optional. If true, don't delete existing tags, just add on. If false,
 *                              replace the tags with the new tags. Default false.
 * @return array|false|WP_Error Array of term taxonomy IDs of affected terms. WP_Error or false on failure.
 */
function wp_set_post_tags($post_id = 0, $tags = '', $append = false)
{
    return wp_set_post_terms($post_id, $tags, 'post_tag', $append);
}

WordPress Version: 4.5

/**
 * Set the tags for a post.
 *
 * @since 2.3.0
 *
 * @see wp_set_object_terms()
 *
 * @param int          $post_id Optional. The Post ID. Does not default to the ID of the global $post.
 * @param string|array $tags    Optional. An array of tags to set for the post, or a string of tags
 *                              separated by commas. Default empty.
 * @param bool         $append  Optional. If true, don't delete existing tags, just add on. If false,
 *                              replace the tags with the new tags. Default false.
 * @return array|false|WP_Error Array of term taxonomy IDs of affected terms. WP_Error or false on failure.
 */
function wp_set_post_tags($post_id = 0, $tags = '', $append = false)
{
    return wp_set_post_terms($post_id, $tags, 'post_tag', $append);
}

WordPress Version: 4.4

/**
 * Set the tags for a post.
 *
 * @since 2.3.0
 *
 * @see wp_set_object_terms()
 *
 * @param int          $post_id Optional. The Post ID. Does not default to the ID of the global $post.
 * @param string|array $tags    Optional. An array of tags to set for the post, or a string of tags
 *                              separated by commas. Default empty.
 * @param bool         $append  Optional. If true, don't delete existing tags, just add on. If false,
 *                              replace the tags with the new tags. Default false.
 * @return array|false|WP_Error Array of affected term IDs. WP_Error or false on failure.
 */
function wp_set_post_tags($post_id = 0, $tags = '', $append = false)
{
    return wp_set_post_terms($post_id, $tags, 'post_tag', $append);
}

WordPress Version: 4.3

/**
 * Set the tags for a post.
 *
 * @since 2.3.0
 *
 * @see wp_set_object_terms()
 *
 * @param int    $post_id Optional. The Post ID. Does not default to the ID of the global $post.
 * @param string $tags    Optional. The tags to set for the post, separated by commas.
 *                        Default empty.
 * @param bool   $append  Optional. If true, don't delete existing tags, just add on. If false,
 *                        replace the tags with the new tags. Default false.
 * @return array|false|WP_Error Array of affected term IDs. WP_Error or false on failure.
 */
function wp_set_post_tags($post_id = 0, $tags = '', $append = false)
{
    return wp_set_post_terms($post_id, $tags, 'post_tag', $append);
}

WordPress Version: 4.0

/**
 * Set the tags for a post.
 *
 * @since 2.3.0
 *
 * @see wp_set_object_terms()
 *
 * @param int    $post_id Optional. The Post ID. Does not default to the ID of the global $post.
 * @param string $tags    Optional. The tags to set for the post, separated by commas.
 *                        Default empty.
 * @param bool   $append  Optional. If true, don't delete existing tags, just add on. If false,
 *                        replace the tags with the new tags. Default false.
 * @return mixed Array of affected term IDs. WP_Error or false on failure.
 */
function wp_set_post_tags($post_id = 0, $tags = '', $append = false)
{
    return wp_set_post_terms($post_id, $tags, 'post_tag', $append);
}

WordPress Version: 3.7

/**
 * Set the tags for a post.
 *
 * @since 2.3.0
 * @uses wp_set_object_terms() Sets the tags for the post.
 *
 * @param int $post_id Post ID.
 * @param string $tags The tags to set for the post, separated by commas.
 * @param bool $append If true, don't delete existing tags, just add on. If false, replace the tags with the new tags.
 * @return mixed Array of affected term IDs. WP_Error or false on failure.
 */
function wp_set_post_tags($post_id = 0, $tags = '', $append = false)
{
    return wp_set_post_terms($post_id, $tags, 'post_tag', $append);
}