feat: add Screen Options for customisable log entries per page

The Syndication Logs page now supports WordPress Screen Options, allowing users to configure how many log entries they see per page (defaulting to 20). This brings the UX in line with standard WordPress admin tables like Posts, making the interface more familiar and customisable for users managing large numbers of syndication logs.

Author: GaryJones

includes/class-syndication-logger-viewer.php

@@ -181,7 +181,7 @@ public function prepare_items() {
 		usort( $filtered_data, array( $this, 'usort_reorder' ) );
 
 		// Paginate the filtered and sorted data.
-		$per_page = $this->get_items_per_page( 'per_page' );
+		$per_page = $this->get_items_per_page( 'syndication_logs_per_page', 20 );
 		$current_page = $this->get_pagenum();
 		$total_items = count( $filtered_data );
 
@@ -287,18 +287,45 @@ class Syndication_Logger_Viewer {
 
 	public function __construct() {
 		add_action( 'admin_menu', array( $this, 'add_menu_items' ) );
+		add_filter( 'set-screen-option', array( $this, 'set_screen_option' ), 10, 3 );
 	}
 
 	public function add_menu_items(){
 		$hook = add_submenu_page( 'edit.php?post_type=syn_site', 'Logs', 'Logs', 'activate_plugins', 'syndication_dashboard', array( $this, 'render_list_page' ) );
 		add_action( "load-$hook", array( $this, 'initialize_list_table' ) );
 	}
 
+	/**
+	 * Save the screen option value when submitted.
+	 *
+	 * @param mixed  $status The current status (false by default).
+	 * @param string $option The option name.
+	 * @param mixed  $value  The option value.
+	 * @return mixed The value to save, or $status to skip saving.
+	 */
+	public function set_screen_option( $status, $option, $value ) {
+		if ( 'syndication_logs_per_page' === $option ) {
+			return absint( $value );
+		}
+		return $status;
+	}
+
 	public function initialize_list_table() {
 		if ( ! empty( $_POST['log_id'] ) && ( empty( $_GET['log_id'] ) || esc_attr( $_GET['log_id'] ) != esc_attr( $_POST['log_id'] ) ) ) {
 			wp_safe_redirect( add_query_arg( array( 'log_id' => esc_attr( $_REQUEST['log_id'] ) ), wp_unslash($_SERVER['REQUEST_URI'] ) ) );
 			exit;
 		}
+
+		// Add screen options for items per page.
+		add_screen_option(
+			'per_page',
+			array(
+				'label'   => __( 'Log entries', 'push-syndication' ),
+				'default' => 20,
+				'option'  => 'syndication_logs_per_page',
+			)
+		);
+
 		$this->syndication_logger_table = new Syndication_Logger_List_Table();
 	}