Theme from scratch setup in Wordpress

Introduction

Creating a WordPress theme from scratch lets you build a unique website look and feel. It gives full control over design and features without relying on pre-made themes.

You want a completely custom website design that matches your brand.

You need a lightweight theme without extra features you don't use.

You want to learn how WordPress themes work by building one yourself.

You want to add special features or layouts not available in existing themes.

Syntax

Wordpress

/*
Theme Name: My Custom Theme
Author: Your Name
Description: A simple theme built from scratch.
Version: 1.0
*/

// index.php
<?php get_header(); ?>
<main>
  <h1>Welcome to My Custom Theme</h1>
  <?php if (have_posts()) : while (have_posts()) : the_post(); ?>
    <article>
      <h2><?php the_title(); ?></h2>
      <div><?php the_content(); ?></div>
    </article>
  <?php endwhile; endif; ?>
</main>
<?php get_footer(); ?>

The comment block at the top of style.css defines your theme details.

index.php is the main template file that loads content.

Examples

This is the minimal style.css file with theme name and basic styles.

Wordpress

/*
Theme Name: Simple Theme
*/

/* style.css */
body {
  font-family: Arial, sans-serif;
  background-color: #f0f0f0;
}

functions.php adds theme support for dynamic page titles.

Wordpress

<?php
// functions.php
function simple_theme_setup() {
  add_theme_support('title-tag');
}
add_action('after_setup_theme', 'simple_theme_setup');
?>

header.php starts the HTML document and includes WordPress head functions.

Wordpress

<?php
// header.php
?><!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <?php wp_head(); ?>
</head>
<body>
<header><h1>My Site Header</h1></header>

Sample Program

This is a complete minimal WordPress theme with style.css, index.php, header.php, and footer.php files. It shows posts and basic navigation.

Wordpress

/*
Theme Name: Scratch Theme
Author: Your Name
Description: A theme built from scratch.
Version: 1.0
*/

/* style.css */
body {
  font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
  background-color: #ffffff;
  color: #333333;
  margin: 0;
  padding: 0;
}

/* index.php */
<?php get_header(); ?>
<main>
  <h1>Welcome to Scratch Theme</h1>
  <?php if (have_posts()) : while (have_posts()) : the_post(); ?>
    <article>
      <h2><?php the_title(); ?></h2>
      <div><?php the_content(); ?></div>
    </article>
  <?php endwhile; else: ?>
    <p>No posts found.</p>
  <?php endif; ?>
</main>
<?php get_footer(); ?>

/* header.php */
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title><?php wp_title('|', true, 'right'); ?></title>
  <?php wp_head(); ?>
</head>
<body>
<header>
  <nav>
    <ul>
      <li><a href="<?php echo home_url(); ?>">Home</a></li>
    </ul>
  </nav>
</header>

/* footer.php */
<footer>
  <p>&copy; <?php echo date('Y'); ?> Scratch Theme</p>
</footer>
<?php wp_footer(); ?>
</body>
</html>

Important Notes

Always include wp_head() in header.php and wp_footer() in footer.php for plugins and scripts to work.

Use semantic HTML tags like <main>, <header>, and <footer> for better accessibility.

Test your theme by activating it in WordPress and checking different pages.

Summary

Building a theme from scratch gives full control over your site's look.

Start with style.css and index.php files, then add header.php and footer.php.

Use WordPress functions like get_header() and have_posts() to load content dynamically.

Practice

1. What is the minimum required file to create a basic WordPress theme from scratch?

easy

A. style.css

B. functions.php

C. header.php

D. footer.php

Solution

1. Step 1: Understand WordPress theme basics

   A WordPress theme must have a style.css file to be recognized by WordPress.

2. Step 2: Identify the minimum files

   While index.php is also needed for templates, style.css is the absolute minimum to register the theme.

3. Final Answer:

   style.css -> Option A

4. Quick Check:

   Minimum theme file = style.css [OK]

Hint: Remember: style.css registers the theme in WordPress [OK]

Common Mistakes:

• Thinking functions.php is mandatory for a basic theme
• Confusing header.php as required initially
• Assuming footer.php is needed to start

2. Which of the following is the correct way to include the header template in a WordPress theme file?

easy

A. include('header.php');

B. load_header();

C. require('header.php');

D. get_header();

Solution

