htmlburger / carbon-fields

core/Container/Fulfillable/Fulfillable_Collection.php

Doc Comments +1 added lines, -1 removed lines

@@ -298,7 +298,7 @@
 	 * 
 	 * @param  array<string>          $condition_types
 	 * @param  array|boolean          $environment Environment array or a boolean value to force on conditions
-	 * @param  array                  $comparison_operators Array of comparison operators to evaluate regardless of condition type
+	 * @param  string[]                  $comparison_operators Array of comparison operators to evaluate regardless of condition type
 	 * @return Fulfillable_Collection
 	 */
 	public function evaluate( $condition_types, $environment, $comparison_operators = array() ) {

core/Container/User_Meta_Container.php

Doc Comments +1 added lines, -1 removed lines

@@ -195,7 +195,7 @@
 	 *
 	 * @deprecated
 	 * @param string|array $role
-	 * @return object $this
+	 * @return User_Meta_Container $this
 	 */
 	public function show_on_user_role( $role ) {
 		$roles = is_array( $role ) ? $role : array( $role );

core/Field/Checkbox_Field.php

Doc Comments +1 added lines, -1 removed lines

@@ -42,7 +42,7 @@
 	/**
 	 * Return a differently formatted value for end-users
 	 *
-	 * @return mixed
+	 * @return boolean
 	 */
 	public function get_formatted_value() {
 		return ( $this->get_value() === $this->option_value );

core/Field/Gravity_Form_Field.php

Doc Comments +1 added lines, -1 removed lines

@@ -30,7 +30,7 @@
 	/**
 	 * Set the available forms as field options
 	 *
-	 * @return array
+	 * @return callable
 	 */
 	protected function get_gravity_form_options() {
 		if ( ! $this->is_plugin_active() ) {

core/Container/Post_Meta_Container.php

Doc Comments +10 added lines, -10 removed lines

@@ -267,7 +267,7 @@ 
 	 *
 	 * @deprecated
 	 * @param int|string $page page ID or page path
-	 * @return object $this
+	 * @return Post_Meta_Container $this
 	 */
 	public function show_on_page( $page ) {
 		$page_id = absint( $page );
@@ -289,7 +289,7 @@ 
 	 *
 	 * @deprecated
 	 * @param string $parent_page_path
-	 * @return object $this
+	 * @return Post_Meta_Container $this
 	 */
 	public function show_on_page_children( $parent_page_path ) {
 		$page = get_page_by_path( $parent_page_path );
@@ -303,7 +303,7 @@ 
 	 *
 	 * @deprecated
 	 * @param string|array $template_path
-	 * @return object $this
+	 * @return Post_Meta_Container $this
 	 */
 	public function show_on_template( $template_path ) {
 		// Backwards compatibility where only pages support templates
@@ -321,7 +321,7 @@ 
 	 *
 	 * @deprecated
 	 * @param string|array $template_path
-	 * @return object $this
+	 * @return Post_Meta_Container $this
 	 */
 	public function hide_on_template( $template_path ) {
 		$template_paths = is_array( $template_path ) ? $template_path : array( $template_path );
@@ -335,7 +335,7 @@ 
 	 *
 	 * @deprecated
 	 * @param int $level
-	 * @return object $this
+	 * @return Post_Meta_Container $this
 	 */
 	public function show_on_level( $level ) {
 		$this->where( 'post_level', '=', intval( $level ) );
@@ -348,7 +348,7 @@ 
 	 *
 	 * @deprecated
 	 * @param string|array $post_format Name of the format as listed on Codex
-	 * @return object $this
+	 * @return Post_Meta_Container $this
 	 */
 	public function show_on_post_format( $post_format ) {
 		$post_formats = is_array( $post_format ) ? $post_format : array( $post_format );
@@ -360,8 +360,8 @@ 
 	 * Show the container only on posts from the specified type(s).
 	 *
 	 * @deprecated
-	 * @param string|array $post_types
-	 * @return object $this
+	 * @param string $post_types
+	 * @return Post_Meta_Container $this
 	 */
 	public function show_on_post_type( $post_types ) {
 		$post_types = is_array( $post_types ) ? $post_types : array( $post_types );
@@ -376,7 +376,7 @@ 
 	 *
 	 * @deprecated
 	 * @param string $category_slug
-	 * @return object $this
+	 * @return Post_Meta_Container $this
 	 */
 	public function show_on_category( $category_slug ) {
 		$this->where( 'post_term', '=', array(
@@ -393,7 +393,7 @@ 
 	 * @deprecated
 	 * @param string $taxonomy_slug
 	 * @param string $term_slug
-	 * @return object $this
+	 * @return Post_Meta_Container $this
 	 */
 	public function show_on_taxonomy_term( $term_slug, $taxonomy_slug ) {
 		$this->where( 'post_term', '=', array(

core/Container/Term_Meta_Container.php

Doc Comments +2 added lines, -2 removed lines

@@ -198,7 +198,7 @@ 
 	 *
 	 * @deprecated
 	 * @param string|array $taxonomies
-	 * @return object $this
+	 * @return Term_Meta_Container $this
 	 */
 	public function show_on_taxonomy( $taxonomies ) {
 		$taxonomies = is_array( $taxonomies ) ? $taxonomies : array( $taxonomies );
@@ -211,7 +211,7 @@ 
 	 *
 	 * @deprecated
 	 * @param int $term_level
-	 * @return object $this
+	 * @return Term_Meta_Container $this
 	 */
 	public function show_on_level( $term_level ) {
 		$this->where( 'term_level', '=', intval( $term_level ) );

core/Carbon_Fields.php

Doc Comments +1 added lines, -3 removed lines

@@ -51,7 +51,7 @@ 
 	/**
 	 * Singleton implementation
 	 *
-	 * @return Carbon_Fields\Carbon_Fields
+	 * @return Carbon_Fields|null
 	 */
 	public static function instance() {
 		static $instance = null;
@@ -134,7 +134,6 @@ 
 	/**
 	 * Extend Carbon Fields by adding a new entity (container condition etc.)
 	 *
-	 * @param string $type     Type of extension - 'container_condition'
 	 * @param string $class    Extension class name
 	 * @param string $extender Extending callable
 	 */
@@ -231,7 +230,6 @@ 
 	/**
 	 * Remove a listener from any event
 	 * 
-	 * @param Listener $removed_listener
 	 */
 	public static function remove_listener( $listener ) {
 		static::instance()->get_emitter()->remove_listener( $listener );

core/Container/Container.php

Doc Comments +5 added lines, -4 removed lines

@@ -383,6 +383,7 @@ 
 	/**
 	 * Check if all conditions pass for object
 	 *
+	 * @param integer $object_id
 	 * @return bool
 	 */
 	protected function all_conditions_pass( $object_id ) {
@@ -543,7 +544,7 @@ 
 	 * Set datastore instance
 	 *
 	 * @param Datastore_Interface $datastore
-	 * @return object $this
+	 * @return Container $this
 	 */
 	public function set_datastore( Datastore_Interface $datastore, $set_as_default = false ) {
 		if ( $set_as_default && ! $this->has_default_datastore() ) {
@@ -711,7 +712,7 @@ 
 	 * Set CSS classes that the container should use.
 	 *
 	 * @param string|array<string> $classes
-	 * @return object $this
+	 * @return Container $this
 	 */
 	public function set_classes( $classes ) {
 		$this->classes = Helper::sanitize_classes( $classes );
@@ -770,7 +771,7 @@ 
 	 * assigned to them instead.
 	 *
 	 * @param array $fields
-	 * @return object $this
+	 * @return Container $this
 	 */
 	public function add_fields( $fields ) {
 		foreach ( $fields as $field ) {
@@ -800,7 +801,7 @@ 
 	 *
 	 * @param string $tab_name
 	 * @param array $fields
-	 * @return object $this
+	 * @return Container $this
 	 */
 	public function add_tab( $tab_name, $fields ) {
 		$this->add_fields( $fields );

core/Datastore/Datastore.php

Doc Comments +1 added lines, -1 removed lines

@@ -28,7 +28,6 @@ 
 	/**
 	 * Create a new datastore of type $type.
 	 *
-	 * @param string $type
 	 * @return Datastore_Interface
 	 */
 	public static function factory( $raw_type ) {
@@ -48,6 +47,7 @@ 
 	 * An alias of factory().
 	 *
 	 * @see Datastore::factory()
+	 * @param string $type
 	 * @return Datastore_Interface
 	 */
 	public static function make( $type ) {