README

一个用于在WordPress插件中自动安装MU插件的类。

描述

这个类接收一个文件，并将其安装到/mu-plugins/文件夹中。如果文件已存在，它将比较文件的版本

安装

这不是一个独立的WordPress插件，所以通常的说明不适用。相反，您可以手动安装或使用composer。

手动安装类

将MuPluginManager/src文件夹复制到您的插件中用于基本使用。确保相应地要求各种文件。

或者

通过Composer安装类

1. 告诉Composer将此类作为依赖项安装：composer require wpsmith/mupluginmanager
2. 建议：安装Mozart包：composer require coenjacobs/mozart --dev 并 配置它。
3. 然后，将类重命名为使用您自己的前缀以防止与其他插件捆绑此类的冲突。

实现与使用

考虑以下基本插件结构，其中mu-plugin在其自己的文件夹中以进行命名空间

|-- example.php
|-- includes
    |-- mu-plugin
        |-- example-mu.php

因此，您可以这样实现它

use WPS\WP\MuPlugins\MuPluginManager;

/**
 * Gets the MU plugin manager.
 */
function get_muplugin_manager() {
    // Path to the actual MU plugin located within this plugin.
    $src = plugin_dir_path( __FILE__ ) . 'includes/mu-plugin/my-mu-plugin.php';
    $dest_filename = 'my-mu-plugin.php';
    
    new MuPluginManager( $src, $dest_filename, '0.0.1', 'my-mu-plugin-settings' );
}

// Register (de)activation hooks.
register_activation_hook( __FILE__, function() {
    MuPluginManager::on_activation( get_muplugin_manager() );
} );
register_deactivation_hook( __FILE__, function() {
    try {
        MuPluginManager::on_deactivation( get_muplugin_manager() );
    } catch ( \Exception $e ) {
        MuPluginManager::write_log( 'MU Plugin threw an error' );
        MuPluginManager::write_log( $e->getMessage() );
    }
} );

现在，出于某种原因，您想在激活或停用之外的地方检查MU插件，则该类可以在插件管理页面自动运行。

use WPS\WP\MuPlugins\MuPluginManager;

/**
 * Gets the MU plugin manager.
 *
 * @return MuPluginManager MU plugin manager.
 */
function get_muplugin_manager() {
    static $mgr;
    
    if ( null !== $mgr ) {
        return $mgr;
    }

    // Path to the actual MU plugin located within this plugin.
    $src = plugin_dir_path( __FILE__ ) . 'mu-plugin/example-mu.php';
    $dest_filename = 'my-mu-plugin.php';
    
    $mgr = new MuPluginManager( $src, $dest_filename, '0.0.1', 'my-mu-plugin-settings' );
    
    return $mgr;
}

add_action( 'plugin_loaded', array( get_muplugin_manager(), 'add_hooks' ) );

变更日志

查看变更日志。

许可

GPL 2.0或更高版本.

贡献

欢迎贡献 - 在master分支上分叉、修复并发送拉取请求。

致谢

由Travis Smith构建
版权所有 2013-2020 Travis Smith