Action Hooks Reference

The theme provides action hooks for plugin integration and customization throughout templates.

extrachill_header_top_right

Populates the top-right header area.

Location: header.php (do_action( 'extrachill_header_top_right' )) Default Handler: inc/header/header-search.php Outputs: Search icon + search overlay panel.

Universal navigation hook before footer.

Context: Fires before footer on all pages throughout the site Usage: Display universal navigation elements (e.g., back-to-home button with smart logic) Example Integration: Theme displays context-aware back-to-home button (hidden on main homepage, links to main site on subsite homepages, links to current site homepage on all other pages)

php
// Example usage
add_action( 'extrachill_above_footer', function() {
    echo '<div class="custom-nav-section">';
    echo '<a href="' . home_url() . '" class="button-1">Back to Home</a>';
    echo '</div>';
}, 20 );

Online users stats display.

Default Handler: extrachill_display_online_users_stats() Default Template: /inc/footer/online-users-stats.php Priority: 10

Requirements: Requires ec_get_online_users_count() from extrachill-users plugin and switches to Blog ID 2 for total member counts

extrachill_footer_main_content

Main footer menu with hierarchical structure.

Default Handler: extrachill_default_footer_main_content() Default Template: /inc/footer/footer-main-menu.php Priority: 10

Renders content below the footer menus.

Default Handler: Inline handler in /inc/footer/footer-main-menu.php Default Output: Renders do_action( 'extrachill_render_newsletter_form', 'navigation' ) in a centered wrapper

Legal/policy links below copyright.

Default Handler: extrachill_default_below_copyright() Default Template: /inc/footer/footer-bottom-menu.php Priority: 10

Homepage Hooks

extrachill_homepage_content

Primary homepage content container.

Default Handler: None (plugins provide content) Default Template: /inc/home/templates/front-page.php Priority: 10

Usage: Single hook for hero/grid/body layout. Plugins render full homepage sections here.

php
add_action( 'extrachill_homepage_content', function() {
    include MY_PLUGIN_DIR . '/templates/homepage-section.php';
} );

extrachill_after_homepage_content

Footer/action slot rendered immediately after homepage content.

Default Handler: None (plugins provide CTA/footer blocks) Default Template: /inc/home/templates/front-page.php Priority: 20

Usage: Ideal for global CTAs, signup widgets, or analytics beacons that belong after all primary content.

php
add_action( 'extrachill_after_homepage_content', 'my_plugin_homepage_cta', 20 );

extrachill_notices

Centralized notice system for user feedback across the platform.

Default Handler: extrachill_display_notices() Default Template: /inc/core/notices.php Priority: 10

Usage: Display multiple notices with cookie-based dismissal and action buttons.

php
add_action( 'extrachill_notices', function() {
    extrachill_add_notice( 'success', 'Operation completed successfully!' );
} );

Single Post Hooks

extrachill_above_post_title

Content above post title (taxonomy badges).

Default Handler: extrachill_hook_taxonomy_badges_above_title() Function: Calls extrachill_display_taxonomy_badges()

extrachill_comments_section

Comments display.

Default Handler: extrachill_hook_comments_section() Default Template: /inc/single/comments.php

Archive Hooks

extrachill_archive_header

Archive page header.

Default Handler: extrachill_default_archive_header() Default Template: /inc/archives/archive-header.php Priority: 10

extrachill_after_author_bio

Hook after author bio on author archive pages.

Context: Only fires on author archives (inside is_author() conditional) on first page (not paged) Parameters: $author_id (int) – The queried author’s user ID Usage: Plugins add content after author bio (e.g., community profile links, social links, custom CTAs) Example Integration: extrachill-users plugin displays "View Community Profile" button

php
// Example usage
add_action( 'extrachill_after_author_bio', function( $author_id ) {
    echo '<div class="author-custom-content">';
    echo '<a href="/community/profile/' . $author_id . '">View Community Profile</a>';
    echo '</div>';
}, 10, 1 );

extrachill_archive_above_posts

Filter bar above archive posts.

Used By: extrachill_filter_bar() (hooked by theme)

extrachill_filter_bar_start

Runs at the start of the filter bar form.

Used By: Theme and plugins to inject hidden inputs or extra controls.

extrachill_filter_bar_end

Runs at the end of the filter bar form.

Used By: Theme and plugins to append additional controls.

extrachill_search_header

Search results header.

Default Handler: extrachill_default_search_header() Default Template: /inc/archives/archive-header.php Priority: 10 (plugins can append additional controls at >10)

Social media icon display.

Default Handler: extrachill_social_links() Location: /inc/core/templates/social-links.php Priority: 10

Displays: Facebook, Twitter/X, Instagram, YouTube, Pinterest, GitHub

Share Button Hook

extrachill_share_button

Share button component with clipboard copy and social sharing.

Default Handler: extrachill_share_button() Location: /inc/core/templates/share.php Priority: 10

Features: Facebook, Twitter/X, Email, Copy Link with clipboard API fallback

Priority Guidelines

  • 5: Load before defaults
  • 10: Default handlers
  • 15: After defaults
  • 20: Late modifications