Changeset 10163

trunk/src/bp-xprofile/bp-xprofile-actions.php

-                      r10140
+                      r10163
  * The function will delete the active avatar for a user.
+ *
- * @package BuddyPress Xprofile
  * @uses bp_core_delete_avatar() Deletes the active avatar for the logged in user.
  * @uses add_action() Runs a specific function for an action when it fires.
 …
+    }
     // Check the nonce
+    // Check the nonce.
     check_admin_referer( 'bp_delete_avatar_link' );
 …
 /**
  * Handles the saving of xprofile field visibilities
+ * Handles the saving of xprofile field visibilities.
+ *
  * @since 1.9.0
 …
 function bp_xprofile_action_settings() {
     // Bail if not a POST action
+    // Bail if not a POST action.
     if ( 'POST' !== strtoupper( $_SERVER['REQUEST_METHOD'] ) ) {
         return;
+    }
     // Bail if no submit action
+    // Bail if no submit action.
     if ( ! isset( $_POST['xprofile-settings-submit'] ) ) {
         return;
+    }
     // Bail if not in settings
+    // Bail if not in settings.
     if ( ! bp_is_user_settings_profile() ) {
         return;
 …
+    }
     // Nonce check
+    // Nonce check.
     check_admin_referer( 'bp_xprofile_settings' );
 …
     /** Save ******************************************************************/
     // Only save if there are field ID's being posted
+    // Only save if there are field ID's being posted.
     if ( ! empty( $_POST['field_ids'] ) ) {
         // Get the POST'ed field ID's
+        // Get the POST'ed field ID's.
         $posted_field_ids = explode( ',', $_POST['field_ids'] );
 …
+        }
         // Save the visibility settings
+        // Save the visibility settings.
         foreach ( $posted_field_ids as $field_id ) {
 …
     do_action( 'bp_xprofile_settings_after_save' );
     // Redirect to the root domain
+    // Redirect to the root domain.
     bp_core_redirect( bp_displayed_user_domain() . bp_get_settings_slug() . '/profile' );
+}

trunk/src/bp-xprofile/bp-xprofile-activity.php

