History: Wiki Handler
Preview of version: 32
Wiki Page Handler
Profile installer in Tiki would not be very useful without wiki pages, thus, a handler was created. To create a wiki page, the page content must exist in the profile repository. The page name is provided in the profile to reference to it.
YAML
Copy to clipboard
preferences: enable: [ feature_wiki ] objects: -
Wiki Object Parameters
Field name | Mandatory | Value |
type | yes | must be "wiki_page" |
ref | can link to a category or structure. see Object References. | |
name | yes | The name of the page to be created. Can be different from local pagename. |
description | The page description. | |
lang | Page language as the two letter code (ex: fr, en, es) | |
content | yes | Initial page content. To simplify the profile, large pages can be included from a remote location in the same profile repository. This is done by using the wikicontent: prefix, as seen in the example. |
mode | create, update, append, create_or_append, create_or_update (default). Handler mode that determines behavior on existing page. create will prevent installation if page already exists. update and append require the page to exist prior to profile installation. | |
translations | List of page names (or page references) to be attached as translations. | |
message | Specify the version message. Will default to modification made by profile installer. (>=4.0) |
Details
minimally, to import a wiki page the following YAML syntax will suffice.Copy to clipboard
objects: - type: wiki_page data: name: todo content: wikicontent:todo
- mind your spaces here each level of indentation is two spaces. (recommended). type and data are at the third level, name and content in the fourth.
- Re-import is ok (>=tikiwiki3.0) you can load a profile multiple times in the same wiki. It will ask if you want to Forget the install - this will not remove data imported. When you re-install a profile anything new will be added. In wiki pages, it's possible to replace & append (see above options)
Alternatively, wikidirect: can be used instead of wikicontent:. When used, the content of the target page will not be parsed for references, which is useful when setting up data channels.
As of Tiki 6 onwards, wikiparsed: can be used to to get the parsed (HTML) output from a page, instead of the wiki mark-up. Used with tracker filter plugins and pretty tracker templates this can make tracker data available to be used in data channels.
List of Profiles with Wiki Handler
Help_Pages
Contact_Form
Profile_Repository_Profile_3x
Example_Wiki_Profile