WebDevStudio's fork of Automattic's _s. Used as our starter theme.
Clone or download
Permalink
Failed to load latest commit information.
.github create `.github` folder and place templates in it Sep 22, 2017
acf-json Feature/#352 carousel block (#374) Sep 18, 2018
assets Fixes JS lint errors (#392) Sep 19, 2018
docs recompile ♻️ Sep 18, 2017
inc PHPCS Warnings and Error Fixes (#388) Sep 19, 2018
languages bump Jun 8, 2018
template-parts PHPCS Warnings and Error Fixes (#388) Sep 19, 2018
.bowerrc point bower at the /assets directory Feb 1, 2016
.editorconfig Don't enforce 4 tab size. (#340) Dec 5, 2017
.eslintrc.js Feature/#352 carousel block (#374) Sep 18, 2018
.gitignore Feature/composer (#342) Dec 12, 2017
.gitlab-ci.yml add gitlab ci integration (#375) Jun 12, 2018
.sass-lint.yml Hotfix/#387 css lint fixes (#390) Sep 19, 2018
.travis.yml update to use wds code standards (#359) Mar 24, 2018
404.php Feature/utilities updates (#319) Jul 21, 2017
Gulpfile.js Feature/#352 carousel block (#374) Sep 18, 2018
README.md Feature/#352 carousel block (#374) Sep 18, 2018
admin-acf-styles.css Theme/acf color picker customizations (#336). Closes #328 Oct 5, 2017
archive.php fix phpcs warnings Oct 2, 2017
bower.json packages & dependencies bump Jun 8, 2018
buddypress.php fix phpcs warnings Oct 2, 2017
comments.php fix phpcs warnings Oct 2, 2017
composer.json Change WDS Coding Standards to a dev dependency, update composer.lock. ( Apr 9, 2018
composer.lock Feature/#352 carousel block (#374) Sep 18, 2018
footer.php display social network links in footer Sep 22, 2017
functions.php PHPCS Warnings and Error Fixes (#388) Sep 19, 2018
header.php Theme/navigation refactor (#335). Closes #273 Oct 3, 2017
index.php fix phpcs warnings Oct 2, 2017
package-lock.json packages & dependencies bump Jun 8, 2018
package.json packages & dependencies bump Jun 8, 2018
page.php fix phpcs warnings Oct 2, 2017
phpcs.xml Feature/#352 carousel block (#374) Sep 18, 2018
rtl.css use more bourbon mixins Mar 17, 2015
screenshot.png Merge screenshot.php from upstream _s Sep 20, 2015
search.php fix phpcs warnings Oct 2, 2017
searchform.php fix phpcs warnings Oct 2, 2017
sidebar.php Feature/utilities updates (#319) Jul 21, 2017
single.php fix phpcs warnings Oct 2, 2017
style.css Hotfix/#387 css lint fixes (#390) Sep 19, 2018
style.min.css Feature/#352 carousel block (#374) Sep 18, 2018
template-acf.php Hotfix/#343 password protect blocks (#351) Mar 23, 2018
template-scaffolding.php Feature/acf (#321) Aug 18, 2017
template-sidebar-right.php fix phpcs warnings Oct 2, 2017
yarn.lock Feature/utilities updates (#319) Jul 21, 2017

README.md

wd_s

Build Status

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: Gulp, LibSass, Babel, PostCSS, Bourbon 4.3, Neat v1.9, and BrowserSync. To help you write clean code (that meets WordPress standards), I'm also bundled with a Sass Lint, ESLint, and PHPCS linting rulesets. Did I mention that I'm also accessible? Yup. I pass both WCAG 2.0AA and Section 508 standards out of the box.

If that weren't enough, I also support synchronized JSON for Advanced Custom Fields and support both Selective Refresh and Live Preview in the Theme Customizer.

If you have the latest version of Advanced Custom Fields Pro, then you can take advantage of our ACF Content Blocks system. Content Blocks are great way to "visually manage blocks of content" throughout your website.

WebDevStudios. WordPress for big brands.

Getting Started

Prerequisites

Because I'm bundled with Gulp, basic knowledge of the command line and the following dependencies are required: either Yarn or Node, Gulp CLI (npm install -g gulp-cli), and Bower (npm install -g bower).

Quick Start

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.

Advanced

If you want to set me up manually:

  1. Download and extract the zip into your wp-content/themes directory and rename wd_s-master to fit your needs.

  2. Find & Replace

You'll need to change all instances of the names: _s.

  • Search for: '_s' and replace with: 'project-name' (inside single quotations) to capture the text domain
  • Search for: _s_ and replace with: project-name_ to capture all the function names
  • Search for: Text Domain: _s and replace with: Text Domain: project-name in style.css
  • Search for (and include the leading space):  _s and replace with:  Project Name (with a space before it) to capture DocBlocks
  • Search for: _s- and replace with: project-name- to capture prefixed handles
  • Search for _s.pot and replace with: project-name.pot to capture translation files
  • Search for _s.com and replace with: project-name.dev to match your local development URL
  • Edit the theme information in the header of style.scss to meet your needs

Development

After you've installed and activated me. It's time to setup Gulp.

  1. From the command line, change directories to your new theme directory
cd /your-project/wordpress/wp-content/themes/your-theme
  1. Install theme dependencies (use either Yarn or NPM)

Yarn

yarn install && bower install

NPM

npm install && bower install

Install and Gulp

Gulp Tasks

From the command line, type any of the following to perform an action:

gulp watch - Automatically handle changes to CSS, JS, SVGs, and image sprites. Also kicks off BrowserSync.

gulp icons - Minify, concatenate, and clean SVG icons.

gulp i18n - Scan the theme and create a POT file.

gulp sass:lint - Run Sass against WordPress code standards.

gulp js:lint - Run Javascript against WordPress code standards.

gulp scripts - Concatenate and minify javascript files.

gulp sprites - Generate an image sprite and the associated Sass (sprite.png).

gulp styles - Compile, prefix, combine media queries, and minify CSS files.

gulp - Runs the following tasks at the same time: i18n, icons, scripts, styles, sprites.

Contributing and Support

Your contributions and support tickets are welcome. Please see our guidelines before submitting a pull request.