Loading...
 

Plugin PrefDoc

This wiki plugin generates and displays preference documentation for use on doc.tiki.org website.

  • This will automatically record and keep past preference versions.
  • It automatically re-caches the current tiki preferences every time the version number increases (like from 17.0 to 17.1)
  • You may force a re-cache by emptying all caches (will only re-load current version)
  • If description, hint or help (link) are added to a new version of tiki, it populates past versions that are missing that information
  • Images specified for past version of tiki be used for up to 5 newer versions if no other images exist
  • Preference data is stored as it is in tiki to allow for maximum expansion in the future with backwards compatibility (like if color coding for basic-advanced-experimental was to be implemented etc.)
  • Plugin visual appearance is independent from storage, allowing for dramatic future style changes.
  • If an invalid, or non-existent tab-name is given, a list of available options will be presented.


Table of contents

Parameters

Introduced in Tiki 17.
Go to the source code
Preferences required: wikiplugin_prefdoc

Parameters Accepted Values Description Default Since
img text Show images at the top of each version of Tiki. Format: TikiVersion:FileGalleryID. Multiple images my be separated like so: TikiVersion1:FileGalleryID1|TikiVersion2:FileGalleryID2. 17
tab text The name of the preference tab to display, or a list of available tabs upon invalid. 17

Example

Generate list of available preferences to display

This code:

{PREFDOC()/}



Display Look and Feel: General Layout, with images

There are 2 images specified. Tiki 17 image has a file gallery id of 33 and the Tiki 14 image has a file gallery id of 12.
This code:

{PREFDOC(tab="look-generallayout" img="17:33|14:12")/}


