AR/addAccount: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(37 intermediate revisions by 6 users not shown)
Line 8: Line 8:
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
account addAccount ( string name, string pass )
account addAccount ( string name, string pass )
</syntaxhighlight>
</syntaxhighlight>|AR|
}}
}}
{{Deprecated_feature|3|1.0|
{{Deprecated_feature|3|1.0|
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool addAccount ( string name, string pass )
bool addAccount ( string name, string pass )
</syntaxhighlight>  
</syntaxhighlight>|AR|
}}
}}


===Required Arguments===  
===العناصر المطلوبة===  
<!-- List each argument one per line. This should be the argument's name as in the argument list above, NOT the argument's data type -->
<!-- List each argument one per line. This should be the argument's name as in the argument list above, NOT the argument's data type -->
*'''name:''' The name of the account you wish to make, this normally is the player's name.
*'''name:''' أسم الحساب الجديد اللذي تريد تسجيلة.
*'''pass:''' The password to set for this account for future logins.
*'''pass:''' كلمة المرور للحساب اللذي تريد تسجيلة.


===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 -->
{{New feature|3|1.0 r848|
{{New feature|3|1.0 r848|
Returns the ''account'' element if the account was created, ''false'' if the account already exists or an error occured.
إذا كان أسم هذا الحساب قد تم تسجيلة مسبقاً أو إذا حدث خطأ ما ''false'' يرجع عنصر ''الحساب'' اللذي تم تسجيلة, أو
}}
{{Deprecated_feature|3|1.0|
Returns ''true'' if the account was created, ''false'' if the account already exists or an error occured.
}}
}}


==Example==  
==مثال==  
<section name="Server" class="server" show="true">
<section name="Server" class="server" show="true">
'''Example 1:''' This enables players to register on your server by using /register <password> in the chat window.
'''مثال 1 :''' /register <password> هذا يسمح للاعبين بالتسجيل في السيرفر عن طريق أستخدام
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function registerPlayer ( source, commandName, password )
function registerPlayer(source, commandName, password)
-- Check if the password field is blank or not (only blank if they didnt enter one)
-- تحقق مما إذا كان حقل كلمة المرور فارغ أم لا (فارغ إلا إذا لم يدخل واحد)
if ( password ~= "" and password ~= nil ) then
if (password ~= "" and password ~= nil) then
--Attempt to add the account, and save its value in a var
-- محاولة إضافة الحساب، وحفظ قيمته في فار
local accountAdded = addAccount( getPlayerName(source), password )
local accountAdded = addAccount(getPlayerName(source), password)
if ( accountAdded ) then
if (accountAdded) then
--  Tell the user all is done
--  اخبار المستخدم ان كل شيء تم
outputChatBox ( "Thank you " .. getPlayerName(source) .. ", you're now registed, you can login with /login", source )
outputChatBox("Thank you "..getPlayerName(source)..", you're now registed, you can login with /login", source)
else
else
-- There was an error making the account, tell the user
-- اخبار المستخدم انا هناك خطا عند انشاء الحساب
outputChatBox ( "Error creating account, contact the server admin", source )
outputChatBox("Error creating account, contact the server admin", source)
end
end
else
else
-- There was an error in the syntax, tell the user the correct syntax.
-- هناك خطأ في تركيب الامر ,اخبار المستخدم التركيب الصحيح
outputChatBox ( "Error creating account, correct syntax: /register <password>", source )
outputChatBox("Error creating account, correct syntax: /register <password>", source)
end
end
end
end
addCommandHandler ( "register", registerPlayer ) -- add the command handler
addCommandHandler("register", registerPlayer) -- اضافة امر
</syntaxhighlight>
</syntaxhighlight>


'''This code differs by allowing the user to change their username that they wish to use.'''
'''هذا الرمز يختلف عن طريق السماح للمستخدم بتغيير اسم المستخدم الخاص بهم الذي كانوا يرغبون في استخدام.'''


'''Example 2:''' This enables players to register on your server by using /register <username> <password> in the chat window.
'''مثال 2 :''' ا يسمح للاعبين للتسجيل في الخادم الخاص بك باستخدام /register <username> <password> في نافذة الشات.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function registerPlayer ( source, commandName, username, password )
function registerPlayer(source, commandName, username, password)
         if(password ~= "" and password ~= nil and username ~= "" and username ~= nil) then
         if(password ~= "" and password ~= nil and username ~= "" and username ~= nil) then
                 local accountAdded = addAccount(username,password)
                 local accountAdded = addAccount(username,password)
                 if(accountAdded) then
                 if(accountAdded) then
                         outputChatBox("Thank you " .. getPlayerName(source) .. ", you're now registed, you can login with /login",source)
                         outputChatBox("Thank you "..getPlayerName(source)..", you're now registed, you can login with /login",source)
                 else
                 else
                         outputChatBox("Error creating account, contact the server admin.",source)
                         outputChatBox("Error creating account, contact the server admin.",source)
Line 70: Line 67:
         end
         end
end
end
addCommandHandler ( "register", registerPlayer ) -- add the command handler
addCommandHandler("register", registerPlayer) -- اضافة امر
</syntaxhighlight>
</syntaxhighlight>


