c:geo User Guide

User Tools

Site Tools

You are here: c:geo User Guide » c:geo User Guide » Cache Filtering
Trace:
en:cachefilter

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
en:cachefilter [2021/07/26 22:31] – [Basic filtering] lineflyeren:cachefilter [2024/02/22 23:49] (current) – fix wrong anchors murggel
Line 5: Line 5:
 ===== Accessing filter ===== ===== Accessing filter =====
  
-Filter settings are reachable via the options menu by clicking the filter icon {{:ic_menu_filter.png?nolink&30|}}. +Filter settings are reachable via the options menu by clicking the filter icon {{:ic_menu_filter.svg?nolink&30|}}. 
  
 In case a filter is already active, it is shown as a header line below the title bar. By tapping this header line, the filter settings can also be reached. For example, the following screenshot shows both the filter icon as well as the filter header line (circled in red) where the current filter is set to only show caches of type "Traditional".  In case a filter is already active, it is shown as a header line below the title bar. By tapping this header line, the filter settings can also be reached. For example, the following screenshot shows both the filter icon as well as the filter header line (circled in red) where the current filter is set to only show caches of type "Traditional". 
 +
 +A long tap on this indication will open a list of the stored filters to change the active filter.
  
 {{ :en:filter-access.png?direct&400 |}} {{ :en:filter-access.png?direct&400 |}}
Line 21: Line 23:
  
 ^ Icon ^ Function ^ Description ^ ^ Icon ^ Function ^ Description ^
