DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:structcondstyle

structcondstyle Plugin

Compatible with DokuWiki

  • 2024-02-06 "Kaos" unknown
  • 2023-04-04 "Jack Jackrum" unknown
  • 2022-07-31 "Igor" unknown
  • 2020-07-29 "Hogfather" yes

plugin

Last updated on
2022-06-02
Provides
Action
Repository
Source
Requires
struct

Installation

:!: External requirements: This plugin requires the following additional plugin that must be installed separately:

Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.

Syntax

The plugin adds a new keyword to the definition of struct aggregations (see Struct Plugin: Aggregation), which allows the user to add a style to the rendered table, depending on specific column values. The syntax idea is simple: the keyword condstyle: is followed by a ternary operator, specifying the condition and the the styles related to the condition being true or false:

Basic syntax:

---- struct table----
schema: schema1
cols: *
condstyle: COLUMN NAME = ARGUMENT ? "STYLE TRUE" : "STYLE FALSE"
----

The conditional part ( COLUMN = ARGUMENT) compares the current row's value in the COLUMN to the argument, using a (boolean) operator. If the condition is true, the STYLE TRUE will be applied to the row, otherwise the STYLE FALSE will be applied. The style are plain CSS code (multiple statements, each ended with a semicolon) and have to be allways wrapped within quotation marks. Currently, the following operators are recognized:

Operator Description Works for…
= Row value has to be equal to the argument text, dates, decimal
!= / NOT Row value has to be not equal to the argument text, dates, decimal
< Row value has to be less than the argument dates, decimal
> Row value has to be greater than the argument dates, decimal
<= Row value has to be less than or equal to the argument dates, decimal
>= Row value has to be greater than or equal to the argument dates, decimal
contains Row value has to contain the argument text, dates, decimal

To adress the current date and time, the keyword now may be used as an argument.

Example:

condstyle  : cms-erl = critical change ? "color: red;" : "color:;"

Development

The pluging is actively maintained and improved.

Change Log

FIXME

ToDo/Wish List

This plugin uses the PHP mbstring extension which is rarely included by default. There should at least be a note to this effect but it would be better if it didn't use it at all. Many Dokuwiki users won't be able to add extensions to the PHP they are using.

FAQ

Nothing yet

Discussion

nothing yet

plugin/structcondstyle.txt · Last modified: 2024-03-04 09:56 by Aleksandr

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki