Merge branch 'main' into feature/WDSUS-44-dependency-updates

.vscode/settings.json

@@ -1,4 +1,5 @@
 {
+	"phpsab.standard": "WordPress",
 	"phpsab.executablePathCS": "./vendor/bin/phpcs",
 	"phpsab.executablePathCBF": "./vendor/bin/phpcbf",
 	"editor.formatOnSave": true,

CHANGELOG.md

@@ -2,9 +2,24 @@
 
 All notable changes to this project will be documented in this file. Dates are displayed in UTC.
 
-## Details
+Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
 
-### [v3.5](https://github.com/WebDevStudios/wd_s/compare/3.0...v3.5)
+## [v4.0.0](https://github.com/WebDevStudios/wd_s/compare/v3.5...v4.0.0)
+
+- Add scaffolding code for the acf block generated using CLI [`#1094`](https://github.com/WebDevStudios/wd_s/pull/1094)
+- Feature/site editor index [`#1097`](https://github.com/WebDevStudios/wd_s/pull/1097)
+- Feature/WDSUS-45 WDS Cleanup [`#1072`](https://github.com/WebDevStudios/wd_s/pull/1072)
+- Feature/WDSUS-43 Folder Restructure [`#1062`](https://github.com/WebDevStudios/wd_s/pull/1062)
+- Feature/wdsus 7 implement wp cli [`#1006`](https://github.com/WebDevStudios/wd_s/pull/1006)
+- WDSUS-19: adds WDS Blocks category [`#1022`](https://github.com/WebDevStudios/wd_s/pull/1022)
+- #958 changed dirname call to WP method [`#1019`](https://github.com/WebDevStudios/wd_s/pull/1019)
+- Update CHANGELOG.md [`#1015`](https://github.com/WebDevStudios/wd_s/pull/1015)
+- WDSUS-24 - Update Changelog [`#1014`](https://github.com/WebDevStudios/wd_s/pull/1014)
+- WDSUS-45 - Update lock files [`77435d5`](https://github.com/WebDevStudios/wd_s/commit/77435d5e87135c14d581a2b65dbadd02deda325a)
+- WDSUS-2 - Update packages [`82cde06`](https://github.com/WebDevStudios/wd_s/commit/82cde06325363bd80a79bf63f545d16ea9f20a2a)
+- WDSUS-2 Update package lock file [`c1406ab`](https://github.com/WebDevStudios/wd_s/commit/c1406abac10765eb667e81e12352947d7697d8af)
+
+## [v3.5](https://github.com/WebDevStudios/wd_s/compare/3.0...v3.5)
 
 > 20 May 2023
 
@@ -178,7 +193,7 @@ All notable changes to this project will be documented in this file. Dates are d
 - Update text domains and package names [`ddb6fb8`](https://github.com/WebDevStudios/wd_s/commit/ddb6fb8e141edb6b24faf52693eccd5d3b7ced11)
 - Fix spacing issues [`0c601aa`](https://github.com/WebDevStudios/wd_s/commit/0c601aa5176bac0d0edcf84a28cd9d7dd5dd8d2c)
 
-#### [2.1](https://github.com/WebDevStudios/wd_s/compare/v2.0.1...2.1)
+## [2.1](https://github.com/WebDevStudios/wd_s/compare/v2.0.1...2.1)
 
 > 20 April 2021
 
@@ -216,7 +231,7 @@ All notable changes to this project will be documented in this file. Dates are d
 - fix merge conflict [`0abaf96`](https://github.com/WebDevStudios/wd_s/commit/0abaf96a60004bb97652a0185552931de45c61bf)
 - Adds browsersync and scripts [`ac9af1b`](https://github.com/WebDevStudios/wd_s/commit/ac9af1bbb386e5042ee6bab4c369f5d127a1ecca)
 
-#### [v2.0.1](https://github.com/WebDevStudios/wd_s/compare/v2.0.0...v2.0.1)
+## [v2.0.1](https://github.com/WebDevStudios/wd_s/compare/v2.0.0...v2.0.1)
 
 > 10 November 2020
 
@@ -702,7 +717,7 @@ All notable changes to this project will be documented in this file. Dates are d
 - Merges in ACF + Gutenberg update [`43a56d8`](https://github.com/WebDevStudios/wd_s/commit/43a56d8eaf261903cd2b2d74d4d4c0b7421035a9)
 - packages & dependencies bump [`7d5f7b4`](https://github.com/WebDevStudios/wd_s/commit/7d5f7b4512fe76b7caf138266e6eaef7616a8327)
 
-#### 1.2
+## 1.2
 
 > 28 December 2012
 

README.md

@@ -4,7 +4,7 @@
 
 A starter theme from WebDevStudios. <https://wdunderscores.com>
 
-[![WebDevStudios. Your Success is Our Mission.](https://webdevstudios.com/wp-content/uploads/2018/04/wds-github-banner.png)](https://webdevstudios.com/contact/)
+[![WebDevStudios. Your Success is Our Mission.](https://camo.githubusercontent.com/42f2d2ee1fd163a35dfde75884c89f308d0ae014e313bd3050caa1b98bfde9c6/68747470733a2f2f77656264657673747564696f732e636f6d2f77702d636f6e74656e742f75706c6f6164732f323031382f30342f7764732d6769746875622d62616e6e65722e706e67)](https://webdevstudios.com/contact/)
 
 ## Table of Contents <!-- omit in toc -->
 
@@ -19,13 +19,11 @@ A starter theme from WebDevStudios. <https://wdunderscores.com>
 
 ## Introduction
 
-Hi. I'm a starter theme called `wd_s`, or `wdunderscores`. I'm a theme meant for hacking so don't use me as a Parent Theme. Instead, try turning me into the next, most awesome, WordPress theme out there. That's what I'm here for!
+Hello there! I am a versatile starter theme known as `wd_s`, or `wdunderscores`. My foundation is built primarily on PHP templates, but I offer the flexibility to incorporate custom templates through the Site Editor. It's worth noting that I'm designed for customization, so it's best not to use me as a Parent Theme. Instead, harness my potential to transform me into the most amazing WordPress theme you can envision – that's what I'm here for!
 
-I feature some of the web's most proven technologies like: [Tailwind](https://www.tailwindcss.com), [npm](https://www.npmjs.com/), [webpack](https://webpack.js.org/), [Sass](http://sass-lang.com/), and [PostCSS](https://github.com/postcss/postcss). To help you write clean code (that meets [WordPress standards](https://make.wordpress.org/core/handbook/best-practices/coding-standards/)), we tap into [@wordpress/scripts](https://developer.wordpress.org/block-editor/packages/packages-scripts/) for linting CSS and JavaScript. Did I mention that I'm also accessible? Yup. I pass both WCAG 2.1AA and Section 508 standards out of the box.
+I come equipped with a host of robust web technologies, including [Tailwind](https://www.tailwindcss.com), [npm](https://www.npmjs.com/), [webpack](https://webpack.js.org/), [Sass](http://sass-lang.com/), and [PostCSS](https://github.com/postcss/postcss). To ensure your code aligns with [WordPress standards](https://make.wordpress.org/core/handbook/best-practices/coding-standards/) and stays clean, I leverage [@wordpress/scripts](https://developer.wordpress.org/block-editor/packages/packages-scripts/) for CSS and JavaScript linting. What's more, I take accessibility seriously and proudly comply with both WCAG 2.1AA and Section 508 standards right from the start.
 
-I also support [Selective Refresh](https://make.wordpress.org/core/2016/03/22/implementing-selective-refresh-support-for-widgets/) and [Live Preview](https://codex.wordpress.org/Theme_Customization_API#Part_3:_Configure_Live_Preview_.28Optional.29) in the Theme Customizer.
-
-Not to mention, I use [Browsersync](https://www.browsersync.io/) so you can watch your project update in real-time while you work.
+I also come with the Site Editor activated, providing you with even more versatility and ease in crafting your WordPress theme. Whether you're customizing templates or utilizing the Site Editor, I'm here to support your creative journey. And remember, I do require at least PHP 8.0 to be activated to unlock my full potential.
 
 ## Getting Started
 

assets/scss/global/_global.scss

@@ -16,3 +16,7 @@ html {
 pre {
 	@apply overflow-auto;
 }
+
+.post-container {
+	@apply mb-6;
+}

assets/scss/template-tags/_comments.scss

@@ -0,0 +1,29 @@
+/* Comments
+--------------------------------------------- */
+
+.comments-area {
+	.comment-list {
+		@apply list-none mb-0 p-0;
+
+		.comment {
+			@apply clear-both;
+		}
+
+		.children {
+			@apply list-none my-4;
+		}
+	}
+
+	.comment-respond {
+		.comment-form {
+			.comment-form-comment {
+				@apply flex flex-col;
+
+				textarea {
+					@apply rounded-md;
+					border: 1px var( --wp--preset--color--primary-300 ) solid;
+				}
+			}
+		}
+	}
+}

assets/scss/template-tags/_forms.scss

@@ -0,0 +1,31 @@
+/* Comments
+--------------------------------------------- */
+button,
+input,
+optgroup,
+select,
+textarea {
+	@apply rounded-md;
+	border: 1px var( --wp--preset--color--primary-300 ) solid;
+	padding-top: 6px;
+	padding-right: 16px;
+	padding-bottom: 6px;
+	padding-left: 16px;
+}
+
+[type='reset'],
+[type='submit'] {
+	background-color: var( --wp--preset--color--tertiary-300 );
+	border-radius: 10px;
+	border-width: 0;
+	border-style: solid;
+	color: var( --wp--preset--color--white );
+	font-family: inherit;
+	font-size: var( --wp--preset--font-size--normal );
+	line-height: 1.435;
+	padding-top: 8px;
+	padding-right: 16px;
+	padding-bottom: 8px;
+	padding-left: 16px;
+	text-decoration: none;
+}

assets/scss/template-tags/index.scss

@@ -2,3 +2,6 @@
 // Template Tag Styles
 // Import partials for functions in template-tags.php.
 //----------------------------------------
+
+@import 'comments';
+@import 'forms';

assets/tailwind-preflight.css

@@ -140,8 +140,6 @@ table {
 
 /*
 1. Change the font styles in all browsers.
-2. Remove the margin in Firefox and Safari.
-3. Remove default padding in all browsers.
 */
 
 button,
@@ -154,8 +152,6 @@ textarea {
 	font-weight: inherit; /* 1 */
 	line-height: inherit; /* 1 */
 	color: inherit; /* 1 */
-	margin: 0; /* 2 */
-	padding: 0; /* 3 */
 }
 
 /*
@@ -169,16 +165,13 @@ select {
 
 /*
 1. Correct the inability to style clickable types in iOS and Safari.
-2. Remove default button styles.
 */
 
 button,
 [type='button'],
 [type='reset'],
 [type='submit'] {
 	-webkit-appearance: button; /* 1 */
-	background-color: transparent; /* 2 */
-	background-image: none; /* 2 */
 }
 
 /*

front-page.php

@@ -16,14 +16,6 @@
 
 			<?php
 			if ( have_posts() ) :
-				if ( is_home() && ! is_front_page() ) :
-					?>
-					<header class="entry-header is-layout-constrained">
-						<h1 class="page-title screen-reader-text"><?php single_post_title(); ?></h1>
-					</header>
-
-					<?php
-				endif;
 
 				/* Start the Loop */
 				while ( have_posts() ) :

home.php

@@ -14,17 +14,12 @@
 	<div class="wp-site-blocks">
 		<main id="main" class="<?php echo esc_attr( main_classes( [] ) ); ?>">
 
-			<?php
-			if ( have_posts() ) :
-				if ( is_home() && ! is_front_page() ) :
-					?>
+			<?php if ( have_posts() ) : ?>
 					<header class="entry-header is-layout-constrained has-global-padding">
 						<h1 class="page-title screen-reader-text"><?php single_post_title(); ?></h1>
 					</header>
 
-					<?php
-				endif;
-
+				<?php
 				/* Start the Loop */
 				while ( have_posts() ) :
 					the_post();

inc/template-tags/print-numeric-pagination.php

@@ -40,9 +40,11 @@ function print_numeric_pagination( $args = [], $query = null ) {
 	}
 	?>
 
-	<nav class="pagination-container" aria-label="<?php esc_attr_e( 'numeric pagination', 'wd_s' ); ?>">
-		<?php echo paginate_links( $args ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- XSS OK. ?>
-	</nav>
+	<div class="is-layout-constrained has-global-padding">
+		<nav class="pagination-container" aria-label="<?php esc_attr_e( 'numeric pagination', 'wd_s' ); ?>">
+			<?php echo paginate_links( $args ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- XSS OK. ?>
+		</nav>
+	</div>
 
 	<?php
 }

inc/wpcli/block-starter/block.php

@@ -4,3 +4,19 @@
  *
  * @package wd_s
  */
+
+// Add classes to block.
+$wds_classes = [];
+if ( ! empty( $block['className'] ) ) {
+	$wds_classes[] = $block['className'];
+}
+if ( ! empty( $block['align'] ) ) {
+	$wds_classes[] = 'align' . $block['align'];
+}
+
+// Add anchor to the block.
+$wds_anchor = ( ! empty( $block['anchor'] ) ) ? 'id="' . esc_attr( $block['anchor'] ) . '" ' : '';
+?>
+<section <?php echo $wds_anchor; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- XSS ?>class="<?php echo esc_attr( implode( ' ', $wds_classes ) ); ?>">
+	<!-- Your block render code goes here. -->
+</section>