Skip to content

About

A simple and clean starter Wordpress theme

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

wp-classic-starter

Classic PHP WordPress starter theme. No page builder. No build tools. Pure CSS + vanilla JS.

Requirements

  • WordPress 6.5+
  • PHP 8.0+
  • ACF 6.0+ (optional — theme works without it)
  • CPT UI 1.x (optional)

Quick start

  1. Copy the folder into wp-content/themes/
  2. Rename the folder to your project name (e.g. client-name)
  3. Find & replace throughout all PHP/CSS/JS files:
    • wp-classic-starter → your project slug (e.g. client-name)
    • wcs_ → your function prefix (e.g. cn_)
  4. Update the header block in style.css
  5. Activate in WP Admin → Appearance → Themes

File structure

wp-classic-starter/
├── style.css                  # Theme header + all styles (15 sections)
├── functions.php              # Loader only — requires inc/ files
├── index.php                  # Fallback template
├── front-page.php             # Static homepage
├── home.php                   # Blog index
├── single.php                 # Single post
├── page.php                   # Static page
├── singular.php               # CPT fallback (prevents index.php showing)
├── archive.php                # Archive (categories, tags, dates, CPTs)
├── search.php                 # Search results
├── 404.php                    # Not found
├── header.php / footer.php    # Structural wrappers
├── sidebar.php                # Primary sidebar
├── comments.php               # Comments template
├── template-parts/
│   ├── content/               # Loop cards and single body parts
│   └── global/                # Header and footer parts
├── inc/
│   ├── setup.php              # Theme supports, menus, image sizes
│   ├── enqueue.php            # Styles and scripts
│   ├── widgets.php            # Sidebar registration
│   ├── template-tags.php      # Display helpers (wcs_posted_on, etc.)
│   └── acf-helpers.php        # ACF wrappers (all guarded with function_exists)
├── assets/js/
│   └── navigation.js          # Mobile menu, dropdowns, sticky header
└── languages/
    └── wp-classic-starter.pot

CPT templates

For each CPT registered via CPT UI, copy the relevant file and rename it:

Template Rename to
archive.php archive-{post_type}.php
singular.php single-{post_type}.php

ACF integration

All helpers are in inc/acf-helpers.php and guarded with function_exists( 'get_field' ) — the theme works normally when ACF is not active.

Function Purpose
wcs_get_field( $name ) Get field value (null-safe)
wcs_the_field( $name ) Echo escaped field value
wcs_get_image_field( $name, $size ) Return <img> from ACF image field
wcs_get_option( $name ) Get ACF options page field

An ACF options page is registered automatically when ACF Pro is active.

CSS custom properties

All design tokens are in Section 01 of style.css. Start there when customising colours, fonts, and spacing. No build step needed — edit directly.

Naming conventions

  • PHP functions: wcs_ prefix
  • CSS: BEM-inspired (.block, .block__element, .block--modifier)
  • Text domain: wp-classic-starter

About

A simple and clean starter Wordpress theme

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages