Installing Your Theme Locally

For development purposes you will need to clone your theme which should be stored in a version control repository (GitHub, BitBucket and GitLab are popular hosted version control platforms).

SMILE works on the basis of Parent/Child Theming, and has it’s own parent theme called “Lemonade”. There is a starter Child Theme called “Salt”. If you would like to take advantage of this, you should fork the child theme and clone your fork.

Cloning Your Theme

Wherever the Git Repository (Repo) is hosted, there will likely be some sort of “Clone” button, link or snippet. What you are looking for is something that resembles this:

git clone https://username@provider.com/wearesmile/repository-name.git

If you are given the choice between SSH or HTTPS, always choose HTTPS for compatibility reasons.

Copy this command, and open the command line (Terminal on OSX used as an example for the rest of this tutorial).

Navigating via the Command Line

Navigate to the themes directory of your WordPress instance. By default, Terminal will start you off in your users home directory. Let’s say you installed the default VVV folder (“vagrant-local”) into a folder called “Sites”. The path to your themes folder will be Sites/vagrant-local/www/wordpress-default/wp-content/themes.

To change into this directory you would type cd Sites/vagrant-local/www/wordpress-default/wp-content/themes

Then you can paste in the snippet from earlier in this tutorial. This will clone the repo to your hard disk. You are now ready to modify the files and commit changes back to Version Control.

Before we move on and only if you are using a Git GUI Client (like GitHub Desktop), you may want to add this repo to your app so you can commit and sync via its interface.

Checking the Theme

If you’ve just cloned a new fork of Salt, you may want to consider updating “style.css” in the theme root directory so that you can tell which is your new theme when we get to the WordPress activation screens.

Back in the WordPress Network Dashboard, you should navigate to themes (“Appearance > Themes”) and check your theme is available. If your theme is broken or is missing a parent theme, it will alert you.

From the “Themes” view in WordPress, you can “Network Activate” a theme. The rest of this tutorial is based on you having NOT network activated the theme.

Was this article helpful?

Related Articles