WordPress.org

Make WordPress Core

Ticket #44354: 44354.5.diff

File 44354.5.diff, 7.4 KB (added by garrett-eclipse, 13 months ago)

Minor refresh to remove the return;

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

     
    3434         * Get columns to show in the list table.
    3535         *
    3636         * @since 4.9.6
     37         * @since 5.6.0 Added `manage_privacy_requests_columns` and
     38         *              `manage_{$this->request_type}_columns` filters.
    3739         *
    3840         * @return string[] Array of column titles keyed by their column name.
    3941         */
     
    4547                        'created_timestamp' => __( 'Requested' ),
    4648                        'next_steps'        => __( 'Next Steps' ),
    4749                );
    48                 return $columns;
     50
     51                /**
     52                 * Filters the columns displayed in the user privacy requests list tables.
     53                 *
     54                 * @since 5.6.0
     55                 *
     56                 * @param string[] $columns      An associative array of column headings.
     57                 * @param string   $request_type The user privacy request type.
     58                 */
     59                $columns = apply_filters( 'manage_privacy_requests_columns', $columns, $this->request_type );
     60
     61                /**
     62                 * Filters the columns displayed in the user privacy requests list table for a specific request type.
     63                 *
     64                 * The dynamic portion of the hook name, `$this->request_type`,
     65                 * refers to the user privacy request type.
     66                 *
     67                 * @since 5.6.0
     68                 *
     69                 * @param string[] $columns An associative array of column headings.
     70                 */
     71                return apply_filters( "manage_{$this->request_type}_columns", $columns );
    4972        }
    5073
    5174        /**
     
    320343        }
    321344
    322345        /**
     346         * Convert timestamp for display.
     347         *
     348         * @since 4.9.6
     349         *
     350         * @param int $timestamp Event timestamp.
     351         * @return string Human readable date.
     352         */
     353        protected function get_timestamp_as_date( $timestamp ) {
     354                if ( empty( $timestamp ) ) {
     355                        return '';
     356                }
     357
     358                $time_diff = time() - $timestamp;
     359
     360                if ( $time_diff >= 0 && $time_diff < DAY_IN_SECONDS ) {
     361                        /* translators: %s: Human-readable time difference. */
     362                        return sprintf( __( '%s ago' ), human_time_diff( $timestamp ) );
     363                }
     364
     365                return date_i18n( get_option( 'date_format' ), $timestamp );
     366        }
     367
     368        /**
     369         * Default column handler.
     370         *
     371         * @since 4.9.6
     372         * @since 5.6.0 Added `manage_privacy_request_custom_column` and
     373         *                    `manage_{$this->request_type}_custom_column` actions.
     374         *
     375         * @param WP_User_Request $item        The user privacy request item being shown.
     376         * @param string          $column_name Name of column being shown.
     377         */
     378        public function column_default( $item, $column_name ) {
     379                /**
     380                 * Fires for each custom column in the privacy requests list table.
     381                 *
     382                 * @since 5.6.0
     383                 *
     384                 * @param string          $column_name  The name of the column to display.
     385                 * @param WP_User_Request $item         The user privacy request item being shown.
     386                 * @param string          $request_type The user privacy request type.
     387                 */
     388                do_action( 'manage_privacy_request_custom_column', $column_name, $item, $this->request_type );
     389
     390                /**
     391                 * Fires for each custom column of a specific request type in the user privacy requests list table.
     392                 *
     393                 * The dynamic portion of the hook name, `$this->request_type`, refers to the user privacy request type.
     394                 *
     395                 * @since 5.6.0
     396                 *
     397                 * @param string          $column_name The name of the column to display.
     398                 * @param WP_User_Request $item        The user privacy request item being shown.
     399                 */
     400                do_action( "manage_{$this->request_type}_custom_column", $column_name, $item );
     401        }
     402
     403        /**
    323404         * Checkbox column.
    324405         *
    325406         * @since 4.9.6
    326407         *
    327          * @param WP_User_Request $item Item being shown.
     408         * @param WP_User_Request $item The user privacy request item being shown.
    328409         * @return string Checkbox column markup.
    329410         */
    330411        public function column_cb( $item ) {
     
    336417         *
    337418         * @since 4.9.6
    338419         *
    339          * @param WP_User_Request $item Item being shown.
     420         * @param WP_User_Request $item The user privacy request item being shown.
    340421         * @return string Status column markup.
    341422         */
    342423        public function column_status( $item ) {
     
    369450        }
    370451
    371452        /**
    372          * Convert timestamp for display.
     453         * Created timestamp column. Overridden by children.
    373454         *
    374          * @since 4.9.6
     455         * @since 5.6.0
    375456         *
    376          * @param int $timestamp Event timestamp.
     457         * @param WP_User_Request $item The user privacy request item being shown.
    377458         * @return string Human readable date.
    378459         */
    379         protected function get_timestamp_as_date( $timestamp ) {
    380                 if ( empty( $timestamp ) ) {
    381                         return '';
    382                 }
    383 
    384                 $time_diff = time() - $timestamp;
    385 
    386                 if ( $time_diff >= 0 && $time_diff < DAY_IN_SECONDS ) {
    387                         /* translators: %s: Human-readable time difference. */
    388                         return sprintf( __( '%s ago' ), human_time_diff( $timestamp ) );
    389                 }
    390 
    391                 return date_i18n( get_option( 'date_format' ), $timestamp );
     460        public function column_created_timestamp( $item ) {
     461                return $this->get_timestamp_as_date( $item->created_timestamp );
    392462        }
    393463
    394464        /**
    395          * Default column handler.
    396          *
    397          * @since 4.9.6
    398          *
    399          * @param WP_User_Request $item        Item being shown.
    400          * @param string          $column_name Name of column being shown.
    401          * @return string Default column output.
    402          */
    403         public function column_default( $item, $column_name ) {
    404                 $cell_value = $item->$column_name;
    405 
    406                 if ( in_array( $column_name, array( 'created_timestamp' ), true ) ) {
    407                         return $this->get_timestamp_as_date( $cell_value );
    408                 }
    409 
    410                 return $cell_value;
    411         }
    412 
    413         /**
    414465         * Actions column. Overridden by children.
    415466         *
    416467         * @since 4.9.6
    417468         *
    418          * @param WP_User_Request $item Item being shown.
     469         * @param WP_User_Request $item The user privacy request item being shown.
    419470         * @return string Email column markup.
    420471         */
    421472        public function column_email( $item ) {
     
    427478         *
    428479         * @since 4.9.6
    429480         *
    430          * @param WP_User_Request $item Item being shown.
     481         * @param WP_User_Request $item The user privacy request item being shown.
    431482         */
    432483        public function column_next_steps( $item ) {}
    433484
     
    436487         *
    437488         * @since 4.9.6
    438489         *
    439          * @param WP_User_Request $item The current item.
     490         * @param WP_User_Request $item The user privacy request item being shown.
    440491         */
    441492        public function single_row( $item ) {
    442493                $status = $item->status;
  • tests/qunit/fixtures/wp-api-generated.js

     
    44694469                        "attributes": {
    44704470                            "required": false,
    44714471                            "default": [],
    4472                             "description": "Attributes for the block",
     4472                            "description": "Attributes for the block.",
    44734473                            "type": "object"
    44744474                        },
    44754475                        "post_id": {
     
    45634563                    "args": {
    45644564                        "name": {
    45654565                            "required": false,
    4566                             "description": "Block name",
     4566                            "description": "Block name.",
    45674567                            "type": "string"
    45684568                        },
    45694569                        "namespace": {
    45704570                            "required": false,
    4571                             "description": "Block namespace",
     4571                            "description": "Block namespace.",
    45724572                            "type": "string"
    45734573                        },
    45744574                        "context": {