Changeset 43305 for branches/4.9

Timestamp:

05/21/2018 01:15:21 PM (8 years ago)

Author:

SergeyBiryukov

Message:

Docs: Add missing documentation and duplicate hook references for wp_privacy_personal_data_export_file, wp_privacy_personal_data_exporters, and wp_privacy_personal_data_erasers hooks.

Props birgire.
Merges [43303] to the 4.9 branch.
See #44125.

Location:

branches/4.9

Files:

• . (modified) (1 prop)
• src/wp-admin/includes/file.php (modified) (7 diffs)
• src/wp-admin/includes/user.php (modified) (4 diffs)

branches/4.9/src/wp-admin/includes/file.php

@@ -1804 +1804 @@
  * @since 4.9.6
  *
- * @param array  $group_data {
+ * @param array $group_data {
  *     The group data to render.
  *
@@ -1866 +1866 @@
  * @since 4.9.6
  *
- * @param int  $request_id  The export request ID.
+ * @param int $request_id The export request ID.
  */
 function wp_privacy_generate_personal_data_export_file( $request_id ) {
@@ -2030 +2030 @@
                          * @param string $archive_url          The URL of the archive file.
                          * @param string $html_report_pathname The full path to the personal data report on the filesystem.
-                         * @param string $request_id           The export request ID.
+                         * @param int    $request_id           The export request ID.
                          */
                         do_action( 'wp_privacy_personal_data_export_file_created', $archive_pathname, $archive_url, $html_report_pathname, $request_id );
@@ -2051 +2051 @@
  * @since 4.9.6
  *
- * @param int  $request_id  The request ID for this personal data export.
- * @return true|WP_Error    True on success or `WP_Error` on failure.
+ * @param int $request_id The request ID for this personal data export.
+ * @return true|WP_Error True on success or `WP_Error` on failure.
  */
 function wp_privacy_send_personal_data_export_email( $request_id ) {
@@ -2062 +2062 @@
         }
 
-        /** This filter is documented in wp-admin/includes/file.php */
+        /** This filter is documented in wp-includes/functions.php */
         $expiration      = apply_filters( 'wp_privacy_export_expiration', 3 * DAY_IN_SECONDS );
         $expiration_date = date_i18n( get_option( 'date_format' ), time() + $expiration );
@@ -2184 +2184 @@
 
         // If we are not yet on the last page of the last exporter, return now.
+        /** This filter is documented in wp-admin/includes/ajax-actions.php */
         $exporters = apply_filters( 'wp_privacy_personal_data_exporters', array() );
         $is_last_exporter = $exporter_index === count( $exporters );
@@ -2219 +2220 @@
         update_post_meta( $request_id, '_export_data_grouped', $groups );
 
-        // Generate the export file from the collected, grouped personal data.
+        /**
+         * Generate the export file from the collected, grouped personal data.
+         *
+         * @since 4.9.6
+         *
+         * @param int $request_id The export request ID.
+         */
         do_action( 'wp_privacy_personal_data_export_file', $request_id );
 

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

@@ -1381 +1381 @@
          */
         public function column_email( $item ) {
+                /** This filter is documented in wp-admin/includes/ajax-actions.php */
                 $exporters       = apply_filters( 'wp_privacy_personal_data_exporters', array() );
                 $exporters_count = count( $exporters );
@@ -1421 +1422 @@
                                 break;
                         case 'request-confirmed':
+                                /** This filter is documented in wp-admin/includes/ajax-actions.php */
                                 $exporters       = apply_filters( 'wp_privacy_personal_data_exporters', array() );
                                 $exporters_count = count( $exporters );
@@ -1493 +1495 @@
                 $status = $item->status;
                 if ( 'request-confirmed' !== $status ) {
+                        /** This filter is documented in wp-admin/includes/ajax-actions.php */
                         $erasers       = apply_filters( 'wp_privacy_personal_data_erasers', array() );
                         $erasers_count = count( $erasers );
@@ -1533 +1536 @@
                                 break;
                         case 'request-confirmed':
+                                /** This filter is documented in wp-admin/includes/ajax-actions.php */
                                 $erasers       = apply_filters( 'wp_privacy_personal_data_erasers', array() );
                                 $erasers_count = count( $erasers );