From 3b9e61cdb133b31d510f49464a8f649d7c361984 Mon Sep 17 00:00:00 2001 From: Sergey Biryukov Date: Thu, 13 Jul 2017 12:08:41 +0000 Subject: [PATCH] Docs: Add missing `@since` tags for `WP_Post` properties and methods. Props keesiemeijer. Fixes #41306. Built from https://develop.svn.wordpress.org/trunk@41036 git-svn-id: http://core.svn.wordpress.org/trunk@40886 1a063a9b-81f0-0310-95a4-ce76da25c4cd --- wp-includes/class-wp-post.php | 60 ++++++++++++++++++++++++++++++++++- wp-includes/version.php | 2 +- 2 files changed, 60 insertions(+), 2 deletions(-) diff --git a/wp-includes/class-wp-post.php b/wp-includes/class-wp-post.php index edaf149a3f..c9ec711606 100644 --- a/wp-includes/class-wp-post.php +++ b/wp-includes/class-wp-post.php @@ -24,6 +24,8 @@ final class WP_Post { /** * Post ID. * + * @since 3.5.0 + * @access public * @var int */ public $ID; @@ -33,6 +35,8 @@ final class WP_Post { * * A numeric string, for compatibility reasons. * + * @since 3.5.0 + * @access public * @var string */ public $post_author = 0; @@ -40,6 +44,8 @@ final class WP_Post { /** * The post's local publication time. * + * @since 3.5.0 + * @access public * @var string */ public $post_date = '0000-00-00 00:00:00'; @@ -47,6 +53,8 @@ final class WP_Post { /** * The post's GMT publication time. * + * @since 3.5.0 + * @access public * @var string */ public $post_date_gmt = '0000-00-00 00:00:00'; @@ -54,6 +62,8 @@ final class WP_Post { /** * The post's content. * + * @since 3.5.0 + * @access public * @var string */ public $post_content = ''; @@ -61,6 +71,8 @@ final class WP_Post { /** * The post's title. * + * @since 3.5.0 + * @access public * @var string */ public $post_title = ''; @@ -68,6 +80,8 @@ final class WP_Post { /** * The post's excerpt. * + * @since 3.5.0 + * @access public * @var string */ public $post_excerpt = ''; @@ -75,6 +89,8 @@ final class WP_Post { /** * The post's status. * + * @since 3.5.0 + * @access public * @var string */ public $post_status = 'publish'; @@ -82,6 +98,8 @@ final class WP_Post { /** * Whether comments are allowed. * + * @since 3.5.0 + * @access public * @var string */ public $comment_status = 'open'; @@ -89,6 +107,8 @@ final class WP_Post { /** * Whether pings are allowed. * + * @since 3.5.0 + * @access public * @var string */ public $ping_status = 'open'; @@ -96,6 +116,8 @@ final class WP_Post { /** * The post's password in plain text. * + * @since 3.5.0 + * @access public * @var string */ public $post_password = ''; @@ -103,6 +125,8 @@ final class WP_Post { /** * The post's slug. * + * @since 3.5.0 + * @access public * @var string */ public $post_name = ''; @@ -110,6 +134,8 @@ final class WP_Post { /** * URLs queued to be pinged. * + * @since 3.5.0 + * @access public * @var string */ public $to_ping = ''; @@ -117,6 +143,8 @@ final class WP_Post { /** * URLs that have been pinged. * + * @since 3.5.0 + * @access public * @var string */ public $pinged = ''; @@ -124,6 +152,8 @@ final class WP_Post { /** * The post's local modified time. * + * @since 3.5.0 + * @access public * @var string */ public $post_modified = '0000-00-00 00:00:00'; @@ -131,6 +161,8 @@ final class WP_Post { /** * The post's GMT modified time. * + * @since 3.5.0 + * @access public * @var string */ public $post_modified_gmt = '0000-00-00 00:00:00'; @@ -138,7 +170,8 @@ final class WP_Post { /** * A utility DB field for post content. * - * + * @since 3.5.0 + * @access public * @var string */ public $post_content_filtered = ''; @@ -146,6 +179,8 @@ final class WP_Post { /** * ID of a post's parent post. * + * @since 3.5.0 + * @access public * @var int */ public $post_parent = 0; @@ -153,6 +188,8 @@ final class WP_Post { /** * The unique identifier for a post, not necessarily a URL, used as the feed GUID. * + * @since 3.5.0 + * @access public * @var string */ public $guid = ''; @@ -160,6 +197,8 @@ final class WP_Post { /** * A field used for ordering posts. * + * @since 3.5.0 + * @access public * @var int */ public $menu_order = 0; @@ -167,6 +206,8 @@ final class WP_Post { /** * The post's type, like post or page. * + * @since 3.5.0 + * @access public * @var string */ public $post_type = 'post'; @@ -174,6 +215,8 @@ final class WP_Post { /** * An attachment's mime type. * + * @since 3.5.0 + * @access public * @var string */ public $post_mime_type = ''; @@ -183,6 +226,8 @@ final class WP_Post { * * A numeric string, for compatibility reasons. * + * @since 3.5.0 + * @access public * @var string */ public $comment_count = 0; @@ -192,6 +237,8 @@ final class WP_Post { * * Does not correspond to a DB field. * + * @since 3.5.0 + * @access public * @var string */ public $filter; @@ -199,6 +246,7 @@ final class WP_Post { /** * Retrieve WP_Post instance. * + * @since 3.5.0 * @static * @access public * @@ -235,6 +283,8 @@ final class WP_Post { /** * Constructor. * + * @since 3.5.0 + * * @param WP_Post|object $post Post object. */ public function __construct( $post ) { @@ -245,6 +295,8 @@ final class WP_Post { /** * Isset-er. * + * @since 3.5.0 + * * @param string $key Property to check if set. * @return bool */ @@ -267,6 +319,8 @@ final class WP_Post { /** * Getter. * + * @since 3.5.0 + * * @param string $key Key to get. * @return mixed */ @@ -310,6 +364,8 @@ final class WP_Post { /** * {@Missing Summary} * + * @since 3.5.0 + * * @param string $filter Filter. * @return self|array|bool|object|WP_Post */ @@ -326,6 +382,8 @@ final class WP_Post { /** * Convert object to array. * + * @since 3.5.0 + * * @return array Object as array. */ public function to_array() { diff --git a/wp-includes/version.php b/wp-includes/version.php index c1e9abdd38..de3a97b56b 100644 --- a/wp-includes/version.php +++ b/wp-includes/version.php @@ -4,7 +4,7 @@ * * @global string $wp_version */ -$wp_version = '4.9-alpha-41035'; +$wp_version = '4.9-alpha-41036'; /** * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.