Loading...
 

History: User Input

View page Collapse Into Edit Sessions

Preview of version: 7

Although a profile sets most things by default, it is sometimes useful to be able to ask the user some simple questions, as the profile is built for them. For example:
  • A blogger will want to set the name of the blog
  • A webmaster will want to change the contact information.

Profiles can contain any number of "user requests", these are questions that request a value. If they are not provided, a default value is used. The syntax to do so is:

$profilerequest:Label name of the value requested$Default value$


By default, the value will be filtered through XSS filters. You can specify a filter using the alternate syntax:

$profilerequest:Label name of the value requested|Filter Name$Default value$


Empty values after filtering will revert to the default value.

If you don't want the result to be used inadvertently in other profiles make sure the label name is unique. The Label name and its value will be used for all the profiles installed at one time. This would be the case if the chosen profile has dependencies.

Example


YAML
preferences:
 feature_blogs: y
objects:
 -
  type: blog
  ref: personal
  data:
   title: $profilerequest:Blog Title$My Personal Blog$
   description: Random daily thoughts and travel stories
   user: $profilerequest:Blog Owner$admin$
   use_title: y
   allow_comments: y
 -
  type: blog_post
  data:
   blog: $personal
   title: Sample Post
   content: This post was created by the installation profile.


Example with a datachannel

You want to create a wiki page but asking interactively the name of the page via a data channel
  • Create a data channel named test on your local using the profile DataChannel 
test, tiki://local, DataChannelTest, Admins

  • Create the profile of the data channel in the page DataChannelTest 
{CODE(caption=>YAML)}
objects:
 -
  type: wiki_page
  data:
   name: $profilerequest:page_name$My Personal Page$
   content: xxxxx
{CODE}

  • Create a page to create to test your data channel 
{DATACHANNEL(channel=test)}
page_name,Give a Page Name
{DATACHANNEL}

  • the result
Image


History

Advanced
Information Version
Sat 28 of Aug, 2010 16:21 GMT-0000 luciash d' being 🧙 highlight that label name must be unique 9
Tue 09 of Feb, 2010 19:06 GMT-0000 sylvie 8
Tue 09 of Feb, 2010 19:05 GMT-0000 sylvie 7
Tue 09 of Feb, 2010 19:01 GMT-0000 sylvie 6
Mon 19 of Jan, 2009 21:41 GMT-0000 System Administrator 5
Mon 19 of Jan, 2009 21:40 GMT-0000 System Administrator 4
Thu 25 of Sep, 2008 00:33 GMT-0000 System Administrator 3
Thu 18 of Sep, 2008 16:32 GMT-0000 matwho changed it around a bit 2
Thu 18 of Sep, 2008 16:14 GMT-0000 System Administrator 1