Differences

This shows you the differences between two versions of the page.

--- plugin:tagfilter [2020-08-09 20:33] – [Installation] tech@tormantil.com
+++ plugin:tagfilter [2020-08-09 20:53] – tech@tormantil.com
@@ Line 36: / Line 36: @@
 ===== Examples/Usage =====
-Expecting you have several pages with different tags, defined by [[plugin:tag]] plugin.
-In the following examples we have two pages
+**The Basics**
+You must have added some tags with tag categories, see the [[plugin:tag]] plugin. There are formatted as follows:
+<code>{{tag>category1:tag1 category2:tag2}}</code>
+In the following examples there are two pages tagged as follows:
   * Page 1 ''<nowiki>{{tag>status:ready version:weatherwax}}</nowiki>''
   * Page 2 ''<nowiki>{{tag>status:start version:Angua}}</nowiki>''
+Tagfilter uses the tag categories to specify what to show as filters and you can also default the values.
+This tag filter defaults the status to 'Ready', which is only used on Page 1, and the user can only select one value in the dropdown:
   {{tagfilter>Status=status:.*=status:ready|Version=version:.*&nouser&nodate}}
 {{ https://github.com/lisps/tagfilter/raw/master/example/example1.png }}
+This tag filter defaults the status to 'Ready', which is only used on Page 1, but the user the user can only select multiple values in the dropdown:
   {{tagfilter>Status=status:.*=status:ready|Version=version:.*&nouser&nodate&multi}}
 {{ https://github.com/lisps/tagfilter/raw/master/example/example2.png }}
+This tag filter defaults the status to 'Ready', which is only used on Page 1, but uses the chosen parameter (not clear what this does):
   {{tagfilter>Status=status:.*=status:ready|Version=version:.*&nouser&nodate&chosen}}
 {{ https://github.com/lisps/tagfilter/raw/master/example/example4.png }}
+This tag filter defaults the status to 'Ready', which is only used on Page 1, but uses the chosen (not clear what this does) and multiple parameters:
   {{tagfilter>Status=status:.*=status:ready|Version=version:.*&nouser&nodate&multi&chosen}}