Difference between revisions of "ARCC Expert EN"

Revision as of 20:18, 21 November 2014

DeutschEnglishEspañolFrançaisРусский105 EN pages.

WIP
in Arbeit - work in progress - trabajo en curso - travaux en cours - незавершенное

Übersetzung , bitte.

To check the quality of the text itself

Traducción, por favor.

À corriger par rapport à l'anglais

перевод, пожалуйста.

User guide for Ark, short for Ryzom Arkitect.

For historical reasons, those manuals refers very often, almost always, to A.R.C.C.. This is due to the fact that the full documentation has been started with the initial name, ARCC, meaning Advanced Ryzom Content Creator.

Ryzom specific BBCODE

date

date displays date in "human". See also time.

Settings

text: If empty or zero gives the actual date.

otherwise, seconds to add to 1970-01-01 00:00.

attribute: format for the date. By default if empty: "YYYY-MM-DD hh:mm"

Exemples

[date]0[/date] => 2014-10-24 15:31
[date]3600[/date] => 1970-01-01 02:00
[date]-3600[/date ]=> 1970-01-01 00:00

[date="%d/%m/%Y %H:%M"]3600[/date] => "01/01/1970 02:00"

db

db store or read a value in a DB. DB is of different kind of rows sets. For instance, "player" DB will memorize the name of the player in column 0; ARCC DB, will memorize an internal number,... Columns can be named, otherwise they are referred by the sequential numeration 0 to n

Settings

text: (general form: xxx:xxx:xxx)
1. store a data in a cell
2. read the contents in a cell

A cell is defined as: line:scope where:

line is a specific kind of data.
scope is associated to the characteristics of the players who are:
1. player (by default and equivalent to '0' )
2. guild
3. arcc
4. civ
5. cult
6. org
7. race

attribute: Name of the database.

Examples

[db=TestDB]0:0=100[/db] load 100 in the cell 0:0 of TestDB.
[db=TestDB]3:0[/db] read the cell 3:0

div

div is the equivalent of the HTML bloc <div>. That container can divide the page in sections containing the style and other attributes of a HTML bloc.

Settings

text: Any kind of data who can be included in a HTML bloc: text, images... and their format.
attribute: normaly an array composed by three elements:
- class
- id
- style

Exemples

[div class="Bepock" id="bepock" style="margin:1em;padding:1em;border:none;background:#fed;color:#300;"]Blabla<br/>blabla<br/>...[/div]

displays:

Blabla
blabla
...

func

func allow the execution of some functions known in Ryzom.

Settings

text: (general form: <1st_part_of_text>|<2nd_part_of_text>|...). Parameters for the functions (except if function has no parameters, in that cas could be the function itself).
attribute:one of the next functions:
- now: internal server time in tics
- rand: random value in a range of two limits.
- sqrt: square root.
- log: natural logarithm.
- pow: power of <1st_number_in_text> by <2nd_number_in_text>.
- round: round of a number.
- floor: floor of a number.
- min: min between two numbers.
- max: max between two numbers.
- find: find in the <1st_string_in_text> the <2nd_string_in_text>: return 1 if found, otherwise, 0.
- split: split the <1st_part_of_text> (a string) by the <2nd_part_of_text> (a char) and return the nth element of the split gift by the <3rd_part_of_text> (a number), if define otherwise the first element counting from 0.
- substr: extract a substring from the <1st_part_of_text> (a string) begininh at the <2nd_part_of_text> (a number) till the <3rd_part_of_text> (a number), if define otherwise till the end of the given string. Chars are counted from 0.
- unset_url_param: unset parameters.
- building: include if not already defined an alias to the <1st_string_in_text>.

Exemples

now: [func]now[/func] or [func=now]100[/func]
rand: [func=rand]0|10[/func]
sqrt: [func=sqrt]64[/func] = 8
log: [func=log]10[/func] = 2.302585092994
pow: [func=pow]10|2[/func] = 100
round: [func=round]2.85092994[/func] = 3
floor: [func=floor]2.85092994[/func] = 2
min: [func=min]10|2[/func] = 2
max: [func=max]10|2[/func] = 10
find:
- [func=find]AZERTYUIOP|Y[/func] = 1
- [func=find]azertyuiop|Y[/func] = 0
split:
- [func=split]A_B_C_D|_[/func] = A
- [func=split]A_B_C_D|_|2[/func] = C
substr:
- [func=substr]A_B_C_D|2[/func] = B_C_D
- [func=substr]A_B_C_D|2|4[/func] = B_C_