'''Example 3:''' This code differs again so the user can only register once /register <username> <password>.
'''مثال 3 :''' هذا الرمز يختلف مرة أخرى بحيث يمكن للمستخدم تسجيل مرة واحدة فقط /register <username> <password>.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
local bRegisteredOnce = false
local bRegisteredOnce = false


function registerPlayer ( source, commandName, username, password )
function registerPlayer(source, commandName, username, password)
         if(password ~= "" and password ~= nil and username ~= "" and username ~= nil and bRegisteredOnce == false) then
         if(password ~= "" and password ~= nil and username ~= "" and username ~= nil and bRegisteredOnce == false) then
                 local accountAdded = addAccount(username,password)
                 local accountAdded = addAccount(username,password)
                 if(accountAdded) then
                 if(accountAdded) then
                         outputChatBox("Thank you " .. getPlayerName(source) .. ", you're now registed, you can login with /login",source)
                         outputChatBox("Thank you " .. getPlayerName(source)..", you're now registed, you can login with /login",source)
                         bRegisteredOnce = true
                         bRegisteredOnce = true
                 else
                 else
Line 94: Line 91:
         end
         end
end
end
addCommandHandler ( "register", registerPlayer ) -- add the command handler
addCommandHandler("register", registerPlayer) -- اضافة امر
</syntaxhighlight>
</syntaxhighlight>
'''3B00DG4MER'''
</section>
</section>


==See Also==
==انظر ايضاً==
<!-- Change FunctionArea to the area that this function is in on the main function list page, e.g. Server, Player, Vehicle etc -->
<!-- Change FunctionArea to the area that this function is in on the main function list page, e.g. Server, Player, Vehicle etc -->
{{AR_Account_functions}}
{{AR_Account_functions}}


[[en:addAcount]]
[[es:addAcount]]
[[es:addAcount]]
[[ru:addAccount]]
[[ru:addAccount]]

Latest revision as of 20:58, 14 June 2021

هذه الوظيفة تقوم بأضافة حساب جديد إلى قائمة الحسابات المسجلة في السيرفر.

Syntax

account addAccount ( string name, string pass )

العناصر المطلوبة

  • name: أسم الحساب الجديد اللذي تريد تسجيلة.
  • pass: كلمة المرور للحساب اللذي تريد تسجيلة.

Returns

إذا كان أسم هذا الحساب قد تم تسجيلة مسبقاً أو إذا حدث خطأ ما false يرجع عنصر الحساب اللذي تم تسجيلة, أو

مثال

Click to collapse [-]
Server

مثال 1 : /register <password> هذا يسمح للاعبين بالتسجيل في السيرفر عن طريق أستخدام

function registerPlayer(source, commandName, password)
	-- تحقق مما إذا كان حقل كلمة المرور فارغ أم لا (فارغ إلا إذا لم يدخل واحد)
	if (password ~= "" and password ~= nil) then
		-- محاولة إضافة الحساب، وحفظ قيمته في فار
		local accountAdded = addAccount(getPlayerName(source), password)
		if (accountAdded) then
			--  اخبار المستخدم ان كل شيء تم
			outputChatBox("Thank you "..getPlayerName(source)..", you're now registed, you can login with /login", source)
		else
			-- اخبار المستخدم انا هناك خطا عند انشاء الحساب
			outputChatBox("Error creating account, contact the server admin", source)
		end
	else
		-- هناك خطأ في تركيب الامر ,اخبار المستخدم التركيب الصحيح
		outputChatBox("Error creating account, correct syntax: /register <password>", source)
	end
end
addCommandHandler("register", registerPlayer) -- اضافة امر

هذا الرمز يختلف عن طريق السماح للمستخدم بتغيير اسم المستخدم الخاص بهم الذي كانوا يرغبون في استخدام.

مثال 2 : ا يسمح للاعبين للتسجيل في الخادم الخاص بك باستخدام /register <username> <password> في نافذة الشات.

function registerPlayer(source, commandName, username, password)
        if(password ~= "" and password ~= nil and username ~= "" and username ~= nil) then
                local accountAdded = addAccount(username,password)
                if(accountAdded) then
                        outputChatBox("Thank you "..getPlayerName(source)..", you're now registed, you can login with /login",source)
                else
                        outputChatBox("Error creating account, contact the server admin.",source)
                end
        else
                outputChatBox("Error creating account, correct syntax: /register <nick> <pass>",source)
        end
end
addCommandHandler("register", registerPlayer) -- اضافة امر

مثال 3 : هذا الرمز يختلف مرة أخرى بحيث يمكن للمستخدم تسجيل مرة واحدة فقط /register <username> <password>.

local bRegisteredOnce = false

function registerPlayer(source, commandName, username, password)
        if(password ~= "" and password ~= nil and username ~= "" and username ~= nil and bRegisteredOnce == false) then
                local accountAdded = addAccount(username,password)
                if(accountAdded) then
                        outputChatBox("Thank you " .. getPlayerName(source)..", you're now registed, you can login with /login",source)
                        bRegisteredOnce = true
                else
                        outputChatBox("Error creating account, contact the server admin.",source)
                end
        else
                if bRegisteredOnce == true then
                    outputChatBox("You already registered on this server!",source)
                else
                    outputChatBox("Error creating account, correct syntax: /register <nick> <pass>",source)
                end
        end
end
addCommandHandler("register", registerPlayer) -- اضافة امر

3B00DG4MER

انظر ايضاً