DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:tagfilter

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Next revisionBoth sides next revision
plugin:tagfilter [2020-02-21 20:55] peterfromearthplugin:tagfilter [2020-08-31 09:12] – [TagFilter Plugin] Set lastupdate as in plugin.info.txt to not be alerted of upgrade in plugins manager chtiland
Line 6: Line 6:
 email      : coder@peterfromearth.de email      : coder@peterfromearth.de
 type       : syntax,action,helper type       : syntax,action,helper
-lastupdate : 2020-02-21+lastupdate : 2020-02-19
 compatible : Greebo, "Frusterick Manners", "Elenor Of Tsort", Detritus compatible : Greebo, "Frusterick Manners", "Elenor Of Tsort", Detritus
 depends    : tag, pagelist depends    : tag, pagelist
Line 20: Line 20:
 screenshot_img : https://github.com/lisps/tagfilter/raw/master/example/example1.png screenshot_img : https://github.com/lisps/tagfilter/raw/master/example/example1.png
 ---- ----
 +
 +===== What it Does =====
 +
 +This plugin takes tags that you have added with a tag category, using the tag plugin, and allows you to filter by the category, displaying the results using the pagelist plugin to control formatting.
  
 ===== Installation ===== ===== Installation =====
Line 32: Line 36:
  
 ===== Examples/Usage ===== ===== 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 categoriessee 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 1 ''<nowiki>{{tag>status:ready version:weatherwax}}</nowiki>''
   * Page 2 ''<nowiki>{{tag>status:start version:Angua}}</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}}   {{tagfilter>Status=status:.*=status:ready|Version=version:.*&nouser&nodate}}
      
 {{ https://github.com/lisps/tagfilter/raw/master/example/example1.png }} {{ 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}}   {{tagfilter>Status=status:.*=status:ready|Version=version:.*&nouser&nodate&multi}}
      
 {{ https://github.com/lisps/tagfilter/raw/master/example/example2.png }}   {{ 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}}   {{tagfilter>Status=status:.*=status:ready|Version=version:.*&nouser&nodate&chosen}}
      
 {{ https://github.com/lisps/tagfilter/raw/master/example/example4.png }}  {{ 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}}   {{tagfilter>Status=status:.*=status:ready|Version=version:.*&nouser&nodate&multi&chosen}}
plugin/tagfilter.txt · Last modified: 2023-10-21 19:55 by Klap-in

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