Ticket #42900: gender-to-user-profile.diff

src/wp-admin/includes/user.php

@@ -96 +96 @@
                 $user->description = trim( $_POST['description'] );
         }
 
+        if ( isset( $_POST['gender'] ) ) {
+                $user->gender = in_array( $_POST['gender'], array( 'unknown', 'female', 'male' ), true ) ? $_POST['gender'] : 'unknown';
+        }
+
         foreach ( wp_get_user_contact_methods( $user ) as $method => $name ) {
                 if ( isset( $_POST[ $method ] ) ) {
                         $user->$method = sanitize_text_field( $_POST[ $method ] );

src/wp-admin/user-edit.php

@@ -638 +638 @@
 </tr>
 <?php endif; ?>
 
+<tr class="user-gender-wrap">
+    <th><label for="gender"><?php _e( 'What pronoun do you prefer?' ); ?></label></th>
+    <td>
+        <p>
+            <?php
+                $gender = get_user_meta( $user_id, 'gender', true );
+                if ( ! $gender ) {
+                    $gender = 'unknown';
+                }
+            ?>
+            <label><input name="gender" type="radio" value="female" <?php checked( 'female', $gender ); ?> /> <?php _e( 'Female: She published a new post.' ); ?></label><br />
+            <label><input name="gender" type="radio" value="male" <?php checked( 'male', $gender ); ?> /> <?php _e( 'Male: He published a new post.' ); ?></label><br />
+            <label><input name="gender" type="radio" value="unknown" <?php checked( 'unknown', $gender ); ?> /> <?php _e( 'Other/Unknown: They published a new post.' ); ?></label>
+        </p>
+        <p class="description">
+            <?php _e( 'This preference will allow translations of WordPress to address you and to mention you to others using the appropriate grammatical gender.' ); ?><br />
+            <?php _e( 'If "Other/Unknown" is chosen, WordPress will use gender-neutral words whenever possible.' ); ?>
+        </p>
+    </td>
+</tr>
+
 <?php
 if ( IS_PROFILE_PAGE && count( $sessions->get_all() ) === 1 ) :
 ?>

src/wp-includes/class-wp-user.php

@@ -32 +32 @@
  * @property string $spam
  * @property string $deleted
  * @property string $locale
+ * @property string $gender
  * @property string $rich_editing
  * @property string $syntax_highlighting
  */

src/wp-includes/l10n.php

@@ -104 +104 @@
         return $locale ? $locale : get_locale();
 }
 
+/**
+ * Retrieves the gender of a user for use in translations.
+ *
+ * If the user has a gender set to a valid non-empty string then it will be
+ * returned. Otherwise it returns 'unknown'.
+ *
+ * @since 5.0.0
+ *
+ * @param int|WP_User $user_id User's ID or a WP_User object. Defaults to current user.
+ * @return string The gender of the user.
+ */
+function get_user_gender( $user_id = 0 ) {
+        $user = false;
+        if ( 0 === $user_id && function_exists( 'wp_get_current_user' ) ) {
+                $user = wp_get_current_user();
+        } elseif ( $user_id instanceof WP_User ) {
+                $user = $user_id;
+        } elseif ( $user_id && is_numeric( $user_id ) ) {
+                $user = get_user_by( 'id', $user_id );
+        }
+
+        if ( ! $user ) {
+                return 'unknown';
+        }
+
+        $gender = $user->gender;
+        return $gender ? $gender : 'unknown';
+}
+
 /**
  * Retrieve the translation of $text.
  *

src/wp-includes/user.php

@@ -1469 +1469 @@
  *                                             to build the second part of the user's display name
  *                                             if `$display_name` is not specified.
  *     @type string      $description          The user's biographical description.
+ *     @type string      $gender               The user's chosen gender.
  *     @type string|bool $rich_editing         Whether to enable the rich-editor for the user.
  *                                             False if not empty.
  *     @type string|bool $syntax_highlighting  Whether to enable the rich code editor for the user.
@@ -1684 +1685 @@
          */
         $meta['description'] = apply_filters( 'pre_user_description', $description );
 
+        $meta['gender'] = empty( $userdata['gender'] ) ? 'unknown' : $userdata['gender'];
+
         $meta['rich_editing'] = empty( $userdata['rich_editing'] ) ? 'true' : $userdata['rich_editing'];
 
         $meta['syntax_highlighting'] = empty( $userdata['syntax_highlighting'] ) ? 'true' : $userdata['syntax_highlighting'];
@@ -1774 +1777 @@
          *     @type string   $first_name           The user's first name.
          *     @type string   $last_name            The user's last name.
          *     @type string   $description          The user's description.
+         *     @type string   $gender               The user's gender.
          *     @type bool     $rich_editing         Whether to enable the rich-editor for the user. False if not empty.
          *     @type bool     $syntax_highlighting  Whether to enable the rich code editor for the user. False if not empty.
          *     @type bool     $comment_shortcuts    Whether to enable keyboard shortcuts for the user. Default false.