Project: Extrachill

WordPress theme for the Extra Chill network. Provides extension points for any music-related WordPress project.

Quick Reference Guide

Essential functions, hooks, and patterns for ExtraChill theme development. Template Functions View Counting // Display view count (provided by extrachill-analytics) if ( function_exists( 'ec_the_post_views' ) ) { ec_the_post_views(); // Outputs:...

Search System

Multisite search functionality with cross-site result integration. Search Architecture Theme search template: inc/archives/archive.php (search routes here by default via extrachill_template_search) Search header: inc/archives/archive-header.php (the same template used for archives; includes...

Template Components

Reusable template components for consistent display across the theme. Pagination Component Location: /inc/core/templates/pagination.php Function: extrachill_pagination( $query, $context ) Parameters $query (WP_Query|null) - Custom query or global $wp_query $context (string) -...

Template Routing System

The ExtraChill theme uses WordPress's native template_include filter for template routing, providing plugin override capability for complete customization. Core Router Function Location: inc/core/template-router.php The extrachill_route_templates() function routes all page types...

Theme Constants and Functions

Core constants, configuration, and utility functions. Theme Constants Location: functions.php EXTRACHILL_PARENT_DIR Theme root directory path. define('EXTRACHILL_PARENT_DIR', get_template_directory()); Value: /path/to/wp-content/themes/extrachill Usage: require_once( EXTRACHILL_PARENT_DIR . '/file.php' ); EXTRACHILL_INCLUDES_DIR Inc directory path for...

View Counting System

Archive-facing view count storage and sorting using WordPress post meta (ec_post_views). Current Implementation The theme relies on the ec_post_views post meta key for archive sorting (see inc/archives/archive-custom-sorting.php). The ec_post_views value...

Custom Embeds

Enhanced oEmbed support for music platforms. Bandcamp Embeds Location: /inc/core/editor/bandcamp-embeds.php Automatic embed support for Bandcamp albums and tracks. Supported URLs Albums: https://{artist}.bandcamp.com/album/{album-slug} Tracks: https://{artist}.bandcamp.com/track/{track-slug} How It Works User pastes Bandcamp...

Custom Taxonomies

The theme registers four music-focused custom taxonomies with REST API support for block editor integration. Taxonomy Overview Taxonomy Hierarchical Slug REST API Applies To Location Yes /location/ Yes post Festival...

Data Contracts

Single Source of Truth All data has a single source of truth located in PHP files on the server side. User Data Stored in WordPress user meta and tables Network-wide...

Filter Hooks Reference

Theme filters for customizing functionality, layout, and embeds while keeping the centralized template router and shared components intact. Template Routing Filters All routing filters receive the default template path (often...

← Back to Chubes.net