Building a WordPress Theme From Scratch

This is a finished example of a WordPress app featuring a custom built theme where the theme is built using JS and CSS from the Bootstrap v4. Instructions provided are specific to using Mac ecosystem. I tried to provide relevant links to explanations for Windows users regarding WAMP vs MAMP, but some setup steps may differ. However, all PHP, HTML, CSS, JS code for creating the theme is platform independent and will be the same for both Mac and Windows users.

Setup Local Server and Install WordPress

Download and install a code editor (if necessary) such as Atom.
Download an app to spin up a local PHP Apache Server such as MAMP for Mac or WAMP for Windows.
Download Wordpress from wordpress.org
Open MAMP (or WAMP) App and click Start Servers. Please note: The following steps assume MAMP on Mac.
When your browser opens under MySQL heading click the phpMyAdmin link.
After logging into phpMyAdmin in the left hand navigation panel click new and under Create Database, name your database something, I called mine wp_dev_db (make sure there are no spaces in the name you choose). Then click Create. Then in the top navigation click Start. Let's leave this browser tab open and refer to the MySQL database details from here later on.
Move into the downloaded WordPress folder using Terminal $ cd ~/Downloads/wordpress or optionally you can rename the folder first if you like, I renamed mine building-a-wordpress-theme-from-scratch and moved it to my Development folder, I then ran the command $ cd ~/Development/building-a-wordpress-theme-from-scratch.
Rename wp-config-sample.php to wp-config.php with $ mv wp-config-sample.php wp-config.php.
Open the site in your code editor I'm using Atom with the command $ atom .
Open wp-config.php and set the database details to point to your local server the following are the instructions for MAMP on Mac directions for Windows may vary at this step so if your own windows instead refer to the instructions for setting up and connecting to databases on WAMP. Here are the MAMP specific code using the details from the MAMP page we left open in our browser:
```
// ** MySQL settings - You can get this info from your web host ** //
/** The name of the database for WordPress */
define('DB_NAME', 'wp_dev_db');
```

/* MySQL database username / define('DB_USER', 'root');

/* MySQL database password / define('DB_PASSWORD', 'root');

/* MySQL hostname / define('DB_HOST', 'localhost:8889');

/* Database Charset to use in creating database tables. / define('DB_CHARSET', 'utf8');

/* The Database Collate type. Don't change this if in doubt. / define('DB_COLLATE', '');

11. Then visit [https://api.wordpress.org/secret-key/1.1/salt/](https://api.wordpress.org/secret-key/1.1/salt/) and copy the generated keys and paste them into your __wp-config.php__ file under the section labeled Authentication Unique Keys and Salts.
12. Also in __wp-config.php__ set debug from false to true `define('WP_DEBUG', true);`.
13. Then back to MAMP (WAMP instructions instead see their docs or forum) App click Stop Servers. Then click Preferences.
14. Click Web Server tab and set the document root to point to the folder for your WP (WordPress) Site. On Mac in MAMP you click the folder icon with three dots on it to browse for the root folder. It is important that it is set to the folder that contains the wp-config.php file. than click OK. Then click to Start Servers again.
15. In your browser set the URL to `http://localhost` if everything was done correctly this should forward to `http://localhost/wp-admin/install.php`.
16. Select your desired install language and click Continue.
17. On the next page set a Site Title I choose `WP Theme From Scratch`. Also set a username typically this is `admin`. Then set a password you will remember. Also set an admin email. Then click Install WordPress button.
18. On the next page click Log In and use your credentials to login to your site. If all goes well you should see the admin dashboard for your site.
19. Run any updates it suggests under Dashboard > updates

## Creating A Custom Theme

1. In Terminal (or in code editor) head to the theme folder at __wp-content/themes/__ $ `cd wp-content/themes`.
2. Create a new theme folder using Terminal $ `mkdir custom_theme` or via Atom by right clicking on the themes folder and select create new folder. Note: you can name your theme folder anything you like I choose custom_theme as a generic name for this example.
3. Inside __custom_theme__ create a __css__ folder $ `mkdir custom_theme/css` and also create a _js__ folder $ `mkdir custom_theme/js`.
4. Move into your custom theme folder $ `cd custom_theme` and create three files __index.php__ and __style.css__ and __js/app.js__$ `touch index.php style.css js/app.js`. Note that we did not save style.css inside the css folder, although we will be putting Bootstrap css in our css folder later on, WordPress requires a style.css file to be located inside the root folder in order to gather theme details.
5. In __style.css__ in your code editor add the following code:
```css
/*
Theme Name: Custom Theme
Theme URI: https://github.com/jongrover/building-a-wordpress-theme-from-scratch
Author: Jonathan Grover
Author URI: https://jonathangrover.com
Description: Example Theme from Github Repo
Version: 0.0.1
License: GNU General Public License v2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Tags: bootstrap
Text Domain: jongcustomtheme

This theme, like WordPress, is licensed under the GPL.
Use it to make something cool, have fun, and share what you've learned with others.
*/

