관리-도구

편집 파일: ad-health-notices.php

<?php // phpcs:ignoreFile
/**
 * Array with ad health messages
 *
 * Attribute: type
 * - "notice" (default, recommendation, etc.)
 * - "problem" (critical)
 *
 * attribute: can_hide
 * (user can see a button to hide this warning, default: true)
 *
 * attribute: hide
 * (how to handle click on "hide" button)
 * - true (default, hide the item)
 * - false (remove the item completely from list of notifications)
 *
 * attribute: timeout
 * (for how long to hide/ignore the message in seconds.)
 * - default: empty
 *
 * attribute: get_help_link
 * (enter URL, if exists, will add a link after the message)
 */

$advanced_ads_ad_health_notices = apply_filters(
	'advanced-ads-ad-health-notices',
	[
		// old PHP version
		// checked using Advanced_Ads_Checks::php_version_minimum().
		'old_php' => [
			'text' => sprintf(
			// translators: %1$s is a version number.
				__( 'Your PHP version (%1$s) is too low. Advanced Ads is built for PHP %2$s and higher. It might work, but updating PHP is highly recommended. Please ask your hosting provider for more information.', 'advanced-ads' ),
				phpversion(),
				Advanced_Ads_Checks::MINIMUM_PHP_VERSION
			),
			'type' => 'problem',
		],
		// conflicting plugins found
		// Advanced_Ads_Checks::conflicting_plugins().
		'conflicting_plugins' => [
			'text' => sprintf(
				// translators: %1$s is a list of plugin names; %2$s a target URL.
				__( 'Plugins that are known to cause (partial) problems: %1$s. <a href="%2$s" target="_blank">Learn more</a>.', 'advanced-ads' ),
				implode( ', ', Advanced_Ads_Checks::conflicting_plugins() ),
				'https://wpadvancedads.com/manual/known-plugin-conflicts/?utm_source=advanced-ads&utm_medium=link&utm_campaign=error-plugin-conflicts'
			),
			'type' => 'problem',
		],
		// PHP extensions missing
		// Advanced_Ads_Checks::php_extensions().
		'php_extensions_missing' => [
			'text' => sprintf(
					// translators: %s is a list of PHP extensions.
				__( 'Missing PHP extensions could cause issues. Please ask your hosting provider to enable them: %s', 'advanced-ads' ),
				implode( ', ', Advanced_Ads_Checks::php_extensions() )
			),
			'type' => 'problem',
		],
		// ads are disabled
		// Advanced_Ads_Checks::ads_disabled().
		'ads_disabled' => [
			'text' => sprintf(
			// translators: %s is a target URL.
				__( 'Ads are disabled for all or some pages. See "disabled ads" in <a href="%s">settings</a>.', 'advanced-ads' ),
				admin_url( 'admin.php?page=advanced-ads-settings#top#general' )
			),
			'type' => 'problem',
		],
		// check if Advanced Ads related constants are enabled
		// Advanced_Ads_Checks::get_defined_constants().
		'constants_enabled' => [
			'text' => '<a href="' . admin_url( 'admin.php?page=advanced-ads-settings#top#support' ) . '">' . esc_html__( 'Advanced Ads related constants enabled', 'advanced-ads' ) . '</a>',
			'type' => 'notice',
		],
		// adblocker assets expired
		// Advanced_Ads_Checks::assets_expired().
		'assets_expired' => [
			'text' => sprintf(
			// translators: %s is a target URL.
				__( 'Some assets were changed. Please rebuild the asset folder in the <a href="%s">Advanced Ads settings</a> to update the ad blocker disguise.', 'advanced-ads' ),
				admin_url( 'admin.php?page=advanced-ads-settings' )
			),
			'type' => 'problem',
			'hide' => true,
		],
		// missing license codes
		// Advanced_Ads_Checks::license_invalid().
		'license_invalid' => [
			'text' => __( 'One or more license keys for Advanced Ads add-ons are invalid or missing.', 'advanced-ads' ) . ' '
				. sprintf(
					// translators: %s is a target URL.
					__( 'Please add valid license keys <a href="%s">here</a>.', 'advanced-ads' ),
					get_admin_url( null, 'admin.php?page=advanced-ads-settings#top#licenses' )
				),
			'type' => 'problem',
			'hide' => false,
			'timeout' => WEEK_IN_SECONDS,
		],
		// an individual ad expired.
		'ad_expired' => [
			'text' => __( 'Ad expired', 'advanced-ads' ) . ': ',
			'type' => 'notice',
			'hide' => false,
		],
		// a visible ad is used in <head> tags
		// is checked in the frontend by Ad Health in Advanced_Ads_Frontend_Checks::can_use_head_placement().
		'ad_with_output_in_head' => [
			// we keep the %s here and replace it with an empty string, because we use it somewhere else and don’t want to create a new string that is basically the same.
			'text' => sprintf(
			// translators: %s is empty here, but the string will be followed by a name of an ad unit.
				__( 'Visible ads should not use the Header placement: %s', 'advanced-ads' ),
				''
			),
			'type' => 'notice',
			'hide' => false,
			'get_help_link' => 'https://wpadvancedads.com/manual/ad-health/?utm_source=advanced-ads&utm_medium=link&utm_campaign=error-visible-ad-in-header#header-ads',
			'timeout' => YEAR_IN_SECONDS,
		],
		// Ad has HTTP, but site uses HTTPS
		// check in Ad Health in frontend.
		'ad_has_http' => [
			'text' => __( 'Your website is using HTTPS, but the ad code contains HTTP and might not work.', 'advanced-ads' ),
			'type' => 'notice',
			'hide' => false,
			'get_help_link' => 'https://wpadvancedads.com/manual/ad-health/?utm_source=advanced-ads&utm_medium=link&utm_campaign=error-https-ads#https-ads',
		],
		// dummy text for general AdSense issue.
		'adsense_issue' => [
			// we keep the %s here and replace it with an empty string, because we use it somewhere else and don’t want to create a new string that is basically the same.
			'text' => __( 'AdSense issue' ),
			'type' => 'problem',
		],
		// AdSense connection error: disapproved account.
		'adsense_connect_disapprovedAccount' => [
			'text' => __( 'Last AdSense account connection attempt failed.', 'advanced-ads' ) . '&nbsp;' . __( 'Your account was not approved by AdSense.', 'advance-ads' ) . ' ' . Advanced_Ads_Ad_Health_Notices::get_adsense_error_link( 'disapprovedAccount' ),
			'type' => 'problem',
			'hide' => false,
		],
		// AdSense connection error: no adsense account.
		'adsense_connect_noAdSenseAccount' => [
			'text' => sprintf(
				__( 'Last AdSense account connection attempt failed.', 'advanced-ads' ) . '&nbsp;' .
				// translators: %1$s is the opening a tag and %2$s the closing one.
				__( 'Create a new AdSense account %1$shere%2$s.', 'advanced-ads' ) . ' ' . Advanced_Ads_Ad_Health_Notices::get_adsense_error_link( 'noAdSenseAccount' ),
				'<a href="https://www.google.com/adsense/start/?utm_source=AdvancedAdsPlugIn&utm_medium=partnerships&utm_campaign=AdvancedAdsPartner1" target="_blank">',
				'</a>'
			),
			'type' => 'problem',
			'hide' => false,
		],
		// AdSense account alert. Missing ads.txt – version 1.
		'adsense_alert_ALERT_TYPE_ADS_TXT_UNAUTHORIZED' => [
			'text' => sprintf(
				 __( 'One of your sites is missing the AdSense publisher ID in the ads.txt file.', 'advanced-ads' )
				 . ' <a class="advads-settings-link" href="%s">'
				 . _x( 'Create one now.', 'related to ads.txt file', 'advanced-ads' ) . '</a>',
				 admin_url( 'admin.php?page=advanced-ads-settings#general__advads-ads-txt' )
			 ) . ' ' . Advanced_Ads_Ad_Health_Notices::get_adsense_error_link( 'ALERT_TYPE_ADS_TXT_UNAUTHORIZED' ),
			'type' => 'problem',
		],
		// AdSense account alert. . Missing ads.txt – version 2.
		'adsense_alert_ADS_TXT_MISSING' => [
			'text' => sprintf(
				 __( 'One of your sites is missing the AdSense publisher ID in the ads.txt file.', 'advanced-ads' )
				 . ' <a class="advads-settings-link" href="%s">'
				 . _x( 'Create one now.', 'related to ads.txt file', 'advanced-ads' ) . '</a>',
				 admin_url( 'admin.php?page=advanced-ads-settings#general__advads-ads-txt' )
			 ) . ' ' . Advanced_Ads_Ad_Health_Notices::get_adsense_error_link( 'ADS_TXT_MISSING' ),
			'type' => 'problem',
		],
		// AdSense account alert. . Missing ads.txt – version 3.
		'adsense_alert_ADS_TXT_ISSUES' => [
			'text' => sprintf(
				 __( 'One of your sites is missing the AdSense publisher ID in the ads.txt file.', 'advanced-ads' )
				 . ' <a class="advads-settings-link" href="%s">'
				 . _x( 'Create one now.', 'related to ads.txt file', 'advanced-ads' ) . '</a>',
				 admin_url( 'admin.php?page=advanced-ads-settings#general__advads-ads-txt' )
			 ) . ' ' . Advanced_Ads_Ad_Health_Notices::get_adsense_error_link( 'ADS_TXT_ISSUES' ),
			'type' => 'problem',
		],
		// AdSense deprecated link units
		'adsense_link_units_deprecated' => [
			'text' => __( 'Google AdSense deprecated Link Units. Please choose another format.', 'advanced-ads' )
					 . ' <a href="https://wpadvancedads.com/adsense-link-units/" target="_blank" rel="noopener">'
					 . esc_html__( 'Learn more', 'advanced-ads' )
					 . '</a>',
			'type' => 'problem',
		],
		'nested_the_content_filters' => [
			'text' => sprintf(
			 // translators: %s is a filter hook, here `the_content`.
				 __( '%s filter found multiple times.', 'advanced-ads' ),
				 'the_content'
			 ) . '&nbsp;' . __( 'Advanced Ads uses the outermost of them.', 'advanced-ads' ),
			'get_help_link' => 'https://wpadvancedads.com/manual/ad-health/?utm_source=advanced-ads&utm_medium=link&utm_campaign=error-multiple-the-content#the_content_filter_found_multiple_times',
			'type' => 'notice',
			'hide' => false,
		],
		// BuddyPress or BuddyBoss installed.
		'buddypress_no_pro' => [
			'text' => sprintf(
			// translators: %1$s is a plugin name, %2$s is the opening a tag and %3$s the closing one.
				__( 'Learn how to integrate %1$s with Advanced Ads %2$shere%3$s.', 'advanced-ads' ),
				'BuddyPress & BuddyBoss',
				'<a href="https://wpadvancedads.com/ads-on-buddypress-pages/?utm_source=advanced-ads&utm_medium=link&utm_campaign=notice-buddypress" target="_blank">',
				'</a>'
			),
			'type' => 'notice',
		],
		// bbPress installed.
		'bbpress_no_pro' => [
			'text' => sprintf(
			// translators: %1$s is a plugin name, %2$s is the opening a tag and %3$s the closing one.
				__( 'Learn how to integrate %1$s with Advanced Ads %2$shere%3$s.', 'advanced-ads' ),
				'bbPress',
				'<a href="https://wpadvancedads.com/ads-in-bbpress/?utm_source=advanced-ads&utm_medium=link&utm_campaign=notice-bbpress" target="_blank">',
				'</a>'
			),
			'type' => 'notice',
		],
		// WPML plugin activated.
		'WPML_active' => [
			'text' => sprintf(
			// translators: %1$s is a plugin name, %2$s is the opening a tag and %3$s the closing one.
				__( 'Learn how to integrate %1$s with Advanced Ads %2$shere%3$s.', 'advanced-ads' ),
				'WPML',
				'<a href="https://wpadvancedads.com/translating-ads-wpml/?utm_source=advanced-ads&utm_medium=link&utm_campaign=notice-WPML" target="_blank">',
				'</a>'
			),
			'type' => 'notice',
			'hide' => false,
			'timeout' => YEAR_IN_SECONDS,
		],
		// AMP and Accelerated Mobile Pages plugins.
		'AMP_active' => [
			'text' => sprintf(
			// translators: %1$s is a plugin name, %2$s is the opening a tag and %3$s the closing one.
				__( 'Learn how to integrate %1$s with Advanced Ads %2$shere%3$s.', 'advanced-ads' ),
				'AMP',
				'<a href="https://wpadvancedads.com/manual/ads-on-amp-pages/?utm_source=advanced-ads&utm_medium=link&utm_campaign=notice-amp" target="_blank">',
				'</a>'
			),
			'type' => 'notice',
			'hide' => false,
			'timeout' => YEAR_IN_SECONDS,
		],
		// Hosting on WP Engine
		// Advanced_Ads_Checks::wp_engine_hosting().
		'wpengine' => [
			'text' => sprintf(
			// translators: %s is a service or plugin name.
				'' . __( '%s detected.', 'advanced-ads' ) . ''
				. ' <a href="https://wpadvancedads.com/wp-engine-and-ads/?utm_source=advanced-ads&utm_medium=link&utm_campaign=notice-wpengine">' . __( 'Learn how this might impact your ad setup.', 'advanced-ads' ) . '</a>',
				'WP Engine'
			),
			'type' => 'notice',
			'hide' => false,
			'timeout' => YEAR_IN_SECONDS,
		],
		// Notice about existing ads.txt plugins.
		// Advanced_Ads_Checks::ads_txt_plugins().
		'ads_txt_plugins_enabled' => [
			'text' => sprintf(
				/* translators: %s removable ads.txt plugins */
				__( 'Advanced Ads handles your ads.txt file automatically. You might be able to remove %1$s.', 'advanced-ads' ),
				implode( ', ', Advanced_Ads_Checks::ads_txt_plugins() )
			),
			'type' => 'notice',
			'hide' => false,
			'timeout' => YEAR_IN_SECONDS,
		],
		// Notice about plugins that add header or footer code.
		// Advanced_Ads_Checks::header_footer_plugins().
		'header_footer_plugins_enabled' => [
			'text' =>
				__( 'Advanced Ads handles header and footer codes.', 'advanced-ads' ) . '&nbsp;' .
				/* translators: %s removable header and footer plugins */
				sprintf( __( 'You might be able to remove %1$s.', 'advanced-ads' ),
					implode( ', ', Advanced_Ads_Checks::header_footer_plugins() )
				) . '&nbsp;' .
				'<a href="https://wpadvancedads.com/add-header-and-footer-code-wordpress/?utm_source=advanced-ads&utm_medium=link&utm_campaign=notice-header-footer" target="_blank">' . __( 'Learn how.', 'advanced-ads' ) . '</a>',
			'type' => 'notice',
			'hide' => false,
			'timeout' => YEAR_IN_SECONDS,
		],
	]
);