1. Step 1: Recall WordPress template functions

   WordPress provides get_header() to load the header.php template properly.

2. Step 2: Compare with PHP includes

   Using include or require bypasses WordPress hooks and is not recommended.

3. Final Answer:

   get_header(); -> Option D

4. Quick Check:

   Use get_header() to load header template [OK]

Hint: Use get_header() for proper WordPress header loading [OK]

Common Mistakes:

• Using PHP include instead of get_header()
• Trying to call a non-existent load_header() function
• Using require which skips WordPress hooks

3. Given this code snippet in index.php of a WordPress theme:

<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
  <h2><?php the_title(); ?></h2>
<?php endwhile; else : ?>
  <p>No posts found.</p>
<?php endif; ?>

What will be displayed if there are no posts?

medium

A. Nothing will be displayed

B. An error message

C. No posts found.

D. The titles of all posts

Solution

1. Step 1: Understand the have_posts() check

   The code checks if posts exist with have_posts(). If none, it runs the else block.

2. Step 2: Identify the else block output

   The else block outputs <p>No posts found.</p> when no posts exist.

3. Final Answer:

   No posts found. -> Option C

4. Quick Check:

   No posts triggers else output [OK]

Hint: If no posts, the else block runs showing 'No posts found.' [OK]

Common Mistakes:

• Assuming no output if no posts
• Expecting an error message instead
• Thinking titles show even if no posts

4. You created a new theme but WordPress shows a blank page. Which of the following is the most likely cause?

medium

A. Missing style.css file with theme header comment

B. Using get_footer() instead of footer.php

C. Calling get_header() twice in index.php

D. Not adding functions.php file

Solution

1. Step 1: Check theme registration requirements

   WordPress requires style.css with a proper header comment to recognize the theme.

2. Step 2: Understand blank page cause

   If style.css is missing or header comment is absent, WordPress won't load the theme, showing a blank page.

3. Final Answer:

   Missing style.css file with theme header comment -> Option A

4. Quick Check:

   Missing style.css causes blank theme page [OK]

Hint: Always include style.css with header comment to register theme [OK]

Common Mistakes:

• Thinking get_footer() usage causes blank page
• Assuming duplicate get_header() breaks theme
• Believing functions.php is mandatory for theme to load

5. You want to create a WordPress theme from scratch that shows a custom message only on the homepage and lists post titles on other pages. Which code snippet correctly implements this in index.php?

hard

A. <?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
<h2><?php the_title(); ?></h2>
<?php endwhile; else : ?>
<p>Welcome to my custom homepage!</p>
<?php endif; ?>

B. <?php if ( is_front_page() ) : ?>
<p>Welcome to my custom homepage!</p>
<?php else : if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
<h2><?php the_title(); ?></h2>
<?php endwhile; endif; endif; ?>

C. <?php if ( is_home() ) : ?>
<p>Welcome to my custom homepage!</p>
<?php else : ?>
<h2>No posts to show</h2>
<?php endif; ?>

D. <?php if ( is_front_page() ) : ?>
<p>Welcome to my custom homepage!</p>
<?php endif; ?>
<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
<h2><?php the_title(); ?></h2>
<?php endwhile; endif; ?>

Solution

1. Step 1: Use conditional tags correctly

   is_front_page() checks if the current page is the homepage to show the custom message.

2. Step 2: Show posts only on other pages

   Else block runs the loop to list post titles on non-homepage pages.

3. Step 3: Verify code structure

   <?php if ( is_front_page() ) : ?> <p>Welcome to my custom homepage!</p> <?php else : if ( have_posts() ) : while ( have_posts() ) : the_post(); ?> <h2><?php the_title(); ?></h2> <?php endwhile; endif; endif; ?> nests the else with have_posts() loop correctly, showing message only on homepage.

4. Final Answer:

   The nested if-else code snippet -> Option B

5. Quick Check:

   Conditional homepage message + posts elsewhere = <?php if ( is_front_page() ) : ?> <p>Welcome to my custom homepage!</p> <?php else : if ( have_posts() ) : while ( have_posts() ) : the_post(); ?> <h2><?php the_title(); ?></h2> <?php endwhile; endif; endif; ?> [OK]

Hint: Use is_front_page() for homepage, else loop for posts [OK]

Common Mistakes:

• Putting posts loop inside homepage condition
• Showing message only when no posts exist
• Not separating homepage and other pages logic