Changeset 47794

Timestamp:

05/14/2020 12:49:00 PM (5 years ago)

Author:

SergeyBiryukov

Message:

Docs: Add @since notes for theme features added or removed in get_theme_feature_list() after its introduction in WordPress 3.1.

See #50165.

Location:

trunk/src

Files:

• wp-admin/includes/theme.php (modified) (2 diffs)
• wp-admin/theme-install.php (modified) (1 diff)
• wp-includes/class-wp-theme.php (modified) (2 diffs)
• wp-includes/customize/class-wp-customize-themes-section.php (modified) (1 diff)

trunk/src/wp-admin/includes/theme.php

@@ -257 +257 @@
  *
  * @since 3.1.0
+ * @since 3.2.0 Added 'Gray' color and 'Featured Image Header', 'Featured Images',
+ *              'Full Width Template', and 'Post Formats' features.
+ * @since 3.5.0 Added 'Flexible Header' feature.
+ * @since 3.8.0 Renamed 'Width' filter to 'Layout'.
+ * @since 3.8.0 Renamed 'Fixed Width' and 'Flexible Width' options
+ *              to 'Fixed Layout' and 'Fluid Layout'.
+ * @since 3.8.0 Added 'Accessibility Ready' feature and 'Responsive Layout' option.
+ * @since 3.9.0 Combined 'Layout' and 'Columns' filters.
+ * @since 4.6.0 Removed 'Colors' filter.
+ * @since 4.6.0 Added 'Grid Layout' option.
+ *              Removed 'Fixed Layout', 'Fluid Layout', and 'Responsive Layout' options.
+ * @since 4.6.0 Added 'Custom Logo' and 'Footer Widgets' features.
+ *              Removed 'Blavatar' feature.
+ * @since 4.6.0 Added 'Blog', 'E-Commerce', 'Education', 'Entertainment', 'Food & Drink',
+ *              'Holiday', 'News', 'Photography', and 'Portfolio' subjects.
+ *              Removed 'Photoblogging' and 'Seasonal' subjects.
+ * @since 4.9.0 Reordered the filters from 'Layout', 'Features', 'Subject'
+ *              to 'Subject', 'Features', 'Layout'.
+ * @since 4.9.0 Removed 'BuddyPress', 'Custom Menu', 'Flexible Header',
+ *              'Front Page Posting', 'Microformats', 'RTL Language Support',
+ *              'Threaded Comments', and 'Translation Ready' features.
+ * @since 5.5.0 Added 'Block Editor Styles' and 'Wide Blocks' features.
  *
  * @param bool $api Optional. Whether try to fetch tags from the WordPress.org API. Defaults to true.
@@ -335 +357 @@
     );
 
+    $wporg_features = array();
+
     // Loop over the wp.org canonical list and apply translations.
-    $wporg_features = array();
     foreach ( (array) $feature_list as $feature_category => $feature_items ) {
         if ( isset( $category_translations[ $feature_category ] ) ) {
             $feature_category = $category_translations[ $feature_category ];
         }
+
         $wporg_features[ $feature_category ] = array();
 

trunk/src/wp-admin/theme-install.php

@@ -209 +209 @@
             </div>
         <?php
-        $feature_list = get_theme_feature_list( false ); // Use the core list, rather than the .org API, due to inconsistencies and to ensure tags are translated.
+        // Use the core list, rather than the .org API, due to inconsistencies
+        // and to ensure tags are translated.
+        $feature_list = get_theme_feature_list( false );
+
         foreach ( $feature_list as $feature_name => $features ) {
             echo '<fieldset class="filter-group">';

trunk/src/wp-includes/class-wp-theme.php

@@ -935 +935 @@
                     return $this->name_translated;
                 }
+
                 // phpcs:ignore WordPress.WP.I18n.LowLevelTranslationFunction,WordPress.WP.I18n.NonSingularStringLiteralText,WordPress.WP.I18n.NonSingularStringLiteralDomain
                 $this->name_translated = translate( $value, $this->get( 'TextDomain' ) );
+
                 return $this->name_translated;
             case 'Tags':
@@ -971 +973 @@
 
                     $feature_list = get_theme_feature_list( false ); // No API.
+
                     foreach ( $feature_list as $tags ) {
                         $tags_list += $tags;

trunk/src/wp-includes/customize/class-wp-customize-themes-section.php

@@ -165 +165 @@
      */
     protected function filter_drawer_content_template() {
-        $feature_list = get_theme_feature_list( false ); // @todo Use the .org API instead of the local core feature list. The .org API is currently outdated and will be reconciled when the .org themes directory is next redesigned.
+        // @todo Use the .org API instead of the local core feature list.
+        // The .org API is currently outdated and will be reconciled when the .org themes directory is next redesigned.
+        $feature_list = get_theme_feature_list( false );
         ?>
         <# if ( 'wporg' === data.action ) { #>