Version 0.9
Adam Powell ( @AdamInfinitum / adaminfinitum.com)
Built upon Matt Bank's WordPress Starter Theme as detailed below customizations including Gumby Framework Version 2.5.15
Matt Banks ( @mattbanks / kernelcreativemedia.com / mattbanks.me )
WordPress Starter Theme for use as a starting template for building custom themes. Uses Compass/SCSS, HTML5 Boilerplate 4 with Modernizr and Normalize.css, and Grunt for all tasks. Tested with WordPress 3.6 RC2.
The theme is setup to use Grunt to compile Compass/SCSS, lint, concatenate and minify JavaScript (with source maps), optimize images, and LiveReload the browser (with extension), with flexibility to add any additional tasks via the Gruntfile. Alternatively, you can use CodeKit or whatever else you prefer to compile the SCSS and manage the JavaScript.
Rename folder to your theme name, change the assets/scss/style.scss
intro block to your theme information. Open the theme directory in terminal and run npm install
to pull in all Grunt dependencies. Run grunt
to execute tasks. Code as you will. If you have the LiveReload browser extension, it will reload after any SCSS or JS changes. To optimize images, run grunt imagemin
.
- Compile
assets/scss/style.scss
tostyle.css
(all paths defined in config.rb for Compass) - Compile
assets/scss/editor-style.scss
toeditor-style.css
- Concatenate and minify plugins in
assets/js/vender
andassets/js/source/plugins.js
toassets/js/plugins.min.js
- Minify
assets/js/source/main.js
toassets/js/main.min.js
- ??
- Profit
To concatenate and minify your jQuery plugins, add them to the assets/js/vendor
directory and add the js
filename and path to the Gruntfile
uglify
task. Previous versions of the starter theme automatically pulled all plugins in the vendor
directory, but this has changed to allow more granular control and for managing plugins and assets with bower.
Supports bower to install and manage JavaScript dependencies in the assets/js/vendor
folder.
The theme includes deployments via grunt-rsync. The Gruntfile includes setups for staging and production - edit your paths and host, then run grunt rsync:staging
or grunt rsync:production
to deploy your files via rsync.
- Normalized stylesheet for cross-browser compatibility using Normalize.css version 2 (IE8+ only)
- Easy to customize
- Flexible grid from Chris Coyier
- Media Queries for mobile and tablets ready to populate
- Removed comments from pages
- Compass & SCSS with plenty of mixins ready to go
- Much much more
- Use Google Libraries
- WordPress SEO by Yoast
- Google Analytics for WordPress by Yoast
- W3 Total Cache
- Gravity Forms
- update to normalize v2.1.3
- update deployment info to fit new rsyncwrapper options
- source maps fully work now!
- update grunt dependencies
- update grunt dependencies
- switch to load-grunt-tasks for loading everything
- restructure deploy task based on grunt-rsync updates
- manually manage plugins in
Gruntfile
instead of automatically pulling all files to streamline bower usage.
- add bower support with
.bowerrc
(thanks tjtate)
- tweak Gruntfile.js to fix LiveReload issues and generate source maps for both main.js and plugins.js
- update to normalize v2.1.2
- optimizations and tweaks here and there
- create
templates
folder and include example portfolio page template - create
templates/partials
and move all template parts there for cleaner directory structure, update allget_template_part()
calls to use new path
- reorganize code in
assets
folder for fonts, images, js and scss - setup Gruntfile to use Grunt for all compiling, concatenation and minification
- add deployments via rsync
- update to normalize v2.1.0
- refactor theme functions in
lib
folder - general code cleanup
- Fix remove_menu_page to trigger on admin_menu instead of admin_init
- Add grid column sizes I typically use, general code cleanup
- Fix calls for favicon and apple-touch-icon in header
- Remove older IE conditional comments since I don't support IE7 and below
- Change chromeframe call to include IE7
- Clean up footer dynamic_sidebar() call
- Add comment blocks for template parts
- Add functions to remove dashboard widgets, remove admin menu pages, reorder admin menu
- Include add_image_size if needed in init
- Fix text selection bg and color not pulling from variables
- Move border-box from
_grid.scss
to_global.scss
- Add border-box support for pseudo elements, because it makes the world a better place
- Fix broken call in sidebar.php
- Properly translate widget titles
- Break functions out into their own included files
- Register style before enqueue
- Redo comments template based on Underscores Theme
- Added required classes to _posts.scss to remember to style them
- Broke register_sidebar() out of loop
- Add support for custom-header, custom-background, editor-style.css, content_width
- Add GPL license info to style.scss
- Add function to remove query strings from static resources
- Remove shortlink from wp_head
- Ran theme through Theme Check plugin to verify things were in order
- remove jQuery loading from Google CDN. Use Google Libraries plugin is a better option while using version of jQuery in WordPress Core
- cleaned up functions.php and made it more robust
- Moved index, single and page displays out to template parts
- Properly enqueue stylesheet in functions.php instead of manually in header.php
- Updated social network buttons to latest code
- Renamed jquery.functions.js to main.js
- Add flexible grid SCSS
- Updated to HTML5 Boilerplate 4
- Updated to Normalize.css 2
- Updated to Modernizr 2.6.2
- Include @media bubbling mixins, via Chris Coyier
- Other bug fixes and changes
- added compass with config.rb
- removed mixins covered by compass
- added SCSS as preprocessor files
- upgraded modernizr to 2.5.2
- upgraded jQuery to 1.7.2
- renamed script.js to jquery.functions.js
- functions.php points to minified versions of plugins.js and jquery.functions.js
- removed unneeded code in functions.php
- cleaned up header.php and footer.php
- added google +1 button to social buttons
- initial version
Without these projects, this WordPress Starter Theme wouldn't be where it is today.
- HTML5 Boilerplate
- Normalize.css
- SASS / SCSS
- Compass
- Don't Overthink It Grids
- Underscores Theme
- Grunt ======= infinitum =========
WordPress Theme with Gumby, Compass, Grunt, H5BP etc.
1d8a7a89d1dbcab1e0713fc90aedbbcd4f69ed83