Changeset 52236
- Timestamp:
- 11/23/2021 09:35:57 PM (3 years ago)
- Location:
- trunk/src
- Files:
-
- 8 edited
Legend:
- Unmodified
- Added
- Removed
-
trunk/src/wp-admin/includes/taxonomy.php
r51302 r52236 116 116 * } 117 117 * @param bool $wp_error Optional. Default false. 118 * @return int| objectThe ID number of the new or updated Category on success. Zero or a WP_Error on failure,119 * depending on param $wp_error.118 * @return int|WP_Error The ID number of the new or updated Category on success. Zero or a WP_Error on failure, 119 * depending on param `$wp_error`. 120 120 */ 121 121 function wp_insert_category( $catarr, $wp_error = false ) { -
trunk/src/wp-includes/class-wp-block-patterns-registry.php
r52219 r52236 9 9 10 10 /** 11 * Class used for interacting with patterns.11 * Class used for interacting with block patterns. 12 12 * 13 13 * @since 5.5.0 … … 15 15 final class WP_Block_Patterns_Registry { 16 16 /** 17 * Registered patterns array.17 * Registered block patterns array. 18 18 * 19 19 * @since 5.5.0 … … 31 31 32 32 /** 33 * Registers a pattern.34 * 35 * @since 5.5.0 36 * 37 * @param string $pattern_name Pattern name including namespace.38 * @param array $pattern_properties{33 * Registers a block pattern. 34 * 35 * @since 5.5.0 36 * 37 * @param string $pattern_name Block pattern name including namespace. 38 * @param array $pattern_properties { 39 39 * List of properties for the block pattern. 40 40 * 41 41 * @type string $title Required. A human-readable title for the pattern. 42 42 * @type string $content Required. Block HTML markup for the pattern. 43 * @type string $description Visually hidden text used to describe the pattern in the43 * @type string $description Optional. Visually hidden text used to describe the pattern in the 44 44 * inserter. A description is optional, but is strongly 45 45 * encouraged when the title does not fully describe what the 46 46 * pattern does. The description will help users discover the 47 * pattern while searching. Optional.48 * @type int $viewportWidth The intended width of the pattern to allow for a scaled49 * preview within the pattern inserter. Optional.50 * @type array $categories A list of registered pattern categories used to group block47 * pattern while searching. 48 * @type int $viewportWidth Optional. The intended width of the pattern to allow for a scaled 49 * preview within the pattern inserter. 50 * @type array $categories Optional. A list of registered pattern categories used to group block 51 51 * patterns. Block patterns can be shown on multiple categories. 52 52 * A category must be registered separately in order to be used 53 * here. Optional.54 * @type array $keywords A list of aliases or keywords that help users discover the55 * pattern while searching. Optional.53 * here. 54 * @type array $keywords Optional. A list of aliases or keywords that help users discover the 55 * pattern while searching. 56 56 * } 57 57 * @return bool True if the pattern was registered with success and false otherwise. … … 94 94 95 95 /** 96 * Unregisters a pattern.97 * 98 * @since 5.5.0 99 * 100 * @param string $pattern_name Pattern name including namespace.96 * Unregisters a block pattern. 97 * 98 * @since 5.5.0 99 * 100 * @param string $pattern_name Block pattern name including namespace. 101 101 * @return bool True if the pattern was unregistered with success and false otherwise. 102 102 */ … … 118 118 119 119 /** 120 * Retrieves an array containing the properties of a registered pattern.121 * 122 * @since 5.5.0 123 * 124 * @param string $pattern_name Pattern name including namespace.120 * Retrieves an array containing the properties of a registered block pattern. 121 * 122 * @since 5.5.0 123 * 124 * @param string $pattern_name Block pattern name including namespace. 125 125 * @return array Registered pattern properties. 126 126 */ … … 134 134 135 135 /** 136 * Retrieves all registered patterns.137 * 138 * @since 5.5.0 139 * 140 * @return array Array of arrays containing the registered patterns properties,136 * Retrieves all registered block patterns. 137 * 138 * @since 5.5.0 139 * 140 * @return array Array of arrays containing the registered block patterns properties, 141 141 * and per style. 142 142 */ … … 146 146 147 147 /** 148 * Checks if a pattern is registered.149 * 150 * @since 5.5.0 151 * 152 * @param string $pattern_name Pattern name including namespace.148 * Checks if a block pattern is registered. 149 * 150 * @since 5.5.0 151 * 152 * @param string $pattern_name Block pattern name including namespace. 153 153 * @return bool True if the pattern is registered, false otherwise. 154 154 */ … … 176 176 177 177 /** 178 * Registers a new pattern.179 * 180 * @since 5.5.0 181 * 182 * @param string $pattern_name Pattern name including namespace.178 * Registers a new block pattern. 179 * 180 * @since 5.5.0 181 * 182 * @param string $pattern_name Block pattern name including namespace. 183 183 * @param array $pattern_properties List of properties for the block pattern. 184 184 * See WP_Block_Patterns_Registry::register() for accepted arguments. … … 188 188 return WP_Block_Patterns_Registry::get_instance()->register( $pattern_name, $pattern_properties ); 189 189 } 190 /** 191 * Unregisters a pattern. 192 * 193 * @since 5.5.0 194 * 195 * @param string $pattern_name Pattern name including namespace. 190 191 /** 192 * Unregisters a block pattern. 193 * 194 * @since 5.5.0 195 * 196 * @param string $pattern_name Block pattern name including namespace. 196 197 * @return bool True if the pattern was unregistered with success and false otherwise. 197 198 */ -
trunk/src/wp-includes/class-wp-block-styles-registry.php
r51154 r52236 18 18 * 19 19 * @since 5.3.0 20 * @var array 20 * 21 * @var array[] 21 22 */ 22 23 private $registered_block_styles = array(); … … 26 27 * 27 28 * @since 5.3.0 29 * 28 30 * @var WP_Block_Styles_Registry|null 29 31 */ … … 31 33 32 34 /** 33 * Registers a block style .35 * Registers a block style for the given block type. 34 36 * 35 37 * @since 5.3.0 … … 72 74 73 75 /** 74 * Unregisters a block style. 76 * Unregisters a block style of the given block type. 77 * 78 * @since 5.3.0 75 79 * 76 80 * @param string $block_name Block type name including namespace. … … 95 99 96 100 /** 97 * Retrieves an array containing the properties of a registered block style.101 * Retrieves the properties of a registered block style for the given block type. 98 102 * 99 103 * @since 5.3.0 … … 116 120 * @since 5.3.0 117 121 * 118 * @return array Array of arrays containing the registered block styles properties grouped per block, 119 * and per style. 122 * @return array[] Array of arrays containing the registered block styles properties grouped by block type. 120 123 */ 121 124 public function get_all_registered() { … … 124 127 125 128 /** 126 * Retrieves registered block styles for a specific block .129 * Retrieves registered block styles for a specific block type. 127 130 * 128 131 * @since 5.3.0 129 132 * 130 133 * @param string $block_name Block type name including namespace. 131 * @return array Array whose keys are block style names and whose valueare block style properties.134 * @return array[] Array whose keys are block style names and whose values are block style properties. 132 135 */ 133 136 public function get_registered_styles_for_block( $block_name ) { … … 139 142 140 143 /** 141 * Checks if a block style is registered .144 * Checks if a block style is registered for the given block type. 142 145 * 143 146 * @since 5.3.0 -
trunk/src/wp-includes/class-wp-block-supports.php
r51246 r52236 59 59 60 60 /** 61 * Initializes the block supports. It registe s the block supports block attributes.61 * Initializes the block supports. It registers the block supports block attributes. 62 62 * 63 63 * @since 5.6.0 … … 73 73 * @since 5.6.0 74 74 * 75 * @param string $block_support_name Block support name.75 * @param string $block_support_name Block support name. 76 76 * @param array $block_support_config Array containing the properties of the block support. 77 77 */ … … 89 89 * @since 5.6.0 90 90 * 91 * @return arrayArray of HTML attributes.91 * @return string[] Array of HTML attributes. 92 92 */ 93 93 public function apply_block_supports() { … … 164 164 * @since 5.6.0 165 165 * 166 * @param array $extra_attributes Optional. Extra attributes to render on the block wrapper. 167 * 168 * @return string String of HTML classes. 166 * @param string[] $extra_attributes Optional. Array of extra attributes to render on the block wrapper. 167 * @return string String of HTML attributes. 169 168 */ 170 169 function get_block_wrapper_attributes( $extra_attributes = array() ) { -
trunk/src/wp-includes/class-wp-block-template.php
r52062 r52236 98 98 * 99 99 * @since 5.8.0 100 * @var bool ean100 * @var bool 101 101 */ 102 102 public $has_theme_file; … … 107 107 * @since 5.9.0 108 108 * 109 * @var bool ean109 * @var bool 110 110 */ 111 111 public $is_custom = true; -
trunk/src/wp-includes/class-wp-meta-query.php
r52226 r52236 339 339 * @since 3.2.0 340 340 * 341 * @param string $type Type of meta, eg 'user', 'post'. 341 * @param string $type Type of meta. Possible values include but are not limited 342 * to 'post', 'comment', 'blog', 'term', and 'user'. 342 343 * @param string $primary_table Database table where the object being filtered is stored (eg wp_users). 343 344 * @param string $primary_id_column ID column for the filtered object in $primary_table. 344 * @param object $context Optional. The main query object. 345 * @return array|false { 346 * Array containing JOIN and WHERE SQL clauses to append to the main query. 345 * @param object $context Optional. The main query object that corresponds to the type, for 346 * example a `WP_Query`, `WP_User_Query`, or `WP_Site_Query`. 347 * @return string[]|false { 348 * Array containing JOIN and WHERE SQL clauses to append to the main query, 349 * or false if no table exists for the requested meta type. 347 350 * 348 351 * @type string $join SQL fragment to append to the main JOIN clause. … … 379 382 * @since 3.1.0 380 383 * 381 * @param array $sql Array containing the query's JOIN and WHERE clauses. 382 * @param array $queries Array of meta queries. 383 * @param string $type Type of meta. 384 * @param string $primary_table Primary table. 385 * @param string $primary_id_column Primary column ID. 386 * @param object $context The main query object. 384 * @param string[] $sql Array containing the query's JOIN and WHERE clauses. 385 * @param array $queries Array of meta queries. 386 * @param string $type Type of meta. Possible values include but are not limited 387 * to 'post', 'comment', 'blog', 'term', and 'user'. 388 * @param string $primary_table Primary table. 389 * @param string $primary_id_column Primary column ID. 390 * @param object $context The main query object that corresponds to the type, for 391 * example a `WP_Query`, `WP_User_Query`, or `WP_Site_Query`. 387 392 */ 388 393 return apply_filters_ref_array( 'get_meta_sql', array( $sql, $this->queries, $type, $primary_table, $primary_id_column, $context ) ); -
trunk/src/wp-includes/cron.php
r51955 r52236 1114 1114 * @since 5.1.0 1115 1115 * 1116 * @return array Cron jobs ready to be run.1116 * @return array[] Array of cron job arrays ready to be run. 1117 1117 */ 1118 1118 function wp_get_ready_cron_jobs() { … … 1125 1125 * @since 5.1.0 1126 1126 * 1127 * @param null|array $pre Array of ready cron tasks to return instead. Default null1128 * to continue using results from _get_cron_array().1127 * @param null|array[] $pre Array of ready cron tasks to return instead. Default null 1128 * to continue using results from _get_cron_array(). 1129 1129 */ 1130 1130 $pre = apply_filters( 'pre_get_ready_cron_jobs', null ); … … 1165 1165 * @access private 1166 1166 * 1167 * @return array |false Cron info arrayon success, false on failure.1167 * @return array[]|false Array of cron info arrays on success, false on failure. 1168 1168 */ 1169 1169 function _get_cron_array() { … … 1191 1191 * @access private 1192 1192 * 1193 * @param array $cron Cron info arrayfrom _get_cron_array().1194 * @param bool $wp_error Optional. Whether to return a WP_Error on failure. Default false.1193 * @param array[] $cron Array of cron info arrays from _get_cron_array(). 1194 * @param bool $wp_error Optional. Whether to return a WP_Error on failure. Default false. 1195 1195 * @return bool|WP_Error True if cron array updated. False or WP_Error on failure. 1196 1196 */ -
trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-pattern-directory-controller.php
r51786 r52236 52 52 53 53 /** 54 * Checks whether a given request has permission to view the local pattern directory.54 * Checks whether a given request has permission to view the local block pattern directory. 55 55 * 56 56 * @since 5.8.0 … … 197 197 198 198 /** 199 * Prepare a raw pattern before it's output in anAPI response.199 * Prepare a raw block pattern before it gets output in a REST API response. 200 200 * 201 201 * @since 5.8.0 … … 224 224 225 225 /** 226 * Filters the REST API response for a pattern.226 * Filters the REST API response for a block pattern. 227 227 * 228 228 * @since 5.8.0 229 229 * 230 230 * @param WP_REST_Response $response The response object. 231 * @param object $raw_pattern The unprepared pattern.231 * @param object $raw_pattern The unprepared block pattern. 232 232 * @param WP_REST_Request $request The request object. 233 233 */ … … 236 236 237 237 /** 238 * Retrieves the pattern's schema, conforming to JSON Schema.238 * Retrieves the block pattern's schema, conforming to JSON Schema. 239 239 * 240 240 * @since 5.8.0 … … 308 308 309 309 /** 310 * Retrieves the search param s for the patterns collection.310 * Retrieves the search parameters for the block pattern's collection. 311 311 * 312 312 * @since 5.8.0 … … 337 337 338 338 /** 339 * Filter collection parameters for the pattern directory controller.339 * Filter collection parameters for the block pattern directory controller. 340 340 * 341 341 * @since 5.8.0
Note: See TracChangeset
for help on using the changeset viewer.