View source for RemoteAdmin:admin create user

'''admin_create_user''' remotely allows to create a new user

=== Enabling admin_create_user ===
If not all functions are enabled, use admin_create_user to enable the function in the [RemoteAdmin] section
<source lang="csharp">
enabled_methods = admin_create_user,...
</source>


== Parameters ==
=== Required Parameters ===
These parameters are required
{| cellspacing="0" cellpadding="4" border="1"
|-
! parameter
! Description
! Values
|-
| ''user_firstname''
| first name of user
|
|-
| ''user_lastname''
| last name of user
|
|-
| ''user_password''
| password of user
|
|-
| ''start_region_x''
| start region x position in grid
|
|-
| ''start_region_y''
| start region y position in grid
|
|}

=== Optional Parameters ===
These parameters are optional and do not need to be set

{| cellspacing="0" cellpadding="4" border="1"
|-
! parameter
! Description
! Values
|-
| ''user_email''
| email adress of user
|
|}


== Returned Parameters ==
=== Returned Parameters ===
These parameters are returned by Remote Admin

{| cellspacing="0" cellpadding="4" border="1"
|-
! parameter
! Description
! Values
|-
| ''success''
| true when successfull
| true, false
|-
|''avatar_uuid''
| new avatar uuid, zero uuid when error occured
|
|}

=== Error messages ===
''avatar_uuid'' returnes zero uuid when an error occures


== Notes ==
* This function is available for Robust and for Standalone
* This function is the same Identical to [[RemoteAdmin:admin_create_user_email|admin_create_user_email]].


== Example ==
=== C# .NET ===
This example needs the Nwc.XmlRpc library, located in your OpenSimulator bin folder. 

<source lang="csharp">
public void CreateUser(Uri url, string adminPassword, string firstName, string lastName, string password, string email, int regionX, int regionY)
{
 var address = Dns.GetHostEntry(url.DnsSafeHost).AddressList[0];
 var ht = new Hashtable();
 ht["password"] = adminPassword;
 ht["user_firstname"] = firstName;
 ht["user_lastname"] = lastName;
 ht["user_password"] = password;
 ht["user_email"] = email;
 ht["start_region_x"] = regionX;
 ht["start_region_y"] = regionY;
 var parameters = new List<Hashtable> { ht };
 var rpc = new XmlRpcRequest("admin_create_user", parameters);
 rpc.Invoke(url.ToString());
}

[Test]
public void NativeUserRegistrationTest()
{
 CreateUser(new Uri("http://yourgrid.com:9000/"), "secret", "Test2", "user2", "apassword", "email@address.com", 0, 0);
}
</source>

=== PHP ===
This example needs the RemoteAdmin PHP Class file available [[RemoteAdmin:RemoteAdmin_Class|here]].

<source lang="php">
<?php

// Including the RemoteAdmin PHP class.
require('RemoteAdmin.php');

// Instantiate the class with parameters identical to the Python example above
$myRemoteAdmin = new RemoteAdmin('127.0.0.1', 9000, 'secret');

// Invoke admin_create_user (multiple parameters)
$parameters = array('user_firstname' => 'John', 'user_lastname' => 'Doe', 'user_password' => 'secret', 'start_region_x' => 10000, 'start_region_y' => 10000);
$myRemoteAdmin->SendCommand('admin_create_user', $parameters);
?>
</source>

[[Category:RemoteAdmin]]
[[Category:RemoteAdmin Commands]]