-|{{:abc_ic_cab_done_holo_light.png?nolink&30 |}} | Apply | Closes the dialog and applies the current filter settings to the caches in the current context. | +|{{:ic_menu_done.svg?nolink&30 |}} | Apply | Closes the dialog and applies the current filter settings to the caches in the current context. | 
-|{{:abc_ic_clear_normal.png?nolink&30 |}} | Cancel | Closes the dialog and aborts the filter changes. | +|{{:ic_menu_cancel.svg?nolink&30 |}} | Cancel | Closes the dialog and aborts the filter changes. | 
-|{{:ic_menu_delete.png?nolink&30 |}} | Clear | Clears the current filter, i.e. sets it to a state where is doesn't filter anything (all cache types checked, all difficulties/terrain values selected). |+|{{:ic_menu_delete.svg?nolink&30 |}} | Clear | Clears the current filter, i.e. sets it to a state where is doesn't filter anything (all cache types checked, all difficulties/terrain values selected). |
 |{{:en:filter-advanced-switch.png?nolink&150|}}| Basic/Advanced mode switch | Switches between basic and [[#filter_advanced|advanced]] filter mode. | |{{:en:filter-advanced-switch.png?nolink&150|}}| Basic/Advanced mode switch | Switches between basic and [[#filter_advanced|advanced]] filter mode. |
  
Line 37: Line 39:
 c:geo supports over 20 cache types from across many geocaching services. Thus, to easify filter dialog, some selectable cache types will group other cache types. This logic was copied as closely as possible from geocaching.com behavior: c:geo supports over 20 cache types from across many geocaching services. Thus, to easify filter dialog, some selectable cache types will group other cache types. This logic was copied as closely as possible from geocaching.com behavior:
 ^ Icon ^ Cache Type Filter ^ Filters the following cache types ^ ^ Icon ^ Cache Type Filter ^ Filters the following cache types ^
-| {{ :type_traditional.png?nolink&50 |}} | Tradi | Traditional Cache, Geocaching HQ, Project APE Cache | +| {{ :type_traditional.svg?nolink&50 |}} | Tradi | Traditional Cache, Geocaching HQ, Project APE Cache | 
-| {{ :type_event.png?nolink&50 |}} | Event | Event Cache, Mega-Event Cache, Giga-Event Cache, Community Celebration Event, Geocaching HQ Celebration, GPS Adventures Exhibit,Geocaching HQ Block Party | +| {{ :type_event.svg?nolink&50 |}} | Event | Event Cache, Mega-Event Cache, Giga-Event Cache, Community Celebration Event, Geocaching HQ Celebration, GPS Adventures Exhibit,Geocaching HQ Block Party | 
-| {{ :type_virtual.png?nolink&50 |}} | Virtual | Virtual Cache, Locationless (Reverse) Cache |+| {{ :type_virtual.svg?nolink&50 |}} | Virtual | Virtual Cache, Locationless (Reverse) Cache |
  
 {{anchor:filter_basic_difficultyterrain:}} {{anchor:filter_basic_difficultyterrain:}}
Line 49: Line 51:
  
  
-{{anchor:filter_advanced:}}+{{anchor:filter_basic_status:}} 
 + 
 +==== Basic status filter ==== 
 + 
 +Allows to filter by the current state of a cache. You can select whether to filter out caches by their state. This filter is also available with more options in the [[#filter_advanced|advanced]] mode. 
 + 
 +{{ :en:filter_basic_status.png?direct&400 |}} 
 + 
 +To include/exclude caches in states **Active**, **Disabled** or **Archived**, mark/unmark the respective chips at the top of the filter. 
 + 
 +The other status options all allow you to set one of three values for it: 
 + 
 +|**All**| Caches should not be filtered according to this criteria.| 
 +|**Yes**| Only caches meeting this criteria will be included in result. For example, setting **Found** to //Yes// will lead to only found caches being included in the filter result.| 
 +|**No**| Only caches **NOT** meeting this criteria will be included in result. For example, setting **Found** to //No// will lead to only not-found caches being included in the filter result.| 
 + 
 +The following status filters are available (Description says what is filtered if you choose //Yes//): 
 + 
 +^ Status Filter ^ Description ^  
 +| Found | Filters for caches you have found. |  
 +| Owned | Filters for caches you own. |  
 +| Has Offline Log | Filters caches which have a locally stored offline log. | 
 ===== Advanced filtering ===== ===== Advanced filtering =====
 +
 +{{anchor:filter_advanced:}}
  
 To use advanced filter functions, turn on the **Basic/Advanced mode switch**. This will change the layout of the filter dialog to something like this: To use advanced filter functions, turn on the **Basic/Advanced mode switch**. This will change the layout of the filter dialog to something like this:
Line 60: Line 86:
 ==== Creating and deleting filter criteria ==== ==== Creating and deleting filter criteria ====
  
-In **Basic** mode, the available filter criteria are fixed to exactly //Cache Type//, //Difficulty// and //Terrain//.+In **Basic** mode, the available filter criteria are fixed to exactly //Cache Type//, //Difficulty// and //Terrain// as well as a basic //status// filter.
 In **Advanced** mode you may freely add or delete filter criteria to build up you own personal filter. You may even add the same filter criteria multiple times, e.g. to create a filter containing multiple text pieces in the cache name. In **Advanced** mode you may freely add or delete filter criteria to build up you own personal filter. You may even add the same filter criteria multiple times, e.g. to create a filter containing multiple text pieces in the cache name.
  
Line 71: Line 97:
 Choosing one of the criteria will add the respective filter to the criteria list. All criteria are explained [[#filter_criterias|here]]. Choosing one of the criteria will add the respective filter to the criteria list. All criteria are explained [[#filter_criterias|here]].
  
-To remove a filter criteria, tap the trash icon {{:ic_menu_delete.png?nolink&30 |}} in its upper right corner.+To remove a filter criteria, tap the trash icon {{:ic_menu_delete.svg?nolink&30 |}} in its upper right corner.
  
-To change the order of filter criteria in the list, tap&drag the drag icon {{:settings_details_black.png?nolink&30 |}} in its upper right corner.+To change the order of filter criteria in the list, tap&drag the drag icon {{:ic_menu_reorder.svg?nolink&30 |}} in its upper right corner.
  
 ==== Load and save filters ==== ==== Load and save filters ====
Line 81: Line 107:
 {{ :en:filter-advanced-saveload.png?direct&400 |}}  {{ :en:filter-advanced-saveload.png?direct&400 |}} 
  
-To save a filter, use the "save" icon {{:ic_menu_save.png?nolink&30 |}}. A dialog will pop up the enter a name for the filter:+To save a filter, use the "save" icon {{:ic_menu_save.svg?nolink&30 |}}. A dialog will pop up the enter a name for the filter:
  
 {{:en:filter-advanced-save-dialog.png?direct&300|}}  {{:en:filter-advanced-save-dialog.png?direct&300|}} 
  
-To load or delete an existing filter, use the "Modify" icon {{:ic_menu_agenda.png?nolink&30|}}. A dialog will pop up with all existing filters, allowing you to select one and either load or delete it using the respective buttons:+To load or delete an existing filter, use the "Modify" icon {{:ic_menu_manage_list.svg?nolink&30|}}. A dialog will pop up with all existing filters, allowing you to select one and either load or delete it using the respective buttons:
  
 {{ :en:filter-advanced-load-dialog.png?direct&300 |}}  {{ :en:filter-advanced-load-dialog.png?direct&300 |}} 
Line 120: Line 146:
 ^ Filter ^ Description ^  ^ Filter ^ Description ^ 
 | Cache Attributes | Filters caches using Cache Attributes e.g. "Recommended for kids" or "Stealth necessary". This filter is explained in more details [[#filter_criteria_attributes|here]]. | | Cache Attributes | Filters caches using Cache Attributes e.g. "Recommended for kids" or "Stealth necessary". This filter is explained in more details [[#filter_criteria_attributes|here]]. |
-| Cache Size | Filters caches for her size (e.g. Regular, Small, Micro). This filter is explained in more details [[#filter_criteria_size|here]]. | +| Cache Size | Filters caches by their size (e.g. Regular, Small, Micro). This filter is explained in more details [[#filter_criteria_size|here]]. | 
-| Difficulty | Filters caches for her difficulty. This is a basic filter which is described [[#filter_basic_difficultyterrain|here]]. | +| Difficulty | Filters caches by their difficulty. This is a basic filter which is described [[#filter_basic_difficultyterrain|here]]. | 
-| Favorites | Filters caches for assigned favorite points. This filter is explained in more details [[#filter_criteria_favorites|here]]. |+| Favorites | Filters caches by assigned favorite points. This filter is explained in more details [[#filter_criteria_favorites|here]]. |
 | Last Found Date | A [[#filter_criteria_date|date filter]] for the cache's last found date. | | Last Found Date | A [[#filter_criteria_date|date filter]] for the cache's last found date. |
 | Location | A [[#filter_criteria_text|text filter]] for the cache's Location (e.g. Country or State). On typing this text filter will make completion suggestions such as "Germany" or "Bavaria" depending on the locations of caches stored on your device. | | Location | A [[#filter_criteria_text|text filter]] for the cache's Location (e.g. Country or State). On typing this text filter will make completion suggestions such as "Germany" or "Bavaria" depending on the locations of caches stored on your device. |
Line 128: Line 154:
 | Logs Count | Filters caches based on logs count. This filter is explained in more details [[#filter_criteria_logscount|here]]. | | Logs Count | Filters caches based on logs count. This filter is explained in more details [[#filter_criteria_logscount|here]]. |
 | Origin | Filters caches based on their origin e.g. //Geocaching.com// or //opencaching.de//. This is a [[#filter_criteria_dynamiccheckboxlist|Dynamic checkbox filter]]. | | Origin | Filters caches based on their origin e.g. //Geocaching.com// or //opencaching.de//. This is a [[#filter_criteria_dynamiccheckboxlist|Dynamic checkbox filter]]. |
-| Terrain | Filters caches for her terrain. This is a basic filter which is described [[#filter_basic_difficultyterrain|here]]. |+| Terrain | Filters caches by their terrain. This is a basic filter which is described [[#filter_basic_difficultyterrain|here]]. |
  
 ==== Category "User Specific" ==== ==== Category "User Specific" ====
Line 140: Line 166:
  
  
-{{anchor:filter_criterias:}}+{{anchor:filter_criterias_details:}}
 ===== Filter criteria details ===== ===== Filter criteria details =====
  
Line 159: Line 185:
 | Starts With | Filters all caches where the filtered field starts with the **Search Text**. |  | Starts With | Filters all caches where the filtered field starts with the **Search Text**. | 
 | Ends With | Filters all caches where the filtered field ends with the **Search Text**. |  | Ends With | Filters all caches where the filtered field ends with the **Search Text**. | 
-| Pattern | Filters all caches where the filtered fields value corresponds to the Pattern given in the **Search Text**. You may use wildcards **?** and *. * represents zero, one or multiple characters, **?** represents one single character. For example, pattern \'H?mburg*\' will match e.g. \'Homburg\' or \'Hamburg at Night\' but not \'A day in Hamburg\' or \'Hahmburg\' |+| Pattern | Filters all caches where the filtered fields value corresponds to the Pattern given in the **Search Text**. You may use the wildcards **?** and *****. A ***** represents zero, one or multiple characters, while a **?** represents only one single character. For example, pattern ''H?mburg*'' will match e.g. ''Homburg'' or ''Hamburg at Night'' but not ''A day in Hamburg'' or ''Hahmburg'' |
  
 Use the **Match case** checkbox to decide whether text matching should occur case-sensitive or not.  Use the **Match case** checkbox to decide whether text matching should occur case-sensitive or not. 
  
-{{anchor:filter_criteria_text:}}+{{anchor:filter_criteria_date:}}
 ==== Date filters ==== ==== Date filters ====
  
Line 182: Line 208:
  
 The other status options all allow you to set one of three values for it: The other status options all allow you to set one of three values for it:
-* **All**: Caches should not be filtered according to this criteria. + 
-* **Yes**: Only caches meeting this criteria will be included in result. For example, setting **Found** to //Yes// will lead to only found caches being included in the filter result. +|**All**| Caches should not be filtered according to this criteria.| 
-* **No**: Only caches **NOT** meeting this criteria will be included in result. For example, setting **Found** to //No// will lead to only not-found caches being included in the filter result.+|**Yes**| Only caches meeting this criteria will be included in result. For example, setting **Found** to //Yes// will lead to only found caches being included in the filter result.| 
 +|**No**| Only caches **NOT** meeting this criteria will be included in result. For example, setting **Found** to //No// will lead to only not-found caches being included in the filter result.|
  
 The following status filters are available (Description says what is filtered if you choose //Yes//): The following status filters are available (Description says what is filtered if you choose //Yes//):
en/cachefilter.1627331486.txt.gz · Last modified: 2021/07/26 22:31 by lineflyer

Page Tools

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