class-misc.php — Advanced Ads – Ad Manager & AdSense 2.0.24

advanced-ads / includes / admin / class-misc.php

advanced-ads / includes / admin Last commit date

class-misc.php

282 lines

1	<?php
2	/**
3	* Uncategorised functionality.
4	*
5	* @package AdvancedAds
6	* @author Advanced Ads <info@wpadvancedads.com>
7	* @since 1.x.x
8	*/
9
10	namespace AdvancedAds\Admin;
11
12	use AdvancedAds\Constants;
13	use Advanced_Ads_Admin_Notices;
14	use AdvancedAds\Utilities\Conditional;
15	use AdvancedAds\Importers\XML_Importer;
16	use AdvancedAds\Framework\Utilities\Params;
17	use AdvancedAds\Framework\Interfaces\Integration_Interface;
18
19	defined( 'ABSPATH' ) \|\| exit;
20
21	/**
22	* Class Misc
23	*/
24	class Misc implements Integration_Interface {
25
26	/**
27	* Hook into WordPress.
28	*
29	* @return void
30	*/
31	public function hooks(): void {
32	add_filter( 'gettext', [ $this, 'replace_cheating_message' ], 20, 2 );
33	add_filter( 'get_user_option_user-settings', [ $this, 'reset_view_mode_option' ] );
34	add_action( 'in_admin_header', [ $this, 'register_admin_notices' ] );
35	add_action( 'plugins_api_result', [ $this, 'recommend_suitable_add_ons' ], 11, 3 );
36	add_action( 'admin_action_advanced_ads_starter_setup', [ $this, 'import_starter_setup' ] );
37	}
38
39	/**
40	* Replace 'You need a higher level of permission.' message if user role does not have required permissions.
41	*
42	* @param string $translated_text Translated text.
43	* @param string $untranslated_text Text to translate.
44	*
45	* @return string $translation Translated text.
46	*/
47	public function replace_cheating_message( $translated_text, $untranslated_text ): string {
48	global $typenow;
49
50	if (
51	isset( $typenow )
52	&& 'You need a higher level of permission.' === $untranslated_text
53	&& Constants::POST_TYPE_AD === $typenow
54	) {
55	$translated_text = __( 'You don’t have access to ads. Please deactivate and re-enable Advanced Ads again to fix this.', 'advanced-ads' )
56	. ' <a href="https://wpadvancedads.com/manual/user-capabilities/?utm_source=advanced-ads&utm_medium=link&utm_campaign=wrong-user-role#You_dont_have_access_to_ads" target="_blank">' . __( 'Get help', 'advanced-ads' ) . '</a>';
57	}
58
59	return (string) $translated_text;
60	}
61
62	/**
63	* Set the removed post list mode to "List", if it was set to "Excerpt".
64	*
65	* @param string $user_options Query string containing user options.
66	*
67	* @return string
68	*/
69	public function reset_view_mode_option( $user_options ): string {
70	return str_replace( '&posts_list_mode=excerpt', '&posts_list_mode=list', $user_options );
71	}
72
73	/**
74	* Registers Advanced Ads admin notices
75	* prevents other notices from showing up on our own pages
76	*
77	* @return void
78	*/
79	public function register_admin_notices(): void {
80	/**
81	* Remove all registered admin_notices from AA screens
82	* we need to use this or some users have half or more of their viewports cluttered with unrelated notices
83	*/
84	if ( Conditional::is_screen_advanced_ads() ) {
85	remove_all_actions( 'admin_notices' );
86	}
87
88	add_action( 'admin_notices', [ $this, 'admin_notices' ] );
89	}
90
91	/**
92	* Initiate the admin notices class
93	*
94	* @return void
95	*/
96	public function admin_notices(): void {
97	// Display ad block warning to everyone who can edit ads.
98	if (
99	Conditional::user_can( 'advanced_ads_edit_ads' )
100	&& Conditional::is_screen_advanced_ads()
101	) {
102	$ad_blocker_notice_id = wp_advads()->get_frontend_prefix() . 'abcheck-' . md5( microtime() );
103	wp_register_script( $ad_blocker_notice_id . '-adblocker-notice', false, [], ADVADS_VERSION, true );
104	wp_enqueue_script( $ad_blocker_notice_id . '-adblocker-notice' );
105	wp_add_inline_script(
106	$ad_blocker_notice_id . '-adblocker-notice',
107	"jQuery( document ).ready( function () {
108	let has_brave_shields = ( typeof navigator.brave !== 'undefined' && typeof advanced_ads_admin === 'undefined' ) ? true : false;
109
110	if ( typeof advanced_ads_adblocker_test === 'undefined' && ( typeof navigator.brave === 'undefined' \|\| has_brave_shields ) ) {
111	jQuery( '#" . esc_attr( $ad_blocker_notice_id ) . ".message' ).show();
112	}
113	} );"
114	);
115	include_once ADVADS_ABSPATH . 'admin/views/notices/adblock.php';
116	}
117
118	// Show success notice after starter setup was imported. Registered here because it will be visible only once.
119	if ( 'advanced-ads-starter-setup-success' === Params::get( 'message' ) ) {
120	add_action( 'advanced-ads-admin-notices', [ $this, 'starter_setup_success_message' ] );
121	}
122
123	/*
124	Register our own notices on Advanced Ads pages, except
125	-> the overview page where they should appear in the notices section,
126	-> revision page to prevent duplicate revision controls.
127	*/
128	$screen = get_current_screen();
129	if (
130	Conditional::user_can( 'advanced_ads_edit_ads' )
131	&& ( ! isset( $screen->id ) \|\| 'toplevel_page_advanced-ads' !== $screen->id )
132	&& 'revision' !== $screen->id
133	) {
134
135	echo '<div class="wrap">';
136	Advanced_Ads_Admin_Notices::get_instance()->display_notices();
137
138	// Allow other Advanced Ads plugins to show admin notices at this late stage.
139	do_action( 'advanced-ads-admin-notices' );
140	echo '</div>';
141	}
142	}
143
144	/**
145	* Show success message after starter setup was created.
146	*
147	* @return void
148	*/
149	public function starter_setup_success_message(): void {
150	$last_post = get_posts( [ 'numberposts' => 1 ] );
151	$last_post_link = isset( $last_post[0]->ID ) ? get_permalink( $last_post[0]->ID ) : false;
152
153	include ADVADS_ABSPATH . 'admin/views/notices/starter-setup-success.php';
154	}
155
156	/**
157	* Recommend additional add-ons
158	*
159	* @param object\|WP_Error $result Response object or WP_Error.
160	* @param string $action The type of information being requested from the Plugin Installation API.
161	* @param object $args Plugin API arguments.
162	*
163	* @return object\|WP_Error Response object or WP_Error.
164	*/
165	public function recommend_suitable_add_ons( $result, $action, $args ) {
166	if (
167	empty( $args->browse )
168	\|\| ! in_array( $args->browse, [ 'featured', 'recommended', 'popular' ], true )
169	\|\| ( isset( $result->info['page'] ) && $result->info['page'] > 1 )
170	) {
171	return $result;
172	}
173
174	// Grab all slugs from the api results.
175	$result_slugs = wp_list_pluck( $result->plugins, 'slug' );
176
177	// Recommend AdSense In-Feed add-on.
178	$result = $this->recommend_plugin(
179	'advanced-ads-adsense-in-feed',
180	'advanced-ads-adsense-in-feed/advanced-ads-in-feed.php',
181	$args,
182	$result,
183	$result_slugs
184	);
185
186	// Recommend Genesis Ads add-on.
187	if ( defined( 'PARENT_THEME_NAME' ) && 'Genesis' === PARENT_THEME_NAME ) {
188	$result = $this->recommend_plugin(
189	'advanced-ads-genesis',
190	'advanced-ads-genesis/genesis-ads.php',
191	$args,
192	$result,
193	$result_slugs
194	);
195	}
196
197	// Recommend WP Bakery (former Visual Composer) add-on.
198	if ( defined( 'WPB_VC_VERSION' ) ) {
199	$result = $this->recommend_plugin(
200	'ads-for-visual-composer',
201	'ads-for-visual-composer/advanced-ads-vc.php',
202	$args,
203	$result,
204	$result_slugs
205	);
206	}
207
208	return $result;
209	}
210
211	/**
212	* Import a starter setup for new users
213	*
214	* @return void
215	*/
216	public function import_starter_setup(): void {
217	if (
218	'advanced_ads_starter_setup' !== Params::get( 'action' )
219	\|\| ! Conditional::user_can( 'advanced_ads_edit_ads' )
220	) {
221	return;
222	}
223
224	check_admin_referer( 'advanced-ads-starter-setup' );
225
226	$xml = file_get_contents( ADVADS_ABSPATH . 'admin/assets/xml/starter-setup.xml' ); // phpcs:ignore WordPress.WP.AlternativeFunctions.file_get_contents_file_get_contents
227
228	( new XML_Importer() )->import_content( $xml );
229
230	// Redirect to the ads overview page.
231	wp_safe_redirect( admin_url( 'edit.php?post_type=advanced_ads&message=advanced-ads-starter-setup-success' ) );
232	}
233
234	/**
235	* Recommends a plugin based on the provided slug and file path.
236	*
237	* This function checks if the plugin is already active or recommended. If not,
238	* it fetches the plugin data using the WordPress Plugin API and adds it to the result.
239	*
240	* @param string $slug The slug of the plugin to recommend.
241	* @param string $file_path The file path of the plugin.
242	* @param object $args Additional arguments for the recommendation.
243	* @param object $result The current result object containing recommended plugins.
244	* @param array $result_slugs An array of slugs of already recommended plugins.
245	*
246	* @return object The updated result object with the recommended plugin added.
247	*/
248	private function recommend_plugin( $slug, $file_path, $args, $result, $result_slugs ) {
249	// Check if the plugin is already active or recommended.
250	if (
251	is_plugin_active( $file_path )
252	\|\| is_plugin_active_for_network( $file_path )
253	\|\| in_array( $slug, $result_slugs, true )
254	) {
255	return $result;
256	}
257
258	// Prepare query arguments to fetch plugin data.
259	$query_args = [
260	'slug' => $slug,
261	'fields' => [
262	'icons' => true,
263	'active_installs' => true,
264	'short_description' => true,
265	'group' => true,
266	],
267	];
268	$plugin_data = plugins_api( 'plugin_information', $query_args );
269
270	// Add plugin data to the result if fetched successfully.
271	if ( ! is_wp_error( $plugin_data ) ) {
272	if ( 'featured' === $args->browse ) {
273	array_push( $result->plugins, $plugin_data );
274	} else {
275	array_unshift( $result->plugins, $plugin_data );
276	}
277	}
278
279	return $result;
280	}
281	}
282