123 lines
2.3 KiB
PHP
123 lines
2.3 KiB
PHP
<?php
|
|
/**
|
|
* Plugin connection management class.
|
|
*
|
|
* @package automattic/jetpack-connection
|
|
*/
|
|
|
|
namespace Automattic\Jetpack\Connection;
|
|
|
|
/**
|
|
* Plugin connection management class.
|
|
* The class represents a single plugin that uses Jetpack connection.
|
|
* Its functionality has been pretty simplistic so far: add to the storage (`Plugin_Storage`), remove it from there,
|
|
* and determine whether it's the last active connection. As the component grows, there'll be more functionality added.
|
|
*/
|
|
class Plugin {
|
|
|
|
/**
|
|
* List of the keys allowed as arguments
|
|
*
|
|
* @var array
|
|
*/
|
|
private $arguments_whitelist = array(
|
|
'url_info',
|
|
);
|
|
|
|
/**
|
|
* Plugin slug.
|
|
*
|
|
* @var string
|
|
*/
|
|
private $slug;
|
|
|
|
/**
|
|
* Initialize the plugin manager.
|
|
*
|
|
* @param string $slug Plugin slug.
|
|
*/
|
|
public function __construct( $slug ) {
|
|
$this->slug = $slug;
|
|
}
|
|
|
|
/**
|
|
* Get the plugin slug.
|
|
*
|
|
* @return string
|
|
*/
|
|
public function get_slug() {
|
|
return $this->slug;
|
|
}
|
|
|
|
/**
|
|
* Add the plugin connection info into Jetpack.
|
|
*
|
|
* @param string $name Plugin name, required.
|
|
* @param array $args Plugin arguments, optional.
|
|
*
|
|
* @return $this
|
|
* @see $this->arguments_whitelist
|
|
*/
|
|
public function add( $name, array $args = array() ) {
|
|
$args = compact( 'name' ) + array_intersect_key( $args, array_flip( $this->arguments_whitelist ) );
|
|
|
|
Plugin_Storage::upsert( $this->slug, $args );
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Remove the plugin connection info from Jetpack.
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function remove() {
|
|
Plugin_Storage::delete( $this->slug );
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Determine if this plugin connection is the only one active at the moment, if any.
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function is_only() {
|
|
$plugins = Plugin_Storage::get_all();
|
|
|
|
return ! $plugins || ( array_key_exists( $this->slug, $plugins ) && 1 === count( $plugins ) );
|
|
}
|
|
|
|
/**
|
|
* Add the plugin to the set of disconnected ones.
|
|
*
|
|
* @deprecated since 1.39.0.
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function disable() {
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Remove the plugin from the set of disconnected ones.
|
|
*
|
|
* @deprecated since 1.39.0.
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function enable() {
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Whether this plugin is allowed to use the connection.
|
|
*
|
|
* @deprecated since 11.0
|
|
* @return bool
|
|
*/
|
|
public function is_enabled() {
|
|
return true;
|
|
}
|
|
}
|