0% found this document useful (0 votes)
25 views24 pages

User Management Interface in PHP

Uploaded by

toomyhong1913
Copyright
© All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
25 views24 pages

User Management Interface in PHP

Uploaded by

toomyhong1913
Copyright
© All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd

Manage User

Objectives
The main objective is the development of PHP code that will:

• Develop the interface to manage user information


• Since the interface must work on a regular computer or a mobile one (tablet and smartphone,
vertical or horizontal), the graphic examples included have the exact sizes of each device and its
display position. As such the concern of the graphics fitting should not exist
• Based on the type of information needed, add the command and related data to ask the server
for the information or data. This is done by sending data request to the server
• Display the result of the request in the graphic interface specified in this document
• When the user wants to submit new information, display the appropriate screen or dialog as
shown in this document, to get that data from the user and then send it to the server

Most of the work is handled by the server. The PHP code requests the data, displays it and sends it and
handles any eventual error, be it local or reported by the server.

The interface only needs to be replicated, as specified in this document

Parts that make up the user management


These are the specific parts that make up the user management, from the server activity to the local
activity, and further described after this section:

• Join Service, with new user information


• Get user data, comprising of these activities:
o Edit user profile
o Edit user password
o Edit user account
• Search user, to find and existing user or users

Each activity or function follows, with graphics of the user interface (UI). Next to the name of the activity
you have the command number or numbers (when more than one command is needed), to make it
easier to relate the function to the code needed to fully implement the function.

Important: except when joining the service, all other activities require that the user be logged on first.
As such, the first screen must do exactly that, so the Join Service must always be the first screen or
dialog to be shown, before the user can do anything else.

Copyright © 2012 Acupic Software Corp. 1


Each section has the description of the function, the UI to be implemented, the structure of the data
sent and received from the server, the size of each property in the data and the type of property to be
interpreted. At the end of this document there is a section with all of the UI colors and font sizes. For the
exact interface without any explanations, ask for the UI file if you have not received it already.

Join Service - 1
In order to do post and share, a user must first join the service. Display the following log on screen or
dialog:

Copyright © 2012 Acupic Software Corp. 2


Join Service dialog or screen

These are the steps to create the account when the Join button is shown:

01.00. Display new account page and form