-                      r10140
+                      r10163
 /**
  * Register the activity actions for the Extended Profile component
+ *
  * @since 1.0.0
+ *
  * @uses bp_activity_set_action() To setup the individual actions
+ * Register the activity actions for the Extended Profile component.
+ *
+ * @since 1.0.0
+ *
+ * @uses bp_activity_set_action() To setup the individual actions.
  */
 function xprofile_register_activity_actions() {
     // Register the activity stream actions for this component
+    // Register the activity stream actions for this component.
     bp_activity_set_action(
+        // older avatar activity items use 'profile' for component
+        // see r4273
+        // Older avatar activity items use 'profile' for component. See r4273.
         'profile',
         'new_avatar',
 …
  * @since 2.0.0
+ *
  * @param string $action Static activity action.
+ * @param string $action   Static activity action.
  * @param object $activity Activity object.
+ *
  * @return string
  */
 …
     $action   = sprintf( __( '%s changed their profile picture', 'buddypress' ), $userlink );
     // Legacy filter - pass $user_id instead of $activity
+    // Legacy filter - pass $user_id instead of $activity.
     if ( has_filter( 'bp_xprofile_new_avatar_action' ) ) {
         $action = apply_filters( 'bp_xprofile_new_avatar_action', $action, $activity->user_id );
 …
  * @since 2.0.0
+ *
  * @param string $action Static activity action.
+ * @param string $action   Static activity action.
  * @param object $activity Activity object.
+ *
  * @return string
  */
 …
 /**
  * Records activity for the logged in user within the profile component so that
+ * it will show in the users activity stream (if installed)
+ *
+ * @since 1.0.0
+ *
+ * @package BuddyPress
+ * @subpackage XProfileActivity
+ * @param string $args String containing all variables used after extract() call
+ * @uses bp_activity_add() Adds an entry to the activity component tables for a specific activity
+ * it will show in the users activity stream (if installed).
+ *
+ * @since 1.0.0
+ *
+ * @uses bp_activity_add() Adds an entry to the activity component tables for a specific activity.
+ *
+ * @param array|string $args String containing all variables used after bp_parse_args() call.
+ *
+ * @return array
  */
 function xprofile_record_activity( $args = '' ) {
     // Bail if activity component is not active
     if ( ! bp_is_active( 'activity' ) ) {
         return false;
+    }
     // Parse the arguments
+    // Bail if activity component is not active.
+    if ( ! bp_is_active( 'activity' ) ) {
+        return false;
+    }
+    // Parse the arguments.
     $r = bp_parse_args( $args, array(
         'user_id'           => bp_loggedin_user_id(),
 …
 /**
  * Deletes activity for a user within the profile component so that it will be
+ * removed from the users activity stream and sitewide stream (if installed)
+ *
+ * @since 1.0.0
+ *
+ * @package BuddyPress XProfile
+ * @param string $args Containing all variables used after extract() call
+ * removed from the users activity stream and sitewide stream (if installed).
+ *
+ * @since 1.0.0
+ *
  * @uses bp_activity_delete() Deletes an entry to the activity component tables
+ *                            for a specific activity
+ *                            for a specific activity.
+ *
+ * @param array|string $args Containing all variables used after bp_parse_args() call.
+ *
+ * @return bool
  */
 function xprofile_delete_activity( $args = '' ) {
     // Bail if activity component is not active
     if ( ! bp_is_active( 'activity' ) ) {
         return false;
+    }
     // Parse the arguments
+    // Bail if activity component is not active.
+    if ( ! bp_is_active( 'activity' ) ) {
+        return false;
+    }
+    // Parse the arguments.
     $r = bp_parse_args( $args, array(
         'component' => buddypress()->profile->id
     ), 'xprofile_delete_activity' );
     // Delete the activity item
+    // Delete the activity item.
     bp_activity_delete_by_item_id( $r );
+}
 /**
+ * Register an activity action for the Extended Profiles component
+ *
+ * @since 1.0.0
+ *
+ * @param string $key
+ * @param string $value
+ * @return bool True if success, false on failure
+ * Register an activity action for the Extended Profiles component.
+ *
+ * @since 1.0.0
+ *
+ * @param string $key Key.
+ * @param string $value Value.
+ *
+ * @return bool True if success, false on failure.
  */
 function xprofile_register_activity_action( $key, $value ) {
     // Bail if activity component is not active
+    // Bail if activity component is not active.
     if ( ! bp_is_active( 'activity' ) ) {
         return false;
 …
+ *
  * @since 1.0.0
+ * @since 2.3.4 Add new parameter to get the user id the avatar was set for
+ *
+ * @package BuddyPress XProfile
+ * @since 2.3.4 Add new parameter to get the user id the avatar was set for.
+ *
  * @uses bp_activity_add() Adds an entry to the activity component tables for a
  *                         specific activity
+ *
+ * @param  int $user_id The user id the avatar was set for
+ * @param int $user_id The user id the avatar was set for.
+ *
+ * @return bool
  */
 function bp_xprofile_new_avatar_activity( $user_id = 0 ) {
     // Bail if activity component is not active
+    // Bail if activity component is not active.
     if ( ! bp_is_active( 'activity' ) ) {
         return false;
 …
     $user_id = apply_filters( 'bp_xprofile_new_avatar_user_id', $user_id );
     // Add the activity
+    // Add the activity.
     bp_activity_add( array(
         'user_id'   => $user_id,
 …
  * @since 2.0.0
+ *
+ * @param int $user_id ID of the user who has updated his profile.
+ * @param array $field_ids IDs of the fields submitted.
+ * @param bool $errors True if validation or saving errors occurred, otherwise
+ *        false.
+ * @param array $old_values Pre-save xprofile field values and visibility
+ *        levels.
+ * @param array $new_values Post-save xprofile field values and visibility
+ *        levels.
+ * @param int   $user_id    ID of the user who has updated his profile.
+ * @param array $field_ids  IDs of the fields submitted.
+ * @param bool  $errors     True if validation or saving errors occurred, otherwise false.
+ * @param array $old_values Pre-save xprofile field values and visibility levels.
+ * @param array $new_values Post-save xprofile field values and visibility levels.
+ *
  * @return bool True on success, false on failure.
  */
 function bp_xprofile_updated_profile_activity( $user_id, $field_ids = array(), $errors = false, $old_values = array(), $new_values = array() ) {
     // If there were errors, don't post
+    // If there were errors, don't post.
     if ( ! empty( $errors ) ) {
         return false;
+    }
     // Bail if activity component is not active
+    // Bail if activity component is not active.
     if ( ! bp_is_active( 'activity' ) ) {
         return false;
 …
     // Don't post if there have been no changes, or if the changes are
     // related solely to non-public fields
+    // related solely to non-public fields.
     $public_changes = false;
     foreach ( $new_values as $field_id => $new_value ) {
         $old_value = isset( $old_values[ $field_id ] ) ? $old_values[ $field_id ] : '';
         // Don't register changes to private fields
+        // Don't register changes to private fields.
         if ( empty( $new_value['visibility'] ) || ( 'public' !== $new_value['visibility'] ) ) {
             continue;
+        }
         // Don't register if there have been no changes
+        // Don't register if there have been no changes.
         if ( $new_value === $old_value ) {
             continue;
+        }
         // Looks like we have public changes - no need to keep checking
+        // Looks like we have public changes - no need to keep checking.
         $public_changes = true;
         break;
+    }
     // Bail if no public changes
+    // Bail if no public changes.
     if ( empty( $public_changes ) ) {
         return false;
+    }
     // Throttle to one activity of this type per 2 hours
+    // Throttle to one activity of this type per 2 hours.
     $existing = bp_activity_get( array(
         'max'    => 1,
 …
     ) );
     // Default throttle time is 2 hours. Filter to change (in seconds)
+    // Default throttle time is 2 hours. Filter to change (in seconds).
     if ( ! empty( $existing['activities'] ) ) {
 …
         $now             = strtotime( bp_core_current_time() );
         // Bail if throttled
+        // Bail if throttled.
         if ( ( $now - $then ) < $throttle_period ) {
             return false;
 …
+    }
     // If we've reached this point, assemble and post the activity item
+    // If we've reached this point, assemble and post the activity item.
     $profile_link = trailingslashit( bp_core_get_user_domain( $user_id ) . bp_get_profile_slug() );

trunk/src/bp-xprofile/bp-xprofile-admin.php

-                      r10140
+                      r10163
  * tables are set up.
+ *
  * @package BuddyPress XProfile
  * @uses bp_current_user_can() returns true if the current user is a site admin, false if not
  * @uses add_users_page() Adds a submenu tab to a top level tab in the admin area
  * @return
+ * @uses bp_current_user_can() returns true if the current user is a site admin, false if not.
+ * @uses add_users_page() Adds a submenu tab to a top level tab in the admin area.
+ *
+ * @return bool
  */
 function xprofile_add_admin_menu() {
     // Bail if current user cannot moderate community
+    // Bail if current user cannot moderate community.
     if ( ! bp_current_user_can( 'bp_moderate' ) ) {
         return false;
 …
  * Handles all actions for the admin area for creating, editing and deleting
  * profile groups and fields.
+ *
+ * @param string $message Message to display.
+ * @param string $type    Type of action to be displayed.
  */
 function xprofile_admin( $message = '', $type = 'error' ) {
 …
  * @since 2.3.0
+ *
  * @param string $message Feedback message
  * @param string $type    Feedback type
+ * @param string $message Feedback message.
+ * @param string $type    Feedback type.
+ *
  * @todo Improve error message output
 …
 function xprofile_admin_screen( $message = '', $type = 'error' ) {
     // Validate type
+    // Validate type.
     $type = preg_replace( '|[^a-z]|i', '', $type );
     // Get all of the profile groups & fields
+    // Get all of the profile groups & fields.
     $groups = bp_xprofile_get_groups( array(
         'fetch_fields' => true
 …
                                 foreach ( $group->fields as $field ) {
                                     // Load the field
+                                    // Load the field.
                                     $field = new BP_XProfile_Field( $field->id );
 …
                                     /**
                                      * This function handles the WYSIWYG profile field
                                      * display for the xprofile admin setup screen
+                                     * display for the xprofile admin setup screen.
                                      */
                                     xprofile_admin_field( $field, $group, $class );
 …
                                 <p class="nodrag nofields"><?php _e( 'There are no fields in this group.', 'buddypress' ); ?></p>
                             <?php endif; // end $group->fields ?>
+                            <?php endif; // End $group->fields. ?>
                         </fieldset>
 …
 /**
  * Handles the adding or editing of groups.
+ *
+ * @param int|null $group_id Group ID to manage.
  */
 function xprofile_admin_manage_group( $group_id = null ) {
     global $message, $type;
     // Get the field group
+    // Get the field group.
     $group = new BP_XProfile_Group( $group_id );
     // Updating
+    // Updating.
     if ( isset( $_POST['save_group'] ) ) {
         // Validate $_POSTed data
+        // Validate $_POSTed data.
         if ( BP_XProfile_Group::admin_validate() ) {
             // Set the group name
+            // Set the group name.
             $group->name = $_POST['group_name'];
             // Set the group description
+            // Set the group description.
             if ( ! empty( $_POST['group_description'] ) ) {
                 $group->description = $_POST['group_description'];
 …
+            }
             // Attempt to save the field group
+            // Attempt to save the field group.
             if ( false === $group->save() ) {
                 $message = __( 'There was an error saving the group. Please try again.', 'buddypress' );
                 $type    = 'error';
             // Save successful
+            // Save successful.
             } else {
                 $message = __( 'The group was saved successfully.', 'buddypress' );
 …
 /**
  * Handles the deletion of profile data groups.
+ *
+ * @param int $group_id ID of the group to delete.
  */
 function xprofile_admin_delete_group( $group_id ) {
 …
 /**
  * Handles the adding or editing of profile field data for a user.
+ *
+ * @param int      $group_id ID of the group.
+ * @param int|null $field_id ID of the field being managed.
  */
 function xprofile_admin_manage_field( $group_id, $field_id = null ) {
 …
+                }
                 // Validate default visibility
+                // Validate default visibility.
                 if ( ! empty( $_POST['default-visibility'] ) && in_array( $_POST['default-visibility'], wp_list_pluck( bp_xprofile_get_visibility_levels(), 'id' ) ) ) {
                     bp_xprofile_update_field_meta( $field_id, 'default_visibility', $_POST['default-visibility'] );
+                }
                 // Validate custom visibility
+                // Validate custom visibility.
                 if ( ! empty( $_POST['allow-custom-visibility'] ) && in_array( $_POST['allow-custom-visibility'], array( 'allowed', 'disabled' ) ) ) {
                     bp_xprofile_update_field_meta( $field_id, 'allow_custom_visibility', $_POST['allow-custom-visibility'] );
+                }
                 // Validate signup
+                // Validate signup.
                 if ( ! empty( $_POST['signup-position'] ) ) {
                     bp_xprofile_update_field_meta( $field_id, 'signup_position', (int) $_POST['signup-position'] );
 …
 /**
  * Handles the deletion of a profile field (or field option)
+ * Handles the deletion of a profile field (or field option).
+ *
  * @since 1.0.0
+ * @global string $message The feedback message to show
+ * @global $type The type of feedback message to show
+ * @param int $field_id The field to delete
+ * @param string $field_type The type of field being deleted
+ * @param bool $delete_data Should the field data be deleted too?
+ * @global string $message The feedback message to show.
+ * @global $type The type of feedback message to show.
+ *
+ * @param int    $field_id    The field to delete.
+ * @param string $field_type  The type of field being deleted.
+ * @param bool   $delete_data Should the field data be deleted too.
  */
 function xprofile_admin_delete_field( $field_id, $field_type = 'field', $delete_data = false ) {
     global $message, $type;
     // Switch type to 'option' if type is not 'field'
     // @todo trust this param
+    // Switch type to 'option' if type is not 'field'.
+    // @todo trust this param.
     $field_type  = ( 'field' == $field_type ) ? __( 'field', 'buddypress' ) : __( 'option', 'buddypress' );
     $field       = new BP_XProfile_Field( $field_id );
 …
 /**
  * Handles the ajax reordering of fields within a group
+ * Handles the ajax reordering of fields within a group.
  */
 function xprofile_ajax_reorder_fields() {
     // Check the nonce
+    // Check the nonce.
     check_admin_referer( 'bp_reorder_fields', '_wpnonce_reorder_fields' );
 …
 /**
  * Handles the reordering of field groups
+ * Handles the reordering of field groups.
  */
 function xprofile_ajax_reorder_field_groups() {
     // Check the nonce
+    // Check the nonce.
     check_admin_referer( 'bp_reorder_groups', '_wpnonce_reorder_groups' );
 …
 /**
+ * Handles the WYSIWYG display of each profile field on the edit screen
+ * Handles the WYSIWYG display of each profile field on the edit screen.
+ *
+ * @param object $admin_field Admin field.
+ * @param object $admin_group Admin group object.
+ * @param string $class       Classes to append to output.
  */
 function xprofile_admin_field( $admin_field, $admin_group, $class = '' ) {
 …
  * Print <option> elements containing the xprofile field types.
+ *
- * @param string $select_field_type The name of the field type that should be selected. Will defaults to "textbox" if NULL is passed.
  * @since 2.0.0
+ *
+ * @param string $select_field_type The name of the field type that should be selected.
+ *                                  Will defaults to "textbox" if NULL is passed.
  */
 function bp_xprofile_admin_form_field_types( $select_field_type ) {
 …
+    }
     // Sort each field type into its category
+    // Sort each field type into its category.
     foreach ( bp_xprofile_get_field_types() as $field_name => $field_class ) {
         $field_type_obj = new $field_class;
         $the_category   = $field_type_obj->category;
         // Fallback to a catch-all if category not set
+        // Fallback to a catch-all if category not set.
         if ( ! $the_category ) {
             $the_category = _x( 'Other', 'xprofile field type category', 'buddypress' );
 …
+    }
     // Sort the categories alphabetically. ksort()'s SORT_NATURAL is only in PHP >= 5.4 :((
+    // Sort the categories alphabetically. ksort()'s SORT_NATURAL is only in PHP >= 5.4 :((.
     uksort( $categories, 'strnatcmp' );
     // Loop through each category and output form <options>
+    // Loop through each category and output form <options>.
     foreach ( $categories as $category => $fields ) {
         printf( '<optgroup label="%1$s">', esc_attr( $category ) );  // Already i18n'd in each profile type class
         // Sort these fields types alphabetically
+        printf( '<optgroup label="%1$s">', esc_attr( $category ) );  // Already i18n'd in each profile type class.
+        // Sort these fields types alphabetically.
         uasort( $fields, create_function( '$a, $b', 'return strnatcmp( $a[1]->name, $b[1]->name );' ) );
 …
 if ( ! class_exists( 'BP_XProfile_User_Admin' ) ) :
 /**
  * Load xProfile Profile admin area.
+ *
- * @package BuddyPress
- * @subpackage xProfileAdministration
+ *
  * @since 2.0.0
 …
      * @since 2.0.0
+     *
      * @uses buddypress() to get BuddyPress main instance
+     * @uses buddypress() to get BuddyPress main instance.
      */
     public static function register_xprofile_user_admin() {
         // Bail if not in admin
+        // Bail if not in admin.
         if ( ! is_admin() ) {
             return;
 …
      */
     private function setup_actions() {
         // Enqueue scripts
+        // Enqueue scripts.
         add_action( 'bp_members_admin_enqueue_scripts',  array( $this, 'enqueue_scripts'    ), 10, 1 );
         // Register the metabox in Member's community admin profile
+        // Register the metabox in Member's community admin profile.
         add_action( 'bp_members_admin_xprofile_metabox', array( $this, 'register_metaboxes' ), 10, 3 );
         // Saves the profile actions for user ( avatar, profile fields )
+        // Saves the profile actions for user ( avatar, profile fields ).
         add_action( 'bp_members_admin_update_user',      array( $this, 'user_admin_load'    ), 10, 4 );
+    }
 …
      * @access public
      * @since 2.3.0
+     *
+     * @param int $screen_id Screen ID being displayed.
      */
     public function enqueue_scripts( $screen_id ) {
 …
         /**
          * Get Thickbox
+         * Get Thickbox.
+         *
          * We cannot simply use add_thickbox() here as WordPress is not playing
 …
         wp_enqueue_script( 'media-upload' );
         // Get Avatar Uploader
+        // Get Avatar Uploader.
         bp_attachments_enqueue_scripts( 'BP_Attachment_Avatar' );
+    }
 …
      * @since 2.0.0
+     *
      * @param int $user_id ID of the user being edited.
      * @param string $screen_id Screen ID to load the metabox in.
+     * @param int    $user_id       ID of the user being edited.
+     * @param string $screen_id     Screen ID to load the metabox in.
      * @param object $stats_metabox Context and priority for the stats metabox.
      */
     public function register_metaboxes( $user_id = 0, $screen_id = '', $stats_metabox = null ) {
         // Set the screen ID if none was passed
+        // Set the screen ID if none was passed.
         if ( empty( $screen_id ) ) {
             $screen_id = buddypress()->members->admin->user_page;
+        }
         // Setup a new metabox class if none was passed
+        // Setup a new metabox class if none was passed.
         if ( empty( $stats_metabox ) ) {
             $stats_metabox = new StdClass();
+        }
         // Moving the Stats Metabox
+        // Moving the Stats Metabox.
         $stats_metabox->context  = 'side';
         $stats_metabox->priority = 'low';
         // Each Group of fields will have his own metabox
+        // Each Group of fields will have his own metabox.
         $profile_args = array(
             'fetch_fields' => false,
 …
         if ( ! bp_is_user_spammer( $user_id ) && bp_has_profile( $profile_args ) ) {
             // Loop through field groups and add a metabox for each one
+            // Loop through field groups and add a metabox for each one.
             while ( bp_profile_groups() ) : bp_the_profile_group();
                 add_meta_box(
 …
             endwhile;
         // If member is already a spammer, show a generic metabox
+        // If member is already a spammer, show a generic metabox.
         } else {
             add_meta_box(
 …
         if ( buddypress()->avatar->show_avatars ) {
             // Avatar Metabox
+            // Avatar Metabox.
             add_meta_box(
                 'bp_xprofile_user_admin_avatar',
 …
      * @access public
      * @since 2.0.0
+     *
+     * @param string $doaction    Action being run.
+     * @param int    $user_id     ID for the user whose profile is being saved.
+     * @param array  $request     Request being made.
+     * @param string $redirect_to Where to redirect user to.
      */
     public function user_admin_load( $doaction = '', $user_id = 0, $request = array(), $redirect_to = '' ) {
         // Eventually delete avatar
+        // Eventually delete avatar.
         if ( 'delete_avatar' === $doaction ) {
 …
             bp_core_redirect( $redirect_to );
         // Update profile fields
+        // Update profile fields.
         } elseif ( isset( $_POST['field_ids'] ) ) {
             // Check the nonce
+            // Check the nonce.
             check_admin_referer( 'edit-bp-profile_' . $user_id );
             // Check we have field ID's
+            // Check we have field ID's.
             if ( empty( $_POST['field_ids'] ) ) {
                 $redirect_to = add_query_arg( 'error', '1', $redirect_to );
 …
             $merge_ids = join( ',', $_POST['field_ids'] );
             // Explode the posted field IDs into an array so we know which fields have been submitted
+            // Explode the posted field IDs into an array so we know which fields have been submitted.
             $posted_field_ids = wp_parse_id_list( $merge_ids );
             $is_required      = array();
             // Loop through the posted fields formatting any datebox values then validate the field
+            // Loop through the posted fields formatting any datebox values then validate the field.
             foreach ( (array) $posted_field_ids as $field_id ) {
                 if ( ! isset( $_POST['field_' . $field_id ] ) ) {
                     if ( ! empty( $_POST['field_' . $field_id . '_day'] ) && ! empty( $_POST['field_' . $field_id . '_month'] ) && ! empty( $_POST['field_' . $field_id . '_year'] ) ) {
                         // Concatenate the values
+                        // Concatenate the values.
                         $date_value =   $_POST['field_' . $field_id . '_day'] . ' ' . $_POST['field_' . $field_id . '_month'] . ' ' . $_POST['field_' . $field_id . '_year'];
                         // Turn the concatenated value into a timestamp
+                        // Turn the concatenated value into a timestamp.
                         $_POST['field_' . $field_id] = date( 'Y-m-d H:i:s', strtotime( $date_value ) );
+                    }
 …
+            }
             // Set the errors var
+            // Set the errors var.
             $errors = false;
 …
+                }
                 // Save the visibility level
+                // Save the visibility level.
                 $visibility_level = ! empty( $_POST['field_' . $field_id . '_visibility'] ) ? $_POST['field_' . $field_id . '_visibility'] : 'public';
                 xprofile_set_field_visibility_level( $field_id, $user_id, $visibility_level );
 …
             do_action( 'xprofile_updated_profile', $user_id, $posted_field_ids, $errors );
             // Set the feedback messages
+            // Set the feedback messages.
             if ( ! empty( $errors ) ) {
                 $redirect_to = add_query_arg( 'error',   '3', $redirect_to );
 …
+     *
      * @param WP_User $user The WP_User object for the user being edited.
+     * @param array   $args Aray of arguments for metaboxes.
      */
     public function user_admin_profile_metaboxes( $user = null, $args = array() ) {
         // Bail if no user ID
+        // Bail if no user ID.
         if ( empty( $user->ID ) ) {
             return;
 …
         ), 'bp_xprofile_user_admin_profile_loop_args' );
         // We really need these args
+        // We really need these args.
         if ( empty( $r['profile_group_id'] ) || empty( $r['user_id'] ) ) {
             return;
+        }
         // Bail if no profile fields are available
+        // Bail if no profile fields are available.
         if ( ! bp_has_profile( $r ) ) {
             return;
+        }
         // Loop through profile groups & fields
+        // Loop through profile groups & fields.
         while ( bp_profile_groups() ) : bp_the_profile_group(); ?>
 …
                 </div>
             <?php endwhile; // bp_profile_fields() ?>
         <?php endwhile; // bp_profile_groups
+            <?php endwhile; // End bp_profile_fields(). ?>
+        <?php endwhile; // End bp_profile_groups.
+    }
 …
             <?php endif;
             // Load the Avatar UI templates if user avatar uploads are enabled and current WordPress version is supported
+            // Load the Avatar UI templates if user avatar uploads are enabled and current WordPress version is supported.
             if ( ! bp_core_get_root_option( 'bp-disable-avatar-uploads' ) && bp_attachments_is_wp_version_supported() ) : ?>
                 <a href="#TB_inline?width=800px&height=400px&inlineId=bp-xprofile-avatar-editor" title="<?php esc_attr_e( 'Edit Profile Photo', 'buddypress' );?>" class="thickbox bp-xprofile-avatar-user-edit"><?php esc_html_e( 'Edit Profile Photo', 'buddypress' ); ?></a>
 …
+}
 endif; // class_exists check
 // Load the xprofile user admin
+endif; // End class_exists check.
+// Load the xprofile user admin.
 add_action( 'bp_init', array( 'BP_XProfile_User_Admin', 'register_xprofile_user_admin' ), 11 );

trunk/src/bp-xprofile/bp-xprofile-cache.php

-                      r10140
+                      r10163
  * @since 2.2.0
+ *
  * @param int   $user_id   User ID to check
+ * @param int   $user_id   User ID to check.
  * @param array $field_ids XProfile field IDs.
+ *
  * @return array
  */
 …
+ *
  * @param array $object_ids Multi-dimensional array of object_ids, keyed by
+ *        object type ('group', 'field', 'data')
+ *                          object type ('group', 'field', 'data').
+ *
+ * @return bool
  */
 function bp_xprofile_update_meta_cache( $object_ids = array() ) {
     global $wpdb;
     // Bail if no objects
+    // Bail if no objects.
     if ( empty( $object_ids ) ) {
         return false;
 …
     $bp = buddypress();
     // Define the array where uncached object IDs will be stored
+    // Define the array where uncached object IDs will be stored.
     $uncached_object_ids = array(
         'group',
 …
     );
     // Define the cache groups for the 3 types of XProfile metadata
+    // Define the cache groups for the 3 types of XProfile metadata.
     $cache_groups = array(
         'group' => 'xprofile_group_meta',
 …
     );
     // No reason to query yet
+    // No reason to query yet.
     $do_query = false;
     // Loop through object types and look for uncached data
+    // Loop through object types and look for uncached data.
     foreach ( $uncached_object_ids as $object_type ) {
         // Skip if empty object type
+        // Skip if empty object type.
         if ( empty( $object_ids[ $object_type ] ) ) {
             continue;
+        }
         // Sanitize $object_ids passed to the function
+        // Sanitize $object_ids passed to the function.
         $object_type_ids = wp_parse_id_list( $object_ids[ $object_type ] );
         // Get non-cached IDs for each object type
+        // Get non-cached IDs for each object type.
         $uncached_object_ids[ $object_type ] = bp_get_non_cached_ids( $object_type_ids, $cache_groups[ $object_type ] );
         // Set the flag to do the meta query
+        // Set the flag to do the meta query.
         if ( ! empty( $uncached_object_ids[ $object_type ] ) && ( false === $do_query ) ) {
             $do_query = true;
 …
+    }
     // Bail if no uncached items
+    // Bail if no uncached items.
     if ( false === $do_query ) {
         return;
+    }
     // Setup where conditions for query
+    // Setup where conditions for query.
     $where_sql        = '';
     $where_conditions = array();
     // Loop through uncached objects and prepare to query for them
+    // Loop through uncached objects and prepare to query for them.
     foreach ( $uncached_object_ids as $otype => $oids ) {
         // Skip empty object IDs
+        // Skip empty object IDs.
         if ( empty( $oids ) ) {
             continue;
+        }
         // Compile WHERE query conditions for uncached metadata
+        // Compile WHERE query conditions for uncached metadata.
         $oids_sql           = implode( ',', wp_parse_id_list( $oids ) );
         $where_conditions[] = $wpdb->prepare( "( object_type = %s AND object_id IN ({$oids_sql}) )", $otype );
+    }
     // Bail if no where conditions
+    // Bail if no where conditions.
     if ( empty( $where_conditions ) ) {
         return;
+    }
     // Setup the WHERE query part
+    // Setup the WHERE query part.
     $where_sql = implode( " OR ", $where_conditions );
     // Attempt to query meta values
+    // Attempt to query meta values.
     $meta_list = $wpdb->get_results( "SELECT object_id, object_type, meta_key, meta_value FROM {$bp->profile->table_name_meta} WHERE {$where_sql}" );
     // Bail if no results found
+    // Bail if no results found.
     if ( empty( $meta_list ) || is_wp_error( $meta_list ) ) {
         return;
+    }
     // Setup empty cache array
+    // Setup empty cache array.
     $cache = array();
     // Loop through metas
+    // Loop through metas.
     foreach ( $meta_list as $meta ) {
         $oid    = $meta->object_id;
 …
         $ovalue = $meta->meta_value;
         // Force subkeys to be array type
+        // Force subkeys to be array type.
         if ( ! isset( $cache[ $otype ][ $oid ] ) || ! is_array( $cache[ $otype ][ $oid ] ) ) {
             $cache[ $otype ][ $oid ] = array();
 …
+        }
         // Add to the cache array
+        // Add to the cache array.
         $cache[ $otype ][ $oid ][ $okey ][] = maybe_unserialize( $ovalue );
+    }
     // Loop through data and cache to the appropriate object
+    // Loop through data and cache to the appropriate object.
     foreach ( $cache as $object_type => $object_caches ) {
         // Determine the cache group for this data
+        // Determine the cache group for this data.
         $cache_group = $cache_groups[ $object_type ];
         // Loop through objects and cache appropriately
+        // Loop through objects and cache appropriately.
         foreach ( $object_caches as $object_id => $object_cache ) {
             wp_cache_set( $object_id, $object_cache, $cache_group );
 …
 /**
  * Clear cached XProfile field group data
+ * Clear cached XProfile field group data.
+ *
  * @since 2.1.0
+ *
  * @param object $group_obj
+ * @param object $group_obj Groub object to clear.
  */
 function xprofile_clear_profile_groups_object_cache( $group_obj ) {
 …
 /**
  * Clear cached XProfile fullname data for user
+ * Clear cached XProfile fullname data for user.
+ *
  * @since 2.1.0
+ *
  * @param int $user_id ID of user whose fullname cache to delete
+ * @param int $user_id ID of user whose fullname cache to delete.
  */
 function xprofile_clear_profile_data_object_cache( $user_id = 0 ) {
 …
  * Clear the fullname cache when field 1 is updated.
+ *
+ * xprofile_clear_profile_data_object_cache() will make this redundant in most
+ * cases, except where the field is updated directly with xprofile_set_field_data()
+ *
+ * @since 2.0.0
+ * The xprofile_clear_profile_data_object_cache() will make this redundant in most
+ * cases, except where the field is updated directly with xprofile_set_field_data().
+ *
+ * @since 2.0.0
+ *
+ * @param object $data Data object to clear.
  */
 function xprofile_clear_fullname_cache_on_profile_field_edit( $data ) {
 …
  * @since 2.0.0
+ *
  * @param BP_XProfile_Field
+ * @param BP_XProfile_Field $field_obj Field object cache to delete.
  */
 function xprofile_clear_profile_field_object_cache( $field_obj ) {
     // Clear default visibility level cache
+    // Clear default visibility level cache.
     wp_cache_delete( 'default_visibility_levels', 'bp_xprofile' );
     // Modified fields can alter parent group status, in particular when
     // the group goes from empty to non-empty. Bust its cache, as well as
     // the global 'all' cache
+    // the global 'all' cache.
     wp_cache_delete( 'all',                'bp_xprofile_groups' );
     wp_cache_delete( $field_obj->group_id, 'bp_xprofile_groups' );
 …
  * @since 2.0.0
+ *
  * @param BP_XProfile_ProfileData $data_obj
+ * @param BP_XProfile_ProfileData $data_obj Field data object to delete.
  */
 function xprofile_clear_profiledata_object_cache( $data_obj ) {
 …
 add_action( 'update_option_bp-xprofile-fullname-field-name', 'xprofile_clear_fullname_field_id_cache' );
 // List actions to clear super cached pages on, if super cache is installed
+// List actions to clear super cached pages on, if super cache is installed.
 add_action( 'xprofile_updated_profile', 'bp_core_clear_cache' );

trunk/src/bp-xprofile/bp-xprofile-caps.php

-                      r10140
+                      r10163
 /**
  * Maps XProfile caps to built in WordPress caps
+ * Maps XProfile caps to built in WordPress caps.
+ *
  * @since 1.6.0
+ *
+ * @param array $caps Capabilities for meta capability
+ * @param string $cap Capability name
+ * @param int $user_id User id
+ * @param mixed $args Arguments
+ * @uses get_post() To get the post
+ * @uses get_post_type_object() To get the post type object
+ * @uses apply_filters() Calls 'bp_map_meta_caps' with caps, cap, user id and
+ *                        args
+ * @return array Actual capabilities for meta capability
+ * @param array  $caps    Capabilities for meta capability.
+ * @param string $cap     Capability name.
+ * @param int    $user_id User id.
+ * @param mixed  $args    Arguments.
+ *
+ * @uses get_post() To get the post.
+ * @uses get_post_type_object() To get the post type object.
+ * @uses apply_filters() Calls 'bp_map_meta_caps' with caps, cap, user id and args.
+ *
+ * @return array Actual capabilities for meta capability.
  */
 function bp_xprofile_map_meta_caps( $caps, $cap, $user_id, $args ) {
     switch ( $cap ) {
         case 'bp_xprofile_change_field_visibility' :
             $caps = array( 'exist' ); // Must allow for logged-out users during registration
+            $caps = array( 'exist' ); // Must allow for logged-out users during registration.
             // You may pass args manually: $field_id, $profile_user_id
+            // You may pass args manually: $field_id, $profile_user_id.
             $field_id        = isset( $args[0] ) ? (int)$args[0] : bp_get_the_profile_field_id();
             $profile_user_id = isset( $args[1] ) ? (int)$args[1] : bp_displayed_user_id();
             // Visibility on the fullname field is not editable
+            // Visibility on the fullname field is not editable.
             if ( 1 == $field_id ) {
                 $caps[] = 'do_not_allow';
 …
+            }
             // Friends don't let friends edit each other's visibility
+            // Friends don't let friends edit each other's visibility.
             if ( $profile_user_id != bp_displayed_user_id() && !bp_current_user_can( 'bp_moderate' ) ) {
                 $caps[] = 'do_not_allow';

trunk/src/bp-xprofile/bp-xprofile-cssjs.php

-                      r10140
+                      r10163
 /**
  * Enqueue the CSS for XProfile admin styling
+ * Enqueue the CSS for XProfile admin styling.
+ *
  * @since 1.1.0
 …
 /**
  * Enqueue the jQuery libraries for handling drag/drop/sort
+ * Enqueue the jQuery libraries for handling drag/drop/sort.
+ *
  * @since 1.5.0
 …
         // supports_options_field_types is a dynamic list of field
         // types that support options, for use in showing/hiding the
         // "please enter options for this field" section
+        // "please enter options for this field" section.
         $strings = array(
             'supports_options_field_types' => array(),

trunk/src/bp-xprofile/bp-xprofile-filters.php

-                      r10140
+                      r10163
 add_filter( 'xprofile_filtered_data_value_before_save', 'trim', 2 );
 // Save field groups
+// Save field groups.
 add_filter( 'xprofile_group_name_before_save',        'wp_filter_kses' );
 add_filter( 'xprofile_group_description_before_save', 'wp_filter_kses' );
 // Save fields
+// Save fields.
 add_filter( 'xprofile_field_name_before_save',         'wp_filter_kses' );
 add_filter( 'xprofile_field_type_before_save',         'wp_filter_kses' );
 …
 add_filter( 'xprofile_field_can_delete_before_save',   'absint' );
 // Save field options
+// Save field options.
 add_filter( 'xprofile_field_options_before_save', 'bp_xprofile_sanitize_field_options' );
 add_filter( 'xprofile_field_default_before_save', 'bp_xprofile_sanitize_field_default' );
 /**
  * Sanitize each field option name for saving to the database
+ * Sanitize each field option name for saving to the database.
+ *
  * @since 2.3.0
+ *
+ * @param  mixed $field_options
+ * @param  mixed $field_options Options to sanitize.
+ *
  * @return mixed
  */
 …
 /**
  * Sanitize each field option default for saving to the database
+ * Sanitize each field option default for saving to the database.
+ *
  * @since 2.3.0
+ *
+ * @param  mixed $field_default
+ * @param  mixed $field_default Field defaults to sanitize.
+ *
  * @return mixed
  */
 …
 /**
- * xprofile_filter_kses ( $content )
+ *
  * Run profile field values through kses with filterable allowed tags.
+ *
+ * @param string $content
+ * @param object $data_obj The BP_XProfile_ProfileData object
+ * @param string $content  Content to filter.
+ * @param object $data_obj The BP_XProfile_ProfileData object.
+ *
  * @return string $content
  */
 …
  * Safely runs profile field data through kses and force_balance_tags.
+ *
+ * @param string $field_value
+ * @param int $field_id
+ * @param bool $reserialize Whether to reserialize arrays before returning. Defaults to true
+ * @param object $data_obj The BP_XProfile_ProfileData object
+ * @param string $field_value Field value being santized.
+ * @param int    $field_id    Field ID being sanitized.
+ * @param bool   $reserialize Whether to reserialize arrays before returning. Defaults to true.
+ * @param object $data_obj    The BP_XProfile_ProfileData object.
+ *
  * @return string
  */
 function xprofile_sanitize_data_value_before_save( $field_value, $field_id = 0, $reserialize = true, $data_obj = null ) {
     // Return if empty
+    // Return if empty.
     if ( empty( $field_value ) ) {
         return $field_value;
+    }
     // Value might be serialized
+    // Value might be serialized.
     $field_value = maybe_unserialize( $field_value );
     // Filter single value
+    // Filter single value.
     if ( !is_array( $field_value ) ) {
         $kses_field_value     = xprofile_filter_kses( $field_value, $data_obj );
 …
         $filtered_field_value = apply_filters( 'xprofile_filtered_data_value_before_save', $filtered_field_value, $field_value, $data_obj );
     // Filter each array item independently
+    // Filter each array item independently.
     } else {
         $filtered_values = array();
 …
+ *
  * @param string $field_value XProfile field_value to be filtered.
+ * @param string $field_type XProfile field_type to be filtered.
+ * @param string $field_type  XProfile field_type to be filtered.
+ *
  * @return string $field_value Filtered XProfile field_value. False on failure.
  */
 function xprofile_filter_format_field_value( $field_value, $field_type = '' ) {
     // Valid field values of 0 or '0' get caught by empty(), so we have an extra check for these. See #BP5731
+    // Valid field values of 0 or '0' get caught by empty(), so we have an extra check for these. See #BP5731.
     if ( ! isset( $field_value ) || empty( $field_value ) && ( '0' !== $field_value ) ) {
         return false;
 …
 /**
+ * Apply display_filter() filters as defined by the BP_XProfile_Field_Type classes, when fetched inside a bp_has_profile() loop.
+ * Apply display_filter() filters as defined by the BP_XProfile_Field_Type classes, when fetched inside
+ * a bp_has_profile() loop.
+ *
  * @since 2.1.0
+ *
+ * @param mixed $field_value Field value.
+ * @param string $field_type Field type.
+ * @param mixed  $field_value Field value.
+ * @param string $field_type  Field type.
+ *
  * @return mixed
  */
 …
 /**
+ * Apply display_filter() filters as defined by the BP_XProfile_Field_Type classes, when fetched by xprofile_get_field_data().
+ * Apply display_filter() filters as defined by the BP_XProfile_Field_Type classes, when fetched
+ * by xprofile_get_field_data().
+ *
  * @since 2.1.0
+ *
  * @param mixed $field_value Field value.
+ * @param int $field_id Field type.
+ * @param int   $field_id    Field type.
+ *
+ * @return string
  */
 function xprofile_filter_format_field_value_by_field_id( $field_value, $field_id ) {
 …
  * @since 2.1.0
+ *
  * @param mixed $value Value passed to the bp_xprofile_set_field_data_pre_validate
  *        filter.
  * @param BP_XProfile_Field $field Field object.
  * @param BP_XProfile_Field_Type Field type object.
+ * @param mixed                  $value          Value passed to the bp_xprofile_set_field_data_pre_validate filter.
+ * @param BP_XProfile_Field      $field          Field object.
+ * @param BP_XProfile_Field_Type $field_type_obj Field type object.
+ *
  * @return mixed
  */
 …
  * to members search results out of them.
+ *
  * - Not run on datebox field types
  * - Not run on values without commas with less than 5 words
  * - URL's are made clickable
+ * - Not run on datebox field types.
+ * - Not run on values without commas with less than 5 words.
+ * - URL's are made clickable.
  * - To disable: remove_filter( 'bp_get_the_profile_field_value', 'xprofile_filter_link_profile_data', 9, 2 );
+ *
  * @since 1.1.0
+ *
+ * @param string $field_value
+ * @param string  $field_type
+ * @param string $field_value Profile field data value.
+ * @param string $field_type  Profile field type.
+ *
  * @return string
  */
 …
                 $new_values[] = make_clickable( $value );
             // Is not clickable
+            // Is not clickable.
             } else {
                 // More than 5 spaces
+                // More than 5 spaces.
                 if ( count( explode( ' ', $value ) ) > 5 ) {
                     $new_values[] = $value;
                 // Less than 5 spaces
+                // Less than 5 spaces.
                 } else {
                     $search_url   = add_query_arg( array( 's' => urlencode( $value ) ), bp_get_members_directory_permalink() );
 …
 /**
  * Ensures that BP data appears in comments array
+ * Ensures that BP data appears in comments array.
+ *
  * This filter loops through the comments return by a normal WordPress request
+ * and swaps out user data with BP xprofile data, where available
+ *
+ * @param array $comments
+ * @param int $post_id
+ * and swaps out user data with BP xprofile data, where available.
+ *
+ * @param array $comments Comments to filter in.
+ * @param int   $post_id  Post ID the comments are for.
+ *
  * @return array $comments
  */
 function xprofile_filter_comments( $comments, $post_id = 0 ) {
     // Locate comment authors with WP accounts
+    // Locate comment authors with WP accounts.
     foreach( (array) $comments as $comment ) {
         if ( $comment->user_id ) {
 …
+    }
     // If none are found, just return the comments array
+    // If none are found, just return the comments array.
     if ( empty( $user_ids ) ) {
         return $comments;
+    }
     // Pull up the xprofile fullname of each commenter
+    // Pull up the xprofile fullname of each commenter.
     if ( $fullnames = bp_core_get_user_displaynames( $user_ids ) ) {
         foreach( (array) $fullnames as $user_id => $user_fullname ) {
 …
+    }
     // Loop through and match xprofile fullname with commenters
+    // Loop through and match xprofile fullname with commenters.
     foreach( (array) $comments as $i => $comment ) {
         if ( ! empty( $comment->user_id ) ) {
 …
 /**
  * Filter BP_User_Query::populate_extras to override each queries users fullname
+ * Filter BP_User_Query::populate_extras to override each queries users fullname.
+ *
  * @since 1.7.0
+ *
  * @param BP_User_Query $user_query
  * @param string $user_ids_sql
+ * @param BP_User_Query $user_query   User query to filter.
+ * @param string        $user_ids_sql SQL statement to use.
  */
 function bp_xprofile_filter_user_query_populate_extras( BP_User_Query $user_query, $user_ids_sql = '' ) {
 …
     $user_id_names = bp_core_get_user_displaynames( $user_query->user_ids );
     // Loop through names and override each user's fullname
+    // Loop through names and override each user's fullname.
     foreach ( $user_id_names as $user_id => $user_fullname ) {
         if ( isset( $user_query->results[ $user_id ] ) ) {
 …
  * @since 2.2.0
+ *
  * @param BP_User_Query User query object.
+ * @param BP_User_Query $q User query object.
  */
 function bp_xprofile_add_xprofile_query_to_user_query( BP_User_Query $q ) {
     // Bail if no `xprofile_query` clause
+    // Bail if no `xprofile_query` clause.
     if ( empty( $q->query_vars['xprofile_query'] ) ) {
         return;
 …
+ *
  * @param string $q SQL query.
+ *
  * @return string
  */
 …
     $q = preg_replace( $quoted_regex, '__QUOTE__', $q );
     // Get the first word of the command
+    // Get the first word of the command.
     preg_match( '/^(\S+)/', $q, $first_word_matches );
 …
+    }
     // Get the field type
+    // Get the field type.
     preg_match( '/xprofile_(group|field|data)_id/', $q, $matches );

trunk/src/bp-xprofile/bp-xprofile-functions.php

-                      r10140
+                      r10163
+ *
  * @param array $args See {@link BP_XProfile_Group::get()} for description of
+ *        arguments.
+ *                    arguments.
+ *
  * @return array $groups
  */
 …
 /**
  * Insert a new profile field group
+ * Insert a new profile field group.
+ *
  * @since 1.0.0
+ *
+ * @param type $args
+ * @param array|string $args Array of arguments for field group insertion.
+ *
  * @return boolean
  */
 function xprofile_insert_field_group( $args = '' ) {
     // Parse the arguments
+    // Parse the arguments.
     $r = bp_parse_args( $args, array(
         'field_group_id' => false,
 …
     ), 'xprofile_insert_field_group' );
     // Bail if no group name
+    // Bail if no group name.
     if ( empty( $r['name'] ) ) {
         return false;
+    }
     // Create new field group object, maybe using an existing ID
+    // Create new field group object, maybe using an existing ID.
     $field_group              = new BP_XProfile_Group( $r['field_group_id'] );
     $field_group->name        = $r['name'];
 …
 /**
  * Get a specific profile field group
+ * Get a specific profile field group.
+ *
  * @since 1.0.0
+ *
+ * @param int $field_group_id
+ * @param int $field_group_id Field group ID to fetch.
+ *
  * @return boolean|BP_XProfile_Group
  */
 function xprofile_get_field_group( $field_group_id = 0 ) {
     // Try to get a specific field group by ID
+    // Try to get a specific field group by ID.
     $field_group = new BP_XProfile_Group( $field_group_id );
     // Bail if group was not found
+    // Bail if group was not found.
     if ( empty( $field_group->id ) ) {
         return false;
+    }
     // Return field group
+    // Return field group.
     return $field_group;
+}
 /**
  * Delete a specific profile field group
+ * Delete a specific profile field group.
+ *
  * @since 1.0.0
+ *
+ * @param int $field_group_id
+ * @param int $field_group_id Field group ID to delete.
+ *
  * @return boolean
  */
 function xprofile_delete_field_group( $field_group_id = 0 ) {
     // Try to get a specific field group by ID
+    // Try to get a specific field group by ID.
     $field_group = xprofile_get_field_group( $field_group_id );
     // Bail if group was not found
+    // Bail if group was not found.
     if ( false === $field_group ) {
         return false;
+    }
     // Return the results of trying to delete the field group
+    // Return the results of trying to delete the field group.
     return $field_group->delete();
+}
 /**
  * Update the position of a specific profile field group
+ * Update the position of a specific profile field group.
+ *
  * @since 1.0.0
+ *
+ * @param int $field_group_id
+ * @param int $position
+ * @return bool
+ * @param int $field_group_id Field group ID to update.
+ * @param int $position       Field group position to update to.
+ *
+ * @return boolean
  */
 function xprofile_update_field_group_position( $field_group_id = 0, $position = 0 ) {
 …
+}
 /*** Field Management *********************************************************/
 …
  * Get details of all xprofile field types.
+ *
+ * @since 2.0.0
+ *
  * @return array Key/value pairs (field type => class name).
- * @since 2.0.0
  */
 function bp_xprofile_get_field_types() {
 …
  * Creates the specified field type object; used for validation and templating.
+ *
+ * @since 2.0.0
+ *
  * @param string $type Type of profile field to create. See {@link bp_xprofile_get_field_types()} for default core values.
+ * @return object If field type unknown, returns BP_XProfile_Field_Type_Textarea. Otherwise returns an instance of the relevant child class of BP_XProfile_Field_Type.
+ * @since 2.0.0
+ *
+ * @return object $value If field type unknown, returns BP_XProfile_Field_Type_Textarea.
+ *                       Otherwise returns an instance of the relevant child class of BP_XProfile_Field_Type.
  */
 function bp_xprofile_create_field_type( $type ) {
 …
  * Insert or update an xprofile field.
+ *
  * @param array $args {
+ * @param array|string $args {
  *     Array of arguments.
  *     @type int    $field_id          Optional. Pass the ID of an existing field to edit that field.
 …
     ) );
     // field_group_id is required
+    // Field_group_id is required.
     if ( empty( $r['field_group_id'] ) ) {
         return false;
 …
+    }
     // Instantiate a new field object
+    // Instantiate a new field object.
     if ( ! empty( $r['field_id'] ) ) {
         $field = new BP_XProfile_Field( $r['field_id'] );
 …
+}
 /*** Field Data Management *****************************************************/
 /**
 …
  * each item in the array.
+ *
+ * @package BuddyPress Core
+ * @param mixed $field         The ID of the field, or the $name of the field.
+ * @param int $user_id         The ID of the user
+ * @uses BP_XProfile_ProfileData::get_value_byid() Fetches the value based on the params passed.
+ *
+ * @param mixed  $field        The ID of the field, or the $name of the field.
+ * @param int    $user_id      The ID of the user.
  * @param string $multi_format How should array data be returned? 'comma' if you want a
  *                             comma-separated string; 'array' if you want an array
  * @uses BP_XProfile_ProfileData::get_value_byid() Fetches the value based on the params passed.
+ *                             comma-separated string; 'array' if you want an array.
+ *
  * @return mixed The profile field data.
  */
 …
     return $data;
+}
 /**
  * A simple function to set profile data for a specific field for a specific user.
+ *
+ * @package BuddyPress Core
+ * @param int|string $field The ID of the field, or the $name of the field.
+ * @param int|$user_id      The ID of the user
+ * @param mixed $value      The value for the field you want to set for the user.
+ * @param $is_required      Whether or not the field is required
+ * @uses xprofile_get_field_id_from_name() Gets the ID for the field based on the name.
+ * @uses xprofile_get_field_id_from_name() Gets the ID from the field based on the name.
+ *
+ * @param int|string $field       The ID of the field, or the $name of the field.
+ * @param int        $user_id     The ID of the user.
+ * @param mixed      $value       The value for the field you want to set for the user.
+ * @param bool       $is_required Whether or not the field is required.
+ *
  * @return bool True on success, false on failure.
  */
 …
      * @since 2.1.0
+     *
      * @param mixed $value Value passed to xprofile_set_field_data()
      * @param BP_XProfile_Field $field Field object.
+     * @param mixed                  $value          Value passed to xprofile_set_field_data().
+     * @param BP_XProfile_Field      $field          Field object.
      * @param BP_XProfile_Field_Type $field_type_obj Field type object.
      */
     $value = apply_filters( 'bp_xprofile_set_field_data_pre_validate', $value, $field, $field_type_obj );
     // Special-case support for integer 0 for the number field type
+    // Special-case support for integer 0 for the number field type.
     if ( $is_required && ! is_integer( $value ) && $value !== '0' && ( empty( $value ) || ! is_array( $value ) && ! strlen( trim( $value ) ) ) ) {
         return false;
 …
+    }
+    // If the value is empty, then delete any field data that exists, unless the field is of a type where null values are semantically meaningful
+    // If the value is empty, then delete any field data that exists, unless the field is of a type
+    // where null values are semantically meaningful.
     if ( empty( $value ) && ! is_integer( $value ) && $value !== '0' && ! $field_type_obj->accepts_null_value ) {
         xprofile_delete_field_data( $field_id, $user_id );
 …
 /**
+ * Set the visibility level for this field
+ *
+ * @param int $field_id The ID of the xprofile field
+ * @param int $user_id The ID of the user to whom the data belongs
+ * @param string $visibility_level
+ * Set the visibility level for this field.
+ *
+ * @param int    $field_id         The ID of the xprofile field.
+ * @param int    $user_id          The ID of the user to whom the data belongs.
+ * @param string $visibility_level What the visibity setting should be.
+ *
  * @return bool True on success
  */
 …
+    }
     // Check against a whitelist
+    // Check against a whitelist.
     $allowed_values = bp_xprofile_get_visibility_levels();
     if ( !array_key_exists( $visibility_level, $allowed_values ) ) {
 …
+    }
     // Stored in an array in usermeta
+    // Stored in an array in usermeta.
     $current_visibility_levels = bp_get_user_meta( $user_id, 'bp_xprofile_visibility_levels', true );
 …
  * @param int $field_id The ID of the xprofile field.
  * @param int $user_id The ID of the user to whom the data belongs.
+ *
  * @return string
  */
 …
     $current_level  = isset( $current_levels[ $field_id ] ) ? $current_levels[ $field_id ] : '';
     // Use the user's stored level, unless custom visibility is disabled
+    // Use the user's stored level, unless custom visibility is disabled.
     $field = new BP_XProfile_Field( $field_id );
     if ( isset( $field->allow_custom_visibility ) && 'disabled' === $field->allow_custom_visibility ) {
 …
 function xprofile_delete_field_data( $field = '', $user_id = 0 ) {
     // Get the field ID
+    // Get the field ID.
     if ( is_numeric( $field ) ) {
         $field_id = (int) $field;
 …
+    }
     // Bail if field or user ID are empty
+    // Bail if field or user ID are empty.
     if ( empty( $field_id ) || empty( $user_id ) ) {
         return false;
+    }
     // Get the profile field data to delete
+    // Get the profile field data to delete.
     $field = new BP_XProfile_ProfileData( $field_id, $user_id );
     // Delete the field data
+    // Delete the field data.
     return $field->delete();
+}
 …
     $field = new BP_Xprofile_Field( $field_id );
     // Define locale variable(s)
+    // Define locale variable(s).
     $retval = false;
     // Super admins can skip required check
+    // Super admins can skip required check.
     if ( bp_current_user_can( 'bp_moderate' ) && ! is_admin() ) {
         $retval = false;
     // All other users will use the field's setting
+    // All other users will use the field's setting.
     } elseif ( isset( $field->is_required ) ) {
         $retval = $field->is_required;
 …
  * Fetches a random piece of profile data for the user.
+ *
+ * @package BuddyPress Core
+ * @param int $user_id User ID of the user to get random data for
+ * @param bool $exclude_fullname Optional; whether or not to exclude the full name field as random data. Defaults to true.
+ * @global BuddyPress $bp The one true BuddyPress instance
+ * @global $wpdb WordPress DB access object.
+ * @global $current_user WordPress global variable containing current logged in user information
+ * @global BuddyPress $bp           The one true BuddyPress instance.
+ * @global object     $wpdb         WordPress DB access object.
+ * @global object     $current_user WordPress global variable containing current logged in user information.
  * @uses xprofile_format_profile_field() Formats profile field data so it is suitable for display.
+ *
+ * @param int  $user_id          User ID of the user to get random data for.
+ * @param bool $exclude_fullname Optional; whether or not to exclude the full name field as random data.
+ *                               Defaults to true.
+ *
  * @return string|bool The fetched random data for the user, or false if no data or no match.
  */
 …
  * Formats a profile field according to its type. [ TODO: Should really be moved to filters ]
+ *
  * @package BuddyPress Core
  * @param string $field_type The type of field: datebox, selectbox, textbox etc
  * @param string $field_value The actual value
  * @return string|bool The formatted value, or false if value is empty
+ * @param string $field_type  The type of field: datebox, selectbox, textbox etc.
+ * @param string $field_value The actual value.
+ *
+ * @return string|bool The formatted value, or false if value is empty.
  */
 function xprofile_format_profile_field( $field_type, $field_value ) {
 …
 function xprofile_avatar_upload_dir( $directory = 'avatars', $user_id = 0 ) {
     // Use displayed user if no user ID was passed
+    // Use displayed user if no user ID was passed.
     if ( empty( $user_id ) ) {
         $user_id = bp_displayed_user_id();
+    }
     // Failsafe against accidentally nooped $directory parameter
+    // Failsafe against accidentally nooped $directory parameter.
     if ( empty( $directory ) ) {
         $directory = 'avatars';
 …
  * @since 2.0.0
+ *
+ * @param array $sql Clauses in the user_id SQL query.
+ * @param BP_User_Query User query object.
+ * @param array         $sql   Clauses in the user_id SQL query.
+ * @param BP_User_Query $query User query object.
+ *
+ * @return array
  */
 function bp_xprofile_bp_user_query_search( $sql, BP_User_Query $query ) {
 …
     // Combine the core search (against wp_users) into a single OR clause
     // with the xprofile_data search
+    // with the xprofile_data search.
     $search_xprofile = $wpdb->prepare(
         "u.{$query->uid_name} IN ( SELECT user_id FROM {$bp->profile->table_name_data} WHERE value LIKE %s OR value LIKE %s )",
 …
  * Syncs Xprofile data to the standard built in WordPress profile data.
+ *
+ * @package BuddyPress Core
+ * @param int $user_id ID of the user to sync.
+ *
+ * @return bool
  */
 function xprofile_sync_wp_profile( $user_id = 0 ) {
     // Bail if profile syncing is disabled
+    // Bail if profile syncing is disabled.
     if ( bp_disable_profile_sync() ) {
         return true;
 …
+ *
  * @since 1.2.4
+ * @package BuddyPress Core
+ *
+ * @param object $errors Array of errors. Passed by reference.
+ * @param bool   $update Whether or not being upated.
+ * @param object $user   User object whose profile is being synced. Passed by reference.
  */
 function xprofile_sync_bp_profile( &$errors, $update, &$user ) {
     // Bail if profile syncing is disabled
+    // Bail if profile syncing is disabled.
     if ( bp_disable_profile_sync() || ! $update || $errors->get_error_codes() ) {
         return;
 …
  * usermeta table that this component uses.
+ *
+ * @package BuddyPress XProfile
+ * @param int $user_id The ID of the deleted user
+ * @param int $user_id The ID of the deleted user.
  */
 function xprofile_remove_data( $user_id ) {
 …
  * Delete a piece of xprofile metadata.
+ *
+ * @param int $object_id ID of the object the metadata belongs to.
+ * @param string $object_type Type of object. 'group', 'field', or 'data'.
+ * @param string $meta_key Key of the metadata being deleted. If omitted, all
+ *        metadata for the object will be deleted.
+ * @param mixed $meta_value Optional. If provided, only metadata that matches
+ *        the value will be permitted.
+ * @param bool $delete_all Optional. If true, delete matching metadata entries
+ *    for all objects, ignoring the specified object_id. Otherwise, only
+ *    delete matching metadata entries for the specified object.
+ *    Default: false.
+ * @param int         $object_id   ID of the object the metadata belongs to.
+ * @param string      $object_type Type of object. 'group', 'field', or 'data'.
+ * @param string|bool $meta_key    Key of the metadata being deleted. If omitted, all
+ *                                 metadata for the object will be deleted.
+ * @param mixed       $meta_value  Optional. If provided, only metadata that matches
+ *                                 the value will be permitted.
+ * @param bool        $delete_all  Optional. If true, delete matching metadata entries
+ *                                 for all objects, ignoring the specified object_id. Otherwise, only
+ *                                 delete matching metadata entries for the specified object.
+ *                                 Default: false.
+ *
  * @return bool True on success, false on failure.
  */
 …
     global $wpdb;
     // Sanitize object type
+    // Sanitize object type.
     if ( ! in_array( $object_type, array( 'group', 'field', 'data' ) ) ) {
         return false;
+    }
     // Legacy - if no meta_key is passed, delete all for the item
+    // Legacy - if no meta_key is passed, delete all for the item.
     if ( empty( $meta_key ) ) {
         $table_key  = 'xprofile_' . $object_type . 'meta';
 …
         $keys = $wpdb->get_col( $wpdb->prepare( "SELECT meta_key FROM {$table_name} WHERE object_type = %s AND object_id = %d", $object_type, $object_id ) );
         // Force delete_all to false if deleting all for object
+        // Force delete_all to false if deleting all for object.
         $delete_all = false;
     } else {
 …
  * underlying get_metadata() function. This is for backward compatibility.
+ *
  * @param int $object_id ID of the object the metadata belongs to.
+ * @param int    $object_id   ID of the object the metadata belongs to.
  * @param string $object_type Type of object. 'group', 'field', or 'data'.
+ * @param string $meta_key Key of the metadata being fetched. If omitted, all
+ *        metadata for the object will be retrieved.
+ * @param bool $single Optional. If true, return only the first value of the
+ *    specified meta_key. This parameter has no effect if meta_key is not
+ *    specified. Default: true.
+ * @param string $meta_key    Key of the metadata being fetched. If omitted, all
+ *                            metadata for the object will be retrieved.
+ * @param bool   $single      Optional. If true, return only the first value of the
+ *                            specified meta_key. This parameter has no effect if meta_key is not
+ *                            specified. Default: true.
+ *
  * @return mixed Meta value if found. False on failure.
  */
 function bp_xprofile_get_meta( $object_id, $object_type, $meta_key = '', $single = true ) {
     // Sanitize object type
+    // Sanitize object type.
     if ( ! in_array( $object_type, array( 'group', 'field', 'data' ) ) ) {
         return false;
 …
  * Update a piece of xprofile metadata.
+ *
  * @param int $object_id ID of the object the metadata belongs to.
+ * @param int    $object_id   ID of the object the metadata belongs to.
  * @param string $object_type Type of object. 'group', 'field', or 'data'.
+ * @param string $meta_key Key of the metadata being updated.
+ * @param mixed $meta_value Value of the metadata being updated.
+ * @param mixed $prev_value Optional. If specified, only update existing
+ *        metadata entries with the specified value. Otherwise, update all
+ *        entries.
+ * @param string $meta_key    Key of the metadata being updated.
+ * @param mixed  $meta_value  Value of the metadata being updated.
+ * @param mixed  $prev_value  Optional. If specified, only update existing
+ *                            metadata entries with the specified value.
+ *                            Otherwise update all entries.
+ *
  * @return bool|int Returns false on failure. On successful update of existing
  *         metadata, returns true. On successful creation of new metadata,
  *         returns the integer ID of the new metadata row.
+ *                  metadata, returns true. On successful creation of new metadata,
+ *                  returns the integer ID of the new metadata row.
  */
 function bp_xprofile_update_meta( $object_id, $object_type, $meta_key, $meta_value, $prev_value = '' ) {
 …
  * @since 2.0.0
+ *
  * @param int $object_id ID of the object the metadata belongs to.
+ * @param int    $object_id   ID of the object the metadata belongs to.
  * @param string $object_type Type of object. 'group', 'field', or 'data'.
+ * @param string $meta_key Metadata key.
+ * @param mixed $meta_value Metadata value.
+ * @param bool $unique Optional. Whether to enforce a single metadata value
+ *        for the given key. If true, and the object already has a value for
+ *        the key, no change will be made. Default: false.
+ * @param string $meta_key    Metadata key.
+ * @param mixed  $meta_value  Metadata value.
+ * @param bool   $unique      Optional. Whether to enforce a single metadata value
+ *                            for the given key. If true, and the object already
+ *                            has a value for the key, no change will be made.
+ *                            Default false.
+ *
  * @return int|bool The meta ID on successful update, false on failure.
  */
 …
 /**
  * Return the field name for the Full Name xprofile field
+ * Return the field name for the Full Name xprofile field.
+ *
  * @package BuddyPress
  * @since 1.5.0
+ *
  * @return string The field name
+ * @return string The field name.
  */
 function bp_xprofile_fullname_field_name() {
 …
 /**
  * Get visibility levels out of the $bp global
+ * Get visibility levels out of the $bp global.
+ *
  * @return array
 …
 /**
  * Get the ids of fields that are hidden for this displayed/loggedin user pair
+ * Get the ids of fields that are hidden for this displayed/loggedin user pair.
+ *
  * This is the function primarily responsible for profile field visibility. It works by determining
 …
  * @see BP_XProfile_Group::get()
  * @uses apply_filters() Filter bp_xprofile_get_hidden_fields_for_user to modify visibility levels,
+ *   or if you have added your own custom levels
+ *
+ * @param int $displayed_user_id The id of the user the profile fields belong to
+ * @param int $current_user_id The id of the user viewing the profile
+ *   or if you have added your own custom levels.
+ *
+ * @param int $displayed_user_id The id of the user the profile fields belong to.
+ * @param int $current_user_id   The id of the user viewing the profile.
+ *
  * @return array An array of field ids that should be excluded from the profile query
  */
 …
 /**
  * Get the visibility levels that should be hidden for this user pair
+ * Get the visibility levels that should be hidden for this user pair.
+ *
  * Field visibility is determined based on the relationship between the
 …
  * @see bp_xprofile_get_hidden_fields_for_user()
+ *
+ * @param int $displayed_user_id The id of the user the profile fields belong to
+ * @param int $current_user_id The id of the user viewing the profile
+ * @return array An array of visibility levels hidden to the current user
+ * @param int $displayed_user_id The id of the user the profile fields belong to.
+ * @param int $current_user_id   The id of the user viewing the profile.
+ *
+ * @return array An array of visibility levels hidden to the current user.
  */
 function bp_xprofile_get_hidden_field_types_for_user( $displayed_user_id = 0, $current_user_id = 0 ) {
     // Current user is logged in
+    // Current user is logged in.
     if ( ! empty( $current_user_id ) ) {
         // Nothing's private when viewing your own profile, or when the
         // current user is an admin
+        // current user is an admin.
         if ( $displayed_user_id == $current_user_id || bp_current_user_can( 'bp_moderate' ) ) {
             $hidden_levels = array();
         // If the current user and displayed user are friends, show all
+        // If the current user and displayed user are friends, show all.
         } elseif ( bp_is_active( 'friends' ) && friends_check_friendship( $displayed_user_id, $current_user_id ) ) {
             $hidden_levels = array( 'adminsonly', );
         // current user is logged in but not friends, so exclude friends-only
+        // Current user is logged in but not friends, so exclude friends-only.
         } else {
             $hidden_levels = array( 'friends', 'adminsonly', );
 …
 /**
  * Fetch an array of the xprofile fields that a given user has marked with certain visibility levels
+ * Fetch an array of the xprofile fields that a given user has marked with certain visibility levels.
+ *
  * @since 1.6.0
  * @see bp_xprofile_get_hidden_fields_for_user()
+ *
+ * @param int $user_id The id of the profile owner
+ * @param array $levels An array of visibility levels ('public', 'friends', 'loggedin', 'adminsonly' etc) to be
+ *    checked against
+ * @return array $field_ids The fields that match the requested visibility levels for the given user
+ * @param int   $user_id The id of the profile owner.
+ * @param array $levels  An array of visibility levels ('public', 'friends', 'loggedin', 'adminsonly' etc) to be
+ *                       checked against.
+ *
+ * @return array $field_ids The fields that match the requested visibility levels for the given user.
  */
 function bp_xprofile_get_fields_by_visibility_levels( $user_id, $levels = array() ) {
 …
     // Parse the user-provided visibility levels with the default levels, which may take
     // precedence
+    // precedence.
     $default_visibility_levels = BP_XProfile_Group::fetch_default_visibility_levels();
     foreach( (array) $default_visibility_levels as $d_field_id => $defaults ) {
         // If the admin has forbidden custom visibility levels for this field, replace
         // the user-provided setting with the default specified by the admin
+        // the user-provided setting with the default specified by the admin.
         if ( isset( $defaults['allow_custom'] ) && isset( $defaults['default'] ) && 'disabled' == $defaults['allow_custom'] ) {
             $user_visibility_levels[$d_field_id] = $defaults['default'];
 …
+    }
     // Never allow the fullname field to be excluded
+    // Never allow the fullname field to be excluded.
     if ( in_array( 1, $field_ids ) ) {
         $key = array_search( 1, $field_ids );

trunk/src/bp-xprofile/bp-xprofile-loader.php

-                      r10157
+                      r10163
     /**
      * Profile field types
+     * Profile field types.
+     *
      * @since 1.5.0
 …
     /**
      * Start the xprofile component creation process
+     * Start the xprofile component creation process.
+     *
      * @since 1.5.0
 …
     /**
+     * Include files
+     * Include files.
+     *
+     * @param array $includes
      */
     public function includes( $includes = array() ) {
 …
     /**
      * Setup globals
+     * Setup globals.
+     *
      * The BP_XPROFILE_SLUG constant is deprecated, and only used here for
 …
+     *
      * @since 1.5.0
+     *
+     * @param array $args Array of globals to set up.
      */
     public function setup_globals( $args = array() ) {
         $bp = buddypress();
         // Define a slug, if necessary
+        // Define a slug, if necessary.
         if ( !defined( 'BP_XPROFILE_SLUG' ) ) {
             define( 'BP_XPROFILE_SLUG', 'profile' );
 …
         // Assign the base group and fullname field names to constants
         // to use in SQL statements.
         // Defined conditionally to accommodate unit tests
+        // Defined conditionally to accommodate unit tests.
         if ( ! defined( 'BP_XPROFILE_BASE_GROUP_NAME' ) ) {
             define( 'BP_XPROFILE_BASE_GROUP_NAME', stripslashes( bp_core_get_root_option( 'avatar_default' ) ) );
 …
         // 'option' is a special case. It is not a top-level field, so
         // does not have an associated BP_XProfile_Field_Type class,
         // but it must be whitelisted
+        // but it must be whitelisted.
         $this->field_types[] = 'option';
         // Register the visibility levels. See bp_xprofile_get_visibility_levels() to filter
+        // Register the visibility levels. See bp_xprofile_get_visibility_levels() to filter.
         $this->visibility_levels = array(
             'public' => array(
 …
+        }
         // Tables
+        // Tables.
         $global_tables = array(
             'table_name_data'   => $bp->table_prefix . 'bp_xprofile_data',
 …
+     *
      * @global BuddyPress $bp The one true BuddyPress instance
+     *
+     * @param array $main_nav Array of main nav items to set up.
+     * @param array $sub_nav  Array of sub nav items to set up.
      */
     public function setup_nav( $main_nav = array(), $sub_nav = array() ) {
         // Determine user to use
+        // Determine user to use.
         if ( bp_displayed_user_domain() ) {
             $user_domain = bp_displayed_user_domain();
 …
         $profile_link = trailingslashit( $user_domain . $slug );
         // Add 'Profile' to the main navigation
+        // Add 'Profile' to the main navigation.
         $main_nav = array(
             'name'                => _x( 'Profile', 'Profile header menu', 'buddypress' ),
 …
         );
         // Add the subnav items to the profile
+        // Add the subnav items to the profile.
         $sub_nav[] = array(
             'name'            => _x( 'View', 'Profile header sub menu', 'buddypress' ),
 …
         );
         // Edit Profile
+        // Edit Profile.
         $sub_nav[] = array(
             'name'            => _x( 'Edit','Profile header sub menu', 'buddypress' ),
 …
         );
         // Change Avatar
+        // Change Avatar.
         if ( buddypress()->avatar->show_avatars ) {
             $sub_nav[] = array(
 …
         // The Settings > Profile nav item can only be set up after
         // the Settings component has run its own nav routine
+        // the Settings component has run its own nav routine.
         add_action( 'bp_settings_setup_nav', array( $this, 'setup_settings_nav' ) );
 …
+        }
         // Determine user to use
+        // Determine user to use.
         if ( bp_displayed_user_domain() ) {
             $user_domain = bp_displayed_user_domain();
 …
+        }
         // Get the settings slug
+        // Get the settings slug.
         $settings_slug = bp_get_settings_slug();
 …
     /**
+     * Set up the Toolbar
+     * Set up the Admin Bar.
+     *
+     * @param array $wp_admin_nav Admin Bar items.
      */
     public function setup_admin_bar( $wp_admin_nav = array() ) {
         // Menus for logged in user
+        // Menus for logged in user.
         if ( is_user_logged_in() ) {
             // Profile link
+            // Profile link.
             $profile_link = trailingslashit( bp_loggedin_user_domain() . bp_get_profile_slug() );
             // Add the "Profile" sub menu
+            // Add the "Profile" sub menu.
             $wp_admin_nav[] = array(
                 'parent' => buddypress()->my_account_menu_id,
 …
             );
             // View Profile
+            // View Profile.
             $wp_admin_nav[] = array(
                 'parent' => 'my-account-' . $this->id,
 …
             );
             // Edit Profile
+            // Edit Profile.
             $wp_admin_nav[] = array(
                 'parent' => 'my-account-' . $this->id,
 …
             );
             // Edit Avatar
+            // Edit Avatar.
             if ( buddypress()->avatar->show_avatars ) {
                 $wp_admin_nav[] = array(
 …
     /**
      * Sets up the title for pages and <title>
+     * Sets up the title for pages and <title>.
      */
     public function setup_title() {
 …
     /**
      * Setup cache groups
+     * Setup cache groups.
+     *
      * @since 2.2.0
 …
     public function setup_cache_groups() {
         // Global groups
+        // Global groups.
         wp_cache_add_global_groups( array(
             'bp_xprofile',
 …
+     *
      * @param array $wp_admin_nav The settings adminbar nav array.
+     *
      * @return array
      */
     public function setup_settings_admin_nav( $wp_admin_nav ) {
         // Setup the logged in user variables
+        // Setup the logged in user variables.
         $settings_link = trailingslashit( bp_loggedin_user_domain() . bp_get_settings_slug() );
         // Add the "Profile" subnav item
+        // Add the "Profile" subnav item.
         $wp_admin_nav[] = array(
             'parent' => 'my-account-' . buddypress()->settings->id,

trunk/src/bp-xprofile/bp-xprofile-screens.php

-                      r10157
+                      r10163
  * Handles the display of the profile page by loading the correct template file.
+ *
+ * @package BuddyPress XProfile
+ * @uses bp_core_load_template() Looks for and loads a template file within the current member theme (folder/filename)
+ * @uses bp_core_load_template() Looks for and loads a template file within the current member theme (folder/filename).
  */
 function xprofile_screen_display_profile() {
 …
  * Also checks to make sure this can only be accessed for the logged in users profile.
+ *
+ * @package BuddyPress XProfile
+ * @uses bp_is_my_profile() Checks to make sure the current user being viewed equals the logged in user
+ * @uses bp_core_load_template() Looks for and loads a template file within the current member theme (folder/filename)
+ * @uses bp_is_my_profile() Checks to make sure the current user being viewed equals the logged in user.
+ * @uses bp_core_load_template() Looks for and loads a template file within the current member theme (folder/filename).
  */
 function xprofile_screen_edit_profile() {
 …
+    }
     // Check the field group exists
+    // Check the field group exists.
     if ( ! bp_is_action_variable( 'group' ) || ! xprofile_get_field_group( bp_action_variable( 1 ) ) ) {
         bp_do_404();
 …
+    }
     // No errors
+    // No errors.
     $errors = false;
     // Check to see if any new information has been submitted
+    // Check to see if any new information has been submitted.
     if ( isset( $_POST['field_ids'] ) ) {
         // Check the nonce
+        // Check the nonce.
         check_admin_referer( 'bp_xprofile_edit' );
         // Check we have field ID's
+        // Check we have field ID's.
         if ( empty( $_POST['field_ids'] ) ) {
             bp_core_redirect( trailingslashit( bp_displayed_user_domain() . bp_get_profile_slug() . '/edit/group/' . bp_action_variable( 1 ) ) );
 …
         // Explode the posted field IDs into an array so we know which
         // fields have been submitted
+        // fields have been submitted.
         $posted_field_ids = wp_parse_id_list( $_POST['field_ids'] );
         $is_required      = array();
         // Loop through the posted fields formatting any datebox values
         // then validate the field
+        // then validate the field.
         foreach ( (array) $posted_field_ids as $field_id ) {
             if ( !isset( $_POST['field_' . $field_id] ) ) {
                 if ( !empty( $_POST['field_' . $field_id . '_day'] ) && !empty( $_POST['field_' . $field_id . '_month'] ) && !empty( $_POST['field_' . $field_id . '_year'] ) ) {
                     // Concatenate the values
+                    // Concatenate the values.
                     $date_value =   $_POST['field_' . $field_id . '_day'] . ' ' . $_POST['field_' . $field_id . '_month'] . ' ' . $_POST['field_' . $field_id . '_year'];
                     // Turn the concatenated value into a timestamp
+                    // Turn the concatenated value into a timestamp.
                     $_POST['field_' . $field_id] = date( 'Y-m-d H:i:s', strtotime( $date_value ) );
+                }
 …
+        }
         // There are errors
+        // There are errors.
         if ( !empty( $errors ) ) {
             bp_core_add_message( __( 'Please make sure you fill in all required fields in this profile field group before saving.', 'buddypress' ), 'error' );
         // No errors
+        // No errors.
         } else {
             // Reset the errors var
+            // Reset the errors var.
             $errors = false;
 …
                 // Save the old and new values. They will be
                 // passed to the filter and used to determine
                 // whether an activity item should be posted
+                // whether an activity item should be posted.
                 $old_values[ $field_id ] = array(
                     'value'      => xprofile_get_field_data( $field_id, bp_displayed_user_id() ),
 …
                 );
                 // Update the field data and visibility level
+                // Update the field data and visibility level.
                 xprofile_set_field_visibility_level( $field_id, bp_displayed_user_id(), $visibility_level );
                 $field_updated = xprofile_set_field_data( $field_id, bp_displayed_user_id(), $value, $is_required[ $field_id ] );
 …
             do_action( 'xprofile_updated_profile', bp_displayed_user_id(), $posted_field_ids, $errors, $old_values, $new_values );
             // Set the feedback messages
+            // Set the feedback messages.
             if ( !empty( $errors ) ) {
                 bp_core_add_message( __( 'There was a problem updating some of your profile information. Please try again.', 'buddypress' ), 'error' );
 …
+            }
             // Redirect back to the edit screen to display the updates and message
+            // Redirect back to the edit screen to display the updates and message.
             bp_core_redirect( trailingslashit( bp_displayed_user_domain() . bp_get_profile_slug() . '/edit/group/' . bp_action_variable( 1 ) ) );
+        }
 …
  * Handles the uploading and cropping of a user avatar. Displays the change avatar page.
+ *
+ * @package BuddyPress XProfile
+ * @uses bp_is_my_profile() Checks to make sure the current user being viewed equals the logged in user
+ * @uses bp_core_load_template() Looks for and loads a template file within the current member theme (folder/filename)
+ * @uses bp_is_my_profile() Checks to make sure the current user being viewed equals the logged in user.
+ * @uses bp_core_load_template() Looks for and loads a template file within the current member theme (folder/filename).
  */
 function xprofile_screen_change_avatar() {
     // Bail if not the correct screen
+    // Bail if not the correct screen.
     if ( ! bp_is_my_profile() && ! bp_current_user_can( 'bp_moderate' ) ) {
         return false;
+    }
     // Bail if there are action variables
+    // Bail if there are action variables.
     if ( bp_action_variables() ) {
         bp_do_404();
 …
     if ( !empty( $_FILES ) ) {
         // Check the nonce
+        // Check the nonce.
         check_admin_referer( 'bp_avatar_upload' );
         // Pass the file to the avatar upload handler
+        // Pass the file to the avatar upload handler.
         if ( bp_core_avatar_handle_upload( $_FILES, 'xprofile_avatar_upload_dir' ) ) {
             $bp->avatar_admin->step = 'crop-image';
             // Make sure we include the jQuery jCrop file for image cropping
+            // Make sure we include the jQuery jCrop file for image cropping.
             add_action( 'wp_print_scripts', 'bp_core_add_jquery_cropper' );
+        }
+    }
     // If the image cropping is done, crop the image and save a full/thumb version
+    // If the image cropping is done, crop the image and save a full/thumb version.
     if ( isset( $_POST['avatar-crop-submit'] ) ) {
         // Check the nonce
+        // Check the nonce.
         check_admin_referer( 'bp_avatar_cropstore' );
 …
              * @since 1.1.0
              * @since 2.3.4 Add two new parameters to inform about the user id and
              *              about the way the avatar was set (eg: 'crop' or 'camera')
+             *              about the way the avatar was set (eg: 'crop' or 'camera').
+             *
              * @param string $item_id Inform about the user id the avatar was set for
              * @param string $value Inform about the way the avatar was set ('crop')
+             * @param string $item_id Inform about the user id the avatar was set for.
+             * @param string $value   Inform about the way the avatar was set ('crop').
              */
             do_action( 'xprofile_avatar_uploaded', (int) $args['item_id'], 'crop' );
 …
 /**
  * Show the xprofile settings template
+ * Show the xprofile settings template.
+ *
  * @since 2.0.0
 …
 function bp_xprofile_screen_settings() {
     // Redirect if no privacy settings page is accessible
+    // Redirect if no privacy settings page is accessible.
     if ( bp_action_variables() || ! bp_is_active( 'xprofile' ) ) {
         bp_do_404();

trunk/src/bp-xprofile/bp-xprofile-settings.php

-                      r10140
+                      r10163
 /**
  * Query all profile fields and their visibility data for display in settings
+ * Query all profile fields and their visibility data for display in settings.
+ *
  * @since 2.0.0
+ *
  * @param array $args
+ * @param array|string $args Array of args for the settings fields.
+ *
  * @return array
 …
 function bp_xprofile_get_settings_fields( $args = '' ) {
     // Parse the possible arguments
+    // Parse the possible arguments.
     $r = bp_parse_args( $args, array(
         'user_id'                => bp_displayed_user_id(),
 …
 /**
  * Adds feedback messages when successfully saving profile field settings
+ * Adds feedback messages when successfully saving profile field settings.
+ *
  * @since 2.0.0
 …
 function bp_xprofile_settings_add_feedback_message() {
     // Default message type is success
+    // Default message type is success.
     $type    = 'success';
     $message = __( 'Your profile settings have been saved.',        'buddypress' );
     // Community moderator editing another user's settings
+    // Community moderator editing another user's settings.
     if ( ! bp_is_my_profile() && bp_core_can_edit_settings() ) {
         $message = __( "This member's profile settings have been saved.", 'buddypress' );
+    }
     // Add the message
+    // Add the message.
     bp_core_add_message( $message, $type );
+}

trunk/src/bp-xprofile/bp-xprofile-template.php

-                      r10140
+                      r10163
      * @since 2.4.0 Introduced `$member_type` argument.
+     *
      * @param array $args {
+     * @param array|string $args {
      *     An array of arguments. All items are optional.
+     *
 …
     public function __construct( $args = '' ) {
         // Backward compatibility with old method of passing arguments
+        // Backward compatibility with old method of passing arguments.
         if ( ! is_array( $args ) || func_num_args() > 1 ) {
             _deprecated_argument( __METHOD__, '2.3.0', sprintf( __( 'Arguments passed to %1$s should be in an associative array. See the inline documentation at %2$s for more details.', 'buddypress' ), __METHOD__, __FILE__ ) );
 …
             do_action( 'xprofile_template_loop_end' );
             // Do some cleaning up after the loop
+            // Do some cleaning up after the loop.
             $this->rewind_groups();
+        }
 …
         $group = $this->next_group();
         // loop has just started
+        // Loop has just started.
         if ( 0 === $this->current_group ) {
 …
             return true;
         } elseif ( $this->current_field + 1 == $this->field_count ) {
             // Do some cleaning up after the loop
+            // Do some cleaning up after the loop.
             $this->rewind_fields();
+        }
 …
         $field = $this->next_field();
         // Valid field values of 0 or '0' get caught by empty(), so we have an extra check for these. See #BP5731
+        // Valid field values of 0 or '0' get caught by empty(), so we have an extra check for these. See #BP5731.
         if ( ! empty( $field->data ) && ( ! empty( $field->data->value ) || ( '0' === $field->data->value ) ) ) {
             $value = maybe_unserialize( $field->data->value );
 …
 /**
  * Query for XProfile groups and fields
+ * Query for XProfile groups and fields.
+ *
  * @since 1.0.0
 …
  * @see BP_XProfile_Group::get() for full description of `$args` array.
+ *
  * @param array $args {
+ * @param array|string $args {
  *     Array of arguments. See BP_XProfile_Group::get() for full description. Those arguments whose defaults differ
  *     from that method are described here:
 …
     // Only show empty fields if we're on the Dashboard, or we're on a user's
     // profile edit page, or this is a registration page
+    // profile edit page, or this is a registration page.
     $hide_empty_fields_default = ( ! is_network_admin() && ! is_admin() && ! bp_is_user_profile_edit() && ! bp_is_register_page() );
     // We only need to fetch visibility levels when viewing your own profile
+    // We only need to fetch visibility levels when viewing your own profile.
     if ( bp_is_my_profile() || bp_current_user_can( 'bp_moderate' ) || bp_is_register_page() ) {
         $fetch_visibility_level_default = true;
 …
+    }
     // Parse arguments
+    // Parse arguments.
     $r = bp_parse_args( $args, array(
         'user_id'                => bp_displayed_user_id(),
 …
         'fetch_field_data'       => true,
         'fetch_visibility_level' => $fetch_visibility_level_default,
         'exclude_groups'         => false, // Comma-separated list of profile field group IDs to exclude
         'exclude_fields'         => false, // Comma-separated list of profile field IDs to exclude
+        'exclude_groups'         => false, // Comma-separated list of profile field group IDs to exclude.
+        'exclude_fields'         => false, // Comma-separated list of profile field IDs to exclude.
         'update_meta_cache'      => true,
     ), 'has_profile' );
     // Populate the template loop global
+    // Populate the template loop global.
     $profile_template = new BP_XProfile_Data_Template( $r );
 …
+        }
         // Set a class with the field ID
+        // Set a class with the field ID.
         $css_classes[] = 'field_' . $profile_template->field->id;
         // Set a class with the field name (sanitized)
+        // Set a class with the field name (sanitized).
         $css_classes[] = 'field_' . sanitize_title( $profile_template->field->name );
         // Set a class indicating whether the field is required or optional
+        // Set a class indicating whether the field is required or optional.
         if ( ! empty( $profile_template->field->is_required ) ) {
             $css_classes[] = 'required-field';
 …
+        }
         // Add the field visibility level
+        // Add the field visibility level.
         $css_classes[] = 'visibility-' . esc_attr( bp_get_the_profile_field_visibility_level() );
 …
         global $group;
         // Build the form action URL
+        // Build the form action URL.
         $form_action = trailingslashit( bp_displayed_user_domain() . bp_get_profile_slug() . '/edit/group/' . $group->id );
 …
 /**
  * Returns the action name for any signup errors related to this profile field
+ * Returns the action name for any signup errors related to this profile field.
+ *
  * In the registration templates, signup errors are pulled from the global
 …
+ *
  * @since 1.8.0
+ * @return string The _errors action name corresponding to this profile field
+ *
+ * @return string The _errors action name corresponding to this profile field.
  */
 function bp_get_the_profile_field_errors_action() {
 …
 /**
- * bp_the_profile_field_options()
+ *
  * Displays field options HTML for field types of 'selectbox', 'multiselectbox',
  * 'radio', 'checkbox', and 'datebox'.
+ *
- * @package BuddyPress Xprofile
  * @since 1.1.0
+ *
 …
+}
     /**
-     * bp_get_the_profile_field_options()
+     *
      * Retrieves field options HTML for field types of 'selectbox', 'multiselectbox', 'radio', 'checkbox', and 'datebox'.
+     *
-     * @package BuddyPress Xprofile
      * @since 1.1.0
+     *
 …
      * @param array $args {
      *     Array of optional arguments.
      *     @type string|bool $type Type of datebox. False if it's not a
      *           datebox, otherwise 'day, 'month', or 'year'. Default: false.
      *     @type int $user_id ID of the user whose profile values should be
      *           used when rendering options. Default: displayed user.
+     *     @type string|bool $type    Type of datebox. False if it's not a
+     *                                datebox, otherwise 'day, 'month', or 'year'. Default: false.
+     *     @type int         $user_id ID of the user whose profile values should be
+     *                                used when rendering options. Default: displayed user.
      * }
+     *
+     * @return string $vaue Field options markup.
      */
     function bp_get_the_profile_field_options( $args = array() ) {
 …
         global $field;
         // Define locale variable(s)
+        // Define locale variable(s).
         $retval = false;
         // Super admins can skip required check
+        // Super admins can skip required check.
         if ( bp_current_user_can( 'bp_moderate' ) && !is_admin() ) {
             $retval = false;
         // All other users will use the field's setting
+        // All other users will use the field's setting.
         } elseif ( isset( $field->is_required ) ) {
             $retval = $field->is_required;
 …
 /**
  * Echo the visibility level of this field
+ * Echo the visibility level of this field.
  */
 function bp_the_profile_field_visibility_level() {
 …
+}
     /**
      * Return the visibility level of this field
+     * Return the visibility level of this field.
      */
     function bp_get_the_profile_field_visibility_level() {
 …
         // On the registration page, values stored in POST should take
         // precedence over default visibility, so that submitted values
         // are not lost on failure
+        // are not lost on failure.
         if ( bp_is_register_page() && ! empty( $_POST['field_' . $field->id . '_visibility'] ) ) {
             $retval = esc_attr( $_POST['field_' . $field->id . '_visibility'] );
 …
 /**
  * Echo the visibility level label of this field
+ * Echo the visibility level label of this field.
  */
 function bp_the_profile_field_visibility_level_label() {
 …
+}
     /**
      * Return the visibility level label of this field
+     * Return the visibility level label of this field.
      */
     function bp_get_the_profile_field_visibility_level_label() {
 …
         // On the registration page, values stored in POST should take
         // precedence over default visibility, so that submitted values
         // are not lost on failure
+        // are not lost on failure.
         if ( bp_is_register_page() && ! empty( $_POST['field_' . $field->id . '_visibility'] ) ) {
             $level = esc_html( $_POST['field_' . $field->id . '_visibility'] );
 …
  * Get all profile field groups.
+ *
  * @since  2.1.0
+ * @since 2.1.0
+ *
  * @return object $groups
 …
  * Check if there is more than one group of fields for the profile being edited.
+ *
  * @since  2.1.0
+ * @since 2.1.0
+ *
  * @return bool True if there is more than one profile field group.
 …
+ *
  * @since 1.0.0
+ *
- * @return string Field group tabs markup.
  */
 function bp_profile_group_tabs() {
 …
 /**
  * Return the XProfile group tabs
+ * Return the XProfile group tabs.
+ *
  * @since 2.3.0
 …
 function bp_get_profile_group_tabs() {
     // Get field group data
+    // Get field group data.
     $groups     = bp_profile_get_field_groups();
     $group_name = bp_get_profile_group_name();
     $tabs       = array();
     // Loop through field groups and put a tab-lst together
+    // Loop through field groups and put a tab-lst together.
     for ( $i = 0, $count = count( $groups ); $i < $count; ++$i ) {
         // Setup the selected class
+        // Setup the selected class.
         $selected = '';
         if ( $group_name === $groups[ $i ]->name ) {
 …
+        }
         // Skip if group has no fields
+        // Skip if group has no fields.
         if ( empty( $groups[ $i ]->fields ) ) {
             continue;
+        }
         // Build the profile field group link
+        // Build the profile field group link.
         $link   = trailingslashit( bp_displayed_user_domain() . bp_get_profile_slug() . '/edit/group/' . $groups[ $i ]->id );
         // Add tab to end of tabs array
+        // Add tab to end of tabs array.
         $tabs[] = sprintf(
             '<li %1$s><a href="%2$s">%3$s</a></li>',
 …
     function bp_get_profile_group_name() {
         // Check action variable
+        // Check action variable.
         $group_id = bp_action_variable( 1 );
         if ( empty( $group_id ) || ! is_numeric( $group_id ) ) {
 …
+        }
         // Check for cached group
+        // Check for cached group.
         $group = new BP_XProfile_Group( $group_id );
 …
          * Filters the current profile group ID.
+         *
          * Possible values are admin/profile/edit/[group-id]
+         * Possible values are admin/profile/edit/[group-id].
+         *
          * @since 1.1.0
 …
 /**
+ * Echo the field visibility radio buttons
+ * Echo the field visibility radio buttons.
+ *
+ * @param array|string $args Args for the radio buttons.
  */
 function bp_profile_visibility_radio_buttons( $args = '' ) {
 …
+}
     /**
+     * Return the field visibility radio buttons
+     * Return the field visibility radio buttons.
+     *
+     * @param array|string $args Args for the radio buttons.
+     *
+     * @return string $retval
      */
     function bp_profile_get_visibility_radio_buttons( $args = '' ) {
         // Parse optional arguments
+        // Parse optional arguments.
         $r = bp_parse_args( $args, array(
             'field_id'     => bp_get_the_profile_field_id(),
 …
         ), 'xprofile_visibility_radio_buttons' );
         // Empty return value, filled in below if a valid field ID is found
+        // Empty return value, filled in below if a valid field ID is found.
         $retval = '';
         // Only do-the-do if there's a valid field ID
+        // Only do-the-do if there's a valid field ID.
         if ( ! empty( $r['field_id'] ) ) :
             // Start the output buffer
+            // Start the output buffer.
             ob_start();
             // Output anything before
+            // Output anything before.
             echo $r['before']; ?>
 …
             <?php endif;
             // Output anything after
+            // Output anything after.
             echo $r['after'];
             // Get the output buffer and empty it
+            // Get the output buffer and empty it.
             $retval = ob_get_clean();
         endif;
 …
 /**
  * Output the XProfile field visibility select list for settings
+ * Output the XProfile field visibility select list for settings.
+ *
  * @since 2.0.0
+ *
+ * @param array|string $args Args for the select list.
  */
 function bp_profile_settings_visibility_select( $args = '' ) {
 …
+}
     /**
      * Return the XProfile field visibility select list for settings
+     * Return the XProfile field visibility select list for settings.
+     *
      * @since 2.0.0
+     *
+     * @param array|string $args Args for the select list.
+     *
+     * @return string $retval
      */
     function bp_profile_get_settings_visibility_select( $args = '' ) {
         // Parse optional arguments
+        // Parse optional arguments.
         $r = bp_parse_args( $args, array(
             'field_id' => bp_get_the_profile_field_id(),
 …
         ), 'xprofile_settings_visibility_select' );
         // Empty return value, filled in below if a valid field ID is found
+        // Empty return value, filled in below if a valid field ID is found.
         $retval = '';
         // Only do-the-do if there's a valid field ID
+        // Only do-the-do if there's a valid field ID.
         if ( ! empty( $r['field_id'] ) ) :
             // Start the output buffer
+            // Start the output buffer.
             ob_start();
             // Output anything before
+            // Output anything before.
             echo $r['before']; ?>
 …
             <?php endif;
             // Output anything after
+            // Output anything after.
             echo $r['after'];
             // Get the output buffer and empty it
+            // Get the output buffer and empty it.
             $retval = ob_get_clean();
         endif;

trunk/src/bp-xprofile/classes/class-bp-xprofile-field-type-checkbox.php

-                      r10140
+                      r10163
     /**
      * Constructor for the checkbox field type
+     * Constructor for the checkbox field type.
+     *
      * @since 2.0.0
      */
+     */
     public function __construct() {
         parent::__construct();
 …
      * Must be used inside the {@link bp_profile_fields()} template loop.
+     *
-     * @param array $raw_properties Optional key/value array of {@link http://dev.w3.org/html5/markup/input.checkbox.html permitted attributes} that you want to add.
      * @since 2.0.0
+     *
+     * @param array $raw_properties Optional key/value array of
+     *                              {@link http://dev.w3.org/html5/markup/input.checkbox.html permitted attributes}
+     *                              that you want to add.
      */
     public function edit_field_html( array $raw_properties = array() ) {
         // user_id is a special optional parameter that we pass to
+        // User_id is a special optional parameter that we pass to
         // {@link bp_the_profile_field_options()}.
         if ( isset( $raw_properties['user_id'] ) ) {
 …
      * Must be used inside the {@link bp_profile_fields()} template loop.
+     *
+     * @since 2.0.0
+     *
      * @param array $args Optional. The arguments passed to {@link bp_the_profile_field_options()}.
-     * @since 2.0.0
      */
     public function edit_field_options_html( array $args = array() ) {
 …
         // Check for updated posted values, but errors preventing them from
         // being saved first time
+        // being saved first time.
         if ( isset( $_POST['field_' . $this->field_obj->id] ) && $option_values != maybe_serialize( $_POST['field_' . $this->field_obj->id] ) ) {
             if ( ! empty( $_POST['field_' . $this->field_obj->id] ) ) {
 …
             $selected = '';
             // First, check to see whether the user's saved values match the option
+            // First, check to see whether the user's saved values match the option.
             for ( $j = 0, $count_values = count( $option_values ); $j < $count_values; ++$j ) {
                 // Run the allowed option name through the before_save filter,
                 // so we'll be sure to get a match
+                // so we'll be sure to get a match.
                 $allowed_options = xprofile_sanitize_data_value_before_save( $options[$k]->name, false, false );
 …
             // If the user has not yet supplied a value for this field, check to
             // see whether there is a default value available
+            // see whether there is a default value available.
             if ( empty( $option_values ) && empty( $selected ) && ! empty( $options[$k]->is_default_option ) ) {
                 $selected = ' checked="checked"';
 …
      * Must be used inside the {@link bp_profile_fields()} template loop.
+     *
+     * @since 2.0.0
+     *
      * @param array $raw_properties Optional key/value array of permitted attributes that you want to add.
-     * @since 2.0.0
      */
     public function admin_field_html( array $raw_properties = array() ) {
 …
      * Must be used inside the {@link bp_profile_fields()} template loop.
+     *
+     * @since 2.0.0
+     *
      * @param BP_XProfile_Field $current_field The current profile field on the add/edit screen.
      * @param string $control_type Optional. HTML input type used to render the current field's child options.
      * @since 2.0.0
+     * @param string            $control_type  Optional. HTML input type used to render the current
+     *                                         field's child options.
      */
     public function admin_new_field_html( BP_XProfile_Field $current_field, $control_type = '' ) {

trunk/src/bp-xprofile/classes/class-bp-xprofile-field-type-datebox.php

-                      r10140
+                      r10163
     /**
      * Constructor for the datebox field type
+     *
      * @since 2.0.0
      */
+     * Constructor for the datebox field type.
+     *
+     * @since 2.0.0
+     */
     public function __construct() {
         parent::__construct();
 …
      * Must be used inside the {@link bp_profile_fields()} template loop.
+     *
+     * @param array $raw_properties Optional key/value array of {@link http://dev.w3.org/html5/markup/input.html permitted attributes} that you want to add.
+     * @since 2.0.0
+     * @since 2.0.0
+     *
+     * @param array $raw_properties Optional key/value array of
+     *                              {@link http://dev.w3.org/html5/markup/input.html permitted attributes}
+     *                              that you want to add.
      */
     public function edit_field_html( array $raw_properties = array() ) {
         // user_id is a special optional parameter that we pass to
+        // User_id is a special optional parameter that we pass to.
         // {@link bp_the_profile_field_options()}.
         if ( isset( $raw_properties['user_id'] ) ) {
 …
      * Must be used inside the {@link bp_profile_fields()} template loop.
+     *
+     * @since 2.0.0
+     *
      * @param array $args Optional. The arguments passed to {@link bp_the_profile_field_options()}.
-     * @since 2.0.0
      */
     public function edit_field_options_html( array $args = array() ) {
 …
         $eng_months = array( 'January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December' );
         // Set day, month, year defaults
+        // Set day, month, year defaults.
         if ( ! empty( $date ) ) {
             // If Unix timestamp
+            // If Unix timestamp.
             if ( is_numeric( $date ) ) {
                 $day   = date( 'j', $date );
 …
                 $year  = date( 'Y', $date );
             // If MySQL timestamp
+            // If MySQL timestamp.
             } else {
                 $day   = mysql2date( 'j', $date );
                 $month = mysql2date( 'F', $date, false ); // Not localized, so that selected() works below
+                $month = mysql2date( 'F', $date, false ); // Not localized, so that selected() works below.
                 $year  = mysql2date( 'Y', $date );
+            }
 …
+        }
         // $type will be passed by calling function when needed
+        // $type will be passed by calling function when needed.
         switch ( $args['type'] ) {
             case 'day':
 …
      * Must be used inside the {@link bp_profile_fields()} template loop.
+     *
+     * @since 2.0.0
+     *
      * @param array $raw_properties Optional key/value array of permitted attributes that you want to add.
-     * @since 2.0.0
      */
     public function admin_field_html( array $raw_properties = array() ) {
 …
      * "Add Field" and "Edit Field" screens, but for this field type, we don't want it, so it's stubbed out.
+     *
+     * @since 2.0.0
+     *
      * @param BP_XProfile_Field $current_field The current profile field on the add/edit screen.
      * @param string $control_type Optional. HTML input type used to render the current field's child options.
      * @since 2.0.0
+     * @param string            $control_type  Optional. HTML input type used to render the current
+     *                                         field's child options.
      */
     public function admin_new_field_html( BP_XProfile_Field $current_field, $control_type = '' ) {}
 …
+     *
      * @param string $field_value The date value, as saved in the database.
+     *        Typically, this is a MySQL-formatted date string (Y-m-d H:i:s).
+     *                            Typically, this is a MySQL-formatted date
+     *                            string (Y-m-d H:i:s).
+     *
      * @return string Date formatted by bp_format_time().
      */
     public static function display_filter( $field_value ) {
         // If Unix timestamp
+        // If Unix timestamp.
         if ( ! is_numeric( $field_value ) ) {
             $field_value = strtotime( $field_value );

trunk/src/bp-xprofile/classes/class-bp-xprofile-field-type-multiselectbox.php

-                      r10140
+                      r10163
     /**
      * Constructor for the multi-selectbox field type
+     *
      * @since 2.0.0
      */
+     * Constructor for the multi-selectbox field type.
+     *
+     * @since 2.0.0
+     */
     public function __construct() {
         parent::__construct();
 …
      * Must be used inside the {@link bp_profile_fields()} template loop.
+     *
+     * @param array $raw_properties Optional key/value array of {@link http://dev.w3.org/html5/markup/select.html permitted attributes} that you want to add.
+     * @since 2.0.0
+     * @since 2.0.0
+     *
+     * @param array $raw_properties Optional key/value array of
+     *                              {@link http://dev.w3.org/html5/markup/select.html permitted attributes}
+     *                              that you want to add.
      */
     public function edit_field_html( array $raw_properties = array() ) {
         // user_id is a special optional parameter that we pass to
+        // User_id is a special optional parameter that we pass to
         // {@link bp_the_profile_field_options()}.
         if ( isset( $raw_properties['user_id'] ) ) {
 …
      * Must be used inside the {@link bp_profile_fields()} template loop.
+     *
+     * @since 2.0.0
+     *
      * @param array $args Optional. The arguments passed to {@link bp_the_profile_field_options()}.
-     * @since 2.0.0
      */
     public function edit_field_options_html( array $args = array() ) {
 …
             // Check for updated posted values, but errors preventing them from
             // being saved first time
+            // being saved first time.
             foreach( $option_values as $i => $option_value ) {
                 if ( isset( $_POST['field_' . $this->field_obj->id] ) && $_POST['field_' . $this->field_obj->id][$i] != $option_value ) {
 …
             // Run the allowed option name through the before_save filter, so
             // we'll be sure to get a match
+            // we'll be sure to get a match.
             $allowed_options = xprofile_sanitize_data_value_before_save( $options[$k]->name, false, false );
             // First, check to see whether the user-entered value matches
+            // First, check to see whether the user-entered value matches.
             if ( in_array( $allowed_options, $option_values ) ) {
                 $selected = ' selected="selected"';
+            }
             // Then, if the user has not provided a value, check for defaults
+            // Then, if the user has not provided a value, check for defaults.
             if ( ! is_array( $original_option_values ) && empty( $option_values ) && ! empty( $options[$k]->is_default_option ) ) {
                 $selected = ' selected="selected"';
 …
      * Must be used inside the {@link bp_profile_fields()} template loop.
+     *
+     * @since 2.0.0
+     *
      * @param array $raw_properties Optional key/value array of permitted attributes that you want to add.
-     * @since 2.0.0
      */
     public function admin_field_html( array $raw_properties = array() ) {
 …
     /**
+     * Output HTML for this field type's children options on the wp-admin Profile Fields "Add Field" and "Edit Field" screens.
+     *
+     * Must be used inside the {@link bp_profile_fields()} template loop.
+     * Output HTML for this field type's children options on the wp-admin Profile Fields,
+     * "Add Field" and "Edit Field" screens.
+     *
+     * Must be used inside the {@link bp_profile_fields()} template loop.
+     *
+     * @since 2.0.0
+     *
      * @param BP_XProfile_Field $current_field The current profile field on the add/edit screen.
      * @param string $control_type Optional. HTML input type used to render the current field's child options.
      * @since 2.0.0
+     * @param string            $control_type  Optional. HTML input type used to render the current
+     *                                         field's child options.
      */
     public function admin_new_field_html( BP_XProfile_Field $current_field, $control_type = '' ) {

trunk/src/bp-xprofile/classes/class-bp-xprofile-field-type-number.php

-                      r10142
+                      r10163
 <?php
 /**
  * BuddyPress XProfile Classes
+ * BuddyPress XProfile Classes.
+ *
  * @package BuddyPress
 …
     /**
      * Constructor for the number field type
+     * Constructor for the number field type.
+     *
      * @since 2.0.0
      */
+     */
     public function __construct() {
         parent::__construct();
 …
      * Must be used inside the {@link bp_profile_fields()} template loop.
+     *
-     * @param array $raw_properties Optional key/value array of {@link http://dev.w3.org/html5/markup/input.number.html permitted attributes} that you want to add.
      * @since 2.0.0
+     *
+     * @param array $raw_properties Optional key/value array of
+     *                              {@link http://dev.w3.org/html5/markup/input.number.html permitted attributes}
+     *                              that you want to add.
      */
     public function edit_field_html( array $raw_properties = array() ) {
         // user_id is a special optional parameter that certain other fields
+        // User_id is a special optional parameter that certain other fields
         // types pass to {@link bp_the_profile_field_options()}.
         if ( isset( $raw_properties['user_id'] ) ) {
 …
      * Must be used inside the {@link bp_profile_fields()} template loop.
+     *
+     * @since 2.0.0
+     *
      * @param array $raw_properties Optional key/value array of permitted attributes that you want to add.
-     * @since 2.0.0
      */
     public function admin_field_html( array $raw_properties = array() ) {
 …
      * "Add Field" and "Edit Field" screens, but for this field type, we don't want it, so it's stubbed out.
+     *
+     * @since 2.0.0
+     *
      * @param BP_XProfile_Field $current_field The current profile field on the add/edit screen.
      * @param string $control_type Optional. HTML input type used to render the current field's child options.
      * @since 2.0.0
+     * @param string            $control_type  Optional. HTML input type used to render the current
+     *                                         field's child options.
      */
     public function admin_new_field_html( BP_XProfile_Field $current_field, $control_type = '' ) {}

trunk/src/bp-xprofile/classes/class-bp-xprofile-field-type-placeholder.php

-                      r10142
+                      r10163
 <?php
 /**
  * BuddyPress XProfile Classes
+ * BuddyPress XProfile Classes.
+ *
  * @package BuddyPress
 …
      * Prevent any HTML being output for this field type.
+     *
-     * @param array $raw_properties Optional key/value array of {@link http://dev.w3.org/html5/markup/input.text.html permitted attributes} that you want to add.
      * @since 2.0.1
+     *
+     * @param array $raw_properties Optional key/value array of
+     *                              {@link http://dev.w3.org/html5/markup/input.text.html permitted attributes}
+     *                              that you want to add.
      */
     public function edit_field_html( array $raw_properties = array() ) {
 …
      * Prevent any HTML being output for this field type.
+     *
+     * @since 2.0.1
+     *
      * @param array $raw_properties Optional key/value array of permitted attributes that you want to add.
-     * @since 2.0.1
      */
     public function admin_field_html( array $raw_properties = array() ) {
 …
      * Prevent any HTML being output for this field type.
+     *
+     * @since 2.0.1
+     *
      * @param BP_XProfile_Field $current_field The current profile field on the add/edit screen.
      * @param string $control_type Optional. HTML input type used to render the current field's child options.
      * @since 2.0.1
+     * @param string            $control_type  Optional. HTML input type used to render the current
+     *                                         field's child options.
      */
     public function admin_new_field_html( BP_XProfile_Field $current_field, $control_type = '' ) {}

trunk/src/bp-xprofile/classes/class-bp-xprofile-field-type-radiobutton.php

-                      r10142
+                      r10163
 <?php
 /**
  * BuddyPress XProfile Classes
+ * BuddyPress XProfile Classes.
+ *
  * @package BuddyPress
 …
  */
 // Exit if accessed directly
+// Exit if accessed directly.
 defined( 'ABSPATH' ) || exit;
 …
+     *
      * @since 2.0.0
      */
+     */
     public function __construct() {
         parent::__construct();
 …
      * Must be used inside the {@link bp_profile_fields()} template loop.
+     *
-     * @param array $raw_properties Optional key/value array of {@link http://dev.w3.org/html5/markup/input.radio.html permitted attributes} that you want to add.
      * @since 2.0.0
+     *
+     * @param array $raw_properties Optional key/value array of
+     *                              {@link http://dev.w3.org/html5/markup/input.radio.html permitted attributes}
+     *                              that you want to add.
      */
     public function edit_field_html( array $raw_properties = array() ) {
         // user_id is a special optional parameter that we pass to
+        // User_id is a special optional parameter that we pass to
         // {@link bp_the_profile_field_options()}.
         if ( isset( $raw_properties['user_id'] ) ) {
 …
      * Must be used inside the {@link bp_profile_fields()} template loop.
+     *
+     * @since 2.0.0
+     *
      * @param array $args Optional. The arguments passed to {@link bp_the_profile_field_options()}.
-     * @since 2.0.0
      */
     public function edit_field_options_html( array $args = array() ) {
 …
             // Check for updated posted values, but errors preventing them from
             // being saved first time
+            // being saved first time.
             if ( isset( $_POST['field_' . $this->field_obj->id] ) && $option_value != $_POST['field_' . $this->field_obj->id] ) {
                 if ( ! empty( $_POST['field_' . $this->field_obj->id] ) ) {
 …
             // Run the allowed option name through the before_save filter, so
             // we'll be sure to get a match
+            // we'll be sure to get a match.
             $allowed_options = xprofile_sanitize_data_value_before_save( $options[$k]->name, false, false );
             $selected        = '';
 …
      * Must be used inside the {@link bp_profile_fields()} template loop.
+     *
+     * @since 2.0.0
+     *
      * @param array $raw_properties Optional key/value array of permitted attributes that you want to add.
-     * @since 2.0.0
      */
     public function admin_field_html( array $raw_properties = array() ) {
 …
      * Must be used inside the {@link bp_profile_fields()} template loop.
+     *
+     * @since 2.0.0
+     *
      * @param BP_XProfile_Field $current_field The current profile field on the add/edit screen.
      * @param string $control_type Optional. HTML input type used to render the current field's child options.
      * @since 2.0.0
+     * @param string            $control_type  Optional. HTML input type used to render the current
+     *                                         field's child options.
      */
     public function admin_new_field_html( BP_XProfile_Field $current_field, $control_type = '' ) {

trunk/src/bp-xprofile/classes/class-bp-xprofile-field-type-selectbox.php

-                      r10142
+                      r10163
 <?php
 /**
  * BuddyPress XProfile Classes
+ * BuddyPress XProfile Classes.
+ *
  * @package BuddyPress
 …
     /**
      * Constructor for the selectbox field type
+     * Constructor for the selectbox field type.
+     *
      * @since 2.0.0
      */
+     */
     public function __construct() {
         parent::__construct();
 …
      * Must be used inside the {@link bp_profile_fields()} template loop.
+     *
-     * @param array $raw_properties Optional key/value array of {@link http://dev.w3.org/html5/markup/select.html permitted attributes} that you want to add.
      * @since 2.0.0
+     *
+     * @param array $raw_properties Optional key/value array of
+     *                              {@link http://dev.w3.org/html5/markup/select.html permitted attributes}
+     *                              that you want to add.
      */
     public function edit_field_html( array $raw_properties = array() ) {
         // user_id is a special optional parameter that we pass to
+        // User_id is a special optional parameter that we pass to
         // {@link bp_the_profile_field_options()}.
         if ( isset( $raw_properties['user_id'] ) ) {
 …
      * Must be used inside the {@link bp_profile_fields()} template loop.
+     *
+     * @since 2.0.0
+     *
      * @param array $args Optional. The arguments passed to {@link bp_the_profile_field_options()}.
-     * @since 2.0.0
      */
     public function edit_field_options_html( array $args = array() ) {
 …
             // Check for updated posted values, but errors preventing them from
             // being saved first time
+            // being saved first time.
             foreach( $option_values as $i => $option_value ) {
                 if ( isset( $_POST['field_' . $this->field_obj->id] ) && $_POST['field_' . $this->field_obj->id] != $option_value ) {
 …
             // Run the allowed option name through the before_save filter, so
             // we'll be sure to get a match
+            // we'll be sure to get a match.
             $allowed_options = xprofile_sanitize_data_value_before_save( $options[$k]->name, false, false );
             // First, check to see whether the user-entered value matches
+            // First, check to see whether the user-entered value matches.
             if ( in_array( $allowed_options, $option_values ) ) {
                 $selected = ' selected="selected"';
+            }
             // Then, if the user has not provided a value, check for defaults
+            // Then, if the user has not provided a value, check for defaults.
             if ( ! is_array( $original_option_values ) && empty( $option_values ) && $options[$k]->is_default_option ) {
                 $selected = ' selected="selected"';
 …
      * Must be used inside the {@link bp_profile_fields()} template loop.
+     *
+     * @since 2.0.0
+     *
      * @param array $raw_properties Optional key/value array of permitted attributes that you want to add.
-     * @since 2.0.0
      */
     public function admin_field_html( array $raw_properties = array() ) {
 …
      * Must be used inside the {@link bp_profile_fields()} template loop.
+     *
+     * @since 2.0.0
+     *
      * @param BP_XProfile_Field $current_field The current profile field on the add/edit screen.
      * @param string $control_type Optional. HTML input type used to render the current field's child options.
      * @since 2.0.0
+     * @param string            $control_type  Optional. HTML input type used to render the current
+     *                                         field's child options.
      */
     public function admin_new_field_html( BP_XProfile_Field $current_field, $control_type = '' ) {

trunk/src/bp-xprofile/classes/class-bp-xprofile-field-type-textarea.php

-                      r10142
+                      r10163
 <?php
 /**
  * BuddyPress XProfile Classes
+ * BuddyPress XProfile Classes.
+ *
  * @package BuddyPress
 …
     /**
      * Constructor for the textarea field type
+     * Constructor for the textarea field type.
+     *
      * @since 2.0.0
      */
+     */
     public function __construct() {
         parent::__construct();
 …
      * Must be used inside the {@link bp_profile_fields()} template loop.
+     *
-     * @param array $raw_properties Optional key/value array of {@link http://dev.w3.org/html5/markup/textarea.html permitted attributes} that you want to add.
      * @since 2.0.0
+     *
+     * @param array $raw_properties Optional key/value array of
+     *                              {@link http://dev.w3.org/html5/markup/textarea.html permitted attributes}
+     *                              that you want to add.
      */
     public function edit_field_html( array $raw_properties = array() ) {
         // user_id is a special optional parameter that certain other fields
+        // User_id is a special optional parameter that certain other fields
         // types pass to {@link bp_the_profile_field_options()}.
         if ( isset( $raw_properties['user_id'] ) ) {
 …
      * Must be used inside the {@link bp_profile_fields()} template loop.
+     *
+     * @since 2.0.0
+     *
      * @param array $raw_properties Optional key/value array of permitted attributes that you want to add.
-     * @since 2.0.0
      */
     public function admin_field_html( array $raw_properties = array() ) {
 …
      * "Add Field" and "Edit Field" screens, but for this field type, we don't want it, so it's stubbed out.
+     *
+     * @since 2.0.0
+     *
      * @param BP_XProfile_Field $current_field The current profile field on the add/edit screen.
      * @param string $control_type Optional. HTML input type used to render the current field's child options.
      * @since 2.0.0
+     * @param string            $control_type  Optional. HTML input type used to render the current
+     *                                         field's child options.
      */
     public function admin_new_field_html( BP_XProfile_Field $current_field, $control_type = '' ) {}

trunk/src/bp-xprofile/classes/class-bp-xprofile-field-type-textbox.php

-                      r10142
+                      r10163
 <?php
 /**
  * BuddyPress XProfile Classes
+ * BuddyPress XProfile Classes.
+ *
  * @package BuddyPress
 …
     /**
      * Constructor for the textbox field type
+     * Constructor for the textbox field type.
+     *
      * @since 2.0.0
      */
+     */
     public function __construct() {
         parent::__construct();
 …
     /**
      * Output the edit field HTML for this field type.
+     *
      * Must be used inside the {@link bp_profile_fields()} template loop.
+     *
-     * @param array $raw_properties Optional key/value array of {@link http://dev.w3.org/html5/markup/input.text.html permitted attributes} that you want to add.
      * @since 2.0.0
+     *
+     * @param array $raw_properties Optional key/value array of
+     *                              {@link http://dev.w3.org/html5/markup/input.text.html permitted attributes}
+     *                              that you want to add.
      */
     public function edit_field_html( array $raw_properties = array() ) {
         // user_id is a special optional parameter that certain other fields
+        // User_id is a special optional parameter that certain other fields
         // types pass to {@link bp_the_profile_field_options()}.
         if ( isset( $raw_properties['user_id'] ) ) {
 …
      * Must be used inside the {@link bp_profile_fields()} template loop.
+     *
+     * @since 2.0.0
+     *
      * @param array $raw_properties Optional key/value array of permitted attributes that you want to add.
-     * @since 2.0.0
      */
     public function admin_field_html( array $raw_properties = array() ) {
 …
      * "Add Field" and "Edit Field" screens, but for this field type, we don't want it, so it's stubbed out.
+     *
+     * @since 2.0.0
+     *
      * @param BP_XProfile_Field $current_field The current profile field on the add/edit screen.
      * @param string $control_type Optional. HTML input type used to render the current field's child options.
      * @since 2.0.0
+     * @param string            $control_type  Optional. HTML input type used to render the
+     *                                         current field's child options.
      */
     public function admin_new_field_html( BP_XProfile_Field $current_field, $control_type = '' ) {}

trunk/src/bp-xprofile/classes/class-bp-xprofile-field-type-url.php

-                      r10142
+                      r10163
 <?php
 /**
  * BuddyPress XProfile Classes
+ * BuddyPress XProfile Classes.
+ *
  * @package BuddyPress
 …
+     *
      * @param array $raw_properties Optional key/value array of
+     *        {@link http://dev.w3.org/html5/markup/input.number.html permitted attributes}
+     *        that you want to add.
+     *                              {@link http://dev.w3.org/html5/markup/input.number.html permitted attributes}
+     *                              that you want to add.
+     *
      * @since 2.1.0
      */
 …
+     *
      * @param array $raw_properties Optional key/value array of permitted
      *        attributes that you want to add.
+     *                              attributes that you want to add.
      * @since 2.1.0
      */
 …
      * for this field type, we don't want it, so it's stubbed out.
+     *
+     * @since 2.1.0
+     *
      * @param BP_XProfile_Field $current_field The current profile field on the add/edit screen.
      * @param string $control_type Optional. HTML input type used to render the current field's child options.
      * @since 2.1.0
+     * @param string            $control_type  Optional. HTML input type used to render the current
+     *                                         field's child options.
      */
     public function admin_new_field_html( BP_XProfile_Field $current_field, $control_type = '' ) {}
 …
+     *
      * @param string $submitted_value Raw value submitted by the user.
+     *
      * @return string
      */
     public static function pre_validate_filter( $submitted_value = '' ) {
         // Allow empty URL values
+        // Allow empty URL values.
         if ( empty( $submitted_value ) ) {
             return '';
+        }
         // Run some checks on the submitted value
+        // Run some checks on the submitted value.
         if ( false === strpos( $submitted_value, ':'  )
              && substr( $submitted_value, 0, 1 ) !== '/'
 …
+     *
      * @param string $field_value The URL value, as saved in the database.
+     *
      * @return string URL converted to a link.
      */

trunk/src/bp-xprofile/classes/class-bp-xprofile-field-type.php

-                      r10142
+                      r10163
 <?php
 /**
  * BuddyPress XProfile Classes
+ * BuddyPress XProfile Classes.
+ *
  * @package BuddyPress
 …
  */
 // Exit if accessed directly
+// Exit if accessed directly.
 defined( 'ABSPATH' ) || exit;
 …
     /**
+     * @since 2.0.0
+     * @var array Field type validation regexes
+     * Validation regex rules for field type.
+     * @since 2.0.0
+     * @var array Field type validation regexes.
      */
     protected $validation_regex = array();
     /**
+     * @since 2.0.0
+     * @var array Field type whitelisted values
+     * Whitelisted values for field type.
+     *
+     * @since 2.0.0
+     * @var array Field type whitelisted values.
      */
     protected $validation_whitelist = array();
     /**
+     * @since 2.0.0
+     * @var string The name of this field type
+     * Name for field type.
+     *
+     * @since 2.0.0
+     * @var string The name of this field type.
      */
     public $name = '';
 …
     /**
+     * If allowed to store null/empty values.
+     *
      * @since 2.0.0
      * @var bool If this is set, allow BP to store null/empty values for this field type.
 …
     /**
+     * If allowed to support multiple options as default.
+     *
      * @since 2.0.0
      * @var bool Does this field type support multiple options being set as default values? e.g. multiselectbox, checkbox.
 …
     /**
+     * @since 2.0.0
+     * @var BP_XProfile_Field If this object is created by instantiating a {@link BP_XProfile_Field}, this is a reference back to that object.
+     * If object is created by an BP_XProfile_Field object.
+     *
+     * @since 2.0.0
+     * @var BP_XProfile_Field If this object is created by instantiating a {@link BP_XProfile_Field},
+     *                        this is a reference back to that object.
      */
     public $field_obj = null;
     /**
      * Constructor
+     * Constructor.
+     *
      * @since 2.0.0
 …
      * it's successful as long as the new value matches any one of the registered formats.
+     *
+     * @param string $format Regex string
+     * @param string $replace_format Optional; if 'replace', replaces the format instead of adding to it. Defaults to 'add'.
+     * @since 2.0.0
+     *
+     * @param string $format         Regex string.
+     * @param string $replace_format Optional; if 'replace', replaces the format instead of adding to it.
+     *                               Defaults to 'add'.
+     *
      * @return BP_XProfile_Field_Type
-     * @since 2.0.0
      */
     public function set_format( $format, $replace_format = 'add' ) {
 …
      * it's successful as long as the new value matches any one of the registered formats.
+     *
+     * @param string|array $values
+     * @since 2.0.0
+     *
+     * @param string|array $values Whitelisted values.
+     *
      * @return BP_XProfile_Field_Type
-     * @since 2.0.0
      */
     public function set_whitelist_values( $values ) {
 …
      * This method doesn't support chaining.
+     *
+     * @param string|array $values Value to check against the registered formats
+     * @since 2.0.0
+     *
+     * @param string|array $values Value to check against the registered formats.
+     *
      * @return bool True if the value validates
-     * @since 2.0.0
      */
     public function is_valid( $values ) {
         $validated = false;
         // Some types of field (e.g. multi-selectbox) may have multiple values to check
+        // Some types of field (e.g. multi-selectbox) may have multiple values to check.
         foreach ( (array) $values as $value ) {
 …
+        }
         // Handle field types with accepts_null_value set if $values is an empty array
+        // Handle field types with accepts_null_value set if $values is an empty array.
         if ( ( false === $validated ) && is_array( $values ) && empty( $values ) && $this->accepts_null_value ) {
             $validated = true;
 …
      * Must be used inside the {@link bp_profile_fields()} template loop.
+     *
+     * @since 2.0.0
+     *
      * @param array $raw_properties Optional key/value array of permitted attributes that you want to add.
-     * @since 2.0.0
      */
     abstract public function edit_field_html( array $raw_properties = array() );
+    /**
+     * Output HTML for this field type on the wp-admin Profile Fields screen.
+     *
+     * Must be used inside the {@link bp_profile_fields()} template loop.
+     *
+     * @param array $raw_properties Optional key/value array of permitted attributes that you want to add.
+     * @since 2.0.0
+     */
+    abstract public function admin_field_html( array $raw_properties = array() );
     /**
 …
      * Must be used inside the {@link bp_profile_fields()} template loop.
+     *
+     * @since 2.0.0
+     *
      * @param array $args Optional. The arguments passed to {@link bp_the_profile_field_options()}.
-     * @since 2.0.0
      */
     public function edit_field_options_html( array $args = array() ) {}
-    /**
-     * Output HTML for this field type on the wp-admin Profile Fields screen.
+     *
-     * Must be used inside the {@link bp_profile_fields()} template loop.
+     *
-     * @param array $raw_properties Optional key/value array of permitted attributes that you want to add.
-     * @since 2.0.0
-     */
-    abstract public function admin_field_html( array $raw_properties = array() );
     /**
 …
      * Must be used inside the {@link bp_profile_fields()} template loop.
+     *
+     * @since 2.0.0
+     *
      * @param BP_XProfile_Field $current_field The current profile field on the add/edit screen.
      * @param string $control_type Optional. HTML input type used to render the current field's child options.
      * @since 2.0.0
+     * @param string            $control_type  Optional. HTML input type used to render the current
+     *                          field's child options.
      */
     public function admin_new_field_html( BP_XProfile_Field $current_field, $control_type = '' ) {
 …
+                        }
                         // Grab the values from $_POST to use as the form's options
+                        // Grab the values from $_POST to use as the form's options.
                         $options[] = (object) array(
                             'id'                => -1,
 …
+                }
                 // Render the markup for the children options
+                // Render the markup for the children options.
                 if ( ! empty( $options ) ) {
                     $default_name = '';
 …
      * @since 2.1.0
+     *
+     * @param mixed $submitted_value Submitted value.
+     * @param mixed $field_value Submitted field value.
+     *
      * @return mixed
      */
 …
+     *
      * @param mixed $field_value Field value.
+     *
      * @return mixed
      */
 …
      * This method was intended to be static but couldn't be because php.net/lsb/ requires PHP >= 5.3.
+     *
+     * @since 2.0.0
+     *
      * @param array $properties Optional key/value array of attributes for this edit field.
+     *
      * @return string
-     * @since 2.0.0
      */
     protected function get_edit_field_html_elements( array $properties = array() ) {
 …
+        }
-        $html = '';
         /**
          * Filters the edit html elements and attributes.

trunk/src/bp-xprofile/classes/class-bp-xprofile-field.php

-                      r10160
+                      r10163
 <?php
 /**
  * BuddyPress XProfile Classes
+ * BuddyPress XProfile Classes.
+ *
  * @package BuddyPress
 …
     /**
+     * Field ID.
+     *
      * @since 1.0.0
+     *
      * @var int ID of field
+     * @var int ID of field.
      */
     public $id;
     /**
+     * Field group ID.
+     *
      * @since 1.0.0
+     *
      * @var int Field group ID for field
+     * @var int Field group ID for field.
      */
     public $group_id;
     /**
+     * Field parent ID.
+     *
      * @since 1.0.0
+     *
      * @var int Parent ID of field
+     * @var int Parent ID of field.
      */
     public $parent_id;
     /**
+     * Field type.
+     *
      * @since 1.0.0
+     *
      * @var string Field type
+     * @var string Field type.
      */
     public $type;
     /**
+     * Field name.
+     *
      * @since 1.0.0
+     *
      * @var string Field name
+     * @var string Field name.
      */
     public $name;
     /**
+     * Field description.
+     *
      * @since 1.0.0
+     *
      * @var string Field description
+     * @var string Field description.
      */
     public $description;
     /**
+     * Required field?
+     *
      * @since 1.0.0
+     *
 …
     /**
+     * Deletable field?
+     *
      * @since 1.0.0
+     *
 …
     /**
+     * Field position.
+     *
      * @since 1.0.0
+     *
      * @var int Field position
+     * @var int Field position.
      */
     public $field_order;
     /**
+     * Option order.
+     *
      * @since 1.0.0
+     *
      * @var int Option order
+     * @var int Option order.
      */
     public $option_order;
     /**
+     * Order child fields.
+     *
      * @since 1.0.0
+     *
      * @var string Order child fields by
+     * @var string Order child fields by.
      */
     public $order_by;
     /**
+     * Is this the default option?
+     *
      * @since 1.0.0
+     *
 …
     /**
+     * Field data visibility.
+     *
      * @since 1.9.0
+     *
      * @var string Default field data visibility
+     * @var string Default field data visibility.
      */
     public $default_visibility = 'public';
     /**
+     * Is the visibility able to be modified?
+     *
      * @since 2.3.0
+     *
      * @var string Members are allowed/disallowed to modify data visibility
+     * @var string Members are allowed/disallowed to modify data visibility.
      */
     public $allow_custom_visibility = 'allowed';
     /**
+     * Field type option.
+     *
      * @since 2.0.0
+     *
      * @var BP_XProfile_Field_Type Field type object used for validation
+     * @var BP_XProfile_Field_Type Field type object used for validation.
      */
     public $type_obj = null;
     /**
+     * Field data for user ID.
+     *
      * @since 2.0.0
+     *
      * @var BP_XProfile_ProfileData Field data for user ID
+     * @var BP_XProfile_ProfileData Field data for user ID.
      */
     public $data;
 …
     /**
      * Initialize and/or populate profile field
+     * Initialize and/or populate profile field.
+     *
      * @since 1.1.0
+     *
      * @param int  $id
      * @param int  $user_id
      * @param bool $get_data
+     * @param int|null $id Field ID.
+     * @param int|null $user_id User ID.
+     * @param bool     $get_data Get data.
      */
     public function __construct( $id = null, $user_id = null, $get_data = true ) {
 …
             $this->populate( $id, $user_id, $get_data );
         // Initialise the type obj to prevent fatals when creating new profile fields
+        // Initialise the type obj to prevent fatals when creating new profile fields.
         } else {
             $this->type_obj            = bp_xprofile_create_field_type( 'textbox' );
 …
     /**
      * Populate a profile field object
+     * Populate a profile field object.
+     *
      * @since 1.1.0
 …
      * @global object $userdata
+     *
      * @param  int    $id
      * @param  int    $user_id
      * @param  bool   $get_data
+     * @param int  $id Field ID.
+     * @param int  $user_id User ID.
+     * @param bool $get_data Get data.
      */
     public function populate( $id, $user_id = null, $get_data = true ) {
 …
+            }
             // Get metadata for field
+            // Get metadata for field.
             $default_visibility       = bp_xprofile_get_meta( $id, 'field', 'default_visibility'      );
             $allow_custom_visibility  = bp_xprofile_get_meta( $id, 'field', 'allow_custom_visibility' );
             // Setup default visibility
+            // Setup default visibility.
             $this->default_visibility = ! empty( $default_visibility )
                 ? $default_visibility
                 : 'public';
             // Allow members to customize visibilty
+            // Allow members to customize visibilty.
             $this->allow_custom_visibility = ( 'disabled' === $allow_custom_visibility )
                 ? 'disabled'
 …
     /**
      * Delete a profile field
+     * Delete a profile field.
+     *
      * @since 1.1.0
+     *
+     * @global object  $wpdb
+     * @param  boolean $delete_data
+     * @global object $wpdb
+     *
+     * @param boolean $delete_data Whether or not to delete data.
+     *
      * @return boolean
      */
 …
         global $wpdb;
         // Prevent deletion if no ID is present
+        // Prevent deletion if no ID is present.
         // Prevent deletion by url when can_delete is false.
         // Prevent deletion of option 1 since this invalidates fields with options.
 …
+        }
         // delete the data in the DB for this field
+        // Delete the data in the DB for this field.
         if ( true === $delete_data ) {
             BP_XProfile_ProfileData::delete_for_field( $this->id );
 …
     /**
      * Save a profile field
+     * Save a profile field.
+     *
      * @since 1.1.0
 …
          * @since 1.0.0
+         *
          * @param BP_XProfile_Field Current instance of the field being saved.
+         * @param BP_XProfile_Field $this Current instance of the field being saved.
          */
         do_action_ref_array( 'xprofile_field_before_save', array( $this ) );
 …
+            }
             // Only do this if we are editing an existing field
+            // Only do this if we are editing an existing field.
             if ( ! $is_new_field ) {
 …
              * @since 1.0.0
+             *
              * @param BP_XProfile_Field Current instance of the field being saved.
+             * @param BP_XProfile_Field $this Current instance of the field being saved.
              */
             do_action_ref_array( 'xprofile_field_after_save', array( $this ) );
 …
     /**
      * Get field data for a user ID
+     * Get field data for a user ID.
+     *
      * @since 1.2.0
+     *
+     * @param  int $user_id
+     * @param int $user_id ID of the user to get field data for.
+     *
      * @return object
      */
 …
     /**
      * Get all child fields for this field ID
+     * Get all child fields for this field ID.
+     *
      * @since 1.2.0
 …
      * @global object $wpdb
+     *
+     * @param  bool  $for_editing
+     * @param bool $for_editing Whether or not the field is for editing.
+     *
      * @return array
      */
 …
         global $wpdb;
         // This is done here so we don't have problems with sql injection
+        // This is done here so we don't have problems with sql injection.
         if ( empty( $for_editing ) && ( 'asc' === $this->order_by ) ) {
             $sort_sql = 'ORDER BY name ASC';
 …
         // This eliminates a problem with getting all fields when there is no
         // id for the object
+        // id for the object.
         if ( empty( $this->id ) ) {
             $parent_id = -1;
 …
     /**
      * Delete all field children for this field
+     * Delete all field children for this field.
+     *
      * @since 1.2.0
 …
      * @param bool  $append       Whether to append to existing member types. If false, all existing member type
      *                            associations will be deleted before adding your `$member_types`. Default false.
+     *
      * @return array Member types for the current field, after being saved.
      */
 …
          * @since 2.4.0
+         *
          * @param BP_XProfile_Field $field Field object.
+         * @param BP_XProfile_Field $this Field object.
          */
         do_action( 'bp_xprofile_field_set_member_type', $this );
 …
         global $wpdb;
         // Bail if no field ID
+        // Bail if no field ID.
         if ( empty( $field_id ) ) {
             return false;
 …
         $type = $wpdb->get_var( $sql );
         // Return field type
+        // Return field type.
         if ( ! empty( $type ) ) {
             return $type;
 …
     /**
      * Delete all fields in a field group
+     * Delete all fields in a field group.
+     *
      * @since 1.2.0
 …
      * @global object $wpdb
+     *
      * @param  int    $group_id
+     * @param int $group_id ID of the field group to delete fields from.
+     *
      * @return boolean
 …
         global $wpdb;
         // Bail if no group ID
+        // Bail if no group ID.
         if ( empty( $group_id ) ) {
             return false;
 …
         $deleted = $wpdb->get_var( $sql );
         // Return true if fields were deleted
+        // Return true if fields were deleted.
         if ( false !== $deleted ) {
             return true;
 …
     /**
      * Get field ID from field name
+     * Get field ID from field name.
+     *
      * @since 1.5.0
+     *
      * @global object $wpdb
+     * @param  string $field_name
+     *
+     * @param string $field_name Name of the field to query the ID for.
+     *
      * @return boolean
 …
     /**
      * Update field position and/or field group when relocating
+     * Update field position and/or field group when relocating.
+     *
      * @since 1.5.0
 …
      * @global object $wpdb
+     *
      * @param  int $field_id
      * @param  int $position
      * @param  int $field_group_id
+     * @param int      $field_id       ID of the field to update.
+     * @param int|null $position       Field position to update.
+     * @param int|null $field_group_id ID of the field group.
+     *
      * @return boolean
 …
         global $wpdb;
         // Bail if invalid position or field group
+        // Bail if invalid position or field group.
         if ( ! is_numeric( $position ) || ! is_numeric( $field_group_id ) ) {
             return false;
+        }
         // Get table name and field parent
+        // Get table name and field parent.
         $table_name = buddypress()->profile->table_name_fields;
         $sql        = $wpdb->prepare( "UPDATE {$table_name} SET field_order = %d, group_id = %d WHERE id = %d", $position, $field_group_id, $field_id );
         $parent     = $wpdb->query( $sql );
         // Update $field_id with new $position and $field_group_id
+        // Update $field_id with new $position and $field_group_id.
         if ( ! empty( $parent ) && ! is_wp_error( $parent ) ) {
             // Update any children of this $field_id
+            // Update any children of this $field_id.
             $sql = $wpdb->prepare( "UPDATE {$table_name} SET group_id = %d WHERE parent_id = %d", $field_group_id, $field_id );
             $wpdb->query( $sql );
 …
      * @param string|array $member_types Member type or array of member types. Use 'any' to return unrestricted
      *                                   fields (those available for anyone, regardless of member type).
+     *
      * @return array Multi-dimensional array, with field IDs as top-level keys, and arrays of member types
      *               associated with each field as values.
 …
     /**
      * Validate form field data on sumbission
+     * Validate form field data on sumbission.
+     *
      * @since 2.2.0
+     *
+     * @global type $message
+     * @global $message
+     *
      * @return boolean
      */
 …
         global $message;
         // Check field name
+        // Check field name.
         if ( ! isset( $_POST['title'] ) || ( '' === $_POST['title'] ) ) {
             $message = esc_html__( 'Profile fields must have a name.', 'buddypress' );
 …
+        }
         // Check field requirement
+        // Check field requirement.
         if ( ! isset( $_POST['required'] ) ) {
             $message = esc_html__( 'Profile field requirement is missing.', 'buddypress' );
 …
+        }
         // Check field type
+        // Check field type.
         if ( empty( $_POST['fieldtype'] ) ) {
             $message = esc_html__( 'Profile field type is missing.', 'buddypress' );
 …
+        }
         // Check that field is of valid type
+        // Check that field is of valid type.
         if ( ! in_array( $_POST['fieldtype'], array_keys( bp_xprofile_get_field_types() ), true ) ) {
             $message = sprintf( esc_html__( 'The profile field type %s is not registered.', 'buddypress' ), '<code>' . esc_attr( $_POST['fieldtype'] ) . '</code>' );
 …
+        }
         // Get field type so we can check for and lavidate any field options
+        // Get field type so we can check for and lavidate any field options.
         $field_type = bp_xprofile_create_field_type( $_POST['fieldtype'] );
         // Field type requires options
+        // Field type requires options.
         if ( true === $field_type->supports_options ) {
             // Build the field option key
+            // Build the field option key.
             $option_name = sanitize_key( $_POST['fieldtype'] ) . '_option';
             // Check for missing or malformed options
+            // Check for missing or malformed options.
             if ( empty( $_POST[ $option_name ] ) || ! is_array( $_POST[ $option_name ] ) ) {
                 $message = esc_html__( 'These field options are invalid.', 'buddypress' );
 …
+            }
             // Trim out empty field options
+            // Trim out empty field options.
             $field_values  = array_values( $_POST[ $option_name ] );
             $field_options = array_map( 'sanitize_text_field', $field_values );
             $field_count   = count( $field_options );
             // Check for missing or malformed options
+            // Check for missing or malformed options.
             if ( 0 === $field_count ) {
                 $message = sprintf( esc_html__( '%s require at least one option.', 'buddypress' ), $field_type->name );
 …
+            }
             // If only one option exists, it cannot be an empty string
+            // If only one option exists, it cannot be an empty string.
             if ( ( 1 === $field_count ) && ( '' === $field_options[0] ) ) {
                 $message = sprintf( esc_html__( '%s require at least one option.', 'buddypress' ), $field_type->name );
 …
     /**
      * Oupput the admin form for this field
+     * Oupput the admin form for this field.
+     *
      * @since 1.9.0
+     *
      * @param type $message
+     * @param string $message Message to display.
      */
     public function render_admin_form( $message = '' ) {
 …
                             <?php
                             // Output the name & description fields
+                            // Output the name & description fields.
                             $this->name_and_description(); ?>
 …
                             <?php
                             // Output the sumbit metabox
+                            // Output the sumbit metabox.
                             $this->submit_metabox( $button );
                             // Output the required metabox
+                            // Output the required metabox.
                             $this->required_metabox();
 …
                             $this->member_type_metabox();
                             // Output the field visibility metaboxes
+                            // Output the field visibility metaboxes.
                             $this->visibility_metabox();
 …
                             do_action( 'xprofile_field_before_contentbox', $this );
                             // Output the field attributes metabox
+                            // Output the field attributes metabox.
                             $this->type_metabox();
                             // Output hidden inputs for default field
+                            // Output hidden inputs for default field.
                             $this->default_field_hidden_inputs();
 …
     /**
      * Private method used to display the submit metabox
+     * Private method used to display the submit metabox.
+     *
      * @since 2.3.0
+     *
      * @param string $button_text
+     * @param string $button_text Text to put on button.
      */
     private function submit_metabox( $button_text = '' ) {
 …
     /**
      * Private method used to output field name and description fields
+     * Private method used to output field name and description fields.
+     *
      * @since 2.3.0
 …
     /**
      * Private method used to output field visibility metaboxes
+     * Private method used to output field visibility metaboxes.
+     *
      * @since 2.3.0
+     *
      * @return if default field id 1
+     * @return void If default field id 1.
      */
     private function visibility_metabox() {
         // Default field cannot have custom visibility
+        // Default field cannot have custom visibility.
         if ( true === $this->is_default_field() ) {
             return;
 …
     /**
      * Output the metabox for setting if field is required or not
+     * Output the metabox for setting if field is required or not.
+     *
      * @since 2.3.0
+     *
      * @return if default field
+     * @return void If default field.
      */
     private function required_metabox() {
         // Default field is always required
+        // Default field is always required.
         if ( true === $this->is_default_field() ) {
             return;
 …
     /**
      * Output the metabox for setting what type of field this is
+     * Output the metabox for setting what type of field this is.
+     *
      * @since 2.3.0
+     *
      * @return if default field
+     * @return void If default field.
      */
     private function type_metabox() {
         // Default field cannot change type
+        // Default field cannot change type.
         if ( true === $this->is_default_field() ) {
             return;
 …
     /**
      * Output hidden fields used by default field
+     * Output hidden fields used by default field.
+     *
      * @since 2.3.0
+     *
      * @return if not default field
+     * @return void If not default field.
      */
     private function default_field_hidden_inputs() {
         // Field 1 is the fullname field, which cannot have custom visibility
+        // Field 1 is the fullname field, which cannot have custom visibility.
         if ( false === $this->is_default_field() ) {
             return;
 …
     /**
      * Return if a field ID is the default field
+     * Return if a field ID is the default field.
+     *
      * @since 2.3.0
+     *
+     * @param  int $field_id ID of field to check
+     * @param int $field_id ID of field to check.
+     *
      * @return bool
      */
     private function is_default_field( $field_id = 0 ) {
         // Fallback to current field ID if none passed
+        // Fallback to current field ID if none passed.
         if ( empty( $field_id ) ) {
             $field_id = $this->id;
+        }
         // Compare & return
+        // Compare & return.
         return (bool) ( 1 === (int) $field_id );
+    }

trunk/src/bp-xprofile/classes/class-bp-xprofile-group.php

-                      r10142
+                      r10163
 <?php
 /**
  * BuddyPress XProfile Classes
+ * BuddyPress XProfile Classes.
+ *
  * @package BuddyPress
 …
     /**
+     * Field group ID.
+     *
      * @since 1.1.0
+     *
 …
     /**
+     * Field group name.
+     *
      * @since 1.1.0
+     *
 …
     /**
+     * Field group Description.
+     *
      * @since 1.1.0
+     *
 …
     /**
+     * Group deletion boolean.
+     *
      * @since 1.1.0
+     *
 …
     /**
+     * Group order.
+     *
      * @since 1.1.0
+     *
 …
     /**
+     * Group fields.
+     *
      * @since 1.1.0
+     *
 …
     /**
      * Initialize and/or populate profile field group
+     * Initialize and/or populate profile field group.
+     *
      * @since 1.1.0
+     *
+     * @param int  $id
+     * @param int  $user_id
+     * @param bool $get_data
+     * @param int|null $id Field group ID.
      */
     public function __construct( $id = null ) {
 …
     /**
      * Populate a profile field group
+     * Populate a profile field group.
+     *
      * @since 1.0.0
+     *
      * @global $wpdb $wpdb
+     * @param  int   $id
+     *
+     * @param int $id Field group ID.
+     *
      * @return boolean
 …
     public function populate( $id ) {
         // Get this group
+        // Get this group.
         $group = self::get( array(
             'profile_group_id' => $id
         ) );
         // Bail if group not found
+        // Bail if group not found.
         if ( empty( $group ) ) {
             return false;
+        }
         // Get the first array element
+        // Get the first array element.
         $group = reset( $group );
         // Set object properties
+        // Set object properties.
         $this->id          = $group->id;
         $this->name        = $group->name;
 …
     /**
      * Save a profile field group
+     * Save a profile field group.
+     *
      * @since 1.1.0
 …
         global $wpdb;
         // Filter the field group attributes
+        // Filter the field group attributes.
         $this->name        = apply_filters( 'xprofile_group_name_before_save',        $this->name,        $this->id );
         $this->description = apply_filters( 'xprofile_group_description_before_save', $this->description, $this->id );
 …
          * @since 1.0.0
+         *
          * @param BP_XProfile_Group Current instance of the group being saved. Passed by reference.
+         * @param BP_XProfile_Group $this Current instance of the group being saved. Passed by reference.
          */
         do_action_ref_array( 'xprofile_group_before_save', array( &$this ) );
 …
         $bp = buddypress();
         // Update or insert
+        // Update or insert.
         if ( ! empty( $this->id ) ) {
             $sql = $wpdb->prepare( "UPDATE {$bp->profile->table_name_groups} SET name = %s, description = %s WHERE id = %d", $this->name, $this->description, $this->id );
 …
+        }
         // Attempt to insert or update
+        // Attempt to insert or update.
         $query = $wpdb->query( $sql );
 …
+        }
         // If not set, update the ID in the group object

BuddyPress.org

Context Navigation

Legend:

trunk/src/bp-xprofile/bp-xprofile-actions.php

trunk/src/bp-xprofile/bp-xprofile-activity.php

trunk/src/bp-xprofile/bp-xprofile-admin.php

trunk/src/bp-xprofile/bp-xprofile-cache.php

trunk/src/bp-xprofile/bp-xprofile-caps.php

trunk/src/bp-xprofile/bp-xprofile-cssjs.php

trunk/src/bp-xprofile/bp-xprofile-filters.php

trunk/src/bp-xprofile/bp-xprofile-functions.php

trunk/src/bp-xprofile/bp-xprofile-loader.php

trunk/src/bp-xprofile/bp-xprofile-screens.php

trunk/src/bp-xprofile/bp-xprofile-settings.php

trunk/src/bp-xprofile/bp-xprofile-template.php

trunk/src/bp-xprofile/classes/class-bp-xprofile-field-type-checkbox.php

trunk/src/bp-xprofile/classes/class-bp-xprofile-field-type-datebox.php

trunk/src/bp-xprofile/classes/class-bp-xprofile-field-type-multiselectbox.php

trunk/src/bp-xprofile/classes/class-bp-xprofile-field-type-number.php

trunk/src/bp-xprofile/classes/class-bp-xprofile-field-type-placeholder.php

trunk/src/bp-xprofile/classes/class-bp-xprofile-field-type-radiobutton.php

trunk/src/bp-xprofile/classes/class-bp-xprofile-field-type-selectbox.php

trunk/src/bp-xprofile/classes/class-bp-xprofile-field-type-textarea.php

trunk/src/bp-xprofile/classes/class-bp-xprofile-field-type-textbox.php

trunk/src/bp-xprofile/classes/class-bp-xprofile-field-type-url.php

trunk/src/bp-xprofile/classes/class-bp-xprofile-field-type.php

trunk/src/bp-xprofile/classes/class-bp-xprofile-field.php

trunk/src/bp-xprofile/classes/class-bp-xprofile-group.php