Log types: Difference between revisions
Jump to navigation
Jump to search
(Created page with "Category:Assigned numbers === NOTE: INITIAL DRAFT; WORK IN PROGRESS === <br /> <br /> <br /> A user may log different actions or status information about a geocache. Thi...") |
(Added OKAPI properties: API string & submittable flag) |
||
| (25 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
[[Category:Assigned numbers]] | [[index.php?title=Category:Assigned numbers]] | ||
=== | [[index.php?title=Category:Cache]] | ||
[[index.php?title=Category:Log]] | |||
[[index.php?title=Category:Opencaching-DE]] | |||
[[index.php?title=Category:Opencaching-PL]] | |||
User interractions with a geocache are recorded in the cache log as a log entries. | |||
Each log entry has a type, indicating an action or a status, in addition to the user supplied log entry text. | |||
This document describes the existing log types across Opencaching sites. | All log entries generate a notification email to the cache owner. Notification may be individual (per log) or digest. | ||
''This document describes the existing log types across Opencaching sites.'' | |||
== Log types matrix == | == Log types matrix == | ||
{| class="wikitable" border="1" | {| class="wikitable" border="1" | ||
|- style="background-color:#CCCCCC" | |||
| rowspan="2" |'''ID''' | |||
| rowspan="2" |'''Type''' | |||
| rowspan="2" |'''Usage''' | |||
| colspan="2" |'''OKAPI''' | |||
| colspan="2" |'''Icons''' | |||
| rowspan="2" |'''Notes''' | |||
| rowspan="2" |'''<small>GC equivalent</small>'''<ref group="GC compatibility">Information provided for third party application compatibility.</ref> | |||
|- style="background-color:#CCCCCC" | |||
|'''API string''' | |||
|'''Submittable''' | |||
|'''OCPL''' | |||
|'''OCDE''' | |||
|- | |- | ||
|- | |- | ||
| 1 | | 1 | ||
| | |[[Log:Found it|Found it]] | ||
| | |All | ||
| | |Found it | ||
| | |yes | ||
| | |[[File:Found.svg]] | ||
| | | | ||
| | | | ||
|<small>Found it</small> | |||
|- | |- | ||
| 2 | | 2 | ||
| | |[[Log:Didn't find it|Didn't find it]] | ||
|All | |All | ||
|Didn't find it | |||
|yes | |||
|[[File:Dnf.svg]] | |||
| | | | ||
| | | | ||
| | |<small>Didn't find it</small> | ||
|- | |- | ||
| 3 | | 3 | ||
| | |[[Log:Comment|Comment]] | ||
|All | |All | ||
|Comment | |||
|yes | |||
|[[File:Note.svg]] | |||
| | | | ||
|i.e. WRITE NOTE | |||
|<small>Write Note</small> | |||
|- | |||
| 4 | |||
|[[Log:Moved|Moved]] | |||
|OCPL | |||
|Moved | |||
|no | |||
|[[File:Moved.svg]] | |||
| | | | ||
|''Specific to "moving cache"'' | |||
| | | | ||
|- | |||
| 5 | |||
|[[Log:Needs maintenance|Needs maintenance]] | |||
|OCPL | |||
|Needs maintenance | |||
|no | |||
|[[File:Need-maintenance.svg]] | |||
| | | | ||
| | | | ||
* OCDE and OKAPI logs have a "needs maintenance" flag | |||
* OKAPI for OCDE Submit via Comment + needs_maintenance2=true | |||
|<small>Needs maintenance</small> | |||
|- | |- | ||
| | | 6 | ||
| | |[[Log:Maintenance performed|Maintenance performed]] | ||
| | |OCPL | ||
| | |Maintenance performed | ||
|no | |||
|[[File:Made-maintenance.svg]] | |||
| | | | ||
| | | | ||
* OCDE and OKAPI logs have a "cache is ok" flag. | |||
* OCPL - all users may perform maintenance | |||
* OKAPI issue #548 | |||
|<small>Owner maintenance</small> | |||
''<small>(GC allows only maintenance by cache owner)</small>'' | |||
|- | |||
| 7 | |||
|[[Log:Attended|Attended]] | |||
|All | |||
|Attended | |||
|yes | |||
|[[File:Attend.svg]] | |||
| | | | ||
| | | | ||
|<small>Attended</small> | |||
|- | |- | ||
| | | 8 | ||
| | |[[Log:Will attend|Will attend]] | ||
|All | |All | ||
|"Will attend | |||
|yes | |||
|[[File:Will_attend.svg]] | |||
| | | | ||
| | | | ||
|<small>Will attend</small> | |||
|- | |||
|9 | |||
|[[Log:Archived|Archived]] | |||
|All | |||
|Archived | |||
|yes | |||
|[[File:Trash.svg]] | |||
| | | | ||
| | | | ||
|<small>Archived</small> | |||
|- | |||
|10 | |||
|[[Log:Ready to be found|Ready to be found]] | |||
|All | |||
|Ready to search | |||
|yes | |||
|[[File:Published.svg]] | |||
| | | | ||
|i.e. ENABLED | |||
OCDE=Available | |||
|<small>Enabled</small> | |||
''<small>(must be published)</small>'' | |||
|- | |- | ||
| | |11 | ||
| | |[[Log:Temporarily unavailable|Temporarily unavailable]] | ||
|All | |All | ||
|Temporarily unavailable | |||
|yes | |||
|[[File:Temporary.svg]] | |||
| | | | ||
|i.e. DISABLED | |||
|<small>Disabled</small> | |||
|- | |||
|12 | |||
|[[Log:OC Team comment|OC Team comment]] | |||
|OCPL | |||
|OC Team comment | |||
|no | |||
|[[File:Octeam.svg]] | |||
| | | | ||
| | | | ||
* OCDE and OKAPI logs have an "OC team entry" flag | |||
| | |<small>Reviewer note</small> | ||
|- | |- | ||
| | |13 | ||
| | |[[Log:Locked|Locked]] | ||
| | |OCDE | ||
| | |Locked | ||
| | |no | ||
| | | | ||
| | | | ||
|<small>''OCPL not implemented, but equivalent functionality is status=BLOCKED''</small> | |||
| | | | ||
|- | |- | ||
| | |14 | ||
| | |[[Log:Locked, invisible|Locked, invisible]] | ||
|OCDE | |OCDE | ||
|Locked, invisible | |||
|no | |||
| | | | ||
| | | | ||
| | | | ||
* OCDE maps to "Locked" in output | |||
| | | | ||
|} | |} | ||
<references group="GC compatibility" /> | |||
Latest revision as of 20:01, 20 June 2026
index.php?title=Category:Assigned numbers index.php?title=Category:Cache index.php?title=Category:Log index.php?title=Category:Opencaching-DE index.php?title=Category:Opencaching-PL User interractions with a geocache are recorded in the cache log as a log entries.
Each log entry has a type, indicating an action or a status, in addition to the user supplied log entry text.
All log entries generate a notification email to the cache owner. Notification may be individual (per log) or digest.
This document describes the existing log types across Opencaching sites.
Log types matrix
| ID | Type | Usage | OKAPI | Icons | Notes | GC equivalent[GC compatibility 1] | ||
| API string | Submittable | OCPL | OCDE | |||||
| 1 | Found it | All | Found it | yes | Found it | |||
| 2 | Didn't find it | All | Didn't find it | yes | Didn't find it | |||
| 3 | Comment | All | Comment | yes | i.e. WRITE NOTE | Write Note | ||
| 4 | Moved | OCPL | Moved | no | Specific to "moving cache" | |||
| 5 | Needs maintenance | OCPL | Needs maintenance | no |
|
Needs maintenance | ||
| 6 | Maintenance performed | OCPL | Maintenance performed | no |
|
Owner maintenance
(GC allows only maintenance by cache owner) | ||
| 7 | Attended | All | Attended | yes | Attended | |||
| 8 | Will attend | All | "Will attend | yes | Will attend | |||
| 9 | Archived | All | Archived | yes | Archived | |||
| 10 | Ready to be found | All | Ready to search | yes | i.e. ENABLED
OCDE=Available |
Enabled
(must be published) | ||
| 11 | Temporarily unavailable | All | Temporarily unavailable | yes | i.e. DISABLED | Disabled | ||
| 12 | OC Team comment | OCPL | OC Team comment | no |
|
Reviewer note | ||
| 13 | Locked | OCDE | Locked | no | OCPL not implemented, but equivalent functionality is status=BLOCKED | |||
| 14 | Locked, invisible | OCDE | Locked, invisible | no |
|
|||
- ↑ Information provided for third party application compatibility.