Filters: Difference between revisions

From Project-GC
Jump to navigation Jump to search
created page
 
Sandbox test edit via tools/wiki-edit-tmp.php
 
(37 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{FIXME}}
==General Information==
Many [[:Category:Tools|tools]] and [[top list]]s on [[Project-GC]] let the user narrow the result by applying filters. Each tool only exposes the filters that are meaningful for it, so not every filter on this page is available everywhere. Whether a filter requires a [[paid membership]] is also decided per tool, so the same filter can be free on one page and paid on another — see the documentation of the individual tool for that.
 
Some filters share a common mechanic but appear in the UI under several names. The most common example is ''Date range'', which is exposed as ''Hidden date'', ''Published date'', ''Log date'' and a few more — they all behave the same way, only the underlying date column differs. Where this is the case the section lists the variants you may see.
 
===Multiple filter sections===
Some tools split their filters into more than one block. Each block has a different job, and the block header in the UI tells you which is which. Two conventions are used:


==General Information==
* '''Filter (Pre) / Filter (Post).''' The ''Pre'' block is applied to your own finds and determines what the tool considers "done" already. The ''Post'' block is applied to the geocaches the tool then suggests as candidates. Used on [[MapMatrix|D/T Matrix]], [[MapHiddenDate|Map hidden date]], [[MapCounties|Map counties]] and [[MapRegions|Map regions]].
Many tools and [[top list]]s on [[Project-GC]] can have different filters applied to get different information. On some of them only a subsection of the filters can be used.
* '''Filters (Player) / Filter (Geocaches).''' The ''Player'' block decides which players are included; the ''Geocaches'' block decides which geocaches qualify. Used on [[MapCompare|Map Compare]], [[HiddenPerDate|Hidden per date]] and [[LogsPerDate|Logs per date]].
 
[[MapMatrix|D/T Matrix]] is a typical Pre/Post case: it covers all 81 difficulty/terrain combinations. Restricting the ''Pre'' block to D 1.0–3.0 / T 1.0–3.5 limits the matrix the tool is trying to fill to 30 cells. The ''Post'' block then narrows which geocaches are suggested for the cells you haven't filled in.
 
==Profile filters==
===Profile name===
This filter highlights a user in a [[top list]], and is the user whose finds the tool operates on. The button with a blue silhouette and a pencil fills the box with the [[authenticate]]d user's own profile name.
 
On comparison tools (such as [[MapCompare|Map Compare]]) this filter appears as '''Compare profile name''' and adds a second box labelled ''Compare with'' for the other user (or users). Users with a [[paid membership]] can use the table icon to add several ''Compare with'' rows at once for multi-compare.
 
On tools that operate on a geocache owner (rather than a finder) the same widget is shown with the label '''Cache owner'''.
 
===Only players from===
Available on some [[top list]]s. Limits the result to users whose calculated [[home location]] is in a specific country or region.
 
==Location filters==
===Location===
Limits the result to geocaches inside a particular country, region or county. Available in most [[top list]]s and tools that work with geocaches. Depending on the tool, only a subset of the levels may be available (e.g. only ''Country'', or ''Country/region''). Some tools also relabel this filter to '''Country''', '''Region''' or '''County''' to clarify what's expected.
 
On a few tools — notably [[PocketQueries|Pocket Queries]] — the country/region list is sourced from [[Geocaching.com]]'s own data rather than from Project-GC's, so the available options match what geocaching.com itself uses. The label is still ''Location''.
 
===Center/radius===
An alternative to '''Location''' that takes an address (or a pair of coordinates) and a radius. Only geocaches within that radius are included. The unit can be chosen as kilometres or miles and defaults to the user's preferred unit. Available in many [[top list]]s and map tools.
 
==Geocache filters==
===Geocache name===
Find geocaches whose name begins with, contains or ends with a given string. For example, all geocaches starting with ''Church Micro''. The match is case-sensitive.


