Tag 5.8

Built from https://develop.svn.wordpress.org/tags/5.8@51465


git-svn-id: http://core.svn.wordpress.org/tags/5.8@51076 1a063a9b-81f0-0310-95a4-ce76da25c4cd

readme.html

@@ -76,7 +76,7 @@
 	<dt><a href="https://wordpress.org/support/forums/">WordPress Support Forums</a></dt>
 		<dd>If you&#8217;ve looked everywhere and still can&#8217;t find an answer, the support forums are very active and have a large community ready to help. To help them help you be sure to use a descriptive thread title and describe your question in as much detail as possible.</dd>
 	<dt><a href="https://make.wordpress.org/support/handbook/appendix/other-support-locations/introduction-to-irc/">WordPress <abbr>IRC</abbr> (Internet Relay Chat) Channel</a></dt>
-		<dd>There is an online chat channel that is used for discussion among people who use WordPress and occasionally support topics. The above wiki page should point you in the right direction. (<a href="irc://irc.freenode.net/wordpress">irc.freenode.net #wordpress</a>)</dd>
+		<dd>There is an online chat channel that is used for discussion among people who use WordPress and occasionally support topics. The above wiki page should point you in the right direction. (<a href="https://web.libera.chat/#wordpress">irc.libera.chat #wordpress</a>)</dd>
 </dl>
 
 <h2>Final Notes</h2>

wp-admin/about.php

@@ -9,9 +9,6 @@
 /** WordPress Administration Bootstrap */
 require_once __DIR__ . '/admin.php';
 
-wp_enqueue_script( 'wp-components' );
-wp_enqueue_style( 'wp-components' );
-
 /* translators: Page title of the About WordPress page in the admin. */
 $title = _x( 'About', 'page title' );
 
@@ -44,13 +41,15 @@ require_once ABSPATH . 'wp-admin/admin-header.php';
 		<hr />
 
 		<div class="about__section">
-			<h2 class="aligncenter has-accent-color">
+			<h2 class="aligncenter">
 				<?php _e( 'Three Essential Powerhouses' ); ?>
 			</h2>
 		</div>
 
 		<div class="about__section has-2-columns is-wider-left">
-			<div class="column about__image has-subtle-background-color"></div>
+			<div class="column about__image is-vertically-aligned-center">
+				<img src="https://s.w.org/images/core/5.8/about-widgets-blocks.png" alt="" />
+			</div>
 			<div class="column">
 				<h3>
 					<?php _e( 'Manage Widgets with Blocks' ); ?>
@@ -60,37 +59,31 @@ require_once ABSPATH . 'wp-admin/admin-header.php';
 					printf(
 						/* translators: %s: Widgets dev note link. */
 						__( 'After months of hard work, the power of blocks has come to both the Block Widgets Editor and the Customizer. Now you can add blocks both in widget areas across your site and with live preview through the Customizer. This opens up new possibilities to create content: from no-code mini layouts to the vast library of core and third-party blocks. For our developers, you can find more details in the <a href="%s">Widgets dev note</a>.' ),
-						'#'
+						'https://make.wordpress.org/core/2021/06/29/block-based-widgets-editor-in-wordpress-5-8/'
 					);
 					?>
 				</p>
 			</div>
 		</div>
 
-		<hr />
-
 		<div class="about__section has-2-columns is-wider-right">
 			<div class="column">
 				<h3>
 					<?php _e( 'Display Posts with New Blocks and Patterns' ); ?>
 				</h3>
 				<p>
-					<?php
-					printf(
-						/* translators: %s: Query Loop dev note link. */
-						__( 'The Query Loop Block makes it possible to display posts based on specified parameters; like a PHP loop without the code. Easily display posts from a specific category, to do things like create a portfolio or a page full of your favorite recipes. Think of it as a more complex and powerful Latest Posts Block! Plus, pattern suggestions make it easier than ever to create a list of posts with the design you want. For our theme authors, learn more about experimenting with this awesome tool in the <a href="%s">Query Loop Block dev note</a>.' ),
-						'#'
-					);
-					?>
+					<?php _e( 'The Query Loop Block makes it possible to display posts based on specified parameters; like a PHP loop without the code. Easily display posts from a specific category, to do things like create a portfolio or a page full of your favorite recipes. Think of it as a more complex and powerful Latest Posts Block! Plus, pattern suggestions make it easier than ever to create a list of posts with the design you want.' ); ?>
 				</p>
 			</div>
-			<div class="column about__image has-subtle-background-color"></div>
+			<div class="column about__image is-vertically-aligned-center">
+				<img src="https://s.w.org/images/core/5.8/about-query-loop.png" alt="" />
+			</div>
 		</div>
 
-		<hr />
-
 		<div class="about__section has-2-columns is-wider-left">
-			<div class="column about__image has-subtle-background-color"></div>
+			<div class="column about__image is-vertically-aligned-center">
+				<img src="https://s.w.org/images/core/5.8/about-template.png" alt="" />
+			</div>
 			<div class="column">
 				<h3>
 					<?php _e( 'Edit the Templates Around Posts' ); ?>
@@ -106,13 +99,15 @@ require_once ABSPATH . 'wp-admin/admin-header.php';
 		<hr class="is-large" />
 
 		<div class="about__section">
-			<h2 class="aligncenter has-accent-color">
+			<h2 class="aligncenter">
 				<?php _e( 'Three Workflow Helpers' ); ?>
 			</h2>
 		</div>
 
 		<div class="about__section has-2-columns is-wider-left">
-			<div class="column about__image has-subtle-background-color"></div>
+			<div class="column about__image is-vertically-aligned-center">
+				<img src="https://s.w.org/images/core/5.8/about-list-view.png" alt="" />
+			</div>
 			<div class="column">
 				<h3>
 					<?php _e( 'Overview of the Page Structure' ); ?>
@@ -125,8 +120,6 @@ require_once ABSPATH . 'wp-admin/admin-header.php';
 			</div>
 		</div>
 
-		<hr />
-
 		<div class="about__section has-2-columns is-wider-right">
 			<div class="column">
 				<h3>
@@ -138,13 +131,15 @@ require_once ABSPATH . 'wp-admin/admin-header.php';
 					?>
 				</p>
 			</div>
-			<div class="column about__image has-subtle-background-color"></div>
+			<div class="column about__image is-vertically-aligned-center">
+				<img src="https://s.w.org/images/core/5.8/about-pattern-suggestions.png" alt="" />
+			</div>
 		</div>
 
-		<hr />
-
 		<div class="about__section has-2-columns is-wider-left">
-			<div class="column about__image has-subtle-background-color"></div>
+			<div class="column about__image is-vertically-aligned-center">
+				<img src="https://s.w.org/images/core/5.8/about-duotone.png" alt="" />
+			</div>
 			<div class="column">
 				<h3>
 					<?php _e( 'Style and Colorize Images' ); ?>
@@ -160,10 +155,15 @@ require_once ABSPATH . 'wp-admin/admin-header.php';
 		<hr class="is-large" />
 
 		<div class="about__section">
-			<h2 class="aligncenter has-accent-color">
+			<h2 class="aligncenter" style="margin-bottom:0;">
 				<?php _e( 'For Developers to Explore' ); ?>
 			</h2>
-			<div class="column about__image has-subtle-background-color" style="margin:32px 0;height:360px;"></div>
+			<div class="column about__image is-vertically-aligned-center">
+				<picture>
+					<source srcset="https://s.w.org/images/core/5.8/about-theme-json.png, https://s.w.org/images/core/5.8/about-theme-json-2x.png 2x">
+					<img src="https://s.w.org/images/core/5.8/about-theme-json.png" alt="">
+				</picture>
+			</div>
 		</div>
 
 		<div class="about__section has-1-column">
@@ -173,14 +173,16 @@ require_once ABSPATH . 'wp-admin/admin-header.php';
 				</h3>
 				<p>
 					<?php
-					_e( 'Introducing the Global Styles and Global Settings APIs: control the editor settings, available customization tools, and style blocks using a theme.json file in the active theme. This configuration file enables or disables features and sets default styles for both a website and blocks. If you build themes, you can experiment with this early iteration of a useful new feature. For more about what is currently available and how it works, check out this dev note.' );
+					printf(
+						/* translators: %s: Theme.json dev note link. */
+						__( 'Introducing the Global Styles and Global Settings APIs: control the editor settings, available customization tools, and style blocks using a theme.json file in the active theme. This configuration file enables or disables features and sets default styles for both a website and blocks. If you build themes, you can experiment with this early iteration of a useful new feature. For more about what is currently available and how it works, <a href="%s">check out this dev note</a>.' ),
+						'https://make.wordpress.org/core/2021/06/25/introducing-theme-json-in-wordpress-5-8/'
+					);
 					?>
 				</p>
 			</div>
 		</div>
 
-		<hr />
-
 		<div class="about__section has-3-columns">
 			<div class="column">
 				<h3>
@@ -213,8 +215,8 @@ require_once ABSPATH . 'wp-admin/admin-header.php';
 				<p>
 					<?php
 					printf(
-						/* translators: %1$s: Link to 5.6's block dev notes. %2$s: Link to 5.7's block dev notes. %1$s: Link to 5.8's block dev notes. */
-						__( 'Expanding on previously implemented block supports in WordPress <a href="%1$s">5.6</a> and <a href="%2$s">5.7</a>, WordPress 5.8 introduces several new block <code>supports</code> flags and new options to customize your registered blocks. More information is available in the <a href="%3$s">block supports dev note</a>.' ),
+						/* translators: %1$s: Link to 5.6's block dev notes. %2$s: Link to 5.7's block dev notes. %3$s: Link to 5.8's block dev notes. */
+						__( 'Expanding on previously implemented block supports in WordPress <a href="%1$s">5.6</a> and <a href="%2$s">5.7</a>, WordPress 5.8 introduces several new block support flags and new options to customize your registered blocks. More information is available in the <a href="%3$s">block supports dev note</a>.' ),
 						'https://make.wordpress.org/core/2020/11/18/block-supports-in-wordpress-5-6/',
 						'https://make.wordpress.org/core/2021/02/24/changes-to-block-editor-components-and-blocks/',
 						'https://make.wordpress.org/core/2021/06/25/block-supports-api-updates-for-wordpress-5-8/'
@@ -234,7 +236,7 @@ require_once ABSPATH . 'wp-admin/admin-header.php';
 					printf(
 						/* translators: %s: WordPress 5.8 Field Guide link. */
 						__( 'Check out the latest version of the WordPress Field Guide. It highlights developer notes for each change you may want to be aware of. <a href="%s">WordPress 5.8 Field Guide.</a>' ),
-						'#'
+						'https://make.wordpress.org/core/2021/07/03/wordpress-5-8-field-guide/'
 					);
 					?>
 				</p>

wp-admin/credits.php

@@ -39,34 +39,28 @@ $credits = wp_credits();
 		</nav>
 	</div>
 
-	<div class="about__section is-feature">
+	<div class="about__section has-1-column">
 		<div class="column aligncenter">
 			<?php if ( ! $credits ) : ?>
 
 			<p>
 				<?php
 				printf(
-					/* translators: 1: https://wordpress.org/about/, 2: https://make.wordpress.org/ */
-					__( 'WordPress is created by a <a href="%1$s">worldwide team</a> of passionate individuals. <a href="%2$s">Get involved in WordPress</a>.' ),
-					__( 'https://wordpress.org/about/' ),
-					__( 'https://make.wordpress.org/' )
+					/* translators: 1: https://wordpress.org/about/ */
+					__( 'WordPress is created by a <a href="%1$s">worldwide team</a> of passionate individuals.' ),
+					__( 'https://wordpress.org/about/' )
 				);
 				?>
+				<br />
+				<a href="https://make.wordpress.org/"><?php _e( 'Get involved in WordPress.' ); ?></a>
 			</p>
 
 			<?php else : ?>
 
 			<p>
-				<?php _e( 'WordPress is created by a worldwide team of passionate individuals.' ); ?>
-			</p>
-			<p>
-				<?php
-				printf(
-					/* translators: %s: https://make.wordpress.org/ */
-					__( 'Want to see your name in lights on this page? <a href="%s">Get involved in WordPress</a>.' ),
-					__( 'https://make.wordpress.org/' )
-				);
-				?>
+				<?php _e( 'Want to see your name in lights on this page?' ); ?>
+				<br />
+				<a href="https://make.wordpress.org/"><?php _e( 'Get involved in WordPress.' ); ?></a>
 			</p>
 
 			<?php endif; ?>

wp-admin/css/about-rtl.css

@@ -792,16 +792,16 @@
 .about__section .wp-person-avatar {
 	display: block;
 	margin: 0 auto calc(var(--gap) / 2);
-	width: 160px;
-	height: 160px;
+	width: 140px;
+	height: 140px;
 	border-radius: 100%;
 	overflow: hidden;
 	background: var(--accent-1);
 }
 
 .about__section .wp-person .gravatar {
-	width: 160px;
-	height: 160px;
+	width: 140px;
+	height: 140px;
 	filter: grayscale(100%);
 	mix-blend-mode: screen;
 }
@@ -880,8 +880,9 @@
   3.0 - Freedoms Page
 ------------------------------------------------------------------------------*/
 
-.about__section .column .freedoms-image {
-	margin-bottom: 1em;
+.about__section .column .freedom-image {
+	margin-bottom: var(--gap);
+	max-height: 140px;
 }
 
 

wp-admin/css/about.css

@@ -791,16 +791,16 @@
 .about__section .wp-person-avatar {
 	display: block;
 	margin: 0 auto calc(var(--gap) / 2);
-	width: 160px;
-	height: 160px;
+	width: 140px;
+	height: 140px;
 	border-radius: 100%;
 	overflow: hidden;
 	background: var(--accent-1);
 }
 
 .about__section .wp-person .gravatar {
-	width: 160px;
-	height: 160px;
+	width: 140px;
+	height: 140px;
 	filter: grayscale(100%);
 	mix-blend-mode: screen;
 }
@@ -879,8 +879,9 @@
   3.0 - Freedoms Page
 ------------------------------------------------------------------------------*/
 
-.about__section .column .freedoms-image {
-	margin-bottom: 1em;
+.about__section .column .freedom-image {
+	margin-bottom: var(--gap);
+	max-height: 140px;
 }
 
 

wp-admin/css/common-rtl.css

@@ -3154,6 +3154,7 @@ img {
 	font-size: 13px;
 	background: #f6f7f7;
 	-moz-tab-size: 4;
+	-o-tab-size: 4;
 	tab-size: 4;
 }
 

wp-admin/css/common.css

@@ -3153,6 +3153,7 @@ img {
 	font-size: 13px;
 	background: #f6f7f7;
 	-moz-tab-size: 4;
+	-o-tab-size: 4;
 	tab-size: 4;
 }
 

wp-admin/css/customize-controls-rtl.css

@@ -1579,6 +1579,7 @@ p.customize-section-description {
 	font-size: 12px;
 	padding: 6px 8px;
 	-moz-tab-size: 2;
+	-o-tab-size: 2;
 	tab-size: 2;
 }
 .customize-control-code_editor textarea,

wp-admin/css/customize-controls.css

@@ -1578,6 +1578,7 @@ p.customize-section-description {
 	font-size: 12px;
 	padding: 6px 8px;
 	-moz-tab-size: 2;
+	-o-tab-size: 2;
 	tab-size: 2;
 }
 .customize-control-code_editor textarea,

wp-admin/css/edit-rtl.css

@@ -976,6 +976,10 @@ form#tags-filter {
 	margin: 0 0 1em;
 }
 
+.privacy-text-copy span {
+	pointer-events: none;
+}
+
 .privacy-settings-accordion-panel .wp-suggested-text > *:not(h1):not(h2):not(h3):not(h4):not(h5):not(h6):not(div):not(.privacy-policy-tutorial):not(.wp-policy-help):not(.privacy-text-copy):not(span.success):not(.notice p),
 .privacy-settings-accordion-panel .wp-suggested-text div > *:not(h1):not(h2):not(h3):not(h4):not(h5):not(h6):not(div):not(.privacy-policy-tutorial):not(.wp-policy-help):not(.privacy-text-copy):not(span.success):not(.notice p),
 .privacy-settings-accordion-panel > *:not(h1):not(h2):not(h3):not(h4):not(h5):not(h6):not(div):not(.privacy-policy-tutorial):not(.wp-policy-help):not(.privacy-text-copy):not(span.success):not(.notice p),

wp-admin/css/edit.css

@@ -975,6 +975,10 @@ form#tags-filter {
 	margin: 0 0 1em;
 }
 
+.privacy-text-copy span {
+	pointer-events: none;
+}
+
 .privacy-settings-accordion-panel .wp-suggested-text > *:not(h1):not(h2):not(h3):not(h4):not(h5):not(h6):not(div):not(.privacy-policy-tutorial):not(.wp-policy-help):not(.privacy-text-copy):not(span.success):not(.notice p),
 .privacy-settings-accordion-panel .wp-suggested-text div > *:not(h1):not(h2):not(h3):not(h4):not(h5):not(h6):not(div):not(.privacy-policy-tutorial):not(.wp-policy-help):not(.privacy-text-copy):not(span.success):not(.notice p),
 .privacy-settings-accordion-panel > *:not(h1):not(h2):not(h3):not(h4):not(h5):not(h6):not(div):not(.privacy-policy-tutorial):not(.wp-policy-help):not(.privacy-text-copy):not(span.success):not(.notice p),

wp-admin/freedoms.php

@@ -42,38 +42,36 @@ require_once ABSPATH . 'wp-admin/admin-header.php';
 		</nav>
 	</div>
 
-	<div class="about__section has-subtle-background-color is-feature">
+	<div class="about__section is-feature">
 		<p class="about-description">
 		<?php
 		printf(
 			/* translators: %s: https://wordpress.org/about/license/ */
-			__( 'WordPress is Free and open source software, built by a distributed community of mostly volunteer developers from around the world. WordPress comes with some awesome, worldview-changing rights courtesy of its <a href="%s">license</a>, the GPL.' ),
+			__( 'WordPress comes with some awesome, worldview-changing rights courtesy of its <a href="%s">license</a>, the GPL.' ),
 			__( 'https://wordpress.org/about/license/' )
 		);
 		?>
 		</p>
 	</div>
 
-	<hr />
-
-	<div class="about__section has-4-columns">
-		<div class="column">
-			<div class="freedoms-image"></div>
+	<div class="about__section has-2-columns">
+		<div class="column aligncenter">
+			<img class="freedom-image" src="<?php echo esc_url( admin_url( 'images/freedom-1.svg' ) ); ?>" alt="" />
 			<h2 class="is-smaller-heading"><?php _e( 'The 1st Freedom' ); ?></h2>
 			<p><?php _e( 'To run the program for any purpose.' ); ?></p>
 		</div>
-		<div class="column">
-			<div class="freedoms-image"></div>
+		<div class="column aligncenter">
+			<img class="freedom-image" src="<?php echo esc_url( admin_url( 'images/freedom-2.svg' ) ); ?>" alt="" />
 			<h2 class="is-smaller-heading"><?php _e( 'The 2nd Freedom' ); ?></h2>
 			<p><?php _e( 'To study how the program works and change it to make it do what you wish.' ); ?></p>
 		</div>
-		<div class="column">
-			<div class="freedoms-image"></div>
+		<div class="column aligncenter">
+			<img class="freedom-image" src="<?php echo esc_url( admin_url( 'images/freedom-3.svg' ) ); ?>" alt="" />
 			<h2 class="is-smaller-heading"><?php _e( 'The 3rd Freedom' ); ?></h2>
 			<p><?php _e( 'To redistribute.' ); ?></p>
 		</div>
-		<div class="column">
-			<div class="freedoms-image"></div>
+		<div class="column aligncenter">
+			<img class="freedom-image" src="<?php echo esc_url( admin_url( 'images/freedom-4.svg' ) ); ?>" alt="" />
 			<h2 class="is-smaller-heading"><?php _e( 'The 4th Freedom' ); ?></h2>
 			<p><?php _e( 'To distribute copies of your modified versions to others.' ); ?></p>
 		</div>

wp-admin/images/freedom-1.svg

@@ -0,0 +1,12 @@
+<svg width="157" height="148" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <path d="M146.643 77.521c.122-1.213.122-2.547.122-3.76C146.765 33.622 114.143 1 74.003 1S1.24 33.621 1.24 73.762c0 40.14 32.622 72.761 72.762 72.761 33.713 0 62.09-22.919 70.336-53.965" fill="#fff"/>
+  <path d="M146.643 77.521c.122-1.213.122-2.547.122-3.76C146.765 33.622 114.143 1 74.003 1S1.24 33.621 1.24 73.762c0 40.14 32.622 72.761 72.762 72.761 33.713 0 62.09-22.919 70.336-53.965" stroke="#3858E9" stroke-width="1.5" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M156.224 67.941l-9.517 10.182-9.401-10.182" stroke="#3858E9" stroke-width="1.5" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M74.003 124.694c28.129 0 50.933-22.803 50.933-50.933s-22.804-50.933-50.933-50.933c-28.13 0-50.934 22.804-50.934 50.933 0 28.13 22.804 50.933 50.934 50.933z" fill="url(#paint0_linear)" stroke="#3858E9" stroke-width="1.5" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round"/>
+  <defs>
+    <linearGradient id="paint0_linear" x1="74.003" y1="22.828" x2="74.003" y2="124.694" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#ECF5FF"/>
+      <stop offset="1" stop-color="#fff"/>
+    </linearGradient>
+  </defs>
+</svg>

wp-admin/images/freedom-2.svg

@@ -0,0 +1,13 @@
+<svg width="165" height="143" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <path d="M71.035 140.703c38.578 0 69.852-31.274 69.852-69.852S109.613 1 71.035 1C32.458 1 1.185 32.273 1.185 70.851s31.273 69.852 69.85 69.852z" fill="url(#paint0_linear)" stroke="#3858E9" stroke-width="1.5" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M70.962 78.994a8.122 8.122 0 100-16.245 8.122 8.122 0 000 16.245z" fill="#fff" stroke="#3858E9" stroke-width="1.5" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round"/>
+  <path fill-rule="evenodd" clip-rule="evenodd" d="M104.862 44.282c18.029 12.1 24.216 35.21 15.548 54.243l35.054 23.526a7.105 7.105 0 01-7.918 11.797l-35.054-23.526c-14.33 15.231-38.06 18.261-56.089 6.161-20.048-13.456-25.453-40.527-12.071-60.465 13.381-19.938 40.482-25.192 60.53-11.736zm-6.478 9.652c14.688 9.858 18.648 29.692 8.844 44.299s-29.659 18.456-44.347 8.598c-14.688-9.858-18.648-29.692-8.844-44.299s29.659-18.456 44.347-8.598z" fill="#fff" stroke="#3858E9" stroke-width="1.5" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round"/>
+  <rect x="88.861" y="68.954" width="10.585" height="26.464" rx="5.293" transform="rotate(-8.376 88.861 68.954)" fill="#fff" stroke="#3858E9" stroke-width="1.5" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M81.965 86.033l-4.21 16.373-12.163-12.163 16.373-4.21z" fill="#fff" stroke="#3858E9" stroke-width="1.5" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round"/>
+  <defs>
+    <linearGradient id="paint0_linear" x1="71.035" y1="1" x2="71.035" y2="140.703" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#ECF5FF"/>
+      <stop offset="1" stop-color="#fff"/>
+    </linearGradient>
+  </defs>
+</svg>

wp-admin/images/freedom-3.svg

@@ -0,0 +1,37 @@
+<svg width="193" height="213" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <path d="M96.591 47.235c12.623 0 22.856-10.233 22.856-22.856 0-12.623-10.233-22.856-22.856-22.856-12.623 0-22.856 10.233-22.856 22.856 0 12.623 10.233 22.856 22.856 22.856z" fill="url(#paint0_linear)" stroke="#3858E9" stroke-width="1.5" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M22.402 89.438c12.193 3.267 24.726-3.969 27.993-16.162 3.267-12.193-3.969-24.725-16.162-27.992-12.192-3.267-24.725 3.968-27.992 16.161-3.267 12.193 3.968 24.726 16.161 27.993z" fill="url(#paint1_linear)" stroke="#3858E9" stroke-width="1.5" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M170.78 89.438c12.193-3.267 19.428-15.8 16.161-27.992-3.267-12.193-15.8-19.43-27.992-16.162-12.193 3.267-19.429 15.8-16.162 27.992 3.267 12.193 15.8 19.43 27.993 16.162z" fill="url(#paint2_linear)" stroke="#3858E9" stroke-width="1.5" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M34.234 167.57c12.193-3.268 19.428-15.8 16.161-27.993-3.267-12.193-15.8-19.429-27.992-16.162-12.193 3.267-19.429 15.8-16.162 27.993 3.267 12.193 15.8 19.429 27.993 16.162z" fill="url(#paint3_linear)" stroke="#3858E9" stroke-width="1.5" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M157.423 167.569c12.193 3.267 24.726-3.968 27.993-16.161 3.267-12.193-3.969-24.726-16.162-27.993-12.193-3.267-24.725 3.969-27.992 16.162-3.267 12.193 3.968 24.725 16.161 27.992z" fill="url(#paint4_linear)" stroke="#3858E9" stroke-width="1.5" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M95.83 211.329c12.622 0 22.855-10.233 22.855-22.855 0-12.623-10.233-22.856-22.856-22.856-12.622 0-22.855 10.233-22.855 22.856 0 12.622 10.233 22.855 22.855 22.855z" fill="url(#paint5_linear)" stroke="#3858E9" stroke-width="1.5" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M96.59 144.377c21.073 0 38.158-17.158 38.158-38.324 0-21.165-17.085-38.323-38.159-38.323-21.074 0-38.158 17.157-38.158 38.323s17.084 38.324 38.158 38.324z" fill="#fff" stroke="#3858E9" stroke-width="1.5" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M79.243 108.789c0 9.705 7.93 17.42 17.345 17.42 9.416 0 17.345-7.964 17.345-17.42" stroke="#3858E9" stroke-width="1.5" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M90.883 95.351a3.72 3.72 0 01-3.71 3.73 3.72 3.72 0 01-3.71-3.73 3.72 3.72 0 013.71-3.729 3.72 3.72 0 013.71 3.73zM109.715 95.351a3.72 3.72 0 01-3.71 3.73 3.72 3.72 0 01-3.71-3.73 3.72 3.72 0 013.71-3.729 3.72 3.72 0 013.71 3.73z" fill="#3858E9" stroke="#3858E9" stroke-width="1.5"/>
+  <defs>
+    <linearGradient id="paint0_linear" x1="96.591" y1="1.523" x2="96.591" y2="47.235" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#ECF5FF"/>
+      <stop offset="1" stop-color="#fff"/>
+    </linearGradient>
+    <linearGradient id="paint1_linear" x1="34.233" y1="45.284" x2="22.402" y2="89.438" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#ECF5FF"/>
+      <stop offset="1" stop-color="#fff"/>
+    </linearGradient>
+    <linearGradient id="paint2_linear" x1="158.949" y1="45.284" x2="170.78" y2="89.438" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#ECF5FF"/>
+      <stop offset="1" stop-color="#fff"/>
+    </linearGradient>
+    <linearGradient id="paint3_linear" x1="22.403" y1="123.415" x2="34.234" y2="167.57" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#ECF5FF"/>
+      <stop offset="1" stop-color="#fff"/>
+    </linearGradient>
+    <linearGradient id="paint4_linear" x1="169.254" y1="123.415" x2="157.423" y2="167.569" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#ECF5FF"/>
+      <stop offset="1" stop-color="#fff"/>
+    </linearGradient>
+    <linearGradient id="paint5_linear" x1="95.829" y1="165.618" x2="95.829" y2="211.329" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#ECF5FF"/>
+      <stop offset="1" stop-color="#fff"/>
+    </linearGradient>
+  </defs>
+</svg>

wp-admin/images/freedom-4.svg

@@ -0,0 +1,28 @@
+<svg width="245" height="155" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <path d="M66.54 55.02L39.693 9.126 12.96 55.02h53.58z" fill="url(#paint0_linear)" stroke="#3858E9" stroke-width="1.5" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M39.75 153.084c21.074 0 38.158-17.158 38.158-38.324 0-21.165-17.084-38.323-38.159-38.323-21.074 0-38.158 17.158-38.158 38.323 0 21.166 17.084 38.324 38.158 38.324z" fill="#fff" stroke="#3858E9" stroke-width="1.5" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M22.404 117.499c0 9.706 7.929 17.42 17.345 17.42 9.415 0 17.344-7.963 17.344-17.42" stroke="#3858E9" stroke-width="1.5" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M34.044 104.061c0 2.063-1.664 3.73-3.71 3.73-2.046 0-3.71-1.667-3.71-3.73a3.72 3.72 0 013.71-3.729 3.72 3.72 0 013.71 3.729zM52.872 104.061a3.72 3.72 0 01-3.71 3.729 3.72 3.72 0 01-3.71-3.729c0-2.063 1.664-3.73 3.71-3.73 2.046 0 3.71 1.667 3.71 3.73z" fill="#3858E9" stroke="#3858E9" stroke-width="1.5"/>
+  <path d="M122.734 85.772c21.074 0 38.158-17.158 38.158-38.324 0-21.165-17.084-38.323-38.158-38.323-21.075 0-38.159 17.158-38.159 38.323 0 21.166 17.084 38.324 38.159 38.324z" fill="#fff" stroke="#3858E9" stroke-width="1.5" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M105.392 50.188c0 9.705 7.929 17.42 17.344 17.42 9.416 0 17.345-7.964 17.345-17.42" stroke="#3858E9" stroke-width="1.5" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M117.031 36.75a3.72 3.72 0 01-3.71 3.728 3.72 3.72 0 01-3.71-3.729 3.72 3.72 0 013.71-3.73 3.72 3.72 0 013.71 3.73zM135.864 36.748a3.72 3.72 0 01-3.711 3.73 3.72 3.72 0 01-3.71-3.73 3.72 3.72 0 013.71-3.729 3.72 3.72 0 013.711 3.73z" fill="#3858E9" stroke="#3858E9" stroke-width="1.5"/>
+  <path fill="url(#paint1_linear)" stroke="#3858E9" stroke-width="1.5" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round" d="M99.782 107.435h45.894v45.894H99.782z"/>
+  <path d="M218.946 37.371l17.518-5.453-17.518-5.454 8.494-16.284-16.229 8.483-5.536-17.496-5.46 17.496-16.305-8.483 8.57 16.284-17.518 5.454 17.518 5.453-8.57 16.285 16.305-8.483 5.46 17.496 5.536-17.496 16.229 8.483-8.494-16.285z" fill="url(#paint2_linear)" stroke="#3858E9" stroke-width="1.5" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M205.714 153.083c21.074 0 38.159-17.158 38.159-38.323 0-21.166-17.085-38.324-38.159-38.324-21.074 0-38.158 17.158-38.158 38.324 0 21.165 17.084 38.323 38.158 38.323z" fill="#fff" stroke="#3858E9" stroke-width="1.5" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M188.368 117.499c0 9.705 7.929 17.419 17.344 17.419 9.416 0 17.345-7.963 17.345-17.419" stroke="#3858E9" stroke-width="1.5" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M200.008 104.06a3.72 3.72 0 01-3.711 3.73c-2.046 0-3.71-1.667-3.71-3.73a3.72 3.72 0 013.71-3.729 3.72 3.72 0 013.711 3.729zM218.839 104.06a3.72 3.72 0 01-3.71 3.729 3.72 3.72 0 01-3.71-3.729 3.72 3.72 0 013.71-3.729 3.72 3.72 0 013.71 3.729z" fill="#3858E9" stroke="#3858E9" stroke-width="1.5"/>
+  <defs>
+    <linearGradient id="paint0_linear" x1="39.749" y1="55.02" x2="39.749" y2="9.126" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#ECF5FF"/>
+      <stop offset="1" stop-color="#fff"/>
+    </linearGradient>
+    <linearGradient id="paint1_linear" x1="122.729" y1="107.435" x2="122.729" y2="153.329" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#ECF5FF"/>
+      <stop offset="1" stop-color="#fff"/>
+    </linearGradient>
+    <linearGradient id="paint2_linear" x1="205.713" y1="1.167" x2="205.713" y2="62.669" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#ECF5FF"/>
+      <stop offset="1" stop-color="#fff"/>
+    </linearGradient>
+  </defs>
+</svg>

wp-admin/images/privacy.svg

@@ -0,0 +1,30 @@
+<svg width="322" height="370" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <path d="M209.004 97.757c-.11-1.762-.328-3.523-.547-5.285a86.978 86.978 0 00-1.314-7.707c-.547-2.533-1.094-5.065-1.86-7.597-.219-.881-.438-1.652-.766-2.423-13.024-42.61-52.532-73.548-99.154-73.548S19.233 32.136 6.1 74.745c-.328.771-.547 1.542-.766 2.423a79.772 79.772 0 00-2.298 10.13c-.329 1.76-.548 3.412-.766 5.174-.22 1.762-.438 3.523-.548 5.285a96.67 96.67 0 00-.328 8.037v223.178h207.938V105.794c0-2.752-.109-5.395-.328-8.037zm-186.16 44.041v-36.004h.11c0-45.802 36.882-82.907 82.519-83.017 45.527 0 82.409 37.105 82.409 83.017h.109v36.004H22.844z" fill="url(#paint0_linear)" stroke="#3858E9" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M141.808 294.4l-28.455-58.355c9.631-3.083 16.526-12.111 16.526-22.681 0-13.212-10.616-23.892-23.749-23.892s-23.749 10.68-23.749 23.892c0 10.68 7.004 19.709 16.526 22.681L70.452 294.4h71.356z" fill="#3858E9" stroke="#3858E9" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M209.332 329.082H1.394v12.882h207.938v-12.882z" fill="url(#paint1_linear)" stroke="#3858E9" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M209.332 341.854H1.394v12.882h207.938v-12.882z" fill="url(#paint2_linear)" stroke="#3858E9" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M209.332 354.735H1.394c0 7.115 5.767 12.882 12.881 12.882H196.45c7.114 0 12.882-5.767 12.882-12.882z" fill="url(#paint3_linear)" stroke="#3858E9" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M285.509 278.325v-76.301h25.28V186.94h-25.28v-9.579h32.285v-15.084h-32.285v-6.936h32.285v-15.085h-32.285v-8.257h-21.013v146.326c-21.013 4.955-36.444 24.553-35.131 47.564 1.314 22.902 19.59 41.619 42.354 43.271 26.813 1.871 49.139-19.378 49.139-45.913-.109-21.911-15.103-40.077-35.349-44.922zM275.002 347.8c-13.461 0-24.515-11.01-24.515-24.663s10.945-24.663 24.515-24.663c13.461 0 24.515 11.01 24.515 24.663S288.573 347.8 275.002 347.8z" fill="url(#paint4_linear)" stroke="#3858E9" stroke-miterlimit="10" stroke-linecap="round" stroke-linejoin="round"/>
+  <defs>
+    <linearGradient id="paint0_linear" x1="105.363" y1="1.197" x2="105.363" y2="328.972" gradientUnits="userSpaceOnUse">
+      <stop offset=".099" stop-color="#ECF5FF"/>
+      <stop offset="1" stop-color="#ECF5FF" stop-opacity="0"/>
+    </linearGradient>
+    <linearGradient id="paint1_linear" x1="105.363" y1="329.082" x2="105.363" y2="341.964" gradientUnits="userSpaceOnUse">
+      <stop offset=".099" stop-color="#ECF5FF"/>
+      <stop offset="1" stop-color="#ECF5FF" stop-opacity="0"/>
+    </linearGradient>
+    <linearGradient id="paint2_linear" x1="105.363" y1="341.854" x2="105.363" y2="354.736" gradientUnits="userSpaceOnUse">
+      <stop offset=".099" stop-color="#ECF5FF"/>
+      <stop offset="1" stop-color="#ECF5FF" stop-opacity="0"/>
+    </linearGradient>
+    <linearGradient id="paint3_linear" x1="105.363" y1="354.735" x2="105.363" y2="367.617" gradientUnits="userSpaceOnUse">
+      <stop offset=".099" stop-color="#ECF5FF"/>
+      <stop offset="1" stop-color="#ECF5FF" stop-opacity="0"/>
+    </linearGradient>
+    <linearGradient id="paint4_linear" x1="275.073" y1="131.999" x2="275.073" y2="369.275" gradientUnits="userSpaceOnUse">
+      <stop offset=".099" stop-color="#ECF5FF"/>
+      <stop offset="1" stop-color="#ECF5FF" stop-opacity="0"/>
+    </linearGradient>
+  </defs>
+</svg>

wp-admin/includes/dashboard.php

@@ -1658,10 +1658,9 @@ function wp_dashboard_quota() {
  * Displays the browser update nag.
  *
  * @since 3.2.0
- * @since 5.8.0 Display special message for Internet Explorer users.
+ * @since 5.8.0 Added a special message for Internet Explorer users.
  *
  * @global bool $is_IE
- *
  */
 function wp_dashboard_browser_nag() {
 	global $is_IE;

wp-admin/includes/update-core.php

@@ -804,6 +804,12 @@ $_old_files = array(
 	// 5.7
 	'wp-includes/blocks/classic/block.json',
 	// 5.8
+	'wp-admin/images/freedoms.png',
+	'wp-admin/images/privacy.png',
+	'wp-admin/images/about-badge.svg',
+	'wp-admin/images/about-color-palette.svg',
+	'wp-admin/images/about-color-palette-vert.svg',
+	'wp-admin/images/about-header-brushes.svg',
 	'wp-includes/block-patterns/large-header.php',
 	'wp-includes/block-patterns/heading-paragraph.php',
 	'wp-includes/block-patterns/quote.php',

wp-admin/js/widgets/text-widgets.js

@@ -161,7 +161,7 @@ wp.textWidgets = ( function( $ ) {
 					control.fields.text.val( syncInput.val() );
 				}
 			} else if ( control.editor && ! control.editorFocused && syncInput.val() !== control.fields.text.val() ) {
-				control.editor.setContent( wp.editor.autop( syncInput.val() ) );
+				control.editor.setContent( wp.oldEditor.autop( syncInput.val() ) );
 			}
 		},
 
@@ -237,7 +237,7 @@ wp.textWidgets = ( function( $ ) {
 
 				// The user has disabled TinyMCE.
 				if ( typeof window.tinymce === 'undefined' ) {
-					wp.editor.initialize( id, {
+					wp.oldEditor.initialize( id, {
 						quicktags: true,
 						mediaButtons: true
 					});
@@ -248,7 +248,7 @@ wp.textWidgets = ( function( $ ) {
 				// Destroy any existing editor so that it can be re-initialized after a widget-updated event.
 				if ( tinymce.get( id ) ) {
 					restoreTextMode = tinymce.get( id ).isHidden();
-					wp.editor.remove( id );
+					wp.oldEditor.remove( id );
 				}
 
 				// Add or enable the `wpview` plugin.
@@ -262,7 +262,7 @@ wp.textWidgets = ( function( $ ) {
 					}
 				} );
 
-				wp.editor.initialize( id, {
+				wp.oldEditor.initialize( id, {
 					tinymce: {
 						wpautop: true
 					},

wp-admin/privacy.php

@@ -36,10 +36,11 @@ require_once ABSPATH . 'wp-admin/admin-header.php';
 		</nav>
 	</div>
 
-	<div class="about__section">
-		<div class="column">
-			<p><img class="privacy-image" src="<?php echo esc_url( admin_url( 'images/privacy.png' ) ); ?>" alt="" /></p>
-
+	<div class="about__section has-2-columns is-wider-right">
+		<div class="column about__image">
+			<img class="privacy-image" src="<?php echo esc_url( admin_url( 'images/privacy.svg' ) ); ?>" alt="" />
+		</div>
+		<div class="column is-vertically-aligned-center">
 			<p><?php _e( 'From time to time, your WordPress site may send data to WordPress.org &#8212; including, but not limited to &#8212; the version of WordPress you are using, and a list of installed plugins and themes.' ); ?></p>
 
 			<p>

wp-content/themes/twentyeleven/inc/block-patterns.php

@@ -7,10 +7,10 @@
  *
  * @package WordPress
  * @subpackage Twenty_Eleven
- * @since Twenty Eleven 1.0
+ * @since Twenty Eleven 3.8
  */
 
- /**
+/**
  * Register Block Pattern Category.
  */
 if ( function_exists( 'register_block_pattern_category' ) ) {

wp-content/themes/twentyeleven/readme.txt

@@ -2,7 +2,7 @@
 Contributors: wordpressdotorg
 Requires at least: WordPress 3.2
 Tested up to: 5.8
-Stable tag: 3.7
+Stable tag: 3.8
 License: GPLv2 or later
 License URI: http://www.gnu.org/licenses/gpl-2.0.html
 Tags: blog, one-column, two-columns, left-sidebar, right-sidebar, custom-background, custom-colors, custom-header, custom-menu, editor-style, featured-image-header, featured-images, flexible-header, footer-widgets, full-width-template, microformats, post-formats, rtl-language-support, sticky-post, theme-options, translation-ready, block-patterns
@@ -47,6 +47,11 @@ Images
 
 == Changelog ==
 
+= 3.8 =
+* Released: July 20, 2021
+
+https://codex.wordpress.org/Twenty_Eleven_Theme_Changelog#Version_3.8
+
 = 3.7 =
 * Released: March 9, 2021
 

wp-content/themes/twentyeleven/style.css

@@ -4,7 +4,7 @@ Theme URI: https://wordpress.org/themes/twentyeleven/
 Author: the WordPress team
 Author URI: https://wordpress.org/
 Description: The 2011 theme for WordPress is sophisticated, lightweight, and adaptable. Make it yours with a custom menu, header image, and background -- then go further with available theme options for light or dark color scheme, custom link colors, and three layout choices. Twenty Eleven comes equipped with a Showcase page template that transforms your front page into a showcase to show off your best content, widget support galore (sidebar, three footer areas, and a Showcase page widget area), and a custom "Ephemera" widget to display your Aside, Link, Quote, or Status posts. Included are styles for print and for the admin editor, support for featured images (as custom header images on posts and pages and as large images on featured "sticky" posts), and special styles for six different post formats.
-Version: 3.7
+Version: 3.8
 Requires PHP: 5.2.4
 License: GNU General Public License v2 or later
 License URI: http://www.gnu.org/licenses/gpl-2.0.html

wp-content/themes/twentyfifteen/readme.txt

@@ -2,7 +2,7 @@
 Contributors: wordpressdotorg
 Requires at least: WordPress 4.1
 Tested up to: 5.8
-Version: 2.9
+Version: 3.0
 License: GPLv2 or later
 License URI: http://www.gnu.org/licenses/gpl-2.0.html
 Tags: blog, two-columns, left-sidebar, accessibility-ready, custom-background, custom-colors, custom-header, custom-logo, custom-menu, editor-style, featured-images, microformats, post-formats, rtl-language-support, sticky-post, threaded-comments, translation-ready, block-patterns
@@ -61,6 +61,11 @@ Source: https://stocksnap.io/photo/purple-yellow-ACF0693B9C
 
 == Changelog ==
 
+= 3.0 =
+* Released: July 20, 2021
+
+https://codex.wordpress.org/Twenty_Fifteen_Theme_Changelog#Version_3.0
+
 = 2.9 =
 * Released: March 9, 2021
 

wp-content/themes/twentyfifteen/style.css

@@ -4,7 +4,7 @@ Theme URI: https://wordpress.org/themes/twentyfifteen/
 Author: the WordPress team
 Author URI: https://wordpress.org/
 Description: Our 2015 default theme is clean, blog-focused, and designed for clarity. Twenty Fifteen's simple, straightforward typography is readable on a wide variety of screen sizes, and suitable for multiple languages. We designed it using a mobile-first approach, meaning your content takes center-stage, regardless of whether your visitors arrive by smartphone, tablet, laptop, or desktop computer.
-Version: 2.9
+Version: 3.0
 Requires PHP: 5.2.4
 License: GNU General Public License v2 or later
 License URI: http://www.gnu.org/licenses/gpl-2.0.html

wp-content/themes/twentyfourteen/inc/block-patterns.php

@@ -10,7 +10,7 @@
  * @since Twenty Fourteen 3.2
  */
 
- /**
+/**
  * Register Block Pattern Category.
  */
 if ( function_exists( 'register_block_pattern_category' ) ) {

wp-content/themes/twentyfourteen/readme.txt

@@ -2,7 +2,7 @@
 Contributors: wordpressdotorg
 Requires at least: WordPress 3.6
 Tested up to: 5.8
-Stable tag: 3.1
+Stable tag: 3.2
 License: GPLv2 or later
 License URI: http://www.gnu.org/licenses/gpl-2.0.html
 Tags: blog, news, two-columns, three-columns, left-sidebar, right-sidebar, custom-background, custom-header, custom-menu, editor-style, featured-images, flexible-header, footer-widgets, full-width-template, microformats, post-formats, rtl-language-support, sticky-post, theme-options, translation-ready, accessibility-ready, block-patterns
@@ -58,6 +58,11 @@ Source: https://stocksnap.io/photo/fog-mountain-ZKN6UKFKEO
 
 == Changelog ==
 
+= 3.2 =
+* Released: July 20, 2021
+
+https://codex.wordpress.org/Twenty_Fourteen_Theme_Changelog#Version_3.2
+
 = 3.1 =
 * Released: March 9, 2021
 

wp-content/themes/twentyfourteen/style.css

@@ -4,7 +4,7 @@ Theme URI: https://wordpress.org/themes/twentyfourteen/
 Author: the WordPress team
 Author URI: https://wordpress.org/
 Description: In 2014, our default theme lets you create a responsive magazine website with a sleek, modern design. Feature your favorite homepage content in either a grid or a slider. Use the three widget areas to customize your website, and change your content's layout with a full-width page template and a contributor page to show off your authors. Creating a magazine website with WordPress has never been easier.
-Version: 3.1
+Version: 3.2
 Requires PHP: 5.2.4
 License: GNU General Public License v2 or later
 License URI: http://www.gnu.org/licenses/gpl-2.0.html

wp-content/themes/twentynineteen/inc/block-patterns.php

@@ -6,8 +6,8 @@
  * @link https://developer.wordpress.org/reference/functions/register_block_pattern_category/
  *
  * @package WordPress
- * @subpackage TwentyNineteen
- * @since Twenty Nineteen 1.7
+ * @subpackage Twenty_Nineteen
+ * @since Twenty Nineteen 1.8
  */
 
 /**

wp-content/themes/twentynineteen/inc/color-patterns.php

@@ -3,7 +3,7 @@
  * Twenty Nineteen: Color Patterns
  *
  * @package WordPress
- * @subpackage TwentyNineteen
+ * @subpackage Twenty_Nineteen
  * @since Twenty Nineteen 1.0
  */
 

wp-content/themes/twentynineteen/package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "twentynineteen",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {

wp-content/themes/twentynineteen/package.json

@@ -1,6 +1,6 @@
 {
   "name": "twentynineteen",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Default WP Theme",
   "bugs": {
     "url": "https://core.trac.wordpress.org/"

wp-content/themes/twentynineteen/readme.txt

@@ -3,7 +3,7 @@ Contributors: wordpressdotorg
 Tags: one-column, flexible-header, accessibility-ready, custom-colors, custom-menu, custom-logo, editor-style, featured-images, footer-widgets, rtl-language-support, sticky-post, threaded-comments, translation-ready, block-patterns
 Requires at least: 4.9.6
 Tested up to: 5.8
-Stable tag: 2.0
+Stable tag: 2.1
 License: GPLv2 or later
 License URI: http://www.gnu.org/licenses/gpl-2.0.html
 
@@ -39,6 +39,11 @@ GNU General Public License for more details.
 
 == Changelog ==
 
+= 2.1 =
+* Released: July 20, 2021
+
+https://codex.wordpress.org/Twenty_Nineteen_Theme_Changelog#Version_2.1
+
 = 2.0 =
 * Released: March 9, 2021
 

wp-content/themes/twentynineteen/style-editor-customizer.css

@@ -1,5 +1,5 @@
 /*!
 Twenty Nineteen Customizer Styles
 
-NOTE: This file is automatically populated with styles if the user selects a custom primary color in the customzier.
+NOTE: This file is automatically populated with styles if the user selects a custom primary color in the customizer.
 */

wp-content/themes/twentynineteen/style-editor-customizer.scss

@@ -1,5 +1,5 @@
 /*!
 Twenty Nineteen Customizer Styles
 
-NOTE: This file is automatically populated with styles if the user selects a custom primary color in the customzier.
+NOTE: This file is automatically populated with styles if the user selects a custom primary color in the customizer.
 */

wp-content/themes/twentynineteen/style-rtl.css

@@ -7,7 +7,7 @@ Author URI: https://wordpress.org/
 Description: Our 2019 default theme is designed to show off the power of the block editor. It features custom styles for all the default blocks, and is built so that what you see in the editor looks like what you'll see on your website. Twenty Nineteen is designed to be adaptable to a wide range of websites, whether you’re running a photo blog, launching a new business, or supporting a non-profit. Featuring ample whitespace and modern sans-serif headlines paired with classic serif body text, it's built to be beautiful on all screen sizes.
 Requires at least: 4.9.6
 Requires PHP: 5.2.4
-Version: 2.0
+Version: 2.1
 License: GNU General Public License v2 or later
 License URI: http://www.gnu.org/licenses/gpl-2.0.html
 Text Domain: twentynineteen

wp-content/themes/twentynineteen/style.css

@@ -7,7 +7,7 @@ Author URI: https://wordpress.org/
 Description: Our 2019 default theme is designed to show off the power of the block editor. It features custom styles for all the default blocks, and is built so that what you see in the editor looks like what you'll see on your website. Twenty Nineteen is designed to be adaptable to a wide range of websites, whether you’re running a photo blog, launching a new business, or supporting a non-profit. Featuring ample whitespace and modern sans-serif headlines paired with classic serif body text, it's built to be beautiful on all screen sizes.
 Requires at least: 4.9.6
 Requires PHP: 5.2.4
-Version: 2.0
+Version: 2.1
 License: GNU General Public License v2 or later
 License URI: http://www.gnu.org/licenses/gpl-2.0.html
 Text Domain: twentynineteen

wp-content/themes/twentynineteen/style.scss

@@ -6,7 +6,7 @@ Author URI: https://wordpress.org/
 Description: Our 2019 default theme is designed to show off the power of the block editor. It features custom styles for all the default blocks, and is built so that what you see in the editor looks like what you'll see on your website. Twenty Nineteen is designed to be adaptable to a wide range of websites, whether you’re running a photo blog, launching a new business, or supporting a non-profit. Featuring ample whitespace and modern sans-serif headlines paired with classic serif body text, it's built to be beautiful on all screen sizes.
 Requires at least: 4.9.6
 Requires PHP: 5.2.4
-Version: 2.0
+Version: 2.1
 License: GNU General Public License v2 or later
 License URI: http://www.gnu.org/licenses/gpl-2.0.html
 Text Domain: twentynineteen

wp-content/themes/twentyseventeen/inc/block-patterns.php

@@ -4,7 +4,7 @@
  *
  * @package WordPress
  * @subpackage Twenty_Seventeen
- * @since Twenty Seventeen 2.4
+ * @since Twenty Seventeen 2.5
  */
 
 /**

wp-content/themes/twentyseventeen/readme.txt

@@ -1,7 +1,7 @@
 === Twenty Seventeen ===
 Contributors: wordpressdotorg
 Tested up to: 5.8
-Version: 2.7
+Version: 2.8
 License: GPLv2 or later
 License URI: http://www.gnu.org/licenses/gpl-2.0.html
 Tags: one-column, two-columns, right-sidebar, flexible-header, accessibility-ready, custom-colors, custom-header, custom-menu, custom-logo, editor-style, featured-images, footer-widgets, post-formats, rtl-language-support, sticky-post, theme-options, threaded-comments, translation-ready, block-patterns
@@ -68,6 +68,11 @@ Source: https://stocksnap.io/photo/striped-fabric-9CBVWF2CDU
 
 == Changelog ==
 
+= 2.8 =
+* Released: July 20, 2021
+
+https://codex.wordpress.org/Twenty_Seventeen_Theme_Changelog#Version_2.8
+
 = 2.7 =
 * Released: April 14, 2021
 

wp-content/themes/twentyseventeen/style.css

@@ -4,7 +4,7 @@ Theme URI: https://wordpress.org/themes/twentyseventeen/
 Author: the WordPress team
 Author URI: https://wordpress.org/
 Description: Twenty Seventeen brings your site to life with header video and immersive featured images. With a focus on business sites, it features multiple sections on the front page as well as widgets, navigation and social menus, a logo, and more. Personalize its asymmetrical grid with a custom color scheme and showcase your multimedia content with post formats. Our default theme for 2017 works great in many languages, for any abilities, and on any device.
-Version: 2.7
+Version: 2.8
 Requires at least: 4.7
 Requires PHP: 5.2.4
 License: GNU General Public License v2 or later

wp-content/themes/twentysixteen/inc/block-patterns.php

@@ -2,8 +2,9 @@
 /**
  * Twenty Sixteen Theme: Block Patterns
  *
- * @package Twenty Sixteen
- * @since 2.2
+ * @package WordPress
+ * @subpackage Twenty_Sixteen
+ * @since Twenty Sixteen 2.3
  */
 
 /**

wp-content/themes/twentysixteen/readme.txt

@@ -1,7 +1,7 @@
 === Twenty Sixteen ===
 Contributors: wordpressdotorg
 Tested up to: 5.8
-Version: 2.4
+Version: 2.5
 License: GPLv2 or later
 License URI: http://www.gnu.org/licenses/gpl-2.0.html
 Tags: one-column, two-columns, right-sidebar, accessibility-ready, custom-background, custom-colors, custom-header, custom-menu, editor-style, featured-images, flexible-header, microformats, post-formats, rtl-language-support, sticky-post, threaded-comments, translation-ready, blog, block-patterns
@@ -55,6 +55,11 @@ Image used in screenshot.png: A photo by Austin Schmid (https://unsplash.com/sch
 
 == Changelog ==
 
+= 2.5 =
+* Released: July 20, 2021
+
+https://codex.wordpress.org/Twenty_Sixteen_Theme_Changelog#Version_2.5
+
 = 2.4 =
 * Released: March 9, 2021
 

wp-content/themes/twentysixteen/style.css

@@ -4,7 +4,7 @@ Theme URI: https://wordpress.org/themes/twentysixteen/
 Author: the WordPress team
 Author URI: https://wordpress.org/
 Description: Twenty Sixteen is a modernized take on an ever-popular WordPress layout — the horizontal masthead with an optional right sidebar that works perfectly for blogs and websites. It has custom color options with beautiful default color schemes, a harmonious fluid grid using a mobile-first approach, and impeccable polish in every detail. Twenty Sixteen will make your WordPress look beautiful everywhere.
-Version: 2.4
+Version: 2.5
 Requires at least: 4.4
 Requires PHP: 5.2.4
 License: GNU General Public License v2 or later

wp-content/themes/twentyten/readme.txt

@@ -1,7 +1,7 @@
 === Twenty Ten ===
 Contributors: wordpressdotorg
 Tested up to: 5.8
-Stable tag: 3.3
+Stable tag: 3.4
 License: GPLv2 or later
 License URI: http://www.gnu.org/licenses/gpl-2.0.html
 Tags: blog, two-columns, custom-header, custom-background, threaded-comments, sticky-post, translation-ready, microformats, rtl-language-support, editor-style, custom-menu, flexible-header, featured-images, footer-widgets, featured-image-header, block-patterns
@@ -42,6 +42,11 @@ Images
 
 == Changelog ==
 
+= 3.4 =
+* Released: July 20, 2021
+
+https://codex.wordpress.org/Twenty_Ten_Theme_Changelog#Version_3.4
+
 = 3.3 =
 * Released: March 9, 2021
 

wp-content/themes/twentyten/style.css

@@ -4,7 +4,7 @@ Theme URI: https://wordpress.org/themes/twentyten/
 Description: The 2010 theme for WordPress is stylish, customizable, simple, and readable -- make it yours with a custom menu, header image, and background. Twenty Ten supports six widgetized areas (two in the sidebar, four in the footer) and featured images (thumbnails for gallery posts and custom header images for posts and pages). It includes stylesheets for print and the admin Visual Editor, special styles for posts in the "Asides" and "Gallery" categories, and has an optional one-column page template that removes the sidebar.
 Author: the WordPress team
 Author URI: https://wordpress.org/
-Version: 3.3
+Version: 3.4
 Requires at least: 3.0
 Requires PHP: 5.2.4
 License: GNU General Public License v2 or later

wp-content/themes/twentythirteen/readme.txt

@@ -1,7 +1,7 @@
 === Twenty Thirteen ===
 Contributors: wordpressdotorg
 Tested up to: 5.8
-Stable tag: 3.3
+Stable tag: 3.4
 License: GPLv2 or later
 License URI: http://www.gnu.org/licenses/gpl-2.0.html
 Tags: blog, one-column, two-columns, right-sidebar, custom-header, custom-menu, editor-style, featured-images, footer-widgets, microformats, post-formats, rtl-language-support, sticky-post, translation-ready, accessibility-ready, block-patterns
@@ -52,6 +52,11 @@ Toroidal Colony: https://www.flickr.com/photos/nasacommons/13889485757/in/album-
 
 == Changelog ==
 
+= 3.4 =
+* Released: July 20, 2021
+
+https://codex.wordpress.org/Twenty_Thirteen_Theme_Changelog#Version_3.4
+
 = 3.3 =
 * Released: March 9, 2021
 

wp-content/themes/twentythirteen/style.css

@@ -4,7 +4,7 @@ Theme URI: https://wordpress.org/themes/twentythirteen/
 Author: the WordPress team
 Author URI: https://wordpress.org/
 Description: The 2013 theme for WordPress takes us back to the blog, featuring a full range of post formats, each displayed beautifully in their own unique way. Design details abound, starting with a vibrant color scheme and matching header images, beautiful typography and icons, and a flexible layout that looks great on any device, big or small.
-Version: 3.3
+Version: 3.4
 Requires at least: 3.6
 Requires PHP: 5.2.4
 License: GNU General Public License v2 or later

wp-content/themes/twentytwelve/readme.txt

@@ -1,7 +1,7 @@
 === Twenty Twelve ===
 Contributors: wordpressdotorg
 Tested up to: 5.8
-Stable tag: 3.3
+Stable tag: 3.4
 License: GPLv2 or later
 License URI: http://www.gnu.org/licenses/gpl-2.0.html
 Tags: blog, one-column, two-columns, right-sidebar, custom-background, custom-header, custom-menu, editor-style, featured-images, flexible-header, footer-widgets, full-width-template, microformats, post-formats, rtl-language-support, sticky-post, theme-options, translation-ready, block-patterns
@@ -46,6 +46,11 @@ Source: https://github.com/aFarkas/html5shiv
 
 == Changelog ==
 
+= 3.4 =
+* Released: July 20, 2021
+
+https://codex.wordpress.org/Twenty_Twelve_Theme_Changelog#Version_3.4
+
 = 3.3 =
 * Released: December 8, 2020
 

wp-content/themes/twentytwelve/style.css

@@ -4,7 +4,7 @@ Theme URI: https://wordpress.org/themes/twentytwelve/
 Author: the WordPress team
 Author URI: https://wordpress.org/
 Description: The 2012 theme for WordPress is a fully responsive theme that looks great on any device. Features include a front page template with its own widgets, an optional display font, styling for post formats on both index and single views, and an optional no-sidebar page template. Make it yours with a custom menu, header image, and background.
-Version: 3.3
+Version: 3.4
 Requires at least: 3.5
 Requires PHP: 5.2.4
 License: GNU General Public License v2 or later

wp-content/themes/twentytwenty/assets/js/customize-preview.js

@@ -11,6 +11,8 @@
 	/**
 	 * Return a value for our partial refresh.
 	 *
+	 * @since Twenty Twenty 1.0
+	 *
 	 * @param {Object} partial  Current partial.
 	 *
 	 * @return {jQuery.Promise} Resolved promise.
@@ -31,6 +33,8 @@
 		/**
 		 * Override the refresh method.
 		 *
+		 * @since Twenty Twenty 1.0
+		 *
 		 * @return {jQuery.Promise} Resolved promise.
 		 */
 		refresh: function() {
@@ -55,6 +59,7 @@
 		/**
 		 * Input attributes.
 		 *
+		 * @since Twenty Twenty 1.0
 		 * @type {Object}
 		 */
 		attrs: {},
@@ -62,6 +67,8 @@
 		/**
 		 * Override the refresh method.
 		 *
+		 * @since Twenty Twenty 1.0
+		 *
 		 * @return {jQuery.Promise} Resolved promise.
 		 */
 		refresh: function() {

wp-content/themes/twentytwenty/assets/js/index.js

@@ -646,6 +646,8 @@ twentytwenty.toggles = {
  *
  * This implementation is coming from https://gomakethings.com/a-native-javascript-equivalent-of-jquerys-ready-method/
  *
+ * @since Twenty Twenty 1.0
+ *
  * @param {Function} fn Callback function to run.
  */
 function twentytwentyDomReady( fn ) {
@@ -695,6 +697,8 @@ function twentytwentyToggleAttribute( element, attribute, trueVal, falseVal ) {
 /**
  * Toggle a menu item on or off.
  *
+ * @since Twenty Twenty 1.0
+ *
  * @param {HTMLElement} target
  * @param {number} duration
  */
@@ -796,6 +800,8 @@ function twentytwentyMenuToggle( target, duration ) {
 /**
  * Traverses the DOM up to find elements matching the query.
  *
+ * @since Twenty Twenty 1.0
+ *
  * @param {HTMLElement} target
  * @param {string} query
  * @return {NodeList} parents matching query

wp-content/themes/twentytwenty/assets/js/skip-link-focus-fix.js

@@ -6,6 +6,8 @@
  * This is the source file for what is minified in the twentytwenty_skip_link_focus_fix() PHP function.
  *
  * Learn more: https://git.io/vWdr2
+ *
+ * @since Twenty Twenty 1.0
  */
 ( function() {
 	var isIe = /(trident|msie)/i.test( navigator.userAgent );

wp-content/themes/twentytwenty/classes/class-twentytwenty-customize.php

@@ -10,12 +10,16 @@
 if ( ! class_exists( 'TwentyTwenty_Customize' ) ) {
 	/**
 	 * CUSTOMIZER SETTINGS
+	 *
+	 * @since Twenty Twenty 1.0
 	 */
 	class TwentyTwenty_Customize {
 
 		/**
 		 * Register customizer options.
 		 *
+		 * @since Twenty Twenty 1.0
+		 *
 		 * @param WP_Customize_Manager $wp_customize Theme Customizer object.
 		 */
 		public static function register( $wp_customize ) {
@@ -412,9 +416,8 @@ if ( ! class_exists( 'TwentyTwenty_Customize' ) ) {
 		/**
 		 * Sanitization callback for the "accent_accessible_colors" setting.
 		 *
-		 * @static
-		 * @access public
 		 * @since Twenty Twenty 1.0
+		 *
 		 * @param array $value The value we want to sanitize.
 		 * @return array Returns sanitized value. Each item in the array gets sanitized separately.
 		 */
@@ -436,7 +439,9 @@ if ( ! class_exists( 'TwentyTwenty_Customize' ) ) {
 		/**
 		 * Sanitize select.
 		 *
-		 * @param string $input The input from the setting.
+		 * @since Twenty Twenty 1.0
+		 *
+		 * @param string $input   The input from the setting.
 		 * @param object $setting The selected setting.
 		 * @return string The input from the setting or the default setting.
 		 */
@@ -449,6 +454,8 @@ if ( ! class_exists( 'TwentyTwenty_Customize' ) ) {
 		/**
 		 * Sanitize boolean for checkbox.
 		 *
+		 * @since Twenty Twenty 1.0
+		 *
 		 * @param bool $checked Whether or not a box is checked.
 		 * @return bool
 		 */
@@ -469,6 +476,8 @@ if ( ! class_exists( 'TwentyTwenty_Customize' ) ) {
 if ( ! function_exists( 'twentytwenty_customize_partial_blogname' ) ) {
 	/**
 	 * Render the site title for the selective refresh partial.
+	 *
+	 * @since Twenty Twenty 1.0
 	 */
 	function twentytwenty_customize_partial_blogname() {
 		bloginfo( 'name' );
@@ -478,6 +487,8 @@ if ( ! function_exists( 'twentytwenty_customize_partial_blogname' ) ) {
 if ( ! function_exists( 'twentytwenty_customize_partial_blogdescription' ) ) {
 	/**
 	 * Render the site description for the selective refresh partial.
+	 *
+	 * @since Twenty Twenty 1.0
 	 */
 	function twentytwenty_customize_partial_blogdescription() {
 		bloginfo( 'description' );
@@ -489,6 +500,8 @@ if ( ! function_exists( 'twentytwenty_customize_partial_site_logo' ) ) {
 	 * Render the site logo for the selective refresh partial.
 	 *
 	 * Doing it this way so we don't have issues with `render_callback`'s arguments.
+	 *
+	 * @since Twenty Twenty 1.0
 	 */
 	function twentytwenty_customize_partial_site_logo() {
 		twentytwenty_site_logo();
@@ -499,18 +512,22 @@ if ( ! function_exists( 'twentytwenty_customize_partial_site_logo' ) ) {
 /**
  * Input attributes for cover overlay opacity option.
  *
+ * @since Twenty Twenty 1.0
+ *
  * @return array Array containing attribute names and their values.
  */
 function twentytwenty_customize_opacity_range() {
 	/**
-	 * Filters the input attributes for opacity
+	 * Filters the input attributes for opacity.
+	 *
+	 * @since Twenty Twenty 1.0
 	 *
 	 * @param array $attrs {
-	 *     The attributes
+	 *     The attributes.
 	 *
-	 *     @type int $min Minimum value
-	 *     @type int $max Maximum value
-	 *     @type int $step Interval between numbers
+	 *     @type int $min  Minimum value.
+	 *     @type int $max  Maximum value.
+	 *     @type int $step Interval between numbers.
 	 * }
 	 */
 	return apply_filters(

wp-content/themes/twentytwenty/classes/class-twentytwenty-non-latin-languages.php

@@ -12,6 +12,8 @@
 if ( ! class_exists( 'TwentyTwenty_Non_Latin_Languages' ) ) {
 	/**
 	 * Language handling.
+	 *
+	 * @since Twenty Twenty 1.0
 	 */
 	class TwentyTwenty_Non_Latin_Languages {
 
@@ -20,7 +22,9 @@ if ( ! class_exists( 'TwentyTwenty_Non_Latin_Languages' ) ) {
 		 *
 		 * Return CSS for non-latin language, if available, or null
 		 *
-		 * @param string $type Whether to return CSS for the "front-end", "block-editor" or "classic-editor".
+		 * @since Twenty Twenty 1.0
+		 *
+		 * @param string $type Whether to return CSS for the "front-end", "block-editor", or "classic-editor".
 		 * @return void
 		 */
 		public static function get_non_latin_css( $type = 'front-end' ) {
@@ -28,7 +32,13 @@ if ( ! class_exists( 'TwentyTwenty_Non_Latin_Languages' ) ) {
 			// Fetch site locale.
 			$locale = get_bloginfo( 'language' );
 
-			// Define fallback fonts for non-latin languages.
+			/**
+			 * Filters the fallback fonts for non-latin languages.
+			 *
+			 * @since Twenty Twenty 1.0
+			 *
+			 * @param array $font_family An array of locales and font families.
+			 */
 			$font_family = apply_filters(
 				'twentytwenty_get_localized_font_family_types',
 				array(
@@ -98,7 +108,13 @@ if ( ! class_exists( 'TwentyTwenty_Non_Latin_Languages' ) ) {
 				return;
 			}
 
-			// Define elements to apply fallback fonts to.
+			/**
+			 * Filters the elements to apply fallback fonts to.
+			 *
+			 * @since Twenty Twenty 1.0
+			 *
+			 * @param array $elements An array of elements for "front-end", "block-editor", or "classic-editor".
+			 */
 			$elements = apply_filters(
 				'twentytwenty_get_localized_font_family_elements',
 				array(

wp-content/themes/twentytwenty/classes/class-twentytwenty-script-loader.php

@@ -14,6 +14,8 @@
 if ( ! class_exists( 'TwentyTwenty_Script_Loader' ) ) {
 	/**
 	 * A class that provides a way to add `async` or `defer` attributes to scripts.
+	 *
+	 * @since Twenty Twenty 1.0
 	 */
 	class TwentyTwenty_Script_Loader {
 
@@ -22,6 +24,8 @@ if ( ! class_exists( 'TwentyTwenty_Script_Loader' ) ) {
 		 *
 		 * If #12009 lands in WordPress, this function can no-op since it would be handled in core.
 		 *
+		 * @since Twenty Twenty 1.0
+		 *
 		 * @link https://core.trac.wordpress.org/ticket/12009
 		 *
 		 * @param string $tag    The script tag.

wp-content/themes/twentytwenty/classes/class-twentytwenty-separator-control.php

@@ -12,10 +12,14 @@ if ( class_exists( 'WP_Customize_Control' ) ) {
 	if ( ! class_exists( 'TwentyTwenty_Separator_Control' ) ) {
 		/**
 		 * Separator Control.
+		 *
+		 * @since Twenty Twenty 1.0
 		 */
 		class TwentyTwenty_Separator_Control extends WP_Customize_Control {
 			/**
 			 * Render the hr.
+			 *
+			 * @since Twenty Twenty 1.0
 			 */
 			public function render_content() {
 				echo '<hr/>';

wp-content/themes/twentytwenty/classes/class-twentytwenty-svg-icons.php

@@ -11,12 +11,16 @@ if ( ! class_exists( 'TwentyTwenty_SVG_Icons' ) ) {
 	/**
 	 * SVG ICONS CLASS
 	 * Retrieve the SVG code for the specified icon. Based on a solution in Twenty Nineteen.
+	 *
+	 * @since Twenty Twenty 1.0
 	 */
 	class TwentyTwenty_SVG_Icons {
 		/**
 		 * GET SVG CODE
 		 * Get the SVG code for the specified icon
 		 *
+		 * @since Twenty Twenty 1.0
+		 *
 		 * @param string $icon  Icon name.
 		 * @param string $group Icon group.
 		 * @param string $color Color.
@@ -69,6 +73,8 @@ if ( ! class_exists( 'TwentyTwenty_SVG_Icons' ) ) {
 		 * GET SOCIAL LINK SVG
 		 * Detects the social network from a URL and returns the SVG code for its icon.
 		 *
+		 * @since Twenty Twenty 1.0
+		 *
 		 * @param string $uri The URL to retrieve SVG for.
 		 */
 		public static function get_social_link_svg( $uri ) {
@@ -116,6 +122,7 @@ if ( ! class_exists( 'TwentyTwenty_SVG_Icons' ) ) {
 		 * ICON STORAGE
 		 * Store the code for all SVGs in an array.
 		 *
+		 * @since Twenty Twenty 1.0
 		 * @var array
 		 */
 		public static $ui_icons = array(
@@ -169,6 +176,7 @@ if ( ! class_exists( 'TwentyTwenty_SVG_Icons' ) ) {
 		 * By default, each Icon ID is matched against a .com TLD. To override this behavior,
 		 * specify all the domains it covers (including the .com TLD too, if applicable).
 		 *
+		 * @since Twenty Twenty 1.0
 		 * @var array
 		 */
 		public static $social_icons_map = array(
@@ -224,6 +232,7 @@ if ( ! class_exists( 'TwentyTwenty_SVG_Icons' ) ) {
 		/**
 		 * Social Icons – svg sources.
 		 *
+		 * @since Twenty Twenty 1.0
 		 * @var array
 		 */
 		public static $social_icons = array(

wp-content/themes/twentytwenty/classes/class-twentytwenty-walker-comment.php

@@ -11,12 +11,16 @@ if ( ! class_exists( 'TwentyTwenty_Walker_Comment' ) ) {
 	/**
 	 * CUSTOM COMMENT WALKER
 	 * A custom walker for comments, based on the walker in Twenty Nineteen.
+	 *
+	 * @since Twenty Twenty 1.0
 	 */
 	class TwentyTwenty_Walker_Comment extends Walker_Comment {
 
 		/**
 		 * Outputs a comment in the HTML5 format.
 		 *
+		 * @since Twenty Twenty 1.0
+		 *
 		 * @see wp_list_comments()
 		 * @see https://developer.wordpress.org/reference/functions/get_comment_author_url/
 		 * @see https://developer.wordpress.org/reference/functions/get_comment_author/

wp-content/themes/twentytwenty/classes/class-twentytwenty-walker-page.php

@@ -11,14 +11,17 @@ if ( ! class_exists( 'TwentyTwenty_Walker_Page' ) ) {
 	/**
 	 * CUSTOM PAGE WALKER
 	 * A custom walker for pages.
+	 *
+	 * @since Twenty Twenty 1.0
 	 */
 	class TwentyTwenty_Walker_Page extends Walker_Page {
 
 		/**
 		 * Outputs the beginning of the current element in the tree.
 		 *
+		 * @since Twenty Twenty 1.0
+		 *
 		 * @see Walker::start_el()
-		 * @since 2.1.0
 		 *
 		 * @param string  $output       Used to append additional content. Passed by reference.
 		 * @param WP_Post $page         Page data object.

wp-content/themes/twentytwenty/functions.php

@@ -30,6 +30,8 @@
  * Note that this function is hooked into the after_setup_theme hook, which
  * runs before the init hook. The init hook is too late for some features, such
  * as indicating support for post thumbnails.
+ *
+ * @since Twenty Twenty 1.0
  */
 function twentytwenty_theme_support() {
 
@@ -183,6 +185,8 @@ require get_template_directory() . '/inc/block-patterns.php';
 
 /**
  * Register and Enqueue Styles.
+ *
+ * @since Twenty Twenty 1.0
  */
 function twentytwenty_register_styles() {
 
@@ -203,6 +207,8 @@ add_action( 'wp_enqueue_scripts', 'twentytwenty_register_styles' );
 
 /**
  * Register and Enqueue Scripts.
+ *
+ * @since Twenty Twenty 1.0
  */
 function twentytwenty_register_scripts() {
 
@@ -225,6 +231,8 @@ add_action( 'wp_enqueue_scripts', 'twentytwenty_register_scripts' );
  * This does not enqueue the script because it is tiny and because it is only for IE11,
  * thus it does not warrant having an entire dedicated blocking script being loaded.
  *
+ * @since Twenty Twenty 1.0
+ *
  * @link https://git.io/vWdr2
  */
 function twentytwenty_skip_link_focus_fix() {
@@ -237,7 +245,8 @@ function twentytwenty_skip_link_focus_fix() {
 }
 add_action( 'wp_print_footer_scripts', 'twentytwenty_skip_link_focus_fix' );
 
-/** Enqueue non-latin language styles
+/**
+ * Enqueue non-latin language styles.
  *
  * @since Twenty Twenty 1.0
  *
@@ -255,6 +264,8 @@ add_action( 'wp_enqueue_scripts', 'twentytwenty_non_latin_languages' );
 
 /**
  * Register navigation menus uses wp_nav_menu in five places.
+ *
+ * @since Twenty Twenty 1.0
  */
 function twentytwenty_menus() {
 
@@ -274,6 +285,8 @@ add_action( 'init', 'twentytwenty_menus' );
 /**
  * Get the information about the logo.
  *
+ * @since Twenty Twenty 1.0
+ *
  * @param string $html The HTML output from get_custom_logo (core function).
  * @return string
  */
@@ -331,14 +344,19 @@ if ( ! function_exists( 'wp_body_open' ) ) {
 
 	/**
 	 * Shim for wp_body_open, ensuring backward compatibility with versions of WordPress older than 5.2.
+	 *
+	 * @since Twenty Twenty 1.0
 	 */
 	function wp_body_open() {
+		/** This action is documented in wp-includes/general-template.php */
 		do_action( 'wp_body_open' );
 	}
 }
 
 /**
  * Include a skip to content link at the top of the page so that users can bypass the menu.
+ *
+ * @since Twenty Twenty 1.0
  */
 function twentytwenty_skip_link() {
 	echo '<a class="skip-link screen-reader-text" href="#site-content">' . __( 'Skip to the content', 'twentytwenty' ) . '</a>';
@@ -349,6 +367,8 @@ add_action( 'wp_body_open', 'twentytwenty_skip_link', 5 );
 /**
  * Register widget areas.
  *
+ * @since Twenty Twenty 1.0
+ *
  * @link https://developer.wordpress.org/themes/functionality/sidebars/#registering-a-sidebar
  */
 function twentytwenty_sidebar_registration() {
@@ -391,6 +411,8 @@ add_action( 'widgets_init', 'twentytwenty_sidebar_registration' );
 
 /**
  * Enqueue supplemental block editor styles.
+ *
+ * @since Twenty Twenty 1.0
  */
 function twentytwenty_block_editor_styles() {
 
@@ -412,6 +434,8 @@ add_action( 'enqueue_block_editor_assets', 'twentytwenty_block_editor_styles', 1
 
 /**
  * Enqueue classic editor styles.
+ *
+ * @since Twenty Twenty 1.0
  */
 function twentytwenty_classic_editor_styles() {
 
@@ -429,6 +453,8 @@ add_action( 'init', 'twentytwenty_classic_editor_styles' );
  * Output Customizer settings in the classic editor.
  * Adds styles to the head of the TinyMCE iframe. Kudos to @Otto42 for the original solution.
  *
+ * @since Twenty Twenty 1.0
+ *
  * @param array $mce_init TinyMCE styles.
  * @return array TinyMCE styles.
  */
@@ -479,6 +505,8 @@ add_filter( 'tiny_mce_before_init', 'twentytwenty_add_classic_editor_non_latin_s
 /**
  * Block Editor Settings.
  * Add custom colors and font sizes to the block editor.
+ *
+ * @since Twenty Twenty 1.0
  */
 function twentytwenty_block_editor_settings() {
 
@@ -632,7 +660,7 @@ add_action( 'customize_preview_init', 'twentytwenty_customize_preview_init' );
  *
  * @since Twenty Twenty 1.0
  *
- * @param string $area The area we want to get the colors for.
+ * @param string $area    The area we want to get the colors for.
  * @param string $context Can be 'text' or 'accent'.
  * @return string Returns a HEX color.
  */
@@ -750,11 +778,11 @@ function twentytwenty_get_elements_array() {
 	);
 
 	/**
-	* Filters Twenty Twenty theme elements
-	*
-	* @since Twenty Twenty 1.0
-	*
-	* @param array Array of elements
-	*/
+	 * Filters Twenty Twenty theme elements.
+	 *
+	 * @since Twenty Twenty 1.0
+	 *
+	 * @param array Array of elements.
+	 */
 	return apply_filters( 'twentytwenty_get_elements_array', $elements );
 }

wp-content/themes/twentytwenty/inc/block-patterns.php

@@ -7,7 +7,7 @@
  *
  * @package WordPress
  * @subpackage Twenty_Twenty
- * @since Twenty Twenty 1.5
+ * @since Twenty Twenty 1.6
  */
 
 /**

wp-content/themes/twentytwenty/inc/custom-css.php

@@ -12,12 +12,14 @@ if ( ! function_exists( 'twentytwenty_generate_css' ) ) {
 	/**
 	 * Generate CSS.
 	 *
+	 * @since Twenty Twenty 1.0
+	 *
 	 * @param string $selector The CSS selector.
-	 * @param string $style The CSS style.
-	 * @param string $value The CSS value.
-	 * @param string $prefix The CSS prefix.
-	 * @param string $suffix The CSS suffix.
-	 * @param bool   $echo Echo the styles.
+	 * @param string $style    The CSS style.
+	 * @param string $value    The CSS value.
+	 * @param string $prefix   The CSS prefix.
+	 * @param string $suffix   The CSS suffix.
+	 * @param bool   $echo     Echo the styles.
 	 */
 	function twentytwenty_generate_css( $selector, $style, $value, $prefix = '', $suffix = '', $echo = true ) {
 
@@ -50,7 +52,9 @@ if ( ! function_exists( 'twentytwenty_get_customizer_css' ) ) {
 	 * Get CSS Built from Customizer Options.
 	 * Build CSS reflecting colors, fonts and other options set in the Customizer, and return them for output.
 	 *
-	 * @param string $type Whether to return CSS for the "front-end", "block-editor" or "classic-editor".
+	 * @since Twenty Twenty 1.0
+	 *
+	 * @param string $type Whether to return CSS for the "front-end", "block-editor", or "classic-editor".
 	 */
 	function twentytwenty_get_customizer_css( $type = 'front-end' ) {
 
@@ -78,7 +82,7 @@ if ( ! function_exists( 'twentytwenty_get_customizer_css' ) ) {
 
 		ob_start();
 
-		/**
+		/*
 		 * Note – Styles are applied in this order:
 		 * 1. Element specific
 		 * 2. Helper classes
@@ -86,7 +90,7 @@ if ( ! function_exists( 'twentytwenty_get_customizer_css' ) ) {
 		 * This enables all helper classes to overwrite base element styles,
 		 * meaning that any color classes applied in the block editor will
 		 * have a higher priority than the base element styles.
-		*/
+		 */
 
 		// Front-End Styles.
 		if ( 'front-end' === $type ) {

wp-content/themes/twentytwenty/inc/svg-icons.php

@@ -12,9 +12,11 @@ if ( ! function_exists( 'twentytwenty_the_theme_svg' ) ) {
 	 * Output and Get Theme SVG.
 	 * Output and get the SVG markup for an icon in the TwentyTwenty_SVG_Icons class.
 	 *
+	 * @since Twenty Twenty 1.0
+	 *
 	 * @param string $svg_name The name of the icon.
-	 * @param string $group The group the icon belongs to.
-	 * @param string $color Color code.
+	 * @param string $group    The group the icon belongs to.
+	 * @param string $color    Color code.
 	 */
 	function twentytwenty_the_theme_svg( $svg_name, $group = 'ui', $color = '' ) {
 		echo twentytwenty_get_theme_svg( $svg_name, $group, $color ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- Escaped in twentytwenty_get_theme_svg().
@@ -26,9 +28,11 @@ if ( ! function_exists( 'twentytwenty_get_theme_svg' ) ) {
 	/**
 	 * Get information about the SVG icon.
 	 *
+	 * @since Twenty Twenty 1.0
+	 *
 	 * @param string $svg_name The name of the icon.
-	 * @param string $group The group the icon belongs to.
-	 * @param string $color Color code.
+	 * @param string $group    The group the icon belongs to.
+	 * @param string $color    Color code.
 	 */
 	function twentytwenty_get_theme_svg( $svg_name, $group = 'ui', $color = '' ) {
 

wp-content/themes/twentytwenty/inc/template-tags.php

@@ -25,8 +25,10 @@
 /**
  * Displays the site logo, either text or image.
  *
- * @param array   $args Arguments for displaying the site logo either as an image or text.
- * @param bool    $echo Echo or return the HTML.
+ * @since Twenty Twenty 1.0
+ *
+ * @param array $args Arguments for displaying the site logo either as an image or text.
+ * @param bool  $echo Echo or return the HTML.
  * @return string Compiled HTML based on our arguments.
  */
 function twentytwenty_site_logo( $args = array(), $echo = true ) {
@@ -50,8 +52,10 @@ function twentytwenty_site_logo( $args = array(), $echo = true ) {
 	/**
 	 * Filters the arguments for `twentytwenty_site_logo()`.
 	 *
-	 * @param array  $args     Parsed arguments.
-	 * @param array  $defaults Function's default arguments.
+	 * @since Twenty Twenty 1.0
+	 *
+	 * @param array $args     Parsed arguments.
+	 * @param array $defaults Function's default arguments.
 	 */
 	$args = apply_filters( 'twentytwenty_site_logo_args', $args, $defaults );
 
@@ -70,6 +74,8 @@ function twentytwenty_site_logo( $args = array(), $echo = true ) {
 	/**
 	 * Filters the arguments for `twentytwenty_site_logo()`.
 	 *
+	 * @since Twenty Twenty 1.0
+	 *
 	 * @param string $html      Compiled HTML based on our arguments.
 	 * @param array  $args      Parsed arguments.
 	 * @param string $classname Class name based on current view, home or single.
@@ -88,6 +94,8 @@ function twentytwenty_site_logo( $args = array(), $echo = true ) {
 /**
  * Displays the site description.
  *
+ * @since Twenty Twenty 1.0
+ *
  * @param bool $echo Echo or return the html.
  * @return string The HTML to display.
  */
@@ -107,9 +115,9 @@ function twentytwenty_site_description( $echo = true ) {
 	 *
 	 * @since Twenty Twenty 1.0
 	 *
-	 * @param string $html         The HTML to display.
-	 * @param string $description  Site description via `bloginfo()`.
-	 * @param string $wrapper      The format used in case you want to reuse it in a `sprintf()`.
+	 * @param string $html        The HTML to display.
+	 * @param string $description Site description via `bloginfo()`.
+	 * @param string $wrapper     The format used in case you want to reuse it in a `sprintf()`.
 	 */
 	$html = apply_filters( 'twentytwenty_site_description', $html, $description, $wrapper );
 
@@ -127,6 +135,8 @@ function twentytwenty_site_description( $echo = true ) {
 /**
  * Checks if the specified comment is written by the author of the post commented on.
  *
+ * @since Twenty Twenty 1.0
+ *
  * @param object $comment Comment data.
  * @return bool
  */
@@ -153,6 +163,8 @@ function twentytwenty_is_comment_by_post_author( $comment = null ) {
  * Filter the comment reply link to add a class indicating it should not use JS slow-scroll, as it
  * makes it scroll to the wrong position on the page.
  *
+ * @since Twenty Twenty 1.0
+ *
  * @param string $link Link to the top of the page.
  * @return string Link to the top of the page.
  */
@@ -174,6 +186,8 @@ add_filter( 'comment_reply_link', 'twentytwenty_filter_comment_reply_link' );
  *
  * If it's a single post, outputs the post meta values specified in the Customizer settings.
  *
+ * @since Twenty Twenty 1.0
+ *
  * @param int    $post_id  The ID of the post for which the post meta should be output.
  * @param string $location Which post meta location to output – single or preview.
  */
@@ -186,6 +200,8 @@ function twentytwenty_the_post_meta( $post_id = null, $location = 'single-top' )
 /**
  * Filters the edit post link to add an icon and use the post meta structure.
  *
+ * @since Twenty Twenty 1.0
+ *
  * @param string $link    Anchor tag for the edit link.
  * @param int    $post_id Post ID.
  * @param string $text    Anchor text.
@@ -223,7 +239,9 @@ add_filter( 'edit_post_link', 'twentytwenty_edit_post_link', 10, 3 );
 /**
  * Retrieves the post meta.
  *
- * @param int    $post_id The ID of the post.
+ * @since Twenty Twenty 1.0
+ *
+ * @param int    $post_id  The ID of the post.
  * @param string $location The location where the meta is shown.
  */
 function twentytwenty_get_post_meta( $post_id = null, $location = 'single-top' ) {
@@ -241,7 +259,7 @@ function twentytwenty_get_post_meta( $post_id = null, $location = 'single-top' )
 	 *
 	 * @since Twenty Twenty 1.0
 	 *
-	 * @param array Array of post types
+	 * @param array Array of post types.
 	 */
 	$disallowed_post_types = apply_filters( 'twentytwenty_disallowed_post_types_for_meta_output', array( 'page' ) );
 
@@ -263,10 +281,10 @@ function twentytwenty_get_post_meta( $post_id = null, $location = 'single-top' )
 		 * @since Twenty Twenty 1.0
 		 *
 		 * @param array $args {
-		 *  @type string 'author'
-		 *  @type string 'post-date'
-		 *  @type string 'comments'
-		 *  @type string 'sticky'
+		 *     @type string $author
+		 *     @type string $post-date
+		 *     @type string $comments
+		 *     @type string $sticky
 		 * }
 		 */
 		$post_meta = apply_filters(
@@ -291,7 +309,7 @@ function twentytwenty_get_post_meta( $post_id = null, $location = 'single-top' )
 		 * @since Twenty Twenty 1.0
 		 *
 		 * @param array $args {
-		 *   @type string 'tags'
+		 *     @type string $tags
 		 * }
 		 */
 		$post_meta = apply_filters(
@@ -499,6 +517,8 @@ function twentytwenty_get_post_meta( $post_id = null, $location = 'single-top' )
  * Filter the class applied to wp_list_pages() items with children to match the menu class, to simplify.
  * styling of sub levels in the fallback. Only applied if the match_menu_classes argument is set.
  *
+ * @since Twenty Twenty 1.0
+ *
  * @param string[] $css_class    An array of CSS classes to be applied to each list item.
  * @param WP_Post  $page         Page data object.
  * @param int      $depth        Depth of page, used for padding.
@@ -534,6 +554,8 @@ add_filter( 'page_css_class', 'twentytwenty_filter_wp_list_pages_item_classes',
 /**
  * Adds a Sub Nav Toggle to the Expanded Menu and Mobile Menu.
  *
+ * @since Twenty Twenty 1.0
+ *
  * @param stdClass $args  An object of wp_nav_menu() arguments.
  * @param WP_Post  $item  Menu item data object.
  * @param int      $depth Depth of menu item. Used for padding.
@@ -580,6 +602,8 @@ add_filter( 'nav_menu_item_args', 'twentytwenty_add_sub_toggles_to_main_menu', 1
 /**
  * Displays SVG icons in social links menu.
  *
+ * @since Twenty Twenty 1.0
+ *
  * @param string   $item_output The menu item's starting HTML output.
  * @param WP_Post  $item        Menu item data object.
  * @param int      $depth       Depth of the menu. Used for padding.
@@ -609,6 +633,8 @@ add_filter( 'walker_nav_menu_start_el', 'twentytwenty_nav_menu_social_icons', 10
  * Adds 'no-js' class.
  *
  * If we're missing JavaScript support, the HTML element will have a 'no-js' class.
+ *
+ * @since Twenty Twenty 1.0
  */
 function twentytwenty_no_js_class() {
 
@@ -623,6 +649,8 @@ add_action( 'wp_head', 'twentytwenty_no_js_class' );
 /**
  * Adds conditional body classes.
  *
+ * @since Twenty Twenty 1.0
+ *
  * @param array $classes Classes added to the body tag.
  * @return array Classes added to the body tag.
  */
@@ -724,11 +752,20 @@ add_filter( 'body_class', 'twentytwenty_body_classes' );
 /**
  * Filters the archive title and styles the word before the first colon.
  *
+ * @since Twenty Twenty 1.0
+ *
  * @param string $title Current archive title.
  * @return string Current archive title.
  */
 function twentytwenty_get_the_archive_title( $title ) {
 
+	/**
+	 * Filters the regular expression used to style the word before the first colon.
+	 *
+	 * @since Twenty Twenty 1.0
+	 *
+	 * @param array $regex An array of regular expression pattern and replacement.
+	 */
 	$regex = apply_filters(
 		'twentytwenty_get_the_archive_title_regex',
 		array(
@@ -756,6 +793,8 @@ add_filter( 'get_the_archive_title', 'twentytwenty_get_the_archive_title' );
 /**
  * Toggles animation duration in milliseconds.
  *
+ * @since Twenty Twenty 1.0
+ *
  * @return int Duration in milliseconds
  */
 function twentytwenty_toggle_duration() {
@@ -779,6 +818,8 @@ function twentytwenty_toggle_duration() {
  * with the optional prefix. As such the returned value is not universally unique,
  * but it is unique across the life of the PHP process.
  *
+ * @since Twenty Twenty 1.0
+ *
  * @see wp_unique_id() Themes requiring WordPress 5.0.3 and greater should use this instead.
  *
  * @param string $prefix Prefix for the returned ID.

wp-content/themes/twentytwenty/package-lock.json

@@ -1,6 +1,6 @@
 {
 	"name": "twentytwenty",
-	"version": "1.7.0",
+	"version": "1.8.0",
 	"lockfileVersion": 1,
 	"requires": true,
 	"dependencies": {

wp-content/themes/twentytwenty/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "twentytwenty",
-	"version": "1.7.0",
+	"version": "1.8.0",
 	"description": "Default WP Theme",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",

wp-content/themes/twentytwenty/readme.txt

@@ -1,7 +1,7 @@
 === Twenty Twenty ===
 Contributors: the WordPress team
 Tested up to: 5.8
-Stable tag: 1.7
+Stable tag: 1.8
 License: GPLv2 or later
 License URI: http://www.gnu.org/licenses/gpl-2.0.html
 
@@ -22,6 +22,11 @@ you pick, ensuring a high, accessible color contrast for your visitors.
 
 == Changelog ==
 
+= 1.8 =
+* Released: July 20, 2021
+
+https://wordpress.org/support/article/twenty-twenty-changelog/#Version_1.8
+
 = 1.7 =
 * Released: March 9, 2021
 

wp-content/themes/twentytwenty/style-rtl.css

@@ -1,7 +1,7 @@
 /*
 Theme Name: Twenty Twenty
 Text Domain: twentytwenty
-Version: 1.7
+Version: 1.8
 Requires at least: 4.7
 Requires PHP: 5.2.4
 Description: Our default theme for 2020 is designed to take full advantage of the flexibility of the block editor. Organizations and businesses have the ability to create dynamic landing pages with endless layouts using the group and column blocks. The centered content column and fine-tuned typography also makes it perfect for traditional blogs. Complete editor styles give you a good idea of what your content will look like, even before you publish. You can give your site a personal touch by changing the background colors and the accent color in the Customizer. The colors of all elements on your site are automatically calculated based on the colors you pick, ensuring a high, accessible color contrast for your visitors.

wp-content/themes/twentytwenty/style.css

@@ -1,7 +1,7 @@
 /*
 Theme Name: Twenty Twenty
 Text Domain: twentytwenty
-Version: 1.7
+Version: 1.8
 Requires at least: 4.7
 Requires PHP: 5.2.4
 Description: Our default theme for 2020 is designed to take full advantage of the flexibility of the block editor. Organizations and businesses have the ability to create dynamic landing pages with endless layouts using the group and column blocks. The centered content column and fine-tuned typography also makes it perfect for traditional blogs. Complete editor styles give you a good idea of what your content will look like, even before you publish. You can give your site a personal touch by changing the background colors and the accent color in the Customizer. The colors of all elements on your site are automatically calculated based on the colors you pick, ensuring a high, accessible color contrast for your visitors.

wp-content/themes/twentytwenty/template-parts/content-cover.php

@@ -59,7 +59,7 @@
 							 *
 							 * @since Twenty Twenty 1.0
 							 *
-							 * @param bool Whether to show the categories in article header, Default true.
+							 * @param bool Whether to show the categories in article header. Default true.
 							 */
 							$show_categories = apply_filters( 'twentytwenty_show_categories_in_entry_header', true );
 
@@ -162,10 +162,10 @@
 		get_template_part( 'template-parts/navigation' );
 	}
 
-	/**
-	 *  Output comments wrapper if it's a post, or if comments are open,
+	/*
+	 * Output comments wrapper if it's a post, or if comments are open,
 	 * or if there's a comment number – and check for password.
-	 * */
+	 */
 	if ( ( is_single() || is_page() ) && ( comments_open() || get_comments_number() ) && ! post_password_required() ) {
 		?>
 

wp-content/themes/twentytwenty/template-parts/content.php

@@ -74,10 +74,10 @@
 
 	}
 
-	/**
-	 *  Output comments wrapper if it's a post, or if comments are open,
+	/*
+	 * Output comments wrapper if it's a post, or if comments are open,
 	 * or if there's a comment number – and check for password.
-	 * */
+	 */
 	if ( ( is_single() || is_page() ) && ( comments_open() || get_comments_number() ) && ! post_password_required() ) {
 		?>
 

wp-content/themes/twentytwenty/template-parts/entry-header.php

@@ -25,7 +25,7 @@ if ( is_singular() ) {
 		 *
 		 * @since Twenty Twenty 1.0
 		 *
-		 * @param bool   Whether to show the categories in header, Default true.
+		 * @param bool Whether to show the categories in header. Default true.
 		 */
 		$show_categories = apply_filters( 'twentytwenty_show_categories_in_entry_header', true );
 

wp-content/themes/twentytwenty/template-parts/pagination.php

@@ -9,19 +9,21 @@
  * @since Twenty Twenty 1.0
  */
 
-/**
- * Translators:
- * This text contains HTML to allow the text to be shorter on small screens.
- * The text inside the span with the class nav-short will be hidden on small screens.
- */
-
 $prev_text = sprintf(
 	'%s <span class="nav-prev-text">%s</span>',
 	'<span aria-hidden="true">&larr;</span>',
+	/*
+	 * Translators: This text contains HTML to allow the text to be shorter on small screens.
+	 * The text inside the span with the class nav-short will be hidden on small screens.
+	 */
 	__( 'Newer <span class="nav-short">Posts</span>', 'twentytwenty' )
 );
 $next_text = sprintf(
 	'<span class="nav-next-text">%s</span> %s',
+	/*
+	 * Translators: This text contains HTML to allow the text to be shorter on small screens.
+	 * The text inside the span with the class nav-short will be hidden on small screens.
+	 */
 	__( 'Older <span class="nav-short">Posts</span>', 'twentytwenty' ),
 	'<span aria-hidden="true">&rarr;</span>'
 );

wp-content/themes/twentytwentyone/assets/css/custom-color-overrides.css

@@ -1,5 +1,5 @@
 /**
  * Custom Color Overrides
  *
- * This file is automatically populated if the user chooses custom colors in the Customzier.
+ * This file is automatically populated if the user chooses custom colors in the Customizer.
  */

wp-content/themes/twentytwentyone/assets/css/ie-editor.css

@@ -324,6 +324,19 @@ select {
 	background-position: right 10px top 60%;
 }
 
+select:focus {
+	border: 3px solid #39414d;
+	border-radius: 0;
+	color: #28303d;
+	font-size: 1.125rem;
+	-moz-appearance: none;
+	-webkit-appearance: none;
+	appearance: none;
+	padding: 10px 30px 10px 10px;
+	background: #fff url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='10' height='10' fill='%2328303d'><polygon points='0,0 10,0 5,5'/></svg>") no-repeat;
+	background-position: right 10px top 60%;
+}
+
 /*
  * text-underline-offset doesn't work in Chrome at all 👎
  * But looks nice in Safari/Firefox, so let's keep it and

wp-content/themes/twentytwentyone/assets/css/ie.css

@@ -9,7 +9,7 @@ Description: Twenty Twenty-One is a blank canvas for your ideas and it makes the
 Requires at least: 5.3
 Tested up to: 5.8
 Requires PHP: 5.6
-Version: 1.3
+Version: 1.4
 License: GNU General Public License v2 or later
 License URI: http://www.gnu.org/licenses/gpl-2.0.html
 Text Domain: twentytwentyone

wp-content/themes/twentytwentyone/assets/css/style-editor.css

@@ -449,7 +449,8 @@ figcaption,
 	padding: 0;
 }
 
-select {
+select,
+select:focus {
 	border: var(--form--border-width) solid var(--form--border-color);
 	border-radius: var(--form--border-radius);
 	color: var(--form--color-text);

wp-content/themes/twentytwentyone/assets/js/customize-helpers.js

@@ -1,6 +1,8 @@
 /**
  * Get luminance from a HEX color.
  *
+ * @since Twenty Twenty-One 1.0
+ *
  * @param {string} hex - The hex color.
  *
  * @return {number} - Returns the luminance, number between 0 and 255.
@@ -13,6 +15,8 @@ function twentytwentyoneGetHexLum( hex ) { // jshint ignore:line
 /**
  * Get RGB from HEX.
  *
+ * @since Twenty Twenty-One 1.0
+ *
  * @param {string} hex - The hex color.
  *
  * @return {Object} - Returns an object {r, g, b}

wp-content/themes/twentytwentyone/assets/js/palette-colorpicker.js

@@ -5,6 +5,8 @@
  * with a few tweaks:
  * 		Removed the hue picker script because we don't use it here
  * 		Added the "palettes" argument in wpColorPicker().
+ *
+ * @since Twenty Twenty-One 1.0
  */
 wp.customize.controlConstructor['twenty-twenty-one-color'] = wp.customize.Control.extend( {
 	ready: function() {

wp-content/themes/twentytwentyone/assets/js/polyfills.js

@@ -7,6 +7,8 @@
 /**
  * Polyfill for Element.closest() because we need to support IE11.
  *
+ * @since Twenty Twenty-One 1.0
+ *
  * @see https://developer.mozilla.org/en-US/docs/Web/API/Element/closest
  */
 if ( ! Element.prototype.matches ) {
@@ -29,6 +31,8 @@ if ( ! Element.prototype.closest ) {
 /**
  * Polyfill for NodeList.foreach() because we need to support IE11.
  *
+ * @since Twenty Twenty-One 1.0
+ *
  * @see https://developer.mozilla.org/en-US/docs/Web/API/NodeList/forEach
  */
 if ( window.NodeList && ! NodeList.prototype.forEach ) {

wp-content/themes/twentytwentyone/assets/js/primary-navigation.js

@@ -7,9 +7,10 @@
 /**
  * Toggle an attribute's value
  *
+ * @since Twenty Twenty-One 1.0
+ *
  * @param {Element} el - The element.
  * @param {boolean} withListeners - Whether we want to add/remove listeners or not.
- * @since Twenty Twenty-One 1.0
  */
 function twentytwentyoneToggleAriaExpanded( el, withListeners ) {
 	if ( 'true' !== el.getAttribute( 'aria-expanded' ) ) {
@@ -37,6 +38,8 @@ function twentytwentyoneCollapseMenuOnClickOutside( event ) {
 /**
  * Changes the position of submenus so they always fit the screen horizontally.
  *
+ * @since Twenty Twenty-One 1.0
+ *
  * @param {Element} li - The li element.
  */
 function twentytwentyoneSubmenuPosition( li ) {
@@ -65,6 +68,8 @@ function twentytwentyoneSubmenuPosition( li ) {
 /**
  * Handle clicks on submenu toggles.
  *
+ * @since Twenty Twenty-One 1.0
+ *
  * @param {Element} el - The element.
  */
 function twentytwentyoneExpandSubMenu( el ) { // jshint ignore:line
@@ -92,6 +97,8 @@ function twentytwentyoneExpandSubMenu( el ) { // jshint ignore:line
 	/**
 	 * Menu Toggle Behaviors
 	 *
+	 * @since Twenty Twenty-One 1.0
+	 *
 	 * @param {string} id - The ID.
 	 */
 	var navMenu = function( id ) {
@@ -112,9 +119,12 @@ function twentytwentyoneExpandSubMenu( el ) { // jshint ignore:line
 				mobileButton.focus();
 			};
 		}
+
 		/**
 		 * Trap keyboard navigation in the menu modal.
-		 * Adapted from TwentyTwenty
+		 * Adapted from Twenty Twenty.
+		 *
+		 * @since Twenty Twenty-One 1.0
 		 */
 		document.addEventListener( 'keydown', function( event ) {
 			var modal, elements, selectors, lastEl, firstEl, activeEl, tabKey, shiftKey, escKey;
@@ -158,7 +168,9 @@ function twentytwentyoneExpandSubMenu( el ) { // jshint ignore:line
 
 		/**
 		 * Close menu and scroll to anchor when an anchor link is clicked.
-		 * Adapted from TwentyTwenty.
+		 * Adapted from Twenty Twenty.
+		 *
+		 * @since Twenty Twenty-One 1.1
 		 */
 		document.addEventListener( 'click', function( event ) {
 			// If target onclick is <a> with # within the href attribute

wp-content/themes/twentytwentyone/assets/js/skip-link-focus-fix.js

@@ -6,6 +6,8 @@
  * This is the source file for what is minified in the twenty_twenty_one_skip_link_focus_fix() PHP function.
  *
  * Learn more: https://git.io/vWdr2
+ *
+ * @since Twenty Twenty-One 1.0
  */
 ( function() {
 	var isIe = /(trident|msie)/i.test( navigator.userAgent );

wp-content/themes/twentytwentyone/assets/sass/01-settings/file-header.scss

@@ -7,7 +7,7 @@ Description: Twenty Twenty-One is a blank canvas for your ideas and it makes the
 Requires at least: 5.3
 Tested up to: 5.8
 Requires PHP: 5.6
-Version: 1.3
+Version: 1.4
 License: GNU General Public License v2 or later
 License URI: http://www.gnu.org/licenses/gpl-2.0.html
 Text Domain: twentytwentyone

wp-content/themes/twentytwentyone/assets/sass/04-elements/forms-editor.scss

@@ -1,4 +1,5 @@
-select {
+select,
+select:focus {
 	border: var(--form--border-width) solid var(--form--border-color);
 	border-radius: var(--form--border-radius);
 	color: var(--form--color-text);

wp-content/themes/twentytwentyone/classes/class-twenty-twenty-one-custom-colors.php

@@ -15,8 +15,6 @@ class Twenty_Twenty_One_Custom_Colors {
 	/**
 	 * Instantiate the object.
 	 *
-	 * @access public
-	 *
 	 * @since Twenty Twenty-One 1.0
 	 */
 	public function __construct() {
@@ -34,12 +32,9 @@ class Twenty_Twenty_One_Custom_Colors {
 	/**
 	 * Determine the luminance of the given color and then return #fff or #000 so that the text is always readable.
 	 *
-	 * @access public
-	 *
-	 * @param string $background_color The background color.
-	 *
 	 * @since Twenty Twenty-One 1.0
 	 *
+	 * @param string $background_color The background color.
 	 * @return string (hex color)
 	 */
 	public function custom_get_readable_color( $background_color ) {
@@ -53,12 +48,9 @@ class Twenty_Twenty_One_Custom_Colors {
 	 * Both text and link colors needs to be updated.
 	 * The code below needs to be updated, because the colors are no longer theme mods.
 	 *
-	 * @access public
-	 *
 	 * @since Twenty Twenty-One 1.0
 	 *
 	 * @param string|null $context Can be "editor" or null.
-	 *
 	 * @return string
 	 */
 	public function generate_custom_color_variables( $context = null ) {
@@ -87,8 +79,6 @@ class Twenty_Twenty_One_Custom_Colors {
 	/**
 	 * Customizer & frontend custom color variables.
 	 *
-	 * @access public
-	 *
 	 * @since Twenty Twenty-One 1.0
 	 *
 	 * @return void
@@ -102,8 +92,6 @@ class Twenty_Twenty_One_Custom_Colors {
 	/**
 	 * Editor custom color variables.
 	 *
-	 * @access public
-	 *
 	 * @since Twenty Twenty-One 1.0
 	 *
 	 * @return void
@@ -127,12 +115,9 @@ class Twenty_Twenty_One_Custom_Colors {
 	 *
 	 * @static
 	 *
-	 * @access public
-	 *
 	 * @since Twenty Twenty-One 1.0
 	 *
 	 * @param string $hex The HEX color.
-	 *
 	 * @return int Returns a number (0-255).
 	 */
 	public static function get_relative_luminance_from_hex( $hex ) {
@@ -158,12 +143,9 @@ class Twenty_Twenty_One_Custom_Colors {
 	/**
 	 * Adds a class to <body> if the background-color is dark.
 	 *
-	 * @access public
-	 *
 	 * @since Twenty Twenty-One 1.0
 	 *
 	 * @param array $classes The existing body classes.
-	 *
 	 * @return array
 	 */
 	public function body_class( $classes ) {

wp-content/themes/twentytwentyone/classes/class-twenty-twenty-one-customize-color-control.php

@@ -27,8 +27,6 @@ class Twenty_Twenty_One_Customize_Color_Control extends WP_Customize_Color_Contr
 	/**
 	 * Colorpicker palette
 	 *
-	 * @access public
-	 *
 	 * @since Twenty Twenty-One 1.0
 	 *
 	 * @var array
@@ -38,8 +36,6 @@ class Twenty_Twenty_One_Customize_Color_Control extends WP_Customize_Color_Contr
 	/**
 	 * Enqueue control related scripts/styles.
 	 *
-	 * @access public
-	 *
 	 * @since Twenty Twenty-One 1.0
 	 *
 	 * @return void
@@ -60,8 +56,6 @@ class Twenty_Twenty_One_Customize_Color_Control extends WP_Customize_Color_Contr
 	/**
 	 * Refresh the parameters passed to the JavaScript via JSON.
 	 *
-	 * @access public
-	 *
 	 * @since Twenty Twenty-One 1.0
 	 *
 	 * @uses WP_Customize_Control::to_json()

wp-content/themes/twentytwentyone/classes/class-twenty-twenty-one-customize-notice-control.php

@@ -29,8 +29,6 @@ class Twenty_Twenty_One_Customize_Notice_Control extends WP_Customize_Control {
 	 *
 	 * This simply prints the notice we need.
 	 *
-	 * @access public
-	 *
 	 * @since Twenty Twenty-One 1.0
 	 *
 	 * @return void