h1 {
  color: red;
}

Note: You can change any of the settings in the CSS comment at the top as you wish these will eventually appear in your admin dashboard view under Appearance>Themes as details for each theme.

In js/app.js in your code editor add the following code:
```
console.log('Hello from your theme!');
```
In index.php in your code editor put the code:
```
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta http-equiv="X-UA-Compatible" content="ie=edge">
<title><?php echo get_bloginfo('name'); ?></title>
<link rel="stylesheet" href="<?php echo get_bloginfo('template_directory'); ?>/style.css">
</head>
<body>
<h1><?php echo get_bloginfo('name'); ?></h1>
<script src="<?php echo get_bloginfo('template_directory'); ?>/js/app.js"></script>
</body>
</html>
```
Note that in our title element we put <title><?php echo get_bloginfo('name'); ?></title> this uses the get_bloginfo() function to print the name of our site that we first set when we installed WordPress. We also printed this site name in the heading inside our page body. We used this function again to link to our CSS and JS files by making use of <?php echo get_bloginfo('template_directory'); ?> which was essential for printing the correct file path to our assets. For full details of what can be done with this function take a look at the docs here.
Now head back to the admin dashboard in your browser and click Appearance>Themes
Under Custom Theme (or whatever your theme name you set was) click Activate.
Then visit localhost in your browser to see your site. It should say your site title in an h1 element and the loaded CSS should style the text color as red. Additionally if you view the JavaScript console using the Developer Tools you should see it print "Hello from your theme!".
Now that our theme is working let's delete the previous theme folders (you don't have to do this, but I won't be using the default themes any longer and they are just taking up space.) I'll get rid of twentyseventeen, twentysixteen, and twentyfifteen.

Adding Bootstrap

Start by downloading Bootstrap.
Next download jQuery a Bootstrap dependency.
Also download Popper another Bootstrap dependency.
After all downloads finish unzip them and move all CSS into your projects css folder and move all JS files into your js folder.

Now let's link to these new files for Bootstrap in our index.php file in the root of our theme folder __custom_theme/index.php. Here We'll link to the files the same way we linked to our style.css and app.js__.

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta http-equiv="X-UA-Compatible" content="ie=edge">
<title><?php echo get_bloginfo('name'); ?></title>
<link rel="stylesheet" href="<?php echo get_bloginfo('template_directory'); ?>/css/bootstrap.min.css">
<link rel="stylesheet" href="<?php echo get_bloginfo('template_directory'); ?>/style.css">
</head>
<body>
<h1><?php echo get_bloginfo('name'); ?></h1>
<script src="<?php echo get_bloginfo('template_directory'); ?>/js/jquery-3.2.1.slim.min.js"></script>
<script src="<?php echo get_bloginfo('template_directory'); ?>/js/popper.min.js"></script>
<script src="<?php echo get_bloginfo('template_directory'); ?>/js/bootstrap.min.js"></script>
<script src="<?php echo get_bloginfo('template_directory'); ?>/js/app.js"></script>
</body>
</html>

Save all files and head to localhost in your browser, open the Network tab in the Developer Tools and refresh the page. You should see Bootstrap CSS, JS, jQuery, and Popper are all correctly loading.

Dividing Page Layout

Let's start by building our layout in __custom_theme/index.php__ and later we'll break it into separate PHP files. Here is my layout code:


