feat: trash (soft delete)

src/js/components/EditorSidebar/actions/DeleteButton.tsx

@@ -26,7 +26,7 @@ export const DeleteButton: React.FC = () => {
 
 			<ConfirmDialog
 				open={isDialogOpen}
-				title={__('Permanently delete?', 'code-snippets')}
+				title={__('Delete?', 'code-snippets')}
 				confirmLabel={__('Delete', 'code-snippets')}
 				confirmButtonClassName="is-destructive"
 				onCancel={() => setIsDialogOpen(false)}
@@ -43,10 +43,9 @@ export const DeleteButton: React.FC = () => {
 				}}
 			>
 				<p style={{ marginBlockStart: 0 }}>
-					{__('You are about to permanently delete this snippet.', 'code-snippets')}{' '}
+					{__('You are about to delete this snippet.', 'code-snippets')}{' '}
 					{__('Are you sure?', 'code-snippets')}
 				</p>
-				<p><strong>{__('This action cannot be undone.', 'code-snippets')}</strong></p>
 			</ConfirmDialog>
 		</>
 	)

src/php/class-list-table.php

@@ -37,7 +37,7 @@ class List_Table extends WP_List_Table {
 	 *
 	 * @var array<string>
 	 */
-	public array $statuses = [ 'all', 'active', 'inactive', 'recently_activated' ];
+	public array $statuses = [ 'all', 'active', 'inactive', 'recently_activated', 'trashed' ];
 
 	/**
 	 * Column name to use when ordering the snippets list.
@@ -246,7 +246,26 @@ public function get_action_link( string $action, Snippet $snippet ): string {
 	private function get_snippet_action_links( Snippet $snippet ): array {
 		$actions = array();
 
-		if ( ! $this->is_network && $snippet->network && ! $snippet->shared_network ) {
+		if ( $snippet->is_trashed() ) {
+			$actions['restore'] = sprintf(
+				'<a href="%s">%s</a>',
+				esc_url( $this->get_action_link( 'restore', $snippet ) ),
+				esc_html__( 'Restore', 'code-snippets' )
+			);
+
+			$actions['delete_permanently'] = sprintf(
+				'<a href="%2$s" class="delete" onclick="%3$s">%1$s</a>',
+				esc_html__( 'Delete Permanently', 'code-snippets' ),
+				esc_url( $this->get_action_link( 'delete_permanently', $snippet ) ),
+				esc_js(
+					sprintf(
+						'return confirm("%s");',
+						esc_html__( 'You are about to permanently delete the selected item.', 'code-snippets' ) . "\n" .
+						esc_html__( "'Cancel' to stop, 'OK' to delete.", 'code-snippets' )
+					)
+				)
+			);
+		} elseif ( ! $this->is_network && $snippet->network && ! $snippet->shared_network ) {
 			// Display special links if on a subsite and dealing with a network-active snippet.
 			if ( $snippet->active ) {
 				$actions['network_active'] = esc_html__( 'Network Active', 'code-snippets' );
@@ -267,16 +286,9 @@ private function get_snippet_action_links( Snippet $snippet ): array {
 			}
 
 			$actions['delete'] = sprintf(
-				'<a href="%2$s" class="delete" onclick="%3$s">%1$s</a>',
+				'<a href="%2$s" class="delete">%1$s</a>',
 				esc_html__( 'Delete', 'code-snippets' ),
-				esc_url( $this->get_action_link( 'delete', $snippet ) ),
-				esc_js(
-					sprintf(
-						'return confirm("%s");',
-						esc_html__( 'You are about to permanently delete the selected item.', 'code-snippets' ) . "\n" .
-						esc_html__( "'Cancel' to stop, 'OK' to delete.", 'code-snippets' )
-					)
-				)
+				esc_url( $this->get_action_link( 'delete', $snippet ) )
 			);
 		}
 
@@ -291,6 +303,10 @@ private function get_snippet_action_links( Snippet $snippet ): array {
 	 * @return string Output for activation switch.
 	 */
 	protected function column_activate( Snippet $snippet ): string {
+		if ( $snippet->is_trashed() ) {
+			return '';
+		}
+
 		if ( $this->is_network && ( $snippet->shared_network || ( ! $this->is_network && $snippet->network && ! $snippet->shared_network ) ) ) {
 			return '';
 		}
@@ -352,8 +368,8 @@ protected function column_name( Snippet $snippet ): string {
 
 		$out = esc_html( $snippet->display_name );
 
-		// Add a link to the snippet if it isn't an unreadable network-only snippet.
-		if ( $this->is_network || ! $snippet->network || current_user_can( code_snippets()->get_network_cap_name() ) ) {
+		// Add a link to the snippet if it isn't an unreadable network-only snippet and isn't trashed.
+		if ( ! $snippet->is_trashed() && ( $this->is_network || ! $snippet->network || current_user_can( code_snippets()->get_network_cap_name() ) ) ) {
 			$out = sprintf(
 				'<a href="%s" class="snippet-name">%s</a>',
 				esc_attr( code_snippets()->get_snippet_edit_url( $snippet->id, $snippet->network ? 'network' : 'admin' ) ),
@@ -482,14 +498,23 @@ public function get_sortable_columns(): array {
 	 * @return array<string, string> An array of menu items with the ID paired to the label
 	 */
 	public function get_bulk_actions(): array {
-		$actions = [
-			'activate-selected'   => $this->is_network ? __( 'Network Activate', 'code-snippets' ) : __( 'Activate', 'code-snippets' ),
-			'deactivate-selected' => $this->is_network ? __( 'Network Deactivate', 'code-snippets' ) : __( 'Deactivate', 'code-snippets' ),
-			'clone-selected'      => __( 'Clone', 'code-snippets' ),
-			'download-selected'   => __( 'Export Code', 'code-snippets' ),
-			'export-selected'     => __( 'Export', 'code-snippets' ),
-			'delete-selected'     => __( 'Delete', 'code-snippets' ),
-		];
+		global $status;
+
+		if ( 'trashed' === $status ) {
+			$actions = [
+				'restore-selected'           => __( 'Restore', 'code-snippets' ),
+				'delete-permanently-selected' => __( 'Delete Permanently', 'code-snippets' ),
+			];
+		} else {
+			$actions = [
+				'activate-selected'   => $this->is_network ? __( 'Network Activate', 'code-snippets' ) : __( 'Activate', 'code-snippets' ),
+				'deactivate-selected' => $this->is_network ? __( 'Network Deactivate', 'code-snippets' ) : __( 'Deactivate', 'code-snippets' ),
+				'clone-selected'      => __( 'Clone', 'code-snippets' ),
+				'download-selected'   => __( 'Export Code', 'code-snippets' ),
+				'export-selected'     => __( 'Export', 'code-snippets' ),
+				'delete-selected'     => __( 'Delete', 'code-snippets' ),
+			];
+		}
 
 		return apply_filters( 'code_snippets/list_table/bulk_actions', $actions );
 	}
@@ -558,6 +583,14 @@ public function get_views(): array {
 				'code-snippets'
 			);
 
+			// translators: %s: total number of trashed snippets.
+			$labels['trashed'] = _n(
+				'Trashed <span class="count">(%s)</span>',
+				'Trashed <span class="count">(%s)</span>',
+				$count,
+				'code-snippets'
+			);
+
 			// The page URL with the status parameter.
 			$url = esc_url( add_query_arg( 'status', $type ) );
 
@@ -737,9 +770,17 @@ private function perform_action( int $id, string $action ) {
 				return 'cloned';
 
 			case 'delete':
-				delete_snippet( $id, $this->is_network );
+				soft_delete_snippet( $id, $this->is_network );
 				return 'deleted';
 
+			case 'restore':
+				restore_snippet( $id, $this->is_network );
+				return 'restored';
+
+			case 'delete_permanently':
+				delete_snippet( $id, $this->is_network );
+				return 'deleted_permanently';
+
 			case 'export':
 				$export = new Export_Attachment( [ $id ], $this->is_network );
 				$export->download_snippets_json();
@@ -860,10 +901,24 @@ public function process_requested_actions() {
 
 			case 'delete-selected':
 				foreach ( $ids as $id ) {
-					delete_snippet( $id, $this->is_network );
+					soft_delete_snippet( $id, $this->is_network );
 				}
 				$result = 'deleted-multi';
 				break;
+
+			case 'restore-selected':
+				foreach ( $ids as $id ) {
+					restore_snippet( $id, $this->is_network );
+				}
+				$result = 'restored-multi';
+				break;
+
+			case 'delete-permanently-selected':
+				foreach ( $ids as $id ) {
+					delete_snippet( $id, $this->is_network );
+				}
+				$result = 'deleted-permanently-multi';
+				break;
 		}
 
 		if ( isset( $result ) ) {
@@ -978,9 +1033,19 @@ public function prepare_items() {
 		$this->process_requested_actions();
 		$snippets = array_fill_keys( $this->statuses, array() );
 
-		$snippets['all'] = apply_filters( 'code_snippets/list_table/get_snippets', get_snippets() );
+		$all_snippets = apply_filters( 'code_snippets/list_table/get_snippets', get_snippets() );
 		$this->fetch_shared_network_snippets();
 
+		// Separate trashed snippets from the main collection
+		$snippets['trashed'] = array_filter( $all_snippets, function( $snippet ) {
+			return $snippet->is_trashed();
+		});
+
+		// Filter out trashed snippets from the 'all' collection
+		$snippets['all'] = array_filter( $all_snippets, function( $snippet ) {
+			return ! $snippet->is_trashed();
+		});
+
 		foreach ( $snippets['all'] as $snippet ) {
 			if ( $snippet->active ) {
 				$this->active_by_condition[ $snippet->condition_id ][] = $snippet;
@@ -997,23 +1062,39 @@ function ( Snippet $snippet ) use ( $type ) {
 					return $type === $snippet->type;
 				}
 			);
+
+			// Filter trashed snippets by type
+			$snippets['trashed'] = array_filter(
+				$snippets['trashed'],
+				function ( Snippet $snippet ) use ( $type ) {
+					return $type === $snippet->type;
+				}
+			);
 		}
 
-		// Add scope tags.
+		// Add scope tags to all snippets (including trashed).
 		foreach ( $snippets['all'] as $snippet ) {
 			if ( 'global' !== $snippet->scope ) {
 				$snippet->add_tag( $snippet->scope );
 			}
 		}
+
+		foreach ( $snippets['trashed'] as $snippet ) {
+			if ( 'global' !== $snippet->scope ) {
+				$snippet->add_tag( $snippet->scope );
+			}
+		}
 
 		// Filter snippets by tag.
 		if ( ! empty( $_GET['tag'] ) ) {
 			$snippets['all'] = array_filter( $snippets['all'], array( $this, 'tags_filter_callback' ) );
+			$snippets['trashed'] = array_filter( $snippets['trashed'], array( $this, 'tags_filter_callback' ) );
 		}
 
 		// Filter snippets based on search query.
 		if ( $s ) {
 			$snippets['all'] = array_filter( $snippets['all'], array( $this, 'search_by_line_callback' ) );
+			$snippets['trashed'] = array_filter( $snippets['trashed'], array( $this, 'search_by_line_callback' ) );
 		}
 
 		// Clear recently activated snippets older than a week.
@@ -1037,6 +1118,11 @@ function ( Snippet $snippet ) use ( $type ) {
 		 * @var Snippet $snippet
 		 */
 		foreach ( $snippets['all'] as $snippet ) {
+			// Skip trashed snippets (they're already in their own section)
+			if ( $snippet->is_trashed() ) {
+				continue;
+			}
+
 			if ( $snippet->active || $this->is_condition_active( $snippet ) ) {
 				$snippets['active'][] = $snippet;
 			} else {
@@ -1310,7 +1396,6 @@ public function search_notice() {
 	 */
 	public function single_row( $item ) {
 		$status = $item->active || $this->is_condition_active( $item ) ? 'active' : 'inactive';
-
 		$row_class = "snippet $status-snippet $item->type-snippet $item->scope-scope";
 
 		if ( $item->shared_network ) {

src/php/class-snippet.php

@@ -50,12 +50,25 @@ class Snippet extends Data_Item {
 	 */
 	public const DEFAULT_DATE = '0000-00-00 00:00:00';
 
+	/**
+	 * Raw active value from database before processing.
+	 *
+	 * @var mixed
+	 */
+	private $raw_active_value;
+
 	/**
 	 * Constructor function.
 	 *
 	 * @param array<string, mixed>|object $initial_data Initial snippet data.
 	 */
 	public function __construct( $initial_data = null ) {
+		if ( is_array( $initial_data ) && isset( $initial_data['active'] ) ) {
+			$this->raw_active_value = $initial_data['active'];
+		} elseif ( is_object( $initial_data ) && isset( $initial_data->active ) ) {
+			$this->raw_active_value = $initial_data->active;
+		}
+
 		$default_values = array(
 			'id'             => 0,
 			'name'           => '',
@@ -101,6 +114,15 @@ public function is_condition(): bool {
 		return 'condition' === $this->scope;
 	}
 
+	/**
+	 * Determine if the snippet is trashed (soft deleted).
+	 *
+	 * @return bool
+	 */
+	public function is_trashed(): bool {
+		return '-1' === (string) $this->raw_active_value || -1 === (int) $this->raw_active_value;
+	}
+
 	/**
 	 * Prepare a value before it is stored.
 	 *
@@ -120,7 +142,7 @@ protected function prepare_field( $value, string $field ) {
 				return code_snippets_build_tags_array( $value );
 
 			case 'active':
-				return ( is_bool( $value ) ? $value : (bool) $value ) && ! $this->is_condition();
+				return ( is_bool( $value ) ? $value : (bool) $value ) && ! $this->is_condition() && (int) $value != -1;
 
 			default:
 				return $value;

src/php/rest-api/class-snippets-rest-controller.php

@@ -12,7 +12,7 @@
 use function Code_Snippets\activate_snippet;
 use function Code_Snippets\code_snippets;
 use function Code_Snippets\deactivate_snippet;
-use function Code_Snippets\delete_snippet;
+use function Code_Snippets\soft_delete_snippet;
 use function Code_Snippets\get_snippet;
 use function Code_Snippets\get_snippets;
 use function Code_Snippets\save_snippet;
@@ -282,15 +282,15 @@ public function update_item( $request ) {
 	}
 
 	/**
-	 * Delete one item from the collection
+	 * Delete one item from the collection (soft delete)
 	 *
 	 * @param WP_REST_Request $request Full data about the request.
 	 *
 	 * @return WP_Error|WP_REST_Response
 	 */
 	public function delete_item( $request ) {
 		$item = $this->prepare_item_for_database( $request );
-		$result = delete_snippet( $item->id, $item->network );
+		$result = soft_delete_snippet( $item->id, $item->network );
 
 		return $result ?
 			new WP_REST_Response( null, 204 ) :