From Ryzom Forge Wiki
(→Exemples) |
|||
Line 92: | Line 92: | ||
====Exemples==== | ====Exemples==== | ||
Launched from script 2088: | Launched from script 2088: | ||
− | + | :[scripturl]ryform_action=edit&ryform_name=stages%3A0[/scripturl] donne: | |
− | : | + | :<nowiki>http://app.ryzom.com/app_arcc/index.php?action=script_Edit&script=</nowiki>'''2088'''<big>&</big>''ryform_action=edit&ryform_name=stages%3A0'' |
<hr/> | <hr/> | ||
+ | |||
===session=== | ===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. | ''' ''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. |
Revision as of 15:16, 5 November 2014
WIP
in Arbeit -
work in progress -
trabajo en curso -
travaux en cours -
незавершенное
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.
Contents
- 1 Ryzom specific BBCODE
- 1.1 date
- 1.2 db
- 1.3 hack
- 1.4 imgurl
- 1.5 lua
- 1.6 scripturl
- 1.7 session
- 1.8 timer
- 1.9 url
- 1.10 img
- 1.11 div
- 1.12 expr
- 1.13 map
- 1.14 link
- 1.15 validate
- 1.16 trad
- 1.17 t
- 1.18 math
- 1.19 func
- 1.20 itemicon
- 1.21 param
- 1.22 data
- 1.23 get
- 1.24 post
- 1.25 playerinfos
- 1.26 gender
- 1.27 playerbackup
- 1.28 playerstat
- 1.29 scriptinfos
- 1.30 if
- 1.31 ifnot
- 2 HTML
- 3 Autre soutils de l'ARCC
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:
- 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
hack
Empty function!
imgurl
imgurl displays an image linking to an URL.
Settings
- text: 2 kind of data:
- URL of the image, mandatory: clickable image;
- 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:
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 -
незавершенное
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][/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 )
- [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
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
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
- 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