← All changes | class-jetpack-pre-connection-jitms.php +20 -80 13.2.4 → 16.3-a.1 View file →

		@@ -1,16 +1,19 @@
1	1	<?php
2	2	/**
3	3	* Jetpack's Pre-Connection JITMs class.
4	4	*
	5	+ * @deprecated 13.3
	6	+ *
5	7	* @package jetpack
6	8	*/
7	9
8		-use Automattic\Jetpack\Partner_Coupon as Jetpack_Partner_Coupon;
9	10	use Automattic\Jetpack\Redirect;
10	11
11	12	/**
12	13	* Jetpack's Pre-Connection JITMs. These can be displayed with the JITM package.
	14	+ *
	15	+ * @deprecated 13.3
13	16	*/
14	17	class Jetpack_Pre_Connection_JITMs {
15	18
16	19	/**
		@@ -15,60 +18,15 @@
15	18
16	19	/**
17	20	* Returns all the pre-connection messages.
18	21	*
	22	+ * @deprecated 13.3
	23	+ *
19	24	* @return array An array containing the pre-connection JITM messages.
20	25	*/
21	26	private function get_raw_messages() {
22		- $button_caption = __( 'Set up Jetpack', 'jetpack' );
23		- /* Translators: placeholders are links. */
24		- $media_description = __( 'Click on the <strong>Set up Jetpack</strong> button to agree to our <a href="%1$s" target="_blank" rel="noopener noreferrer">Terms of Service</a> and to <a href="%2$s" target="_blank" rel="noopener noreferrer">share details</a> with WordPress.com, and gain access to Site Accelerator.', 'jetpack' );
25		- /* Translators: placeholders are links. */
26		- $widgets_description = __( 'Click on the <strong>Set up Jetpack</strong> button to agree to our <a href="%1$s" target="_blank" rel="noopener noreferrer">Terms of Service</a> and to <a href="%2$s" target="_blank" rel="noopener noreferrer">share details</a> with WordPress.com, and gain access to great additional widgets.', 'jetpack' );
27		- /* Translators: placeholders are links. */
28		- $posts_description = __( 'Click on the <strong>Set up Jetpack</strong> button to agree to our <a href="%1$s" target="_blank" rel="noopener noreferrer">Terms of Service</a> and to <a href="%2$s" target="_blank" rel="noopener noreferrer">share details</a> with WordPress.com, and gain access to in-depth stats about your site.', 'jetpack' );
29		-
30		- $messages = array(
31		- array(
32		- 'id' => 'jpsetup-upload',
33		- 'message_path' => '/wp:upload:admin_notices/',
34		- 'message' => __( 'Do you want lightning-fast images?', 'jetpack' ),
35		- 'description' => $this->generate_description_with_tos( $media_description ),
36		- 'button_caption' => $button_caption,
37		- ),
38		- array(
39		- 'id' => 'jpsetup-widgets',
40		- 'message_path' => '/wp:widgets:admin_notices/',
41		- 'message' => __( 'Looking for even more widgets?', 'jetpack' ),
42		- 'description' => $this->generate_description_with_tos( $widgets_description ),
43		- 'button_caption' => $button_caption,
44		- ),
45		- );
46		-
47		- if ( wp_count_posts()->publish >= 5 ) {
48		- $messages[] = array(
49		- 'id' => 'jpsetup-posts',
50		- 'message_path' => '/wp:edit-post:admin_notices/',
51		- 'message' => __( 'Do you know which of these posts gets the most traffic?', 'jetpack' ),
52		- 'description' => $this->generate_description_with_tos( $posts_description ),
53		- 'button_caption' => $button_caption,
54		- );
55		- }
56		-
57		- foreach ( $messages as $key => $message ) {
58		- /*
59		- * Add Connect URL to each message, with from including jitm id.
60		- */
61		- $jetpack_setup_url = $this->generate_admin_url(
62		- array(
63		- 'page' => 'jetpack#/setup',
64		- 'from' => sprintf( 'pre-connection-jitm-%s', $message['id'] ),
65		- )
66		- );
67		- $messages[ $key ]['button_link'] = $jetpack_setup_url;
68		- }
69		-
70		- return $messages;
	27	+ _deprecated_function( __METHOD__, 'jetpack-13.3' );
	28	+ return array();
71	29	}
72	30
73	31	/**
74	32	* Generate a description text with links to ToS documents.
		@@ -76,8 +34,10 @@
76	34	* Those messages must mention the ToS agreement message,
77	35	* but do not use the standard message defined in jetpack_render_tos_blurb.
78	36	* Instead, they use their own custom messages.
79	37	*
	38	+ * @deprecated 13.3
	39	+ *
80	40	* @param string $description Description string with placeholders.
81	41	*
82	42	* @return string
83	43	*/
		@@ -103,38 +63,22 @@
103	63	* Returns partnership related pre-connection messages.
104	64	*
105	65	* @since 10.4
106	66	*
	67	+ * @deprecated 13.3
	68	+ *
107	69	* @return array An array containing the pre-connection JITM messages.
108	70	*/
109	71	private function maybe_get_raw_partnership_messages() {
110		- $partner_coupon = Jetpack_Partner_Coupon::get_coupon();
111		-
112		- if ( ! $partner_coupon ) {
113		- return array();
114		- }
115		-
116		- return array(
117		- array(
118		- 'id' => 'jpsetup-partner-coupon',
119		- 'message_path' => '/wp:(plugin-install|themes|update-core|upload|users|tools|options-general):admin_notices/',
120		- /* Translators: 1: Product name, 2: Partner name. */
121		- 'message' => sprintf( esc_html__( 'Get %1$s with your %2$s account', 'jetpack' ), $partner_coupon['product']['title'], $partner_coupon['partner']['name'] ),
122		- 'description' => $partner_coupon['product']['description'],
123		- 'button_caption' => esc_html__( 'Redeem coupon', 'jetpack' ),
124		- 'button_link' => $this->generate_admin_url(
125		- array(
126		- 'page' => 'jetpack#/dashboard',
127		- 'from' => 'pre-connection-jitm--jpsetup-partner-coupon',
128		- )
129		- ),
130		- ),
131		- );
	72	+ _deprecated_function( __METHOD__, 'jetpack-13.3' );
	73	+ return array();
132	74	}
133	75
134	76	/**
135	77	* Adds the input query arguments to the admin url.
136	78	*
	79	+ * @deprecated 13.3
	80	+ *
137	81	* @param array $args The query arguments.
138	82	*
139	83	* @return string The admin url.
140	84	*/
		@@ -145,19 +89,15 @@
145	89
146	90	/**
147	91	* Add the Jetpack pre-connection JITMs to the list of pre-connection JITM messages.
148	92	*
	93	+ * @deprecated 13.3
	94	+ *
149	95	* @param array $pre_connection_messages An array of pre-connection JITMs.
150	96	*
151	97	* @return array The array of pre-connection JITMs.
152	98	*/
153	99	public function add_pre_connection_jitms( $pre_connection_messages ) {
154		- $jetpack_messages = array_merge( $this->get_raw_messages(), $this->maybe_get_raw_partnership_messages() );
155		-
156		- if ( ! is_array( $pre_connection_messages ) ) {
157		- // The incoming messages aren't an array, so just return Jetpack's messages.
158		- return $jetpack_messages;
159		- }
160		-
161		- return array_merge( $pre_connection_messages, $jetpack_messages );
	100	+ _deprecated_function( __METHOD__, 'jetpack-13.3' );
	101	+ return $pre_connection_messages;
162	102	}
163	103	}