This is a WordPress starter theme based on Foundation 5 by Zurb. The purpose of FoundationPress, is to act as a small and handy toolbox that contains the essentials needed to build any design. FoundationPress is meant to be a starting point, not the final product. If you're looking for an all-in-one theme with built-in shortcodes, plugins, fancypancy portfolio templates or whatnot, I'm afraid you have to look elsewhere.
Please fork, copy, modify, delete, share or do whatever you like with this.
All contributions are welcome!
A brief explanation to the requirements (feel free to skip this if you're a pro):
Back in the days we wrote all styles in the style.css file. Then we realized that this could quickly create clutter and confusion, especially in larger projects. Foundation uses SASS (equivalent to LESS, used in Bootstrap). In short, SASS is a CSS pre-processor that allows you to write styles more effectively and tidy.
To compile SASS files into one style sheet, we use a tool called Grunt. In short, Grunt is a task runner that automates repetitive tasks like minification, compilation, linting, etc. Grunt and Grunt plugins are installed and managed via npm, the Node.js package manager. Before setting up Grunt ensure that your npm is up-to-date by running npm update -g npm (this might require sudo on certain systems)
Bower is a package manager used by Zurb to distribute Foundation. When you have Bower installed, you will be able to run foundation update in the terminal to update Foundation to the latest version. (After an upgrade you must run grunt build to recompile files).
Okay, so you'll need to have the following items installed before continuing.
- Node.js: Due to an unresolved incompability issue with node-sass, we will need to use Node v. 0.10.33 (stable). See this issue for a more detailed description
- Grunt: Run
[sudo] npm install -g grunt-cli - Bower: Run
[sudo] npm install -g bower
cd my-wordpress-folder/wp-content/themes/
git clone git@github.com:olefredrik/FoundationPress.git
mv FoundationPress your-theme-name
cd your-theme-name
npm install && bower install && grunt buildTip 1:
If you get an error saying Permission denied (publickey) when cloning the repository, use the https protocol instead:
git clone https://github.com/olefredrik/FoundationPress.git
Tip 2: If you get a fatal error during installation, it might be related to a libsass incompability issue with the latest version of nodejs. Check the guide at the bottom of this page: olefredrik#209
While you're working on your project, run:
grunt watch
And you're set!
Check for Foundation Updates? Run:
foundation update
(this requires the foundation gem to be installed in order to work. Please see the docs for details.)
-
style.css: Do not worry about this file. (For some reason) it's required by WordPress. All styling are handled in the Sass files described below -
scss/foundation.scss: Imports for Foundation components and your custom styles. -
scss/config/_settings.scss: Original Foundation 5 base settings -
scss/assets/_icons.scss: Foundation Icons -
scss/site/_base.scss: Basic styles for FoundationPress. These can be replaced by your needs. -
css/foundation.css: All Sass files are minified and compiled to this file -
css/foundation.css.map: CSS source maps
-
bower_components/: This is the source folder where all Foundation components are located.foundation updatewill check and update scripts in this folder. -
js/custom: This is where you put all your custom scripts. Every .js file you put in this directory will be minified and concatinated to foundation.js -
js/vendor: Vendor scripts are copied frombower_components/to this directory. We use this path for enqueing the vendor scripts in WordPress. -
Please note that you must run
grunt buildin your terminal for the script to be copied and concatinated. See Gruntfile.js for details
- Clean FoundationPress install
- FoundationPress Kitchen Sink - see every single element in action
- FoundationPSD - Photoshop template for Foundation
- Learn to use the _settings file to change almost every aspect of a Foundation site
- Other lessons from Zurb University
- Harvard Center for Green Buildings and Cities
- Parent-Child Home Program
- Hip and Healthy
- Thinx Underwear
- Threadbird blog
- Public House Wines
- Franchise Career Advisors
- Le saint
- Help blog
- Maren Schmidt
- Ciancimino Gallery
- Sokolove Law
- Pandora Children's Parties
- The Rainbow Venues
- Ameronix
- Finnerodja
- Nufloors
- Glossop Cartons
- Ready4Work
- Just Legal
- Vintage and Stuff
- Software for FM
- Star the project!
- Answer questions that come through GitHub issues
- Report a bug that you find
- Share a theme you've built on top of FoundationPress
- Tweet and blog about the advantages (and criticisms) of FoundationPress
Pull requests are highly appreciated. About a dozen people have written parts of FoundationPress (so far). Here are some guidelines to help:
- Solve a problem. Features are great, but even better is cleaning-up and fixing issues in the code that you discover
- Make sure that your code is bug-free and does not introduce new bugs
- Create a pull request