README

这是一个 WordPress MU 插件的 Composer 安装器。

安装器基本上基于/兼容于一个多框架 Composer 库安装器，但它也支持安装您的 MU 插件的加载器脚本。

默认情况下，加载器脚本被安装到 mu-plugins 目录，这样您就可以将您的 MU 插件（包括子目录）作为 Composer 包提供。

示例

一个包

• your-package-root

  • mu-plugins/（加载器目录：默认为 mu-plugins）

    • your-plugin.php（加载器脚本：默认与包名相同）

  • foo/

    • bar.php

  • baz.php

将被安装为

• wp-content/mu-plugins/

  • your-plugin.php（加载器脚本）

  • your-plugin/（默认与包名相同）

    • mu-plugins/（原始加载器目录保持不变）

      • your-plugin.php（原始加载器脚本保持不变）

    • foo/

      • bar.php

    • baz.php

示例 composer.json 文件（适用于 MU 插件包）

composer.json 几乎与一个多框架 Composer 库安装器相同。

包类型和依赖项（type 和 require）

{
    "name": "you/your-plugin-name",
    "type": "devaloka-muplugin",
    "require": {
        "devaloka/mu-plugin-installer": "~0.2.0"
    }
}

自定义加载器文件（installer-loader）

installer-loader 键可用于您的自定义加载器文件，它是从包根的相对路径。

{
    "extra": {
        "installer-loader": "loader/your-loader.php"
    }
}

您可以查看一个真实的 composer.json 示例。

示例 composer.json 文件（适用于根包）

根包意味着您的项目的 composer.json。

自定义加载器路径（installer-loader-paths）

installer-loader-paths 键可用于您的自定义加载器安装路径。

这几乎与一个多框架 Composer 库安装器的 installer-paths 相同，但它是针对加载器文件的。

{
    "extra": {
        "installer-loader-paths": {
            "your-custom-path/{$name}/": ["vendor/package"]
        }
    }
}

带有 type: 前缀

{
    "extra": {
        "installer-loader-paths": {
            "your-custom-path/{$name}/": ["type:devaloka-muplugin"]
        }
    }
}

{$vendor}、{$name} 和 {$type} 变量可用。

此外，{$loader} 变量可用，它是加载器文件的相对路径。