SetAccountPassword: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 16: Line 16:
===Returns===
===Returns===
<!-- Make this descriptive. Explain what cases will return false. If you're unsure, add a tag to it so we can check -->
<!-- Make this descriptive. Explain what cases will return false. If you're unsure, add a tag to it so we can check -->
Returns ''true'' if the password was set corrently, ''false'' otherwise.
Returns ''true'' if the password was set correctly, ''false'' otherwise.


==Example==  
==Example==  

Revision as of 18:45, 12 February 2008

This function sets the password of the specified account.

Syntax

bool setAccountPassword(account theAccount, string password)

Required Arguments

  • theAccount: the account whos password you want to set
  • password: the password

Returns

Returns true if the password was set correctly, false otherwise.

Example

This example allows a user to change their password with a command.

function ChangePlayerPassword(player,command,oldpass,newpass)
	-- get the account the player is currently logged into
	local account = getClientAccount(player)
	if (account) then
		-- if its only a guest account, do not allow the password to be changed
		if (isGuestAccount(account)) then
			outputChatBox("You must be logged into an account to change your password.",player) 
			-- end the function
			return
		end
		
		-- check that the old password is correct
		local password_check = getAccount(getPlayerUserName(player),oldpass)
		if (oldpass==password_check) then
			-- check the length of the new password
			if (string.len(newpass)>=5) then
				setAccountPassword(account,newpass)
			else
				outputChatBox("Your new password must be at least 5 characters long.",player)
			end
		else
			outputChatBox("Old password invalid.",player)
		end
	end

addCommandHandler("changepass",ChangePlayerPassword)

See Also