WordPress.org
Get WordPress

Make WordPress Core


Ignore:
Timestamp:
05/01/2018 11:41:37 PM (6 years ago)
Author:
SergeyBiryukov
Message:

Privacy: add new wp-admin screens for exporting and removing of personal data.

Props melchoyce, mikejolley, allendav, xkon.
Merges [42967] to the 4.9 branch.
See #43481.

Location:
branches/4.9
Files:
2 edited

Legend:

Unmodified
Added
Removed

  • branches/4.9

  • branches/4.9/src/wp-admin/includes/user.php

    r41686 r43071  
    539539%%s' ), wp_specialchars_decode( get_bloginfo( 'name' ), ENT_QUOTES ), home_url(), wp_specialchars_decode( translate_user_role( $role['name'] ) ) );
    540540}
     541
     542/**
     543 * Get action description from the name.
     544 *
     545 * @since 5.0.0
     546 * @access private
     547 *
     548 * @return string
     549 */
     550function _wp_privacy_action_description( $request_type ) {
     551    switch ( $request_type ) {
     552        case 'user_export_request':
     553            return __( 'Export Personal Data' );
     554        case 'user_remove_request':
     555            return __( 'Remove Personal Data' );
     556    }
     557}
     558
     559/**
     560 * Log a request and send to the user.
     561 *
     562 * @since 5.0.0
     563 * @access private
     564 *
     565 * @param string $email_address Email address sending the request to.
     566 * @param string $action Action being requested.
     567 * @param string $description Description of request.
     568 * @return bool|WP_Error depending on success.
     569 */
     570function _wp_privacy_create_request( $email_address, $action, $description ) {
     571    $user_id = 0;
     572    $user    = get_user_by( 'email', $email_address );
     573
     574    if ( $user ) {
     575        $user_id = $user->ID;
     576    }
     577
     578    $privacy_request_id = wp_insert_post( array(
     579        'post_author'   => $user_id,
     580        'post_status'   => 'request-pending',
     581        'post_type'     => $action,
     582        'post_date'     => current_time( 'mysql', false ),
     583        'post_date_gmt' => current_time( 'mysql', true ),
     584    ), true );
     585
     586    if ( is_wp_error( $privacy_request_id ) ) {
     587        return $privacy_request_id;
     588    }
     589
     590    update_post_meta( $privacy_request_id, '_user_email', $email_address );
     591    update_post_meta( $privacy_request_id, '_action_name', $action );
     592    update_post_meta( $privacy_request_id, '_confirmed_timestamp', false );
     593
     594    return wp_send_account_verification_key( $email_address, $action, $description, array(
     595        'privacy_request_id' => $privacy_request_id,
     596    ) );
     597}
     598
     599/**
     600 * Resend an existing request and return the result.
     601 *
     602 * @since 5.0.0
     603 * @access private
     604 *
     605 * @param int $privacy_request_id Request ID.
     606 * @return bool|WP_Error
     607 */
     608function _wp_privacy_resend_request( $privacy_request_id ) {
     609    $privacy_request_id = absint( $privacy_request_id );
     610    $privacy_request    = get_post( $privacy_request_id );
     611
     612    if ( ! $privacy_request || ! in_array( $privacy_request->post_type, _wp_privacy_action_request_types(), true ) ) {
     613        return new WP_Error( 'privacy_request_error', __( 'Invalid request.' ) );
     614    }
     615
     616    $email_address = get_post_meta( $privacy_request_id, '_user_email', true );
     617    $action        = get_post_meta( $privacy_request_id, '_action_name', true );
     618    $description   = _wp_privacy_action_description( $action );
     619    $result        = wp_send_account_verification_key( $email_address, $action, $description, array(
     620        'privacy_request_id' => $privacy_request_id,
     621    ) );
     622
     623    if ( is_wp_error( $result ) ) {
     624        return $result;
     625    } elseif ( ! $result ) {
     626        return new WP_Error( 'privacy_request_error', __( 'Unable to initiate confirmation request.' ) );
     627    }
     628
     629    wp_update_post( array(
     630        'ID'            => $privacy_request_id,
     631        'post_status'   => 'request-pending',
     632        'post_date'     => current_time( 'mysql', false ),
     633        'post_date_gmt' => current_time( 'mysql', true ),
     634    ) );
     635
     636    return true;
     637}
     638
     639/**
     640 * Marks a request as completed by the admin and logs the datetime.
     641 *
     642 * @since 5.0.0
     643 * @access private
     644 *
     645 * @param int $privacy_request_id Request ID.
     646 * @return bool|WP_Error
     647 */
     648function _wp_privacy_completed_request( $privacy_request_id ) {
     649    $privacy_request_id = absint( $privacy_request_id );
     650    $privacy_request    = get_post( $privacy_request_id );
     651
     652    if ( ! $privacy_request || ! in_array( $privacy_request->post_type, _wp_privacy_action_request_types(), true ) ) {
     653        return new WP_Error( 'privacy_request_error', __( 'Invalid request.' ) );
     654    }
     655
     656    wp_update_post( array(
     657        'ID'          => $privacy_request_id,
     658        'post_status' => 'request-completed',
     659    ) );
     660
     661    update_post_meta( $privacy_request_id, '_completed_timestamp', time() );
     662}
     663
     664/**
     665 * Handle list table actions.
     666 *
     667 * @since 5.0.0
     668 * @access private
     669 */
     670function _wp_personal_data_handle_actions() {
     671    if ( isset( $_POST['export_personal_data_email_retry'] ) ) { // WPCS: input var ok.
     672        check_admin_referer( 'bulk-privacy_requests' );
     673
     674        $request_id = absint( current( array_keys( (array) wp_unslash( $_POST['export_personal_data_email_retry'] ) ) ) ); // WPCS: input var ok, sanitization ok.
     675        $result     = _wp_privacy_resend_request( $request_id );
     676
     677        if ( is_wp_error( $result ) ) {
     678            add_settings_error(
     679                'export_personal_data_email_retry',
     680                'export_personal_data_email_retry',
     681                $result->get_error_message(),
     682                'error'
     683            );
     684        } else {
     685            add_settings_error(
     686                'export_personal_data_email_retry',
     687                'export_personal_data_email_retry',
     688                __( 'Confirmation request re-resent successfully.' ),
     689                'updated'
     690            );
     691        }
     692
     693    } elseif ( isset( $_POST['export_personal_data_email_send'] ) ) { // WPCS: input var ok.
     694        check_admin_referer( 'bulk-privacy_requests' );
     695
     696        $request_id = absint( current( array_keys( (array) wp_unslash( $_POST['export_personal_data_email_send'] ) ) ) ); // WPCS: input var ok, sanitization ok.
     697        $result     = false;
     698
     699        /**
     700         * TODO: Email the data to the user here.
     701         */
     702
     703        if ( is_wp_error( $result ) ) {
     704            add_settings_error(
     705                'export_personal_data_email_send',
     706                'export_personal_data_email_send',
     707                $result->get_error_message(),
     708                'error'
     709            );
     710        } else {
     711            _wp_privacy_completed_request( $request_id );
     712            add_settings_error(
     713                'export_personal_data_email_send',
     714                'export_personal_data_email_send',
     715                __( 'Personal data was sent to the user successfully.' ),
     716                'updated'
     717            );
     718        }
     719
     720    } elseif ( isset( $_POST['action'] ) ) {
     721        $action = isset( $_POST['action'] ) ? sanitize_key( wp_unslash( $_POST['action'] ) ) : ''; // WPCS: input var ok, CSRF ok.
     722
     723        switch ( $action ) {
     724            case 'add_export_personal_data_request':
     725            case 'add_remove_personal_data_request':
     726                check_admin_referer( 'personal-data-request' );
     727
     728                if ( ! isset( $_POST['type_of_action'], $_POST['username_or_email_to_export'] ) ) { // WPCS: input var ok.
     729                    add_settings_error(
     730                        'action_type',
     731                        'action_type',
     732                        __( 'Invalid action.' ),
     733                        'error'
     734                    );
     735                }
     736                $action_type               = sanitize_text_field( wp_unslash( $_POST['type_of_action'] ) ); // WPCS: input var ok.
     737                $username_or_email_address = sanitize_text_field( wp_unslash( $_POST['username_or_email_to_export'] ) ); // WPCS: input var ok.
     738                $email_address             = '';
     739
     740                if ( ! in_array( $action_type, _wp_privacy_action_request_types(), true ) ) {
     741                    add_settings_error(
     742                        'action_type',
     743                        'action_type',
     744                        __( 'Invalid action.' ),
     745                        'error'
     746                    );
     747                }
     748
     749                if ( ! is_email( $username_or_email_address ) ) {
     750                    $user = get_user_by( 'login', $username_or_email_address );
     751                    if ( ! $user instanceof WP_User ) {
     752                        add_settings_error(
     753                            'username_or_email_to_export',
     754                            'username_or_email_to_export',
     755                            __( 'Unable to add export request. A valid email address or username must be supplied.' ),
     756                            'error'
     757                        );
     758                    } else {
     759                        $email_address = $user->user_email;
     760                    }
     761                } else {
     762                    $email_address = $username_or_email_address;
     763                }
     764
     765                if ( ! empty( $email_address ) ) {
     766                    $result = _wp_privacy_create_request( $email_address, $action_type, _wp_privacy_action_description( $action_type ) );
     767
     768                    if ( is_wp_error( $result ) ) {
     769                        add_settings_error(
     770                            'username_or_email_to_export',
     771                            'username_or_email_to_export',
     772                            $result->get_error_message(),
     773                            'error'
     774                        );
     775                    } elseif ( ! $result ) {
     776                        add_settings_error(
     777                            'username_or_email_to_export',
     778                            'username_or_email_to_export',
     779                            __( 'Unable to initiate confirmation request.' ),
     780                            'error'
     781                        );
     782                    } else {
     783                        add_settings_error(
     784                            'username_or_email_to_export',
     785                            'username_or_email_to_export',
     786                            __( 'Confirmation request initiated successfully.' ),
     787                            'updated'
     788                        );
     789                    }
     790                }
     791                break;
     792        }
     793    }
     794}
     795
     796/**
     797 * Personal data export.
     798 *
     799 * @since 5.0.0
     800 * @access private
     801 */
     802function _wp_personal_data_export_page() {
     803    if ( ! current_user_can( 'manage_options' ) ) {
     804        wp_die( esc_html__( 'Sorry, you are not allowed to manage privacy on this site.' ) );
     805    }
     806
     807    _wp_personal_data_handle_actions();
     808
     809    $requests_table = new WP_Privacy_Data_Export_Requests_Table( array(
     810        'plural'   => 'privacy_requests',
     811        'singular' => 'privacy_request',
     812    ) );
     813    $requests_table->process_bulk_action();
     814    $requests_table->prepare_items();
     815    ?>
     816    <div class="wrap nosubsub">
     817        <h1><?php esc_html_e( 'Export Personal Data' ); ?></h1>
     818        <hr class="wp-header-end" />
     819
     820        <?php settings_errors(); ?>
     821
     822        <form method="post" class="wp-privacy-request-form">
     823            <h2><?php esc_html_e( 'Add Data Export Request' ); ?></h2>
     824            <p><?php esc_html_e( 'An email will be sent to the user at this email address asking them to verify the request.' ); ?></p>
     825
     826            <div class="wp-privacy-request-form-field">
     827                <label for="username_or_email_to_export"><?php esc_html_e( 'Username or email address' ); ?></label>
     828                <input type="text" required class="regular-text" id="username_or_email_to_export" name="username_or_email_to_export" />
     829                <?php submit_button( __( 'Send Request' ), 'secondary', 'submit', false ); ?>
     830            </div>
     831            <?php wp_nonce_field( 'personal-data-request' ); ?>
     832            <input type="hidden" name="action" value="add_export_personal_data_request" />
     833            <input type="hidden" name="type_of_action" value="user_export_request" />
     834        </form>
     835        <hr />
     836
     837        <?php $requests_table->views(); ?>
     838
     839        <form class="search-form wp-clearfix">
     840            <?php $requests_table->search_box( __( 'Search Requests' ), 'requests' ); ?>
     841            <input type="hidden" name="page" value="export_personal_data" />
     842            <input type="hidden" name="filter-status" value="<?php echo isset( $_REQUEST['filter-status'] ) ? esc_attr( sanitize_text_field( $_REQUEST['filter-status'] ) ) : ''; ?>" />
     843            <input type="hidden" name="orderby" value="<?php echo isset( $_REQUEST['orderby'] ) ? esc_attr( sanitize_text_field( $_REQUEST['orderby'] ) ) : ''; ?>" />
     844            <input type="hidden" name="order" value="<?php echo isset( $_REQUEST['order'] ) ? esc_attr( sanitize_text_field( $_REQUEST['order'] ) ) : ''; ?>" />
     845        </form>
     846
     847        <form method="post">
     848            <?php
     849            $requests_table->display();
     850            $requests_table->embed_scripts();
     851            ?>
     852        </form>
     853    </div>
     854    <?php
     855}
     856
     857/**
     858 * Personal data anonymization.
     859 *
     860 * @since 5.0.0
     861 * @access private
     862 */
     863function _wp_personal_data_removal_page() {
     864    if ( ! current_user_can( 'manage_options' ) ) {
     865        wp_die( esc_html__( 'Sorry, you are not allowed to manage privacy on this site.' ) );
     866    }
     867
     868    _wp_personal_data_handle_actions();
     869
     870    $requests_table = new WP_Privacy_Data_Removal_Requests_Table( array(
     871        'plural'   => 'privacy_requests',
     872        'singular' => 'privacy_request',
     873    ) );
     874    $requests_table->process_bulk_action();
     875    $requests_table->prepare_items();
     876    ?>
     877    <div class="wrap nosubsub">
     878        <h1><?php esc_html_e( 'Remove Personal Data' ); ?></h1>
     879        <hr class="wp-header-end" />
     880
     881        <?php settings_errors(); ?>
     882
     883        <form method="post" class="wp-privacy-request-form">
     884            <h2><?php esc_html_e( 'Add Data Removal Request' ); ?></h2>
     885            <p><?php esc_html_e( 'An email will be sent to the user at this email address asking them to verify the request.' ); ?></p>
     886
     887            <div class="wp-privacy-request-form-field">
     888                <label for="username_or_email_to_export"><?php esc_html_e( 'Username or email address' ); ?></label>
     889                <input type="text" required class="regular-text" id="username_or_email_to_export" name="username_or_email_to_export" />
     890                <?php submit_button( __( 'Send Request' ), 'secondary', 'submit', false ); ?>
     891            </div>
     892            <?php wp_nonce_field( 'personal-data-request' ); ?>
     893            <input type="hidden" name="action" value="add_remove_personal_data_request" />
     894            <input type="hidden" name="type_of_action" value="user_remove_request" />
     895        </form>
     896        <hr />
     897
     898        <?php $requests_table->views(); ?>
     899
     900        <form class="search-form wp-clearfix">
     901            <?php $requests_table->search_box( __( 'Search Requests' ), 'requests' ); ?>
     902            <input type="hidden" name="page" value="export_personal_data" />
     903            <input type="hidden" name="filter-status" value="<?php echo isset( $_REQUEST['filter-status'] ) ? esc_attr( sanitize_text_field( $_REQUEST['filter-status'] ) ) : ''; ?>" />
     904            <input type="hidden" name="orderby" value="<?php echo isset( $_REQUEST['orderby'] ) ? esc_attr( sanitize_text_field( $_REQUEST['orderby'] ) ) : ''; ?>" />
     905            <input type="hidden" name="order" value="<?php echo isset( $_REQUEST['order'] ) ? esc_attr( sanitize_text_field( $_REQUEST['order'] ) ) : ''; ?>" />
     906        </form>
     907
     908        <form method="post">
     909            <?php
     910            $requests_table->display();
     911            $requests_table->embed_scripts();
     912            ?>
     913        </form>
     914    </div>
     915    <?php
     916}
     917
     918/**
     919 * Add requests pages.
     920 *
     921 * @since 5.0.0
     922 * @access private
     923 */
     924function _wp_privacy_hook_requests_page() {
     925    add_submenu_page( 'tools.php', __( 'Export Personal Data' ), __( 'Export Personal Data' ), 'manage_options', 'export_personal_data', '_wp_personal_data_export_page' );
     926    add_submenu_page( 'tools.php', __( 'Remove Personal Data' ), __( 'Remove Personal Data' ), 'manage_options', 'remove_personal_data', '_wp_personal_data_removal_page' );
     927}
     928
     929// TODO: move the following classes in new files.
     930if ( ! class_exists( 'WP_List_Table' ) ) {
     931    require_once( ABSPATH . 'wp-admin/includes/class-wp-list-table.php' );
     932}
     933
     934/**
     935 * WP_Privacy_Requests_Table class.
     936 */
     937abstract class WP_Privacy_Requests_Table extends WP_List_Table {
     938
     939    /**
     940     * Action name for the requests this table will work with. Classes
     941     * which inherit from WP_Privacy_Requests_Table should define this.
     942     * e.g. 'user_export_request'
     943     *
     944     * @since 5.0.0
     945     *
     946     * @var string $request_type Name of action.
     947     */
     948    protected $request_type = 'INVALID';
     949
     950    /**
     951     * Get columns to show in the list table.
     952     *
     953     * @since 5.0.0
     954     *
     955     * @param array Array of columns.
     956     */
     957    public function get_columns() {
     958        $columns = array(
     959            'cb'         => '<input type="checkbox" />',
     960            'email'      => __( 'Requester' ),
     961            'status'     => __( 'Status' ),
     962            'requested'  => __( 'Requested' ),
     963            'next_steps' => __( 'Next Steps' ),
     964        );
     965        return $columns;
     966    }
     967
     968    /**
     969     * Get a list of sortable columns.
     970     *
     971     * @since 5.0.0
     972     *
     973     * @return array
     974     */
     975    protected function get_sortable_columns() {
     976        return array();
     977    }
     978
     979    /**
     980     * Default primary column.
     981     *
     982     * @since 5.0.0
     983     *
     984     * @return string
     985     */
     986    protected function get_default_primary_column_name() {
     987        return 'email';
     988    }
     989
     990    /**
     991     * Get an associative array ( id => link ) with the list
     992     * of views available on this table.
     993     *
     994     * @since 5.0.0
     995     *
     996     * @return array
     997     */
     998    protected function get_views() {
     999        $current_status = isset( $_REQUEST['filter-status'] ) ? sanitize_text_field( $_REQUEST['filter-status'] ): '';
     1000        $statuses       = _wp_privacy_statuses();
     1001        $views          = array();
     1002        $admin_url      = admin_url( 'tools.php?page=' . $this->request_type );
     1003        $counts         = wp_count_posts( $this->request_type );
     1004
     1005        $current_link_attributes = empty( $current_status ) ? ' class="current" aria-current="page"' : '';
     1006        $views['all']            = '<a href="' . esc_url( $admin_url ) . "\" $current_link_attributes>" . esc_html__( 'All' ) . ' (' . absint( array_sum( (array) $counts ) ) . ')</a>';
     1007
     1008        foreach ( $statuses as $status => $label ) {
     1009            $current_link_attributes = $status === $current_status ? ' class="current" aria-current="page"' : '';
     1010            $views[ $status ]        = '<a href="' . esc_url( add_query_arg( 'filter-status', $status, $admin_url ) ) . "\" $current_link_attributes>" . esc_html( $label ) . ' (' . absint( $counts->$status ) . ')</a>';
     1011        }
     1012
     1013        return $views;
     1014    }
     1015
     1016    /**
     1017     * Get bulk actions.
     1018     *
     1019     * @since 5.0.0
     1020     *
     1021     * @return array
     1022     */
     1023    protected function get_bulk_actions() {
     1024        return array(
     1025            'delete' => __( 'Remove' ),
     1026            'resend' => __( 'Resend email' ),
     1027        );
     1028    }
     1029
     1030    /**
     1031     * Process bulk actions.
     1032     *
     1033     * @since 5.0.0
     1034     */
     1035    public function process_bulk_action() {
     1036        $action      = $this->current_action();
     1037        $request_ids = isset( $_REQUEST['request_id'] ) ? wp_parse_id_list( wp_unslash( $_REQUEST['request_id'] ) ) : array(); // WPCS: input var ok, CSRF ok.
     1038
     1039        if ( $request_ids ) {
     1040            check_admin_referer( 'bulk-privacy_requests' );
     1041        }
     1042
     1043        switch ( $action ) {
     1044            case 'delete':
     1045                $count = 0;
     1046
     1047                foreach ( $request_ids as $request_id ) {
     1048                    if ( wp_delete_post( $request_id, true ) ) {
     1049                        $count ++;
     1050                    }
     1051                }
     1052
     1053                add_settings_error(
     1054                    'bulk_action',
     1055                    'bulk_action',
     1056                    sprintf( _n( 'Deleted %d request', 'Deleted %d requests', $count ), $count ),
     1057                    'updated'
     1058                );
     1059                break;
     1060            case 'resend':
     1061                $count = 0;
     1062
     1063                foreach ( $request_ids as $request_id ) {
     1064                    if ( _wp_privacy_resend_request( $request_id ) ) {
     1065                        $count ++;
     1066                    }
     1067                }
     1068
     1069                add_settings_error(
     1070                    'bulk_action',
     1071                    'bulk_action',
     1072                    sprintf( _n( 'Re-sent %d request', 'Re-sent %d requests', $count ), $count ),
     1073                    'updated'
     1074                );
     1075                break;
     1076        }
     1077    }
     1078
     1079    /**
     1080     * Prepare items to output.
     1081     *
     1082     * @since 5.0.0
     1083     */
     1084    public function prepare_items() {
     1085        global $wpdb;
     1086
     1087        $primary               = $this->get_primary_column_name();
     1088        $this->_column_headers = array(
     1089            $this->get_columns(),
     1090            array(),
     1091            $this->get_sortable_columns(),
     1092            $primary,
     1093        );
     1094
     1095        $this->items    = array();
     1096        $posts_per_page = 20;
     1097        $args           = array(
     1098            'post_type'      => $this->request_type,
     1099            'posts_per_page' => $posts_per_page,
     1100            'offset'         => isset( $_REQUEST['paged'] ) ? max( 0, absint( $_REQUEST['paged'] ) - 1 ) * $posts_per_page: 0,
     1101            'post_status'    => 'any',
     1102        );
     1103
     1104        if ( ! empty( $_REQUEST['filter-status'] ) ) {
     1105            $filter_status       = isset( $_REQUEST['filter-status'] ) ? sanitize_text_field( $_REQUEST['filter-status'] ) : '';
     1106            $args['post_status'] = $filter_status;
     1107        }
     1108
     1109        if ( ! empty( $_REQUEST['s'] ) ) {
     1110            $args['meta_query'] = array(
     1111                $name_query,
     1112                'relation'  => 'AND',
     1113                array(
     1114                    'key'     => '_user_email',
     1115                    'value'   => isset( $_REQUEST['s'] ) ? sanitize_text_field( $_REQUEST['s'] ): '',
     1116                    'compare' => 'LIKE'
     1117                ),
     1118            );
     1119        }
     1120
     1121        $privacy_requests_query = new WP_Query( $args );
     1122        $privacy_requests       = $privacy_requests_query->posts;
     1123
     1124        foreach ( $privacy_requests as $privacy_request ) {
     1125            $this->items[] = array(
     1126                'request_id' => $privacy_request->ID,
     1127                'user_id'    => $privacy_request->post_author,
     1128                'email'      => get_post_meta( $privacy_request->ID, '_user_email', true ),
     1129                'action'     => get_post_meta( $privacy_request->ID, '_action_name', true ),
     1130                'requested'  => strtotime( $privacy_request->post_date_gmt ),
     1131                'confirmed'  => get_post_meta( $privacy_request->ID, '_confirmed_timestamp', true ),
     1132                'completed'  => get_post_meta( $privacy_request->ID, '_completed_timestamp', true ),
     1133            );
     1134        }
     1135
     1136        $this->set_pagination_args(
     1137            array(
     1138                'total_items' => $privacy_requests_query->found_posts,
     1139                'per_page'    => $posts_per_page,
     1140            )
     1141        );
     1142    }
     1143
     1144    /**
     1145     * Checkbox column.
     1146     *
     1147     * @since 5.0.0
     1148     *
     1149     * @param array $item Item being shown.
     1150     * @return string
     1151     */
     1152    public function column_cb( $item ) {
     1153        return sprintf( '<input type="checkbox" name="request_id[]" value="%1$s" /><span class="spinner"></span>', esc_attr( $item['request_id'] ) );
     1154    }
     1155
     1156    /**
     1157     * Status column.
     1158     *
     1159     * @since 5.0.0
     1160     *
     1161     * @param array $item Item being shown.
     1162     * @return string
     1163     */
     1164    public function column_status( $item ) {
     1165        $status        = get_post_status( $item['request_id'] );
     1166        $status_object = get_post_status_object( $status );
     1167
     1168        if ( ! $status_object || empty( $status_object->label ) ) {
     1169            return '-';
     1170        }
     1171
     1172        $timestamp = false;
     1173
     1174        switch ( $status ) {
     1175            case 'request-confirmed':
     1176                $timestamp = $item['confirmed'];
     1177                break;
     1178            case 'request-completed':
     1179                $timestamp = $item['completed'];
     1180                break;
     1181        }
     1182
     1183        echo '<span class="status-label status-' . esc_attr( $status ) . '">';
     1184        echo esc_html( $status_object->label );
     1185
     1186        if ( $timestamp ) {
     1187            echo ' (' . $this->get_timestamp_as_date( $timestamp ) . ')';
     1188        }
     1189
     1190        echo '</span>';
     1191    }
     1192
     1193    /**
     1194     * Convert timestamp for display.
     1195     *
     1196     * @since 5.0.0
     1197     *
     1198     * @param int $timestamp Event timestamp.
     1199     * @return string
     1200     */
     1201    protected function get_timestamp_as_date( $timestamp ) {
     1202        if ( empty( $timestamp ) ) {
     1203            return '';
     1204        }
     1205
     1206        $time_diff = current_time( 'timestamp', true ) - $timestamp;
     1207
     1208        if ( $time_diff >= 0 && $time_diff < DAY_IN_SECONDS ) {
     1209            return sprintf( __( '%s ago' ), human_time_diff( $timestamp ) );
     1210        }
     1211
     1212        return date_i18n( get_option( 'date_format' ), $timestamp );
     1213    }
     1214
     1215    /**
     1216     * Default column handler.
     1217     *
     1218     * @since 5.0.0
     1219     *
     1220     * @param array $item         Item being shown.
     1221     * @param string $column_name Name of column being shown.
     1222     * @return string
     1223     */
     1224    public function column_default( $item, $column_name ) {
     1225        $cell_value = $item[ $column_name ];
     1226
     1227        if ( in_array( $column_name, array( 'requested' ), true ) ) {
     1228            return $this->get_timestamp_as_date( $cell_value );
     1229        }
     1230
     1231        return $cell_value;
     1232    }
     1233
     1234    /**
     1235     * Actions column. Overriden by children.
     1236     *
     1237     * @since 5.0.0
     1238     *
     1239     * @param array $item Item being shown.
     1240     * @return string
     1241     */
     1242    public function column_email( $item ) {
     1243        return sprintf( '%1$s %2$s', $item['email'], $this->row_actions( array() ) );
     1244    }
     1245
     1246    /**
     1247     * Next steps column. Overriden by children.
     1248     *
     1249     * @since 5.0.0
     1250     *
     1251     * @param array $item Item being shown.
     1252     */
     1253    public function column_next_steps( $item ) {}
     1254
     1255    /**
     1256     * Generates content for a single row of the table
     1257     *
     1258     * @since 5.0.0
     1259     *
     1260     * @param object $item The current item
     1261     */
     1262    public function single_row( $item ) {
     1263        $status = get_post_status( $item['request_id'] );
     1264
     1265        echo '<tr class="status-' . esc_attr( $status ) . '">';
     1266        $this->single_row_columns( $item );
     1267        echo '</tr>';
     1268    }
     1269
     1270    /**
     1271     * Embed scripts used to perform actions. Overriden by children.
     1272     *
     1273     * @since 5.0.0
     1274     */
     1275    public function embed_scripts() {}
     1276}
     1277
     1278/**
     1279 * WP_Privacy_Data_Export_Requests_Table class.
     1280 *
     1281 * @since 5.0.0
     1282 */
     1283class WP_Privacy_Data_Export_Requests_Table extends WP_Privacy_Requests_Table {
     1284    /**
     1285     * Action name for the requests this table will work with. Classes
     1286     * which inherit from WP_Privacy_Requests_Table should define this.
     1287     * e.g. 'user_export_request'
     1288     *
     1289     * @since 5.0.0
     1290     *
     1291     * @var string $request_type Name of action.
     1292     */
     1293    protected $request_type = 'user_export_request';
     1294
     1295    /**
     1296     * Actions column.
     1297     *
     1298     * @since 5.0.0
     1299     *
     1300     * @param array $item Item being shown.
     1301     * @return string
     1302     */
     1303    public function column_email( $item ) {
     1304        $row_actions = array(
     1305            'download_data' => __( 'Download Personal Data' ),
     1306        );
     1307
     1308        return sprintf( '%1$s %2$s', $item['email'], $this->row_actions( $row_actions ) );
     1309    }
     1310
     1311    /**
     1312     * Next steps column.
     1313     *
     1314     * @since 5.0.0
     1315     *
     1316     * @param array $item Item being shown.
     1317     */
     1318    public function column_next_steps( $item ) {
     1319        $status = get_post_status( $item['request_id'] );
     1320
     1321        switch ( $status ) {
     1322            case 'request-pending':
     1323                esc_html_e( 'Waiting for confirmation' );
     1324                break;
     1325            case 'request-confirmed':
     1326                // TODO Complete in follow on patch.
     1327                break;
     1328            case 'request-failed':
     1329                submit_button( __( 'Retry' ), 'secondary', 'export_personal_data_email_retry[' . $item['request_id'] . ']', false );
     1330                break;
     1331            case 'request-completed':
     1332                echo '<a href="' . esc_url( wp_nonce_url( add_query_arg( array(
     1333                    'action' => 'delete',
     1334                    'request_id' => array( $item['request_id'] )
     1335                ), admin_url( 'tools.php?page=export_personal_data' ) ), 'bulk-privacy_requests' ) ) . '">' . esc_html__( 'Remove request' ) . '</a>';
     1336                break;
     1337        }
     1338    }
     1339}
     1340
     1341/**
     1342 * WP_Privacy_Data_Removal_Requests_Table class.
     1343 *
     1344     * @since 5.0.0
     1345 */
     1346class WP_Privacy_Data_Removal_Requests_Table extends WP_Privacy_Requests_Table {
     1347    /**
     1348     * Action name for the requests this table will work with. Classes
     1349     * which inherit from WP_Privacy_Requests_Table should define this.
     1350     * e.g. 'user_remove_request'
     1351     *
     1352     * @since 5.0.0
     1353     *
     1354     * @var string $request_type Name of action.
     1355     */
     1356    protected $request_type = 'user_remove_request';
     1357
     1358    /**
     1359     * Actions column.
     1360     *
     1361     * @since 5.0.0
     1362     *
     1363     * @param array $item Item being shown.
     1364     * @return string
     1365     */
     1366    public function column_email( $item ) {
     1367        $row_actions = array(
     1368            // TODO Complete in follow on patch.
     1369            'remove_data' => __( 'Remove Personal Data' ),
     1370        );
     1371
     1372        // If we have a user ID, include a delete user action.
     1373        if ( ! empty( $item['user_id'] ) ) {
     1374            // TODO Complete in follow on patch.
     1375            $row_actions['delete_user'] = __( 'Delete User' );
     1376        }
     1377
     1378        return sprintf( '%1$s %2$s', $item['email'], $this->row_actions( $row_actions ) );
     1379    }
     1380
     1381    /**
     1382     * Next steps column.
     1383     *
     1384     * @since 5.0.0
     1385     *
     1386     * @param array $item Item being shown.
     1387     */
     1388    public function column_next_steps( $item ) {
     1389    }
     1390
     1391}
Note: See TracChangeset for help on using the changeset viewer.