Search Close
Log inRegister

Applications

You are here: Applications » TopicType » TopicFunction » RenderApplicationDocumentation

RenderApplicationDocumentation
Extracts the documentation section from all parts of a WikiApplication

Documentation

Parameters
  • NAME: application name, defaults to BASEWEB
  • THEWEB: web to search for docu, defaults to BASEWEB
  • TYPE: extract documentation of topics of the given type
  • NOTTYPE: don't list topics of that type

Css
  • twbDocuHolder
  • twbDocuSectionHolder
  • twbDocuSectionSummary
  • twbDocuSectionText

Implementation 

%STARTINCLUDE%
%DBQUERY{
   "WikiApplication='\b%NAME{default="%EXTRACT{text="%BASEWEB%" pattern=".*/(.+?)$" format="$1"}%"}%\b'
   AND TopicType=~'\b%TYPE%\b' 
   %IF{"defined NOTTYPE" then=" AND !(TopicType=~'\b%NOTTYPE%\b')"}%"
   web="%THEWEB{default="%BASEWEB%"}%"
   hidenull="on"
   header="<div class='twbDocuHolder'>
---+++ [[%TYPE%]]$n"
   format="<div class='twbDocuSectionHolder'>
---++++ [[$topic]]
<div class='twbDocuSectionSummary'>$formfield(Summary)</div>
<div class='twbDocuSectionText'>$percntDBCALL{\"$web.$topic\" section=\"documentation\" warn=\"off\"}$percnt
... [[$web.$topic][%MAKETEXT{"read more"}%]]</div>
</div>"
   separator="$n"
  footer="</div>"
}%
%STOPINCLUDE%

Test

TopicFunction

GetTopicTypes

returns a list of TopicTypes known in the base web
This is a "getter" TopicFunction that returns a list of known TopicTypes in a given web. Use it to create a selection in DataForms for the TopicType formfield. It adds the "none" type so that you can have (temporarily) un-typed topics. The type "TopicType" is added hardcoded so that you don't have to rely on that type being present in your web and to allow bootstrapping a type system in a web from scratch on as you will be able to create an initial TopicType TopicType this way.

Parameters
  • WEBS: list of webs to search for TopicTypes, defaults to BASEWEB
  • EXCLUDE: expression to exclude types (optional)
  • ADDITION: types that are listed additionally (optional)

… read more

RenderApplicationDocumentation

Extracts the documentation section from all parts of a WikiApplication
Parameters
  • NAME: application name, defaults to BASEWEB
  • THEWEB: web to search for docu, defaults to BASEWEB
  • TYPE: extract documentation of topics of the given type
  • NOTTYPE: don't list topics of that type

Css
  • twbDocuHolder
  • twbDocuSectionHolder
  • twbDocuSectionSummary
  • twbDocuSectionText

… read more

RenderApplicationManifest

Render a list of all files making up a given application
… read more

RenderDataFormList

Renders a list of DataForms that make use of the given DataFormAttribute
Parameters
  • ATTR: DataFormAttribute to search for, defaults to BASETOPIC
  • THEWEB: web to examin, defaults to BASEWEB

… read more

RenderFunctionCallers

Render a list of topics that use a given TopicFunction
… read more

RenderImageSelector

Renders a widget to select an image attached to a topic
Select an image attached to a OBJECT topic

Parameters
  • OBJECT, default BASEWEB.BASETOPIC
  • SELECTED
  • FIELDNAME
  • EXTENSIONS, defaults to jpe?g|JPE?G|gif|GIF|png|PNG|svg|SVG|webp|WEBP

… read more

RenderIndexItem

Fallback to render a summary for WikiTopic that does not have a type specific version of to render an index item
This method is called by RenderCategory to display a summary for an object. This method serves as a final fallback when no other TopicType-specific method was found.

Parameters
  • OBJECT
  • THEICON
  • TITLEEXTRA

… read more

RenderInheritanceGraph

a directed graph of TopicType inheritance
This function requires GraphvizPlugin

… read more

RenderRecentChanges

renders a list of recent changes in a web
This uses solr and infintescroll to create a frontpage widget.

Parameters
  • HEIGHT: height of scroll container, defaults to 40em
  • LIMIT: number of rows to render, defaults to 20
  • PAGE: from which page to start rendering
  • THEWEB: the web to render recent changes for
  • FILTER: filter to be added to the search query
  • CLASS

… read more

RenderRss

default implementation of an rss view of a single topic
This method is called by RssViewTemplate for each topic found. Note that this is a base-implementation for all TopicTypes processed. Individual TopicTypes may implement their own version called MyTopicTypeRenderRss. These are then called automatically using the %DBCALL{"web.topic->RenderRss"}% method call of the RssViewTemplate.

Parameters
  • OBJECT: the current topic

… read more

RenderSideBar

Render the sidebar navigation for the WikiWorkbench
… read more

RenderSimpleTopicCreator

TopicFunction to display a simple form to create a new topic
This function renders a topic creator form that holds a set of initial input elements to create a topic.

Parameters
  • TEXT: headline text; defaults to "Create a new INCLUDINGTOPIC"
  • LABEL: label of the TopicTitle field, defaults to "Title"
  • BUTTONTEXT: text on the twisty buttinm; default New
  • VALUE: initial value of the title input field (optional)
  • VALUES: map of initial values to formfields; format is <fieldName1>=<value1>;<fieldName2>=<value2>;...
  • FORM: DataForm to be used when creating a topic, defaults to INCLUDINGWEB.INCLUDINGTOPIC
  • TEMPLATE: TopicTemplate to be used (optional)
  • TYPE: initial TopicType value, defaults to values predefined in the form definition
  • PARENT: parent topic for the new topic, defaults to the BASETOPIC
  • WHITEBOARD: switch on/off the whiteboard textarea
  • EXTRA: additional formfields
  • SCRIPT: script to be used to create the topic, eg save or edit, defaults is specified in referring TopicType
  • EDITOR: TopicView to be used as an edit_template
  • ENABLETWISTY: boolean switch to use/hide a twisty to hide the form initially, defaults to on
  • SHOWBUTTONS: boolean switch to show/hide the submit button of the form
  • THEWEB: target web where to create the topic, defaults to BASEWEB

… read more

RenderTopicInstaller

Render a simple factory to deploy a topic in another web
This is a tool to add a topic based application, or part of it to another web. This is done by creating a TopicStub that points back to the implementation. For example, to add a new TopicType to web, you create a TopicStub that points back to the implementation of that TopicType.

The function will display a small input form to specify the web where the TopicStub is to be created.

Parameters
  • TEXT: headline for the install form, defaults to "Install BASETOPIC"
  • NAME: name of the topic to be created, defaults to BASETOPIC
  • SOURCE: used to specify the TopicStub's target to be created, defaults to BASEWEB.BASETOPIC
  • PARENT: topicparent of the new topic, defaults to HOMETOPIC
  • TEMPLATE: TopicTemplate used to create this topic, defaults to TopicStubTemplate
  • FORM: DataForm used for this topic, defaults to TopicStub
  • TYPE: type of the new topic, defaults to TopicStub
  • WIKIAPP: the name of the WikiApllication this topic belongs to, defaults to BASEWEB
  • EXTRA: extra stuff to be send during save

… read more

RenderTopicThumbnail

Display thumbnail image for a topic

Parameters
  • OBJECT: topic to generate a thumbnail for
  • ALIGN: optional alignment of image, defaults to right
  • SIZE: optional size of thumbnail
  • TYPE: image rendering type, see documentation of ImagePlugin, defaults to simple
  • CROP
  • TOOLTIP: switch on/off tooltips for thumbnails, defaults to on

… read more

RenderTopicsOfType

Display a table of topcis of a given type
Parameters
  • TYPE: the TopicType to be searched for, defaults to BASETOPIC
  • FORM: the form definition of the TopicType, defaults to TYPE's DataForm definition
  • FIELDS: columns of formfields to display, defaults to TopicTitle, Summary, WikiApplication, Changed
  • HIDDENFIELDS: list of fields that are not shown
  • SORT: sorting of rows, defaults to unsorted
  • PAGING: boolean to enable/disable paged results, defaults to on
  • INFO: boolean to enable/disable infos for results, defaults to on
  • REVERSE: sorting direction, defaults to "off", defaults to "on" if SORT="Changed"
  • ROWS: number of rows to display initially, defauts to 10
  • FILTER: additional filter expression (optional)
  • THEWEB: web to examin, defaults to BASEWEB
  • TOPICS: list of topics to query per web, default: all
  • SAVESTATE: save state of sorting and filtering, defaults to "on"
  • SEARCHING: boolean to enable/disable, defaults to on
  • ROWNUMBERS: boolean toggle to switch on/off row numbers
  • ROWGROUP: column by which to group rows, default none
  • ROWCLASS: javascript function to add a css class to the row
  • ROWCALLBACK: javascript function to process rows
  • SELECTING: boolean toggle to switch on/off row selection, defaults to off
  • ORDERING: boolean toggle to switch on/off changing the sorting, defaults to on
  • SEARCHMODE: either have one single search box using global or one per column using multi, default global
  • LENGTHMENU: list of numbers appearing in the length menu to change the page size, defaults to 5,10,15,20,25,30,40,50,100
  • BUTTONS: list of buttons to show; possible values are excel, csv, print, pdf and copy
  • <field_name>_title: column title for the given field
  • <field_name>_width: column width for the given field

… read more

RenderTopicsOfType (solr)

Display a table of topcis of a given type
Parameters
  • TYPE: the TopicType to be searched for, defaults to BASETOPIC
  • FORM: the form definition of the TopicType, defaults to TYPE's DataForm definition
  • FIELDS: columns of formfields to display, defaults to TopicTitle, Summary, WikiApplication, Changed
  • HIDDENFIELDS: list of fields that are not shown
  • SORT: sorting of rows, defaults to unsorted
  • REVERSE: sorting direction, defaults to "off", defaults to "on" if SORT="Changed"
  • ROWS: number of rows to display initially, defauts to 10
  • FILTER: additional filter expression (optional)
  • THEWEB: web to examin, defaults to BASEWEB
  • TOPICS: list of topics to query per web, default: all
  • SAVESTATE: save state of sorting and filtering, defaults to "on"
  • ROWNUMBERS: boolean toggle to switch on/off row numbers
  • ROWGROUP: column by which to group rows, default none
  • ROWCLASS: javascript function to add a css class to the row
  • ROWCALLBACK: javascript function to process rows
  • SELECTING: boolean toggle to switch on/off row selection, defaults to off
  • ORDERING: boolean toggle to switch on/off changing the sorting, defaults to on
  • SEARCHMODE: either have one single search box using global or one per column using multi, default global
  • LENGTHMENU: list of numbers appearing in the length menu to change the page size, defaults to 5,10,15,20,25,30,40,50,100
  • BUTTONS: list of buttons to show; possible values are excel, csv, print, pdf and copy
  • <field_name>_title: column title for the given field
  • <field_name>_width: column width for the given field

… read more

RenderWikiApplicationFactory

Renders a form to create a new WikiApplication
This is used to create a new WikiApplication

… read more

RenderWikiApplicationWebHome

Renders a dashboard for an application web
Renders the Applications of a WikiApplication subweb

Parameters
None

… read more

RenderWikiTopicView

(deprecated)
This function renders a view for a wiki topic, showing its title and the summary line.

Parameters

  • OBJECT: the topic to render the view for, defaults to %BASEWEB%.%BASETOPIC%
  • TITLE_PREFIX: optional string put before the topic title. see RenderWikiTopicView
  • TITLE_EXTRA: optional addition to the topic title. see RenderWikiTopicView
  • TITLE_FIELDS: fields that make up the title aera, defaults to TopicTitle, Summary
  • DISPLAYREVISIONINFO: boolean flag to switch on/off revinfo
  • EDITABLE: boolean flag switching on/off inline editing, defaults to on

… read more

Calls to 'RenderApplicationDocumentation'

Copyright

© 2006-2025 Michael Daum

This file is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. For more details read the LICENSE.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY, to the extent permitted by law; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

Sitemap

Public
This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Flatiron Institute Documentation Center? Send feedback
This website is using cookies. More info. That's Fine