Download the PHP package automattic/jetpack-config without Composer

On this page you can find all versions of the php package automattic/jetpack-config. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of automattic/jetpack-config

Informations about the package jetpack-config

Jetpack Configuration

Allows for enabling and initializing of Jetpack features provided by other packages.

Usage

Add this package as a dependency to your project:

Add every other package you're planning to configure:

In your code initialize the configuration package at or before plugins_loaded priority 1:

Adding your package to the config class

You can have your package initialized using the Config class by adding several things.

The configure method

It's better to have one static configure method in your package class. That method will be called early on the plugins_loaded hook. This way you can add your own plugins_loaded handlers with standard priority and they will get executed:

The feature enabling method

An enabling method should be added to the Config class and should only contain your configuration method call.

Note that the method name should use the feature slug, in this case your feature slug is configurable_package for the sake of simplicity. When you're adding your feature it should be unique and recognizable, like sync or tracking.

The feature slug

To make sure the feature is supported by the Config class, you need to add its slug to the config class property:

The ensure_options call

Each consumer will initialize your package from its own instance of the Config class, and each consumer can call $config->ensure( 'your-feature', $options ) passing different options.

Your package will need to handle these options and decide what to do with them when different consumers pass diferent options.

You do that by creating a ensure_options_{$package_slug} method to the Config class. For example:

This method will be called every time a different consumer "ensures" your feature and pass some options. It will run BEFORE the enable_$feature method is called, so your package must be prepare to receive and treat this options before it is initialized. By the time it is initialized, it should have received all the different options consumers have passed and decided what to do with them.

The ensure call

Finally you need to add a block that will check if your package is loaded and mark it to be initialized:

This code does three things: it checks whether the current setup has requested your package to be loaded. Next it checks if the class that you need for the package to run is present, and then it adds the hook handlers that initialize your class. After that you can use the config package's interface in a Jetpack package consumer application and load your package as shown in the first section of this README.

Config Package Dependencies

The Config package does not have any composer package dependencies. The consumer plugins must require the packages that they need.

Before using a package class, the Config package will verify that the class exists using the Config::ensure_class() method. This allows the consumer plugins to use the Config package to enable and initialize Jetpack features while requiring only the packages that they need.

Using this package in your WordPress plugin

If you plan on using this package in your WordPress plugin, we would recommend that you use Jetpack Autoloader as your autoloader. This will allow for maximum interoperability with other plugins that use this package as well.

Security

Need to report a security vulnerability? Go to https://automattic.com/security/ or directly to our security bug bounty site https://hackerone.com/automattic.

License

jetpack-config is licensed under GNU General Public License v2 (or later)

All versions of jetpack-config with dependencies

PHP Build Version
Package Version
Requires php Version >=7.2
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package automattic/jetpack-config contains the following files

Loading the files please wait ....