Difference between revisions of "ARCC Expert EN"

From Ryzom Forge Wiki

Jump to: navigation, search
Line 20: Line 20:
 
===date===
 
===date===
 
''' ''date'' ''' displays date in "human". See also ''[[#time|time]]''.
 
''' ''date'' ''' displays date in "human". See also ''[[#time|time]]''.
====Paramètres====
+
====Settings====
 
*text: If empty or zero gives the actual date.
 
*text: If empty or zero gives the actual date.
 
:otherwise, seconds to add to 1970-01-01 00:00.
 
:otherwise, seconds to add to 1970-01-01 00:00.
Line 30: Line 30:
  
 
*[date="%d/%m/%Y %H:%M"]3600[/date] => "01/01/1970 02:00"
 
*[date="%d/%m/%Y %H:%M"]3600[/date] => "01/01/1970 02:00"
 +
<hr/>
 +
 +
=== 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:
 +
* # store a data in a cell
 +
* # 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:
 +
## player (by default and equivalent to '0' )
 +
## guild
 +
## arcc
 +
## civ
 +
## cult
 +
## org
 +
## 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
 
<hr/>
 
<hr/>
  
Line 37: Line 63:
 
===imgurl===
 
===imgurl===
 
''' ''imgurl'' ''' displays an image linking to an URL.
 
''' ''imgurl'' ''' displays an image linking to an URL.
====Paramètres====
+
====Settings====
 
*text:  2 kind of data:
 
*text:  2 kind of data:
 
*# URL of the image, mandatory: clickable image;  
 
*# URL of the image, mandatory: clickable image;  
Line 50: Line 76:
 
===lua===
 
===lua===
 
''' ''lua'' ''' passes the ''text'' to the [[Ryzom Lua]] interpreter.
 
''' ''lua'' ''' passes the ''text'' to the [[Ryzom Lua]] interpreter.
====Paramètres====
+
====Settings====
 
*text: Lua script.
 
*text: Lua script.
 
*attribute: None.
 
*attribute: None.
Line 59: Line 85:
  
 
<small>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''.</small>
 
<small>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''.</small>
====Paramètres====
+
====Settings====
 
*'''text''': depends of the attribute.
 
*'''text''': depends of the attribute.
 
*'''attribute''':
 
*'''attribute''':
Line 76: Line 102:
 
''' ''timer'' ''' displays time in format "hh:mm:ss".  
 
''' ''timer'' ''' displays time in format "hh:mm:ss".  
 
*See also ''[[#date|date]]''.
 
*See also ''[[#date|date]]''.
====Paramètres====
+
====Settings====
 
*text: If empty or zero or "now()" gives the actual time in ''days_of_the_current_year'':''GMT_hour'':''minutes'':''seconds''.
 
*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''.
 
:otherwise, treats the value in the text as number of seconds, and display the equivalent "hour'':''minutes'':''seconds''.
Line 88: Line 114:
 
===url===
 
===url===
 
''' ''url'' ''' is the standard way to pass an URL. That URL visually  is formatted as usual in Ryzom.
 
''' ''url'' ''' is the standard way to pass an URL. That URL visually  is formatted as usual in Ryzom.
====Paramètres====
+
====Settings====
 
*'''text''' : URL or text to display
 
*'''text''' : URL or text to display
 
*'''attribute:'''
 
*'''attribute:'''
Line 108: Line 134:
 
*[scripturl]ryform_action=edit&ryform_name=stages%3A0[/scripturl] donne:
 
*[scripturl]ryform_action=edit&ryform_name=stages%3A0[/scripturl] donne:
 
:'''<nowiki>http://app.ryzom.com/app_arcc/index.php?action=script_Edit&script=2088</nowiki>'''<big>&</big>''ryform_action=edit&ryform_name=stages%3A0''
 
:'''<nowiki>http://app.ryzom.com/app_arcc/index.php?action=script_Edit&script=2088</nowiki>'''<big>&</big>''ryform_action=edit&ryform_name=stages%3A0''
===db===
 
====Paramètres====
 
*texte:
 
*#chargement d'une donnée: ''cellule ='' valeur
 
*#extraction d'une donnée enregistrée: ''cellule''
 
 
:cellule est défini par:  ''ligne'': ''colonne''
 
:# ''ligne'' = enregistrement dans la base (peut être nommé ou numéro d'ordre à partir de 0)
 
:# ''colonne'' ou "scope" = domaine d’application:
 
:##player
 
:##guild
 
:##arcc =>  0
 
:##civ
 
:##cult
 
:##org
 
:##race
 
*attribut: Nom  de la base.
 
 
====Exemples====
 
*[db=TestDB]0:0=100[/db] chargement d'une valeur (100) dans une DB.
 
*[db=TestDB]3:0[/db] RAZ dans une DB.
 
  
 
===img===
 
===img===

Revision as of 17:05, 25 October 2014

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


Flag-DE

Übersetzung , bitte.

Flag-EN

To check the quality of the text itself

Flag-ES

Traducción, por favor.

Flag-FR

À corriger par rapport à l'anglais

Flag-RU

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


User guide for RARC, short for Ryzom ARChitect.

For historical reasons, those manuals refers to A.R.C.C.

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:
  • # store a data in a cell
  • # read the contents in a cell
A cell is defined as: line: scope where:
  1. line is a specific kind of data.
  2. 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

hack

Empty function!


imgurl

imgurl displays an image linking to an URL.

Settings

  • text: 2 kind 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.
  • attribut: 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:

The_ARCC

lua

lua passes the text to the Ryzom Lua interpreter.

Settings

  • text: Lua script.
  • attribute: None.

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".

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 - незавершенное


scripturl

Paramètres

  • texte: ajoute une extension PHP à L’URL fournie dans l'attribut.
  • attribut: ne semble pas marcher (un seul caractère parsé). S'il est nul, remonte l'URL du script en cours.

Exemples

  • [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

img

Paramètres

  • texte: nul ou adresse_de_l_image nom_de_l_image
  • attribut: significatif si texte est nul
    • nom_de_l_image (utilisé aussi pour l'affichage de remplacement si est image absente. Éventuellement traduite automatiquement)

Exemples

  • [img]emotion_happy.png[/img]

div

Paramètres

  • texte: texte qui sera affiché dans une page HTML dans un bloc "div" HTML. C'est un container qui divise la page en une section contenant ses propres objet et styles.
  • attribut: array composé de trois éléments:
    • class
    • id
    • style

Exemples

  • [div]Un texte[/div]
  • [div=Classe|identiy|color:#f00;...???]txt[/div]

expr

  • affichage du calcul
  • affichage du résultat

map

Paramètres

  • texte:
  • attribut: significatif si texte est nul

Exemples

  • [map]18176,-29492[/map]

link

Paramètres

  • texte:
  • attribut: significatif si texte est nul

Exemples

http://app.ryzom.com/app_arcc/index.php?action=scripts_Main&event=211 (A.R.C.C. » TESTS » Bepock » UserGuide » NewEvent » Nouvel event )
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)
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

  • texte:
  • attribut: significatif si texte est nul

Exemples

trad

Paramètres

  • texte:
  • attribut: significatif si texte est nul

Exemples

t

Paramètres

  • text:
  • attribute: None.

Exemples

math

Paramètres

  • texte:
  • attribut: significatif si texte est nul

Exemples

@process randint(0, 100)

func

Paramètres

  • texte:
  • attribut: significatif si texte est nul

Exemples

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

Paramètres

  • text: is a "pseudo" array with "|" delimiters. It contains:
    • first field: 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

  • attribut:
    • Empty
    • "#"
    • <name>

Exemples

gender

Paramètres

  • texte:
  • attribut: significatif si texte est nul

Exemples

playerbackup

Paramètres

  • texte:
  • attribut: significatif si texte est nul

Exemples

playerstat

Paramètres

  • texte:
  • attribut: 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

  • texte:
  • attribut: significatif si texte est nul

Exemples

ifnot

Paramètres

  • texte:
  • attribut: 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

  • texte:
  • attribut: significatif si texte est nul

Exemples

Autre soutils de l'ARCC


Ryzom Wiki: Ryzom Commons | DE • EN • ESFRRU | Ryzom Forge