If we want delete some users by different criteria, we could do some functions like delete_users_by_id, delete_users_by_idnumber, delete_users_by_email, etc.

Or do it in a function delete_users ($array, $criteria);
where $criteria is a string {id, idnumber or email}
and $array is the array with values for specified criteria.

Insigths?

We think that the easiest way to solve this functionality is deleting only by id or idnumber, because all of them are unique on Moodle.

/**

• Deletes an user
• User is marked as deleted
• All it's role assignments are destroyed
• @private ?
• @param string $field Possible values:
• <ul>
• <li>id</li>
• <li>idnumber</li>
• <li>login</li>
• <li>email</li>
• </ul>
• @param string $value
• @return boolean
  */
  function delete_user($field, $values){
  }

/**

• Deletes several users
• Users are marked as deleted
• All their role assignments are destroyed
• @param string $field Possible values:
• <ul>
• <li>id</li>
• <li>idnumber</li>
• <li>login</li>
• <li>email</li>
• </ul>
• @param array $values
• @uses delete_user
  *
• @return boolean
  */
  function delete_users($field, $values){
  }

http://cvs.moodle.org/contrib/patches/dfws/webservice/apis/user.lib.php?revision=1.4&view=markup

The name of the function is:

array mdl_user_delete_instances($userids, $idtype='idnumber')

The particles of the name are explained here: http://tracker.moodle.org/browse/MDL-13126?focusedCommentId=56209#action_56209

The function gets one mandatory param and am optional one, and returns an associative array of identifier=>boolean. The hot point of this function is that users can be identified by several fields:

-username
-email
-internal id
-idnumber (in my point of view is the best way)

So, to implement this function we decided to allow all of them. The default is 'idnumber' but, you can pass an array of internal ids, usernames or emails too, just by specify it in the second parameter.

http://cvs.moodle.org/contrib/patches/dfws/webservice/apis/user.lib.php?revision=1.5&view=markup