==Profile name==
===Cache type / size===
This filter highlights the user in a [[top list]], clicking the button with a blue silhouette and a pencil will fill the box with the user name of the [[authenticate]]d user. For the [[:Category:Tools|tools]] that can be used to compare something between two or more users this filter have an extra box labeled ''Compare with'' for input of what other users should be compared. Users with a [[paid membership]] can use the button with a table on it to turn on ''multi compare''.
Restrict the result to specific geocache types and/or sizes. Some tools split this into separate '''Type''' and '''Size''' filters.


==Only people from==
===Difficulty / Terrain===
''Details to follow''
Restrict the result to a range (or set) of [[D/T|difficulty and/or terrain]] ratings. A few tools expose this as just '''Difficulty'''.


==Cache location==
===Attribute===
''Details to follow''
Restrict the result to geocaches that have (or do not have) one or more selected attributes.


==Hide Disabled / Archived / Premium==
===Elevation===
''Details to follow''
Restrict the result to geocaches within a given elevation range above sea level.


==Hide Found / Owned / Not found==
===Corrected coordinates===
''Details to follow''
Filter on whether the user has corrected coordinates on a geocache (typically a mystery). Used on tools that care about the difference between posted and solved coordinates, such as [[ForgottenFavorites|Forgotten Favorites]] and [[FTFList|FTF List]].


==Center/Radius (km)==
==Date and time filters==
''Details to follow''
===Date range===
Pick an inclusive date range using ''From'' and ''To''. Either field can be left empty for an open-ended range.


==From/To Hidden date==
The same mechanic is exposed in the UI under several names, depending on which date the tool is filtering on:
''Details to follow''
* '''Hidden date''' — the geocache's [[hidden date]].
* '''Published date''' — the date the geocache was published.
* '''Log date''' — the user's "found it" log date.
* '''Event date''' — for events.
* '''Last found date''' — when the geocache was most recently found.


==From/To Log date==
===Calendar day===
''Details to follow''
Restrict to geocaches whose date falls on a specific day-of-year (independent of year). Useful for working on a [[calendar]] grid.


==Cache type / size==
Exposed in the UI as:
''Details to follow''
* '''Hidden calendar day''' — by the geocache's hidden date.
* '''Published calendar day''' — by the publish date.
* '''Log calendar day''' — by your "found it" log date.


==Difficulty / Terrain ==
===Weekday===
''Details to follow''
Restrict to geocaches whose date falls on one or more weekdays (Mon–Sun). Useful when working on a [[Weekday|weekday grid]].


==Show Disabled / Archived==
Exposed in the UI as:
''Details to follow''
* '''Hidden weekday''' — by the geocache's hidden date.
* '''Published weekday''' — by the publish date.
* '''Log weekday''' — by your "found it" log date.


==Bookmark list==
==Log, ownership and status filters==
''Details to follow''
===Found / Hidden===
Include or exclude geocaches the chosen user has '''found''', '''not found''' or '''hidden'''. The defaults (include vs exclude) depend on the tool — for example, many "Map …" tools default to ''exclude finds'', while [[top list]]s default to ''include everything''.


==Ignore Bookmark list==
===Premium-only geocaches===
''Details to follow''
Include or exclude [[premium member only|Premium-only]] geocaches.


==Virtual GPS==
===Disabled / archived / past events===
''Details to follow''
Include or exclude geocaches that are ''disabled'', ''archived'' or (on some tools) ''past events''. Each status has its own checkbox. The default (include vs exclude) varies between tools.


