Resources

Create a Framework Child Theme

Overview

Before using a child theme, it's important that you understand what a child theme is. Please, read the child theme guide from the WordPress Codex for more information.

Getting Started

To get started, you first need to have PageLines Framework installed and FTP access to your host so you can upload the new child theme. .

If you don't have FTP access or unsure how to use FTP, contact your web host and they can provide your FTP login details. You will also need to download a FTP program to upload your files.

Creating the child theme

To create a basic child theme, one directory and one CSS file (style.css) is required. You may also include a functions.php file. However, this is optional and only used for advanced customization. It isn't required for the child theme to operate.

Directory

The directory (folder) name can be whatever you like and doesn't require any special configuration.

Style.css

Using your favourite code editor (we recommend either Atom or SubLime Text) create a new file called style.css.

The name of the stylesheet (style.css) is important and can not be named anything else. It must be style.css, otherwise the child theme will not be recognized by WordPress.

When you have created a style.css file, copy and paste the code below into it:


/*
Theme Name: Framework Child theme
Author: PageLines
Author URI: http://www.pagelines.com
Description: Child theme for PageLines Framework.
Version: 1.0
Template: pl-framework
*/

In the code above the part between /* and */ is how WordPress identifies the theme. All the tags above except for Template: can be changed. The Template line is important since it declares the parent theme. In this case the PageLines Framework theme.

Functions.php (Optional)

If you wish to add custom functions or hooks to your child theme, you will need to create a functions.php file. Using your favourite code editor (we recommend either Atom or SubLime Text) create a new file called functions.php.

When the functions.php file has been created, add the code below to the file and save.


<?php
/**
 * Child theme functions
 *
 */

Then add the functions.php file to your child themes directory. Once added, you can then add your custom functions, hooks and etc... to the file. These must be after the <?php tag.

Installation

To install your child theme, you can choose to either upload the child theme directory (folder) via FTP or us the WordPress Automatic Theme installer.

FTP Method

To install your child theme using the FTP method, simply connect to your site using an FTP client and upload your child themes directory to /wp-content/themes/.

WordPress Theme Installer Method

To install your child theme using the WordPress Automatic Theme installer, you will first need to archive your child theme using a zip application.

If you're unsure how to create a .zip of your child theme directory, use the guides below for your preferred OS.

For a more in-depth guide on how to install a WordPress theme, follow the instructions on this guide.