Wie passe ich mein Plugin an Multisite an?

Als für einreihen und darunter, die Dinge gehen, wie normal. Plugin-Pfad und die URL sind die gleichen.

Ich nie behandelt alles rund um die upload-Pfade in Multisite und ich denke, normalerweise WP kümmert sich um diese.

---

$wpdb

Es ist eine Häufig verwendete snippet zum iterieren durch alle blogs:

global $wpdb;
$blogs = $wpdb->get_results("
    SELECT blog_id
    FROM {$wpdb->blogs}
    WHERE site_id = '{$wpdb->siteid}'
    AND spam = '0'
    AND deleted = '0'
    AND archived = '0'
");
$original_blog_id = get_current_blog_id();   
foreach ( $blogs as $blog_id ) 
{
    switch_to_blog( $blog_id->blog_id );
    //do something in the blog, like:
    //update_option()
}   
switch_to_blog( $original_blog_id );

Finden Sie viele Beispiele, wo restore_current_blog() statt switch_to_blog( $original_blog_id ). Aber hier ist, warum switch ist zuverlässiger: restore_current_blog() vs switch_to_blog().

---

$blog_id

Ausführen einer Funktion oder Haken nach der blog-ID:

global $blog_id;
if( $blog_id != 3 )
    add_image_size( 'category-thumb', 300, 9999 ); //300 pixels wide (and unlimited height)

Oder vielleicht:

if( 
    'child.multisite.com' === $_SERVER['SERVER_NAME'] 
    || 
    'domain-mapped-child.com' === $_SERVER['SERVER_NAME']
    )
{
    //do_something();
}

---

Installieren - Netzwerk-Aktivierung nur

Mithilfe der plugin-header - Network: true ^{(siehe: Beispiel-Plugin)} wird nur angezeigt, das plugin in die Seite /wp-admin/network/plugins.php. Die mit diesem header in Ort, können wir die folgenden blockieren bestimmte Aktionen geschehen soll, wenn das plugin wird nur im Netzwerk.

function my_plugin_block_something()
{
    $plugin = plugin_basename( __FILE__ );
    if( !is_network_only_plugin( $plugin ) )
        wp_die(
            'Sorry, this action is meant for Network only', 
            'Network only',  
            array( 
                'response' => 500, 
                'back_link' => true 
            )
        );    
}

---

Deinstallieren

Zur (De)Aktivierung, es hängt vom jeweiligen plugin. Aber bei der Deinstallation, das ist der code, den ich verwenden, in der Datei uninstall.php:

<?php
/**
 * Uninstall plugin - Single and Multisite
 * Source: https://wordpress.stackexchange.com/q/80350/12615
 */

//Make sure that we are uninstalling
if ( !defined( 'WP_UNINSTALL_PLUGIN' ) ) 
    exit();

//Leave no trail
$option_name = 'HardCodedOptionName';

if ( !is_multisite() ) 
{
    delete_option( $option_name );
} 
else 
{
    global $wpdb;
    $blog_ids = $wpdb->get_col( "SELECT blog_id FROM $wpdb->blogs" );
    $original_blog_id = get_current_blog_id();

    foreach ( $blog_ids as $blog_id ) 
    {
        switch_to_blog( $blog_id );
        delete_option( $option_name );    
    }
    switch_to_blog( $original_blog_id );
}

---

Admin-Seiten

1) Hinzufügen eines admin-Seite

Fügen Sie ein Menü "Verwaltung" überprüfen wir, ob is_multisite() und ändern Sie die Haken entsprechend:

$hook = is_multisite() ? 'network_' : '';
add_action( "{$hook}admin_menu", 'unique_prefix_function_callback' );

2) Überprüfen Sie für Multisite-dashboard und ändern Sie die admin-URL ein:

//Check for MS dashboard
if( is_network_admin() )
    $url = network_admin_url( 'plugins.php' );
else
    $url = admin_url( 'plugins.php' );

3) Abhilfe zu zeigen, interface-Elemente nur in Haupt-Website

Ohne erstellen einer Netzwerk-Admin Menü (Aktion Haken network_admin_menu), ist es möglich zu zeigen, ein Teil der plugin nur in der Haupt-Website.

Begann ich, einige Multisite-Funktionalität in meinem größte plugin und habe die folgenden zu beschränken, einen Teil der plugin-Optionen auf der Haupt-Website. Das heißt, wenn das plugin aktiviert ist in eine sub-site, die option nicht.

$this->multisite = is_multisite() 
        ? ( is_super_admin() && is_main_site() ) //must meet this 2 conditions to be "our multisite"
        : false;

^{bei dieser Suche wieder, vielleicht es sein kann, einfach: is_multisite() && is_super_admin() && is_main_site(). Beachten Sie, dass die letzten zwei zurück true im einzelnen Websites.}

