add notificaton to upsell attribute mapper

Author: David Evbodaghe

facebook-commerce.php

@@ -539,6 +539,10 @@ public function load_background_sync_process() {
 			'wp_ajax_ajax_fb_background_check_queue',
 			[ $this, 'ajax_fb_background_check_queue' ]
 		);
+		add_action(
+			'wp_ajax_fb_dismiss_unmapped_attributes_banner',
+			[ $this, 'ajax_dismiss_unmapped_attributes_banner' ]
+		);
 	}
 
 	/**
@@ -1734,9 +1738,88 @@ public function display_batch_api_completed( $post ) {
 					$this->get_product_catalog_id() .
 					'/products/" target="_blank">View product on Meta catalog</a>'
 			);
+
+			// Display unmapped attributes banner if there are any
+			$this->display_unmapped_attributes_banner( $fb_product->woo_product );
+		}
+	}
+
+	/**
+	 * Displays a banner for unmapped attributes encouraging users to use the attribute mapper.
+	 *
+	 * @param \WC_Product $product The product object
+	 * @return void
+	 */
+	public function display_unmapped_attributes_banner( \WC_Product $product ) {
+		// Check if this feature should be shown
+		if ( ! $this->should_show_unmapped_attributes_banner() ) {
+			return;
+		}
+
+		// Get unmapped attributes using the ProductAttributeMapper
+		if ( ! class_exists( '\WooCommerce\Facebook\ProductAttributeMapper' ) ) {
+			return;
 		}
+
+		$unmapped_attributes = \WooCommerce\Facebook\ProductAttributeMapper::get_unmapped_attributes( $product );
+
+		// Only show if there are unmapped attributes
+		if ( empty( $unmapped_attributes ) ) {
+			return;
+		}
+
+		$count = count( $unmapped_attributes );
+		$attribute_names = array_column( $unmapped_attributes, 'name' );
+		$attribute_list = implode( ', ', array_slice( $attribute_names, 0, 3 ) );
+		if ( $count > 3 ) {
+			$attribute_list .= sprintf( __( ' and %d more', 'facebook-for-woocommerce' ), $count - 3 );
+		}
+
+		// Build the mapper URL
+		$mapper_url = add_query_arg( 
+			array( 
+				'page' => 'wc-facebook',
+				'tab'  => 'product-attributes'
+			),
+			admin_url( 'admin.php' )
+		);
+
+		$message = sprintf(
+			/* translators: %1$s - attribute list, %2$d - count, %3$s - link start, %4$s - link end */
+			_n(
+				'%3$sAttribute "%1$s" is not mapped to Meta.%4$s Use the %3$sattribute mapper%4$s to map this attribute and improve your product visibility in Meta ads.',
+				'%3$s%2$d attributes (%1$s) are not mapped to Meta.%4$s Use the %3$sattribute mapper%4$s to map these attributes and improve your product visibility in Meta ads.',
+				$count,
+				'facebook-for-woocommerce'
+			),
+			$attribute_list,
+			$count,
+			'<a href="' . esc_url( $mapper_url ) . '" target="_blank">',
+			'</a>'
+		);
+
+		// Store the message with a specific prefix to identify it
+		$banner_message = self::FB_ADMIN_MESSAGE_PREPEND . $message;
+		set_transient(
+			'facebook_plugin_unmapped_attributes_info',
+			$banner_message,
+			self::FB_MESSAGE_DISPLAY_TIME
+		);
 	}
 
+	/**
+	 * Determines if the unmapped attributes banner should be shown.
+	 *
+	 * @return bool
+	 */
+	private function should_show_unmapped_attributes_banner() {
+		// Only show to users who can manage WooCommerce
+		if ( ! current_user_can( 'manage_woocommerce' ) ) {
+			return false;
+		}
+
+		return true;
+	}
 
 	/**
 	 * Checks the feed upload status (FBE v1.0).
@@ -2161,6 +2244,27 @@ public function ajax_delete_fb_product() {
 		wp_die();
 	}
 
+	/**
+	 * AJAX handler for dismissing the unmapped attributes banner.
+	 *
+	 * @return void
+	 */
+	public function ajax_dismiss_unmapped_attributes_banner() {
+		// Check permissions
+		if ( ! current_user_can( 'manage_woocommerce' ) ) {
+			wp_die( -1, 403 );
+		}
+
+		// Check nonce
+		check_ajax_referer( 'fb_dismiss_unmapped_attributes_banner' );
+
+		// Clear the transient (but don't set permanent user meta)
+		// This way the banner will show again next time there are unmapped attributes
+		delete_transient( 'facebook_plugin_unmapped_attributes_info' );
+
+		wp_die();
+	}
+
 	/**
 	 * Special function to run all visible products through on_product_publish
 	 *
@@ -2841,6 +2945,39 @@ public function maybe_display_facebook_api_messages() {
 			echo $this->get_message_html( $sticky_msg, 'info' );
 			// transient must be deleted elsewhere, or wait for timeout
 		}
+		
+		// Display unmapped attributes banner
+		$unmapped_attributes_msg = get_transient( 'facebook_plugin_unmapped_attributes_info' );
+		if ( $unmapped_attributes_msg && $this->should_show_unmapped_attributes_banner() ) {
+			// Add a dismiss button to the message
+			$dismiss_message = $unmapped_attributes_msg . ' <button type="button" class="notice-dismiss" onclick="fbDismissUnmappedAttributesBanner(event)" title="' . esc_attr__( 'Dismiss this notice.', 'facebook-for-woocommerce' ) . '"><span class="screen-reader-text">' . esc_html__( 'Dismiss this notice.', 'facebook-for-woocommerce' ) . '</span></button>';
+			
+			// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
+			echo $this->get_message_html( $dismiss_message, 'info' );
+			
+			// Include JavaScript for dismiss functionality
+			?>
+			<script type="text/javascript">
+			function fbDismissUnmappedAttributesBanner(event) {
+				// Make AJAX request to dismiss the banner
+				var xhr = new XMLHttpRequest();
+				xhr.open('POST', '<?php echo esc_url( admin_url( 'admin-ajax.php' ) ); ?>', true);
+				xhr.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded');
+				xhr.onload = function() {
+					if (xhr.status === 200) {
+						// Hide the notice immediately
+						var notice = event.target.closest('.notice');
+						if (notice) {
+							notice.style.display = 'none';
+						}
+					}
+				};
+				xhr.send('action=fb_dismiss_unmapped_attributes_banner&_wpnonce=<?php echo esc_attr( wp_create_nonce( 'fb_dismiss_unmapped_attributes_banner' ) ); ?>');
+			}
+			</script>
+			<?php
+			delete_transient( 'facebook_plugin_unmapped_attributes_info' );
+		}
 	}
 
 	/**