1: Theme files & folders
WordPress themes have a tendency to quickly get large, disorganized, and unmanageable (i.e. file soup). NOUVEAU attempts to solve this problem by using a clean, standardized file structure. This chapter will quickly explain the purpose of each of the folders and files in NOUVEAU‘s root directory.
The bower_components folder contains all the Bower components found in the SASS version of Zurb Foundation for Sites. This is also where you will find any original, un-minified (dev) files.
* This is included to make life easier for folks who might not be as cutting-edge as the rest of us, with our fancy-pants dependency management and whatnot. You can still update the bower dependencies on your own if you like.
The NV folder contains all the files and folders for the NOUVEAU starter theme library. Everything in this folder is part of the
NV\Theme\ namespace. This is the meat and potatoes of NOUVEAU, where most of the magic happens.
The overrides folder contains all your admin-selectable page templates.
The parts folder contains any template-oriented code fragments.
The comments folder more readily exposes the various parts of the comments systems as standard WordPress template files. If you plan on using a different comment system (e.g. Disqus), then you should feel free to delete this.
The layout folder lets you keep your
footer.php files out of the way. This is also helpful for those cases when you need to juggle multiple header and/or footer files.
The tests directory contains files needed to get up and running with PhpUnit for your theme. If you are not planning to use PhpUnit or unit testing in your workflow, you can safely delete this folder and it’s contents.
About the theme root folder…
Although the theme root will technically continue to work exactly as it always has, in NOUVEAU the root should generally only be used for full-page template files. Use the
parts folder for any partials, or
parts/layout for headers and footers.
Of course, you’ll find a few other files in the root as well, as WordPress convention makes it impossible to safely remove or relocate them. Let’s briefly cover some of the key root files…
archive.php file is a standard WordPress template for archive pages.
This is a bower manifest file, containing all the version numbers of the various dependencies currently being used. Any time one of the packages (Foundation, et al) gets updated, this file is updated automatically. It’s how bower keeps track of updates.
This is a preconfigured CodeKit project file for anyone who wants to use CodeKit as their SASS/JS compiler. If you are not using CodeKit, you can safely delete this file.
functions.php is a required WordPress theme file. By default, it loads and initializes the entire
NV class and namespace (which is responsible for all NOUVEAUs back-end magic).
index.php file is a standard WordPress page template, and is used by WordPress when no more-specific template is available.
This file contains a list of dependencies that need to be installed / updated / used when you use Gulp as part of your workflow. If you are not using Gulp in your workflow, you can safely delete this file.
This file contains configuration information needed configuring PhpUnit unit tests for your theme. If you do not plan on using unit tests in your workflow, you can safely delete this file.
This is simply a Github-friendly version of a WordPress standard
readme.txt file. It can be safely deleted.
A copy of the Foundation 6 readme. It can be safely deleted.
single.php template file serves as an example for how a template file can work without the need for a loop. Instead,
get_post() is simply called once near the top of the file.
style.css file is a required WordPress theme file. Since NOUVEAU works best when used with the SASS version of Foundation, this contains no actual CSS by default… but it does contain mandatory metadata which is required by WordPress (such as theme name, author, version, etc).
You should work in
style.css only if you are planning on using regular CSS instead of SASS.
This page was last updated on September 16, 2016 – it is currently considered COMPLETE.