Feature 681: Adding uninstall method

includes/core/classes/class-setup.php

@@ -83,6 +83,7 @@
 	protected function setup_hooks(): void {
 		register_activation_hook( GATHERPRESS_CORE_FILE, array( $this, 'activate_gatherpress_plugin' ) );
 		register_deactivation_hook( GATHERPRESS_CORE_FILE, array( $this, 'deactivate_gatherpress_plugin' ) );
+		register_uninstall_hook( GATHERPRESS_CORE_FILE, array( 'GatherPress\Core\Setup', 'uninstall_gatherpress_plugin' ) );
 
 		add_action( 'init', array( $this, 'load_textdomain' ), 9 );
 		add_action( 'init', array( $this, 'maybe_flush_rewrite_rules' ) );
@@ -218,6 +219,83 @@
 		flush_rewrite_rules();
 	}
 
+	/**
+	 * Uninstalls the GatherPress plugin.
+	 *
+	 * @since 1.0.0
+	 *
+	 * @global wpdb $wpdb WordPress database abstraction object.
+	 *
+	 * @return void
+	 */
+	public static function uninstall_gatherpress_plugin() {
+		global $wpdb;
+
+		// Ensure the uninstallation script is called from within WordPress.
+		if ( ! defined( 'WP_UNINSTALL_PLUGIN' ) ) {
+			die;
+		}
+
+		// Check if the user opted to delete data on uninstall.
+		$settings    = Settings::get_instance();
+		$delete_data = $settings->get_value( 'general', 'general', 'delete_data_on_uninstall' );
+
+		// If the option is not enabled, exit early to prevent data on uninstall.
+		if( intval( $delete_data )  !== 1 ) {
+			return;
+		}
+
+		// GatherPress-specific options and transients to be deleted.
+		$option_names = array(
+			'gatherpress_flush_rewrite_rules_flag',
+			'gatherpress_general',
+			'gatherpress_suppress_site_notification'
+		);
+
+		// Delete options in single-site or multisite setup.
+		foreach ( $option_names as $option ) {
+			delete_option( $option );
+			if ( is_multisite() ) {
+				delete_site_option( $option );
+			}
+		}
+
+		// Drop custom tables for events and RSVPs.
+		$event_table = sprintf( Event::TABLE_FORMAT, $wpdb->prefix );
+		$rsvp_table  = sprintf( Rsvp::TABLE_FORMAT, $wpdb->prefix );
+
+		// Drop the tables if they exist.
+		$wpdb->query( "DROP TABLE IF EXISTS {$event_table}" );
+		$wpdb->query( "DROP TABLE IF EXISTS {$rsvp_table}" );
+
+		// Delete any custom taxonomies if required (like 'gatherpress_venue', 'gatherpress_event_category').
+		$taxonomies = array( 'gatherpress_venue', 'gatherpress_event_category' );
+
+		foreach ( $taxonomies as $taxonomy ) {
+			$terms = get_terms( array( 'taxonomy' => $taxonomy, 'hide_empty' => false ) );
+			if ( ! is_wp_error( $terms ) && ! empty( $terms ) ) {
+				foreach ( $terms as $term ) {
+					wp_delete_term( $term->term_id, $taxonomy );
+				}
+			}
+		}
+
+		// Remove user meta related to GatherPress.
+		$meta_keys = array(
+			'gatherpress_event_meta',
+			'gatherpress_venue_meta',
+			'gatherpress_rsvp_meta',
+		);
+
+		$meta_query = implode( ', ', array_fill( 0, count( $meta_keys ), '%s' ) );
+		$wpdb->query( $wpdb->prepare( "DELETE FROM $wpdb->usermeta WHERE meta_key IN ( {$meta_query} )", $meta_keys ) );
+
+		// Clear rewrite rules to remove any custom rewrites added by the plugin.
+		flush_rewrite_rules();
+	}
+
+
+
 	/**
 	 * Flush GatherPress rewrite rules if the previously added flag exists and then remove the flag.
 	 *

includes/core/classes/settings/class-general.php

@@ -159,6 +159,19 @@ protected function get_sections(): array {
 							),
 						),
 					),
+					'delete_data_on_uninstall' => array(
+						'labels'      => array(
+							'name' => __( 'Delete Data on Uninstall', 'gatherpress' ),
+						),
+						'description' => __( 'Check this box if you want all GatherPress data and settings to be removed when the plugin is uninstalled.', 'gatherpress' ),
+						'field'       => array(
+							'label'   => __( 'Delete all plugin data upon uninstall', 'gatherpress' ),
+							'type'    => 'checkbox',
+							'options' => array(
+								'default' => 0,
+							),
+						),
+					),
 				),
 			),
 			'formatting' => array(