01.01. Join button, create a request string with each field separated by a zero or a NULL. Each field can
have any length, up to the length shown below (anything longer will generate an error. Starting from
the start of the string or offset 0 the string must contain:

Copyright © 2012 Acupic Software Corp. 3


cmd - the number 1, for join service
uname - 18 characters (unicode)
userPwd - 18 characters with password with a minimum of 8 characters
fullName - 37 characters for user's full name
city - 27 characters for user's city
state - 22 characters for user's state or county (can be left blank if not USA)
country - 22 characters for user's country
email - 42 characters for user's email
webPg - 202 characters for user's web page (optional to submit)
bioDesc - 174 characters for a description or biography of the user (optional to submit)
timeZoneHr - the hours to GMT from the user’s location (a positive or negative number)
timeZoneMin - the miutes to GMT from the user’s location (a positive or negative number)
pic - a number 1 if a user picture added or a 0 for not added
picFile - 42 characters with the name of the picture file¹. Always include full filename, no path.
protect - a number with the protection level of this user (details below
usedAI - a number of zero as not accessed (as joining)

Notes - The picture must be a max of 700k, and jpg, png or gif.

01.02. Connect to server


Connect as per external instructions (ask for that).

01.03. Wait for response


If a timeout occurs, try again three times. Otherwise disconnect and advise the
user to try again later.

01.04. Send the request data


Send to the IP returned upon connecting.

01.05. Wait for the response


If a timeout occurs, try again three times. Otherwise disconnect and advise the
user to try again later. If a database error, this will come in the form of text starting with ERROR.

01.06. Result returned


Starting from offset 0 there is:

res - 1 text result with these possibilities:


0 = ASCII general error adding user. Try again or advise user to try
again later
1 = ASCII user added so send picture next if there is one. Otherwise disconnect.
2 = ASCII user name exists so try another name (see below)
3 = ASCII a full name with the given email exists
4 = ASCII the given email exists on the system

Copyright © 2012 Acupic Software Corp. 4


suggNm - 18 characters with a suggested user name (it may be blank
ownerID - 14 characters ownerID of the user that just joined.

Notes - A user name will only be suggested if the user name given exists already. It
based on the given name, with a number after it to keep to the basic given name.
Of course, the user can always try another if that is not the the user’s liking.

01.07. Upload the picture


Upload the picture now if the result is a 1 above. Otherwise skip to 1.10.
When uploading a picture, first get the picture or file’s size and send that
first as NULL ending string. Then send the picture itself. The server will
not return a result of the size of the string sent. Check for a socket error for
any errors. The server will use this size data to better upload the picture.

01.08. Wait for the response.


If a timeout occurs, try again three times. Otherwise disconnect and advise the
user to try again later.

01.09. Result returned


Only to tell result of the uploaded picture. Starting from offset 0 the data has:

res - 1 text result with these possibilities:


0 = ASCII error getting picture. Send again or advise user to add later
1 = ASCII picture received and added

01.10. User added so add viewing members


User added normally so disconnect and keep user name and password and then
display page to add members.

Del User Account - 50


To delete the user’s account send the following:

cmd - the number 50 for validate user


uname - 18 characters (unicode)
upswd - 18 characters with password with a minimum of 8 characters

50.02. Connect to server


Connect as per external instructions (ask for that).

50.03. Wait for response


If a timeout occurs, try again three times. Otherwise disconnect and advise the
user to try again later.

Copyright © 2012 Acupic Software Corp. 5


50.06. Result returned
A text string with one of these possibilities:

1 = Validated and enabled and the user can now access normally
0 = with this error: 6ERRUB and/or User not deleted

Validate User - 32
After the user joins the user’s account will be blocked until the account is specifically unblocked for
validation. Until the account is unblocked with this command all other commands will return this error:

6ERRUB and/or User not validated

To unblock just send this command (with the user name and password) to the server:

cmd - the number 32 for validate user


uname - 18 characters (unicode)
upswd - 18 characters with password with a minimum of 8 characters

32.02. Connect to server


Connect as per external instructions (ask for that).

32.03. Wait for response


If a timeout occurs, try again three times. Otherwise disconnect and advise the
user to try again later.

32.04. Send the request data


Send to the IP returned upon connecting.

32.05. Wait for the response


If a timeout occurs, try again three times. Otherwise disconnect and advise the
user to try again later. If a database error, this will come in the form of text starting with ERROR.

32.06. Result returned


A text string with one of these possibilities:

1 = Validated and enabled and the user can now access normally
0 = with this error: 6ERRUB and/or User not validated

Send Email - 46
Use this command to send email. It is prepared to handle other email options:

46.02. Connect to server


Connect as per external instructions (ask for that).

Copyright © 2012 Acupic Software Corp. 6


46.03. Wait for response
If a timeout occurs, try again three times. Otherwise disconnect and advise the
user to try again later.

46.04. Send the data


After the user has logged on, create a string with each field separated by a zero or a NULL.
Each field can have any length, up to the length shown below (anything longer will generate
an error. Starting from the start of the string or offset 0 the string must contain:

cmd - the number 3 for get user account data


uname - 18 characters (unicode)
upswd - 18 characters with password with a minimum of 8 characters
type - 1 character with a 1 to send a validation code or with a 2 to send a welcome email
code - up to 14 characters the validation code string

46.05. Wait for the response


If a timeout occurs, try again three times. Otherwise disconnect and advise the
user to try again later. If a database error, this will come in the form of text starting with ERROR.

46.06. Result returned

1 = Email sent. Note that this does not mean the email was sent successfully
0 = Or anything else indicates an error receiving or processing the command

Edit User Profile – 3 & 4


In order to edit the user’s profile, the user’s data needs to be requested. Seeing as that data needs to be
shown, display the following screen or dialog to receive the data:

Copyright © 2012 Acupic Software Corp. 7


Edit User Profile dialog or screen

This function is made up of getting the user data and then updating the data, which is the same in the
next two functions. Thus the first command below handles getting the data and the next one setting the
data.

GET USER DATA [3]


These are the steps to get the data to edit the account:

Copyright © 2012 Acupic Software Corp. 8


03.00. After the user has logged on, create a request string with each field separated by a zero or a
NULL. Each field can have any length, up to the length shown below (anything longer will
generate an error. Starting from the start of the string or offset 0 the string must contain:

01.01. Join button, create a request string with each field separated by a zero or a NULL. Each field can
have any length, up to the length shown below (anything longer will generate an error. Starting
from the start of the string or offset 0 the string must contain:

cmd - the number 3 for get user account data


uname - 18 characters (unicode)
upswd- 18 characters with password with a minimum of 8 characters

03.01. Connect to server


Connect as per external instructions.

03.02. Wait for response


If a timeout occurs, try again three times. Otherwise disconnect
and advise the user to try again later.

03.03. Send the request data


Send to the IP returned upon connecting.

03.04. Wait for the response


If a timeout occurs, try again three times. Otherwise disconnect
and advise the user to try again later.

03.05. Result returned


Starting from offset 0 the data has:

res - 1 int result with these possibilities:


0 = general error getting user data. Try again or advise to try again later
1 = user data returned

fullName - 37 characters with user's full name


city - 27 characters with user's city
state - 22 characters with user's state or county (can be left blank if not USA)
country - 22 characters with user's country
webPg - 202 characters with user's web page (optional)
bioDesc - 174 characters with a description or biography of the user
userPgLnk - 258 characters with link to user's page
timeZone - two numbers with time zone (i.e. no. 1: GMT-01:00; no. 2: GMT-00:30)
ublocked - 1 int - see blocked notes at the end
notify - 1 int used as binary on server
pic - a number 1 if a user picture added or a 0 for not added
picPath - 200 characters with FTP path to user's picture

Copyright © 2012 Acupic Software Corp. 9


stampPath - 200 characters with FTP path to user's stamp picture
protect - a number with the protection level of this user (details below)
usedAI - a number of zero as not accessed (as joining)

Proceed to SET USER DATA (below) when the user presses the Save changes button.

SET USER DATA [4]


These are the steps to update the account:

04.00. On save changes button press, create a string with each field separated by a zero or a NULL.
Each field can have any length, up to the length shown below (anything longer will generate an
error.

Starting from the start of the string or offset 0 the string must contain:

cmd - the number 4, for update user account data


uname - 18 characters. Just for logon. This cannot be edited or changed
upswd - 18 characters with password with a minimum of 8 characters
fullName - 37 characters for user's full name
city - 27 characters for user's city
state - 22 characters for user's state or county (can be left blank if not USA)
country - 22 characters for user's country
email - 42 characters for user's email
webPg - 202 characters for user's web page (optional)
bioDesc - 174 characters for a description or biography of the user
nwPswd - 18 characters with a new password; blank if now new password
timeZone - two numbers with time zone (i.e. no. 1: GMT-01:00; no. 2: GMT-00:30)
pic - a number 1 if a user picture added or a 0 for not added and 2, deleted
picFile - 42 characters with the name of the picture file¹. Always include full filename, no path.
protect - a number with the protection level of this user (details below
usedAI - a number of one that the user accessed AI (or zero not accessed)

04.01. Connect to server again


Connect as usual.

04.02. Wait for response


If a timeout occurs, try again three times. Otherwise disconnect and advise
the user to try again later.

04.03. Send the requested data


Send to the IP returned upon connecting.

Copyright © 2012 Acupic Software Corp. 10


04.04. Wait for the response
If a timeout occurs, try again three times. Otherwise disconnect
and advise the user to try again later. If a database error, this will come in the form of text
starting with ERROR.

04.05. Result returned


Starting from offset 0 the data has:

res – 1 text result with these possibilities:

ERRUP = general error updating user. Try again or advise user to try again later
1 = ASCII user updated so send picture next if picture updated. Disconnect otherwise.
2 = ASCII new email already exists on the system so update rejected.

04.06. Upload the picture


Upload the picture now if the result is a 1 above. Otherwise skip to 3.15.
When uploading a picture, first get the picture or file’s size and send that first
as NULL ending string. Then send the picture itself. The server will not return
a result of the size of the string sent. Check for a socket error for errors. The
server will use this size data to better upload the picture.

04.07. Wait for the response


If a timeout occurs, try again three times. Otherwise disconnect and advise
the user to try again later.

04.08. Result returned


Only to tell the result of picture uploaded above. Starting from offset 0 the data has:

res – 1 text result with these possibilities:


0 = ASCII error getting picture. Send again or advise user to add later
1 = ASCII picture received and added

04.09. User updated


User updated normally so disconnect and keep user name and password.

Edit User Password – 3 & 4


So as to change the user’s password, the user’s data needs to be requested, with the password to make
sure it has indeed changed (warn if it was not changed). Even though the password will not be shown,
start by displaying the following screen or dialog for the user to enter the new password:

Copyright © 2012 Acupic Software Corp. 11


Change User Password dialog or screen

This function is made up of getting the user data and with it the new password. After the new password
is entered, compare both versions and also compare it with the existing password and then update the
server. Thus the first command below handles getting the data and the next one setting the data.

GET USER DATA [3]


These are the steps to get the data to edit the account:

Copyright © 2012 Acupic Software Corp. 12


03.00. After the user has logged on, create a string with each field separated by a zero or a NULL. Each
field can have any length, up to the length shown below (anything longer will generate an error.
Starting from the start of the string or offset 0 the string must contain:

cmd - the number 3 for get user account data


uname - 18 characters (unicode)
upswd- 18 characters with password with a minimum of 8 characters

03.01. Connect to server


Connect as per external instructions.

03.02. Wait for response


If a timeout occurs, try again three times. Otherwise disconnect
and advise the user to try again later.

03.03. Send the request data


Send to the IP returned upon connecting.

03.04. Wait for the response


If a timeout occurs, try again three times. Otherwise disconnect
and advise the user to try again later.

03.05. Result returned


Starting from offset 0 the data has:

res - ERRUS text that either user not found or password wrong
ERRUB text of user blocked
0 = int with general error getting user data. Try again or advise to try again later
1 = int that user data returned normally

fullName - 37 characters with user’s full name


city - 27 characters with user’s city
state - 22 characters with user’s state or county (can be left blank if not USA)
country - 22 characters with user’s country
webPg - 202 characters with user’s web page (optional)
bioDesc - 174 characters with a description or biography of the user
userPgLnk - 258 characters with link to user’s page
timeZone - two numbers with time zone (i.e. no. 1: GMT-01:00; no. 2: GMT-00:30)
ublocked - 1 int – see blocked notes at the end
notify - 1 int used as binary on server
pic - a number 1 if a user picture added or a 0 for not added
picPath - 200 characters with FTP path to user’s picture
stampPath - 200 characters with FTP path to user’s stamp picture
protect - a number with the protection level of this user (details below)

Copyright © 2012 Acupic Software Corp. 13


Proceed to SET USER DATA (below) when the user presses the Save changes button.

SET USER DATA [4]


These are the steps to update the account:

04.00. On save changes button press, create a string with each field separated by a zero or a NULL.
Each field can have any length, up to the length shown below (anything longer will generate an
error).

Starting from the start of the string or offset 0 the string must contain:

cmd - the number 4, for update user account data


uname - 18 characters. Just for logon. This cannot be edited or changed
upswd - 18 characters with password with a minimum of 8 characters
fullName - 37 characters for user’s full name
city - 27 characters for user’s city
state - 22 characters for user’s state or county (can be left blank if not USA)
country - 22 characters for user’s country
email - 42 characters for user’s email
webPg - 202 characters for user’s web page (optional)
bioDesc - 174 characters for a description or biography of the user
nwPswd - 18 characters with a new password; blank if now new password
timeZone - two numbers with time zone (i.e. no. 1: GMT-01:00; no. 2: GMT-00:30)
pic - a number 1 if a user picture added or a 0 for not added
picFile - 42 characters with the name of the picture file
protect - a number with the protection level of this user (details below)

Notes - In reality, only the password data will be used by the server in this case.

04.01. Connect to server again


Connect as usual.

04.02. Wait for response


If a timeout occurs, try again three times. Otherwise disconnect and advise
the user to try again later.

04.03. Send the requested data


Send to the IP returned upon connecting.

04.04. Wait for the response


If a timeout occurs, try again three times. Otherwise disconnect and advise the user to try again
later . If a database error, this will come in the form of text starting with ERROR.

04.05. Result returned


Starting from offset 0 the data has:

Copyright © 2012 Acupic Software Corp. 14


res – 1 int result with these possibilities:

0 = general error updating user. Try again or advise user to try again later
1 = All okay so disconnect.

04.09. User updated


User updated normally so disconnect and keep user name and password.

Edit User Account- 3 & 4


In order to edit the user’s account, the user’s data needs to be requested. Since that data needs to be
shown, display the following screen or dialog to receive the data:

Edit User Account dialog or screen

This function is made up of getting the user data and displaying it. When the user presses the Save
changes button, proceed to update the data changes, after starting with the first command below to get
the data and then using the next command to set or update the data.

GET USER DATA [3]


These are the steps to get the data to edit the account:

Copyright © 2012 Acupic Software Corp. 15


03.00. After the user has logged on, create a string with each field separated by a zero or a NULL. Each
field can have any length, up to the length shown below (anything longer will generate an error).
Starting from the start of the string or offset 0 the string must contain:

cmd - 1 int with the number and 3 for get user account data
uname - 18 characters (unicode)
upswd- 18 characters with password with a minimum of 8 characters

03.01. Connect to server


Connect as per external instructions.

03.02. Wait for response


If a timeout occurs, try again three times. Otherwise disconnect
and advise the user to try again later.

03.03. Send the request data


Send to the IP returned upon connecting.

03.04. Wait for the response


If a timeout occurs, try again three times. Otherwise disconnect
and advise the user to try again later.

03.05. Result returned


Starting from offset 0 the data has:

res – 1 int result with these possibilities:


0 = general error getting user data. Try again or advise to try again later
1 = user data returned

fullName - 37 characters with user’s full name


city - 27 characters with user’s city
state - 22 characters with user’s state or county (can be left blank if not USA)
country - 22 characters with user’s country
webPg - 202 characters with user’s web page (optional)
bioDesc - 174 characters with a description or biography of the user
userPgLnk - 258 characters with link to user’s page
timeZone - two numbers with time zone (i.e. no. 1: GMT-01:00; no. 2: GMT-00:30)
ublocked - 1 int – see blocked notes at the end
notify - 1 int used as binary on server
pic - a number 1 if a user picture added or a 0 for not added
picPath - 200 characters with FTP path to user’s picture
stampPath - 200 characters with FTP path to user’s stamp picture
unameFTP - 20 characters with user name for FTP access

Copyright © 2012 Acupic Software Corp. 16


pswdFTP - 20 characters with password for FTP access
protect - a number with the protection level of this user (details below)

Proceed to SET USER DATA (below) when the user presses the Save changes button.

SET USER DATA [4]


These are the steps to update the account:

04.00. On save changes button press, create the update data structure.

Starting from offset 0 the data must contain:

cmd - 1 int with the number 4, for update user account data
uname - 18 characters. Just for logon. This cannot be edited or changed
upswd - 18 characters with password with a minimum of 8 characters
fullName - 37 characters for user’s full name
city - 27 characters for user’s city
state - 22 characters for user’s state or county (can be left blank if not USA)
country - 22 characters for user’s country
email - 42 characters for user’s email
webPg - 202 characters for user’s web page (optional)
bioDesc - 174 characters for a description or biography of the user
nwPswd - 18 characters with a new password; blank if now new password
timeZone - two numbers with time zone (i.e. no. 1: GMT-01:00; no. 2: GMT-00:30)
pic - a number 1 if a user picture added or a 0 for not added
picFile - 42 characters with the name of the picture file
protect - a number with the protection level of this user (details below)

Notes - Only the requested data will be included by the server. The rest ignored.

04.01. Connect to server again


Connect as usual.

04.02. Wait for response


If a timeout occurs, try again three times. Otherwise disconnect and advise
the user to try again later.

04.03. Send the requested data


Send to the IP returned upon connecting.

04.04. Wait for the response


If a timeout occurs, try again three times. Otherwise disconnect
and advise the user to try again later. . If a database error, this will come in the form of text starting with
ERROR.

Copyright © 2012 Acupic Software Corp. 17


04.05. Result returned
Starting from offset 0 the data has:

res – 1 int result with these possibilities:

0 = general error updating user. Try again or advise user to try again later
1 = Okay, so disconnect

04.08. Result returned


Only to tell the result of picture uploaded above. Starting from offset 0 the data has:

res – 1 int result with these possibilities:


0 = error getting picture. Send again or advise user to add later
1 = picture received and added

04.09. User updated


User updated normally so disconnect and keep user name and password.

Get and Change User Settings- 34 & 35


The User Settings can be saved to the server so be retrieved when the user logs on, typically when
getting the user’s data. That way the settings will be the same no matter what device.

These functions allow saving certain variables and then getting them.

GET SETTINGS [34]


These are the steps to get the user’s settings:

34.00. After the user has logged on, create a string with each field separated by a zero or a NULL. Each
field can have any length, up to the length shown below (anything longer will generate an error).
Starting from the start of the string or offset 0 the string must contain:

cmd - 1 int with the number and 34 for get user account data
uname - 18 characters (unicode)
upswd- 18 characters with password with a minimum of 8 characters

34.01. Connect to server


Connect as per external instructions.

34.02. Wait for response


If a timeout occurs, try again three times. Otherwise disconnect
and advise the user to try again later.

34.03. Result returned


A comma delimited string with the following data:

Copyright © 2012 Acupic Software Corp. 18


res – 1 a number result with these possibilities:
0 = general error getting user data. Try again or advise to try again later
1 = user data returned

count - 1 a number with the count of settings returned


selected group - a number with selected group to display. Note that this should not change
the order of the groups, with Home always at the top, then Public posts. The
other groups will be in the order of the most new posts and then the last
order of groups sent. Default = Home group
email alterts - a number where 0 = no email alert and 1 = email when a new post added to
a group
view or follow - a number where 0 = viewers/viewing and 1 = followers/following
group open - a number where 0 = group dialog closed when Bryxe starts and 1 = dialog open

SET SETTINGS [35]


These are the steps to update the user’s settings:

35.00. After the user has logged on, create a string with each field separated by a zero or a NULL. Each
field can have any length, up to the length shown below (anything longer will generate an error).
Starting from the start of the string or offset 0 the string must contain:

cmd - 1 int with the number and 34 for get user account data
uname - 18 characters (unicode)
upswd - 18 characters with password with a minimum of 8 characters
selected group - a number with the next selected group, where Home (1) will be the default
email alterts - a number where 0 = no email alert and 1 = email when a new post added to
a group
view or follow - a character number where 0 = viewers/viewing and 1 = followers/following
group dialog - a character number where 1 = dialog is open when Bryxe loads and 0 it is closed

35.01. Connect to server


Connect as per external instructions and send the full command above.

35.02. Wait for response


If a timeout occurs, try again three times. Otherwise disconnect
and advise the user to try again later.

35.03. Result returned


A comma delimited string with the following data:

res – 1 a number result with these possibilities:


0 = general error getting user data. Try again or advise to try again later
1 = user settings updated normally

Copyright © 2012 Acupic Software Corp. 19


Search User – 5
To search for an existing user display this screen or dialog:

Search for user dialog or screen

Note that the example above has three sections:

• The top part shows an edit box to get the user information to be searched for
• The middle part displays the result of the search when a user is found, with a button to include
that user as a member of this user
• The bottom part is displayed when the user searched for was not found

The idea is to display the top part initially and then show either the middle or the bottom part, together
with the top, depending on the result. That way it becomes easier to search again, no matter what the
outcome is.

These are the command to request a search on the server and then get the results from there.

SEARCH USER [5]

Copyright © 2012 Acupic Software Corp. 20


05.00. Create a request string with each field separated by a zero or a NULL. Each field can have any
length, up to the length shown below (anything longer will generate an error). Starting from
the start of the string or offset 0 the string must contain:

cmd - the number 5, for search for a user


uname - 18 characters (21nicode)
upswd - 18 characters (obtained when logging on)
searchTxt - 50 characters with the search string
schNo - the number to start the search from
count - the count of data block search results to return

05.01. Connect to server


Connect as per external instructions.

05.02. Wait for the response


If a timeout occurs, try again three times. Otherwise disconnect
and advise the user to try again later.

05.03. Result returned


Starting from offset 0 the data has:

res – 1 int result with these possibilities:

0 = general error searching. Try again or advise user to try again later
1 = search found and returned here
2 = search string not found

count - 1 int with count returned

cntLeft - 1 int where:

0 = more records of data available


1 = reached and returned last record of data

viewerID - 12 characters the viewer ID to use as needed


stampPic - 202 characters with path to stamp picture of user
picID - 202 characters with path to picture of user
userIDLink - 258 characters with link to user’s page
fullNm - 35 characters with user’s full name
uname - 18 characters with user’s name to display
ucity - 27 characters with the user’s city
ucountry - 22 characters with the user’s country
bioDesc - 174 characters for a description or biography of the user

Copyright © 2012 Acupic Software Corp. 21


05.04. Display result
Display the result in the search dialog with the view button to add the searched user
as a member of this user

User interface font sizes and colors


The font sizes given here should be double checked against the exact visual spaces they occupy, as
shown in the screens above. The reason this is important is that the sizes are taken from Photoshop, so
there can be some point variations. However, the colors are the exact ones. These are the fonts and
colors of the screens or dialogs:

Copyright © 2012 Acupic Software Corp. 22


User management dialogs or screens

Copyright © 2012 Acupic Software Corp. 23


Search for user dialog or screen

1 - Accepted Picture file types:

JPEG , PNG, GIF, BMP, JPEG2000, PCX and TIFF. Restrict pictures to 500k in size.

Copyright © 2012 Acupic Software Corp. 24

Common questions

Powered by AI

First, create a string with each field separated by a zero or NULL . After connecting and if a timeout occurs, retries are made three times . The outcomes could be an error message ('ERRUS' or 'ERRUB') if there's an issue with the user or password, or data returned if successful .

Errors like 'general error getting user data' (res=0) and 'ERRUS' or 'ERRUB' indicate issues retrieving data . Users are advised to retry after operating timeouts or correct authentication details as appropriate .

To update a user account, a string must be created with each field separated by a zero or a NULL, starting from offset 0 including fields like cmd, uname, upswd, etc. . After connecting to the server, if a timeout occurs, the process is attempted three more times before advising the user to try again later . The result returned might be 'ERRUP' if there's a general error, 1 if the update is successful, or 2 if a new email already exists .

The system requires checking the picture or file’s size first, sending it as a NULL-ending string before uploading the picture itself . If the result is 1, the picture is received and added; otherwise, an error is indicated . If a timeout occurs during the upload process, up to three retries are attempted before advising the user to try again later .

User settings include a field for timeZone specified as two numbers, accommodating various global time offsets (e.g., GMT-01:00). This implies a diverse, international user base requiring localized features.

User data is structured as a string where each field is separated by a zero or NULL. It includes a command number and mandatory fields like uname and upswd, followed by optional data fields such as fullName, city, and others . This structure enables quick parsing and processing by the server.

When a timeout occurs, the system attempts to reconnect up to three times. If the issue persists, the user is advised to try again later . This protocol helps ensure robust user experience despite temporary connectivity issues.

Each field in the user data has a specified maximum length, such as uname with 18 characters, and email with 42 characters . These constraints are vital to ensure data integrity, prevent buffer overflows, and maintain efficient database storage.

After uploading, the system checks the result: 0 indicates an error requiring resending, while 1 confirms receipt and addition of the picture . This mechanism ensures only valid uploads are processed, maintaining database integrity.

The protection level is a numeric value denoting the user's security access or restrictions within the system. It influences permissions and safeguards sensitive user information from unauthorized access .

You might also like