Hello World

Mon, 23 Mar 2009 23:20:13 +0100

'Hello World' Tutorial for TikiWiki? Developers

Introduction+
Glossary+
Who does what?+
Smarty/PHP+
The 'Hello World' page+
tiki-setup.php+
How to debug and to see the smarty variables+
To execute some queries in the php+
To introduce a new feature or a new preference+
To update the database schema+
To get/set a user preference+
To create a menu or to introduce a menu option+
Menu created by sql+
- Menu created with the TikiWiki ? API+
Menu created with a smarty template+
To introduce a new permission+
To check a permission+
To wiki parse a textarea+

+
+
+

Introduction

+
+
+

Glossary

+ Things are sometimes named a bit differently than in other Web Applications. Please see:
+ http://tikiwiki.org/Glossary
+
+

Who does what?

+ TikiWiki? CMS/Groupware is a vast project. It's tricky for new people to know how the TikiWiki? Community is organized, to find the right person to contact and to start to contribute. What may I expect from others within TikiWiki? Community, and what do others expect from me? Who does what? Who should I talk to? How does it work? This page is intended to help.
+
+ Important: everyone is a volunteer. Things get done because someone, like you decides to take the time to make it better.
+
+ Please see:
+ http://tikiwiki.org/WhoWhat
+
+

Smarty/PHP

+ TikiWiki? uses the Smarty template engine. Its purpose is to separate the presentation layer from the programming layer.
+ The PHP interfaces with the database, does the computation…and assigns the Smarty variables. The Smarty templates use these variables to generate the actual HTML.
+
+ For instance:
+

assign('user', $user);+ ?>

+ This PHP assigns the Smarty variable $user.
+ This variable will be used in a template like that
+

{$user}

+ This will display
+

admin

+
+ In a Smarty template, you can loop over array of data and do some simple computation. To preserve separation and optimization, no PHP code must be inserted in a template.
+
+

The 'Hello World' page

+ How to display "hello world" in the central column of a TikiWiki? page:
+
+ Create a php file in the TikiWiki? root directory (where tiki-install.php is).
+ hello_world.php:
+

assign('mid', 'hello_world.tpl');+ $smarty->display('tiki.tpl');+ ?>

