IntenseWebs/WordPress
3
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Docs: Replace multiple single line comments with multi-line comments.

Browse Source 
This changeset updates various comments as per WordPress PHP Inline Documentation Standards.
See https://developer.wordpress.org/coding-standards/inline-documentation-standards/php/#5-inline-comments.

Follow-up to [56174], [56175], [56176], [56177], [56178].

Props costdev, audrasjb.
See #58459.



Built from https://develop.svn.wordpress.org/trunk@56179


git-svn-id: http://core.svn.wordpress.org/trunk@55691 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
audrasjb 2023-07-09 21:40:23 +00:00
parent b696756a61
commit 90dadb1457
3 changed files with 126 additions and 70 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
wp-includes/class-wp-theme-json-resolver.php
View File

@ -358,8 +358,10 @@ class WP_Theme_JSON_Resolver {
isset( $block_type->supports['spacing']['blockGap']['__experimentalDefault'] ) && isset( $block_type->supports['spacing']['blockGap']['__experimentalDefault'] ) &&
null === _wp_array_get( $config, array( 'styles', 'blocks', $block_name, 'spacing', 'blockGap' ), null ) null === _wp_array_get( $config, array( 'styles', 'blocks', $block_name, 'spacing', 'blockGap' ), null )
) { ) {
// Ensure an empty placeholder value exists for the block, if it provides a default blockGap value. /*
// The real blockGap value to be used will be determined when the styles are rendered for output. * Ensure an empty placeholder value exists for the block, if it provides a default blockGap value.
* The real blockGap value to be used will be determined when the styles are rendered for output.
*/
$config['styles']['blocks'][ $block_name ]['spacing']['blockGap'] = null; $config['styles']['blocks'][ $block_name ]['spacing']['blockGap'] = null;
} }
} }
@ -512,8 +514,10 @@ class WP_Theme_JSON_Resolver {
return new WP_Theme_JSON( $config, 'custom' ); return new WP_Theme_JSON( $config, 'custom' );
} }
// Very important to verify that the flag isGlobalStylesUserThemeJSON is true. /*
// If it's not true then the content was not escaped and is not safe. * Very important to verify that the flag isGlobalStylesUserThemeJSON is true.
* If it's not true then the content was not escaped and is not safe.
*/
if ( if (
is_array( $decoded_data ) && is_array( $decoded_data ) &&
isset( $decoded_data['isGlobalStylesUserThemeJSON'] ) && isset( $decoded_data['isGlobalStylesUserThemeJSON'] ) &&

182
wp-includes/class-wp-theme-json.php
View File

@ -545,8 +545,10 @@ class WP_Theme_JSON {
public static function get_element_class_name( $element ) { public static function get_element_class_name( $element ) {
$class_name = ''; $class_name = '';
// TODO: Replace array_key_exists() with isset() check once WordPress drops /*
// support for PHP 5.6. See https://core.trac.wordpress.org/ticket/57067. * TODO: Replace array_key_exists() with isset() check once WordPress drops
* support for PHP 5.6. See https://core.trac.wordpress.org/ticket/57067.
*/
if ( array_key_exists( $element, static::__EXPERIMENTAL_ELEMENT_CLASS_NAMES ) ) { if ( array_key_exists( $element, static::__EXPERIMENTAL_ELEMENT_CLASS_NAMES ) ) {
$class_name = static::__EXPERIMENTAL_ELEMENT_CLASS_NAMES[ $element ]; $class_name = static::__EXPERIMENTAL_ELEMENT_CLASS_NAMES[ $element ];
} }
@ -671,8 +673,10 @@ class WP_Theme_JSON {
*/ */
protected static function do_opt_in_into_settings( &$context ) { protected static function do_opt_in_into_settings( &$context ) {
foreach ( static::APPEARANCE_TOOLS_OPT_INS as $path ) { foreach ( static::APPEARANCE_TOOLS_OPT_INS as $path ) {
// Use "unset prop" as a marker instead of "null" because /*
// "null" can be a valid value for some props (e.g. blockGap). * Use "unset prop" as a marker instead of "null" because
* "null" can be a valid value for some props (e.g. blockGap).
*/
if ( 'unset prop' === _wp_array_get( $context, $path, 'unset prop' ) ) { if ( 'unset prop' === _wp_array_get( $context, $path, 'unset prop' ) ) {
_wp_array_set( $context, $path, true ); _wp_array_set( $context, $path, true );
} }
@ -736,8 +740,10 @@ class WP_Theme_JSON {
foreach ( $valid_element_names as $element ) { foreach ( $valid_element_names as $element ) {
$schema_styles_elements[ $element ] = $styles_non_top_level; $schema_styles_elements[ $element ] = $styles_non_top_level;
// TODO: Replace array_key_exists() with isset() check once WordPress drops /*
// support for PHP 5.6. See https://core.trac.wordpress.org/ticket/57067. * TODO: Replace array_key_exists() with isset() check once WordPress drops
* support for PHP 5.6. See https://core.trac.wordpress.org/ticket/57067.
*/
if ( array_key_exists( $element, static::VALID_ELEMENT_PSEUDO_SELECTORS ) ) { if ( array_key_exists( $element, static::VALID_ELEMENT_PSEUDO_SELECTORS ) ) {
foreach ( static::VALID_ELEMENT_PSEUDO_SELECTORS[ $element ] as $pseudo_selector ) { foreach ( static::VALID_ELEMENT_PSEUDO_SELECTORS[ $element ] as $pseudo_selector ) {
$schema_styles_elements[ $element ][ $pseudo_selector ] = $styles_non_top_level; $schema_styles_elements[ $element ][ $pseudo_selector ] = $styles_non_top_level;
@ -1083,8 +1089,10 @@ class WP_Theme_JSON {
if ( ! empty( $options['root_selector'] ) ) { if ( ! empty( $options['root_selector'] ) ) {
$root_selector = $options['root_selector']; $root_selector = $options['root_selector'];
} }
// Base layout styles are provided as part of `styles`, so only output separately if explicitly requested. /*
// For backwards compatibility, the Columns block is explicitly included, to support a different default gap value. * Base layout styles are provided as part of `styles`, so only output separately if explicitly requested.
* For backwards compatibility, the Columns block is explicitly included, to support a different default gap value.
*/
$base_styles_nodes = array( $base_styles_nodes = array(
array( array(
'path' => array( 'styles' ), 'path' => array( 'styles' ),
@ -1275,8 +1283,10 @@ class WP_Theme_JSON {
$layout_definitions = wp_get_layout_definitions(); $layout_definitions = wp_get_layout_definitions();
$layout_selector_pattern = '/^[a-zA-Z0-9\-\.\ *+>:\(\)]*$/'; // Allow alphanumeric classnames, spaces, wildcard, sibling, child combinator and pseudo class selectors. $layout_selector_pattern = '/^[a-zA-Z0-9\-\.\ *+>:\(\)]*$/'; // Allow alphanumeric classnames, spaces, wildcard, sibling, child combinator and pseudo class selectors.
// Gap styles will only be output if the theme has block gap support, or supports a fallback gap. /*
// Default layout gap styles will be skipped for themes that do not explicitly opt-in to blockGap with a `true` or `false` value. * Gap styles will only be output if the theme has block gap support, or supports a fallback gap.
* Default layout gap styles will be skipped for themes that do not explicitly opt-in to blockGap with a `true` or `false` value.
*/
if ( $has_block_gap_support || $has_fallback_gap_support ) { if ( $has_block_gap_support || $has_fallback_gap_support ) {
$block_gap_value = null; $block_gap_value = null;
// Use a fallback gap value if block gap support is not available. // Use a fallback gap value if block gap support is not available.
@ -1554,8 +1564,10 @@ class WP_Theme_JSON {
*/ */
protected static function compute_preset_classes( $settings, $selector, $origins ) { protected static function compute_preset_classes( $settings, $selector, $origins ) {
if ( static::ROOT_BLOCK_SELECTOR === $selector ) { if ( static::ROOT_BLOCK_SELECTOR === $selector ) {
// Classes at the global level do not need any CSS prefixed, /*
// and we don't want to increase its specificity. * Classes at the global level do not need any CSS prefixed,
* and we don't want to increase its specificity.
*/
$selector = ''; $selector = '';
} }
@ -1897,8 +1909,10 @@ class WP_Theme_JSON {
if ( str_starts_with( $css_property, '--wp--style--root--' ) && ( static::ROOT_BLOCK_SELECTOR !== $selector || ! $use_root_padding ) ) { if ( str_starts_with( $css_property, '--wp--style--root--' ) && ( static::ROOT_BLOCK_SELECTOR !== $selector || ! $use_root_padding ) ) {
continue; continue;
} }
// Root-level padding styles don't currently support strings with CSS shorthand values. /*
// This may change: https://github.com/WordPress/gutenberg/issues/40132. * Root-level padding styles don't currently support strings with CSS shorthand values.
* This may change: https://github.com/WordPress/gutenberg/issues/40132.
*/
if ( '--wp--style--root--padding' === $css_property && is_string( $value ) ) { if ( '--wp--style--root--padding' === $css_property && is_string( $value ) ) {
continue; continue;
} }
@ -1907,13 +1921,17 @@ class WP_Theme_JSON {
$root_variable_duplicates[] = substr( $css_property, strlen( '--wp--style--root--' ) ); $root_variable_duplicates[] = substr( $css_property, strlen( '--wp--style--root--' ) );
} }
// Look up protected properties, keyed by value path. /*
// Skip protected properties that are explicitly set to `null`. * Look up protected properties, keyed by value path.
* Skip protected properties that are explicitly set to `null`.
*/
if ( is_array( $value_path ) ) { if ( is_array( $value_path ) ) {
$path_string = implode( '.', $value_path ); $path_string = implode( '.', $value_path );
if ( if (
// TODO: Replace array_key_exists() with isset() check once WordPress drops /*
// support for PHP 5.6. See https://core.trac.wordpress.org/ticket/57067. * TODO: Replace array_key_exists() with isset() check once WordPress drops
* support for PHP 5.6. See https://core.trac.wordpress.org/ticket/57067.
*/
array_key_exists( $path_string, static::PROTECTED_PROPERTIES ) && array_key_exists( $path_string, static::PROTECTED_PROPERTIES ) &&
_wp_array_get( $settings, static::PROTECTED_PROPERTIES[ $path_string ], null ) === null _wp_array_get( $settings, static::PROTECTED_PROPERTIES[ $path_string ], null ) === null
) { ) {
@ -2118,9 +2136,11 @@ class WP_Theme_JSON {
'selector' => static::ELEMENTS[ $element ], 'selector' => static::ELEMENTS[ $element ],
); );
// Handle any pseudo selectors for the element. /*
// TODO: Replace array_key_exists() with isset() check once WordPress drops * Handle any pseudo selectors for the element.
// support for PHP 5.6. See https://core.trac.wordpress.org/ticket/57067. * TODO: Replace array_key_exists() with isset() check once WordPress drops
* support for PHP 5.6. See https://core.trac.wordpress.org/ticket/57067.
*/
if ( array_key_exists( $element, static::VALID_ELEMENT_PSEUDO_SELECTORS ) ) { if ( array_key_exists( $element, static::VALID_ELEMENT_PSEUDO_SELECTORS ) ) {
foreach ( static::VALID_ELEMENT_PSEUDO_SELECTORS[ $element ] as $pseudo_selector ) { foreach ( static::VALID_ELEMENT_PSEUDO_SELECTORS[ $element ] as $pseudo_selector ) {
@ -2270,9 +2290,11 @@ class WP_Theme_JSON {
'selector' => $selectors[ $name ]['elements'][ $element ], 'selector' => $selectors[ $name ]['elements'][ $element ],
); );
// Handle any pseudo selectors for the element. /*
// TODO: Replace array_key_exists() with isset() check once WordPress drops * Handle any pseudo selectors for the element.
// support for PHP 5.6. See https://core.trac.wordpress.org/ticket/57067. * TODO: Replace array_key_exists() with isset() check once WordPress drops
* support for PHP 5.6. See https://core.trac.wordpress.org/ticket/57067.
*/
if ( array_key_exists( $element, static::VALID_ELEMENT_PSEUDO_SELECTORS ) ) { if ( array_key_exists( $element, static::VALID_ELEMENT_PSEUDO_SELECTORS ) ) {
foreach ( static::VALID_ELEMENT_PSEUDO_SELECTORS[ $element ] as $pseudo_selector ) { foreach ( static::VALID_ELEMENT_PSEUDO_SELECTORS[ $element ] as $pseudo_selector ) {
if ( isset( $theme_json['styles']['blocks'][ $name ]['elements'][ $element ][ $pseudo_selector ] ) ) { if ( isset( $theme_json['styles']['blocks'][ $name ]['elements'][ $element ][ $pseudo_selector ] ) ) {
@ -2351,8 +2373,10 @@ class WP_Theme_JSON {
$element_pseudo_allowed = array(); $element_pseudo_allowed = array();
// TODO: Replace array_key_exists() with isset() check once WordPress drops /*
// support for PHP 5.6. See https://core.trac.wordpress.org/ticket/57067. * TODO: Replace array_key_exists() with isset() check once WordPress drops
* support for PHP 5.6. See https://core.trac.wordpress.org/ticket/57067.
*/
if ( array_key_exists( $current_element, static::VALID_ELEMENT_PSEUDO_SELECTORS ) ) { if ( array_key_exists( $current_element, static::VALID_ELEMENT_PSEUDO_SELECTORS ) ) {
$element_pseudo_allowed = static::VALID_ELEMENT_PSEUDO_SELECTORS[ $current_element ]; $element_pseudo_allowed = static::VALID_ELEMENT_PSEUDO_SELECTORS[ $current_element ];
} }
@ -2378,8 +2402,10 @@ class WP_Theme_JSON {
* Otherwise just compute the styles for the default selector as normal. * Otherwise just compute the styles for the default selector as normal.
*/ */
if ( $pseudo_selector && isset( $node[ $pseudo_selector ] ) && if ( $pseudo_selector && isset( $node[ $pseudo_selector ] ) &&
// TODO: Replace array_key_exists() with isset() check once WordPress drops /*
// support for PHP 5.6. See https://core.trac.wordpress.org/ticket/57067. * TODO: Replace array_key_exists() with isset() check once WordPress drops
* support for PHP 5.6. See https://core.trac.wordpress.org/ticket/57067.
*/
array_key_exists( $current_element, static::VALID_ELEMENT_PSEUDO_SELECTORS ) array_key_exists( $current_element, static::VALID_ELEMENT_PSEUDO_SELECTORS )
&& in_array( $pseudo_selector, static::VALID_ELEMENT_PSEUDO_SELECTORS[ $current_element ], true ) && in_array( $pseudo_selector, static::VALID_ELEMENT_PSEUDO_SELECTORS[ $current_element ], true )
) { ) {
@ -2869,9 +2895,10 @@ class WP_Theme_JSON {
/* /*
* $output is stripped of pseudo selectors. Re-add and process them * $output is stripped of pseudo selectors. Re-add and process them
* or insecure styles here. * or insecure styles here.
*
* TODO: Replace array_key_exists() with isset() check once WordPress drops
* support for PHP 5.6. See https://core.trac.wordpress.org/ticket/57067.
*/ */
// TODO: Replace array_key_exists() with isset() check once WordPress drops
// support for PHP 5.6. See https://core.trac.wordpress.org/ticket/57067.
if ( array_key_exists( $current_element, static::VALID_ELEMENT_PSEUDO_SELECTORS ) ) { if ( array_key_exists( $current_element, static::VALID_ELEMENT_PSEUDO_SELECTORS ) ) {
foreach ( static::VALID_ELEMENT_PSEUDO_SELECTORS[ $current_element ] as $pseudo_selector ) { foreach ( static::VALID_ELEMENT_PSEUDO_SELECTORS[ $current_element ] as $pseudo_selector ) {
if ( isset( $input[ $pseudo_selector ] ) ) { if ( isset( $input[ $pseudo_selector ] ) ) {
@ -2992,8 +3019,10 @@ class WP_Theme_JSON {
if ( static::is_safe_css_declaration( $declaration['name'], $declaration['value'] ) ) { if ( static::is_safe_css_declaration( $declaration['name'], $declaration['value'] ) ) {
$path = static::PROPERTIES_METADATA[ $declaration['name'] ]; $path = static::PROPERTIES_METADATA[ $declaration['name'] ];
// Check the value isn't an array before adding so as to not /*
// double up shorthand and longhand styles. * Check the value isn't an array before adding so as to not
* double up shorthand and longhand styles.
*/
$value = _wp_array_get( $input, $path, array() ); $value = _wp_array_get( $input, $path, array() );
if ( ! is_array( $value ) ) { if ( ! is_array( $value ) ) {
_wp_array_set( $output, $path, $value ); _wp_array_set( $output, $path, $value );
@ -3236,8 +3265,10 @@ class WP_Theme_JSON {
} }
} }
// If all of the static::APPEARANCE_TOOLS_OPT_INS are true, /*
// this code unsets them and sets 'appearanceTools' instead. * If all of the static::APPEARANCE_TOOLS_OPT_INS are true,
* this code unsets them and sets 'appearanceTools' instead.
*/
foreach ( $nodes as $node ) { foreach ( $nodes as $node ) {
$all_opt_ins_are_set = true; $all_opt_ins_are_set = true;
foreach ( static::APPEARANCE_TOOLS_OPT_INS as $opt_in_path ) { foreach ( static::APPEARANCE_TOOLS_OPT_INS as $opt_in_path ) {
@ -3245,8 +3276,10 @@ class WP_Theme_JSON {
foreach ( $opt_in_path as $opt_in_path_item ) { foreach ( $opt_in_path as $opt_in_path_item ) {
$full_path[] = $opt_in_path_item; $full_path[] = $opt_in_path_item;
} }
// Use "unset prop" as a marker instead of "null" because /*
// "null" can be a valid value for some props (e.g. blockGap). * Use "unset prop" as a marker instead of "null" because
* "null" can be a valid value for some props (e.g. blockGap).
*/
$opt_in_value = _wp_array_get( $output, $full_path, 'unset prop' ); $opt_in_value = _wp_array_get( $output, $full_path, 'unset prop' );
if ( 'unset prop' === $opt_in_value ) { if ( 'unset prop' === $opt_in_value ) {
$all_opt_ins_are_set = false; $all_opt_ins_are_set = false;
@ -3263,18 +3296,22 @@ class WP_Theme_JSON {
foreach ( $opt_in_path as $opt_in_path_item ) { foreach ( $opt_in_path as $opt_in_path_item ) {
$full_path[] = $opt_in_path_item; $full_path[] = $opt_in_path_item;
} }
// Use "unset prop" as a marker instead of "null" because /*
// "null" can be a valid value for some props (e.g. blockGap). * Use "unset prop" as a marker instead of "null" because
* "null" can be a valid value for some props (e.g. blockGap).
*/
$opt_in_value = _wp_array_get( $output, $full_path, 'unset prop' ); $opt_in_value = _wp_array_get( $output, $full_path, 'unset prop' );
if ( true !== $opt_in_value ) { if ( true !== $opt_in_value ) {
continue; continue;
} }
// The following could be improved to be path independent. /*
// At the moment it relies on a couple of assumptions: * The following could be improved to be path independent.
// * At the moment it relies on a couple of assumptions:
// - all opt-ins having a path of size 2. *
// - there's two sources of settings: the top-level and the block-level. * - all opt-ins having a path of size 2.
* - there's two sources of settings: the top-level and the block-level.
*/
if ( if (
( 1 === count( $node['path'] ) ) && ( 1 === count( $node['path'] ) ) &&
( 'settings' === $node['path'][0] ) ( 'settings' === $node['path'][0] )
@ -3510,12 +3547,13 @@ class WP_Theme_JSON {
* @return array The block's element selectors. * @return array The block's element selectors.
*/ */
protected static function get_block_element_selectors( $root_selector ) { protected static function get_block_element_selectors( $root_selector ) {
// Assign defaults, then override those that the block sets by itself. /*
// If the block selector is compounded, will append the element to each * Assign defaults, then override those that the block sets by itself.
// individual block selector. * If the block selector is compounded, will append the element to each
$block_selectors = explode( ',', $root_selector ); * individual block selector.
$element_selectors = array(); * $block_selectors = explode( ',', $root_selector );
* $element_selectors = array();
*/
foreach ( static::ELEMENTS as $el_name => $el_selector ) { foreach ( static::ELEMENTS as $el_name => $el_selector ) {
$element_selector = array(); $element_selector = array();
foreach ( $block_selectors as $selector ) { foreach ( $block_selectors as $selector ) {
@ -3554,8 +3592,10 @@ class WP_Theme_JSON {
$settings = _wp_array_get( $this->theme_json, array( 'settings' ) ); $settings = _wp_array_get( $this->theme_json, array( 'settings' ) );
foreach ( $metadata['selectors'] as $feature => $feature_selectors ) { foreach ( $metadata['selectors'] as $feature => $feature_selectors ) {
// Skip if this is the block's root selector or the block doesn't /*
// have any styles for the feature. * Skip if this is the block's root selector or the block doesn't
* have any styles for the feature.
*/
if ( 'root' === $feature || empty( $node[ $feature ] ) ) { if ( 'root' === $feature || empty( $node[ $feature ] ) ) {
continue; continue;
} }
@ -3566,8 +3606,10 @@ class WP_Theme_JSON {
continue; continue;
} }
// Create temporary node containing only the subfeature data /*
// to leverage existing `compute_style_properties` function. * Create temporary node containing only the subfeature data
* to leverage existing `compute_style_properties` function.
*/
$subfeature_node = array( $subfeature_node = array(
$feature => array( $feature => array(
$subfeature => $node[ $feature ][ $subfeature ], $subfeature => $node[ $feature ][ $subfeature ],
@ -3586,31 +3628,39 @@ class WP_Theme_JSON {
$declarations[ $subfeature_selector ] = $new_declarations; $declarations[ $subfeature_selector ] = $new_declarations;
} }
// Remove the subfeature from the block's node now its /*
// styles will be included under its own selector not the * Remove the subfeature from the block's node now its
// block's. * styles will be included under its own selector not the
* block's.
*/
unset( $node[ $feature ][ $subfeature ] ); unset( $node[ $feature ][ $subfeature ] );
} }
} }
// Now subfeatures have been processed and removed we can process /*
// feature root selector or simple string selector. * Now subfeatures have been processed and removed we can process
* feature root selector or simple string selector.
*/
if ( if (
is_string( $feature_selectors ) || is_string( $feature_selectors ) ||
( isset( $feature_selectors['root'] ) && $feature_selectors['root'] ) ( isset( $feature_selectors['root'] ) && $feature_selectors['root'] )
) { ) {
$feature_selector = is_string( $feature_selectors ) ? $feature_selectors : $feature_selectors['root']; $feature_selector = is_string( $feature_selectors ) ? $feature_selectors : $feature_selectors['root'];
// Create temporary node containing only the feature data /*
// to leverage existing `compute_style_properties` function. * Create temporary node containing only the feature data
* to leverage existing `compute_style_properties` function.
*/
$feature_node = array( $feature => $node[ $feature ] ); $feature_node = array( $feature => $node[ $feature ] );
// Generate the style declarations. // Generate the style declarations.
$new_declarations = static::compute_style_properties( $feature_node, $settings, null, $this->theme_json ); $new_declarations = static::compute_style_properties( $feature_node, $settings, null, $this->theme_json );
// Merge new declarations with any that already exist for /*
// the feature selector. This may occur when multiple block * Merge new declarations with any that already exist for
// support features use the same custom selector. * the feature selector. This may occur when multiple block
* support features use the same custom selector.
*/
if ( isset( $declarations[ $feature_selector ] ) ) { if ( isset( $declarations[ $feature_selector ] ) ) {
foreach ( $new_declarations as $new_declaration ) { foreach ( $new_declarations as $new_declaration ) {
$declarations[ $feature_selector ][] = $new_declaration; $declarations[ $feature_selector ][] = $new_declaration;
@ -3619,8 +3669,10 @@ class WP_Theme_JSON {
$declarations[ $feature_selector ] = $new_declarations; $declarations[ $feature_selector ] = $new_declarations;
} }
// Remove the feature from the block's node now its styles /*
// will be included under its own selector not the block's. * Remove the feature from the block's node now its styles
* will be included under its own selector not the block's.
*/
unset( $node[ $feature ] ); unset( $node[ $feature ] );
} }
} }

2
wp-includes/version.php
View File

@ -16,7 +16,7 @@
* *
* @global string $wp_version * @global string $wp_version
*/ */
$wp_version = '6.3-beta3-56178'; $wp_version = '6.3-beta3-56179';
/** /**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema. * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.