Bundle

WordPress plugin to enable plugin activation using a JSON, YAML or PHP file., _(*1)

Installation

Composer:

Recommended method/s;, _(*2)

Roots Bedrock and WP-CLI, _(*3)

$ composer require soberwp/bundle
$ wp plugin activate bundle

Roots Sage, _(*4)

$ composer require soberwp/bundle:1.0.2-p

Manual:

Download the zip file
Unzip to your sites plugin folder
Activate via WordPress

Requirements:

PHP >= 5.6.x

Setup

By default either bundle.json, bundle.yaml or bundle.php is used., _(*5)

You can use a custom file for each using the filters below within your themes functions.php file;, _(*6)

add_filter('sober/bundle/file', function () {
    return get_stylesheet_directory() . '/plugin-dependencies.yaml';
});

Usage

Themes often require plugins in order to work — bundle leverages the popular tgmpa class to achieve plugin activation nags and actions., _(*7)

Examples:

bundle.json, _(*8)

[
  {
    "name": "Disable Comments",
    "slug": "disable-comments",
    "required": false,
    "force_activation": true
  },
  {
    "name": "Models",
    "slug": "models",
    "source": "https://github.com/soberwp/models/archive/master.zip",
    "external_url": "https://github.com/models/intervention",
    "required": true,
    "force_activation": true,
    "force_deactivation": false
  }
]

bundle.yaml, _(*9)

---
- name: Disable Comments
  slug: disable-comments
  required: false
  force_activation: true
- name: Models
  slug: models
  source: https://github.com/soberwp/models/archive/master.zip
  external_url: https://github.com/models/intervention
  required: true
  force_activation: true
  force_deactivation: false

bundle.php, _(*10)

<?php
return [
    [
        'name' => 'Disable Comments',
        'slug' => 'disable-comments',
        'required' => false,
        'force_activation' => true
    ],
    [
        'name' => 'Models',
        'slug' => 'models',
        'source' => 'https://github.com/soberwp/models/archive/master.zip',
        'external_url' => 'https://github.com/models/intervention',
        'required' => true,
        'force_activation' => true,
        'force_deactivation' => false
    ]
];

You can read tgmpa documentation for plugin activation options., _(*11)

Updates

Composer:

Change the composer.json version to ^1.0.2**
Check CHANGELOG.md for any breaking changes before updating.

$ composer update

WordPress:

Includes support for github-updater to keep track on updates through the WordPress backend. * Download github-updater * Clone github-updater to your sites plugins/ folder * Activate via WordPress, _(*12)