← All changes | jetpack_vendor/automattic/jetpack-connection/src/class-plugin.php +109 -0 16.2-beta → 16.3 View file →

		@@ -1,0 +1,109 @@
	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	+}