Bootscore (Bootstrap 5) WordPress Multisite / Network Integration Guide

[pro-wow]

WordPress Multisite Support for Bootscore Theme

This documentation provides a comprehensive guide for implementing WordPress Multisite/Network functionality with the Bootscore (Bootstrap 5) theme, supporting all three configurations: subdirectories, subdomains, and domain mapping.

📚 Reference

• [WordPress Multisite / Network Documentation](https://developer.wordpress.org/advanced-administration/multisite/)

🏗️ Theme Structure

This setup provides a flexible, scalable foundation for running Bootscore on WordPress Multisite:

/wp-content/themes/
├── bootscore/              # Parent theme
├── bootscore-child/        # Base child theme
└── bootscore-network/      # Network-specific child theme

🔧 Core Implementation

Multisite Detection & Configuration

Add this to your functions.php:

/**
 * Detect and configure multisite setup
 */
function bootscore_multisite_init() {
    // Exit if not multisite
    if (!is_multisite()) return;
    
    // Get current blog ID
    $blog_id = get_current_blog_id();
    
    // Load site-specific styles
    add_action('wp_enqueue_scripts', function() use ($blog_id) {
        // Load network-wide styles first
        wp_enqueue_style('bootscore-network', 
            get_stylesheet_directory_uri() . '/css/network.css'
        );
        
        // Load site-specific styles if they exist
        $site_css = "/css/site-{$blog_id}.css";
        if (file_exists(get_stylesheet_directory() . $site_css)) {
            wp_enqueue_style("bootscore-site-{$blog_id}", 
                get_stylesheet_directory_uri() . $site_css
            );
        }
    });
}
add_action('after_setup_theme', 'bootscore_multisite_init');

🌐 Network Type Configurations

1. Subdirectory Setup

For sites like site.com/blog, site.com/shop:

/**
 * Handle subdirectory multisite configuration
 * Example: site.com/blog, site.com/shop
 */
function bootscore_subdirectory_config() {
    $current_blog = get_blog_details();
    $path = trim($current_blog->path, '/');
    
    // Load path-specific configuration
    switch($path) {
        case 'shop':
            // Enable WooCommerce features
            add_theme_support('woocommerce');
            require_once('inc/woocommerce-config.php');
            break;
            
        case 'blog':
            // Blog-specific settings
            add_theme_support('post-formats', ['aside', 'gallery']);
            break;
    }
}
add_action('init', 'bootscore_subdirectory_config');

2. Subdomain Setup

For sites like blog.site.com, shop.site.com:

/**
 * Handle subdomain multisite configuration
 * Example: blog.site.com, shop.site.com
 */
function bootscore_subdomain_config() {
    $current_site = get_site();
    $subdomain = explode('.', $current_site->domain)[0];
    
    // Dynamic class loading based on subdomain
    add_filter('body_class', function($classes) use ($subdomain) {
        $classes[] = 'site-' . sanitize_html_class($subdomain);
        return $classes;
    });
    
    // Load subdomain-specific modules
    $module_file = get_stylesheet_directory() . "/modules/{$subdomain}.php";
    if (file_exists($module_file)) {
        require_once($module_file);
    }
}
add_action('init', 'bootscore_subdomain_config');

3. Domain Mapping Setup

For mapped domains like brand1.com, brand2.net:

/**
 * Handle domain-mapped sites
 * Example: brand1.com, brand2.net (mapped to network sites)
 */
function bootscore_domain_mapping_config() {
    // Get current domain
    $current_domain = $_SERVER['HTTP_HOST'];
    
    // Store domain-specific settings
    $domain_config = [
        'brand1.com' => [
            'logo' => '/images/brand1-logo.png',
            'primary_color' => '#e74c3c',
            'menu_location' => 'brand1_menu'
        ],
        'brand2.net' => [
            'logo' => '/images/brand2-logo.png', 
            'primary_color' => '#3498db',
            'menu_location' => 'brand2_menu'
        ]
    ];
    
    // Apply configuration if domain exists
    if (isset($domain_config[$current_domain])) {
        $config = $domain_config[$current_domain];
        
        // Make config available globally
        set_theme_mod('site_config', $config);
        
        // Register specific menu location
        register_nav_menus([
            $config['menu_location'] => __('Primary Menu', 'bootscore')
        ]);
    }
}
add_action('after_setup_theme', 'bootscore_domain_mapping_config');

🎨 Dynamic SCSS & CSS Management

Base SCSS Structure

Create a style.scss file:

// Network-wide variables
$network-font: 'Helvetica Neue', sans-serif;
$network-radius: 4px;

// Site-specific overrides
@import 'network-variables';

// Example network-variables.scss generation
// This would be dynamically generated based on site
$primary: var(--bs-primary, #0d6efd) !default;
$secondary: var(--bs-secondary, #6c757d) !default;

Dynamic CSS Generation

/**
 * Generate site-specific CSS variables
 */
function bootscore_generate_site_css() {
    $blog_id = get_current_blog_id();
    $colors = get_blog_option($blog_id, 'site_colors', []);
    
    if (empty($colors)) return;
    
    $css = ":root {\n";
    foreach ($colors as $key => $value) {
        $css .= "  --site-{$key}: {$value};\n";
    }
    $css .= "}\n";
    
    wp_add_inline_style('bootscore-style', $css);
}
add_action('wp_enqueue_scripts', 'bootscore_generate_site_css', 20);

⚙️ Network Admin Controls

Create a network-admin.php file:

/**
 * Add network admin menu for Bootscore settings
 */
function bootscore_network_admin_menu() {
    add_submenu_page(
        'themes.php',
        'Bootscore Network Settings',
        'Network Settings',
        'manage_network_options',
        'bootscore-network',
        'bootscore_network_settings_page'
    );
}
add_action('network_admin_menu', 'bootscore_network_admin_menu');

/**
 * Network settings page
 */
function bootscore_network_settings_page() {
    // Get all sites
    $sites = get_sites();
    ?>
    <div class="wrap">
        <h1>Bootscore Network Settings</h1>
        <table class="wp-list-table widefat fixed striped">
            <thead>
                <tr>
                    <th>Site</th>
                    <th>Theme Status</th>
                    <th>Custom CSS</th>
                    <th>Actions</th>
                </tr>
            </thead>
            <tbody>
                <?php foreach ($sites as $site): ?>
                    <tr>
                        <td><?php echo esc_html($site->blogname); ?></td>
                        <td>
                            <?php 
                            switch_to_blog($site->blog_id);
                            $theme = wp_get_theme();
                            echo esc_html($theme->get('Name'));
                            restore_current_blog();
                            ?>
                        </td>
                        <td>
                            <?php
                            $has_custom = file_exists(
                                get_stylesheet_directory() . "/css/site-{$site->blog_id}.css"
                            );
                            echo $has_custom ? '✓' : '✗';
                            ?>
                        </td>
                        <td>
                            <a href="<?php echo esc_url(get_admin_url($site->blog_id)); ?>" 
                               class="button">Manage</a>
                        </td>
                    </tr>
                <?php endforeach; ?>
            </tbody>
        </table>
    </div>
    <?php
}

⚡ Performance Optimization

Create a cache-config.php file:

/**
 * Multisite-aware caching
 */
function bootscore_multisite_cache_key($key) {
    if (!is_multisite()) return $key;
    
    // Prefix cache keys with blog ID
    return get_current_blog_id() . '_' . $key;
}

/**
 * Shared network resources
 */
function bootscore_network_shared_resources() {
    // Share common assets across network
    $shared_assets = [
        'bootstrap' => get_template_directory_uri() . '/css/lib/bootstrap.min.css',
        'fontawesome' => get_template_directory_uri() . '/css/lib/fontawesome.min.css'
    ];
    
    // Enqueue from parent theme to avoid duplication
    foreach ($shared_assets as $handle => $src) {
        wp_enqueue_style("bootscore-{$handle}", $src, [], null);
    }
}
add_action('wp_enqueue_scripts', 'bootscore_network_shared_resources', 5);

✅ Implementation Checklist

Bootscore Multisite Setup Steps:

1. Install Bootscore parent theme network-wide
2. Create network child theme with this structure:

   /bootscore-network/
   ├── style.css (with Template: bootscore)
   ├── functions.php (with multisite logic)
   ├── /css/
   │   ├── network.css (shared styles)
   │   ├── site-1.css (main site)
   │   └── site-2.css (subsite)
   └── /inc/
       ├── multisite-functions.php
       └── network-admin.php
   

3. Network activate the child theme
4. Configure individual sites through Network Admin

---

📧 Feature Request for Bootscore Team

Subject: Native WordPress Multisite/Network Support Enhancement

Dear Bootscore Development Team,

I hope this message finds you well. First, I want to express my appreciation for creating such an excellent Bootstrap-based WordPress starter theme. The clean codebase, built-in SCSS compiler, and minimal approach make Bootscore a joy to work with.

🎯 Feature Request

I would like to propose adding native WordPress Multisite/Network support to Bootscore. As someone who manages multiple WordPress sites, I believe this enhancement would significantly benefit the Bootscore community.

💼 Use Case Scenarios

Multisite support would enable developers to:

• Manage multiple branded sites from a single WordPress installation
• Create site networks with shared resources (themes, plugins, users)
• Build SaaS-like platforms with subdomain/subdirectory structures
• Implement efficient domain mapping for client projects
• Reduce server resources and maintenance overhead

🛠️ Proposed Implementation

The enhancement could include:

• Network-aware child theme structure
• Site-specific CSS loading mechanism
• Shared resource optimization
• Network admin integration
• Documentation for subdomain, subdirectory, and domain mapping setups

🌟 Community Benefits

This feature would:

• Attract enterprise and agency developers to Bootscore
• Reduce development time for multi-site projects
• Provide a standardized approach for network implementations
• Strengthen Bootscore's position as a professional development framework

🤝 Offer to Contribute

I would be happy to:

• Test beta implementations
• Provide feedback and use cases
• Contribute to documentation
• Share real-world implementation examples

I believe many developers in the community would greatly appreciate and benefit from official Multisite support. Would you consider adding this to your development roadmap for upcoming releases?

Thank you for your time and for maintaining such an excellent theme framework. I look forward to hearing your thoughts on this proposal.

Best regards,
Vladislav

---

P.S. If this is already on your roadmap or if there are existing solutions I've missed, I'd be grateful for any guidance you can provide.

[pro-wow]

WP-CLI Multisite Management Guide

Essential WP-CLI commands specifically designed for WordPress Multisite networks. These commands leverage multisite-specific functionality that isn't available in single WordPress installations.

🔌 Network Plugin Operations

Network-wide Plugin Activation

# Activate a plugin across the entire network
# This makes the plugin active on all sites in the multisite network
wp plugin activate contact-form-7 --network

Install and Network Activate

# Install a plugin and immediately activate it network-wide
# Combines installation with network activation in one command
wp plugin install woocommerce --network --activate

Network Deactivation

# Deactivate a plugin from the entire network
# This will disable the plugin on all sites in the network
wp plugin deactivate jetpack --network

🎨 Network Theme Management

Enable Theme for Network

# Make a theme available for activation across the network
# Note: This doesn't activate the theme, just allows subsites to use it
wp theme enable storefront --network

Enable and Activate Network-wide

# Enable a theme for the network AND activate it on the main site
# Combines enabling for network with activation
wp theme enable twentytwentyfour --network --activate

Disable Theme Network-wide

# Remove a theme from being available across the network
# Subsites will no longer be able to activate this theme
wp theme disable storefront --network

🌐 Site Management

Create New Site in Network

# Create a new subsite in the multisite network
# --slug: URL path for subdirectory installs or subdomain name
# --title: Site title shown in admin and frontend
# --email: Administrator email for the new site
wp site create --slug=shop --title="Online Shop" --email="admin@example.com"

Delete Site from Network

# Remove a site from the multisite network
# The number (5) is the blog_id of the site to delete
# --yes flag skips confirmation prompt
wp site delete 5 --yes

List All Network Sites

# Display all sites in the multisite network
# Shows blog_id, URL, last_updated, and registered date
wp site list

🔄 Bulk Operations Across Network

Install Plugin on All Sites

# Install and activate a plugin on every site in the network
# Gets list of all site URLs, then runs plugin install on each
wp site list --field=url | xargs -I % wp plugin install contact-form-7 --url=% --activate

Update Options Network-wide

# Update a WordPress option on all sites in the network
# Example: Change tagline on all sites
wp site list --field=url | xargs -I % wp option update blogdescription "New tagline" --url=%

Run Commands on Specific Site Types

Subdirectory Site

# Target a specific subdirectory site (example.com/blog)
wp plugin list --url=example.com/blog

Subdomain Site

# Target a specific subdomain site (blog.example.com)
wp plugin list --url=blog.example.com

Domain Mapped Site

# Target a site with custom domain mapping
wp plugin list --url=customdomain.com

💡 Command Breakdown

Key Multisite Flags

• --network: Applies operation to entire network
• --url=<site-url>: Targets specific site in network
• --yes: Skips confirmation prompts (useful for automation)

Understanding xargs Usage

# This pattern is common for bulk operations:
wp site list --field=url | xargs -I % wp [command] --url=%

# Breaking it down:
# 1. wp site list --field=url    → Gets list of all site URLs
# 2. |                           → Pipes output to next command  
# 3. xargs -I %                  → Takes each URL and replaces % with it
# 4. wp [command] --url=%        → Runs command on each site

⚠️ Important Notes

1. Network Operations: Commands with --network flag require Super Admin privileges
2. Site Context: Always specify --url when targeting specific sites
3. Plugin vs Theme Enabling: Enabling a theme for network doesn't activate it, just makes it available
4. Bulk Operations: Test commands on staging before running on production networks
5. Site IDs: You can use blog IDs instead of URLs: wp site list shows the blog_id for each site

🚀 Real-world Examples

Setup New Multisite Network

# 1. Create the multisite network (run once)
# wp core download
# wp core download --locale=de_DE
# wp core download --locale=ru_RU
wp core multisite-install --title="My Network" --admin_user="admin" --admin_email="admin@example.com"

# 2. Install and network-activate essential plugins
wp plugin install contact-form-7 --network --activate
wp plugin install yoast-seo --network --activate

# 3. Enable themes for network use
wp theme enable storefront --network
wp theme enable twentytwentyfour --network

Maintenance Tasks

# Update all plugins across the network
wp plugin update --all --network

# Check for updates on all sites
wp site list --field=url | xargs -I % wp core check-update --url=%

# Flush rewrite rules on all sites
wp site list --field=url | xargs -I % wp rewrite flush --url=%

This guide focuses specifically on multisite functionality that differentiates WordPress networks from single installations, providing practical commands for network administrators.

[crftwrk]

Great, thank you! 🙏