+ Create a template located in the sub directory templates/ (http://www.domain.com/templates/) or in templates/styles/your_style/
+ hello_world.tpl:
+

Hello World

+
+ To test it, type the URL in your browser : http://my.domain.com/hello_world.php (where http://my.domain.com links to your TikiWiki? root).
+
+
+ Notice the use of include_once(‘tiki-setup.php’) in the php code. This include initializes the context to be able to use smarty. Later we will see it is doing more.
+ tiki.tpl is the TikiWiki? global template file. It is the only(almost) template that contains a complete html page. A simplified working tiki.tpl file would be:
+

{* top *}+ {include file="header.tpl"}+ {* middle *}+ +    +       +       +       +    +  {* left column *}+          {section name=ix loop=$left_modules}+             {$left_modules[ix].data}+          {/section}+        {* middle column *}+             {include file=$mid} +        {* right column *}+         {section name=ix loop=$right_modules}+               {$right_modules[ix].data}+         {/section}+       
+ {* bottom*}+ {include file="footer.tpl"}

+ You can see the top section header.tpl, the bottom section footer.tpl and the 3 columns. The left column displays all the left modules through a loop. Idem for the right column. The central part is an include of the $mid file. (Notice: in TikiWiki? 1.10, it is simply {$mid} and not missing page for plugin INCLUDE
)
+ In our hello_world example, the $mid part is the template hello_world.tpl and will display the string “hello world”.
+
+ The templates hello_world.tpl can be created in the sub-directory templates/ or the sub-directory templates/styles/your_style/ (where your_style is the name of the theme you are currently using (A theme name is the css file name without extension). If it exists, the template in your current theme directory overrides the one in the default directory. The avantage of putting your templates in your local theme directory is to better identify what you have changed from the original TikiWiki?. (Notice: if you are using CVS and are handy with cvs conflict resolution, it may be better to directly modify the templates in the default directory to be able to update/merge the tikwiki modification with yours)
+
+ The $left_modules and $right_modules smarty variables are set up in tiki-modules.php. You will see later in the module section how the modules are set.
+
+

tiki-setup.php

+
+ This include does everything you need to have a TikiWiki? page. It does a lot more that initializing smarty. By including this file in your php, you:
+

establish the connection with the database.+
read all the system preferences, user preferences, permissions from the database.+
check if the user is logged via a cookie.+
computes all the modules (in TikiWiki1?.9). In TikiWiki? 1.10 this is done in $smarty->display+
check up for some security points+
…+

+
+ A couple of interesting variables are also set there
+

user (user login)+
group (default group name)+
language+
all preferences+
….+

+ All these variables are set for php and for smarty.
+
+ To see your username in the hello world program, modify your template:
+

Hello World, Dear {$user}

+
+

How to debug and to see the smarty variables

+ If you want to see all the smarty variables that are set, you can use the smarty function {debug} in your templates. Smarty will display a popup window.
+

{debug}+ Hello World

+
+
+ You can also use the php function echo or print_r to see some php variable for debugging.
+ And you can use the function debug_backtrace to see the php trace.
+

";+    print_r(debug_backtrace());+    echo "

";+ }+ include_once('tiki-setup.php');+ echo "

user:$user

";+ test();+ $smarty->assign('mid', 'hello_world.tpl');+ $smarty->display('tiki.tpl');
+
+

To execute some queries in the php

+ TikiWiki? uses the ADODB database abstraction library. A good description about how to code the queries can be found at http://TikiWiki.org/tiki-index.php?page=DbAbstractionDev
+
+ A typical list routine without permission check.
+ In lib/contribution/contributionlib.php
+

// List a subset of contribution+ // $offset = will return the objects from there to $offset + $maxRecords (if 0 = from the beginning)	+ // $maxRecords = max number to return if = -1 returns all the objects+ // $sort_mode = order criterium+ // $find = string to search+ function list_contributions($offset=0, $maxRecords=-1, $sort_mode='name_asc', $find='') {+ 	$bindvars = array();+ 	$mid = '';+ 	if ($find) {+ 		$mid .= " where (`name` like ?)";+ 		$bindvars[] = "%$find%";+ 	} + 	$query = "select * from `tiki_contributions` $mid order by ".$this->convert_sortmode($sort_mode);+ 	$result = $this->query($query, $bindvars, $maxRecords, $offset);+ + 	$ret = array();+ 	while ($res = $result->fetchRow()) {+ 		$ret[] = $res;+ 	}+ 	$retval = array();+ 	$retval['data'] = $ret;+ 	if ($maxRecords > 0) {+ 		$query_cant = "select count(*) from `tiki_contributions` $mid";+ 		$retval['cant'] = $this->getOne($query_cant, $bindvars);+ 	} else {+ 		$retval['cant'] = count($ret);+ 	}+ 	return $retval;		+ }

+ First, you have to notice that all table names and column names must be back quoted.
+ The $sort_mode is the concatenation of the column name, the underscore and asc or desc. It can be any column.
+
+ In the main php, tiki-contribution.php, you will have
+

include_once('lib/contribution/contributionlib.php');+ $contributions = $contributionlib->list_contributions();+ $smarty->assign('contributions', $contributions['data']);

+
+ and in the template templates/tiki-contribution.tpl, you will have
+

{cycle values="even,odd" print=false}+ {section name=ix loop=$contributions}+ + 	{$contributions["ix"].name|escape}+ 	{$contributions["ix"].hits}+ + {/section}

+
+ Notice: There is not yet good method to check the perms in this kind of routine. You have to get all the objects and checked them.
+
+

To introduce a new feature or a new preference

+ In 2.0 lib/setup/prefs.php has been introduced. Add your preference to this file, no database hacking is necessary. For pre-2.0 times and other (fundamental) DB changes the procedure below is still valid.
+
+ For instance, you want to create a new feature called contribution
+ First you have to create an entry in the database
+

INSERT IGNORE INTO tiki_preferences(name,value) VALUES ('feature_contribution', 'n');

+ Each database update must be done in db/tiki.sql and db/tiki_1.xto1_y.sql. The first sql does the complete database creation, the second is the upgrade script. The second one can be rerun as many times as needed ((with the mysqldump option –f to ignore error).. The update of each script for each database supported by TikiWiki? is done by the script db/convertscripts/convertsqls.sh (Available in 1.10). So each time you have to update the database scheme, you have to modify 2 files and run a script.
+ The script can be run by
+

cd db/convertscripts+ ./convertsqls.sh

+ virtualhost/root can be localhost/tiki1.9 for instance
+
+ After you have to insert the check box into the features administration page.
+ In templates/tiki-admin-include-features.tpl, you have to insert these lines :
+ In TikiWiki1?.10
+

+    + +    +    + {if $prefs.feature_help eq 'y'}{/if}+ {tr}Contribution{/tr}+ {if $prefs.feature_help eq 'y'}{/if}+    +     +

+ In TikiWiki1?.9
+

+    + +    +    + {if $feature_help eq 'y'}{/if}+ {tr}Contribution{/tr}+ {if $feature_help eq 'y'}{/if}+    +     +

+ just before these lines if you want it in the first table.
+
+
+

+ {* ---------- Administration features ------------ *}

+
+ In tiki-admin_include_features.php, you have to insert the line "feature_contribution",
+ in the $features_toggles table definition
+

$features_toggles = array(+ "feature_contribution",+ ….+ );+ foreach ($features_toggles as $toggle) {+  	simple_set_toggle ($toggle);+  }

+ The loop on features_toggles will to the wanted step:
+ - update the database
+ - update the smarty variable and the php variable
+ Notice: Not all the admin pages are using simple_set_toggle ($toggle);even if it is the best practice.
+
+ You have nothing else to do, tiki-setup.php will automatically read and assign the php variable and the smarty variable $prefs in TikiWiki? 1.10 (so you can use $prefs.feature_contribution) or $feature_contribution in TikiWiki1?.9 in any TikiWiki? page.
+
+ Feature and preference are set the same way.
+
+ You can have the list of features/preferences in the sql table tiki_preferences.
+ Notice: all the preferences are not necessarily there. Some old preferences have not been set in this table and are test through isset($this_preference).This is bad habit: it is better to always include your preference as described previously in the database and not to test if it is set with the isset function
+

INSERT IGNORE INTO tiki_preferences(name,value) VALUES ('my_preference', 'my_value');

+
+

To update the database schema

+ DatabaseSchemaUpgrade?
+

To get/set a user preference

+ To get the value of a user preference, you can use in a function :
+

global $tikilib, $someuser;+ $foo = $tikilib->get_user_preference($someuser, $pref_name, $default_pref_value);

+ $someuser is the user name.
+ $pref_name can be ‘theme’, ‘allowMsgs’…
+ The default for $default_pref_value is ‘’
+ The effect of the above code is to populate the global array variable $user_preferencessomeuser, which is also returned in the variable foo.
+ Notice: “global $tikilib, $someuser;” is not necessary if you add these lines in the same file that the include tiki-setup.php (the hello_world.php) but are needed in you add these lines in a function.
+ Notice: To access the prefs of the current user (user), it is not necessary to use the above. These are always available as variables. In version 1.10, they are available in the $prefs array.
+
+ To set a user preference
+

global $tikilib, $someuser;+ $tikilib->set_user_preference($someuser, $pref_name, $pref_value);

+
+ Notice: we don’t include lib/tikilib.php because it is always included in tiki-setup.php. Meanwhile, the other libraries must be included like this:
+

global $categlib; include_once('lib/categories/categlib.php');

+ Notice the use of global. Global is necessary because your library can have been included in another function that is out of scope of your new function.
+
+ You can have a list of user preferences in the sql table tiki_user_preferences. Same remark than for tiki_preferences, the list can be incomplete.
+
+

To create a menu or to introduce a menu option

+ TikiWiki? has a couple of ways to introduce menus
+ - one by creating the menu and the menu options through sql (1)
+ - one by using the tiki API (2)
+ - one by using the templating / module feature (3)
+ - one based on phplayers (4)
+
+ There is not really a best method to create a menu. It depends. If your menu can be dynamically updated, you will not use the template. If your menu is fixed, perhaps a template is the best.
+ The phplayers method is not described here as there is no current API. (phplayers menu are interesting because they can have more than 2 levels (Means an option in an option in a section)
+

Menu created by sql

INSERT INTO tiki_menus (menuId,name,description,type) VALUES ('100', ‘My menu','My very own  menu','d');+ INSERT INTO tiki_menu_options (menuId,type,name,url,position,section,perm,groupname) VALUES (‘100’,'o','My option','tiki-my_option.php',10,'','','');+ INSERT INTO tiki_menu_options (menuId,type,name,url,position,section,perm,groupname) VALUES (‘100’,'o','My other option','tiki-my_other_option.php',15,'','','');

+ A menu affects 2 tables. One for the menu by itself, and the other one for the menu options. In the previous example, we created a menu ‘My menu’ with 2 options.
+ A menu type can be
+ - d (dynamic collapsed)
+ - e (dynamic extended)
+ - f (fixed)
+ an option type can be:
+ - s (section)
+ - r (sorted section)
+ - o (option)
+ - - (separator)
+
+ The section parameter corresponds the feature. If the feature is not activated, the option will not show up.
+ The groupname parameter is a filter on the group.
+
+ Notice: the menuId 42 is reserved for the application menu (the default TikiWiki? menu).
+ Trick: we usually don’t give consecutive number to menu options to be able later to add additional options easier.
+ If an option can be see with 2 perms, you need to add 2 options with the same position and different perm. Idem if it can be see in 2 sections or 2 groups.
+ Some documentation can be found at http://doc.TikiWiki.org/tiki-index.php?page=Custom+Menus.
+ Notice: there is some bugs about the expand/collapse javascript in tw1.9.2.
+
+ To insert this menu in a column, you need to create a user menu that uses it (admin->modules->create a new user menu) and then assign this user menu (admin->modules->assign new module)
+
+

Menu created with the TikiWiki? API

global $menulib; include_once(‘lib/menubuilder/menulib.php’);+ $menulib->replace_menu($menuId, $name, $description, $type);+ foreach (… optionmenu…) {+ $menulib->replace_menu_option($menuId, $optionId, $name, $url, $type, $position, $section, $perm, $groupname);+ }

+ The parameter values are the same than described previously.
+ Notice: you can notice the use of global $menulib. This is very useful when you use this part of code in a function. The include can have been done somewhere else, and the global gives you the opportunity to catch the variable $menulib.
+
+ If you don’t know the $menuId you want to use, you need to
+

$menulib->replace_menu(0, $name, $description, $type);+ $query = 'select max(`menuId`) from `tiki_menus`';+ $menuId = $tikilib->getOne($query);+ foreach (… optionmenu…) {+    $menulib->replace_menu_option($menuId, $optionId, $name, $url, $type, $position, $section, $perm, $groupname);+ }

+
+ Next, you have to create a user menu and assign it
+

global $modlib; include_once ('lib/modules/modlib.php');+ $modlib->replace_user_module($name, $title, "{menu id=$menuId}");+ $modlib->assign_module($name, $title, $position, $order, 0, $rows , serialize($groups), $params, $type);

+ $position is ‘l’ (left column) or ‘r’ (right column)
+ If you assign 2 modules with the same order in the same column, they will appear both in a random order.
+ $groups is an array of groups (ex: array("Registered", "Anonymous"))
+ $params is the value you put in the param field in admin->modules->assign module. (ex: “max=10”)
+ $type is ‘D’ to assign to everybody.
+

Menu created with a smarty template

+ You can also create a menu with a template module. A good example is templates/modules/mod-application_menu.tpl. This menu is the old tikwiki menu that has been replaced by a database menu to be able to use the mods.
+
+ You only need to create a new template in templates/modules/ with a filename beginning with mod-. This new module will automatically appear in the admin->modules scrolling list.
+
+

To introduce a new permission

+ If you want to create a new permission, you need to add it in the database like this:
+

INSERT INTO users_permissions (permName, permDesc, level, type) +     VALUES ('tiki_p_whatever', 'Perm definition', 'level', 'feature');

+ This must be added in db/tiki.sql and db/tiki_1.xto1.y.sql.
+ Where level can be editors, registered, admin … and feature is the group of perms (wiki, cms, blog..)
+ You can create a new group of perms there. There is no other requirement for a group of perms.
+ The perm will be read and set to a php variable and a smarty variable in tiki-setup.php
+
+ In a php, the perm is used like this:
+

if ($tiki_p_whatever == 'y')

+ Don’t forget to compare to a value a current error is to write only
+

if ($tiki_p_whatever)//wrong code

+ We usually name a perm with a name beginning by tiki_p_
+
+

To check a permission

+ All permissions can be overwritten at a category or object level. The rule to check if you have the tiki_p_perm on an object is:
+ - check if the object has special perm. If yes, test if one of the group user has the perm tiki_p_perm otherwise returns false.
+ - check if the object has a category with special perm. If yes, test if one of the group user has the perm tiki_p_perm otherwise returns false.
+ - if none above, use the tiki_p_perm value
+
+ A function is dedicated to do the job
+

include_once('tiki-setup.php');+ include_once('lib/tikilib.php');+ $perm = $tikilib->user_has_perm_on_object($user, $object_id, $object_type, $tiki_p_perm);

+ where user is the login name, $object_id is the object id (can be the page name or the article_id or …), $object_type is the object type (can be ‘wiki page’, ‘article’….). You can use an array of perms instead of tiki_p_perm if needed.
+
+ Example
+

if (!$tikilib->user_has_perm_on_object($user, $pageName, 'wiki_page', 'tiki_p_view') {+ 	$smarty->assign('msg', tra('Permission denied you cannot read this page'));+ 	$smarty->display('error.tpl');+ 	die;+ }

+
+ Example
+

if (!$tikilib->user_has_perm_on_object($user, $quiz_id, 'quiz', array('tiki_p_take_quiz','tiki_p_view_quiz_stats')){+ 	$smarty->assign('msg', tra('Permission denied you cannot access this quiz'));+ 	$smarty->display('error.tpl');+ 	die;+ }

+
+ Notice: This function is very convenient but it is quite a bit slow even if there are a couple of cache to optimize it. There is only one example in the TikiWiki? code that integrates the perm checking in the sql query.
+
+ To reassign all the permissions a user has on an object
+ There is actually no integrated function to do the job. This snippet reassigns the perm variables.
+

global $userlib; include_once('lib/userslib.php');+ + global $feature_categories;+ if ($userlib->object_has_one_permission($objectId, $objectType)) {+ 	$perms = $userlib->get_permissions(0, -1, 'permName_desc', '', $objectType);+ 	foreach ($perms['data'] as $perm) {+ 		$permName = $perm["permName"];+ 		if ($userlib->object_has_permission($user, $objectId, $objectType, $permName)) {+ 			$permName = 'y';+ 		} else {+ 			$permName = 'n';+ 		}+ 	}+ } elseif ($feature_categories == ‘y’) {+ 	global $categlib; include_once('lib/categories/categlib.php');+ $perms_array = $categlib->get_object_categories_perms($user, $objectType, $objectId); +    	if ($perms_array) {+     		foreach ($perms_array as $permName => $value) {+     			$permName = $value;+ 		}+     	}+   }

+ $objectId is the object identifier: Ex: the page name for a wiki page, the article_id for an article.
+ $ObjectType is one of ‘wiki page’, ‘article’, ‘forum’, ‘post’, ‘blog’, ‘faq’, ‘image gallery’, ‘file gallery’, ‘comment’, ‘tracker’, ‘survey’, ‘quiz’ …
+
+

To wiki parse a textarea

+ Imagine you have a textarea and you want this textarea to accept wiki format.
+ To parse the textarea, you will have to call
+

$tikilib->parse_data($text)+ Usually if you have a choice like “it is html”, you need to add an additional parameter+ $tikilib->parse($test, $is_html)

+ PS: some tikwiki1.9 have bugs around the is_html parameter. There are patched by replacing $test with htmlspecialchars($test);
+
+ If you want to add some quicktags to the textarea
+

include_once ('lib/quicktags/quicktagslib.php');+ $quicktags = $quicktagslib->list_quicktags(0,-1,'taglabel_desc','','wiki');+ $smarty->assign_by_ref('quicktags', $quicktags["data"]);+ $smarty->assign('quicktagscant', $quicktags["cant"]);

+
+ In the templates in order to use the quicktags, you have to add in the template where you want the quicktags to appear:
+

{include file="tiki-edit_help_tool.tpl"}

+
+ PS: only one quicktag zone per page is allowed
+
+ If you want to add the resize buttoms, you have to add in the php:
+

include_once("textareasize.php");

+
+ And in your tpl, you have to add something like this:
+

+ {include file="textareasize.tpl" area_name='editwiki' formId='editpageform'}+ {$pagedata|escape}</pre><br />
</article>
<article>
<h1>Missing tiki3.0</h1>
<p>Tue, 27 Jan 2009 13:23:22 +0100</p>
<style TYPE="text/css"> .diffchar { color:red; } </style>+ - extraparams do not open a line for extra param in plugin editor<br />+ - feature not to display edit plugin<br />
</article>
<article>
<h1>New in 3.0</h1>
<p>Mon, 01 Dec 2008 17:10:52 +0100</p>
<style TYPE="text/css"> .diffchar { color:red; } </style>- </li><li> imp<span class="diffchar">o</span>rvment in webmail+ </li><li> impr<span class="diffchar">o</span>vment in webmail- </li><li> <b>webservice<span class="diffchar">s</span></b>+ </li><li> <b>webservice</b<span class="diffchar">> <a class="wiki external" target="_blank" href="http://dev.tikiwiki.org/tiki-index.php?page=WebservicePlugin" rel="external">http://dev.tikiwiki.org/tiki-index.php?page=WebservicePlugin</a</span>>- </li><li> plugin ftp+ </li><li> plugin ftp<span class="diffchar"><a class="wiki external" target="_blank" href="http://doc.tikiwiki.org/PluginFtp" rel="external">http://doc.tikiwiki.org/PluginFtp</a></span>+ </li><li> special little css overloading (ex: styles/my_styles+ </li></ul>+ /css/calendar.css)<br />+ <ul><li> tracker description parseable- <br />+ <ul><li> page selector field type+ </li><li> semantic links <a class="wiki external" target="_blank" href="http://doc.tikiwiki.org/Semantic+Admin" rel="external">http://doc.tikiwiki.org/Semantic+Admin</a>+ </li></ul>
</article>
<article>
<h1>what is a wiki?</h1>
<p>Tue, 08 Jul 2008 20:17:33 +0100</p>
<style TYPE="text/css"> .diffchar { color:red; } </style>+ <param name="movie" value="http://www.youtube.com/v/-dnL00TdmLY&rel=1" /><param name="quality" value="high" /><param name="wmode" value="transparent" /></object><br />
</article>
<article>
<h1>proto</h1>
<p>Mon, 17 Mar 2008 12:42:39 +0100</p>
<style TYPE="text/css"> .diffchar { color:red; } </style>+ <br />+ <br />+ <br />+ <br />+ <br />+ <br />
</article>
<article>
<h1>security</h1>
<p>Wed, 05 Dec 2007 22:08:34 +0100</p>
<style TYPE="text/css"> .diffchar { color:red; } </style>+ <br />+ /tiki-export_pdf_reader.php?file=../../../../../../etc/passwd<br />
</article>
<article>
<h1>Etat des lieux de la recherche avec tikiwiki</h1>
<p>Thu, 08 Jun 2006 17:13:01 +0100</p>
<style TYPE="text/css"> .diffchar { color:red; } </style>+ (verifier que ce n' est que sur les fichiers de gqleries et pqs sur ficheirs attaches à une page wiki)<br />
</article>
<article>
<h1>session life time</h1>
<p>Mon, 01 May 2006 11:06:10 +0100</p>
<style TYPE="text/css"> .diffchar { color:red; } </style>+ <br />+ <b>session.gc_maxlifetime</b><br />+ in secongs in php.ini<br />
</article>
<article>
<h1>Checkpoint</h1>
<p>Sat, 26 Nov 2005 16:28:19 +0100</p>
<style TYPE="text/css"> .diffchar { color:red; } </style>+ <ul><li> memory limit (16M at least) . <a class="wiki external" target="_blank" href="hhttp://tikiwiki.org/art82" rel="external">more</a>+ </li><li> restart the server if you change the limit+ </li><li> browser accept cookies+ </li><li> Php session.save_path must be rewritable by apache+ </li></ul>
</article>
</main></body></html>

Tiki RSS feed for the wiki pages

HomePage

Hello World

Table of contents

Introduction

Glossary

Who does what?

Smarty/PHP

{$user}

admin

The 'Hello World' page

tiki-setup.php

How to debug and to see the smarty variables

To execute some queries in the php

To introduce a new feature or a new preference

To update the database schema

To get/set a user preference

To create a menu or to introduce a menu option

Menu created by sql

Menu created with the TikiWiki? API

Menu created with a smarty template

To introduce a new permission

To check a permission

To wiki parse a textarea