<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta http-equiv="X-UA-Compatible" content="ie=edge">
<title><?php echo get_bloginfo('name'); ?></title>
<link rel="stylesheet" href="<?php echo get_bloginfo('template_directory'); ?>/css/bootstrap.min.css">
<link rel="stylesheet" href="<?php echo get_bloginfo('template_directory'); ?>/style.css">
</head>
<body>

    <section class="col-md-9">
      <div class="jumbotron">
        <h1 class="display-3">Welcome</h1>
        <p class="lead">Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.</p>
        <hr class="my-4">
        <p>Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.</p>
      </div>
    </section>

    <aside class="col-md-3">
      <ul class="nav flex-column">
        <li class="nav-item">
          <a class="nav-link active" href="#">Active</a>
        </li>
        <li class="nav-item">
          <a class="nav-link" href="#">Link</a>
        </li>
        <li class="nav-item">
          <a class="nav-link" href="#">Link</a>
        </li>
        <li class="nav-item">
          <a class="nav-link disabled" href="#">Disabled</a>
        </li>
      </ul>
    </aside>

  </div><!-- .row -->
</div><!-- .container -->

``` 2. Then in __custom_theme/style.css__ add the code: ```css header { position: fixed; top: 0; width: 100%; z-index: 100; }

main { margin-top: 80px; }

.navbar-light .navbar-brand.active, .navbar-light .navbar-nav .nav-link.active, .nav .nav-link.active { color: darkblue; }

3. Save all pages and refresh in the browser and you should see an updated page layout including a navigation bar, welcome page and sidebar as well as a footer.
4. Now create the files: __custom_theme/header.php__, __custom_theme/single.php__, __custom_theme/sidebar.php__, and __custom_theme/footer.php__.
5. In __index.php__ add the function call `<?php wp_head(); ?>` just before the closing `</head>` tag.  
```php
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <meta http-equiv="X-UA-Compatible" content="ie=edge">
  <title><?php echo get_bloginfo('name'); ?></title>
  <link rel="stylesheet" href="<?php echo get_bloginfo('template_directory'); ?>/css/bootstrap.min.css">
  <link rel="stylesheet" href="<?php echo get_bloginfo('template_directory'); ?>/style.css">
  <?php wp_head(); ?>
</head>
<body>

In index.php copy everything from <!doctype> all the way down to the closing </header> and paste it into header.php.

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta http-equiv="X-UA-Compatible" content="ie=edge">
<title><?php echo get_bloginfo('name'); ?></title>
<link rel="stylesheet" href="<?php echo get_bloginfo('template_directory'); ?>/css/bootstrap.min.css">
<link rel="stylesheet" href="<?php echo get_bloginfo('template_directory'); ?>/style.css">
<?php wp_head() ?>
</head>
<body>
<header>
<nav class="navbar navbar-expand-lg navbar-light bg-light">
 <div class="container">
   <a class="navbar-brand" href="<?php echo get_bloginfo( 'wpurl' ); ?>"><?php echo get_bloginfo('name'); ?></a>
   <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarSupportedContent" aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation">
     <span class="navbar-toggler-icon"></span>
   </button>
   <div class="collapse navbar-collapse" id="navbarSupportedContent">
     <ul class="navbar-nav mr-auto">
       <li class="nav-item">
         <a class="nav-link" href="#">About</a>
       </li>
       <li class="nav-item">
         <a class="nav-link" href="#">Contact</a>
       </li>
       <li class="nav-item">
         <a class="nav-link" href="#">Blog</a>
       </li>
     </ul>
   </div>
 </div><!-- .container -->
</nav>
</header>

Notice I also added to the code above <?php echo get_bloginfo( 'wpurl' ); ?> into the href attribute for the navbar-brand link that shows our site title. This way when the user clicks our site title in the navbar it will head back to our site root (home page).

Back in index.php remove that code you copied into header.php replacing it with <?php get_header(); ?>.

In index.php add the function call <?php wp_footer(); ?> just before the closing </body> tag.

 <script src="<?php echo get_bloginfo('template_directory'); ?>/js/jquery-3.2.1.slim.min.js"></script>
 <script src="<?php echo get_bloginfo('template_directory'); ?>/js/popper.min.js"></script>
 <script src="<?php echo get_bloginfo('template_directory'); ?>/js/bootstrap.min.js"></script>
 <script src="<?php echo get_bloginfo('template_directory'); ?>/js/app.js"></script>
 <?php wp_footer(); ?>
</body>
</html>

In index.php copy everything from <footer> all the way down to the closing </html> and paste it into footer.php.


<footer>
<div class="container">
 <div class="row">
   <div class="col">
     <p class="copyright"><small>&copy; <?php echo date( 'Y' ); ?> <?php bloginfo( 'name' ); ?>, <?php bloginfo( 'description' ); ?>. All Rights Reserved.</small></p>
   </div><!-- .col -->
 </div><!-- .row -->
</div><!-- .container -->
</footer>

``` 10. Back in __index.php__ remove that code you copied into __footer.php__ replacing it with ``. 11. In __index.php__ delete all the content inside of `

` element and replace with this: ```php

``` This will check if there are posts and if there are, it will loop over them and display them in this space.