File is not an image.
Option Description Default
Site logo and title Display a site logo image and/or title in the page header area.
This setting is expected to be moved from here to the admin-modules page.
Enabled
Logo source (image path) This can be a conventional path to the image file, or the syntax to display an image in a Tiki gallery. img/tiki/Tiki_WCG.png
Site icon This is used in narrow (top to bottom) page headers. In some layouts, the image is scaled down to fit in the available space.
Recommended image height: 32 pixel
img/tiki/tikilogo_icon.png
Logo background color A legacy option to add a background color to the div that contains the logo image.
Examples: 1) silver - 2) #fff
Transparent
Logo title (on mouseover) This appears as tool tip text. The site logo is also a link to the site index (top page). Tiki powered site
HTML "alt" tag description Normally a description of the image, such as \"Example.com logo\".
Used by text browsers, screen readers, etc.
Site Logo
Site title The displayed title of the website. None
Subtitle A short phrase that, for example, describes the site. None
Top module zone Visibility of horizontal zone for modules such as site logo, log-in form, etc. (page header)
Only if one or more modules are assigned | Always | Never
Only if one or more modules...
Topbar module zone Visibility of horizontal zone for modules such as menu (navbar), search form, full-width content, etc.
Only if one or more modules are assigned | Always | Never
Only if one or more modules...
Page top module zone Visibility of horizontal zone above main page area for modules such as breadcrumbs, banners, share icons, etc
Only if one or more modules are assigned | Always | Never
Only if one or more modules...
Left column Controls visibility of the left column of modules
Only if one or more modules are assigned | Always | User decides | Never
Only if one or more modules...
Right column Controls visibility of the right column of modules
Only if one or more modules are assigned | Always | User decides | Never
Only if one or more modules...
Page bottom module zone Visibility of horizontal zone below the main page area for modules such as banners or other information
Only if one or more modules are assigned | Always | Never
Only if one or more modules...
Bottom module zone Visibility of horizontal zone for modules such as "powered by" and "rss list" (page footer)
Only if one or more modules are assigned | Always | Never
Only if one or more modules...
Module file Use a static module definition file instead of relying on the dynamic values generated by Tiki. Useful for custom themes. The file must be in YAML format, following the format used in profiles. None
Extra module zones available Extra module zones to be managed through the module administration interface. Useful if a custom theme or layout requires a special zone other than the predefined ones.
Comma-separated list, maximum of 20 characters per entry.
None
Webmaster report Activate the feature to report a problematic page to the webmaster.. Disabled
Webmaster email A specific email address can be set for receiving the webmaster reports.
Leave blank to use the default sender email
None
Email this page This enables users to share a page with others, by emailing a short message and link to the page.
Adds a link at the bottom if set, otherwise adds a link at the top
Disabled
File is not an image.
Option Description Default
Site logo and title Display a site logo image and/or title in the page header area.
This setting is expected to be moved from here to the admin-modules page.
Enabled
Logo source (image path) This can be a conventional path to the image file, or the syntax for an image in a Tiki gallery. img/tiki/Tiki_WCG.png
Site icon This is to be used in narrow (top to bottom) page headers. In some layouts, the site logo is scaled down to fit.
Recommended image height: 32 pixel
img/tiki/tikilogo_icon.png
Logo background color A legacy option to add a background color to the div that contains the logo image.
Examples: 1) silver - 2) #fff
Transparent
Logo title (on mouseover) This appears as tool tip text. The site logo is also a link to the site index (top page). Tiki powered site
HTML “alt” tag description Normally a description of the image, such as “Example.com logo”.
Used by text browsers, screen readers, etc.
Site Logo
Site title The displayed title of the website. None
Subtitle A short descriptive phrase. None
Left column Controls visibility of the left column of modules
Only if one or more modules are assigned | Always | User decides | Never
Only if one or more modules...
Right column Controls visibility of the right column of modules
Only if one or more modules are assigned | Always | User decides | Never
Only if one or more modules...
Top module zone Activate zone for modules such as site logo, log-in form, etc. (page header)
Only if one or more modules are assigned | Always | Never
Only if one or more modules...
Topbar module zone Activate zone for modules such as horizontal menu (navbar), search form, page-wide content, etc.
Only if one or more modules are assigned | Always | Never
Only if one or more modules...
Page top module zone Activate zone for modules such as breadcrumbs, banners, share icons, etc
Only if one or more modules are assigned | Always | Never
Only if one or more modules...
Page bottom module zone Activate zone for modules at the bottom of the main column of each page
Only if one or more modules are assigned | Always | Never
Only if one or more modules...
Bottom module zone Activate zone for modules such as “powered by” and “rss list” (page footer)
Only if one or more modules are assigned | Always | Never
Only if one or more modules...
Module file Use a static module definition file instead of relying on the dynamic values generated by Tiki. Useful for custom themes. The file must be in YAML format, following the format used in profiles. None
Extra module zones available Extra module zones to be managed through the module administration interface. Useful if your custom theme requires a special zone other than the predefined ones.
Comma-separated list, maximum of 20 characters per entry.
None
Webmaster report This activates the feature to report a problematic page to the webmaster. Disabled
Webmaster email A specific email address can be set for receiving the webmaster reports.
Leave blank to use the default sender email
None
Email this page This enables users to share a page with others, by emailing a short message and link to the page.
Adds a link at the bottom if set, otherwise adds a link at the top
Disabled
look-generallayout
Tiki 14 Preferences Image
Option Description Default
Site logo and title Display a site logo image and/or title
This setting is expected to be moved from here to the admin-modules page .
Enabled
Logo source (image path) This can be a conventional path to the image file, or the syntax for an image in a Tiki gallery. img/tiki/Tiki_WCG.png
Site icon This is to be used in narrow (top to bottom) page headers. In some layouts, the site logo is scaled down to fit.
Recommended image height: 32 pixel
img/tiki/tikilogo_icon.png
Logo background color A legacy option to add a background color to the div that contains the logo image.
Examples: 1) silver - 2) #fff
Transparent
Logo title (on mouseover) This appears as tool tip text. The site logo is also a link to the site index (top page). Tiki powered site
HTML "alt" tag description (for text browsers, screen readers, etc.) Normally a description of the image, such as “Example.com logo”.
Used by text browsers, screen readers, etc.
Site Logo
Site title The displayed title of the website. None
Subtitle A short descriptive phrase. None
Left column Controls visibility of the left column of modules
Only if one or more modules are assigned | Always | User decides | Never
Only if one or more modules...
Right column Controls visibility of the right column of modules
Only if one or more modules are assigned | Always | User decides | Never
Only if one or more modules...
Top module zone Activate zone for modules such as site logo, log-in form, etc. (page header)
Only if one or more modules are assigned | Always | Never
Only if one or more modules...
Topbar module zone Activate zone for modules such as horizontal menu (navbar), search form, page-wide content, etc.
Only if one or more modules are assigned | Always | Never
Only if one or more modules...
Page top module zone Activate zone for modules such as breadcrumbs, banners, share icons, etc
Only if one or more modules are assigned | Always | Never
Only if one or more modules...
Page bottom module zone Activate zone for modules at the bottom of the main column of each page
Only if one or more modules are assigned | Always | Never
Only if one or more modules...
Bottom module zone Activate zone for modules such as "powered by" and "rss list" (page footer)
Only if one or more modules are assigned | Always | Never
Only if one or more modules...
Module file Use a static module definition file instead of relying on the dynamic values generated by Tiki. Useful for custom themes. The file must be in YAML format, following the format used in profiles. None
Extra module zones available Extra module zones to be managed through the module administration interface. Useful if your custom theme requires a special zone other than the predefined ones.
Comma-separated list, maximum of 20 characters per entry.
None
Webmaster report This activates the feature to report a problematic page to the webmaster. Disabled
Webmaster email A specific email address can be set for receiving the webmaster reports.
Leave blank to use the default sender email
None
Email this page Add a link at the bottom if set, otherwise add a link at the top
Adds a link at the bottom if set, otherwise adds a link at the top
Disabled
look-generallayout
Tiki 14 Preferences Image
Option Description Default
Site logo and title Display a site logo image and/or title
This setting is expected to be moved from here to the admin-modules page .
Enabled
Logo source (image path) This can be a conventional path to the image file, or the syntax for an image in a Tiki gallery. img/tiki/Tiki_WCG.png
Site icon This is to be used in narrow (top to bottom) page headers. In some layouts, the site logo is scaled down to fit.
Recommended image height: 32 pixel
img/tiki/tikilogo_icon.png
Logo background color A legacy option to add a background color to the div that contains the logo image.
Examples: 1) silver - 2) #fff
Transparent
Logo title (on mouseover) This appears as tool tip text. The site logo is also a link to the site index (top page). Tiki powered site
HTML "alt" tag description (for text browsers, screen readers, etc.) Normally a description of the image, such as “Example.com logo”.
Used by text browsers, screen readers, etc.
Site Logo
Site title The displayed title of the website. None
Subtitle A short descriptive phrase. None
Left column Controls visibility of the left column of modules
Only if one or more modules are assigned | Always | User decides | Never
Only if one or more modules...
Right column Controls visibility of the right column of modules
Only if one or more modules are assigned | Always | User decides | Never
Only if one or more modules...
Top module zone Activate zone for modules such as site logo, log-in form, etc. (page header)
Only if one or more modules are assigned | Always | Never
Only if one or more modules...
Topbar module zone Activate zone for modules such as horizontal menu (navbar), search form, page-wide content, etc.
Only if one or more modules are assigned | Always | Never
Only if one or more modules...
Page top module zone Activate zone for modules such as breadcrumbs, banners, share icons, etc
Only if one or more modules are assigned | Always | Never
Only if one or more modules...
Page bottom module zone Activate zone for modules at the bottom of the main column of each page
Only if one or more modules are assigned | Always | Never
Only if one or more modules...
Bottom module zone Activate zone for modules such as "powered by" and "rss list" (page footer)
Only if one or more modules are assigned | Always | Never
Only if one or more modules...
Module file Use a static module definition file instead of relying on the dynamic values generated by Tiki. Useful for custom themes. The file must be in YAML format, following the format used in profiles. None
Extra module zones available Extra module zones to be managed through the module administration interface. Useful if your custom theme requires a special zone other than the predefined ones.
Comma-separated list, maximum of 20 characters per entry.
None
Webmaster report This activates the feature to report a problematic page to the webmaster. Disabled
Webmaster email A specific email address can be set for receiving the webmaster reports.
Leave blank to use the default sender email
None
Email this page Add a link at the bottom if set, otherwise add a link at the top
Adds a link at the bottom if set, otherwise adds a link at the top
Disabled
look-generallayout
Tiki 14 Preferences Image
Option Description Default
Site Logo and Title use a Site Logo and Title
Expected to be migrated to modules entirely and made obsolete.
Enabled
Logo source (image path) This can be a conventional path to the image file, or the syntax for an image in a Tiki gallery. img/tiki/Tiki_WCG.png
Logo background color A legacy option to add a background color to the div that contains the logo image.
Examples: 1) silver - 2) #fff
Transparent
Logo title (on mouse over) This appears as tool tip text. The site logo is also a link to the site index (top page). Tiki powered site
Alt. description (e.g. for text browsers) Normally a description of the image, such as “Example.com logo”.
Used by text browsers, screen readers, etc.
Site Logo
Site title The displayed title of the website. None
Subtitle A short descriptive phrase. None
Top module zone Visibility of area to keep modules such as logo, login etc (header)
Only if module | Always | Never
Only if module
Topbar module zone Visibility of area for modules such as main horizontal menu, search form, page-wide content, etc.
Only if module | Always | Never
Only if module
Page top module zone Visibility of area to keep modules such as share etc
Only if module | Always | Never
Only if module
Left column Controls visibility of the left column of modules
Only if module | Always | User Decides | Never
Only if module
Right Column Controls visibility of the right column of modules
Only if module | Always | User Decides | Never
Only if module
Page bottom module zone Visibility of area to keep modules at the foot of each page
Only if module | Always | Never
Only if module
Bottom module zone Visibility of area to keep modules such as "powered by" and "rss list" (footer)
Only if module | Always | Never
Only if module
Module file Use a static module definition file instead of relying on the dynamic values generated by Tiki. Useful for custom themes. The file must be in YAML format, following the format used in profiles. None
Extra module zones available Extra module zones to be managed through the module administration interface. Useful if your custom theme requires a special zone other than the predefined ones.
Comma-separated list, 20 characters max per entry.
None
Webmaster Report This activates the feature to report a problematic page to the webmaster. Disabled
Webmaster Email A specific email address can be set for receiving the webmaster reports.
Leave blank to use the default sender email
None
Email this page Add a link at the bottom if set, otherwise add a link at the top
Adds a link at the bottom if set, otherwise adds a link at the top
Disabled
Option Description Default
Site Logo and Title use a Site Logo and Title
Expected to be migrated to modules entirely and made obsolete.
Enabled
Logo source (image path) This can be a conventional path to the image file, or the syntax for an image in a Tiki gallery. img/tiki/Tiki_WCG.png
Logo background color A legacy option to add a background color to the div that contains the logo image.
Examples: 1) silver - 2) #fff
Transparent
Logo title (on mouse over) This appears as tool tip text. The site logo is also a link to the site index (top page). Tiki powered site
Alt. description (e.g. for text browsers) Normally a description of the image, such as “Example.com logo”.
Used by text browsers, screen readers, etc.
Site Logo
Site title The displayed title of the website. None
Subtitle A short descriptive phrase. None
Top module zone Visibility of area to keep modules such as logo, login etc (header)
Only if module | Always | Never
Only if module
Topbar module zone Visibility of area for modules such as main horizontal menu, search form, page-wide content, etc.
Only if module | Always | Never
Only if module
Page top module zone Visibility of area to keep modules such as share etc
Only if module | Always | Never
Only if module
Left column Controls visibility of the left column of modules
Only if module | Always | User Decides | Never
Only if module
Right Column Controls visibility of the right column of modules
Only if module | Always | User Decides | Never
Only if module
Page bottom module zone Visibility of area to keep modules at the foot of each page
Only if module | Always | Never
Only if module
Bottom module zone Visibility of area to keep modules such as "powered by" and "rss list" (footer)
Only if module | Always | Never
Only if module
Module file Use a static module definition file instead of relying on the dynamic values generated by Tiki. Useful for custom themes. The file must be in YAML format, following the format used in profiles. None
Extra module zones available Extra module zones to be managed through the module administration interface. Useful if your custom theme requires a special zone other than the predefined ones.
Comma-separated list, 20 characters max per entry.
None
Webmaster Report This activates the feature to report a problematic page to the webmaster. Disabled
Webmaster Email A specific email address can be set for receiving the webmaster reports.
Leave blank to use the default sender email
None
Email this page Add a link at the bottom if set, otherwise add a link at the top
Adds a link at the bottom if set, otherwise adds a link at the top
Disabled
Option Description Default
Site Logo and Title use a Site Logo and Title
Expected to be migrated to modules entirely and made obsolete.
Enabled
Logo source (image path) This can be a conventional path to the image file, or the syntax for an image in a Tiki gallery. img/tiki/Tiki_WCG.png
Logo background color A legacy option to add a background color to the div that contains the logo image.
Examples: 1) silver - 2) #fff
Transparent
Logo title (on mouse over) This appears as tool tip text. The site logo is also a link to the site index (top page). Tiki powered site
Alt. description (e.g. for text browsers) Normally a description of the image, such as “Example.com logo”.
Used by text browsers, screen readers, etc.
Site Logo
Site title The displayed title of the website. None
Subtitle A short descriptive phrase. None
Top module zone Visibility of area to keep modules such as logo, login etc (header)
Only if module | Always | Never
Only if module
Topbar module zone Visibility of area for modules such as main horizontal menu, search form, page-wide content, etc.
Only if module | Always | Never
Only if module
Page top module zone Visibility of area to keep modules such as share etc
Only if module | Always | Never
Only if module
Left column Controls visibility of the left column of modules
Only if module | Always | User Decides | Never
Only if module
Right Column Controls visibility of the right column of modules
Only if module | Always | User Decides | Never
Only if module
Page bottom module zone Visibility of area to keep modules at the foot of each page
Only if module | Always | Never
Only if module
Bottom module zone Visibility of area to keep modules such as "powered by" and "rss list" (footer)
Only if module | Always | Never
Only if module
Module file Use a static module definition file instead of relying on the dynamic values generated by Tiki. Useful for custom themes. The file must be in YAML format, following the format used in profiles. None
Extra module zones available Extra module zones to be managed through the module administration interface. Useful if your custom theme requires a special zone other than the predefined ones.
Comma-separated list, 20 characters max per entry.
None
Webmaster Report This activates the feature to report a problematic page to the webmaster. Disabled
Webmaster Email A specific email address can be set for receiving the webmaster reports.
Leave blank to use the default sender email
None
Email this page Add a link at the bottom if set, otherwise add a link at the top
Adds a link at the bottom if set, otherwise adds a link at the top
Disabled






List Slides