Dann:

if( $this->multisite )
    echo "Something only for the main site, i.e.: Super Admin!";

4) Sammlung von nützlichen Haken und Funktionen.

Haken: network_admin_menu, wpmu_new_blog, signup_blogform, wpmu_blogs_columns, manage_sites_custom_column, manage_blogs_custom_column, wp_dashboard_setup, network_admin_notices, site_option_active_sitewide_plugins, {$hook}admin_menu

Funktionen: is_multisite, is_super_admin is_main_site, get_blogs_of_user, update_blog_option, is_network_admin, network_admin_url, is_network_only_plugin

^{PS: ich eher den link zu WordPress Antworten, als der Codex, da gibt es sicherlich noch mehr Beispiele für funktionierenden code.}

---

Beispiel-plugin

Ich habe gerade rollte ein Multisite-plugin, Netzwerk Deaktiviert, aber Anderweitig Aktiv, und machte eine nicht arbeiten wieder kommentierte version Balg (siehe GitHub für das fertige voll funktionierende version). Das fertige plugin wird rein funktional, es gibt keine Einstellungen-Schnittstelle.

^{Beachten Sie, dass der plugin-header hat Network: true. Es verhindert, dass das plugin von zeigt an untergeordneten Standorten.}

<?php
/**
 * Plugin Name: Network Deactivated but Active Elsewhere
 * Network: true
 */ 

/**
 * Start the plugin only if in Admin side and if site is Multisite
 */
if( is_admin() && is_multisite() )
{
    add_action(
        'plugins_loaded',
        array ( B5F_Blog_Active_Plugins_Multisite::get_instance(), 'plugin_setup' )
    );
}    

/**
 * Based on Plugin Class Demo - https://gist.github.com/toscho/3804204 
 */
class B5F_Blog_Active_Plugins_Multisite
{
    protected static $instance = NULL;
    public $blogs = array();
    public $plugin_url = '';
    public $plugin_path = '';

    public static function get_instance()
    {
        NULL === self::$instance and self::$instance = new self;
        return self::$instance;
    }

    /**
     * Plugin URL and Path work as normal
     */
    public function plugin_setup()
    {
        $this->plugin_url    = plugins_url( '/', __FILE__ );
        $this->plugin_path   = plugin_dir_path( __FILE__ );
        add_action( 
            'load-plugins.php', 
            array( $this, 'load_blogs' ) 
        );
    }

    public function __construct() {}

    public function load_blogs()
    { 
        /**
         * Using "is_network" property from $current_screen global variable.
         * Run only in /wp-admin/network/plugins.php
         */
        global $current_screen;
        if( !$current_screen->is_network )
            return;

        /**
         * A couple of Multisite-only filter hooks and a regular one.
         */
        add_action( 
                'network_admin_plugin_action_links', 
                array( $this, 'list_plugins' ), 
                10, 4 
        );
        add_filter( 
                'views_plugins-network', //'views_{$current_screen->id}'
                array( $this, 'inactive_views' ), 
                10, 1 
        );
        add_action(
                'admin_print_scripts',
                array( $this, 'enqueue')
        );

        /**
         * This query is quite frequent to retrieve all blog IDs.
         */
        global $wpdb;
        $this->blogs = $wpdb->get_results(
                " SELECT blog_id, domain 
                FROM {$wpdb->blogs}
                WHERE site_id = '{$wpdb->siteid}'
                AND spam = '0'
                AND deleted = '0'
                AND archived = '0' "
        );  
    }

    /**
     * Enqueue script and style normally.
     */
    public function enqueue()
    {
        wp_enqueue_script( 
                'ndbae-js', 
                $this->plugin_url . '/ndbae.js', 
                array(), 
                false, 
                true 
        );
        wp_enqueue_style( 
                'ndbae-css', 
                $this->plugin_url . '/ndbae.css'
        );
    }

    /**
     * Check if plugin is active in any blog
     * Using Multisite function get_blog_option
     */
    private function get_network_plugins_active( $plug )
    {
        $active_in_blogs = array();
        foreach( $this->blogs as $blog )
        {
            $the_plugs = get_blog_option( $blog['blog_id'], 'active_plugins' );
            foreach( $the_plugs as $value )
            {
                if( $value == $plug )
                    $active_in_blogs[] = $blog['domain'];
            }
        }
        return $active_in_blogs;
    }
}

---

Andere Ressourcen - e-books

Nicht direkt mit plugin-Entwicklung, sondern eine Art unerlässlich, um Multisite-management.

Die e-Bücher sind geschrieben von nicht weniger als zwei Riesen Multisite: Mika Epstein (aka Ipstenu) und Andrea Rennick.

• WordPress-Multisite-101
• WordPress-Multisite-110

InformationsquelleAutor der Antwort brasofilo