Now in single.php add the following skeleton for each blog post:
```
<?php get_header(); ?>
```

<?php get_footer(); ?>

13. In __index.php__ copy all the code from `<aside class="col-md-3">` to the closing `</aside>` and paste it into __sidebar.php__.  
```php
<aside class="col-md-3">
  <h4>Archives</h4>
  <ul class="nav flex-column">
    <?php wp_get_archives( 'type=monthly' ); ?>
  </ul>
</aside>

Here we also removed all the <li> elements and are replacing it with dynamic code <?php wp_get_archives( 'type=monthly' ); ?> as well as a few <h4> to title the Archives list.

Back in index.php remove that code you copied into sidebar.php replacing it with <?php get_sidebar(); ?>.
After refreshing the page in the browser it should still look the same but the welcome box is now showing the Hello World post that WordPress creates for us when we first install it. Our sidebar now shows the about description and Archive month list.

Custom Menu Locations

Create a functions.php file in the root directory of your theme $ touch functions.php.

Inside functions.php add the following code to register a new menu locations:

<?php
function register_my_menus() {
register_nav_menus(array(
 'header-menu' => 'Header Menu'
));
}
add_action( 'init', 'register_my_menus' );
?>

Add the first Menu Location in the header.php by replacing the dummy <li> with the function wp_nav_menu(array('theme_location' => 'header-menu')) like so:

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta http-equiv="X-UA-Compatible" content="ie=edge">
<title><?php echo get_bloginfo('name'); ?></title>
<link rel="stylesheet" href="<?php echo get_bloginfo('template_directory'); ?>/css/bootstrap.min.css">
<link rel="stylesheet" href="<?php echo get_bloginfo('template_directory'); ?>/style.css">
<?php wp_head() ?>
</head>
<body>
<header>
 <nav class="navbar navbar-expand-lg navbar-light bg-light">
   <div class="container">
     <a class="navbar-brand active" href="<?php echo get_bloginfo( 'wpurl' ); ?>"><?php echo get_bloginfo('name'); ?></a>
     <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarSupportedContent" aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation">
       <span class="navbar-toggler-icon"></span>
     </button>
     <div class="collapse navbar-collapse" id="navbarSupportedContent">
       <ul class="navbar-nav mr-auto">
         <?php if (has_nav_menu('header-menu')) {
           wp_nav_menu(array('theme_location' => 'header-menu'));
         } ?>
       </ul>
     </div>
   </div><!-- .container -->
 </nav>
</header>

Then in style.css add the following code to re-style the links:
```
.menu {
list-style: none;
padding-left: 0;
}
```

.menu-item a { display: inline-block; padding: .5rem 1rem; }

.navbar-nav .menu-item a { padding-right: 0; padding-left: 0; }

.navbar-light .navbar-nav .menu-item a { color: rgba(0,0,0,.5); }

.navbar-light .navbar-nav .menu-item a:hover { color: rgba(0,0,0,.7); text-decoration: none; }

.navbar-light .navbar-brand.active, .navbar-light .navbar-nav .menu-item a.active, .nav .menu-item a.active { color: darkblue; }

@media (min-width: 992px) { .menu-item { display: inline-block; } .navbar-expand-lg .navbar-nav .menu-item a { padding-right: .5rem; padding-left: .5rem; } }

5. Next in the browser head into the Admin dashboard and build a menu by going to Appearance>Menus and create a new menu assigning its location to Header Menu. Add your pages as desired. I created four pages: Home, About, Contact, and Blog. Save the Menu and refresh the browser page at localhost and your Header Navigation should appear.

## Creating Pages Layout

1. Next create a __custome-theme/page.php__ file in the themes root folder allowing Pages to have a different layout From blog Post pages. For instance we will have only single columns in our Pages vs 2 columns as we see now in our Posts. In __page.php__ insert this code:  
```php
<?php get_header(); ?>

  <main>
    <div class="container">

      <div class="row">
        <section class="col">
          <?php while ( have_posts() ) : the_post(); ?>

            <article>
              <h1><?php the_title(); ?></h1>
              <?php the_content(); ?>
            </article>

          <?php endwhile; ?>
        </section>
      </div><!-- .row -->
    </div><!-- .container -->
  </main>

