plugin:datatemplate
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
plugin:datatemplate [2014-09-25 18:32] – [Template Definition] mcgumbel | plugin:datatemplate [2022-12-06 11:59] (current) – [Data Template Plugin] Search for new maintainer(s) Cyrille37 | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Data Template | + | ====== Data Template |
---- plugin ---- | ---- plugin ---- | ||
description: | description: | ||
- | author | + | author |
- | email : christoph.clausen@gmail.com | + | email : cyrille@giquello.fr |
type : syntax | type : syntax | ||
- | lastupdate : 2014-01-12 | + | lastupdate : 2016-08-03 |
- | compatible : rincewind, weatherwax | + | compatible : 2017-02-19 " |
depends | depends | ||
conflicts | conflicts | ||
Line 13: | Line 13: | ||
tags : data, database, listing, template | tags : data, database, listing, template | ||
- | downloadurl: | + | downloadurl: |
- | bugtracker : https:// | + | bugtracker : https:// |
- | sourcerepo : https:// | + | sourcerepo : https:// |
donationurl: | donationurl: | ||
---- | ---- | ||
- | This plugin adds the possibility to display the structered | + | :?: :!: [[https:// |
+ | |||
+ | This plugin adds the possibility to display the structured | ||
to individual data entries or lists of multiple entries. Additionally, | to individual data entries or lists of multiple entries. Additionally, | ||
+ | |||
+ | News: The original author, Christoph Clausen, cannot maintain anymore the plugin, so I adopt it ;-) Thanks a lot to him to have built first steps and accepted the adoption in 2016 august. | ||
===== Download and Installation ===== | ===== Download and Installation ===== | ||
- | Download | + | Search |
==== Change Log ==== | ==== Change Log ==== | ||
- | {{rss> | + | * 2016-08-02 Add translation for list navigation links and filter button |
+ | * 2016-08-02 Cyrille Giquello adopted the plugin with Christoph Clausen agreement | ||
+ | * 2016-07-11 fix deprecated constructor calls | ||
+ | |||
+ | Last github commits on release [[https:// | ||
+ | |||
+ | {{rss> | ||
===== Template Definition ===== | ===== Template Definition ===== | ||
Line 34: | Line 44: | ||
Templates are separate wiki pages containing placeholders. There are two kinds of placeholders: | Templates are separate wiki pages containing placeholders. There are two kinds of placeholders: | ||
* Placeholders enclosed by '' | * Placeholders enclosed by '' | ||
- | * Placeholders with an additional exclamation in front of the placeholder name, like in '' | + | * Placeholders with an additional exclamation in front of the placeholder name, like in '' |
* :!: Placeholders with capital letter do not work in the current version | * :!: Placeholders with capital letter do not work in the current version | ||
Line 40: | Line 50: | ||
A template definition as in | A template definition as in | ||
+ | |||
<code - tpl_member> | <code - tpl_member> | ||
{{@@!imgname@@? | {{@@!imgname@@? | ||
Line 47: | Line 58: | ||
* **E-Mail**: @@email@@ | * **E-Mail**: @@email@@ | ||
</ | </ | ||
+ | |||
OR | OR | ||
+ | |||
<code - tpl_memberlist> | <code - tpl_memberlist> | ||
=== @@%title%@@ === | === @@%title%@@ === | ||
Line 55: | Line 68: | ||
**E-Mail**: @@email@@ | **E-Mail**: @@email@@ | ||
</ | </ | ||
- | will use whatever value is stored in the field '' | + | |
+ | will use whatever value is stored in the field '' | ||
===== Syntax ===== | ===== Syntax ===== | ||
- | This plugin provides **3** different syntax blocks: '' | + | This plugin provides **3** different syntax blocks: |
+ | - '' | ||
+ | - '' | ||
+ | - '' | ||
+ | |||
+ | The first two are essentially the same as for the data plugin, but with an added '' | ||
==== datatemplateentry ==== | ==== datatemplateentry ==== | ||
Line 65: | Line 84: | ||
The '' | The '' | ||
- | The value of the '' | + | The value of the '' |
< | < | ||
---- datatemplateentry member ---- | ---- datatemplateentry member ---- | ||
Line 93: | Line 113: | ||
==== datatemplatelist ==== | ==== datatemplatelist ==== | ||
+ | |||
The '' | The '' | ||
Example syntax: | Example syntax: | ||
+ | |||
< | < | ||
---- datatemplatelist ---- | ---- datatemplatelist ---- | ||
Line 106: | Line 128: | ||
---- | ---- | ||
</ | </ | ||
- | This list all the pages in '' | + | |
+ | This list all the pages in '' | ||
The '' | The '' | ||
+ | |||
^Column name ^ Appearance^ Placeholder | ^Column name ^ Appearance^ Placeholder | ||
| %title% | | %title% | ||
Line 118: | Line 142: | ||
=== Deprecated === | === Deprecated === | ||
+ | |||
Untill 18 May 2013 the special placeholders above where available by their localized title. To simplify their usage, you can now only use the column names as mentioned above. | Untill 18 May 2013 the special placeholders above where available by their localized title. To simplify their usage, you can now only use the column names as mentioned above. | ||
Line 129: | Line 154: | ||
The filter form adds new functionality to the '' | The filter form adds new functionality to the '' | ||
+ | |||
< | < | ||
---- filterform ---- | ---- filterform ---- | ||
Line 134: | Line 160: | ||
---- | ---- | ||
</ | </ | ||
- | The single parameter '' | + | |
+ | The single parameter '' | ||
+ | |||
+ | Next to the dropdown list is a text field. When the form is submitted, only those data entries are displayed, where the column selected in the dropdown box contains the text in the text field. This effectively corresponds to adding a line like '' | ||
It is possible to add more and more filter criteria by repeatedly submitting the form. Also, applied filters can later be removed individually. | It is possible to add more and more filter criteria by repeatedly submitting the form. Also, applied filters can later be removed individually. | ||
Line 140: | Line 169: | ||
===== Demonstration ===== | ===== Demonstration ===== | ||
- | For a demonstration, | + | For a demonstration, |
+ | |||
+ | The [[http:// | ||
- | The [[http://www.gap-optique.unige.ch/wiki/ | + | As another example I am using this plugin on my personal website to provide a pretty index page for a collection of [[http://adam.nz/recipe|recipes]] and [[http:// |
===== A technical note about caching ===== | ===== A technical note about caching ===== | ||
Line 153: | Line 184: | ||
- **Validation: | - **Validation: | ||
- **Building: | - **Building: | ||
- | - **Storage: | + | - **Storage: |
- | One can force a rebuild of the cache by using the [[devel: | + | One can force a rebuild of the cache by using the [[devel: |
===== Shortcomings ===== | ===== Shortcomings ===== | ||
+ | |||
In the current state, this plugin leaves room for improvements. Some of the currently known issues are | In the current state, this plugin leaves room for improvements. Some of the currently known issues are | ||
* The plugin is not able to detect circular dependencies in the rendering of templates. | * The plugin is not able to detect circular dependencies in the rendering of templates. | ||
Line 169: | Line 201: | ||
===== Acknowledgements ===== | ===== Acknowledgements ===== | ||
- | This plugin was inspired by the [[dataloop|dataloop plugin]] by Martyn Eggleton. Much of the template rendering code is based on the | + | |
- | [[templater|templater plugin]] by Jonathan Arkell. | + | First years, until 2016 august, of this plugin was released and maintained by Christoph Clausen. |
+ | |||
+ | This plugin was inspired by the [[dataloop|dataloop plugin]] by Martyn Eggleton. Much of the template rendering code is based on the [[templater|templater plugin]] by Jonathan Arkell. | ||
===== Bugs, Feature Requests and Patches ===== | ===== Bugs, Feature Requests and Patches ===== | ||
Please submit bugs and feature requests in the issue tracker linked at the top. | Please submit bugs and feature requests in the issue tracker linked at the top. |
plugin/datatemplate.1411662751.txt.gz · Last modified: 2014-09-25 18:32 by mcgumbel