WebDevStudio's fork of Automattic's _s. Used as our starter theme.
CSS PHP JavaScript
Latest commit 3315021 Jan 16, 2017 @blobaugh blobaugh committed with gregrickaby Added an image placeholder function (#233)
* Added an image placeholder function

After placehold.it went down I wanted to standardize how we are creating
placeholder images and stop relying on external services. This patch
will create a single method of creating basic placeholder images that
utilizes the infrastructure WebDevStudios already has in place.

* Swapping function params for array of args

Swapped out the function parameters for passing in an array of args per
code review. This was done to fall in line with the coding standards for
WebDevStudios.
Permalink
Failed to load latest commit information.
assets Adds the youtube iframe jsapi to the modal js. (#232) Jan 16, 2017
inc Added an image placeholder function (#233) Jan 16, 2017
languages Branch from master and begin copying mobile nav changes in. May 20, 2016
template-parts PHPCS Cleanup of Theme (minus template-tags.php) (#219) Nov 5, 2016
.bowerrc point bower at the /assets directory Feb 1, 2016
.editorconfig update .eslintrc.js file extension Jan 10, 2017
.eslintrc.js Rename and Update .eslintrc config file. Fixes #230. Props @cheffheid Dec 17, 2016
.gitignore only ignore bourbon/neat Feb 11, 2016
.sass-lint.yml Run through Sass Linter. Fixes #216 Nov 5, 2016
404.php Add end of file space Sep 30, 2016
CONTRIBUTING.md contributions bump Feb 22, 2016
Gulpfile.js New commit message Nov 4, 2016
README.md Hotfix/update readme #208 (#210) Oct 21, 2016
archive.php Add end of file space Sep 30, 2016
bower.json bower.json bump to latest Nov 3, 2016
buddypress.php PHPCS Cleanup of Theme (minus template-tags.php) (#219) Nov 5, 2016
comments.php PHPCS Cleanup of Theme (minus template-tags.php) (#219) Nov 5, 2016
footer.php PHPCS Cleanup of Theme (minus template-tags.php) (#219) Nov 5, 2016
functions.php PHPCS Cleanup of Theme (minus template-tags.php) (#219) Nov 5, 2016
header.php Remove old meta tag for chrome and edge. Dec 2, 2016
index.php Add end of file line Sep 30, 2016
package.json package.json bump to latest Nov 3, 2016
page.php Add end of file line Sep 30, 2016
phpcs.xml normalize config files. fixes #221 Nov 11, 2016
rtl.css use more bourbon mixins Mar 17, 2015
screenshot.png Merge screenshot.php from upstream _s Sep 20, 2015
search.php Add end of file line Sep 30, 2016
searchform.php PHPCS Cleanup of Theme (minus template-tags.php) (#219) Nov 5, 2016
sidebar.php Add end of file line Sep 30, 2016
single.php Add end of file line Sep 30, 2016
style.css Enhancement/screen reader text white space (#217) Nov 4, 2016
style.min.css Enhancement/screen reader text white space (#217) Nov 4, 2016

README.md

wd_s

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 exciting technologies like: Gulp, LibSass, PostCSS, Bourbon, Neat, and BrowserSync to help make your development process fast and efficient. I'm also accessible, passing both WCAG 2.0AA and Section 508 standards out of the box.

Getting Started

Prerequisites

Because I'm bundled with Gulp, basic knowledge of the command line and the following dependencies are required: 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

2) Install theme dependencies

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.