abilities
6 days ago
connectors
6 days ago
health
6 days ago
identity-crisis
2 months ago
sso
2 months ago
traits
9 months ago
webhooks
9 months ago
class-authorize-json-api.php
2 months ago
class-client.php
6 days ago
class-connection-assets.php
1 year ago
class-connection-notice.php
8 months ago
class-error-handler.php
6 days ago
class-external-storage.php
4 months ago
class-heartbeat.php
1 month ago
class-initial-state.php
4 weeks ago
class-manager.php
6 days ago
class-nonce-handler.php
9 months ago
class-package-version-tracker.php
2 months ago
class-package-version.php
6 days ago
class-partner-coupon.php
3 months ago
class-partner.php
2 years ago
class-plugin-storage.php
8 months ago
class-plugin.php
9 months ago
class-rest-authentication.php
6 days ago
class-rest-connector.php
6 days ago
class-secrets.php
9 months ago
class-server-sandbox.php
3 months ago
class-site-health.php
6 days ago
class-terms-of-service.php
6 days ago
class-tokens-locks.php
9 months ago
class-tokens.php
6 days ago
class-tracking.php
6 days ago
class-urls.php
6 months ago
class-user-account-status.php
6 days ago
class-users-connection-admin.php
2 months ago
class-utils.php
2 years ago
class-webhooks.php
2 months ago
class-xmlrpc-async-call.php
2 years ago
class-xmlrpc-connector.php
9 months ago
interface-manager.php
4 years ago
interface-storage-provider.php
6 months ago
class-plugin.php
110 lines
| 1 | <?php |
| 2 | /** |
| 3 | * Plugin connection management class. |
| 4 | * |
| 5 | * @package automattic/jetpack-connection |
| 6 | */ |
| 7 | |
| 8 | namespace Automattic\Jetpack\Connection; |
| 9 | |
| 10 | /** |
| 11 | * Plugin connection management class. |
| 12 | * The class represents a single plugin that uses Jetpack connection. |
| 13 | * Its functionality has been pretty simplistic so far: add to the storage (`Plugin_Storage`), remove it from there, |
| 14 | * and determine whether it's the last active connection. As the component grows, there'll be more functionality added. |
| 15 | */ |
| 16 | class Plugin { |
| 17 | |
| 18 | /** |
| 19 | * List of the keys allowed as arguments |
| 20 | * |
| 21 | * @var array |
| 22 | */ |
| 23 | private $arguments_whitelist = array( |
| 24 | 'url_info', |
| 25 | ); |
| 26 | |
| 27 | /** |
| 28 | * Plugin slug. |
| 29 | * |
| 30 | * @var string |
| 31 | */ |
| 32 | private $slug; |
| 33 | |
| 34 | /** |
| 35 | * Users Connection Admin instance. |
| 36 | * |
| 37 | * @var Users_Connection_Admin |
| 38 | */ |
| 39 | private $users_connection_admin; |
| 40 | |
| 41 | /** |
| 42 | * Initialize the plugin manager. |
| 43 | * |
| 44 | * @param string $slug Plugin slug. |
| 45 | */ |
| 46 | public function __construct( $slug ) { |
| 47 | $this->slug = $slug; |
| 48 | |
| 49 | // Initialize Users_Connection_Admin |
| 50 | $this->users_connection_admin = new Users_Connection_Admin(); |
| 51 | } |
| 52 | |
| 53 | /** |
| 54 | * Get the plugin slug. |
| 55 | * |
| 56 | * @return string |
| 57 | */ |
| 58 | public function get_slug() { |
| 59 | return $this->slug; |
| 60 | } |
| 61 | |
| 62 | /** |
| 63 | * Add the plugin connection info into Jetpack. |
| 64 | * |
| 65 | * @param string $name Plugin name, required. |
| 66 | * @param array $args Plugin arguments, optional. |
| 67 | * |
| 68 | * @return $this |
| 69 | * @see $this->arguments_whitelist |
| 70 | */ |
| 71 | public function add( $name, array $args = array() ) { |
| 72 | $args = compact( 'name' ) + array_intersect_key( $args, array_flip( $this->arguments_whitelist ) ); |
| 73 | |
| 74 | Plugin_Storage::upsert( $this->slug, $args ); |
| 75 | |
| 76 | return $this; |
| 77 | } |
| 78 | |
| 79 | /** |
| 80 | * Remove the plugin connection info from Jetpack. |
| 81 | * |
| 82 | * @return $this |
| 83 | */ |
| 84 | public function remove() { |
| 85 | Plugin_Storage::delete( $this->slug ); |
| 86 | |
| 87 | return $this; |
| 88 | } |
| 89 | |
| 90 | /** |
| 91 | * Determine if this plugin connection is the only one active at the moment, if any. |
| 92 | * |
| 93 | * @return bool |
| 94 | */ |
| 95 | public function is_only() { |
| 96 | $plugins = Plugin_Storage::get_all(); |
| 97 | |
| 98 | if ( is_wp_error( $plugins ) ) { |
| 99 | if ( 'too_early' === $plugins->get_error_code() ) { |
| 100 | _doing_it_wrong( __METHOD__, esc_html( $plugins->get_error_code() . ': ' . $plugins->get_error_message() ), '6.16.1' ); |
| 101 | } else { |
| 102 | wp_trigger_error( __METHOD__, $plugins->get_error_code() . ': ' . $plugins->get_error_message() ); |
| 103 | } |
| 104 | return false; |
| 105 | } |
| 106 | |
| 107 | return ! $plugins || ( array_key_exists( $this->slug, $plugins ) && 1 === count( $plugins ) ); |
| 108 | } |
| 109 | } |
| 110 |