<?php get_footer(); ?>

Now links in the Header Menu should navigate to each page when clicked.

Set Static Homepage.

Previously I created four pages: Home, About, Contact, and Blog; now we would like to set a static home page and have our blog posts show up under the blog page instead. In the browser in the Admin Dashboard view head to Settings>Reading and under Front page displays heading select the radio button for static page, and under Front page I will select Home a page I created previously. Under Posts page I will select Blog a blank page I created previously.

Create Custom Widget Areas

In functions.php add the following code:

function register_my_widgets() {
register_sidebar(array(
 'name' => 'Sidebar',
 'id' => 'sidebar-1',
 'description'   => 'Custom Sidebar Widget',
 'before_widget' => '<div class="sidebar-widget">',
 'after_widget' => '</div>',
 'before_title' => '<h4>',
 'after_title' => '</h4>',
));
}
add_action( 'widgets_init', 'register_my_widgets' );

In sidebar.php remove the code inside <aside>...</aside> and add the following code in its place:

<aside class="col-md-3">
<?php if (is_active_sidebar('sidebar-1')) {
 dynamic_sidebar('sidebar-1');
} ?>
</aside>

In style.css add the following code to style <ul> in your widgets:
```
[class="-widget"] ul {
list-style: none;
padding-left: 0;
}
```
Now in the browser head to Appearance>Widgets and drag a Widget such as Archives to the new widget area labeled Sidebar. Now in the user facing view of the side you should see the Widget location appearing at in the sidebar of the blog link.

Now let's add four additional register_sidebar functions for new footer widget areas in functions.php:

function register_my_widgets() {
register_sidebar(array(
 'name' => 'Sidebar',
 'id' => 'sidebar-1',
 'description'   => 'Custom Sidebar Widget',
 'before_widget' => '<div class="sidebar-widget">',
 'after_widget' => '</div>',
 'before_title' => '<h4>',
 'after_title' => '</h4>',
));
register_sidebar(array(
 'name' => 'Footer 1',
 'id' => 'footer-1',
 'description'   => 'Custom Footer Widget',
 'before_widget' => '<div class="footer-widget">',
 'after_widget' => '</div>',
 'before_title' => '<h4>',
 'after_title' => '</h4>',
));
register_sidebar(array(
 'name' => 'Footer 2',
 'id' => 'footer-2',
 'description'   => 'Custom Footer Widget',
 'before_widget' => '<div class="footer-widget">',
 'after_widget' => '</div>',
 'before_title' => '<h4>',
 'after_title' => '</h4>',
));
register_sidebar(array(
 'name' => 'Footer 3',
 'id' => 'footer-3',
 'description'   => 'Custom Footer Widget',
 'before_widget' => '<div class="footer-widget">',
 'after_widget' => '</div>',
 'before_title' => '<h4>',
 'after_title' => '</h4>',
));
register_sidebar(array(
 'name' => 'Footer 4',
 'id' => 'footer-4',
 'description'   => 'Custom Footer Widget',
 'before_widget' => '<div class="footer-widget">',
 'after_widget' => '</div>',
 'before_title' => '<h4>',
 'after_title' => '</h4>',
));
}

