Changeset 43305 for branches/4.9

Timestamp:

05/21/2018 01:15:21 PM (6 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 );