==Cache name==
===Travelling geocaches===
''Details to follow''
Include or exclude geocaches on the well-known [[bookmark list]] [https://www.geocaching.com/plan/lists/BMAFMJR BMAFMJR], which lists travelling, [[Antipode cache|antipode]] and locationless geocaches that would otherwise distort certain results. The default (include vs exclude) varies between tools.


==Custom filter==
==List filters==
''Details to follow''
===Bookmark list===
Restrict the result to geocaches that are on a specific [[bookmark list]]. Select the owner of the bookmark list, then pick the desired list.


==Route==
===Ignore bookmark list===
''Details to follow''
The same widget as '''Bookmark list''' but inverted: geocaches that are on the chosen [[bookmark list]] are removed from the result.


==Special==
===Virtual GPS===
Some of the filters are specific to certain tools.
Restrict the result to geocaches that appear in a selected [[Virtual GPS]] list.


===None/One/Both/Owned found===
===Route===
''Details to follow''
Restrict to geocaches within a given distance of a linear route built in the [[RouteBuilder|Route Builder]] tool.


===Attribute required===
==Other==
''Details to follow''
===Custom filter===
Restrict the result to geocaches matching an advanced filter built with [[CustomFilters|Custom Filters]].


===Negative attribute required===
===Tool-specific filters===
''Details to follow''
A handful of filters only appear on a single tool or top list. They aren't grouped here in detail; the documentation page of the tool itself is the best place to read about them. Some examples:


===D/T type / size===
* '''Show''' — on [[MapCompare|Map Compare]], chooses which geocaches to display based on who has found them (''found by neither'', ''by exactly one'', ''by both''), with a separate checkbox to treat the user's owned geocaches as finds.
''Details to follow''
* '''Include''' — on [[SolvedMysteries|Solved Mysteries]], chooses which kinds of solved mysteries to include.
* '''Loop''' (or '''Loop number''') — on tools that support working on the next [[loop]] of a grid, such as [[NeededFoundDates|Needed Found Dates]].
* '''GC code''' — on [[LogDiff|Log Diff]], restricts the result to log differences on a specific geocache.
* '''Max. number of geocache hides''' — on hides-based [[top list]]s such as [[TopLogsReceived|Logs Received]], limits how many of each owner's geocaches contribute to the total.
* '''Extreme categories''' and '''Restrict to location level''' — on the [[Extremes]] tools.


===Loop===
[[Category:Tools]]
''Details to follow''

Latest revision as of 08:01, 29 May 2026

General Information

Many tools and top lists on Project-GC let the user narrow the result by applying filters. Each tool only exposes the filters that are meaningful for it, so not every filter on this page is available everywhere. Whether a filter requires a paid membership is also decided per tool, so the same filter can be free on one page and paid on another — see the documentation of the individual tool for that.

Some filters share a common mechanic but appear in the UI under several names. The most common example is Date range, which is exposed as Hidden date, Published date, Log date and a few more — they all behave the same way, only the underlying date column differs. Where this is the case the section lists the variants you may see.

Multiple filter sections

Some tools split their filters into more than one block. Each block has a different job, and the block header in the UI tells you which is which. Two conventions are used:

  • Filter (Pre) / Filter (Post). The Pre block is applied to your own finds and determines what the tool considers "done" already. The Post block is applied to the geocaches the tool then suggests as candidates. Used on D/T Matrix, Map hidden date, Map counties and Map regions.
  • Filters (Player) / Filter (Geocaches). The Player block decides which players are included; the Geocaches block decides which geocaches qualify. Used on Map Compare, Hidden per date and Logs per date.

D/T Matrix is a typical Pre/Post case: it covers all 81 difficulty/terrain combinations. Restricting the Pre block to D 1.0–3.0 / T 1.0–3.5 limits the matrix the tool is trying to fill to 30 cells. The Post block then narrows which geocaches are suggested for the cells you haven't filled in.

Profile filters

Profile name

This filter highlights a user in a top list, and is the user whose finds the tool operates on. The button with a blue silhouette and a pencil fills the box with the authenticated user's own profile name.

On comparison tools (such as Map Compare) this filter appears as Compare profile name and adds a second box labelled Compare with for the other user (or users). Users with a paid membership can use the table icon to add several Compare with rows at once for multi-compare.

On tools that operate on a geocache owner (rather than a finder) the same widget is shown with the label Cache owner.

Only players from

Available on some top lists. Limits the result to users whose calculated home location is in a specific country or region.

Location filters

Location

Limits the result to geocaches inside a particular country, region or county. Available in most top lists and tools that work with geocaches. Depending on the tool, only a subset of the levels may be available (e.g. only Country, or Country/region). Some tools also relabel this filter to Country, Region or County to clarify what's expected.

On a few tools — notably Pocket Queries — the country/region list is sourced from Geocaching.com's own data rather than from Project-GC's, so the available options match what geocaching.com itself uses. The label is still Location.

Center/radius

An alternative to Location that takes an address (or a pair of coordinates) and a radius. Only geocaches within that radius are included. The unit can be chosen as kilometres or miles and defaults to the user's preferred unit. Available in many top lists and map tools.

Geocache filters

Geocache name

Find geocaches whose name begins with, contains or ends with a given string. For example, all geocaches starting with Church Micro. The match is case-sensitive.

Cache type / size

Restrict the result to specific geocache types and/or sizes. Some tools split this into separate Type and Size filters.

Difficulty / Terrain

Restrict the result to a range (or set) of difficulty and/or terrain ratings. A few tools expose this as just Difficulty.

Attribute

Restrict the result to geocaches that have (or do not have) one or more selected attributes.

Elevation

Restrict the result to geocaches within a given elevation range above sea level.

Corrected coordinates

Filter on whether the user has corrected coordinates on a geocache (typically a mystery). Used on tools that care about the difference between posted and solved coordinates, such as Forgotten Favorites and FTF List.

Date and time filters

Date range

Pick an inclusive date range using From and To. Either field can be left empty for an open-ended range.

The same mechanic is exposed in the UI under several names, depending on which date the tool is filtering on:

  • Hidden date — the geocache's hidden date.
  • Published date — the date the geocache was published.
  • Log date — the user's "found it" log date.
  • Event date — for events.
  • Last found date — when the geocache was most recently found.

Calendar day

Restrict to geocaches whose date falls on a specific day-of-year (independent of year). Useful for working on a calendar grid.

Exposed in the UI as:

  • Hidden calendar day — by the geocache's hidden date.
  • Published calendar day — by the publish date.
  • Log calendar day — by your "found it" log date.

Weekday

Restrict to geocaches whose date falls on one or more weekdays (Mon–Sun). Useful when working on a weekday grid.

Exposed in the UI as:

  • Hidden weekday — by the geocache's hidden date.
  • Published weekday — by the publish date.
  • Log weekday — by your "found it" log date.

Log, ownership and status filters

Found / Hidden

Include or exclude geocaches the chosen user has found, not found or hidden. The defaults (include vs exclude) depend on the tool — for example, many "Map …" tools default to exclude finds, while top lists default to include everything.

Premium-only geocaches

Include or exclude Premium-only geocaches.

Disabled / archived / past events

Include or exclude geocaches that are disabled, archived or (on some tools) past events. Each status has its own checkbox. The default (include vs exclude) varies between tools.

Travelling geocaches

Include or exclude geocaches on the well-known bookmark list BMAFMJR, which lists travelling, antipode and locationless geocaches that would otherwise distort certain results. The default (include vs exclude) varies between tools.

List filters

Bookmark list

Restrict the result to geocaches that are on a specific bookmark list. Select the owner of the bookmark list, then pick the desired list.

Ignore bookmark list

The same widget as Bookmark list but inverted: geocaches that are on the chosen bookmark list are removed from the result.

Virtual GPS

Restrict the result to geocaches that appear in a selected Virtual GPS list.

Route

Restrict to geocaches within a given distance of a linear route built in the Route Builder tool.

Other

Custom filter

Restrict the result to geocaches matching an advanced filter built with Custom Filters.

Tool-specific filters

A handful of filters only appear on a single tool or top list. They aren't grouped here in detail; the documentation page of the tool itself is the best place to read about them. Some examples:

  • Show — on Map Compare, chooses which geocaches to display based on who has found them (found by neither, by exactly one, by both), with a separate checkbox to treat the user's owned geocaches as finds.
  • Include — on Solved Mysteries, chooses which kinds of solved mysteries to include.
  • Loop (or Loop number) — on tools that support working on the next loop of a grid, such as Needed Found Dates.
  • GC code — on Log Diff, restricts the result to log differences on a specific geocache.
  • Max. number of geocache hides — on hides-based top lists such as Logs Received, limits how many of each owner's geocaches contribute to the total.
  • Extreme categories and Restrict to location level — on the Extremes tools.