Ticket #44354: 44354.3.diff

src/wp-admin/includes/class-wp-privacy-requests-table.php

@@ -34 +34 @@
          * Get columns to show in the list table.
          *
          * @since 4.9.6
+         * @since 5.6.0 Added `manage_privacy_requests_columns` and
+         *              `manage_{$this->request_type}_columns` filters.
          *
          * @return string[] Array of column titles keyed by their column name.
          */
@@ -45 +47 @@
                         'created_timestamp' => __( 'Requested' ),
                         'next_steps'        => __( 'Next Steps' ),
                 );
-                return $columns;
+
+                /**
+                 * Filters the columns displayed in the user privacy requests list tables.
+                 *
+                 * @since 5.6.0
+                 *
+                 * @param string[] $columns      An associative array of column headings.
+                 * @param string   $request_type The user privacy request type.
+                 */
+                $columns = apply_filters( 'manage_privacy_requests_columns', $columns, $this->request_type );
+
+                /**
+                 * Filters the columns displayed in the user privacy requests list table for a specific request type.
+                 *
+                 * The dynamic portion of the hook name, `$this->request_type`, 
+                 * refers to the user privacy request type.
+                 *
+                 * @since 5.6.0
+                 *
+                 * @param string[] $columns An associative array of column headings.
+                 */
+                return apply_filters( "manage_{$this->request_type}_columns", $columns );
         }
 
         /**
@@ -320 +343 @@
         }
 
         /**
+         * Convert timestamp for display.
+         *
+         * @since 4.9.6
+         *
+         * @param int $timestamp Event timestamp.
+         * @return string Human readable date.
+         */
+        protected function get_timestamp_as_date( $timestamp ) {
+                if ( empty( $timestamp ) ) {
+                        return '';
+                }
+
+                $time_diff = time() - $timestamp;
+
+                if ( $time_diff >= 0 && $time_diff < DAY_IN_SECONDS ) {
+                        /* translators: %s: Human-readable time difference. */
+                        return sprintf( __( '%s ago' ), human_time_diff( $timestamp ) );
+                }
+
+                return date_i18n( get_option( 'date_format' ), $timestamp );
+        }
+
+        /**
+         * Default column handler.
+         *
+         * @since 4.9.6
+         * @since 5.6.0 Added `manage_privacy_request_custom_column` and
+         *                    `manage_{$this->request_type}_custom_column` actions.
+         *
+         * @param WP_User_Request $item        The user privacy request item being shown.
+         * @param string          $column_name Name of column being shown.
+         */
+        public function column_default( $item, $column_name ) {
+                /**
+                 * Fires for each custom column in the privacy requests list table.
+                 *
+                 * @since 5.6.0
+                 *
+                 * @param string          $column_name  The name of the column to display.
+                 * @param WP_User_Request $item         The user privacy request item being shown.
+                 * @param string          $request_type The user privacy request type.
+                 */
+                do_action( 'manage_privacy_request_custom_column', $column_name, $item, $this->request_type );
+
+                /**
+                 * Fires for each custom column of a specific request type in the user privacy requests list table.
+                 *
+                 * The dynamic portion of the hook name, `$this->request_type`, refers to the user privacy request type.
+                 *
+                 * @since 5.6.0
+                 *
+                 * @param string          $column_name The name of the column to display.
+                 * @param WP_User_Request $item        The user privacy request item being shown.
+                 */
+                do_action( "manage_{$this->request_type}_custom_column", $column_name, $item );
+                return;
+        }
+
+        /**
          * Checkbox column.
          *
          * @since 4.9.6
          *
-         * @param WP_User_Request $item Item being shown.
+         * @param WP_User_Request $item The user privacy request item being shown.
          * @return string Checkbox column markup.
          */
         public function column_cb( $item ) {
@@ -336 +418 @@
          *
          * @since 4.9.6
          *
-         * @param WP_User_Request $item Item being shown.
+         * @param WP_User_Request $item The user privacy request item being shown.
          * @return string Status column markup.
          */
         public function column_status( $item ) {
@@ -369 +451 @@
         }
 
         /**
-         * Convert timestamp for display.
+         * Created timestamp column. Overridden by children.
          *
-         * @since 4.9.6
+         * @since 5.6.0
          *
-         * @param int $timestamp Event timestamp.
+         * @param WP_User_Request $item The user privacy request item being shown.
          * @return string Human readable date.
          */
-        protected function get_timestamp_as_date( $timestamp ) {
-                if ( empty( $timestamp ) ) {
-                        return '';
-                }
-
-                $time_diff = time() - $timestamp;
-
-                if ( $time_diff >= 0 && $time_diff < DAY_IN_SECONDS ) {
-                        /* translators: %s: Human-readable time difference. */
-                        return sprintf( __( '%s ago' ), human_time_diff( $timestamp ) );
-                }
-
-                return date_i18n( get_option( 'date_format' ), $timestamp );
+        public function column_created_timestamp( $item ) {
+                return $this->get_timestamp_as_date( $item->created_timestamp );
         }
 
         /**
-         * Default column handler.
-         *
-         * @since 4.9.6
-         *
-         * @param WP_User_Request $item        Item being shown.
-         * @param string          $column_name Name of column being shown.
-         * @return string Default column output.
-         */
-        public function column_default( $item, $column_name ) {
-                $cell_value = $item->$column_name;
-
-                if ( in_array( $column_name, array( 'created_timestamp' ), true ) ) {
-                        return $this->get_timestamp_as_date( $cell_value );
-                }
-
-                return $cell_value;
-        }
-
-        /**
          * Actions column. Overridden by children.
          *
          * @since 4.9.6
          *
-         * @param WP_User_Request $item Item being shown.
+         * @param WP_User_Request $item The user privacy request item being shown.
          * @return string Email column markup.
          */
         public function column_email( $item ) {
@@ -427 +479 @@
          *
          * @since 4.9.6
          *
-         * @param WP_User_Request $item Item being shown.
+         * @param WP_User_Request $item The user privacy request item being shown.
          */
         public function column_next_steps( $item ) {}
 
@@ -436 +488 @@
          *
          * @since 4.9.6
          *
-         * @param WP_User_Request $item The current item.
+         * @param WP_User_Request $item The user privacy request item being shown.
          */
         public function single_row( $item ) {
                 $status = $item->status;