Classic PHP WordPress starter theme. No page builder. No build tools. Pure CSS + vanilla JS.
- WordPress 6.5+
- PHP 8.0+
- ACF 6.0+ (optional — theme works without it)
- CPT UI 1.x (optional)
- Copy the folder into
wp-content/themes/ - Rename the folder to your project name (e.g.
client-name) - 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_)
- Update the header block in
style.css - Activate in WP Admin → Appearance → Themes
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
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 |
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.
All design tokens are in Section 01 of style.css. Start there when customising colours, fonts, and spacing. No build step needed — edit directly.
- PHP functions:
wcs_prefix - CSS: BEM-inspired (
.block,.block__element,.block--modifier) - Text domain:
wp-classic-starter