Searching via the HTML User Interface

Registered by Jochen Schnelle

How to perform a search within your found caches using the HTML user interface.

Blueprint information

Status:
Complete
Approver:
Jochen Schnelle
Priority:
Medium
Drafter:
Jochen Schnelle
Direction:
Approved
Assignee:
None
Definition:
Obsolete
Series goal:
Accepted for trunk
Implementation:
Unknown
Milestone target:
None
Completed by
Jochen Schnelle

Related branches

Sprints

Whiteboard

Starting with version 0.4, the HTML-based user interface offers to custom search through your found caches. To do so, start the HTML user interface:

$ python pygcstats_html_ui.py

Once the start page is opened in the browser, click onto "Search" at the bottom of the page.
In the next screen you are requested to select the GPX-file you would like to search through, which is typically your 'my finds' file. After selecting the file, click on "Start search". This will read the GPX-file and store the content in a database filed named "my_found_caches.db", which is stored in your Home-directory. Depending on the number of your finds, this may take a few seconds.
Once this is done, you are ready to search through your caches. There are four possible search options:

 * search by cache name
 * search by cache owner
 * search by country
 * search by log date

Actually you can enter a search term in more than one field. In this case, the search terms will be concatenated with "and", so only caches which match all search criteria will be shown in the result table.
The search does _not_ look for exact matches, but considers the search term as a fraction of the overall database entry. E.g. when searching for the term "united" in the country field, all caches you found in the "United States", "United Kingdom" and "United Arab Emirates" will be shown.
The case is not case-sensitive, so the search for "united" and "United" will give the same result.
Dates need to be input in the format "YYYY-MM-DD", otherwise an error message will be shown. Preceding zeros can be omitted, so "2012-1-1" is a legal search term as well (and is treated equal to "2012-01-01").

Clicking on "search" will initiated the search. The caches matching the search term(s) are displayed in a table, sorted in ascending order of your log date. The cache name is a link to the cache listing at geocaching.com, so clicking it will open that in a new browser tab.

A new search can be initiated by clicking on "New search" at the bottom of the result page.

Once you finished your search and after shuting down pygcstats_html_ui.py feel free to delete the file "my_found_caches.db" from your Home directory, as it is not needed anymore.

(?)

Work Items

This blueprint contains Public information 
Everyone can see this information.

Subscribers

No subscribers.