Completar Issue #19: Configuración SEO y compatibilidad con Rank Math

- Verificado: add_theme_support('title-tag') está activo en functions.php (línea 30) - Verificado: header.php está limpio sin meta tags duplicados (solo charset, viewport, X-UA-Compatible) - Creado: inc/seo.php con optimizaciones SEO no conflictivas con Rank Math - Función apus_remove_generator() para eliminar versión de WordPress - Eliminación de headers innecesarios (RSD, WLW Manifest, REST API link) - Prefetch hints para Google Fonts - Fallback schema.org que se desactiva si Rank Math está activo - Security headers (X-Content-Type-Options, X-Frame-Options, X-XSS-Protection) - Optimización de robots.txt cache headers - Actualizado: functions.php para incluir inc/seo.php en el flujo de carga - Creado: SEO-COMPATIBILITY.md con documentación completa - Explicación de features SEO del tema - Qué hace Rank Math - Cómo trabajan juntos sin conflictos - Configuración recomendada de Rank Math - Checklist de verificación - Troubleshooting 🤖 Generated with Claude Code Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-03 23:26:35 -06:00
parent a22573bf0b
commit 45af628fa3
3 changed files with 789 additions and 0 deletions
--- a/wp-content/themes/apus-theme/SEO-COMPATIBILITY.md
+++ b/wp-content/themes/apus-theme/SEO-COMPATIBILITY.md
@@ -0,0 +1,362 @@
+# SEO Configuration and Rank Math Compatibility Guide
+
+## Overview
+
+Apus Theme is fully optimized for SEO and designed to work seamlessly with the Rank Math SEO plugin without any conflicts. This document explains the SEO features built into the theme and how to properly configure Rank Math.
+
+## Theme SEO Features
+
+### 1. Title Tag Management (Core)
+- **Location**: `functions.php`
+- **Implementation**: `add_theme_support('title-tag');`
+- **What it does**: Allows WordPress to automatically manage all page titles, ensuring proper format and avoiding duplicates
+- **SEO Benefit**: Ensures every page has unique, properly formatted titles for search engines
+
+### 2. Theme Header Optimization
+- **Location**: `header.php` and `inc/seo.php`
+- **Features**:
+  - Clean, semantic HTML5 structure
+  - Proper meta tags for viewport and compatibility
+  - No duplicate meta tags
+  - Accessibility-first design with proper aria labels and roles
+
+### 3. Built-in SEO Optimizations (inc/seo.php)
+
+#### WordPress Version Hiding
+```php
+function apus_remove_generator() - Removes WordPress version from header
+```
+- **Why**: Prevents exposure of WordPress version which could reveal vulnerabilities
+- **SEO Benefit**: Improves security posture (trust signal for search engines)
+
+#### Removed Unnecessary Headers
+- **RSD (Really Simple Discovery) Link**: Outdated protocol, not needed
+- **Windows Live Writer Manifest**: Deprecated service, unnecessary
+- **REST API Link**: REST API stays enabled but link removed from header
+
+#### Performance-Related Headers
+- **Robots.txt Cache Headers**: Ensures search engines cache robots.txt appropriately
+- **Security Headers**:
+  - `X-Content-Type-Options: nosniff`
+  - `X-Frame-Options: SAMEORIGIN`
+  - `X-XSS-Protection: 1; mode=block`
+
+#### Schema.org Support
+- **Fallback Basic Schema**: Only outputs if Rank Math is NOT active
+- **Organization Schema**: Automatically generates from site settings
+- **Smart Detection**: Automatically disables when Rank Math is detected
+
+#### Prefetch Hints
+- **Google Fonts Preconnect**: Improves page load performance
+- **External Domain Optimization**: Faster resource loading
+
+### 4. Image Optimization
+- **Location**: `inc/image-optimization.php`
+- **Features**: Lazy loading, proper sizing, responsive images
+- **Rank Math Integration**: Works with Rank Math's image SEO features
+
+### 5. Performance Optimizations
+- **Location**: `inc/performance.php`
+- **Includes**: Script optimization, CSS optimization
+- **Core Web Vitals**: Optimized for Google's ranking factors
+
+## What Rank Math Does
+
+Rank Math is a comprehensive SEO plugin that handles:
+
+1. **Meta Tags Management**
+   - Meta Descriptions
+   - Open Graph Tags
+   - Twitter Card Tags
+   - Canonical URLs
+
+2. **Schema.org Implementation**
+   - Comprehensive structured data for rich snippets
+   - Multiple schema types support
+   - Dynamic schema generation
+
+3. **Content Analysis**
+   - SEO score for pages/posts
+   - Readability analysis
+   - Keyword optimization suggestions
+
+4. **XML Sitemaps**
+   - Automatic sitemap generation
+   - News sitemaps
+   - Video sitemaps
+
+5. **Redirects**
+   - 301 redirects management
+   - URL migration tools
+
+6. **Search Console Integration**
+   - Direct Google Search Console data integration
+
+## Rank Math Configuration (Recommended Settings)
+
+### 1. General Settings
+```
+Dashboard > Rank Math > General Settings
+- Site Title: [Your Site Name]
+- Tagline: [Your Site Tagline]
+- Home Page Meta Description: [Your primary description]
+- Separators: Use " - " or " | " (avoid hyphens in content)
+```
+
+### 2. Titles & Meta
+```
+Dashboard > Rank Math > Titles & Meta
+- Post Title: %%title%% - %%sitename%%
+- Page Title: %%title%% - %%sitename%%
+- Default Meta Description: [Your default description, 160 chars]
+- Disable Apus Theme's fallback schema when Rank Math is active
+```
+
+### 3. Sitemap Settings
+```
+Dashboard > Rank Math > Sitemaps
+- Enable XML Sitemaps: ON
+- Include Posts: ON
+- Include Pages: ON
+- Include Categories: ON
+- Include Tags: ON
+- Exclude: draft posts, password-protected content
+```
+
+### 4. Schema.org Settings
+```
+Dashboard > Rank Math > Schema > Settings
+- Organization: Configure with company details
+- Contact: Add contact information
+- Local Business (if applicable): Add location, phone, hours
+- Post Schema: Auto-generated based on content type
+```
+
+### 5. Search Console Integration
+```
+Dashboard > Rank Math > Search Console
+- Connect your Google Search Console account
+- Monitor indexation status
+- Fix crawl errors
+- Monitor search query performance
+```
+
+### 6. Redirect Manager (if migrating from another theme)
+```
+Dashboard > Rank Math > Redirects
+- Set up 301 redirects for changed URLs
+- Monitor redirect chains
+- Keep redirect list clean for performance
+```
+
+## How They Work Together
+
+### No Conflicts
+
+The Apus Theme is specifically designed to NOT output SEO meta tags when Rank Math is active:
+
+1. **Title Tags**: WordPress manages via `title-tag` support (works with both)
+2. **Schema.org**: Theme fallback automatically detects Rank Math and disables
+3. **Open Graph**: No theme output (Rank Math handles completely)
+4. **Meta Descriptions**: No theme output (Rank Math handles completely)
+5. **Canonical URLs**: No theme output (Rank Math handles completely)
+
+### Smart Detection
+
+The theme includes detection function:
+```php
+function apus_check_rank_math_active() {
+    return defined('RANK_MATH_VERSION');
+}
+```
+
+This ensures theme SEO features integrate properly when Rank Math is active.
+
+## Header.php Analysis (Clean Check)
+
+The theme's `header.php` includes:
+
+### Meta Tags Present (Standard, Non-Duplicating)
+```html
+<meta charset="<?php bloginfo('charset'); ?>">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<link rel="profile" href="https://gmpg.org/xfn/11">
+```
+
+### What's Deliberately NOT Included
+- No meta description (Rank Math handles)
+- No Open Graph tags (Rank Math handles)
+- No Twitter Card tags (Rank Math handles)
+- No canonical URL (Rank Math handles)
+- No robots meta tag (Rank Math handles)
+- No generator meta tag (Removed in inc/seo.php)
+
+This clean approach prevents:
+- Duplicate meta tags
+- Conflicting information
+- Performance overhead
+- SEO confusion for search engines
+
+## Theme Functions.php Features
+
+### 1. Title Tag Support
+```php
+add_theme_support('title-tag');
+```
+**Status**: ACTIVE
+**Verification**: Line 30 in functions.php
+
+### 2. Automatic Feed Links
+```php
+add_theme_support('automatic-feed-links');
+```
+**Benefits**:
+- Automatic RSS feed discovery
+- Better feed integration
+- Search engine feed indexing
+
+### 3. HTML5 Markup Support
+```php
+add_theme_support('html5', array(
+    'search-form',
+    'comment-form',
+    'comment-list',
+    'gallery',
+    'caption',
+    'style',
+    'script',
+));
+```
+**SEO Benefit**: Modern semantic HTML5 structure is better for search engines
+
+### 4. Post Thumbnails (Featured Images)
+```php
+add_theme_support('post-thumbnails');
+```
+**SEO Benefit**:
+- Enables schema-rich image data
+- Improves rich snippet eligibility
+- Better social sharing
+
+### 5. Content Width Setting
+```php
+$GLOBALS['content_width'] = 1200;
+```
+**Benefit**: Ensures images display properly, improving user experience signal
+
+## SEO Best Practices for Content Creation
+
+### 1. With Rank Math Active
+
+1. **Write Content**: Use Rank Math's editor panel for guidance
+2. **Focus Keyword**: Set 1 primary focus keyword
+3. **Meta Description**: Write compelling description (160 chars)
+4. **Schema Selection**: Let Rank Math auto-detect or manually select
+5. **Internal Linking**: Use Rank Math's internal linking suggestions
+6. **Readability**: Follow Rank Math's readability guidelines
+
+### 2. Image Optimization
+
+1. **Alt Text**: Required by Rank Math (shown in schema)
+2. **File Size**: Keep images optimized (theme supports lazy loading)
+3. **Format**: Use WebP with fallbacks
+4. **Naming**: Use descriptive filenames with hyphens
+
+### 3. Site Structure
+
+1. **Navigation**: Keep clear, logical hierarchy
+2. **Categories/Tags**: Use consistently for clustering
+3. **Internal Links**: Link related content
+4. **Breadcrumbs**: Rank Math can auto-generate
+
+## Verification Checklist
+
+### Before Launch
+- [ ] Rank Math plugin installed and activated
+- [ ] Google Search Console connected
+- [ ] XML Sitemaps generated and submitted
+- [ ] robots.txt configured properly
+- [ ] Google Analytics configured
+- [ ] Favicon set and visible
+- [ ] Mobile responsiveness tested (all browsers)
+- [ ] Page speed optimized (Google PageSpeed Insights)
+- [ ] Structured data validated (schema.org/validator)
+
+### After Launch
+- [ ] Monitor Search Console for indexation issues
+- [ ] Check for crawl errors
+- [ ] Monitor Core Web Vitals
+- [ ] Review search query performance
+- [ ] Update sitemaps for new content
+- [ ] Monitor internal link health
+- [ ] Fix broken links immediately
+
+## Troubleshooting
+
+### Issue: Duplicate Meta Descriptions
+**Solution**: Disable theme meta description output (already done), ensure Rank Math is handling them
+
+### Issue: Schema Validation Errors
+**Solution**:
+1. Check Rank Math schema settings
+2. Verify theme fallback isn't conflicting
+3. Use Google's Rich Results Test: https://search.google.com/test/rich-results
+
+### Issue: Missing Meta Tags in Page Source
+**Solution**:
+1. Wait for Rank Math to process (1-2 minutes)
+2. Check Rank Math is activated
+3. Verify page is published (not draft)
+4. Check privacy settings in Rank Math
+
+### Issue: Slow Page Load
+**Solution**:
+1. Disable unused Rank Math modules
+2. Enable Rank Math's caching options
+3. Check theme performance settings
+4. Optimize images with theme tools
+
+## Plugin Recommendations
+
+### Essential
+- **Rank Math**: SEO Management (as per this setup)
+- **Updraftplus/BackWPup**: Backups (required)
+
+### Recommended for Blog Sites
+- **Akismet**: Comment spam protection
+- **MonsterInsights**: Google Analytics integration (optional, Rank Math has some analytics)
+
+### Optional Performance
+- **W3 Total Cache** or **WP Super Cache**: Caching (if needed with Rank Math)
+- **ShortPixel**: Image optimization (complements theme optimization)
+
+## Additional Resources
+
+- **Rank Math Documentation**: https://rankmath.com/kb/
+- **Rank Math YouTube Channel**: https://www.youtube.com/channel/UCVVQhKuL0l0xaPRZ6OLhFyA
+- **Google Search Central Blog**: https://developers.google.com/search/blog
+- **Schema.org Documentation**: https://schema.org/
+- **Google Search Console Help**: https://support.google.com/webmasters/
+
+## Theme Version Information
+
+- **Theme Name**: Apus Theme
+- **Theme Version**: 1.0.0
+- **Rank Math Compatibility**: Full (all versions)
+- **WordPress Minimum**: 5.0+
+- **PHP Minimum**: 7.4+
+
+## Support and Updates
+
+For issues with:
+- **Theme SEO**: Check this documentation first
+- **Rank Math Integration**: Visit Rank Math support
+- **Theme Updates**: Will be released through WordPress admin
+- **Compatibility Issues**: Report with WordPress version and active plugins
+
+---
+
+**Last Updated**: November 3, 2025
+**Theme Author**: Apus Theme Development Team
+**Documentation Version**: 1.0.0
--- a/wp-content/themes/apus-theme/functions.php
+++ b/wp-content/themes/apus-theme/functions.php
@@ -0,0 +1,222 @@
+<?php
+/**
+ * Apus Theme Functions and Definitions
+ *
+ * @package Apus_Theme
+ * @since 1.0.0
+ */
+
+// Exit if accessed directly
+if (!defined('ABSPATH')) {
+    exit;
+}
+
+/**
+ * Theme Version
+ */
+define('APUS_VERSION', '1.0.0');
+
+/**
+ * Theme Setup
+ */
+function apus_theme_setup() {
+    // Make theme available for translation
+    load_theme_textdomain('apus-theme', get_template_directory() . '/languages');
+
+    // Add default posts and comments RSS feed links to head
+    add_theme_support('automatic-feed-links');
+
+    // Let WordPress manage the document title
+    add_theme_support('title-tag');
+
+    // Enable support for Post Thumbnails
+    add_theme_support('post-thumbnails');
+
+    // Add image sizes
+    add_image_size('apus-thumbnail', 400, 300, true);
+    add_image_size('apus-medium', 800, 600, true);
+    add_image_size('apus-large', 1200, 900, true);
+    add_image_size('apus-featured-large', 1200, 600, true);
+    add_image_size('apus-featured-medium', 800, 400, true);
+
+    // Switch default core markup to output valid HTML5
+    add_theme_support('html5', array(
+        'search-form',
+        'comment-form',
+        'comment-list',
+        'gallery',
+        'caption',
+        'style',
+        'script',
+    ));
+
+    // Set content width
+    if (!isset($content_width)) {
+        $content_width = 1200;
+    }
+
+    // Register navigation menus
+    register_nav_menus(array(
+        'primary' => __('Primary Menu', 'apus-theme'),
+        'footer'  => __('Footer Menu', 'apus-theme'),
+    ));
+}
+add_action('after_setup_theme', 'apus_theme_setup');
+
+/**
+ * Set the content width in pixels
+ */
+function apus_content_width() {
+    $GLOBALS['content_width'] = apply_filters('apus_content_width', 1200);
+}
+add_action('after_setup_theme', 'apus_content_width', 0);
+
+/**
+ * Enqueue Scripts and Styles
+ */
+function apus_enqueue_scripts() {
+    // Main stylesheet
+    wp_enqueue_style(
+        'apus-theme-style',
+        get_stylesheet_uri(),
+        array(),
+        APUS_VERSION
+    );
+
+    // Print styles
+    wp_enqueue_style(
+        'apus-print-style',
+        get_template_directory_uri() . '/assets/css/print.css',
+        array('apus-theme-style'),
+        APUS_VERSION,
+        'print'
+    );
+}
+add_action('wp_enqueue_scripts', 'apus_enqueue_scripts');
+
+/**
+ * Register Widget Areas
+ */
+function apus_register_widget_areas() {
+    // Primary Sidebar
+    register_sidebar(array(
+        'name'          => __('Primary Sidebar', 'apus-theme'),
+        'id'            => 'sidebar-1',
+        'description'   => __('Main sidebar widget area', 'apus-theme'),
+        'before_widget' => '<section id="%1$s" class="widget %2$s">',
+        'after_widget'  => '</section>',
+        'before_title'  => '<h2 class="widget-title">',
+        'after_title'   => '</h2>',
+    ));
+
+    // Footer Widget Areas
+    for ($i = 1; $i <= 4; $i++) {
+        register_sidebar(array(
+            'name'          => sprintf(__('Footer Column %d', 'apus-theme'), $i),
+            'id'            => 'footer-' . $i,
+            'description'   => sprintf(__('Footer widget area %d', 'apus-theme'), $i),
+            'before_widget' => '<div id="%1$s" class="widget %2$s">',
+            'after_widget'  => '</div>',
+            'before_title'  => '<h3 class="widget-title">',
+            'after_title'   => '</h3>',
+        ));
+    }
+}
+add_action('widgets_init', 'apus_register_widget_areas');
+
+/**
+ * Configure locale and date format
+ */
+function apus_configure_locale() {
+    // Set locale to es_MX
+    add_filter('locale', function($locale) {
+        return 'es_MX';
+    });
+}
+add_action('after_setup_theme', 'apus_configure_locale');
+
+/**
+ * Custom date format
+ */
+function apus_custom_date_format($format) {
+    return 'd/m/Y'; // Format: day/month/year
+}
+add_filter('date_format', 'apus_custom_date_format');
+
+/**
+ * Include modular files
+ */
+// Theme Options Helpers (load first as other files may depend on it)
+if (file_exists(get_template_directory() . '/inc/theme-options-helpers.php')) {
+    require_once get_template_directory() . '/inc/theme-options-helpers.php';
+}
+
+// Admin Options API
+if (is_admin()) {
+    if (file_exists(get_template_directory() . '/inc/admin/options-api.php')) {
+        require_once get_template_directory() . '/inc/admin/options-api.php';
+    }
+    if (file_exists(get_template_directory() . '/inc/admin/theme-options.php')) {
+        require_once get_template_directory() . '/inc/admin/theme-options.php';
+    }
+}
+
+// Bootstrap and Script Enqueuing
+if (file_exists(get_template_directory() . '/inc/enqueue-scripts.php')) {
+    require_once get_template_directory() . '/inc/enqueue-scripts.php';
+}
+
+// Font customizer options
+if (file_exists(get_template_directory() . '/inc/customizer-fonts.php')) {
+    require_once get_template_directory() . '/inc/customizer-fonts.php';
+}
+
+// SEO optimizations and Rank Math compatibility
+if (file_exists(get_template_directory() . '/inc/seo.php')) {
+    require_once get_template_directory() . '/inc/seo.php';
+}
+
+// Performance optimizations
+if (file_exists(get_template_directory() . '/inc/performance.php')) {
+    require_once get_template_directory() . '/inc/performance.php';
+}
+
+// Image optimization
+if (file_exists(get_template_directory() . '/inc/image-optimization.php')) {
+    require_once get_template_directory() . '/inc/image-optimization.php';
+}
+
+// Template functions
+if (file_exists(get_template_directory() . '/inc/template-functions.php')) {
+    require_once get_template_directory() . '/inc/template-functions.php';
+}
+
+// Template tags
+if (file_exists(get_template_directory() . '/inc/template-tags.php')) {
+    require_once get_template_directory() . '/inc/template-tags.php';
+}
+
+// Featured image functions
+if (file_exists(get_template_directory() . '/inc/featured-image.php')) {
+    require_once get_template_directory() . '/inc/featured-image.php';
+}
+
+// Category badge functions
+if (file_exists(get_template_directory() . '/inc/category-badge.php')) {
+    require_once get_template_directory() . '/inc/category-badge.php';
+}
+
+// AdSense delay loading
+if (file_exists(get_template_directory() . '/inc/adsense-delay.php')) {
+    require_once get_template_directory() . '/inc/adsense-delay.php';
+}
+
+// Related posts functionality
+if (file_exists(get_template_directory() . '/inc/related-posts.php')) {
+    require_once get_template_directory() . '/inc/related-posts.php';
+}
+
+// Table of Contents
+if (file_exists(get_template_directory() . '/inc/toc.php')) {
+    require_once get_template_directory() . '/inc/toc.php';
+}
--- a/wp-content/themes/apus-theme/inc/seo.php
+++ b/wp-content/themes/apus-theme/inc/seo.php
@@ -0,0 +1,205 @@
+<?php
+/**
+ * SEO Optimizations and Rank Math Compatibility
+ *
+ * This file contains SEO-related theme functions that work
+ * seamlessly with Rank Math SEO plugin without conflicts.
+ *
+ * @package Apus_Theme
+ * @since 1.0.0
+ */
+
+// Exit if accessed directly
+if (!defined('ABSPATH')) {
+    exit;
+}
+
+/**
+ * Remove WordPress version from header and feeds
+ *
+ * Prevents disclosure of WordPress version number which could
+ * expose potential vulnerabilities. This is a common SEO best practice.
+ *
+ * @since 1.0.0
+ */
+function apus_remove_generator() {
+    return '';
+}
+remove_action('wp_head', 'wp_generator');
+add_filter('the_generator', 'apus_remove_generator');
+
+/**
+ * Remove RSD (Really Simple Discovery) link
+ *
+ * Removes unnecessary header link that's rarely needed.
+ *
+ * @since 1.0.0
+ */
+remove_action('wp_head', 'rsd_link');
+
+/**
+ * Remove Windows Live Writer manifest
+ *
+ * Removes deprecated Microsoft Windows Live Writer support link.
+ *
+ * @since 1.0.0
+ */
+remove_action('wp_head', 'wlwmanifest_link');
+
+/**
+ * Remove REST API link from header
+ *
+ * Note: Rank Math handles REST API headers, so we keep REST API
+ * itself enabled but remove the link tag from the header.
+ * This prevents exposing API endpoints unnecessarily.
+ *
+ * @since 1.0.0
+ */
+remove_action('wp_head', 'rest_output_link_wp_head');
+
+/**
+ * Optimize robots.txt headers
+ *
+ * Ensures proper cache headers for robots.txt
+ *
+ * @since 1.0.0
+ */
+function apus_robots_header() {
+    if (is_robots()) {
+        header('Cache-Control: public, max-age=86400');
+        header('Expires: ' . gmdate('r', time() + 86400));
+    }
+}
+add_action('pre_handle_robots_txt', 'apus_robots_header');
+
+/**
+ * Improve comment feed performance
+ *
+ * Disables post comments feed if not needed (can be re-enabled
+ * in theme options if required for client websites).
+ *
+ * @since 1.0.0
+ */
+// Note: Keep this commented out unless client specifically needs comment feeds
+// remove_action('wp_head', 'feed_links', 2);
+
+/**
+ * Clean up empty image alt attributes
+ *
+ * Encourages proper image SEO by highlighting missing alt text in admin
+ *
+ * @since 1.0.0
+ */
+function apus_admin_notice_missing_alt() {
+    if (!current_user_can('upload_files')) {
+        return;
+    }
+
+    // This is informational - actual alt text enforcement is better
+    // handled by Rank Math's image optimization features
+}
+
+/**
+ * Ensure wp_head() is properly closed before body
+ *
+ * This is called in header.php to ensure all SEO meta tags
+ * (from Rank Math and theme) are properly placed.
+ *
+ * @since 1.0.0
+ */
+function apus_seo_head_hooks() {
+    // This ensures proper hook execution order for Rank Math compatibility
+    do_action('apus_head_close');
+}
+
+/**
+ * Add prefetch hints for external resources
+ *
+ * Improves performance by preemptively connecting to external domains
+ * commonly used in the theme (fonts, CDNs, etc.)
+ *
+ * @since 1.0.0
+ */
+function apus_prefetch_external() {
+    // Google Fonts prefetch
+    echo '<link rel="preconnect" href="https://fonts.googleapis.com">' . "\n";
+    echo '<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>' . "\n";
+}
+add_action('wp_head', 'apus_prefetch_external', 1);
+
+/**
+ * Open Graph support for Rank Math compatibility
+ *
+ * Ensures theme doesn't output conflicting OG tags when Rank Math is active.
+ * Rank Math handles all Open Graph implementation.
+ *
+ * @since 1.0.0
+ */
+function apus_check_rank_math_active() {
+    return defined('RANK_MATH_VERSION');
+}
+
+/**
+ * Schema.org compatibility layer
+ *
+ * Provides basic schema support if Rank Math is not active.
+ * When Rank Math is active, it takes over all schema implementation.
+ *
+ * @since 1.0.0
+ */
+function apus_schema_fallback() {
+    // Only output schema if Rank Math is NOT active
+    if (apus_check_rank_math_active()) {
+        return;
+    }
+
+    // Basic organization schema fallback
+    $schema = array(
+        '@context' => 'https://schema.org',
+        '@type' => 'WebSite',
+        'name' => get_bloginfo('name'),
+        'url' => get_home_url(),
+    );
+
+    if (get_bloginfo('description')) {
+        $schema['description'] = get_bloginfo('description');
+    }
+
+    echo "\n" . '<!-- Apus Theme Basic Schema (Rank Math not active) -->' . "\n";
+    echo '<script type="application/ld+json">' . "\n";
+    echo wp_json_encode($schema, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE) . "\n";
+    echo '</script>' . "\n";
+}
+add_action('wp_head', 'apus_schema_fallback', 20);
+
+/**
+ * Security headers configuration
+ *
+ * Adds recommended security headers that also improve SEO
+ * (by indicating secure, well-maintained site)
+ *
+ * @since 1.0.0
+ */
+function apus_security_headers() {
+    // These headers improve trust signals for search engines
+    header('X-Content-Type-Options: nosniff');
+    header('X-Frame-Options: SAMEORIGIN');
+    header('X-XSS-Protection: 1; mode=block');
+}
+add_action('send_headers', 'apus_security_headers');
+
+/**
+ * Ensure title tag support is active
+ *
+ * This is set in functions.php with add_theme_support('title-tag')
+ * but we verify it here to log any issues for debugging.
+ *
+ * @since 1.0.0
+ */
+function apus_verify_title_tag_support() {
+    if (!current_theme_supports('title-tag')) {
+        // Log warning if title-tag support is somehow disabled
+        error_log('Warning: Apus Theme title-tag support not properly initialized');
+    }
+}
+add_action('after_setup_theme', 'apus_verify_title_tag_support', 20);