A starter theme from WebDevStudios. https://wdunderscores.com
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!
I feature some of the web's most proven technologies like: Tailwind, npm, webpack, Sass, and PostCSS. To help you write clean code (that meets WordPress standards), we tap into @wordpress/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 also support Selective Refresh and Live Preview in the Theme Customizer.
Not to mention, I use Browsersync so you can watch your project update in real-time while you work.
Looking to use some of our custom Gutenberg blocks? It's easy! Add the WDS Blocks plugin for a quick starter including our Accordion and Carousel blocks.
Looking to use some of our Advanced Custom Fields Gutenberg Blocks? It's also easy! Add the WDS ACF Blocks plugin for a whole set of blocks built with ACF including: Accordion, Carousel, Call To Action, Fifty/Fifty, Hero, Recent Posts, and Related Posts.
Because I compile and bundle assets via NPM scripts, basic knowledge of the command line and the following dependencies are required:
If you want to keep it simple, head over to https://wdunderscores.com and generate your wd_s based theme from there. You just input the name of the theme you want to create, click the "Generate" button, and you get your ready-to-awesomize starter theme. Alternatively, you could download a pre-built ZIP
If you want to set me up manually:
-
Download and extract the zip into your
wp-content/themesdirectory and renamewd_sto fit your needs. -
Find & Replace
You'll need to change all instances of the name: wd_s.
- Search for:
@package wd_sand replace with:@package project_nameto capture the package name - Update
"WebDevStudios\wd_s,wd_s"to:"CompanyName\project_name,project_name"(with double quotes) in phpcs.xml.dist - Search for:
WebDevStudios\wd_sand replace with:CompanyName\project_nameto capture the namespaces - Update
"webdevstudios/wd_s"to"companyname/project_name"(with double quotes) in composer.json - Search for:
, 'wd_s'and replace with:, 'project_name'(inside backticks) to capture the text domain - Update
Text Domain: wd_sto:Text Domain: project_namein style.css - Update
"wd_s"to:"project_name"(with double quotes) in phpcs.xml.dist and package.json - Update
'wd_s'to:'project_name'(with single quotes) in inc/setup/setup.php - Search for:
wd_s_and replace with:project_name_to capture all the function names - Search for:
'wd_s-and replace with:'project_name-to capture prefixed handles - Search for
wd_s.potand replace with:project_name.potto capture translation files - Search for
wdunderscores.testand replace with:project_name.testto match your local development URL - Edit the theme information in the header of style.scss to meet your needs
From the command line, change directories to your new theme directory:
cd /wp-content/themes/your-themeInstall theme dependencies and trigger an initial build.
Note: You will need to have Composer and NPM 7 installed first.
npm i --legacy-peer-depsFrom the command line, type any of the following to perform an action:
| Command | Action |
|---|---|
npm run watch |
Builds assets and starts Live Reload and Browsersync servers |
npm run start |
Builds assets and starts Live Reload server |
npm run build |
Builds production-ready assets for a deployment |
npm run lint |
Check all CSS, JS, MD, and PHP files for errors |
npm run format |
Fix all CSS, JS, MD, and PHP formatting errors automatically |
Your contributions and support tickets are welcome. Please see our contributing guidelines before submitting a pull request.
wd_s is free software, and is released under the terms of the GNU General Public License version 2 or any later version. See LICENSE.md for complete license.