add ability to show notifications for new features in matomo for wordpress

assets/css/admin-style.css

@@ -161,3 +161,52 @@ table.matomo-tracking-form th {
     -ms-transform: translateX(1.03em);
     transform: translateX(1.03em);
 }
+
+#toplevel_page_matomo a {
+    position: relative;
+    display: inline-block;
+}
+
+#toplevel_page_matomo .matomo-notification-dot::before {
+    content: " ";
+    position: absolute;
+    display: inline-block;
+    width: 6px;
+    height: 6px;
+    background-color: red;
+    border-radius: 50%;
+    right: 4px;
+}
+
+.notice.matomo-whats-new {
+    border-left-color: #9D2235;
+}
+
+.notice.matomo-whats-new .button-primary {
+    background-color: #9D2235;
+    border-color: #9D2235;
+}
+
+.notice.matomo-whats-new h6 {
+    margin: 0;
+    font-style: italic;
+    color: #9D2235;
+    font-size: .8em;
+}
+
+.notice.matomo-whats-new h3 {
+    font-size: 1.6em;
+    margin: 6px 0;
+}
+
+.matomo-plugin-list.matomo-new-plugins .plugin-card {
+    position: relative;
+}
+
+.matomo-plugin-list.matomo-new-plugins .plugin-card .matomo-new-marker {
+    position: absolute;
+    right: 8px;
+    top: 8px;
+    font-style: italic;
+    color: #9D2235;
+}

assets/js/admin.js

@@ -45,4 +45,34 @@ window.jQuery(document).ready(function ($) {
       });
     });
   }
+
+  // whats new notice dismiss
+  if (typeof mtmWhatsNewNotificationAjax !== 'undefined' && mtmWhatsNewNotificationAjax.ajax_url) {
+      $('body').on('click', '.matomo-whats-new .notice-dismiss', function (e) {
+          $.post(mtmWhatsNewNotificationAjax.ajax_url, {
+              _ajax_nonce: mtmWhatsNewNotificationAjax.nonce,
+              action: 'mtm_dismiss_whats_new',
+              matomo_notification: $(e.target).closest('.matomo-whats-new').data('notification-id'),
+          });
+      });
+  }
+
+  // add a notification dot to menu items that need it (see WhatsNewNotification.php)
+  if (typeof mtmUnseenWhatsNewNotifications !== 'undefined' && mtmUnseenWhatsNewNotifications.length) {
+      $('#toplevel_page_matomo a').each(function () {
+          var href = $(this).attr('href');
+
+          var m = href.match(/\?page=(.*?)$/);
+          var page = m && m[1];
+          if (!page) {
+              return;
+          }
+
+          if (!mtmUnseenWhatsNewNotifications.includes(page)) {
+              return;
+          }
+
+          $(this).addClass('matomo-notification-dot');
+      });
+  }
 });

classes/WpMatomo.php

@@ -120,6 +120,17 @@ public function __construct() {
 			$plugin_admin_overrides->register_hooks();
 		}
 
+		add_action(
+			'init',
+			function () {
+				$whats_new_notifications = new \WpMatomo\Admin\WhatsNewNotifications( self::$settings );
+				if ( $whats_new_notifications->is_active() ) {
+					$whats_new_notifications->register_hooks();
+				}
+				$whats_new_notifications->register_ajax();
+			}
+		);
+
 		$tracking_code = new TrackingCode( self::$settings );
 		$tracking_code->register_hooks();
 		$annotations = new Annotations( self::$settings );

classes/WpMatomo/Admin/Admin.php

@@ -28,8 +28,11 @@ public function __construct( $settings, $init_menu = true ) {
 	}
 
 	public static function is_matomo_admin() {
-		return isset( $_GET['page'] )
-			&& substr( sanitize_text_field( wp_unslash( $_GET['page'] ) ), 0, 7 ) === 'matomo-';
+		return substr( self::get_current_page(), 0, 7 ) === 'matomo-';
+	}
+
+	public static function get_current_page() {
+		return isset( $_GET['page'] ) ? sanitize_text_field( wp_unslash( $_GET['page'] ) ) : '';
 	}
 
 	public function load_scripts() {