Show a plugin action link and activation notice link that lead to the admin page.

Author: Felix Arntz

wpengine-phpcompat.php

@@ -19,6 +19,12 @@
  */
 class WPEngine_PHPCompat {
 
+	/* Capability required to run the scanner and access the admin page */
+	const CAPABILITY = 'manage_options';
+
+	/* Slug for the admin page */
+	const ADMIN_PAGE_SLUG = 'php-compatibility-checker';
+
 	/* Define and register singleton */
 	private static $instance = false;
 
@@ -59,6 +65,13 @@ public static function init() {
 
 		// Create custom post type.
 		add_action( 'init', array( self::instance(), 'create_job_queue' ) );
+
+		// Handle activation notice.
+		register_activation_hook( __FILE__, array( self::instance(), 'set_activation_notice_flag' ) );
+		add_action( 'admin_notices', array( self::instance(), 'maybe_show_activation_notice' ) );
+
+		// Add plugin action link.
+		add_filter( 'plugin_action_links_' . plugin_basename( __FILE__ ), array( self::instance(), 'filter_plugin_links' ) );
 	}
 
 	/**
@@ -100,7 +113,7 @@ function get_phpversions() {
 	 * @return null
 	 */
 	function start_test() {
-		if ( current_user_can( 'manage_options' ) || ( defined( 'DOING_CRON' ) && DOING_CRON ) ) {
+		if ( current_user_can( self::CAPABILITY ) || ( defined( 'DOING_CRON' ) && DOING_CRON ) ) {
 			global $wpdb;
 
 			$wpephpc = new WPEPHPCompat( dirname( __FILE__ ) );
@@ -144,7 +157,7 @@ function start_test() {
 	 * @return null
 	 */
 	function check_status() {
-		if ( current_user_can( 'manage_options' ) || ( defined( 'DOING_CRON' ) && DOING_CRON ) ) {
+		if ( current_user_can( self::CAPABILITY ) || ( defined( 'DOING_CRON' ) && DOING_CRON ) ) {
 			$scan_status = get_option( 'wpephpcompat.status' );
 			$count_jobs = wp_count_posts( 'wpephpcompat_jobs' );
 			$total_jobs = get_option( 'wpephpcompat.numdirs' );
@@ -230,7 +243,7 @@ function fork_scan( $test_version, $only_active ) {
 	 * @action wp_ajax_wpephpcompat_clean_up
 	 */
 	function clean_up() {
-		if ( current_user_can( 'manage_options' ) || ( defined( 'DOING_CRON' ) && DOING_CRON ) ) {
+		if ( current_user_can( self::CAPABILITY ) || ( defined( 'DOING_CRON' ) && DOING_CRON ) ) {
 			$wpephpc = new WPEPHPCompat( dirname( __FILE__ ) );
 			$wpephpc->clean_after_scan();
 			delete_option( 'wpephpcompat.scan_results' );
@@ -307,7 +320,7 @@ function admin_enqueue( $hook ) {
 	 */
 	function create_menu() {
 		// Create Tools sub-menu.
-		$this->page = add_submenu_page( 'tools.php', __( 'PHP Compatibility', 'php-compatibility-checker' ), __( 'PHP Compatibility', 'php-compatibility-checker' ), 'manage_options', 'php-compatibility-checker', array( self::instance(), 'settings_page' ) );
+		$this->page = add_submenu_page( 'tools.php', __( 'PHP Compatibility', 'php-compatibility-checker' ), __( 'PHP Compatibility', 'php-compatibility-checker' ), self::CAPABILITY, self::ADMIN_PAGE_SLUG, array( self::instance(), 'settings_page' ) );
 	}
 
 	/**
@@ -466,6 +479,68 @@ function settings_page() {
 		</script>
 		<?php
 	}
+
+	/**
+	 * Sets the activation notice flag so that it is shown in the admin.
+	 *
+	 * @since 1.4.4
+	 */
+	function set_activation_notice_flag() {
+		add_option( 'wpephpcompat.show_notice', true );
+	}
+
+	/**
+	 * Shows the activation notice if the flag for it is set.
+	 *
+	 * @since 1.4.4
+	 */
+	function maybe_show_activation_notice() {
+		$option = get_option( 'wpephpcompat.show_notice' );
+
+		if ( ! $option ) {
+			return;
+		}
+
+		delete_option( 'wpephpcompat.show_notice' );
+
+		if ( ! current_user_can( self::CAPABILITY ) ) {
+			return;
+		}
+
+		$url = add_query_arg( 'page', self::ADMIN_PAGE_SLUG, admin_url( 'tools.php' ) );
+
+		?>
+		<div class="notice updated is-dismissible">
+			<p>
+				<?php
+				printf(
+					/* translators: %s: URL to admin page */
+					__( 'You have just activated the <strong>PHP Compatibility Checker</strong>. <a href="%s">Start scanning your plugins and themes for compatibility with the latest PHP versions now!</a>', 'php-compatibility-checker' ),
+					esc_url( $url )
+				);
+				?>
+			</p>
+		</div>
+		<?php
+	}
+
+	/**
+	 * Adds a link to the admin page to the plugin action links.
+	 *
+	 * @since 1.4.4
+	 *
+	 * @param array $links Plugin action links.
+	 * @return array Modified plugin action links.
+	 */
+	function filter_plugin_links( $links ) {
+		if ( current_user_can( self::CAPABILITY ) ) {
+			$url = add_query_arg( 'page', self::ADMIN_PAGE_SLUG, admin_url( 'tools.php' ) );
+
+			array_unshift( $links, '<a href="' . esc_url( $url ) . '">' . esc_html__( 'Start Scan', 'php-compatibility-checker' ) . '</a>' );
+		}
+
+		return $links;
+	}
 }
 // Register the WPEngine_PHPCompat instance
 WPEngine_PHPCompat::init();