In footer.php create a new row with four columns and each has the widget placement code within:

<footer>
<div class="container">
 <div class="row">
   <div class="col-md-3">
     <?php if (is_active_sidebar('footer-1')) {
       dynamic_sidebar('footer-1');
     } ?>
   </div>
   <div class="col-md-3">
     <?php if (is_active_sidebar('footer-2')) {
       dynamic_sidebar('footer-2');
     } ?>
   </div>
   <div class="col-md-3">
     <?php if (is_active_sidebar('footer-3')) {
       dynamic_sidebar('footer-3');
     } ?>
   </div>
   <div class="col-md-3">
     <?php if (is_active_sidebar('sidebar-4')) {
       dynamic_sidebar('footer-4');
     } ?>
   </div>
 </div>
 <div class="row">
   <div class="col">
     <p class="copyright"><small>&copy; <?php echo date( 'Y' ); ?> <?php bloginfo( 'name' ); ?>, <?php bloginfo( 'description' ); ?>. All Rights Reserved.</small></p>
   </div><!-- .col -->
 </div><!-- .row -->
</div><!-- .container -->
</footer>

Add some styles for our footer in style.css:


footer {
margin-top: 40px;
border-top: 1px solid #ccc;
background: #f8f9fa;
padding-bottom: 40px;
}

footer .row { padding: 40px 0 10px; }

