Digital Agency WordPress Theme
A high-performance, SEO-ready WordPress theme for digital agency and professional services sites — built with semantic HTML5, custom PHP routing, conditional asset loading, and full ARIA accessibility.
The Problem
Most WordPress themes load all assets globally, lack clean URL-to-template routing, and ignore ARIA accessibility standards — resulting in poor performance, hard-to-maintain codebases, and inaccessible experiences for assistive technology users. There was a need for a theme architecture that keeps assets minimal, routing transparent, and markup semantically correct.
The Solution
A custom WordPress theme was engineered from the ground up with three core pillars: a slug-based PHP router (page-da.php) that maps URL slugs to dedicated content files, a conditional asset pipeline (inc/enqueue.php) that loads CSS and JS only for the pages that need them, and a fully semantic HTML5 shell (header.php / footer.php) with complete ARIA roles, skip links, and Schema.org markup — delivering a fast, accessible, and maintainable platform for digital agency workflows.
Custom PHP Router
page-da.php reads the current page slug and maps it to a dedicated PHP file in page-contents/. This keeps URLs clean while allowing descriptive filenames, and outputs a clear error for any unmapped slug.
Conditional Asset Pipeline
inc/enqueue.php uses filemtime() for automatic cache-busting and loads page-specific CSS/JS only when the matching slug is active — eliminating render-blocking resources on unrelated pages.
Accessible Semantic Shell
header.php and footer.php provide a consistent ARIA-compliant layout: skip link, role="banner", role="contentinfo", aria-haspopup dropdowns, aria-expanded mobile burger, and Schema.org Organization markup.
Architecture & Features
Modular WordPress theme with a slug-driven PHP content router, a conditional enqueue pipeline, and a semantic HTML5 / ARIA shell — all managed through a clean separation of routing, presentation, and asset concerns.
- Router: page-da.php — slug → page-contents/{file}.php mapping
- Asset Manager: inc/enqueue.php — global + per-page CSS/JS with filemtime() versioning
- Shortcodes: inc/shortcodes.php — [da_display_content] for reusing page-contents/ in the block editor
- Shell: header.php — DOCTYPE, skip link, ARIA nav, Schema.org Organization wrapper
- Shell: footer.php — ARIA footer sections, footer nav groups, wp_footer() hook
- Core: functions.php — title-tag support, include loader for inc/ files
Technologies Used
Project Gallery
Future Improvements
- Add a WP-CLI command to scaffold new slug → content file mappings automatically.
- Introduce a Gutenberg block for inline page-contents/ previews inside the editor.
- Implement critical CSS inlining for above-the-fold sections.
- Add dark mode support via CSS custom properties and a user-preference toggle.
- Extend Schema.org markup to Service and FAQPage types for richer search results.
- Write PHPUnit tests for the router and enqueue helpers.