Improve admin UI for event-category mapping

Based on evaluation results.

CHANGELOG.md

@@ -7,9 +7,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Unreleased
 
-### Fixed
+## Fixed
 
-* Fixed that transformer hook function might also return `null`.
+* Improved admin UI for event-category mapping
 
 ## [0.2.1] - 2024-11-16
 

README.md

@@ -100,12 +100,6 @@ We're always interested in your feedback. Feel free to reach out to us via [E-Ma
 
 ## Changelog ##
 
-## Unreleased
-
-### Fixed
-
-* Fixed that transformer hook function might also return `null`.
-
 ### [0.2.1] 2024-11-16 ###
 
 * Initial release on https://wordpress.org/

assets/css/activitypub-event-bridge-admin.css

@@ -177,3 +177,9 @@ code.activitypub-event-bridge-settings-example-url {
 	overflow-x: auto;
 	word-break: break-all;
 }
+
+.activitypub-event-bridge-settings .select-cell::before {
+    content: "\21D2";
+    margin-right: 8px;
+    color: inherit;
+}

includes/class-setup.php

@@ -252,7 +252,7 @@ class Setup {
 	 *
 	 * @return \Activitypub\Transformer\Base|null
 	 */
-	public function register_activitypub_event_transformer( $transformer, $wp_object, $object_class ): ?\Activitypub\Transformer\Base {
+	public function register_activitypub_event_transformer( $transformer, $wp_object, $object_class ): \Activitypub\Transformer\Base {
 		// If the current WordPress object is not a post (e.g., a WP_Comment), don't change the transformer.
 		if ( 'WP_Post' !== $object_class ) {
 			return $transformer;

templates/settings.php

@@ -62,13 +62,17 @@ $current_category_mapping        = \get_option( 'activitypub_event_bridge_event_
 			</table>
 
 			<?php if ( ! empty( $event_terms ) ) : ?>
-			<h3> <?php esc_html_e( 'Advanced Event Category Settings', 'activitypub-event-bridge' ); ?> </h3>
+			<h3> <?php esc_html_e( 'Fine-grained Event Category Settings', 'activitypub-event-bridge' ); ?> </h3>
-			<p> <?php esc_html_e( 'Take more control by adjusting how your event categories are mapped to the basic category set used in ActivityPub. This option lets you override the default selection above, ensuring more accurate categorization and better visibility for your events.', 'activitypub-event-bridge' ); ?> </p>
+			<p> <?php esc_html_e( 'For any event category you have created on your WordPress site you can choose an event category which will be used in federation. This option lets you override the default selection above. ', 'activitypub-event-bridge' ); ?> </p>
 			<table class="form-table">
+				<tr>
+					<th> <?php esc_html_e( 'Event category on your site', 'activitypub-event-bridge' ); ?> </th>
+					<th> <?php esc_html_e( 'Fediverse event category', 'activitypub-event-bridge' ); ?> </th>
+				</tr>
 				<?php foreach ( $event_terms as $event_term ) { ?>
 					<tr>
-						<th scope="row"> <?php echo esc_html( $event_term->name ); ?> </th>
+						<td scope="row"> <?php echo esc_html( $event_term->name ); ?> </td>
-						<td>
+						<td class="select-cell">
 							<select name="activitypub_event_bridge_event_category_mappings[<?php echo esc_attr( $event_term->slug ); ?>]">
 								<?php
 								$current_mapping_is_set = false;

templates/welcome.php

@@ -11,6 +11,7 @@ defined( 'ABSPATH' ) || exit; // @codeCoverageIgnore
 use ActivityPub_Event_Bridge\Setup;
 use ActivityPub_Event_Bridge\Admin\Settings_Page;
 use ActivityPub_Event_Bridge\Admin\Health_Check;
+use ActivityPub_Event_Bridge\Admin\General_Admin_Notices;
 
 \load_template(
 	__DIR__ . '/admin-header.php',
@@ -21,6 +22,11 @@ use ActivityPub_Event_Bridge\Admin\Health_Check;
 );
 
 $active_event_plugins               = Setup::get_instance()->get_active_event_plugins();
+
+if ( empty( $active_event_plugins ) ) {
+	return;
+}
+
 $activitypub_event_bridge_status_ok = true;
 $example_event_post                 = Health_Check::get_most_recent_event_posts();