.copyright { text-align: left; color: #777; }

[class$="-widget"] .menu-item, [class$="-widget"] .menu-item a { display: block; padding: 0; }

[class$="-widget"] ul { list-style: none; padding-left: 0; }

8. In the browser under Appearance>Widgets your four new footer Widget areas should appear.

## Displaying Comments On Posts & Pages

1. Create a new file called __comments.php__ and add the following code:  
```php
<?php
$args = array(
  'post_id' => get_the_ID(),
  'status' => 'approve'
);
$comments_query = new WP_Comment_Query;
$comments = $comments_query->query( $args );
if ( $comments ) {
  foreach ( $comments as $comment ) {
    echo '<hr>';
    echo '<p>'.$comment->comment_content.'</p>';
  }
} else {
  echo '<p>No comments found.</p>';
}
comment_form();
?>

Then in your index.php & page.php add a place for comments to display if they are enabled:
```
<?php if (comments_open() || get_comments_number()) {
comments_template();
} ?>
```

Then add some styles for your comment form in style.css:


.comment-respond {
border: 1px solid #ccc;
background: #efefef;
padding: 20px;
}

.form-submit input[type="submit"] { display: inline-block; font-weight: 400; text-align: center; white-space: nowrap; vertical-align: middle; -webkit-user-select: none; -moz-user-select: none; -ms-user-select: none; user-select: none; border: 1px solid transparent; padding: .5rem .75rem; font-size: 1rem; line-height: 1.25; border-radius: .25rem; transition: all .15s ease-in-out; color: #fff; background-color: #007bff; border-color: #007bff; cursor: pointer; }


## Create a Theme Screenshot

1.  In a browser head to localhost and take a screenshot of one of your pages I choose my Home page. Screenshots should follow 4:3 aspect ratio and be a maximum of 1200px x 900px in size. In our case we're going to open the file in Photoshop and resize it to 880px x 660px. Then save it under the name __screenshot.png__ in the root of your custom theme folder in my case it is at __custom_theme/screenshot.png__. In the browser Admin Dashboard head to Appearance>Themes and you should see your thumbnail image appearing as well as all the details you included in your style.css file.

## Creating Custom User Theme Controls

1. In __functions.php__ include the following code which will allow us to style the text color of `<h1>` elements:  
```php
function register_my_customizations( $wp_customize ) {
  // setting
  $wp_customize->add_setting( 'header_color' , array(
    'default'   => '#000000',
    'transport' => 'refresh',
  ));
  // section
  $wp_customize->add_section( 'colors' , array(
    'title'      => __( 'Colors', 'custom_theme' ),
    'priority'   => 30,
  ));
  // control
  $wp_customize->add_control( new WP_Customize_Color_Control( $wp_customize, 'link_color', array(
    'label'      => __( 'Header Color', 'custom_theme' ),
    'section'    => 'colors',
    'settings'   => 'header_color',
   )
  ));
}
add_action( 'customize_register', 'register_my_customizations' );

function apply_my_customizations() {
  echo '<style type="text/css">'.
          'h1 { color: '.get_theme_mod('header_color','#000000').'; }'.
       '</style>';
}
add_action( 'wp_head', 'apply_my_customizations');

Now head to the browser under Appearance>Customize there should be a new section labeled Colors, and inside it you hsould be able to update the header color. For more information on Customizations see the docs on Theme_Customization_API and browse some example code. For an explantion of the __() function see this reference.

Custom Page Template Files

Create a sub folder in your theme called page-templates.
Duplicate page.php into the page-templates folder and give it a name that is not already reserved by WordPress. I called mine include-sidebar.php.
Add the following code as a PHP comment at the top of the file:
```
/*
```

Template Name: Include Sidebar

Description: Page template with sidebar included. */


The name under Template Name is what will be displayed under Page Attributes in the WordPress editor.

Then I changed the previous layout, adding in the get_sidebar() function and changing the column classes to reflect a nine column beside a three column sidebar:
```
<?php
/*
```

Template Name: Include Sidebar
Description: Page template with sidebar included. */

get_header(); ?>

   <div class="row">
     <section class="col-md-9">
       <?php while ( have_posts() ) : the_post(); ?>

         <article>
           <h1><?php the_title(); ?></h1>
           <?php the_content(); ?>
         </article>

            <?php endwhile; ?>
       <?php if (comments_open() || get_comments_number()) {
         comments_template();
       } ?>
     </section>

     <?php get_sidebar(); ?>

   </div><!-- .row -->
 </div><!-- .container -->

<?php get_footer(); ?>

 4. Now to test our template, head back to the browser and under the Admin Dashboard click Pages > All Pages. Click to edit a page and now under Page Attributes there should now be a Template menu where you can select between Default Template (page.php) or Include Sidebar (page-templates/include-sidebar.php).

## Advanced Custom Fields

Custom fields can be added both using raw code in either the functions.php file, as custom plugin code, or using a pre-created plugin such as [Advanced Custom Fields Plugin](https://www.advancedcustomfields.com). Below I demonstrate creating custom fields using a pre-made plugin. If you are interested to build this by writing your own code from scratch you can refer to the [tutorial here](http://blog.teamtreehouse.com/adding-custom-fields-to-a-custom-post-type-the-right-way) instead. I teach using the plugin so the end user can update custom fields without having to write any code.

1. Start by installing the [Advanced Custom Fields Plugin](https://www.advancedcustomfields.com) under Plugins > Add New then search for Advanced Custom Fields, find the plugin by By Elliot Condon, click Install and then Activate.
2. Next, click the new Custom Fields link from the left side Navigation in the Admin Dashboard.
3. Click Add New, and under New Field Group give it a name I called mine `Blurbs`. Then click the Add Field button.
4. Name the new field under Field Label `About Blurb`.
5. Set the field type as Text.
6. Write a description for users to understand what this field is for using the Field Instructions area. I wrote: `Set this to add about text to pages using the include sidebar page template.`
7. Under location set a rule such as Page template is equal to Include Sidebar.
8. Click Publish.
9. Now to place the field content in the file __page-templates/include-sidebar.php__ remove the sidebar code and add in the custom field to display using the `get_field('about_blurb')` function like so:  
```php
<?php
/*
 * Template Name: Include Sidebar
 * Description: Page template with sidebar included.
 */

get_header();
?>

  <main>
    <div class="container">

      <div class="row">
        <section class="col-md-9">
          <?php while ( have_posts() ) : the_post(); ?>

            <article>
              <h1><?php the_title(); ?></h1>
              <?php the_content(); ?>
            </article>

                <?php endwhile; ?>
          <?php if (comments_open() || get_comments_number()) {
            comments_template();
          } ?>
        </section>

        <aside class="col-md-3">
          <?php if(get_field('about_blurb')) {
            echo '<p>'.get_field('about_blurb').'</p>';
          } ?>
        </aside>
      </div><!-- .row -->
    </div><!-- .container -->
  </main>

<?php get_footer(); ?>

To test head to Pages > Edit a page and under Page Attributes set Template to Include Sidebar. Below should appear a text input field to type some content for our About Blurb. Whatever text and HTML content you type here will appear inside the sidebar area.

Custom Post Types

WordPress provides us with Posts and Pages but what if I want to create Products, Recipes, Portfolios, or some other custom content in my site. For this we can use Custom Post Types.

Can be created using a plugin or by coding it from scratch into the functions.php file as detailed in the tutorial here. The instructions below describe the process using the Plugin which gives the end user more control over these post types without needing to code them from scratch. This article describes the pros and cons of each method.

Under Plugins > Add New, search for Custom Post Type UI.
Find the plugin by WebDevStudios and click to Install and then Activate it.
In the newly created left hand navigation link (in Admin Dashboard) click on CPT UI > Add/Edit Post Types.
Under slug put product.
For Singular Label put Product and plural label put Products.
Under Has Archive select true so that we will be able to access a list of all products from the /product/ URL.
Under Supports check the boxes for anything you'd like to include on Product pages. In my case I checked Custom Fields so I can include a Price.
Fill out any other options you desire and then click Add Post Type button.
Refresh the page and you should now see a Products link. Click Products > Add New. Type a name for the product Baseball and in the description write A baseball, good condition!.
Click Publish button to publish this product.
To display this product let's head to Appearance > Menus and select Header Menu.
Under Custom Links, for URL put /product/ then for Link Text put Products and click Add to Menu button, and then click the Save menu button.
To test head to the browser and click the Products link from the Header Menu. Your Baseball Product should be listed there.
Got to Custom Fields > Field Group, Add New.
Name the Field Group Products and then click Add Field button.
Set the field label to Price and the field name to _price, field type to Number, required Yes, default value 0, step size 1.
Set Location to Post Type is equal to product and then click Publish button. Now our custom post type of Product has a custom Price field.
Next let's create a page layout unique to products by duplicating the index.php file and name it archive-product.php.
In the archive-product.php file remove the sidebar and column classes and change the get_template_part( 'single', get_post_format() ) to get_template_part( 'single', 'product', get_post_format() ). Following is the full code for this page:
```
<?php get_header(); ?>
```

  <div class="row">

    <section class="col">
      <?php if ( have_posts() ) : while ( have_posts() ) : the_post();
                get_template_part( 'single', 'product', get_post_format() );
            endwhile; endif;

      if (comments_open() || get_comments_number()) {
        comments_template();
      } ?>
    </section>

  </div><!-- .row -->
</div><!-- .container -->

<?php get_footer(); ?>

20. Next duplicate __single.php__ and name it __single-product.php__.
21. In __single-product.php__ change the code to the following:  
```php
<?php setup_postdata( $post ); ?>

<?php get_header(); ?>

  <main>
    <div class="container">

      <div class="row">
        <section class="col">
                    <article id="post-<?php the_ID(); ?>">
                        <h1><a href="<?php the_permalink(); ?>" rel="bookmark"><?php the_title(); ?></a></h1>
                      <p><?php the_content(); ?></p>
                        <p><?php echo "Price: $".get_field('_price').".00"; ?></p>
                    </article>
           </section>
      </div><!-- .row -->
    </div><!-- .container -->
</main>

<?php get_footer(); ?>

To test click the Products link to view all products which will now display our custom layout as well as our custom Price field.

Default Template Files

See the documentation on Template File Name List to discover default names. It is recommended to create all template files such as: 404.php, category.php, archive.php, tag.php, author.php, attachment.php, image.php, etc. then style them to your liking.

Resources

License

Contact

[email protected]

building-a-wordpress-theme-from-scratch

About building-a-wordpress-theme-from-scratch

Platforms

Languages

Links

README.md

Building a WordPress Theme From Scratch

Setup Local Server and Install WordPress

Adding Bootstrap

Dividing Page Layout

Custom Menu Locations

Set Static Homepage.

Create Custom Widget Areas

Custom Page Template Files

Custom Post Types

Default Template Files

Resources

License

Contact