wiki:ParametrizedTemplatesPlugin

Version 4 (modified by Álvaro Iradier, 13 years ago) (diff)

Explanation about default_value in 0.3

Trac Parametrized Templates

Description

Create pages from templates with parameters, using a form to input the parameter values. When making a page template, you can add some parameters. When a new page is created using that template, a form will be displayed, with a field for every parameter, and the page will be created by replacing the values submitted in that form.

Bugs/Feature Requests

Existing bugs and feature requests for ParametrizedTemplatesPlugin are here.

If you have any issues, create a new ticket.

Download

Download the zipped source from [download:parametrizedtemplatesplugin here].

Source

You can check out ParametrizedTemplatesPlugin from here using Subversion, or browse the source with Trac.

Usage

With this plugin, it is possible to add parameters to a wiki page template, so when creating a new wiki page from this template an intermediate form is displayed, where a field is shown for each of the parameters in the template.

When the form is submitted, the page is created from the template, replacing every parameter specification in the template with the values from the form.

To activate the plugin, add the following line (as usual) to trac.ini:

...

[components]
parametrizedtemplates.* = enabled

...

Then create templates containing parameters. Parameter format is {{parameter_name, Description or title, field_type, default_value}}

  • Available field types are:
    • textarea: a big text area with scrollboxes
    • text, by default, or if not specified, a single line text box
  • default_value: Sets a default value for this parameter, instead of empty. If a default_value is set, field_type must be set too.

Example

An example template:

 = Example page template =

 This is value of parameter 1: {{param1, Title for parameter 1}}

 This is a textare parameter 2: {{param2, Title for parameter 2, textarea}}

when creating a new page from that template, you'll get a form like:

Notes

  • If a parameter is repeated over the template (same parameter name), only one entry will be shown in the form, using the description from the first ocurrence.
  • A new page can be created using the url /newpage/PageName?template=TemplateName
  • The plugin will intercept when a new page is created via the traditional way (/wiki/PageName?template=TemplateName), if the page doesn't exist and the template does contain any parameters, and will redirect the user to /newpage/PageName?template=TemplateName in order to fill the form.

Recent Changes

16397 by rjollos on 2017-03-25 09:37:00
Remove obsolete "0.9" code
9437 by airadier on 2010-11-18 10:14:28
Added support for default value in the parameters. Closes #8013
9259 by airadier on 2010-10-06 16:09:55
Added missing setup.py. Closes #7783
(more)

Author/Contributors

Author: airadier
Maintainer: airadier
Contributors:

Attachments (1)

Download all attachments as: .zip