Extras
Since the JSON string in multiTV starts with [[ and ends with ]][^1], you can't check if the multiTV is empty by i.e. [*multittvname:ne=``:then=`not empty`*].
But you could to use the PHx modifier in the folder phx-modifier in that case. Move the two files to assets/plugins/phx/modifiers and call it like this [+phx:multitvisempty=`tvname|docid`:then=`xxx`:else=`yyy`+] or like this [+phx:multitvisnotempty=`tvname|docid`:then=`xxx`:else=`yyy`+]. If docid is not set it defaults to current document.
Ditto filter extender
If you want to filter displayed Ditto rows by the values of multiTV field content, you could use the Ditto multitv filter extender. As all other Ditto filters it filters the row away if the condition is true.
The extender uses the following parameters
| Name | Description |
|---|---|
| multiTvFilterBy | multiTV name to filter by (required) |
| multiTvFilterOptions | (Array of) json encoded object(s) of filter options |
The following filter options could be used
| Name | Description |
|---|---|
| name | mulitTV field name that is used for filtering |
| type | Type of the multiTV field content (possible content: date, text) |
| value | The value the multiTV field content is filtered with |
| mode | Mode for filtering the multiTV field content |
| conjunction | Logical conjunction with the previous filter result (AND/OR) |
The following modes could be used for text type:
| Name | Description |
|---|---|
| contains | filtered if one value contains filterValue |
| allcontains | filtered if all values containing filterValue |
| containsnot | filtered if one value not contains filterValue |
| allcontainsnot | filtered if all values not containing filterValue |
| is | filtered if one value is filterValue |
| allis | filtered if all values are filterValue |
| isnot | filtered if one value is not filterValue |
| allisnot | filtered if all values are not filterValue |
The following modes could be used for date type:
| Name | Description |
|---|---|
| before | filtered if one value is before filterValue |
| beforeall | filtered if all values are before filterValue |
| equal | filtered if one value is equal filterValue |
| equalall | filtered if all values are equal filterValue |
| after | filtered if one value is after filterValue |
| afterall | filtered if one value is after filterValue |
Examples
The following example displays all documents within containers 3, 4, and 5 where the multiTV event values in column title not containing Important in any multiTV row.
[[Ditto?
&parents=`3,4,5`
&display=`all`
&tpl=`...`
&extenders=`@FILE assets/tvs/multitv/dittoExtender/multitvfilter.extender.inc.php`
&multiTvFilterBy=`event`
&multiTvFilterOptions=`[{"name":"title","type":"text","value":"Important","mode":"contains"}]`]]
]]If you want to filter Ditto by several multiTV values, you ave to append an option object to the multiTvFilterOptions. The next example will display all documents within containers 3, 4, and 5 where the multiTV event values in column title not containing Important and column location is Outdoor in any multiTV row.
[[Ditto?
&parents=`3,4,5`
&display=`all`
&tpl=`...`
&extenders=`@FILE assets/tvs/multitv/dittoExtender/multitvfilter.extender.inc.php`
&multiTvFilterBy=`event,event`
&multiTvFilterOptions=`[{"name":"title","type":"text","value":"Important","mode":"contains"},{"name":"location","type":"text","value":"Outdoor","mode":"allisnot","conjunction":"OR"}]`]]
]]Update to the new data format
Version 1.4.11 of multiTV uses a new data format (the column names are saved as key with each value). The custom tv and the snippet code supports the old and new format, so you don't have to update your multiTVs. It is only nessesary, if you want to add/remove columns in your multiTVs.
Create a new snippet called updateTV with the following snippet code
<?php
return include(MODX_BASE_PATH.'assets/tvs/multitv/updatetv.snippet.php');
?>Call the snippet on one (temporary) MODX document like this:
[!updateTV?
&tvNames=`yourMultiTVname1,yourMultiTVname2`
!]Parameters
| Name | Description | Default value |
|---|---|---|
| tvNames | (required) comma separated list of template variable names that contain multiTV data | - |
[^1]: The JSON string the multitv is converted to starts with [[ and ends with ]] so the MODX parser thinks it contains a snippet and you can't place the template variable directly in the template.