plugin:datatemplate
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
plugin:datatemplate [2016-08-02 17:08] – [Demonstration] Strike-throught unavailable examples Cyrille37 | plugin:datatemplate [2022-12-06 11:59] (current) – [Data Template Plugin] Search for new maintainer(s) Cyrille37 | ||
---|---|---|---|
Line 6: | Line 6: | ||
email : cyrille@giquello.fr | email : cyrille@giquello.fr | ||
type : syntax | type : syntax | ||
- | lastupdate : 2016-08-02 | + | lastupdate : 2016-08-03 |
- | compatible : 2016-06-26 " | + | 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: | ||
---- | ---- | ||
+ | |||
+ | :?: :!: [[https:// | ||
This plugin adds the possibility to display the structured data of the [[data|Data Plugin]] using templates. Templates can be applied | This plugin adds the possibility to display the structured data of the [[data|Data Plugin]] using templates. Templates can be applied | ||
Line 26: | Line 28: | ||
===== Download and Installation ===== | ===== Download and Installation ===== | ||
- | Download | + | Search |
==== Change Log ==== | ==== Change Log ==== | ||
+ | * 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-08-02 Cyrille Giquello adopted the plugin with Christoph Clausen agreement | ||
* 2016-07-11 fix deprecated constructor calls | * 2016-07-11 fix deprecated constructor calls | ||
- | Last github commits on tag [[https:// | + | Last github commits on release |
- | {{rss> | + | |
+ | {{rss> | ||
===== Template Definition ===== | ===== Template Definition ===== | ||
Line 40: | 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 46: | Line 50: | ||
A template definition as in | A template definition as in | ||
+ | |||
<code - tpl_member> | <code - tpl_member> | ||
{{@@!imgname@@? | {{@@!imgname@@? | ||
Line 53: | Line 58: | ||
* **E-Mail**: @@email@@ | * **E-Mail**: @@email@@ | ||
</ | </ | ||
+ | |||
OR | OR | ||
+ | |||
<code - tpl_memberlist> | <code - tpl_memberlist> | ||
=== @@%title%@@ === | === @@%title%@@ === | ||
Line 61: | 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 71: | Line 84: | ||
The '' | The '' | ||
- | The value of the '' | + | The value of the '' |
< | < | ||
---- datatemplateentry member ---- | ---- datatemplateentry member ---- | ||
Line 99: | Line 113: | ||
==== datatemplatelist ==== | ==== datatemplatelist ==== | ||
+ | |||
The '' | The '' | ||
Example syntax: | Example syntax: | ||
+ | |||
< | < | ||
---- datatemplatelist ---- | ---- datatemplatelist ---- | ||
Line 112: | 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 124: | 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 135: | Line 154: | ||
The filter form adds new functionality to the '' | The filter form adds new functionality to the '' | ||
+ | |||
< | < | ||
---- filterform ---- | ---- filterform ---- | ||
Line 140: | 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 150: | Line 173: | ||
The [[http:// | The [[http:// | ||
- | <del>As another example I am using this plugin on my personal website to provide a pretty index page for a collection of [[http:// | + | As another example I am using this plugin on my personal website to provide a pretty index page for a collection of [[http:// |
===== A technical note about caching ===== | ===== A technical note about caching ===== | ||
Line 160: | 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 184: | Line 209: | ||
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.1470150511.txt.gz · Last modified: 2016-08-02 17:08 by Cyrille37