The TopicCreator can operate in two modes:
In this mode you simply enter a free-form TopicTitle and optionally select a template available in the current web to create a new topic.
Once a TopicType is deployed to a web will the dialog switch over to TopicType mode.
In the first example there are 5 TopicTypes deployed to the Sandbox web "Category", "Classified Topic", "Controlled Topic", "Tagged Topic" and "Workflow Definition" that you can choose from in a first step creating a new topic. Note further that there is a selection "Default" to create wiki content in Standard mode.
Once you selected the type of content to be created there is an optional second step to select the TopicTemplate available in the current web tailored towards the selected TopicType. This step will be skipped automatically if there are no templates available for the selected TopicType. Of course you may skip this step manually yourself if you like to do so.
In above example "Classified Topic" has been selected in the first step. Now there are 3 additional TopicTemplates available for this TopicType: "ArticleTemplate", "Bookmark" and "SprintBoardTemplate" which will be used to seed the content area of the topic about to be created. Note that the actual choices available in each step heavily depends on the data of your wiki. You don't necessarily have these templates available on your system.
Depending on the actual implementation of the TopicType will the final step offer a form to specify the initial properties of the topic. Most importantly will it ask for a TopicTitle and derive a WikiWord from it.
NEWLINKFORMAT
preference settings that are best customized in your SitePreferences.
* Set NEWLINKFORMAT = <a class='foswikiNewLink jqUIDialogLink' href='%SCRIPTURLPATH{"rest"}%/RenderPlugin/template?name=newtopic;expand=dialog;topic=$web.$topic;render=on;topictitle=%ENCODE{"$text"}%'>$text</a>Above settings will pop up the TopicCreator dialog whenever clicking on an unknown WikiWord (given that auto-linking is enabled as well and not disabled using the
NOAUTOLINK
setting).
There are a couple of preference settings that let you control which TopicTypes and TopicTemplates are available in the TopicCreator dialog, besides the actual settings of the TopicType itself.
Preference | Description | Default |
---|---|---|
TopicType step: | ||
TOPICCREATOR_SHOW_DEFAULT_TYPE |
boolean switch to show/hide the "Default" choice to create topics in Standard mode | on |
TOPICCREATOR_SELECT_TYPE |
name of the TopicType initially selected | Default |
TOPICCREATOR_INCLUDE_TYPE |
regular expression that TopicTypes must match to be listed | |
TOPICCREATOR_EXCLUDE_TYPE |
regular expression to exclude TopicTypes from the list | |
TopicTemplate step: | ||
TOPICCREATOR_SHOW_DEFAULT_TEMPLATE |
boolean switch to show/hide the "Default" template of a TopicType | on |
TOPICCREATOR_SELECT_TEMPLATE |
name of the TopicTempalte initially selected; this is the TopicTemplate as configured in the TopicType itself | Default |
TOPICCREATOR_INCLUDE_TEMPLATE |
regular expression that TopicTemplates must match to be listed | |
TOPICCREATOR_EXCLUDE_TEMPLATE |
regular expression to exclude TopicTemplates from the list | |
Standard mode: | ||
TOPICCREATOR_DEFAULT_INCLUDE_TEMPLATE |
regular expression that templates must match to be included in the list of templates | |
TOPICCREATOR_DEFAULT_EXCLUDE_TEMPLATE |
regular expression to exclude templates from the list |
For instance in above screenshot "TopicType Mode, example 2", the default type was disabled and the "ClassifiedTopic" was selected by default using below settings:
* Set TOPICCREATOR_SHOW_DEFAULT_TYPE = off * Set TOPICCREATOR_SELECT_TYPE = ClassifiedTopic
I | Attachment | Action | Size | Date | Who | Comment |
---|---|---|---|---|---|---|
png | create_step.png | manage | 33 K | 03 May 2018 - 13:00 | UnknownUser | |
png | create_step_2.png | manage | 43 K | 03 May 2018 - 13:02 | UnknownUser | |
png | standard_mode.png | manage | 27 K | 03 May 2018 - 12:35 | UnknownUser | |
png | topictemplate_step.png | manage | 47 K | 03 May 2018 - 12:52 | UnknownUser | |
png | topictype_mode.png | manage | 57 K | 03 May 2018 - 12:43 | UnknownUser | |
png | topictype_mode_2.png | manage | 73 K | 03 May 2018 - 12:43 | UnknownUser |