Skip to content

Home

Jump to bottom
Jo Dickson edited this page Feb 3, 2020 · 7 revisions

What are these files?

This template repo is a boilerplate set of files for WordPress themes, for use in projects created by UCF Communications and Marketing (specifically, UCF Web Communications/Webcom). It includes an opinionated set of build tool and linter configurations for rapid development of minified, optimized theme assets that follow our team's code standards.

How to create a new theme repo

To ensure our projects are created with the latest configurations and README information, CM devs should create new theme projects from this repo. Use the guide below to get started:

Instructions:

  1. Create a new repo in Github using this template.

  2. Pull down your new repo into your local development environment.

  3. Replace {{My-Project}} and {{My Project}} placeholders throughout the template files.

    {{My-Project}} corresponds to the the slug of your project on Github, e.g. Main-Site-Theme.

    {{My Project}} should be replaced with the human-friendly name of your project, e.g. Main Site Theme.

    You can perform a couple of project-wide find+replace commands in your IDE/editor to do this quickly.

That's it! From here, continue developing your theme as you would normally. Remember to fill in the remaining placeholder information for your project in the README, CONTRIBUTING doc, and other files! (You can do a project-wide search for {{ to locate all of these placeholders.)

Post-setup checklist:

In addition to setting up your new project on Github using these files, remember to also do the following for all new projects. Some parts of our project documentation depend on the following existing:

Things to know / project assumptions

Projects generated using these template files assume the following:

  • The developer is responsible for setting up registration of ALL project css and js; no enqueuing is included in the template files out-of-the-box
  • Minified css and js will be saved to static/
  • The Athena Framework is included in all generated themes
  • style.css is NOT a registered stylesheet, in favor of static/css/style.min.css
  • If ACF is a required plugin, its field config should be saved to dev/acf-config.json
Clone this wiki locally