hack

Empty function!

img

img displays an image. Something is wrong because, I (Bepock) obtain always a " title="" /> after the image. Use [imgurl] instead: it works fine.

Settings

text: image_URL
attribute: does not work

Exemples

[img]http://app.ryzom.com//data/icons/32/emotion_happy.png[/img]

displays:

" title="" />

imgurl

imgurl displays an image linking to an URL.

Settings

text: (general form: xxx xxx xxx). 2 kinds of data:
1. URL of the image, mandatory: clickable image;
2. Display name of the URL when mouse goes over the image. Preceded by the underscore character ("_"), it is a text that will be translated. It remains enclosed by brackets "{}" if it is not translated.
attribute: URL

Exemples

[imgurl=http://forge.ryzom.com/wiki/ARCC_Expert_EN]http://app.ryzom.com//data/icons/32/emotion_tongue.png _The_ARCC[/imgurl]

displays:

lua

lua passes the text to the Ryzom Lua interpreter.

Settings

text: Lua script.
attribute: None.

scripturl

scripturl cats action, action number and extension to be send to the server.

Settings

text: add a PHP extension to the URL gift in the atribute.
attribute:
- Nothing: current action number of the script.
- Otherwise: first letter of the letter field if not "space". In that case add a "+".

Exemples

Launched from script 2088:

[scripturl]ryform_action=edit&ryform_name=stages%3A0[/scripturl] donne:

http://app.ryzom.com/app_arcc/index.php?action=script_Edit&script=2088&ryform_action=edit&ryform_name=stages%3A0

session

session is the simplest way to memorize data during the session, i.e. the connection. It offers also quicker answer, because it is a temporary memory not stored in the DB server.

It can be use also in some condition as a temporary array, when each Rows are named, because that is the internal behaviour of Session.

Settings

text: depends of the attribute.
attribute:
- <empty> : text is the raw name of Session.
- any raw name : save the text in the temporary memory of Session.

Exemples

Putting a value:
- [session=Name_1]Name one[/session]
- [session=Name_2]⇒Name two⇐[/session]
Getting the value stored in the session (connection)
- Name_1 = [session]Name_1[/session] displays : "Name one"
- Name_2 = [session]Name_2[/session] displays : "⇒Name two⇐"

timer

timer displays time in format "hh:mm:ss".

See also date.

Settings

text: If empty or zero or "now()" gives the actual time in days_of_the_current_year:GMT_hour:minutes:seconds.

otherwise, treats the value in the text as number of seconds, and display the equivalent "hour:minutes:seconds.

attribute: None.

Exemples

[timer][/timer] or [timer]now()[/timer] or [timer]0[/timer] => 296:13:05:18
[timer]60[/timer] => 00:01:00
[timer]3600[/timer] => 01:00:00

url

url is the standard way to pass an URL. That URL visually is formatted as usual in Ryzom.

Settings

text : URL or text to display
attribute:
- if text=<empty>: URL;
- else, text to be displayed: name, description... of the URL.

Exemples

[url]http://forge.ryzom.com/wiki/ARCC_Expert_EN[/url]
[url=http://forge.ryzom.com/wiki/ARCC_Expert_EN]The ARCC[/url]

WIP
in Arbeit - work in progress - trabajo en curso - travaux en cours - незавершенное

expr

affichage du calcul
affichage du résultat

map

Paramètres

text:
attribute: significatif si texte est nul

Exemples

[map]18176,-29492[/map]

link

Paramètres

text:
attribute: significatif si texte est nul

Exemples

[link][/link] ⇒ http://app.ryzom.com/app_arcc/index.php?action=script_Edit&event=211&script=1929

http://app.ryzom.com/app_arcc/index.php?action=scripts_Main&event=211 (A.R.C.C. » TESTS » Bepock » UserGuide » NewEvent » Nouvel event )

[link]GrimSon[/link] ⇒ http://app.ryzom.com/app_arcc/index.php?action=script_Edit&event=211&script=1936

http://app.ryzom.com/app_arcc/index.php?action=script_Edit&script=1936&version=0 (A.R.C.C. » TESTS » Bepock » UserGuide » NewEvent » NewEvent » GrimSon)

[link]#weGPlayerInfos_BBCodeTest[/link] ⇒ http://app.ryzom.com/app_arcc/index.php?action=script_Edit&script=2088&select=weGPlayerInfos_BBCodeTest

http://app.ryzom.com/app_arcc/index.php?message=recipe_updated&action=script_Edit&script=2088&ryform_action=&ryform_name= (

A.R.C.C. » TESTS » Bepock » UserGuide » NewEvent » NewEvent » BBCODE: stage weGPlayerInfos_BBCodeTest)

validate

Paramètres

text:
attribute: significatif si texte est nul

Exemples

trad

trad displays one of the translations associated to a keyword if it exist in the language of the user (See also the "trad tool" of ARK).

Paramètres

text: (general form: xxx|xxx|xxx, and internal xxx_xxx_xxx).
attribute: significatif si texte est nul

Exemples

t

Paramètres

text: (general form xxx|xxx|xxx)
attribute: None.

Exemples

math

math calculates basic calculations.

Settings

text : a basic calculations with the four arithmetical operators: +, -, *, /.
attribute: no significative.

Exemples

[math]1+2*3-4/6[/math] = 6.3333333333333
[math=toto][/math] and [math=toto]1+2*3-4/6t[/math] => no output

[math][func=round]6.45[/func][/math] = 6
[math][func=round]6.45[/func]*2[/math] = 12

itemicon

Paramètres

text:
attribute: None.

Exemples

param

Paramètres

text:
attribute: None.

Exemples

data

Paramètres

text:
attribute: None.

Exemples

get

Paramètres

text:
attribute: None.

Exemples

post

Paramètres

text:
attribute: None.

Exemples

playerinfos

playerinfos gives some informations concerning the player.

Settings

text: (general form: xxx|xxx|xxx) . One of the next keys: 'name', 'fullname', 'id', 'guild', 'guild_id', 'pvp_points', 'money', 'cid', 'gender' or 'api'.

- next fields up to 2: values of that key if needed for api.
attribute:
- <empty>:
- beginning with #:
- other:

                       if ($attr[0] == "#") action semble être un des parametres important... àtester
                               $name = ryzom_get_param(substr($attr, 1));
                       else
                               $name = $attr;
                       
                       $db = ryDB::getInstance('webig');
                       $player_infos = $db->querySingle('players', array('name' => strtolower($name), 'deleted' => 0, 'shard' => ryzom_get_param('shard', _user()->shardid)));
                       p($player_infos);
                       if ($player_infos) {
                               $text = explode('|', $text);
                               switch ($text[0]) {
                                       case 'id':
                                               return $player_infos['id'];
                                       case 'cid':
                                               return $player_infos['cid'];
                                       case 'api':
                                               return ryzom_player_value($player_infos['id'], $text[1], '$text[2]');

http://app.ryzom.com/app_forum/index.php?page=topic/view/21035/1#1 http://app.ryzom.com/app_ryzhome/index.php?from_index=1

attribute:
- Empty
- "#"
- <name>

Exemples

gender

Paramètres

texte:
attribute: significatif si texte est nul

Exemples

playerbackup

Paramètres

text:
attribute: significatif si texte est nul

Exemples

playerstat

Paramètres

text: (general form: xxx:xxx:xxx)
attribute: significatif si texte est nul

Exemples

scriptinfos

Paramètres

text:
- id: return the number id of the script.

- stage: return the currentStage in the script. Does not work?
- is_valid_url

attribute: None.

Exemples

[*][scriptinfos]id[/scriptinfos] [*][scriptinfos]stage[/scriptinfos] [*][scriptinfos]is_valid_url[/scriptinfos]

if

Paramètres

text:
attribute: significatif si texte est nul

Exemples

ifnot

Paramètres

text:
attribute: significatif si texte est nul

Exemples

HTML

		Alpha :	([db=TestDB]0:0[/db]+2000)/4000
		Beta :	[db=TestDB]1:0[/db]/4000+60
		Gamma :	[db=TestDB]2:0[/db]/4000
		Delta :	[db=TestDB]3:0[/db]/4000

[list=1] [*]now:[func]now[/func] [*]rand %:[func=rand]0|100[/func] [*]calc:[math](10*2)[/math] [*]session DATE:[session=DATE][func]now[/func][/session] [*]DATE:[session]DATE[/session] [*]date:[date]DATE[/date] [*]rand*DATE:[math][func=rand]0|100[/func]*[session]DATE[/session][/math] [*]rand*DATE:[math]([func=rand]0|100[/func]*[session]DATE[/session])%100[/math] [*] [/list]

[list] [*]session DATE:[session=DATE][func]now[/func][/session] [*]DATE:[session]DATE[/session] [*]date:[date]DATE[/date]

[*]1 [date shard=atys][/date] [*]2 [date=atys][/date] [*]3 [date shard][/date] [*]4 [date][/date] [*]5 [date]1407426669[/date] [session=DATE][func]now[/func]+1000[/session] [*]6 [time][session]DATE[/session][/time] [*] [*]Samedi 8 Novembre 12:00:00 UTC (dans 3 mois) [*]17h - Tria, Pluvia 15, 3e CA 2580 [*][time]2014-11-08 12:00[/time] [*]1:[date shard=atys]2014-11-08 12:00[/date] [*]2:[date=atys]2014-11-08 12:00[/date] [*]3:[date shard]2014-11-08 12:00[/date] [*]4:[date]2014-11-08 12:00[/date] [*] [*]1:[date shard=atys]2014-11-08 12:00[/date] [*]2:[date=atys]2014-11-08 12:00[/date] [*]3:[date shard]2014-11-08 12:00[/date] [*]4:[date]2014-11-08 12:00[/date] [*] [*]1:[shard=atys]2014-11-08 12:00[/shard] [*]2: [*]3:[shard]2014-11-08 12:00[/shard] [*]4:[date]2014-11-08 12:00[/date] [*] [*]1:[date shard=atys=2014-11-08 12:00][/date] [*]2:[date=atys=2014-11-08 12:00][/date] [*]3:[date shard=2014-11-08 12:00][/date] [*]4:[date=2014-11-08 12:00][/date] [*] [*] [*] [*] [*] [*] [*] [*] [/list]

liste des item .ps et .sitem?

players dans les db permet de différencier et mémoriser chaque players ! il doir en etre de meme pour guilde etc...

Paramètres

text:
attribute: significatif si texte est nul

Exemples

⇒

Autre soutils de l'ARCC

Traduction automatique

Ryzom Wiki: Ryzom Commons | DE • EN • ES • FR • RU | Ryzom Forge

@@ Line 263: / Line 263: @@
 </div>
 ===math===
-<div style="margin:0em; padding:0em;border: none;background:yellow;">
+''' ''math'' ''' calculates basic calculations.
-====Paramètres====
+====Settings====
-*'''text''':
+*'''text''' : a basic calculations with the four arithmetical operators: +, -, *,  /.
-*'''attribute''': significatif si texte est nul
+*'''attribute''': no significative.
-**
 ====Exemples====
-</div>
+*[math]1+2*3-4/6[/math] = 6.3333333333333
-@process randint(0, 100)
+*[math=toto][/math] and [math=toto]1+2*3-4/6t[/math] => no output
+*[math][func=round]6.45[/func][/math] = 6
+*[math][func=round]6.45[/func]*2[/math] = 12
 ===itemicon===

From Ryzom Forge Wiki

Revision as of 20:18, 21 November 2014

Contents

Ryzom specific BBCODE

date

Settings

Exemples

db

Settings

Examples

div

Settings

Exemples

func

Settings

Exemples

hack

img

Settings

Exemples

imgurl

Settings

Exemples

lua

Settings

scripturl

Settings

Exemples

session

Settings

Exemples

timer

Settings

Exemples

url

Settings

Exemples

expr

map

Paramètres

Exemples

link

Paramètres

Exemples

validate

Paramètres

Exemples

trad

Paramètres

Exemples

t

Paramètres

Exemples

math

Settings

Exemples

itemicon

Paramètres

Exemples

param

Paramètres

Exemples

data

Paramètres

Exemples

get

Paramètres

Exemples

post

Paramètres

Exemples

playerinfos

Settings

Exemples

gender

Paramètres

Exemples

playerbackup

Paramètres

Exemples