Opencaching-Wiki - Benutzerbeiträge [de]

Cmanager

2015-11-01T07:51:41Z

Dl6hbo:

cmanager ist eine auf Java basierende Software vom Opencaching.de-User [http://www.opencaching.de/viewprofile.php?userid=316615 Samsung1], die Logs zwischen Geocaching.com und Opencaching.de vergleicht.
Das Programm liest dazu eine vom Nutzer ausgewählte "Funddatei"(z.B. myfounds.gpx) von Geocaching.com ein und vergleicht diese via [[OKAPI]] mit den Funden des angegebenen Opencaching.de-Nutzers.
Ausgegeben wird aktuell eine Liste der Duplikate(Caches die auf Geocaching.com und Opencaching.de vorhanden sind). D.h. der Nutzer muss die Caches händisch nachloggen. In Zukunft wird vom Entwickler eine automatische Logübertragung angestrebt.

=== Bedinung ===
*Menu → Settings: OC-Namen eingeben<br />
*Menu → Open: GPX-Datei laden<br />
*List → Find on OC: Sucht alle Caches, die der Nutzer bei GCcom gefunden hat und bei OC gelistet sind <br />
*List → Find on OC(exclude found): Sucht alle Caches, die der Nutzer bei GCcom gefunden hat und bei OC noch '''nicht geloggt''' hat

=== myfounds-Datei erzeugen ===
Um die Funde abzugleichen muss eine Funddatei mit allen Funden eines Nutzers von Geocaching.com erstellt werden.<br />
An die benötigte myfounds-Dateie mit den eigenen Funden von Geocaching.com kommnt man über zwei Wege:<br />
*'''Für GCcom-Basis-Member:'''<br />
:Als Basismember muss man sich seine founds.gpx selber erstellen, z.B. mit '''geotoad'''. Dort in den Filtern dann folgendes auswählen: '''(18) cache found by [<username>]'''<br />
*'''Für GCcom-Premium-Member:'''<br />
#Auf GCcom: Your Profil→Play→[https://www.geocaching.com/pocket/ Pocket Queries]<br />
#Dort im Reiter "Active Pocket Queries" (ggf.) ganz nach unten scrollen und bei "My Finds" auf den Button "Add to Querie" klicken, um eine aktuelle Datei zu erzeugen.<br />
#Anschließend in den Reiter "Pocket Queries Ready for Download" wechseln und "My Finds Pocket Query" downloaden.

=== Download ===
Aktuelle Versionsnummer: 0.1l (31.10.2015)<br />
Aktuelle Version: [http://www.rq-project.net/others/cm/cm.zip http://www.rq-project.net/others/cm/cm.zip] <br />
Mirror OConly: [https://drive.google.com/folderview?id=0B644rrci7awHc2w3T1FoellWRjQ&usp=sharing#grid Versionen 0.1b,e,h,i,j in Google-Drive]

=== Weitere Links ===
Aktueller Forumsthread für Feedback & Co.: [http://forum.opencaching.de/index.php?topic=4348.0 Erste Seite] / [http://forum.opencaching.de/index.php?topic=4348.100000 Aktuelle Seite]<br />
Blogartikel von Schrottie zum cmanager(27.10.2015, Update: 30.10.2015): [https://blog.dafb-o.de/doppellistings-aufspueren-mit-cmanager/ OC/GC-Doppellistings aufspüren: CManager 0.1d]<br />

Ocprop

2015-07-04T16:14:47Z

Dl6hbo: /* Installation von Ocprop */

[[Datei:Statistik geolog.jpg|250px|right|thumb|Erzeugte Statistik]]

Die beiden Programme '''Ocprop''' und '''Geolog''' wurden vom User ''Fogg'' programmiert.
Sie sind als Perl-Skipte für alle Plattformen mit installiertem Perl und zusätzlich als exe-Programme für Windows verfügbar.

'''Geolog''' bereitet Rohinformationen wie z.B. Pocket-Queries auf. Man kann damit eine eigene Website mit Statistiken generieren. Die erstellten Webseiten sind zum Upload auf die eigene Homepage/Website gedacht. Das Tool kann auch von Geocaching.com Bilder, [[Das Onlinelog|Logeinträge]] und [[Cachebeschreibung (Listing)|Cachebeschreibungen]] herunterladen.<br /><br />
Geolog ermöglicht die Aufbereitung von Geocaching.com-Daten, um anschließend mit Hilfe von Ocprop seine eigenen Cachebeschreibungen und Logeinträge von [[Geocaching-Plattformen#Geocaching.com (GC)|Geocaching.com]] nach [http://www.opencaching.de Opencaching.de] übertragen zu können.<br /><br />
'''Ocprop''' kann von Geolog aufbereitete Cachebeschreibungen, Logeinträge, Cache-Status und Änderungen an eben denen zur Opencaching-Website hochladen aber auch OConly-Informationen herunterladen.
Dazu sind nur wenige Benutzereingaben erforderlich. Der Ablauf ist weitestgehend automatisiert.

__TOC__
=== Download-Quelle ===
* [http://geolog.sourceforge.net/index_de.html Perl Skripte und Programme zum Geocachen] von ''Fogg''
Auf der Website ist ein Installationsprogramm für Installation und Update von Geolog und Ocprop mit Benutzerführung verfügbar.

=== Installation von Geolog ===

==== Unter Windows 7 ohne Perl, Geolog Version 2.92 (22-04-2015) ====
# Download des ZIP-Archivs mit den EXE-Dateien von oben genannter Download-Quelle.
# Ordner anlegen, z.B. <code>C:\Program Files\Geolog</code>
# ZIP-Archiv in den neuen Ordner entpacken. (Benutzt man das Windows-Programm geolog.exe, braucht man kein Perl installieren.)
# '''geolog.exe''' mit der rechten Maustaste festhalten, auf eine leere Stelle vom Desktop ziehen und Maustaste loslassen. Aus dem Kontextmenü '''"Verknüpfung hier erstellen"''' wählen.
# Erstmaliger Aufruf des Programmes über die Windows-Kommandozeile:
## Start > <code>cmd</code> in Suche eingeben > Mit rechter Maustaste auf '''cmd''' klicken und "Als Administrator ausführen" wählen (es öffnet sich ein Windows Command Fenster)
## Wechseln in den Ordner von Geolog: <code>cd C:\Program Files\Geolog</code>
## Start des Programms mit <code>geolog <Enter></code>. Es erfolgt die Abfrage verschiedener Konfigurationsparameter. Für viele werden sinnvolle Werte vorgeschlagen, die man übernehmen kann. Manche Punkte muss man mit seinen eigenen Serverdaten o.ä. beantworten.
## Zum Schluss das Setup mit der ANYKEY-Taste beenden.
# Hat man das Programm unter einem geschützten Ordner wie '''C:\Program Files\''' abgelegt, muss man es im Admin-Modus ausführen, weil sonst die Konfigfiles nicht geschrieben werden können. Dazu rechte Maustaste auf das Geolog-Icon auf dem Desktop, '''Eigenschaften''' > Tab '''Kompatibilität''' > Haken bei '''"Programm als Administrator ausführen"'''.
# Bei Geocaching.com einloggen und im Profil das Datumsformat auf '''YYYY-MM-DD''' ändern (Bei DD.MM.YYYY gab es einen Error). Die Spracheinstellung in geolog und im Profil auf GC.com war Deutsch.
# geolog.exe wieder starten und Option '''i''' sowie anschließend '''F''' auswählen. Mit dieser Option werden inkrementell die Caches mit zugehörigen Informationen von GC.com heruntergeladen, die lokale Datenbank aufgebaut und die HTML-Seiten erstellt. Jede Seitenabfrage wird erst nach einer Wartezeit von einigen Sekunden ausgeführt, damit der eigene Account nicht wegen Massenabfragen gesperrt wird. Daher kann diese inkrementelle Abfrage mehrere Stunden dauern.

=== Installation von Ocprop ===

Unter Windows 7 ohne Perl, Ocprop Version ist 2.21 (27-02-2013)

# Download des ZIP-Archivs mit den EXE-Dateien von oben genannter Download-Quelle.
# Ordner anlegen, z.B. <code>C:\Program Files\ocprop</code>
# ZIP-Archiv in den neuen Ordner entpacken. (Benutzt man das Windows-Programm ocprop.exe, braucht man kein Perl zu installieren.)
# ocprop.exe mit der rechten Maustaste festhalten, auf eine leere Stelle vom Desktop ziehen und Maustaste loslassen. Aus dem Kontextmenü "Verknüpfung hier erstellen" wählen.
# Erstmaliger Aufruf des Programmes per Doppelklick auf das Icon:
## Es erfolgt die Abfrage verschiedener Konfigurationsparameter. Für viele werden sinnvolle Werte vorgeschlagen, die man übernehmen kann.
## Man muss seinen Benutzernamen und Passwort für Opencaching.de angeben.
## Während der Konfiguration muss man getrennt entscheiden, ob man seine Cache-Listings und Logs hochladen will. Man kann z.B. auch auf das Synchronisieren von Cache-Listings verzichten, wenn die Bescheibung bei Geocaching.com vielleicht anders sein soll als bei Opencaching.de.
## Zum Schluss das Setup mit der ANYKEY-Taste beenden.

=== Übertragen von Logeinträgen von geocaching.com nach opencaching.de ===

'''Vorbedingung''': geolog und ocprop wurden installiert und konfiguriert.

Das Übertragen der eigenen Logs von geocaching.com nach opencaching.de geschieht in mehreren Schritten:

# Starte geolog und wähle die Option '''i''' für '''inkrementell'''.
## geolog lädt zunächst alle noch nicht bekannten Logs und Listings von der GC.com-Website herunter und aktualisiert die lokale Datenbank.
## Diesen Schritt kann man nach einiger Zeit ruhig wiederholen. Beim ersten Lauf wird gegebenenfalls noch nicht alles geladen.
# Starte ocprop.exe und wähle die Option "'''.'''"
## Die geolog-Datenbank wird nun schrittweise mit Opencaching.de abgeglichen.
## Wenn im nahen Umkreis eines GC-Caches ein OC-Cache gefunden wurde, bei dem Cachename, Koordinaten oder Owner abweichen, fragt ocprop, ob beide Caches als identisch zu betrachten sind. Anhand der Anzeige kann man das recht leicht entscheiden.
## Legt man fest, dass zwei Caches trotz unterschiedlicher Daten identisch sind, so überträgt ocprop das GC-Log nach Opencaching.de.
## Findet ocprop zwei identische Caches, so werden fehlende [[Das Onlinelog#Gefunden|Fund-]] und [[Das Onlinelog#Nicht gefunden (DNF)|DNF-Logs]] sofort nach Opencaching.de übertragen.
## [[Das Onlinelog#Hinweis|Hinweis-Logs]] werden ignoriert.

'''Achtung: Der erstmalige interaktive Abgleich von über 1000 Caches kann durchaus 1 bis 2 Stunden dauernd!'''

=== Übertragen von Cachebeschreibungen ===
Damit hier keine Fehler passieren, sollten die Ausgaben des Programms genauestens überprüft werden. Denn natürlich ist es nur sinnvoll, eigene Geocaches zu übertragen.

{{unvollständig|
* Kurzanleitung ergänzen}}

=== Anleitungen ===
* [http://geolog.sourceforge.net/index_de.html Homepage]
* [http://blog.clanfamily.de/gc-vs-oc-logs-und-listings-uebertragen vom OC-Teammitglied ''ClanFamily'']

[[Kategorie:Geocaching-Software]]
[[Kategorie:Opencaching]]

Reverse („Locationless“) Caches

2014-11-06T17:50:08Z

Dl6hbo: /* Wie funktionieren Reverse Caches? */

[[Datei:Safari-attribut.png|rechts]]
Als „Reverse“ oder „Locationless“ werden [[Cachearten#Virtueller Cache|virtuelle Caches]] bezeichnet, die nicht an einen bestimmten Ort gebunden sind. Bei Opencaching.de heißen diese Caches '''Safari-Cache''' und werden mit einem besonderen [[Attribute|Attribut]] gekennzeichnet (Abbildung).

Die Bezeichnung „Locationless“ ist irreführend, da diese Caches [[Location]]s haben – nur nicht eine bestimmte, sondern mehrere.

== Wie funktionieren Reverse Caches? ==

Die Aufgabe bei Reverse Caches liegt darin, ein Objekt oder einen Ort zu finden, von dem es auf der Welt mehrere gibt, und diesen Fund im Onlinelog z.B. mit Bildern und Koordinaten zu dokumentieren. Meist können die Caches überregional absolviert werden.

Ein schönes Beispiel ist der Cache [http://www.opencaching.de/OC0EBC Trigonometrischer Punkt (OC0EBC)]. Hier soll ein trigonometrischer Punkt gefunden und der Fund durch Bilder dokumentiert werden: ein Bild vom GPS-Gerät auf dem Vermessungspunkt, und je ein Bild vom Ausblick in jede Himmelsrichtung. Mit der Zeit entwickelt sich so ein bebildertes Verzeichnis von trigonometrischen Punkten.

Bei Safari-Caches ist es essenziell, dass man als Finder tatsächlich vor Ort war. Deshalb muss die Aufgabenstellung so gewählt sein, dass sie nur vor Ort erfüllt werden kann (z.B. indem ein Foto vom GPS-Empfänger auf dem Vermessungspunkt gemacht werden muss).

== Regeln ==
Reverse bzw. Safari-Caches werden von den Opencaching.de-Nutzungsbedingungen nicht ausdrücklich erlaubt, werden aber akzeptiert wenn sie den folgenden Regeln entsprechen:

* Es muss eine klar definierte Logbedingung geben, aus der ersichtlich ist, dass der Logger draußen unterwegs war (Logfoto o.ä.).
* Es müssen Objekte bzw. Punkte sein, deren Standort reproduzierbar ist und über längere Zeit Bestand hat.
* Die Koordinaten des Standortes müssen bestimmt und beim Loggen angegeben werden.

Darüber hinaus kann der Cachebesitzer weitere Logbedingungen festlegen. Es wird empfohlen, nur ein Fundlog pro Standort zu erlauben.

Diese Regeln sind das Ergebnis folgender Forendiskussionen:
* [http://forum.opencaching-network.org/index.php?topic=2994.0 Locationless Caches]
* [http://forum.opencaching-network.org/index.php?topic=2998.0 Umfrage: Sollen Locationless Caches erlaubt sein?]
* [http://forum.opencaching-network.org/index.php?topic=3006.0 Regeln für Locationless Caches]

== Safari-Caches auf der Karte ==

Sarfari-Caches erscheinen standardmäßig auch auf der [[Cachekarte]], obwohl die Koordinaten keine Rolle spielen. Man kann sie ausblenden, indem man die Kartenfilter-Einstellungen öffnest (Klick auf den Pfeil rechts oben) und dann zweimal auf das Safari-Attribut klickt. Die Einstellungen können auch gespeichert werden - dann bleiben die Safaris unsichtbar, bis man sie per Klick auf das Safari-Attribut wieder einblendet.

== Listing für einen Safari-Cache erstellen ==
Um einen Safari-Cache zu erstellen empfiehlt es sich die Logaufgabe selber zu erfüllen und zu dokumentieren um so ein gutes Beispiel für das Listing zu haben. Ebenso sollte man sich Gedanken über eine Logbedingung machen, welche spannend ist, die Sucher herausfordert und natürlich nur vor Ort zu lösen ist.

Zur Kennzeichnung des Listings sollten folgende Attribute und Eigenschaften ausgewählt werden werden:
* Cacheart: virtueller Cache
* Größe: kein Behälter
* Wegpunkte: Safari-Cache [http://www.opencaching.de/resource2/ocstyle/images/attributes/safari.png Safari-Attribut]
* Listing: [http://wiki.opencaching.de/index.php/Attribute#OC-Only OC only] [http://www.opencaching.de/resource2/ocstyle/images/attributes/oconly.png OC-only-Attribut] ''(Falls dieser Cache auch auf einer anderen Plattform gelistet ist, dann natürlich ohne dieses Attribut. Momentan ist dies aber vermutlich nur bei OC.de möglich.)''

Weiterhin können zur genaueren Erläuterung und ein Link zur [http://www.flopp.net/safari Safari-Karte] als Hilfestellung kleine Infoboxen mittels html-Code-Schnipsel in das Listing eingebunden werden (Danke an [http://blog.flopp-caching.de/2013/09/safari-map-fuer-opencaching-de/ Flopp]):

Erste Box (der OC-Code in der letzten Zeile muss noch angepasst werden!):
{|class="wikitable octable1"
|<nowiki><div style="border:solid 2px #5f90bb;background:#dbe6f1;color:#000000;padding:5px;text-align:justify;">
<img style="float:left;" src="http://www.opencaching.de/resource2/ocstyle/images/attributes/safari.png" alt="safari.png" /><p style="margin-left:45px;">Dies ist ein virtueller <a href="http://wiki.opencaching.de/index.php/Safari-Cache">Safari-Cache</a>. Es ist nicht an einen festen Ort gebunden, sondern kann an verschiedenen Orten gelöst werden. Die oben angegebenen Koordinaten dienen nur als Beispiel.<br />
Weitere Caches mit dem Attribut "Safari-Cache" findet man mit dieser <a href="http://www.opencaching.de/search.php?searchto=searchbyname&showresult=1&output=HTML&utf8=1&sort=byname&cache_attribs=61">Suche</a>.<br />
Safari-Caches und die zugehörigen Logs werden auf der <a href="http://www.flopp.net/safari/">Safari-Cache-Karte</a> angezeigt.<br />
Der Cache und seine Logs werden <a href="http://www.flopp.net/safari/OCF858">hier</a> angezeigt.
</p></div></nowiki>
|}

Sieht dann im Listing so aus:

[[Datei:Safari Rahmen 1.png]]

Zweite Box (der OC-Code in der letzten Zeile muss noch angepasst werden!):
{|class="wikitable octable1"
|<nowiki><div style="border:solid 2px #5f90bb;background:#dbe6f1;color:#000000;padding:5px;text-align:justify;">
<p>Bitte die in der Logbedingung geforderten Koordinaten im Format "N/S DD MM.MMM E/W DDD MM.MMM" (z.B. "N 48 00.000 E 008 00.000") ins Log eintragen, damit die Positionen von der <a href="http://www.flopp.net/safari/">Safari-Cache-Karte</a> korrekt erkannt und angezeigt werden können!<br />
Der Cache und seine Logs werden <a href="http://www.flopp.net/safari/OCF858">hier</a> angezeigt.
</p></div></nowiki>
|}

Sieht dann im Listing so aus:

[[Datei:Safari Rahmen 2.png]]

Damit die Einbindung in die [http://www.flopp.net/safari Safari-Karte] funktioniert, bitte eine kurze Info an Flopp senden, der die Karte betreut.

== Listen mit Reverse Caches ==
=== Alle Caches mit Attribut ===
Caches, bei denen das Attribut ''Safari-Cache'' korrekt gesetzt ist, können über [http://www.opencaching.de/search.php?searchto=searchbyname&showresult=1&output=HTML&utf8=1&sort=bycreated&cache_attribs=61 diese Suche] aufgelistet werden.

=== Liste bekannter Caches ===
Da noch nicht alle Caches mit dem Safari-Attribut versehen sind, gibt es '''[[Safari-Caches auf einen Blick|hier]]''' eine Liste bekannter Reverse Caches.

=== Beispiele nach Thema ===

;Safari-Caches mit geographischem Bezug

*[http://www.opencaching.de/OC0EBC Trigonometrischer Punkt (OC0EBC)]
*[http://www.opencaching.de/OCFA6F Am Mittelpunkt (OCFA6F)]
*[http://www.opencaching.de/OC10061 N50°00.000 / Safari-Cache (OC10061)]
*[http://www.opencaching.de/OCF495 Go Geohashing (OCF495)]

;Safari-Caches mit geschichtlichem Hintergrund

*[http://www.opencaching.de/OCFE3E Die Geschichte der Statuen (OCFE3E)]
*[http://www.opencaching.de/OCF6D1 Mordkreuz (OCF6D1)]
*[http://www.opencaching.de/OC10274 Gerichtsbaum (OC10274)]

;Safari-Caches, die nur zum Spaß gedacht sind

*[http://www.opencaching.de/OCFD50 Streetart Safari (OCFD50)]
*[http://www.opencaching.de/OC102FC Safari für Schwergewichte (OC102FC)]
*[http://www.opencaching.de/OC0418 Wo sind welche? (OC0418)]
*[http://www.opencaching.de/OCDFDD Pirate's Totenkopf Safari (OCDFDD)]

Entwicklung/Codedoku

2014-11-06T17:43:41Z

Dl6hbo: /* Slave-Server */

Dies ist eine Materialsammlung zum [http://github.com/OpencachingDeutschland/oc-server3 Opencaching-Programmcode]. Sie soll neuen [[Entwicklung|Entwicklern]] einen Überblick über die Grundstruktur und wichtigsten Bestandteile des OC-Codes geben. Mit "OC-Code" ist alles gemeint, was sich im [[Entwicklung/Git|Git-Repository]] befindet.

Weitere Dokumentationen gibt es auch in den Codeverzeichnissen {{Codepath|doc}} und {{Codepath|htdocs/doc}}. Die Datei {{Codepath|doc/directories.txt}} enthält eine Übersicht der Repository-Verzeichnisstruktur. ''(Grüne Pfad- und Dateinamen sind anklickbar.)''

Alle die bereits an Opencaching mitprogrammiert haben, sind eingeladen, ihr Wissen beizusteuern! Wenn du dir zusätzliche Erläuterungen wünschst, kannst du sie auf der Diskussionsseite anfragen – vielleicht findet sich jemand, der den Artikel ergänzt.

Siehe auch: [[Entwicklung/Stil|Style Guidelines]]

== Dateiformat ==

Alle OC-Quelltextdateien haben [[wikipedia:UTF-8|UTF-8]]-Format. Im Kopf der Quelltextdateien befindet sich ein japanisches Wort ("Unicode Reminder"), mit dem geprüft werden kann ob die Zeichencodierung intakt ist. Sollte versehentlich nach ISO-8859-1 o.ä. umcodiert worden sein, erscheinen dort z.B. zwei Fragezeichen oder gar nichts.

{{Codepath|local/tools/find_bad_encodings.php}} prüft alle Quelltexte auf fehlende oder beschädigte Unicode Reminder.

Die Zeilenenden der Quelltexte bestehen grundsätzlich aus einem einfachen LF (line feed). Ausnahmen gibt es z.B. bei [[#Email-Templates|Email-Templates]]; hier ist CR/LF vorgeschrieben.

== Hauptmodule ==

Mit "lib1" und "lib2" sind im Folgenden die OC-eigenen Codebibliotheken in {{Codepath|htdocs/lib}} und {{Codepath|htdocs/lib2}} gemeint. Alle Teile des OC-Codes bauen auf einer dieser beiden Bibliotheken auf.

<div class="widelist">
Der OC-Software besteht aus ...
* Den '''darstellbaren Seiten''' der OC-Website, z.B. Startseite (''index'') oder Cachelisting-Anzeige (''viewcache''). Diese bestehen jeweils aus einem PHP-Script im Verzeichnis {{Codepath|htdocs}} und einem [[#Templates|Template]] in {{Codepath|htdocs/templates2/ocstyle}} (lib1: {{Codepath|htdocs/lang/de/ocstyle}}). Das PHP-Script erzeugt die darzustellenden Inhalte, das Template stellt sie als HTML-Seite dar.

* '''Kommandozeilentools''' für verschiedene Zwecke, z.B. Wartungstools die per Crojob oder von Hand aufgerufen werden. Sie befinden sich in an verschiedenen Stellen:
** {{Codepath|bin}} (Update-Scripte)
** {{Codepath|htdocs/util}} (lib1, Tools für Produktivbetrieb)
** {{Codepath|htdocs/util2}} (lib2, Tools für Produktivbetrieb)
** {{Codepath|local}} (spezielle Tools für lokale Verwendung)

* '''APIs''', also Schnittstellen für Datenabruf oder -upload durch Dritte:
** diverse APIs in {{Codepath|htdocs/api}}
** die [[OKAPI]] in {{Codepath|htdocs/okapi}}, repliziert aus dem [http://code.google.com/p/opencaching-api/source/browse/trunk/#trunk%2Fokapi OKAPI-Repository]
** die [[XML-Schnittstelle]] in {{Codepath|htdocs/xml}}
</div>

* '''Apache-Rewrites'''. Dies sind Konfigurationsdateien mit dem Name ''.htaccess'', die vom Apache-Webserver ausgelesen werden. Sie interpretieren die übergebene URL und leiten auf ein PHP-Script um. Apache-Rewrites kommen an zwei Stellen zum Einsatz:
** Statistikbilder: {{Codepath|htdocs/statpics/htaccess-dist|htdocs/statpics/.htaccess}}
** OC-Kurz-URLs, z.B. http://opencaching.de/OC1234: diese sind direkt im Produktiv-Webserver konfiguriert.

== Bibliotheken ==

Die einzelnen OC-Module verwenden verschiedene Code-Bibliotheken:

=== Eigene Bibliotheken ===

==== lib1 ====
Die alte selbstgeschriebene Bibliothek von OC-Codeversion 1.0, in {{Codepath|htdocs/lib}}. Sie enthält z.B. Funktionen für Datenbankzugriff, Login, Menüs, geographische Berechnungen und ein einfaches Template-System.

lib1 ist veraltet und wird auf OC.de nur noch für das Bearbeiten von Logs und Cachebeschschreibungen, für Benachrichtigungen über beobachtete und neue Caches und für die XML-Schnittstelle verwendet. Mittelfristig soll sie ganz durch lib2 ersetzt werden. (Alle auf OC.pl-Code basierenden [[Opencaching]]-Seiten verwenden weiterhin ausschließlich die lib1).

lib1 wird eingebunden mit
:<code>require 'lib/common.inc.php'</code>

==== lib2 ====
Die Bibliothek der OC.de-Codversion 2.0 und höher in {{Codepath|htdocs/lib2}}, Nachfolger von lib1. Sie ist wesentlich umfangreicher. Der Code ist aufgeteilt in das "Framework" mit allgemeinen Dingen wie Datenbankzugriff, Authentifizierung, Lokalisierung, Templates etc. und die sogenannte "Business Logic" in {{Codepath|htdocs/lib2/logic}} mit allen Geocaching-spezifischen Klassen und Funktionen.

lib2 wird in Bestandteile der Website eingebunden mit
:<code>require 'lib2/web.inc.php'</code>
und in Kommandozeilentools mit
:<code>require 'lib2/cli.inc.php'</code>

;gemeinsamer lib1- und lib2-Code
Manche Bibliotheksmodule werden versionsübergreifend verwendet, z.B. für Übersetzungen und Sprachauswahl. Sie sind in {{Codepath|htdocs/lib2}} abgelegt.

==== libse ====
Eine Klassenbibliothek von Opencaching.se, in {{Codepath|htdocs/libse}}. Im Zuge der Codezusammenführung von OC.de und OC.se wurde sie 2011 mit in den OC.de-Code übernommen. Sie wird für zusätzliche Wegpunkte und persönliche Notizen im Cachelisting verwendet.

==== Autoload ====
Für die Klassen aller drei Bibliotheken sind Autoloader installiert. Das heißt wenn man z.B. ein Cache-Objekt benötigt, muss man dafür nicht {{Codepath2|htdocs|lib2/logic/cache.class.php}} einbinden sondern man erzeugt einfach direkt das Objekt:
:<code>$cache = new cache();</code>
{{Codepath2|htdocs/lib2/logic|cache.class.php}} wird dann automatisch geladen.

=== Fremdbibliotheken ===

Die OC-Software macht ausgiebig Gebrauch von fertigen PHP- und JavaScript-Codebibliotheken. Eine vollständige Aufstellung incl. Codepfade, Bezugsquellen etc. enthält {{Codepath|doc/license.txt}}. Hier seien nur die wichtigsten davon erwähnt:

<div class="widelist">
* [http://www.smarty.net/ '''Smarty'''] wird als "Template-Engine" für lib2 verwendet. OC-spezifische Erweiterungen befinden sich in der Klasse ''OcSmarty'' und in {{Codepath2|htdocs|lib2/smarty/ocplugins}}. Mehr dazu im Abschnitt [[#Templates|Templates]].

* '''[http://htmlpurifier.org/ HTML Purifier]''' dient zum "Säubern" von HTML-Code, den der Benutzer z.B. in Cachebeschreibungen eingeben kann. lib1 und lib2 verwenden getrennte HTML-Purifier-Installationen. In lib2 wird er über die Klasse ''OcHTMLPurifier'' eingebunden und kann dort auch angepasst werden.

* '''[http://www.tinymce.com/ TinyMCE]''' ist ein leistungsfähiger JavaScript-Wysiwyg-Texteditor. Er dient zum Bearbeiten von Cachebeschreibungen, Logs und Profiltexten. lib1 und lib2 verwenden beide die TinyMCE-Installation in {{Codepath|htdocs/resource2/tinymce}}. OC-spezifische Konfigurationsdaten gibt es in {{Codepath2|htdocs/resource2|tinymce/config}}.

Von lib2-Code verwendete Bibliotheken sind in {{Codepath|htdocs/lib2}} (PHP) und {{Codepath|htdocs/resource2}} (JavaScript) angelegt. Bibliotheken für lib1 befinden sich an verschiedenen Stellen.

</div>

== Konfigurationsdateien ==

==== lib1-Konfiguration ====

Die Einstellungen für lib1-Code befinden sich überwiegend in
:''htdocs/lib/settings.inc.php''
Diese Datei ist nur lokal vorhanden. Als Vorlage für das Aufsetzen einer neuen Produktiv-Installation gibt es die Datei {{Codepath2|htdocs/lib|settings-dist.inc.php}}, die nach ''settings.inc.php'' zu kopieren und anzupassen ist.

Für [[Entwicklung/Entwicklersystem|Entwicklersysteme]] gibt es entsprechend die Vorlage {{Codepath2|htdocs/lib|settings-sample-dev.inc.php}}. Sie verwendet die Datei {{Codepath2|htdocs/lib|settings-dev.inc.php}}, in der die Grundeinstellungen für Entwicklersysteme zusammengefasst sind.

Daneben gibt es noch zwei Konfigurationsdateien ''settings.inc.php'' für die Benachrichtigungs-Cronjobs, in {{Codepath|htdocs/util/notification}} und {{Codepath|htdocs/util/watchlist}}.

Weiterhin verwendet lib1 auch Teile der lib2-Konfiguration, insbesondere {{Codepath2|htdocs/config2|locale.inc.php}}.

==== lib2-Konfiguration ====

Die lib2-Einstellungen befinden sich alle in {{Codepath|htdocs/config2}}. Sie werden ''alle'' in folgender Reihenfolge eingebunden, sobald man {{Codepath2|htdocs/lib2|web.inc.php}} oder {{Codepath2|htdocs/lib2|cli.inc.php}} einbindet:

* sprachabhängige Einstellungen: {{Codepath2|htdocs/config2|locale.inc.php}}
* sonstige Default-Einstellungen: {{Codepath2|htdocs/config2|settings-dist.inc.php}}
* lokale Einstellungen: ''settings.inc.php''

Auch hier sind Vorlagen für Produktiv- ({{Codepath2|htdocs/config2|settings-sample.inc.php}}) und Entwicklersystem ({{Codepath2|htdocs/config2|settings-sample-dev.inc.php}}) vorhanden, die nach ''settings.inc.php'' zu kopieren und and die lokale Systeminstallation anzupassen sind.

==== Der Rootpath ====

Wenn man in PHP-Scripte mit <code>include</code> oder <code>require</code> weitere Dateien einbindet, geschieht dies relativ zum Verzeichnispfad des Hauptscripts. (Daneben kann man auch weitere Pfade festlegen, in denen PHP nach passenden Scripten sucht.)

Wie unter [[#Hauptmodule|Hauptmodule]] erläutert, befinden sich die Module der OC-Software auf verschiedenen Verzeichnisebenen Die Startseite liegt z.B. in {{Codepath|htdocs}}, das lib2-Cronjob-Modul dagegen in {{Codepath|htdocs/util2/cron}}. Alle diese Module binden lib1- oder lib2-Bibliothekscode ein, der weitere Unterscripte einbindet. Damit das alles funktioniert, wird im OC-Code ein ''Basispfad'' für alle Includes festgelegt. Dieser heißt
:<code>$opt['rootpath']</code>
in lib2 und
:<code>$rootpath</code>
in lib1.

Sofern man keine weiteren Vorkehrungen trifft, wird dieser Rootpath automatisch als Relativpfad "./" gesetzt. Scripte in Unterverzeichnissen müssen ihn dagegen selbst setzen, z.B. "../" wenn das Script eine Ebene tiefer liegt, oder absolut als <code>dirname(__FILE__).'../'</code>, wenn nicht bekannt ist, aus welchem aktuellen Verzeichnis ein Kommandozeilentool aufgerufen wird.

== Konstanten ==

Globale Konstanten sind an folgenden Stellen definiert:

* {{Codepath|htdocs/lib/consts.inc.php}}
* {{Codepath|htdocs/lib2/const.inc.php}}
* {{Codepath|htdocs/lib2/error.inc.php}}
* {{Codepath|htdocs/lib2/logic/const.inc.php}}

Die lib2-Konstanten werden auch teilweise auch in lib1-Code verwendet.

== Datenbank ==

Die OC-Software ist nur für die Verwendung von MySQL ausgelegt. Zwar werden in lib2 keine MySQL-Funktionen mehr direkt aufgerufen, aber zahlreiche SQL-Statements verlassen sich auf MySQL-Syntax.

=== Grundlegende Datenbankfunktionen ===

Für lib2 befinden sich alle Funktionen in {{Codepath2|htdocs|lib2/db.inc.php}} und sind dort kurz dokumentiert, für lib1 in {{Codepath2|htdocs|lib/clicompatbase.inc.php}}. Datenbankverbindungen werden automatisch entsprechend den Konfigurationseinstellungen hergestellt, sobald man eine Query absetzt.

Die wichtigsten Funktionen seien hier anhand von Beispielen erläutert:

sql("UPDATE `caches` SET `size`='&1' WHERE `cache_id`='&2'",
$newsize, $cacheid);

Hier wird die Größe eines Caches geändert. Variablen werden als fortlaufend numerierte Platzhalter &1, &2 etc. übergeben. Die Funktion ''sql'' ruft dann intern für jede Variable <code>mysql_real_escape_string()</code> auf, was spezielle Zeichen wie " codiert und gleichzeitig [[wikipedia:SQL-Injection|SQL-Injections]] verhindert.

'''Niemals dürfen Variablen direkt in SQL-Statements eingebaut werden!''' Wann immer möglich sind Platzhalter zu verwenden. Notfalls kann auch direkt mit <code>sql_escape()</code> codiert werden, was allerdings Probleme verursacht, wenn ein "&" in den Daten enthalten ist: Die Funktion <code>sql()</code> interpretiert es anschließend als Startzeichen eines Platzhalters.

$cachesize = sql_value("
SELECT `size` FROM `caches`
WHERE `cache_id`='&1'",
null, $cacheid);

Hier wird die Größe eines Caches abgefragt. Falls die Cache-ID nicht gefunden wird, wird der Defaultwert ''null'' zurückgeliefert. Denke immer daran, den Defaultwert als ersten Parameter anzugeben! Ihn zu vergessen ist eine häufige Fehlerquelle.

In der lib1 heißt die Funktion anders und kann nicht mit Platzhaltern umgehen; der entsprechende Code lautet dann:

$cachesize = sqlValue("
SELECT `size` FROM `caches`
WHERE `cache_id`='" . sql_escape($cacheid) . "'",
null);

Das folgende Beispiel demonstriert, wie der Inhalt einer Tabelle ausgelesen wird:

$rs = sql("
SELECT `cache_id`, `name`, `type` `size` FROM `caches`
WHERE `cache_id`='&1'",
$cacheid);
while ($r = sql_fetch_assoc($rs))
{
// ... Weiterverarbeitung von $r['cache_id'], $r['name'] etc.
}
sql_free_result($rs);

=== Slave-Server ===

Beide OC-Libraries sehen eine Lastverteilung auf einen Haupt-Datenbankserver (Master) und einen oder mehrere "Slaves" vor, die replizierte Daten des Masters enthalten; siehe {{Codepath|doc/replication.txt}}. Dazu gibt es SQL-Funktionen mit dem Zusatz "_slave", z.B. <code>sql_slave()</code>, die von "datenbankintensiven" Programmmodulen wie z.B. der Suche ({{Codepath2|htdocs|search.php}}) anstatt der Basisfunktionen verwendet werden.

Wenn per ''settings.inc.php'' keine Slave-Server konfiguriert sind, laufen alle Zugriffe über den Master. Zurzeit betreibt kein Opencaching-Knoten Slave-Server; die Kapazität des Masters reicht überall aus.

=== Temporärtabellen ===

Da Subqueries bei MySQL recht ineffizient sind, sind manchmal temporäre Tabellen für Zwischenergebnisse nötig.

lib2 sieht einen speziellen Mechanismus zur Verwaltung von Temporärtabellen vor. Sie werden in einer eigenen Datenbank abgelegt, für die erweiterte Zugriffsrechte (Tabellen anlegen/löschen) vergeben werden, und werden per Cronjob automatisch aufgeräumt, wenn sie nicht gleich wieder gelöscht wurden.

Ein (nicht unbedingt sinnvolles) Beispiel für die Verwendung von lib2-Temporärtabellen. Die temporäre Tabelle heißt "tmp_caches" und wird in SQL-Statements über einen Platzhalter referenziert:

sql_temp_table('tmp_caches'); // Tabelle registrieren
sql(" // Tabelle anlegen
CREATE TEMPORARY TABLE &tmp_caches ENGINE=MEMORY
SELECT `cache_id` FROM `caches`
WHERE `user`.`user_id` = `caches`.`user_id`
AND `user`.`country` = '&1'",
$country);

$rs = sql(" // Tabelle auslesen
SELECT * FROM `cache_desc`, &tmp_caches
WHERE `cache_desc`.`cache_id` = &tmp_caches.`cache_id`");
// ... Daten weiterverarbeiten
sql_free_result($rs);

sql_drop_temp_table('tmp_caches'); // Tabelle löschen

=== Datenbankstruktur; statische Daten ===

Datenbankstruktur und -inhalte werden an folgenden Stellen unter {{Codepath|htdocs/doc/sql}} definiert:

* Tabellen, Felder und Indizes in {{Codepath2|htdocs/doc/sql|tables}}
* Stored Functions, Procedures und Triger in {{Codepath2|htdocs/doc/sql|stored-proc}}
* statische Daten wie z.B. Menüs, Cachetypen und sprachabhängige Texte in {{Codepath2|htdocs/doc/sql|static-data/data.sql}}.

Es gibt weitere (geographische) "statische Daten", die aufgrund ihres Umfangs nicht im Git-Repository enthalten sind; siehe {{Codepath2|htdocs/doc/sql|static-data/static-data.txt}}. Für Entwickler steht auf Anfrage ein Datenbankdump zur Verfügung, der eine vollständig initialisierte OC-Datenbank enthält (Veröffentlichung ist geplant). Weitere Updates können dann per
:{{Codepath|bin/dbupdate.php}}
eingepflegt werden, also man muss die oben aufgelisteten Dateien nicht von Hand weiterverarbeiten.

Siehe auch: [[Entwicklung/Datenbankversionierung|Datenbankversionierung]]

==== OKAPI ====

Die [[OKAPI]]-Tabellen werden zwar in der gleichen Datenbank abgelegt, sind aber unabhängig von den OC-Tabellen und daher ''nicht'' in {{Codepath|htdocs/doc/sql}} definiert. Bei [http://code.google.com/p/opencaching-api/#Installation_/_Update_Instructions Installation der OKAPI] werden sie automatisch angelegt und bei OKAPI-Updates automatisch aktualisiert. {{Codepath2|bin|dbupdate.php}} führt auch OKAPI-Updates durch, falls die OKAPI installiert ist.

Auch der OKAPI-''Code'' ist unabhängig vom OC-Code, d.h. sämtliche Datenbankzugriffe sind dort redundant implementiert. '''Bei Änderungen an Datenstrukturen oder -inhalten ist daher immer zu prüfen, ob eine Anpassung der OKAPI nötig ist!'''

=== Trigger & Stored Procedures ===

Der Opencaching-Code macht reichlich Gebrauch von gespeicherten Datenbank-Funktionen und Triggern. Sie werden dazu eingesetzt, um die Konsistenz der Datenbankinhalte zu gewährleisten. Vor dem Hintergrund, dass drei unabhängige Frameworks parallel auf die Datenbank zugreifen – lib1, lib2 und OKAPI (und manchmal noch ein Administrator von Hand) – ist diese Vorgehensweise ratsam. Sie macht die OC.de-Datenbank ausgesprochen robust.

Alle Datenbankfunktionen sind in
:{{Codepath|htdocs/doc/sql/stored-proc}}
definiert. Der aktuelle Stand befinden sich in {{Codepath2|htdocs/doc/sql/stored-proc|maintain-current.inc.php}}; für die [[Entwicklung/Datenbankversionierung|Datenbankversionierung]] können zusätzliche ältere Stände bzw. Update-Scripte existieren.

Der Inhalt des ''maintain''-Scripts lässt sich grob untergliedern in
* allgemeine Funktionen für komplexe Berechnungen, z.B. <code>DECTOWP</code> für die Berechnung neuer OC-Wegpunkte
* Update-Funktionen für bestimmte Felder (<code>sp_update_*</code>) die entweder von verschiedenen Triggern aufgerufen werden oder zur Datenbankwartung aus {{Codepath2|htdocs|dbmaint.php}} (Menü Admin|Datenbankwartung)
* Trigger-Prozeduren

Eine Besonderheit sind '''globale Variablen''' die zur Parameterübergabe von PHP-Scripten an Datenbankfunktionen oder zwischen Datenbankfunktionen verwendet werden. Sie sind in {{Codepath2|htdocs/doc/sql/stored-proc|maintain-current.inc.php}} erläutert.

=== SQL-Debugger ===

lib1 und lib2 enthalten einen nützlichen SQL-Debugger ({{Codepath2|htdocs|lib/sqldebugger.inc.php}} bzw. {{Codepath2|htdocs|lib2/sqldebugger.class.php}}). Er zeigt für jedes ausgeführte SQL-Statment

* das Statement selbst,
* ein [http://dev.mysql.com/doc/refman/5.1-olh/de/using-explain.html EXPLAIN],
* die ersten zurückgelieferten Datensätze, falls vorhanden,
* die Ausführungszeit,
* eventuelle MySQL-Warnungen.

Der SQL-Debugger muss in den [[#Konfigurationsdateien|Settings]] aktiviert sein – für lib1 per <code>$sql_debug = true</code>, in lib2 durch Setzen des Flags <code>DEBUG_SQLDEBUGGER</code> in <code>$opt['debug']</code>. Wahlweise kann man diese Flags auch nur in einzelnen zu debuggenden PHP-Quelltexten setzen.

Anschließend ist die zu debuggende Seite mit dem URL-Parameter <code>sqldebug=1</code> aufzurufen.

== Temporärdaten und Inhalte im Dateisystem ==

Manche Dinge werden in Dateien statt in der Datenbank abgelegt.

<div class="mediumlist">
* '''Hochgeladene Bilder''' befinden sich üblicherweise in {{Codepath|htdocs/images/uploads}} (in den Settings änderbar), die Thumbnails darunter in {{Codepath2|htdocs/images/uploads|thumbs}}. Generierte Statistikbilder werden in {{Codepath|htdocs/images/statpics}} abgelegt.
* Herunterzuladende, gepackte '''Ausgaben der [[XML-Schnittstelle]]''' werden in {{Codepath|htdocs/download/zip}} zwischengespeichert (ebenfalls konfigurierbar).
* {{Codepath|htdocs/cache2}} enthält zwischengespeicherte [[#Templates|Templates]], [[#Übersetzung|Übersetzungsdateien]] für gettext und verschiedene Temporärdaten. Ein guter Teil dieser Daten wird von {{Codepath|bin/clear-webcache.php}} neu generiert.
* {{Codepath|htdocs/var}} enthält zwischengespeicherte OKAPI-Daten (die OKAPI legt allerdings auch eine Menge "gecachete" in der Datenbank ab) und Fehlerprotokolle.
* {{Codepath|htdocs/cache}} enthält vermutlich nur noch temporäre Prozess-Synchronisationsdateien (.pid-Dateien) der lib1-cronjobs für Log- und Cache-Benachrichtigungen.
</div>

== Templates ==

[[wikipedia:Template (Programmierung)|Templates]] dienen in Webanwendungen dazu, die Generierung von aus- und einzugebenden Daten von deren HTML-Darstellung zu trennen. HTML- und JavaScript-Code wird komplett in den Template-Dateien untergebracht, PHP-Code soweit wie irgend möglich in PHP-Scripten.

Die Einbindung der Templates in den PHP-Programmablauf geschieht wie folgt:
# Festlegung, welche Templatedatei verwendet wird
# Zuweisung von variablen Inhalten an das Template
# Darstellung des Templates
Für alle drei Punkte gibt es entsprechende Bibliotheksfunktionen.

=== lib1-Templates ===

Die alte Library enthält ein selbstgemachtes, simples Templatesystem. Die Templatedateien befinden sich in {{Codepath|htdocs/lang/de/ocstyle}} und enthalten den auszugebenden HTML- und JavaScript-Code. Der Name der Template-Datei wird im PHP-Code über die globale Variable <code>$tplname</code> festgelegt, z.B.
:<code>$tplname = 'newcache';</code>

Für alle variablen Inhalte werden im Template Platzhalter wie z.B. <code>{cachename}</code> verwendet; die PHP-Variable wird dann übergeben mit

:<code>tpl_set_var('cachename', $cachename);</code>

Sofern der variable Teil auch HTML-Code oder etwas zu Übersetzendes enthält, wird dies in speziellen Include-Dateien abgelegt, z.B.

$cachelink = '<a href="viewcache.php?cacheid={cacheid}">{cachename}</a>';
$outputformat_notexist = t('The selected output format is unknown!');

Die Include-Datei wird im PHP-Hauptmodul eingebunden und die Variablen per <code>mb_ereg_replace</code> ersetzt, bevor das Ganze per <code>tpl_set_var()</code> ans Template übergeben wird.

:<code>tpl_BuildTemplate();</code>
stellt schließlich das Template dar und beendet das PHP-Script.

Alle [[Opencaching]]-Seiten außer OC.de und OC.se/no verwenden noch das lib1-Templatesystem.

=== lib2-Templates (Smarty) ===

==== Grundlagen ====

Die neue Bibliothek verwendet die leistungsfähige [[wikipedia:Smarty|Smarty]]-Engine. Smarty-Templates bestehen neben dem HTML/JavaScript-Code im Wesentlichen aus Kontrollstrukturen und Variableneinbindungen. Die Templates sind in {{Codepath|htdocs/templates2/ocstyle}} abgelegt.

Die lib2 definiert die globale Variable
:<code>$tpl</code>
über die alle Zugriffe auf Smarty und die Templates laufen. Am Beginn des PHP-Moduls wird jeweils das Template initialisiert:

$tpl->name = 'newemail'; // Name der Template-Datei
$tpl->menuitem = MNU_MYPROFILE_DATA; // Menü-ID, siehe doc/sql/static-data/data.sql
$tpl->caching = false; // nicht zwischenspeichern

Der ''caching''-Parameter legt fest, ob das Ergebnis der Templateausgabe zwischengespeichert wird; die Dauer der Zwischenspeicherung ist dann ggf. per
$tpl->caching_lifetime = 1800; // halbe Stunde Caching
festzulegen. Dies empfiehlt sich bei häufig aufgerufenen, rechenintensiven Seiten. Seiten mit ständig wechselndem bzw. benutzerabhängigem Inhalt dürfen '''nicht''' "gecacht" werden!

Neben Caching der Template-''Ausgaben'' gibt es auch eine ''Vorcompilierung'' der Templates selbst. Diese erfolgt
* einmalig für alle Templates per <code>bin/clear-webcache.php</code>,
* automatisch, wenn ein geändertes Template abgerufen wird,
* jedesmal bei jedem Template-Aufruf, falls in den Settings der Debug-Schalter <code>DEBUG_TEMPLATES</code> gesetzt ist.

Die zwischengespeicherten Templates werden in <code>htdocs/cache2/smarty</code> abgelegt.

Auf die Initialisierung des Templates folgen Variablen-Zuweisungen (s.u.) und schließlich die Darstellung mit
:<code>$tpl->display();</code>
die das PHP-Script beendet.

;Smarty-Syntax

Im Folgenden sind ein paar grundlegende Smarty-Elemente erklärt; ansonsten sei auf die [http://www.smarty.net/docsv2/de/ Smarty-Dokumentation] verwiesen und auf die vielen Bespiele in {{Codepath2|htdocs|templates2/ocstyle}}. (Achtung: Der OC-Code verwendet eine ältere Smarty-Version; nicht alles was in der Doku steht ist hier auch schon verfügbar!)

Alle Smarty-Elemente stehen in geschweiften Klammern {}. Wenn das Template solche Klammern für andere Zwecke verwendet, z.B. für JavaScript-Kontrollstrukturen, müssen diese von der Smarty-Interpretation ausgeklammert werden:

{literal}
function js_function()
{
...
}
{/literal}

==== Variablen ====

Variablen werden z.B. per
:<code>$tpl->assign('cachename', $cache['name']);</code>
an das Template übergeben und dort als
:<code>{$cachename}</code>
verwendet. Es können auch Arrays übergeben werden, deren Elemente statt [] mit einem Punkt referenziert werden.
:<code>{$cache.name}</code>
steht z.B. für <code>$caches['name']</code>, übergeben per <code>$tpl->assign('caches', ...)</code>. Dies funktioniert auch mit numerischen Indizes – z.B. <code>{$user.0}</code> für das erste Element eines $user-Arrays – und mit mehr als zwei Ebenen.

Auch simple Berechnung sind möglich, z.B. <code>{$waylength*2}</code>.

Zusätzlich zu dem vom PHP-Code übergebenen Variablen kann man auch eigene definieren, z.B.
:<code>{assign var=counter value=1}</code>
Mit <code>{capture}</code> lassen sich u.U. auch komplexere Ausdrücke in einer Variable unterbringen.

==== Kontrollstrukturen ====

Bedingte Einbindung von Template-Komponenten ist mit <code>{if} … {elseif} … {else} … {/if}</code>-Anweisungen möglich. Dabei können auch komplexere PHP-Ausdrucke verwendet werden, die als Boolean ausgewertet werden:

{if $show_statistics && ($statdata|@count > 0)}
... Statistik ausgeben ...
{/if}

(@count ist eine [[#Benutzerdefinierte Erweiterungen; Übersetzungen|benutzerdefinierte Funktion]])

Eine weiter häufig verwendete Struktur ist <code>{foreach}</code> zum iterieren von Arrayelementen:

{foreach from=$caches item=cache}
<td>{$cache.name|escape}</td>
{/foreach}

<code>|escape</code> ist ein ''Modifizierer'', der den Variableninhalt weiterverarbeitet. In diesem Fall werden HTML-Entitäten "escaped".

Mit <code>{strip}...{/strip}</code> lassen sich alle Whitespaces (Leerzeichen, Tabs, Zeilenumbrüche) in einem Abschnitt herausfiltern, was die auszugebende Datenbank reduziert. Aber Vorsicht, falls Whitespaces als Trennzeichen in Ausgaben benötigt werden!

==== Benutzerdefinierte Erweiterungen ====

Smarty lässt sich um eigene
* Elemente ("Blocks"),
* Modifizierer und
* Funktionen
erweitern. Der Opencaching-Code enthält eine Reihe solcher eigener Erweiterungen in {{Codepath2|htdocs|lib2/smarty/ocplugins}}.

Die wichtigste Erweiterung ist das <code>{t}</code>-Element zum Übersetzen von Texten. Alle Texte in den Templates werden in Englisch geschrieben und in <code>{t} ... {/t}</code> eingeschlossen; sie werden dadurch automatisch dem Übersetzungssystem zugeführt. Mehr dazu im Kapitel [[#Übersetzungen|Übersetzungen]].

=== Systemtemplate und Menüsystem ===

Was oben über einzelne Templates geschrieben wurde betrifft nur den Teil der Seite, der im ''Content-Container'' dargestellt wird – also dem Teil unterhalb und rechts des Menüsystems und oberhalb der Fußzeile. Alles "drumherum" wird vom ''Systemtemplate'' erzeugt.

Folgende Codedateien sind daran in der lib1 beteiligt ...
* Systemtemplate: {{Codepath2|htdocs|lang/de/ocstyle/main.tpl.php}}
* Menüdefinitionen: {{Codepath2|htdocs|lang/de/ocstyle/lib/menu.php}}
* PHP-Framework: {{Codepath2|htdocs|lib/common.inc.php}} → tpl_BuildTemplate()
... und in der lib2:
* Systemtemplate: {{Codepath2|htdocs|templates2/ocstyle/sys_main.tpl}}
* Menüsystem: Tabelle 'sys_menu' per {{Codepath2|htdocs|doc/sql/static-data/data.sql}}, {{Codepath2|htdocs|lib2/menu.class.php}}
* PHP-Framework: {{Codepath2|htdocs|lib2/OcSmarty.class.php}}

Zusätzliche Hauptmenü-Punkte sind via [[#Konfigurationsdateien|Konfigurationsdateien]] erzeugbar.

=== Email-Templates ===

Auch der Inhalt (''body'') von Emails wird über Templates erzeugt.

lib1-Email-Templates befinden sich in {{Codepath|htdocs/lang/de/ocstyle/email}}, {{Codepath|htdocs/util/notification}} und {{Codepath|htdocs/util/watchlist}} und werden von den entsprechenden PHP-Modulen direkt per <code>mb_ereg_replace()</code> aufgelöst.

lib2-Email-Templates liegen in {{Codepath|htdocs/templates2/mail}} und werden von <code>mail.class.php</code> per Smarty verarbeitet.

=== OKAPI ===
Die OKAPI hat ein eigenes Templatesystem; mehr dazu im Abschnitt [[#OKAPI|OKAPI]].

== CSS Style Sheets ==
Die Style Sheets befinden sich in {{Codepath|htdocs/resource2/ocstyle/css}}.

== Grafiken ==

Grafiken für Icons und andere Dinge verteilen sich – soweit es keine Drittbibliotheken betrifft – über drei Verzeichnisse:

* {{Codepath|htdocs/images}} (lib1 und lib2)
* {{Codepath|htdocs/lang/de/ocstyle/images}} (lib1)
* {{Codepath|htdocs/resource2/ocstyle/images}} (lib2)

Hier herrscht etwas Chaos. Manches ist mehrfach vorhanden - auch innerhalb ''einer'' Library - oder inkonsistent abgelegt, die Dateitypen wechseln zwischen GIF und PNG. Glattziehen lässt sich das kaum, weil Grafiken auch gerne von anderer Stelle aus verlinkt werden, z.B. aus Cachelistings - teils sogar von anderen Plattformen aus. Schiebt man die Grafiken einfach weg oder ändert das Format, zerstört es unbemerkt Cachebeschreibungen.

Zur Kompatibilität mit alten Cachebeschreibungen und Logs liegen in folgenden Verzeichnissen Grafiken, die anderweitig nicht mehr verwendet werden:

* {{Codepath|htdocs/lang/de/stdstyle/images}}
* {{Codepath|htdocs/lib/tinymce/plugins/emotions/images}}
* {{Codepath|htdocs/resource2/stdstyle/images}}

== Übersetzung ==

Der OC-Code ist mehrsprachig und frei übersetzbar, mit Ausnahme
* der Benachrichtigungs-Emails, die es bislang nur in Deutsch gibt (-> http://redmine.opencaching.de/issues/141)
* des Garmin-Download-Dialogs ({{Codepath2|htdocs|garmin.php}}), dessen untere Hälfte es nur in Deutsch und Englisch gibt (siehe {{Codepath|htdocs/resource2/ocstyle/js/GarminDisplay.js}})
(weitere noch nicht lokalisierbare Module bitte ergänzen!)

Die Lokalisierung je nach gewählter Sprache erfolgt grundsätzlich mit folgenden Mechanismen:
* In Templates über die Smarty-Tags <code>{t}English Text{/t}</code>. Hierbei können auch Variablen eingesetzt werden, z.B.
*:<code>{t 1=$cachename 2=$username}The geocache %1 has been found by %2{/t}</code>
* Notfalls direkt im PHP-Code durch Aufruf von <code>$translate->t()</code>, z.B.
*:<code>$text = $translate->t('New password code', <nowiki>''</nowiki>, basename(__FILE__), __LINE__)</code>
* Bei Artikelseiten, die via {{Codepath|htdocs/articles.php}} dargestellt werden, per Ablage der Templates in Unterverzeichnissen von {{Codepath|htdocs/templates2/ocstyle/articles}}.

Das Übersetzungssystem arbeitet intern mit <code>gettext()</code>. Die Strings dafür befinden sich in der Tabellen ''sys_trans'' und ''sys_trans_text''. Man kann sie direkt via {{Codepath2|htdocs/doc/sql/static-data|data.sql}} einpflegen, oder mit dem "Schnellübersetzungsmodus" + "SQL-Export" von {{Codepath2|htdocs|translate.php}} (Menü Admin|Übersetzung). Letzteres kann allerdings jede Menge Git-Merge-Konflikte beim Zusammenführen verschiedener Branches erzeugen, daher werden OC.de-Übersetzungen derzeit nur direkt in {{Codepath2|htdocs/doc/sql/static-data|data.sql}} eingepflegt.

Achtung: '''Auch für die englische Seitendarstellung läuft nochmal alles durch den Übersetzer''', Artikel ausgenommen. Die englischen Originaltexte in den Templates oder im PHP-Code sind also nur eine Basis für die weitere Übersetzung. Kleinere Fehler dort müssen nicht korrigiert werden, solange die Texte verständlich sind. ''Wenn'' dort etwas korrigiert wird, muss es gleichzeitig auch in der Tabelle ''sys_trans'' in {{Codepath2|htdocs/doc/sql/static-data|data.sql}} geändert werden!

Opencaching.de gibt es zurzeit in Deutsch, Englisch, Italienisch und Spanisch. Die Übersetzungen werden durch den von Opencaching Deutschland eingesetzten Code Maintainer organisiert.

== Fehlerbehandlung ==

Der OC-Code verwendet kein Exception Handling (mit Ausnahme der OKAPI). Wenn etwas fehlschlägt, wird dies durch den Rückgabewert der betreffenden Funktion signalisiert und entsprechend reagiert. Würde man den betroffenen Funktionen noch einen Namenszusatz spendieren, der die mögliche Fehlerrückgabe kennzeichnet, wäre dieses System transparenter und in sich weniger fehleranfällig als ein strukturiertes Exception Handling.

==== fehlerhafte Benutzereingaben ====
Wenn es Probleme mit einer Benutzereingabe gibt, wird das betreffende Template nochmals angezeigt und an passender Stelle eine mit dem CSS-Stil <code>errormsg</code> formatierte Meldung eingeblendet. Dies ist jeweils entsprechend zu implementieren.

==== erkanntes Problem ====
Wenn anderweitig ein nicht handhhabbares Problem erkannt wird, wird das Fehlertemplate angezeigt. In '''lib1''' befindet sich dies in {{Codepath2|htdocs|lang/de/ocstyle/error.tpl.php}} und wird aufgerufen per
:<code>tpl_errorMsg('original_templatename', $fehlermeldung);</code>
z.B.
$error_desc_not_found = t('(internal error) The description is not available.');
...
tpl_errorMsg('editdesc', $error_desc_not_found);

Das '''lib2'''-Fehlertemplate befindet sich in bzw. {{Codepath2|htdocs|templates2/ocstyle/error.tpl}} und wird verwendet mit
:<code>$tpl->error(Fehlernummer)</code>
oder
:<code>$tpl->error($fehlermeldung);</code>
Die Fehlernummern sind in {{Codepath2|htdocs|lib2/error.inc.php}} definiert.

; SQL-Fehler

Bei MySQL-Fehlern wird ein Fehlertemplate anzeigt und eine Admin-Email versandt, sofern in den [[#Konfigurationsdateien|Settings]] eine Mailadresse hinterlegt ist. In der lib1 ist sie in
:<code>$sql_errormail</code>
einzutragen, in der lib2 in
:<code>$opt['db']['error']['mail']</code>.
Entwicklersysteme werden so konfiguriert, dass das komplette SQL-Statement auch direkt angezeigt wird.

Zusätzlich kann man per <code>$sql_warntime</code> (lib1) bzw. <code>$opt['db']['warn']['time']</code> (lib2) eine Warnschwelle für zu lange SQL-Ausführungszeiten festlegen. Bei Überschreitung werden dann Admin-Mails erzeugt.

==== unerkanntes Problem ====

{{Codepath2|htdocs|lib2/errorhandler.inc.php}} enthält ein noch in der Testphase befindlichen Handler für PHP-Fehler, der auch in lib1 eingebunden ist. Er wird bei PHP-Fehlern aktiv, die (abhängig von der ''error_reporting''-Einstellung in der PHP-Konfiguration) zu einem Abbruch des Scripts führen. Es wird dann eine Fehlermeldung anzeigt und ggf. eine Admin-Mail erzeugt. Es wird die gleiche Emailkonfiguration wie für bei SQL-Problemen (s.o.) verwendet.

Dieser PHP-Errorhandler ist derzeit nur aktiviert, wenn in der Konfiguration der Debug-Modus eingeschaltet ist. Ansonsten erscheint bei Fehlern eine leere Seite.

== OKAPI ==

Die Opencaching-API ist ein eigenständiges PHP-Projekt, dessen Code auf verschiedenen OC-Seiten zum Einsatz kommt. Die Projekt-Homepage ist http://code.google.com/p/opencaching-api/. Beiträge, die nicht vom Code-Maintainer selbst kommen, werden üblicherweise in Branches hochgeladen und laufen dann durch ein Code Review.

Die OKAPI wird – erfolgreich! – mit einem wesentlich höheren Anspruch an Codequalität und -Stil entwickelt als die OC-Länderseiten. Dokumentation und Codestruktur sind herausragend. Gleichzeitig steht sie bei einigen Details wie Template-Engine, Datenbank-Library und Konstanten-Definitionen hinter dem OC.de-Code zurück. Der OKAPI-Code ist nur für Webanwendungen geschrieben; Einbindung in Kommandozeilentools kann insbesondere am Exception-Handling scheitern.

Der OKAPI-Code wird aus dem OKAPI-Projekt in die lokalen OC-Code-Repositories (nach {{Codepath|htdocs/okapi}}) repliziert. Bei Opencaching.pl und .nl geschieht dies automatisch über einen SVN-"Commit-Hook", bei Opencaching.de manuell durch den Code-Maintainer nach einem Security Review.

OKAPI-Code kann über die "Facade"-Schnittstelle in OC-Code eingebunden werden ({{Codepath2|htdocs|okapi/facade.php}}). OC.pl macht davon insbesondere bei der Karte Gebrauch, die von der OKAPI generiert wird. OC.de verwendet die Facade bislang nur (experimentell) im Update-Script {{Codepath|bin/okapi-update.php}}, das von {{Codepath2|bin|dbupdate.php}} aufgerufen wird.

Sämtliche OKAPI-Seitenzugriffe laufen über eine Rewrite-Engine ({{Codepath2|htdocs|okapi/.htaccess}} → {{Codepath2|htdocs|okapi/controller.php}}). Man kann daher die PHP-Scripte nicht direkt über ihre URLs idenitifizieren sondern muss schonmal etwas suchen. Methoden befinden sich in {{Codepath2|htdocs|okapi/services}}, Seiten mit HTML-Output in {{Codepath2|htdocs|okapi/views}}.

Für die Dokumentation verwendet die OKAPI ein eigenes XML-Format, das von einem Parser aufbereitet wird.

Templates für Methoden, die HTML- oder sonstiges XML-Output liefern, sind in .tpl.php-Dateien zusammen mit den PHP-Quelltexten abgelegt. Variablen werden per PHP-Code eingebunden, meist per "short open tags", z.B.

<? if (($vars['my_notes'] == 'desc:text') && ($c['my_notes'] != null)) { /* Does user want us to include personal notes? */ ?>
<p><b><?= _("Personal notes") ?>:</b> <?= Okapi::xmlescape($c['my_notes']) ?></p>
<? } ?>

[[Kategorie:Entwicklung|Codedoku]]

Entwicklung/Codedoku

2014-05-18T07:53:47Z

Dl6hbo: /* Übersetzung */

Dies ist eine Materialsammlung zum [http://github.com/OpencachingDeutschland/oc-server3 Opencaching-Programmcode]. Sie soll neuen [[Entwicklung|Entwicklern]] einen Überblick über die Grundstruktur und wichtigsten Bestandteile des OC-Codes geben. Mit "OC-Code" ist alles gemeint, was sich im [[Entwicklung/Git|Git-Repository]] befindet.

Weitere Dokumentationen gibt es auch in den Codeverzeichnissen {{Codepath|doc}} und {{Codepath|htdocs/doc}}. Die Datei {{Codepath|doc/directories.txt}} enthält eine Übersicht der Repository-Verzeichnisstruktur. ''(Grüne Pfad- und Dateinamen sind anklickbar.)''

Alle die bereits an Opencaching mitprogrammiert haben, sind eingeladen, ihr Wissen beizusteuern! Wenn du dir zusätzliche Erläuterungen wünschst, kannst du sie auf der Diskussionsseite anfragen – vielleicht findet sich jemand, der den Artikel ergänzt.

Siehe auch: [[Entwicklung/Stil|Style Guidelines]]

== Dateiformat ==

Alle OC-Quelltextdateien haben [[wikipedia:UTF-8|UTF-8]]-Format. Im Kopf der Quelltextdateien befindet sich ein japanisches Wort ("Unicode Reminder"), mit dem geprüft werden kann ob die Zeichencodierung intakt ist. Sollte versehentlich nach ISO-8859-1 o.ä. umcodiert worden sein, erscheinen dort z.B. zwei Fragezeichen oder gar nichts.

{{Codepath|local/tools/find_bad_encodings.php}} prüft alle Quelltexte auf fehlende oder beschädigte Unicode Reminder.

Die Zeilenenden der Quelltexte bestehen grundsätzlich aus einem einfachen LF (line feed). Ausnahmen gibt es z.B. bei [[#Email-Templates|Email-Templates]]; hier ist CR/LF vorgeschrieben.

== Hauptmodule ==

Mit "lib1" und "lib2" sind im Folgenden die OC-eigenen Codebibliotheken in {{Codepath|htdocs/lib}} und {{Codepath|htdocs/lib2}} gemeint. Alle Teile des OC-Codes bauen auf einer dieser beiden Bibliotheken auf.

<div class="widelist">
Der OC-Software besteht aus ...
* Den '''darstellbaren Seiten''' der OC-Website, z.B. Startseite (''index'') oder Cachelisting-Anzeige (''viewcache''). Diese bestehen jeweils aus einem PHP-Script im Verzeichnis {{Codepath|htdocs}} und einem [[#Templates|Template]] in {{Codepath|htdocs/templates2/ocstyle}} (lib1: {{Codepath|htdocs/lang/de/ocstyle}}). Das PHP-Script erzeugt die darzustellenden Inhalte, das Template stellt sie als HTML-Seite dar.

* '''Kommandozeilentools''' für verschiedene Zwecke, z.B. Wartungstools die per Crojob oder von Hand aufgerufen werden. Sie befinden sich in an verschiedenen Stellen:
** {{Codepath|bin}} (Update-Scripte)
** {{Codepath|htdocs/util}} (lib1, Tools für Produktivbetrieb)
** {{Codepath|htdocs/util2}} (lib2, Tools für Produktivbetrieb)
** {{Codepath|local}} (spezielle Tools für lokale Verwendung)

* '''APIs''', also Schnittstellen für Datenabruf oder -upload durch Dritte:
** diverse APIs in {{Codepath|htdocs/api}}
** die [[OKAPI]] in {{Codepath|htdocs/okapi}}, repliziert aus dem [http://code.google.com/p/opencaching-api/source/browse/trunk/#trunk%2Fokapi OKAPI-Repository]
** die [[XML-Schnittstelle]] in {{Codepath|htdocs/xml}}
</div>

* '''Apache-Rewrites'''. Dies sind Konfigurationsdateien mit dem Name ''.htaccess'', die vom Apache-Webserver ausgelesen werden. Sie interpretieren die übergebene URL und leiten auf ein PHP-Script um. Apache-Rewrites kommen an zwei Stellen zum Einsatz:
** Statistikbilder: {{Codepath|htdocs/statpics/htaccess-dist|htdocs/statpics/.htaccess}}
** OC-Kurz-URLs, z.B. http://opencaching.de/OC1234: diese sind direkt im Produktiv-Webserver konfiguriert.

== Bibliotheken ==

Die einzelnen OC-Module verwenden verschiedene Code-Bibliotheken:

=== Eigene Bibliotheken ===

==== lib1 ====
Die alte selbstgeschriebene Bibliothek von OC-Codeversion 1.0, in {{Codepath|htdocs/lib}}. Sie enthält z.B. Funktionen für Datenbankzugriff, Login, Menüs, geographische Berechnungen und ein einfaches Template-System.

lib1 ist veraltet und wird auf OC.de nur noch für das Bearbeiten von Logs und Cachebeschschreibungen, für Benachrichtigungen über beobachtete und neue Caches und für die XML-Schnittstelle verwendet. Mittelfristig soll sie ganz durch lib2 ersetzt werden. (Alle auf OC.pl-Code basierenden [[Opencaching]]-Seiten verwenden weiterhin ausschließlich die lib1).

lib1 wird eingebunden mit
:<code>require 'lib/common.inc.php'</code>

==== lib2 ====
Die Bibliothek der OC.de-Codversion 2.0 und höher in {{Codepath|htdocs/lib2}}, Nachfolger von lib1. Sie ist wesentlich umfangreicher. Der Code ist aufgeteilt in das "Framework" mit allgemeinen Dingen wie Datenbankzugriff, Authentifizierung, Lokalisierung, Templates etc. und die sogenannte "Business Logic" in {{Codepath|htdocs/lib2/logic}} mit allen Geocaching-spezifischen Klassen und Funktionen.

lib2 wird in Bestandteile der Website eingebunden mit
:<code>require 'lib2/web.inc.php'</code>
und in Kommandozeilentools mit
:<code>require 'lib2/cli.inc.php'</code>

;gemeinsamer lib1- und lib2-Code
Manche Bibliotheksmodule werden versionsübergreifend verwendet, z.B. für Übersetzungen und Sprachauswahl. Sie sind in {{Codepath|htdocs/lib2}} abgelegt.

==== libse ====
Eine Klassenbibliothek von Opencaching.se, in {{Codepath|htdocs/libse}}. Im Zuge der Codezusammenführung von OC.de und OC.se wurde sie 2011 mit in den OC.de-Code übernommen. Sie wird für zusätzliche Wegpunkte und persönliche Notizen im Cachelisting verwendet.

==== Autoload ====
Für die Klassen aller drei Bibliotheken sind Autoloader installiert. Das heißt wenn man z.B. ein Cache-Objekt benötigt, muss man dafür nicht {{Codepath2|htdocs|lib2/logic/cache.class.php}} einbinden sondern man erzeugt einfach direkt das Objekt:
:<code>$cache = new cache();</code>
{{Codepath2|htdocs/lib2/logic|cache.class.php}} wird dann automatisch geladen.

=== Fremdbibliotheken ===

Die OC-Software macht ausgiebig Gebrauch von fertigen PHP- und JavaScript-Codebibliotheken. Eine vollständige Aufstellung incl. Codepfade, Bezugsquellen etc. enthält {{Codepath|doc/license.txt}}. Hier seien nur die wichtigsten davon erwähnt:

<div class="widelist">
* [http://www.smarty.net/ '''Smarty'''] wird als "Template-Engine" für lib2 verwendet. OC-spezifische Erweiterungen befinden sich in der Klasse ''OcSmarty'' und in {{Codepath2|htdocs|lib2/smarty/ocplugins}}. Mehr dazu im Abschnitt [[#Templates|Templates]].

* '''[http://htmlpurifier.org/ HTML Purifier]''' dient zum "Säubern" von HTML-Code, den der Benutzer z.B. in Cachebeschreibungen eingeben kann. lib1 und lib2 verwenden getrennte HTML-Purifier-Installationen. In lib2 wird er über die Klasse ''OcHTMLPurifier'' eingebunden und kann dort auch angepasst werden.

* '''[http://www.tinymce.com/ TinyMCE]''' ist ein leistungsfähiger JavaScript-Wysiwyg-Texteditor. Er dient zum Bearbeiten von Cachebeschreibungen, Logs und Profiltexten. lib1 und lib2 verwenden beide die TinyMCE-Installation in {{Codepath|htdocs/resource2/tinymce}}. OC-spezifische Konfigurationsdaten gibt es in {{Codepath2|htdocs/resource2|tinymce/config}}.

Von lib2-Code verwendete Bibliotheken sind in {{Codepath|htdocs/lib2}} (PHP) und {{Codepath|htdocs/resource2}} (JavaScript) angelegt. Bibliotheken für lib1 befinden sich an verschiedenen Stellen.

</div>

== Konfigurationsdateien ==

==== lib1-Konfiguration ====

Die Einstellungen für lib1-Code befinden sich überwiegend in
:''htdocs/lib/settings.inc.php''
Diese Datei ist nur lokal vorhanden. Als Vorlage für das Aufsetzen einer neuen Produktiv-Installation gibt es die Datei {{Codepath2|htdocs/lib|settings-dist.inc.php}}, die nach ''settings.inc.php'' zu kopieren und anzupassen ist.

Für [[Entwicklung/Entwicklersystem|Entwicklersysteme]] gibt es entsprechend die Vorlage {{Codepath2|htdocs/lib|settings-sample-dev.inc.php}}. Sie verwendet die Datei {{Codepath2|htdocs/lib|settings-dev.inc.php}}, in der die Grundeinstellungen für Entwicklersysteme zusammengefasst sind.

Daneben gibt es noch zwei Konfigurationsdateien ''settings.inc.php'' für die Benachrichtigungs-Cronjobs, in {{Codepath|htdocs/util/notification}} und {{Codepath|htdocs/util/watchlist}}.

Weiterhin verwendet lib1 auch Teile der lib2-Konfiguration, insbesondere {{Codepath2|htdocs/config2|locale.inc.php}}.

==== lib2-Konfiguration ====

Die lib2-Einstellungen befinden sich alle in {{Codepath|htdocs/config2}}. Sie werden ''alle'' in folgender Reihenfolge eingebunden, sobald man {{Codepath2|htdocs/lib2|web.inc.php}} oder {{Codepath2|htdocs/lib2|cli.inc.php}} einbindet:

* sprachabhängige Einstellungen: {{Codepath2|htdocs/config2|locale.inc.php}}
* sonstige Default-Einstellungen: {{Codepath2|htdocs/config2|settings-dist.inc.php}}
* lokale Einstellungen: ''settings.inc.php''

Auch hier sind Vorlagen für Produktiv- ({{Codepath2|htdocs/config2|settings-sample.inc.php}}) und Entwicklersystem ({{Codepath2|htdocs/config2|settings-sample-dev.inc.php}}) vorhanden, die nach ''settings.inc.php'' zu kopieren und and die lokale Systeminstallation anzupassen sind.

==== Der Rootpath ====

Wenn man in PHP-Scripte mit <code>include</code> oder <code>require</code> weitere Dateien einbindet, geschieht dies relativ zum Verzeichnispfad des Hauptscripts. (Daneben kann man auch weitere Pfade festlegen, in denen PHP nach passenden Scripten sucht.)

Wie unter [[#Hauptmodule|Hauptmodule]] erläutert, befinden sich die Module der OC-Software auf verschiedenen Verzeichnisebenen Die Startseite liegt z.B. in {{Codepath|htdocs}}, das lib2-Cronjob-Modul dagegen in {{Codepath|htdocs/util2/cron}}. Alle diese Module binden lib1- oder lib2-Bibliothekscode ein, der weitere Unterscripte einbindet. Damit das alles funktioniert, wird im OC-Code ein ''Basispfad'' für alle Includes festgelegt. Dieser heißt
:<code>$opt['rootpath']</code>
in lib2 und
:<code>$rootpath</code>
in lib1.

Sofern man keine weiteren Vorkehrungen trifft, wird dieser Rootpath automatisch als Relativpfad "./" gesetzt. Scripte in Unterverzeichnissen müssen ihn dagegen selbst setzen, z.B. "../" wenn das Script eine Ebene tiefer liegt, oder absolut als <code>dirname(__FILE__).'../'</code>, wenn nicht bekannt ist, aus welchem aktuellen Verzeichnis ein Kommandozeilentool aufgerufen wird.

== Konstanten ==

Globale Konstanten sind an folgenden Stellen definiert:

* {{Codepath|htdocs/lib/consts.inc.php}}
* {{Codepath|htdocs/lib2/const.inc.php}}
* {{Codepath|htdocs/lib2/error.inc.php}}
* {{Codepath|htdocs/lib2/logic/const.inc.php}}

Die lib2-Konstanten werden auch teilweise auch in lib1-Code verwendet.

== Datenbank ==

Die OC-Software ist nur für die Verwendung von MySQL ausgelegt. Zwar werden in lib2 keine MySQL-Funktionen mehr direkt aufgerufen, aber zahlreiche SQL-Statements verlassen sich auf MySQL-Syntax.

=== Grundlegende Datenbankfunktionen ===

Für lib2 befinden sich alle Funktionen in {{Codepath2|htdocs|lib2/db.inc.php}} und sind dort kurz dokumentiert, für lib1 in {{Codepath2|htdocs|lib/clicompatbase.inc.php}}. Datenbankverbindungen werden automatisch entsprechend den Konfigurationseinstellungen hergestellt, sobald man eine Query absetzt.

Die wichtigsten Funktionen seien hier anhand von Beispielen erläutert:

sql("UPDATE `caches` SET `size`='&1' WHERE `cache_id`='&2'",
$newsize, $cacheid);

Hier wird die Größe eines Caches geändert. Variablen werden als fortlaufend numerierte Platzhalter &1, &2 etc. übergeben. Die Funktion ''sql'' ruft dann intern für jede Variable <code>mysql_real_escape_string()</code> auf, was spezielle Zeichen wie " codiert und gleichzeitig [[wikipedia:SQL-Injection|SQL-Injections]] verhindert.

'''Niemals dürfen Variablen direkt in SQL-Statements eingebaut werden!''' Wann immer möglich sind Platzhalter zu verwenden. Notfalls kann auch direkt mit <code>sql_escape()</code> codiert werden, was allerdings Probleme verursacht, wenn ein "&" in den Daten enthalten ist: Die Funktion <code>sql()</code> interpretiert es anschließend als Startzeichen eines Platzhalters.

$cachesize = sql_value("
SELECT `size` FROM `caches`
WHERE `cache_id`='&1'",
null, $cacheid);

Hier wird die Größe eines Caches abgefragt. Falls die Cache-ID nicht gefunden wird, wird der Defaultwert ''null'' zurückgeliefert. Denke immer daran, den Defaultwert als ersten Parameter anzugeben! Ihn zu vergessen ist eine häufige Fehlerquelle.

In der lib1 heißt die Funktion anders und kann nicht mit Platzhaltern umgehen; der entsprechende Code lautet dann:

$cachesize = sqlValue("
SELECT `size` FROM `caches`
WHERE `cache_id`='" . sql_escape($cacheid) . "'",
null);

Das folgende Beispiel demonstriert, wie der Inhalt einer Tabelle ausgelesen wird:

$rs = sql("
SELECT `cache_id`, `name`, `type` `size` FROM `caches`
WHERE `cache_id`='&1'",
$cacheid);
while ($r = sql_fetch_assoc($rs))
{
// ... Weiterverarbeitung von $r['cache_id'], $r['name'] etc.
}
sql_free_result($rs);

=== Slave-Server ===

Beide OC-Libraries sehen eine Lastverteilung auf einen Haupt-Datebankserver (Master) und einen oder mehrere "Slaves" vor, die replizierte Daten des Masters enthalten; siehe {{Codepath|doc/replication.txt}}. Dazu gibt es SQL-Funktionen mit dem Zusatz "_slave", z.B. <code>sql_slave()</code>, die von "datenbankintensiven" Programmmodulen wie z.B. der Suche ({{Codepath2|htdocs|search.php}}) anstatt der Basisfunktionen verwendet werden.

Wenn per ''settings.inc.php'' keine Slave-Server konfiguriert sind, laufen alle Zugriffe über den Master. Zurzeit betreibt kein Opencaching-Knoten Slave-Server; die Kapazität des Masters reicht überall aus.

=== Temporärtabellen ===

Da Subqueries bei MySQL recht ineffizient sind, sind manchmal temporäre Tabellen für Zwischenergebnisse nötig.

lib2 sieht einen speziellen Mechanismus zur Verwaltung von Temporärtabellen vor. Sie werden in einer eigenen Datenbank abgelegt, für die erweiterte Zugriffsrechte (Tabellen anlegen/löschen) vergeben werden, und werden per Cronjob automatisch aufgeräumt, wenn sie nicht gleich wieder gelöscht wurden.

Ein (nicht unbedingt sinnvolles) Beispiel für die Verwendung von lib2-Temporärtabellen. Die temporäre Tabelle heißt "tmp_caches" und wird in SQL-Statements über einen Platzhalter referenziert:

sql_temp_table('tmp_caches'); // Tabelle registrieren
sql(" // Tabelle anlegen
CREATE TEMPORARY TABLE &tmp_caches ENGINE=MEMORY
SELECT `cache_id` FROM `caches`
WHERE `user`.`user_id` = `caches`.`user_id`
AND `user`.`country` = '&1'",
$country);

$rs = sql(" // Tabelle auslesen
SELECT * FROM `cache_desc`, &tmp_caches
WHERE `cache_desc`.`cache_id` = &tmp_caches.`cache_id`");
// ... Daten weiterverarbeiten
sql_free_result($rs);

sql_drop_temp_table('tmp_caches'); // Tabelle löschen

=== Datenbankstruktur; statische Daten ===

Datenbankstruktur und -inhalte werden an folgenden Stellen unter {{Codepath|htdocs/doc/sql}} definiert:

* Tabellen, Felder und Indizes in {{Codepath2|htdocs/doc/sql|tables}}
* Stored Functions, Procedures und Triger in {{Codepath2|htdocs/doc/sql|stored-proc}}
* statische Daten wie z.B. Menüs, Cachetypen und sprachabhängige Texte in {{Codepath2|htdocs/doc/sql|static-data/data.sql}}.

Es gibt weitere (geographische) "statische Daten", die aufgrund ihres Umfangs nicht im Git-Repository enthalten sind; siehe {{Codepath2|htdocs/doc/sql|static-data/static-data.txt}}. Für Entwickler steht auf Anfrage ein Datenbankdump zur Verfügung, der eine vollständig initialisierte OC-Datenbank enthält (Veröffentlichung ist geplant). Weitere Updates können dann per
:{{Codepath|bin/dbupdate.php}}
eingepflegt werden, also man muss die oben aufgelisteten Dateien nicht von Hand weiterverarbeiten.

Siehe auch: [[Entwicklung/Datenbankversionierung|Datenbankversionierung]]

==== OKAPI ====

Die [[OKAPI]]-Tabellen werden zwar in der gleichen Datenbank abgelegt, sind aber unabhängig von den OC-Tabellen und daher ''nicht'' in {{Codepath|htdocs/doc/sql}} definiert. Bei [http://code.google.com/p/opencaching-api/#Installation_/_Update_Instructions Installation der OKAPI] werden sie automatisch angelegt und bei OKAPI-Updates automatisch aktualisiert. {{Codepath2|bin|dbupdate.php}} führt auch OKAPI-Updates durch, falls die OKAPI installiert ist.

Auch der OKAPI-''Code'' ist unabhängig vom OC-Code, d.h. sämtliche Datenbankzugriffe sind dort redundant implementiert. '''Bei Änderungen an Datenstrukturen oder -inhalten ist daher immer zu prüfen, ob eine Anpassung der OKAPI nötig ist!'''

=== Trigger & Stored Procedures ===

Der Opencaching-Code macht reichlich Gebrauch von gespeicherten Datenbank-Funktionen und Triggern. Sie werden dazu eingesetzt, um die Konsistenz der Datenbankinhalte zu gewährleisten. Vor dem Hintergrund, dass drei unabhängige Frameworks parallel auf die Datenbank zugreifen – lib1, lib2 und OKAPI (und manchmal noch ein Administrator von Hand) – ist diese Vorgehensweise ratsam. Sie macht die OC.de-Datenbank ausgesprochen robust.

Alle Datenbankfunktionen sind in
:{{Codepath|htdocs/doc/sql/stored-proc}}
definiert. Der aktuelle Stand befinden sich in {{Codepath2|htdocs/doc/sql/stored-proc|maintain-current.inc.php}}; für die [[Entwicklung/Datenbankversionierung|Datenbankversionierung]] können zusätzliche ältere Stände bzw. Update-Scripte existieren.

Der Inhalt des ''maintain''-Scripts lässt sich grob untergliedern in
* allgemeine Funktionen für komplexe Berechnungen, z.B. <code>DECTOWP</code> für die Berechnung neuer OC-Wegpunkte
* Update-Funktionen für bestimmte Felder (<code>sp_update_*</code>) die entweder von verschiedenen Triggern aufgerufen werden oder zur Datenbankwartung aus {{Codepath2|htdocs|dbmaint.php}} (Menü Admin|Datenbankwartung)
* Trigger-Prozeduren

Eine Besonderheit sind '''globale Variablen''' die zur Parameterübergabe von PHP-Scripten an Datenbankfunktionen oder zwischen Datenbankfunktionen verwendet werden. Sie sind in {{Codepath2|htdocs/doc/sql/stored-proc|maintain-current.inc.php}} erläutert.

=== SQL-Debugger ===

lib1 und lib2 enthalten einen nützlichen SQL-Debugger ({{Codepath2|htdocs|lib/sqldebugger.inc.php}} bzw. {{Codepath2|htdocs|lib2/sqldebugger.class.php}}). Er zeigt für jedes ausgeführte SQL-Statment

* das Statement selbst,
* ein [http://dev.mysql.com/doc/refman/5.1-olh/de/using-explain.html EXPLAIN],
* die ersten zurückgelieferten Datensätze, falls vorhanden,
* die Ausführungszeit,
* eventuelle MySQL-Warnungen.

Der SQL-Debugger muss in den [[#Konfigurationsdateien|Settings]] aktiviert sein – für lib1 per <code>$sql_debug = true</code>, in lib2 durch Setzen des Flags <code>DEBUG_SQLDEBUGGER</code> in <code>$opt['debug']</code>. Wahlweise kann man diese Flags auch nur in einzelnen zu debuggenden PHP-Quelltexten setzen.

Anschließend ist die zu debuggende Seite mit dem URL-Parameter <code>sqldebug=1</code> aufzurufen.

== Temporärdaten und Inhalte im Dateisystem ==

Manche Dinge werden in Dateien statt in der Datenbank abgelegt.

<div class="mediumlist">
* '''Hochgeladene Bilder''' befinden sich üblicherweise in {{Codepath|htdocs/images/uploads}} (in den Settings änderbar), die Thumbnails darunter in {{Codepath2|htdocs/images/uploads|thumbs}}. Generierte Statistikbilder werden in {{Codepath|htdocs/images/statpics}} abgelegt.
* Herunterzuladende, gepackte '''Ausgaben der [[XML-Schnittstelle]]''' werden in {{Codepath|htdocs/download/zip}} zwischengespeichert (ebenfalls konfigurierbar).
* {{Codepath|htdocs/cache2}} enthält zwischengespeicherte [[#Templates|Templates]], [[#Übersetzung|Übersetzungsdateien]] für gettext und verschiedene Temporärdaten. Ein guter Teil dieser Daten wird von {{Codepath|bin/clear-webcache.php}} neu generiert.
* {{Codepath|htdocs/var}} enthält zwischengespeicherte OKAPI-Daten (die OKAPI legt allerdings auch eine Menge "gecachete" in der Datenbank ab) und Fehlerprotokolle.
* {{Codepath|htdocs/cache}} enthält vermutlich nur noch temporäre Prozess-Synchronisationsdateien (.pid-Dateien) der lib1-cronjobs für Log- und Cache-Benachrichtigungen.
</div>

== Templates ==

[[wikipedia:Template (Programmierung)|Templates]] dienen in Webanwendungen dazu, die Generierung von aus- und einzugebenden Daten von deren HTML-Darstellung zu trennen. HTML- und JavaScript-Code wird komplett in den Template-Dateien untergebracht, PHP-Code soweit wie irgend möglich in PHP-Scripten.

Die Einbindung der Templates in den PHP-Programmablauf geschieht wie folgt:
# Festlegung, welche Templatedatei verwendet wird
# Zuweisung von variablen Inhalten an das Template
# Darstellung des Templates
Für alle drei Punkte gibt es entsprechende Bibliotheksfunktionen.

=== lib1-Templates ===

Die alte Library enthält ein selbstgemachtes, simples Templatesystem. Die Templatedateien befinden sich in {{Codepath|htdocs/lang/de/ocstyle}} und enthalten den auszugebenden HTML- und JavaScript-Code. Der Name der Template-Datei wird im PHP-Code über die globale Variable <code>$tplname</code> festgelegt, z.B.
:<code>$tplname = 'newcache';</code>

Für alle variablen Inhalte werden im Template Platzhalter wie z.B. <code>{cachename}</code> verwendet; die PHP-Variable wird dann übergeben mit

:<code>tpl_set_var('cachename', $cachename);</code>

Sofern der variable Teil auch HTML-Code oder etwas zu Übersetzendes enthält, wird dies in speziellen Include-Dateien abgelegt, z.B.

$cachelink = '<a href="viewcache.php?cacheid={cacheid}">{cachename}</a>';
$outputformat_notexist = t('The selected output format is unknown!');

Die Include-Datei wird im PHP-Hauptmodul eingebunden und die Variablen per <code>mb_ereg_replace</code> ersetzt, bevor das Ganze per <code>tpl_set_var()</code> ans Template übergeben wird.

:<code>tpl_BuildTemplate();</code>
stellt schließlich das Template dar und beendet das PHP-Script.

Alle [[Opencaching]]-Seiten außer OC.de und OC.se/no verwenden noch das lib1-Templatesystem.

=== lib2-Templates (Smarty) ===

==== Grundlagen ====

Die neue Bibliothek verwendet die leistungsfähige [[wikipedia:Smarty|Smarty]]-Engine. Smarty-Templates bestehen neben dem HTML/JavaScript-Code im Wesentlichen aus Kontrollstrukturen und Variableneinbindungen. Die Templates sind in {{Codepath|htdocs/templates2/ocstyle}} abgelegt.

Die lib2 definiert die globale Variable
:<code>$tpl</code>
über die alle Zugriffe auf Smarty und die Templates laufen. Am Beginn des PHP-Moduls wird jeweils das Template initialisiert:

$tpl->name = 'newemail'; // Name der Template-Datei
$tpl->menuitem = MNU_MYPROFILE_DATA; // Menü-ID, siehe doc/sql/static-data/data.sql
$tpl->caching = false; // nicht zwischenspeichern

Der ''caching''-Parameter legt fest, ob das Ergebnis der Templateausgabe zwischengespeichert wird; die Dauer der Zwischenspeicherung ist dann ggf. per
$tpl->caching_lifetime = 1800; // halbe Stunde Caching
festzulegen. Dies empfiehlt sich bei häufig aufgerufenen, rechenintensiven Seiten. Seiten mit ständig wechselndem bzw. benutzerabhängigem Inhalt dürfen '''nicht''' "gecacht" werden!

Neben Caching der Template-''Ausgaben'' gibt es auch eine ''Vorcompilierung'' der Templates selbst. Diese erfolgt
* einmalig für alle Templates per <code>bin/clear-webcache.php</code>,
* automatisch, wenn ein geändertes Template abgerufen wird,
* jedesmal bei jedem Template-Aufruf, falls in den Settings der Debug-Schalter <code>DEBUG_TEMPLATES</code> gesetzt ist.

Die zwischengespeicherten Templates werden in <code>htdocs/cache2/smarty</code> abgelegt.

Auf die Initialisierung des Templates folgen Variablen-Zuweisungen (s.u.) und schließlich die Darstellung mit
:<code>$tpl->display();</code>
die das PHP-Script beendet.

;Smarty-Syntax

Im Folgenden sind ein paar grundlegende Smarty-Elemente erklärt; ansonsten sei auf die [http://www.smarty.net/docsv2/de/ Smarty-Dokumentation] verwiesen und auf die vielen Bespiele in {{Codepath2|htdocs|templates2/ocstyle}}. (Achtung: Der OC-Code verwendet eine ältere Smarty-Version; nicht alles was in der Doku steht ist hier auch schon verfügbar!)

Alle Smarty-Elemente stehen in geschweiften Klammern {}. Wenn das Template solche Klammern für andere Zwecke verwendet, z.B. für JavaScript-Kontrollstrukturen, müssen diese von der Smarty-Interpretation ausgeklammert werden:

{literal}
function js_function()
{
...
}
{/literal}

==== Variablen ====

Variablen werden z.B. per
:<code>$tpl->assign('cachename', $cache['name']);</code>
an das Template übergeben und dort als
:<code>{$cachename}</code>
verwendet. Es können auch Arrays übergeben werden, deren Elemente statt [] mit einem Punkt referenziert werden.
:<code>{$cache.name}</code>
steht z.B. für <code>$caches['name']</code>, übergeben per <code>$tpl->assign('caches', ...)</code>. Dies funktioniert auch mit numerischen Indizes – z.B. <code>{$user.0}</code> für das erste Element eines $user-Arrays – und mit mehr als zwei Ebenen.

Auch simple Berechnung sind möglich, z.B. <code>{$waylength*2}</code>.

Zusätzlich zu dem vom PHP-Code übergebenen Variablen kann man auch eigene definieren, z.B.
:<code>{assign var=counter value=1}</code>
Mit <code>{capture}</code> lassen sich u.U. auch komplexere Ausdrücke in einer Variable unterbringen.

==== Kontrollstrukturen ====

Bedingte Einbindung von Template-Komponenten ist mit <code>{if} … {elseif} … {else} … {/if}</code>-Anweisungen möglich. Dabei können auch komplexere PHP-Ausdrucke verwendet werden, die als Boolean ausgewertet werden:

{if $show_statistics && ($statdata|@count > 0)}
... Statistik ausgeben ...
{/if}

(@count ist eine [[#Benutzerdefinierte Erweiterungen; Übersetzungen|benutzerdefinierte Funktion]])

Eine weiter häufig verwendete Struktur ist <code>{foreach}</code> zum iterieren von Arrayelementen:

{foreach from=$caches item=cache}
<td>{$cache.name|escape}</td>
{/foreach}

<code>|escape</code> ist ein ''Modifizierer'', der den Variableninhalt weiterverarbeitet. In diesem Fall werden HTML-Entitäten "escaped".

Mit <code>{strip}...{/strip}</code> lassen sich alle Whitespaces (Leerzeichen, Tabs, Zeilenumbrüche) in einem Abschnitt herausfiltern, was die auszugebende Datenbank reduziert. Aber Vorsicht, falls Whitespaces als Trennzeichen in Ausgaben benötigt werden!

==== Benutzerdefinierte Erweiterungen ====

Smarty lässt sich um eigene
* Elemente ("Blocks"),
* Modifizierer und
* Funktionen
erweitern. Der Opencaching-Code enthält eine Reihe solcher eigener Erweiterungen in {{Codepath2|htdocs|lib2/smarty/ocplugins}}.

Die wichtigste Erweiterung ist das <code>{t}</code>-Element zum Übersetzen von Texten. Alle Texte in den Templates werden in Englisch geschrieben und in <code>{t} ... {/t}</code> eingeschlossen; sie werden dadurch automatisch dem Übersetzungssystem zugeführt. Mehr dazu im Kapitel [[#Übersetzungen|Übersetzungen]].

=== Systemtemplate und Menüsystem ===

Was oben über einzelne Templates geschrieben wurde betrifft nur den Teil der Seite, der im ''Content-Container'' dargestellt wird – also dem Teil unterhalb und rechts des Menüsystems und oberhalb der Fußzeile. Alles "drumherum" wird vom ''Systemtemplate'' erzeugt.

Folgende Codedateien sind daran in der lib1 beteiligt ...
* Systemtemplate: {{Codepath2|htdocs|lang/de/ocstyle/main.tpl.php}}
* Menüdefinitionen: {{Codepath2|htdocs|lang/de/ocstyle/lib/menu.php}}
* PHP-Framework: {{Codepath2|htdocs|lib/common.inc.php}} → tpl_BuildTemplate()
... und in der lib2:
* Systemtemplate: {{Codepath2|htdocs|templates2/ocstyle/sys_main.tpl}}
* Menüsystem: Tabelle 'sys_menu' per {{Codepath2|htdocs|doc/sql/static-data/data.sql}}, {{Codepath2|htdocs|lib2/menu.class.php}}
* PHP-Framework: {{Codepath2|htdocs|lib2/OcSmarty.class.php}}

Zusätzliche Hauptmenü-Punkte sind via [[#Konfigurationsdateien|Konfigurationsdateien]] erzeugbar.

=== Email-Templates ===

Auch der Inhalt (''body'') von Emails wird über Templates erzeugt.

lib1-Email-Templates befinden sich in {{Codepath|htdocs/lang/de/ocstyle/email}}, {{Codepath|htdocs/util/notification}} und {{Codepath|htdocs/util/watchlist}} und werden von den entsprechenden PHP-Modulen direkt per <code>mb_ereg_replace()</code> aufgelöst.

lib2-Email-Templates liegen in {{Codepath|htdocs/templates2/mail}} und werden von <code>mail.class.php</code> per Smarty verarbeitet.

=== OKAPI ===
Die OKAPI hat ein eigenes Templatesystem; mehr dazu im Abschnitt [[#OKAPI|OKAPI]].

== CSS Style Sheets ==
Die Style Sheets befinden sich in {{Codepath|htdocs/resource2/ocstyle/css}}.

== Grafiken ==

Grafiken für Icons und andere Dinge verteilen sich – soweit es keine Drittbibliotheken betrifft – über drei Verzeichnisse:

* {{Codepath|htdocs/images}} (lib1 und lib2)
* {{Codepath|htdocs/lang/de/ocstyle/images}} (lib1)
* {{Codepath|htdocs/resource2/ocstyle/images}} (lib2)

Hier herrscht etwas Chaos. Manches ist mehrfach vorhanden - auch innerhalb ''einer'' Library - oder inkonsistent abgelegt, die Dateitypen wechseln zwischen GIF und PNG. Glattziehen lässt sich das kaum, weil Grafiken auch gerne von anderer Stelle aus verlinkt werden, z.B. aus Cachelistings - teils sogar von anderen Plattformen aus. Schiebt man die Grafiken einfach weg oder ändert das Format, zerstört es unbemerkt Cachebeschreibungen.

Zur Kompatibilität mit alten Cachebeschreibungen und Logs liegen in folgenden Verzeichnissen Grafiken, die anderweitig nicht mehr verwendet werden:

* {{Codepath|htdocs/lang/de/stdstyle/images}}
* {{Codepath|htdocs/lib/tinymce/plugins/emotions/images}}
* {{Codepath|htdocs/resource2/stdstyle/images}}

== Übersetzung ==

Der OC-Code ist mehrsprachig und frei übersetzbar, mit Ausnahme
* der Benachrichtigungs-Emails, die es bislang nur in Deutsch gibt (-> http://redmine.opencaching.de/issues/141)
* des Garmin-Download-Dialogs ({{Codepath2|htdocs|garmin.php}}), dessen untere Hälfte es nur in Deutsch und Englisch gibt (siehe {{Codepath|htdocs/resource2/ocstyle/js/GarminDisplay.js}})
(weitere noch nicht lokalisierbare Module bitte ergänzen!)

Die Lokalisierung je nach gewählter Sprache erfolgt grundsätzlich mit folgenden Mechanismen:
* In Templates über die Smarty-Tags <code>{t}English Text{/t}</code>. Hierbei können auch Variablen eingesetzt werden, z.B.
*:<code>{t 1=$cachename 2=$username}The geocache %1 has been found by %2{/t}</code>
* Notfalls direkt im PHP-Code durch Aufruf von <code>$translate->t()</code>, z.B.
*:<code>$text = $translate->t('New password code', <nowiki>''</nowiki>, basename(__FILE__), __LINE__)</code>
* Bei Artikelseiten, die via {{Codepath|htdocs/articles.php}} dargestellt werden, per Ablage der Templates in Unterverzeichnissen von {{Codepath|htdocs/templates2/ocstyle/articles}}.

Das Übersetzungssystem arbeitet intern mit <code>gettext()</code>. Die Strings dafür befinden sich in der Tabellen ''sys_trans'' und ''sys_trans_text''. Man kann sie direkt via {{Codepath2|htdocs/doc/sql/static-data|data.sql}} einpflegen, oder mit dem "Schnellübersetzungsmodus" + "SQL-Export" von {{Codepath2|htdocs|translate.php}} (Menü Admin|Übersetzung). Letzteres kann allerdings jede Menge Git-Merge-Konflikte beim Zusammenführen verschiedener Branches erzeugen, daher werden OC.de-Übersetzungen derzeit nur direkt in {{Codepath2|htdocs/doc/sql/static-data|data.sql}} eingepflegt.

Achtung: '''Auch für die englische Seitendarstellung läuft nochmal alles durch den Übersetzer''', Artikel ausgenommen. Die englischen Originaltexte in den Templates oder im PHP-Code sind also nur eine Basis für die weitere Übersetzung. Kleinere Fehler dort müssen nicht korrigiert werden, solange die Texte verständlich sind. ''Wenn'' dort etwas korrigiert wird, muss es gleichzeitig auch in der Tabelle ''sys_trans'' in {{Codepath2|htdocs/doc/sql/static-data|data.sql}} geändert werden!

Opencaching.de gibt es zurzeit in Deutsch, Englisch, Italienisch und Spanisch. Die Übersetzungen werden durch den von Opencaching Deutschland eingesetzten Code Maintainer organisiert.

== Fehlerbehandlung ==

Der OC-Code verwendet kein Exception Handling (mit Ausnahme der OKAPI). Wenn etwas fehlschlägt, wird dies durch den Rückgabewert der betreffenden Funktion signalisiert und entsprechend reagiert. Würde man den betroffenen Funktionen noch einen Namenszusatz spendieren, der die mögliche Fehlerrückgabe kennzeichnet, wäre dieses System transparenter und in sich weniger fehleranfällig als ein strukturiertes Exception Handling.

==== fehlerhafte Benutzereingaben ====
Wenn es Probleme mit einer Benutzereingabe gibt, wird das betreffende Template nochmals angezeigt und an passender Stelle eine mit dem CSS-Stil <code>errormsg</code> formatierte Meldung eingeblendet. Dies ist jeweils entsprechend zu implementieren.

==== erkanntes Problem ====
Wenn anderweitig ein nicht handhhabbares Problem erkannt wird, wird das Fehlertemplate angezeigt. In '''lib1''' befindet sich dies in {{Codepath2|htdocs|lang/de/ocstyle/error.tpl.php}} und wird aufgerufen per
:<code>tpl_errorMsg('original_templatename', $fehlermeldung);</code>
z.B.
$error_desc_not_found = t('(internal error) The description is not available.');
...
tpl_errorMsg('editdesc', $error_desc_not_found);

Das '''lib2'''-Fehlertemplate befindet sich in bzw. {{Codepath2|htdocs|templates2/ocstyle/error.tpl}} und wird verwendet mit
:<code>$tpl->error(Fehlernummer)</code>
oder
:<code>$tpl->error($fehlermeldung);</code>
Die Fehlernummern sind in {{Codepath2|htdocs|lib2/error.inc.php}} definiert.

; SQL-Fehler

Bei MySQL-Fehlern wird ein Fehlertemplate anzeigt und eine Admin-Email versandt, sofern in den [[#Konfigurationsdateien|Settings]] eine Mailadresse hinterlegt ist. In der lib1 ist sie in
:<code>$sql_errormail</code>
einzutragen, in der lib2 in
:<code>$opt['db']['error']['mail']</code>.
Entwicklersysteme werden so konfiguriert, dass das komplette SQL-Statement auch direkt angezeigt wird.

Zusätzlich kann man per <code>$sql_warntime</code> (lib1) bzw. <code>$opt['db']['warn']['time']</code> (lib2) eine Warnschwelle für zu lange SQL-Ausführungszeiten festlegen. Bei Überschreitung werden dann Admin-Mails erzeugt.

==== unerkanntes Problem ====

{{Codepath2|htdocs|lib2/errorhandler.inc.php}} enthält ein noch in der Testphase befindlichen Handler für PHP-Fehler, der auch in lib1 eingebunden ist. Er wird bei PHP-Fehlern aktiv, die (abhängig von der ''error_reporting''-Einstellung in der PHP-Konfiguration) zu einem Abbruch des Scripts führen. Es wird dann eine Fehlermeldung anzeigt und ggf. eine Admin-Mail erzeugt. Es wird die gleiche Emailkonfiguration wie für bei SQL-Problemen (s.o.) verwendet.

Dieser PHP-Errorhandler ist derzeit nur aktiviert, wenn in der Konfiguration der Debug-Modus eingeschaltet ist. Ansonsten erscheint bei Fehlern eine leere Seite.

== OKAPI ==

Die Opencaching-API ist ein eigenständiges PHP-Projekt, dessen Code auf verschiedenen OC-Seiten zum Einsatz kommt. Die Projekt-Homepage ist http://code.google.com/p/opencaching-api/. Beiträge, die nicht vom Code-Maintainer selbst kommen, werden üblicherweise in Branches hochgeladen und laufen dann durch ein Code Review.

Die OKAPI wird – erfolgreich! – mit einem wesentlich höheren Anspruch an Codequalität und -Stil entwickelt als die OC-Länderseiten. Dokumentation und Codestruktur sind herausragend. Gleichzeitig steht sie bei einigen Details wie Template-Engine, Datenbank-Library und Konstanten-Definitionen hinter dem OC.de-Code zurück. Der OKAPI-Code ist nur für Webanwendungen geschrieben; Einbindung in Kommandozeilentools kann insbesondere am Exception-Handling scheitern.

Der OKAPI-Code wird aus dem OKAPI-Projekt in die lokalen OC-Code-Repositories (nach {{Codepath|htdocs/okapi}}) repliziert. Bei Opencaching.pl und .nl geschieht dies automatisch über einen SVN-"Commit-Hook", bei Opencaching.de manuell durch den Code-Maintainer nach einem Security Review.

OKAPI-Code kann über die "Facade"-Schnittstelle in OC-Code eingebunden werden ({{Codepath2|htdocs|okapi/facade.php}}). OC.pl macht davon insbesondere bei der Karte Gebrauch, die von der OKAPI generiert wird. OC.de verwendet die Facade bislang nur (experimentell) im Update-Script {{Codepath|bin/okapi-update.php}}, das von {{Codepath2|bin|dbupdate.php}} aufgerufen wird.

Sämtliche OKAPI-Seitenzugriffe laufen über eine Rewrite-Engine ({{Codepath2|htdocs|okapi/.htaccess}} → {{Codepath2|htdocs|okapi/controller.php}}). Man kann daher die PHP-Scripte nicht direkt über ihre URLs idenitifizieren sondern muss schonmal etwas suchen. Methoden befinden sich in {{Codepath2|htdocs|okapi/services}}, Seiten mit HTML-Output in {{Codepath2|htdocs|okapi/views}}.

Für die Dokumentation verwendet die OKAPI ein eigenes XML-Format, das von einem Parser aufbereitet wird.

Templates für Methoden, die HTML- oder sonstiges XML-Output liefern, sind in .tpl.php-Dateien zusammen mit den PHP-Quelltexten abgelegt. Variablen werden per PHP-Code eingebunden, meist per "short open tags", z.B.

<? if (($vars['my_notes'] == 'desc:text') && ($c['my_notes'] != null)) { /* Does user want us to include personal notes? */ ?>
<p><b><?= _("Personal notes") ?>:</b> <?= Okapi::xmlescape($c['my_notes']) ?></p>
<? } ?>

[[Kategorie:Entwicklung|Codedoku]]

Entwicklung/Codedoku

2014-05-18T07:50:38Z

Dl6hbo: /* Grundlagen */

Dies ist eine Materialsammlung zum [http://github.com/OpencachingDeutschland/oc-server3 Opencaching-Programmcode]. Sie soll neuen [[Entwicklung|Entwicklern]] einen Überblick über die Grundstruktur und wichtigsten Bestandteile des OC-Codes geben. Mit "OC-Code" ist alles gemeint, was sich im [[Entwicklung/Git|Git-Repository]] befindet.

Weitere Dokumentationen gibt es auch in den Codeverzeichnissen {{Codepath|doc}} und {{Codepath|htdocs/doc}}. Die Datei {{Codepath|doc/directories.txt}} enthält eine Übersicht der Repository-Verzeichnisstruktur. ''(Grüne Pfad- und Dateinamen sind anklickbar.)''

Alle die bereits an Opencaching mitprogrammiert haben, sind eingeladen, ihr Wissen beizusteuern! Wenn du dir zusätzliche Erläuterungen wünschst, kannst du sie auf der Diskussionsseite anfragen – vielleicht findet sich jemand, der den Artikel ergänzt.

Siehe auch: [[Entwicklung/Stil|Style Guidelines]]

== Dateiformat ==

Alle OC-Quelltextdateien haben [[wikipedia:UTF-8|UTF-8]]-Format. Im Kopf der Quelltextdateien befindet sich ein japanisches Wort ("Unicode Reminder"), mit dem geprüft werden kann ob die Zeichencodierung intakt ist. Sollte versehentlich nach ISO-8859-1 o.ä. umcodiert worden sein, erscheinen dort z.B. zwei Fragezeichen oder gar nichts.

{{Codepath|local/tools/find_bad_encodings.php}} prüft alle Quelltexte auf fehlende oder beschädigte Unicode Reminder.

Die Zeilenenden der Quelltexte bestehen grundsätzlich aus einem einfachen LF (line feed). Ausnahmen gibt es z.B. bei [[#Email-Templates|Email-Templates]]; hier ist CR/LF vorgeschrieben.

== Hauptmodule ==

Mit "lib1" und "lib2" sind im Folgenden die OC-eigenen Codebibliotheken in {{Codepath|htdocs/lib}} und {{Codepath|htdocs/lib2}} gemeint. Alle Teile des OC-Codes bauen auf einer dieser beiden Bibliotheken auf.

<div class="widelist">
Der OC-Software besteht aus ...
* Den '''darstellbaren Seiten''' der OC-Website, z.B. Startseite (''index'') oder Cachelisting-Anzeige (''viewcache''). Diese bestehen jeweils aus einem PHP-Script im Verzeichnis {{Codepath|htdocs}} und einem [[#Templates|Template]] in {{Codepath|htdocs/templates2/ocstyle}} (lib1: {{Codepath|htdocs/lang/de/ocstyle}}). Das PHP-Script erzeugt die darzustellenden Inhalte, das Template stellt sie als HTML-Seite dar.

* '''Kommandozeilentools''' für verschiedene Zwecke, z.B. Wartungstools die per Crojob oder von Hand aufgerufen werden. Sie befinden sich in an verschiedenen Stellen:
** {{Codepath|bin}} (Update-Scripte)
** {{Codepath|htdocs/util}} (lib1, Tools für Produktivbetrieb)
** {{Codepath|htdocs/util2}} (lib2, Tools für Produktivbetrieb)
** {{Codepath|local}} (spezielle Tools für lokale Verwendung)

* '''APIs''', also Schnittstellen für Datenabruf oder -upload durch Dritte:
** diverse APIs in {{Codepath|htdocs/api}}
** die [[OKAPI]] in {{Codepath|htdocs/okapi}}, repliziert aus dem [http://code.google.com/p/opencaching-api/source/browse/trunk/#trunk%2Fokapi OKAPI-Repository]
** die [[XML-Schnittstelle]] in {{Codepath|htdocs/xml}}
</div>

* '''Apache-Rewrites'''. Dies sind Konfigurationsdateien mit dem Name ''.htaccess'', die vom Apache-Webserver ausgelesen werden. Sie interpretieren die übergebene URL und leiten auf ein PHP-Script um. Apache-Rewrites kommen an zwei Stellen zum Einsatz:
** Statistikbilder: {{Codepath|htdocs/statpics/htaccess-dist|htdocs/statpics/.htaccess}}
** OC-Kurz-URLs, z.B. http://opencaching.de/OC1234: diese sind direkt im Produktiv-Webserver konfiguriert.

== Bibliotheken ==

Die einzelnen OC-Module verwenden verschiedene Code-Bibliotheken:

=== Eigene Bibliotheken ===

==== lib1 ====
Die alte selbstgeschriebene Bibliothek von OC-Codeversion 1.0, in {{Codepath|htdocs/lib}}. Sie enthält z.B. Funktionen für Datenbankzugriff, Login, Menüs, geographische Berechnungen und ein einfaches Template-System.

lib1 ist veraltet und wird auf OC.de nur noch für das Bearbeiten von Logs und Cachebeschschreibungen, für Benachrichtigungen über beobachtete und neue Caches und für die XML-Schnittstelle verwendet. Mittelfristig soll sie ganz durch lib2 ersetzt werden. (Alle auf OC.pl-Code basierenden [[Opencaching]]-Seiten verwenden weiterhin ausschließlich die lib1).

lib1 wird eingebunden mit
:<code>require 'lib/common.inc.php'</code>

==== lib2 ====
Die Bibliothek der OC.de-Codversion 2.0 und höher in {{Codepath|htdocs/lib2}}, Nachfolger von lib1. Sie ist wesentlich umfangreicher. Der Code ist aufgeteilt in das "Framework" mit allgemeinen Dingen wie Datenbankzugriff, Authentifizierung, Lokalisierung, Templates etc. und die sogenannte "Business Logic" in {{Codepath|htdocs/lib2/logic}} mit allen Geocaching-spezifischen Klassen und Funktionen.

lib2 wird in Bestandteile der Website eingebunden mit
:<code>require 'lib2/web.inc.php'</code>
und in Kommandozeilentools mit
:<code>require 'lib2/cli.inc.php'</code>

;gemeinsamer lib1- und lib2-Code
Manche Bibliotheksmodule werden versionsübergreifend verwendet, z.B. für Übersetzungen und Sprachauswahl. Sie sind in {{Codepath|htdocs/lib2}} abgelegt.

==== libse ====
Eine Klassenbibliothek von Opencaching.se, in {{Codepath|htdocs/libse}}. Im Zuge der Codezusammenführung von OC.de und OC.se wurde sie 2011 mit in den OC.de-Code übernommen. Sie wird für zusätzliche Wegpunkte und persönliche Notizen im Cachelisting verwendet.

==== Autoload ====
Für die Klassen aller drei Bibliotheken sind Autoloader installiert. Das heißt wenn man z.B. ein Cache-Objekt benötigt, muss man dafür nicht {{Codepath2|htdocs|lib2/logic/cache.class.php}} einbinden sondern man erzeugt einfach direkt das Objekt:
:<code>$cache = new cache();</code>
{{Codepath2|htdocs/lib2/logic|cache.class.php}} wird dann automatisch geladen.

=== Fremdbibliotheken ===

Die OC-Software macht ausgiebig Gebrauch von fertigen PHP- und JavaScript-Codebibliotheken. Eine vollständige Aufstellung incl. Codepfade, Bezugsquellen etc. enthält {{Codepath|doc/license.txt}}. Hier seien nur die wichtigsten davon erwähnt:

<div class="widelist">
* [http://www.smarty.net/ '''Smarty'''] wird als "Template-Engine" für lib2 verwendet. OC-spezifische Erweiterungen befinden sich in der Klasse ''OcSmarty'' und in {{Codepath2|htdocs|lib2/smarty/ocplugins}}. Mehr dazu im Abschnitt [[#Templates|Templates]].

* '''[http://htmlpurifier.org/ HTML Purifier]''' dient zum "Säubern" von HTML-Code, den der Benutzer z.B. in Cachebeschreibungen eingeben kann. lib1 und lib2 verwenden getrennte HTML-Purifier-Installationen. In lib2 wird er über die Klasse ''OcHTMLPurifier'' eingebunden und kann dort auch angepasst werden.

* '''[http://www.tinymce.com/ TinyMCE]''' ist ein leistungsfähiger JavaScript-Wysiwyg-Texteditor. Er dient zum Bearbeiten von Cachebeschreibungen, Logs und Profiltexten. lib1 und lib2 verwenden beide die TinyMCE-Installation in {{Codepath|htdocs/resource2/tinymce}}. OC-spezifische Konfigurationsdaten gibt es in {{Codepath2|htdocs/resource2|tinymce/config}}.

Von lib2-Code verwendete Bibliotheken sind in {{Codepath|htdocs/lib2}} (PHP) und {{Codepath|htdocs/resource2}} (JavaScript) angelegt. Bibliotheken für lib1 befinden sich an verschiedenen Stellen.

</div>

== Konfigurationsdateien ==

==== lib1-Konfiguration ====

Die Einstellungen für lib1-Code befinden sich überwiegend in
:''htdocs/lib/settings.inc.php''
Diese Datei ist nur lokal vorhanden. Als Vorlage für das Aufsetzen einer neuen Produktiv-Installation gibt es die Datei {{Codepath2|htdocs/lib|settings-dist.inc.php}}, die nach ''settings.inc.php'' zu kopieren und anzupassen ist.

Für [[Entwicklung/Entwicklersystem|Entwicklersysteme]] gibt es entsprechend die Vorlage {{Codepath2|htdocs/lib|settings-sample-dev.inc.php}}. Sie verwendet die Datei {{Codepath2|htdocs/lib|settings-dev.inc.php}}, in der die Grundeinstellungen für Entwicklersysteme zusammengefasst sind.

Daneben gibt es noch zwei Konfigurationsdateien ''settings.inc.php'' für die Benachrichtigungs-Cronjobs, in {{Codepath|htdocs/util/notification}} und {{Codepath|htdocs/util/watchlist}}.

Weiterhin verwendet lib1 auch Teile der lib2-Konfiguration, insbesondere {{Codepath2|htdocs/config2|locale.inc.php}}.

==== lib2-Konfiguration ====

Die lib2-Einstellungen befinden sich alle in {{Codepath|htdocs/config2}}. Sie werden ''alle'' in folgender Reihenfolge eingebunden, sobald man {{Codepath2|htdocs/lib2|web.inc.php}} oder {{Codepath2|htdocs/lib2|cli.inc.php}} einbindet:

* sprachabhängige Einstellungen: {{Codepath2|htdocs/config2|locale.inc.php}}
* sonstige Default-Einstellungen: {{Codepath2|htdocs/config2|settings-dist.inc.php}}
* lokale Einstellungen: ''settings.inc.php''

Auch hier sind Vorlagen für Produktiv- ({{Codepath2|htdocs/config2|settings-sample.inc.php}}) und Entwicklersystem ({{Codepath2|htdocs/config2|settings-sample-dev.inc.php}}) vorhanden, die nach ''settings.inc.php'' zu kopieren und and die lokale Systeminstallation anzupassen sind.

==== Der Rootpath ====

Wenn man in PHP-Scripte mit <code>include</code> oder <code>require</code> weitere Dateien einbindet, geschieht dies relativ zum Verzeichnispfad des Hauptscripts. (Daneben kann man auch weitere Pfade festlegen, in denen PHP nach passenden Scripten sucht.)

Wie unter [[#Hauptmodule|Hauptmodule]] erläutert, befinden sich die Module der OC-Software auf verschiedenen Verzeichnisebenen Die Startseite liegt z.B. in {{Codepath|htdocs}}, das lib2-Cronjob-Modul dagegen in {{Codepath|htdocs/util2/cron}}. Alle diese Module binden lib1- oder lib2-Bibliothekscode ein, der weitere Unterscripte einbindet. Damit das alles funktioniert, wird im OC-Code ein ''Basispfad'' für alle Includes festgelegt. Dieser heißt
:<code>$opt['rootpath']</code>
in lib2 und
:<code>$rootpath</code>
in lib1.

Sofern man keine weiteren Vorkehrungen trifft, wird dieser Rootpath automatisch als Relativpfad "./" gesetzt. Scripte in Unterverzeichnissen müssen ihn dagegen selbst setzen, z.B. "../" wenn das Script eine Ebene tiefer liegt, oder absolut als <code>dirname(__FILE__).'../'</code>, wenn nicht bekannt ist, aus welchem aktuellen Verzeichnis ein Kommandozeilentool aufgerufen wird.

== Konstanten ==

Globale Konstanten sind an folgenden Stellen definiert:

* {{Codepath|htdocs/lib/consts.inc.php}}
* {{Codepath|htdocs/lib2/const.inc.php}}
* {{Codepath|htdocs/lib2/error.inc.php}}
* {{Codepath|htdocs/lib2/logic/const.inc.php}}

Die lib2-Konstanten werden auch teilweise auch in lib1-Code verwendet.

== Datenbank ==

Die OC-Software ist nur für die Verwendung von MySQL ausgelegt. Zwar werden in lib2 keine MySQL-Funktionen mehr direkt aufgerufen, aber zahlreiche SQL-Statements verlassen sich auf MySQL-Syntax.

=== Grundlegende Datenbankfunktionen ===

Für lib2 befinden sich alle Funktionen in {{Codepath2|htdocs|lib2/db.inc.php}} und sind dort kurz dokumentiert, für lib1 in {{Codepath2|htdocs|lib/clicompatbase.inc.php}}. Datenbankverbindungen werden automatisch entsprechend den Konfigurationseinstellungen hergestellt, sobald man eine Query absetzt.

Die wichtigsten Funktionen seien hier anhand von Beispielen erläutert:

sql("UPDATE `caches` SET `size`='&1' WHERE `cache_id`='&2'",
$newsize, $cacheid);

Hier wird die Größe eines Caches geändert. Variablen werden als fortlaufend numerierte Platzhalter &1, &2 etc. übergeben. Die Funktion ''sql'' ruft dann intern für jede Variable <code>mysql_real_escape_string()</code> auf, was spezielle Zeichen wie " codiert und gleichzeitig [[wikipedia:SQL-Injection|SQL-Injections]] verhindert.

'''Niemals dürfen Variablen direkt in SQL-Statements eingebaut werden!''' Wann immer möglich sind Platzhalter zu verwenden. Notfalls kann auch direkt mit <code>sql_escape()</code> codiert werden, was allerdings Probleme verursacht, wenn ein "&" in den Daten enthalten ist: Die Funktion <code>sql()</code> interpretiert es anschließend als Startzeichen eines Platzhalters.

$cachesize = sql_value("
SELECT `size` FROM `caches`
WHERE `cache_id`='&1'",
null, $cacheid);

Hier wird die Größe eines Caches abgefragt. Falls die Cache-ID nicht gefunden wird, wird der Defaultwert ''null'' zurückgeliefert. Denke immer daran, den Defaultwert als ersten Parameter anzugeben! Ihn zu vergessen ist eine häufige Fehlerquelle.

In der lib1 heißt die Funktion anders und kann nicht mit Platzhaltern umgehen; der entsprechende Code lautet dann:

$cachesize = sqlValue("
SELECT `size` FROM `caches`
WHERE `cache_id`='" . sql_escape($cacheid) . "'",
null);

Das folgende Beispiel demonstriert, wie der Inhalt einer Tabelle ausgelesen wird:

$rs = sql("
SELECT `cache_id`, `name`, `type` `size` FROM `caches`
WHERE `cache_id`='&1'",
$cacheid);
while ($r = sql_fetch_assoc($rs))
{
// ... Weiterverarbeitung von $r['cache_id'], $r['name'] etc.
}
sql_free_result($rs);

=== Slave-Server ===

Beide OC-Libraries sehen eine Lastverteilung auf einen Haupt-Datebankserver (Master) und einen oder mehrere "Slaves" vor, die replizierte Daten des Masters enthalten; siehe {{Codepath|doc/replication.txt}}. Dazu gibt es SQL-Funktionen mit dem Zusatz "_slave", z.B. <code>sql_slave()</code>, die von "datenbankintensiven" Programmmodulen wie z.B. der Suche ({{Codepath2|htdocs|search.php}}) anstatt der Basisfunktionen verwendet werden.

Wenn per ''settings.inc.php'' keine Slave-Server konfiguriert sind, laufen alle Zugriffe über den Master. Zurzeit betreibt kein Opencaching-Knoten Slave-Server; die Kapazität des Masters reicht überall aus.

=== Temporärtabellen ===

Da Subqueries bei MySQL recht ineffizient sind, sind manchmal temporäre Tabellen für Zwischenergebnisse nötig.

lib2 sieht einen speziellen Mechanismus zur Verwaltung von Temporärtabellen vor. Sie werden in einer eigenen Datenbank abgelegt, für die erweiterte Zugriffsrechte (Tabellen anlegen/löschen) vergeben werden, und werden per Cronjob automatisch aufgeräumt, wenn sie nicht gleich wieder gelöscht wurden.

Ein (nicht unbedingt sinnvolles) Beispiel für die Verwendung von lib2-Temporärtabellen. Die temporäre Tabelle heißt "tmp_caches" und wird in SQL-Statements über einen Platzhalter referenziert:

sql_temp_table('tmp_caches'); // Tabelle registrieren
sql(" // Tabelle anlegen
CREATE TEMPORARY TABLE &tmp_caches ENGINE=MEMORY
SELECT `cache_id` FROM `caches`
WHERE `user`.`user_id` = `caches`.`user_id`
AND `user`.`country` = '&1'",
$country);

$rs = sql(" // Tabelle auslesen
SELECT * FROM `cache_desc`, &tmp_caches
WHERE `cache_desc`.`cache_id` = &tmp_caches.`cache_id`");
// ... Daten weiterverarbeiten
sql_free_result($rs);

sql_drop_temp_table('tmp_caches'); // Tabelle löschen

=== Datenbankstruktur; statische Daten ===

Datenbankstruktur und -inhalte werden an folgenden Stellen unter {{Codepath|htdocs/doc/sql}} definiert:

* Tabellen, Felder und Indizes in {{Codepath2|htdocs/doc/sql|tables}}
* Stored Functions, Procedures und Triger in {{Codepath2|htdocs/doc/sql|stored-proc}}
* statische Daten wie z.B. Menüs, Cachetypen und sprachabhängige Texte in {{Codepath2|htdocs/doc/sql|static-data/data.sql}}.

Es gibt weitere (geographische) "statische Daten", die aufgrund ihres Umfangs nicht im Git-Repository enthalten sind; siehe {{Codepath2|htdocs/doc/sql|static-data/static-data.txt}}. Für Entwickler steht auf Anfrage ein Datenbankdump zur Verfügung, der eine vollständig initialisierte OC-Datenbank enthält (Veröffentlichung ist geplant). Weitere Updates können dann per
:{{Codepath|bin/dbupdate.php}}
eingepflegt werden, also man muss die oben aufgelisteten Dateien nicht von Hand weiterverarbeiten.

Siehe auch: [[Entwicklung/Datenbankversionierung|Datenbankversionierung]]

==== OKAPI ====

Die [[OKAPI]]-Tabellen werden zwar in der gleichen Datenbank abgelegt, sind aber unabhängig von den OC-Tabellen und daher ''nicht'' in {{Codepath|htdocs/doc/sql}} definiert. Bei [http://code.google.com/p/opencaching-api/#Installation_/_Update_Instructions Installation der OKAPI] werden sie automatisch angelegt und bei OKAPI-Updates automatisch aktualisiert. {{Codepath2|bin|dbupdate.php}} führt auch OKAPI-Updates durch, falls die OKAPI installiert ist.

Auch der OKAPI-''Code'' ist unabhängig vom OC-Code, d.h. sämtliche Datenbankzugriffe sind dort redundant implementiert. '''Bei Änderungen an Datenstrukturen oder -inhalten ist daher immer zu prüfen, ob eine Anpassung der OKAPI nötig ist!'''

=== Trigger & Stored Procedures ===

Der Opencaching-Code macht reichlich Gebrauch von gespeicherten Datenbank-Funktionen und Triggern. Sie werden dazu eingesetzt, um die Konsistenz der Datenbankinhalte zu gewährleisten. Vor dem Hintergrund, dass drei unabhängige Frameworks parallel auf die Datenbank zugreifen – lib1, lib2 und OKAPI (und manchmal noch ein Administrator von Hand) – ist diese Vorgehensweise ratsam. Sie macht die OC.de-Datenbank ausgesprochen robust.

Alle Datenbankfunktionen sind in
:{{Codepath|htdocs/doc/sql/stored-proc}}
definiert. Der aktuelle Stand befinden sich in {{Codepath2|htdocs/doc/sql/stored-proc|maintain-current.inc.php}}; für die [[Entwicklung/Datenbankversionierung|Datenbankversionierung]] können zusätzliche ältere Stände bzw. Update-Scripte existieren.

Der Inhalt des ''maintain''-Scripts lässt sich grob untergliedern in
* allgemeine Funktionen für komplexe Berechnungen, z.B. <code>DECTOWP</code> für die Berechnung neuer OC-Wegpunkte
* Update-Funktionen für bestimmte Felder (<code>sp_update_*</code>) die entweder von verschiedenen Triggern aufgerufen werden oder zur Datenbankwartung aus {{Codepath2|htdocs|dbmaint.php}} (Menü Admin|Datenbankwartung)
* Trigger-Prozeduren

Eine Besonderheit sind '''globale Variablen''' die zur Parameterübergabe von PHP-Scripten an Datenbankfunktionen oder zwischen Datenbankfunktionen verwendet werden. Sie sind in {{Codepath2|htdocs/doc/sql/stored-proc|maintain-current.inc.php}} erläutert.

=== SQL-Debugger ===

lib1 und lib2 enthalten einen nützlichen SQL-Debugger ({{Codepath2|htdocs|lib/sqldebugger.inc.php}} bzw. {{Codepath2|htdocs|lib2/sqldebugger.class.php}}). Er zeigt für jedes ausgeführte SQL-Statment

* das Statement selbst,
* ein [http://dev.mysql.com/doc/refman/5.1-olh/de/using-explain.html EXPLAIN],
* die ersten zurückgelieferten Datensätze, falls vorhanden,
* die Ausführungszeit,
* eventuelle MySQL-Warnungen.

Der SQL-Debugger muss in den [[#Konfigurationsdateien|Settings]] aktiviert sein – für lib1 per <code>$sql_debug = true</code>, in lib2 durch Setzen des Flags <code>DEBUG_SQLDEBUGGER</code> in <code>$opt['debug']</code>. Wahlweise kann man diese Flags auch nur in einzelnen zu debuggenden PHP-Quelltexten setzen.

Anschließend ist die zu debuggende Seite mit dem URL-Parameter <code>sqldebug=1</code> aufzurufen.

== Temporärdaten und Inhalte im Dateisystem ==

Manche Dinge werden in Dateien statt in der Datenbank abgelegt.

<div class="mediumlist">
* '''Hochgeladene Bilder''' befinden sich üblicherweise in {{Codepath|htdocs/images/uploads}} (in den Settings änderbar), die Thumbnails darunter in {{Codepath2|htdocs/images/uploads|thumbs}}. Generierte Statistikbilder werden in {{Codepath|htdocs/images/statpics}} abgelegt.
* Herunterzuladende, gepackte '''Ausgaben der [[XML-Schnittstelle]]''' werden in {{Codepath|htdocs/download/zip}} zwischengespeichert (ebenfalls konfigurierbar).
* {{Codepath|htdocs/cache2}} enthält zwischengespeicherte [[#Templates|Templates]], [[#Übersetzung|Übersetzungsdateien]] für gettext und verschiedene Temporärdaten. Ein guter Teil dieser Daten wird von {{Codepath|bin/clear-webcache.php}} neu generiert.
* {{Codepath|htdocs/var}} enthält zwischengespeicherte OKAPI-Daten (die OKAPI legt allerdings auch eine Menge "gecachete" in der Datenbank ab) und Fehlerprotokolle.
* {{Codepath|htdocs/cache}} enthält vermutlich nur noch temporäre Prozess-Synchronisationsdateien (.pid-Dateien) der lib1-cronjobs für Log- und Cache-Benachrichtigungen.
</div>

== Templates ==

[[wikipedia:Template (Programmierung)|Templates]] dienen in Webanwendungen dazu, die Generierung von aus- und einzugebenden Daten von deren HTML-Darstellung zu trennen. HTML- und JavaScript-Code wird komplett in den Template-Dateien untergebracht, PHP-Code soweit wie irgend möglich in PHP-Scripten.

Die Einbindung der Templates in den PHP-Programmablauf geschieht wie folgt:
# Festlegung, welche Templatedatei verwendet wird
# Zuweisung von variablen Inhalten an das Template
# Darstellung des Templates
Für alle drei Punkte gibt es entsprechende Bibliotheksfunktionen.

=== lib1-Templates ===

Die alte Library enthält ein selbstgemachtes, simples Templatesystem. Die Templatedateien befinden sich in {{Codepath|htdocs/lang/de/ocstyle}} und enthalten den auszugebenden HTML- und JavaScript-Code. Der Name der Template-Datei wird im PHP-Code über die globale Variable <code>$tplname</code> festgelegt, z.B.
:<code>$tplname = 'newcache';</code>

Für alle variablen Inhalte werden im Template Platzhalter wie z.B. <code>{cachename}</code> verwendet; die PHP-Variable wird dann übergeben mit

:<code>tpl_set_var('cachename', $cachename);</code>

Sofern der variable Teil auch HTML-Code oder etwas zu Übersetzendes enthält, wird dies in speziellen Include-Dateien abgelegt, z.B.

$cachelink = '<a href="viewcache.php?cacheid={cacheid}">{cachename}</a>';
$outputformat_notexist = t('The selected output format is unknown!');

Die Include-Datei wird im PHP-Hauptmodul eingebunden und die Variablen per <code>mb_ereg_replace</code> ersetzt, bevor das Ganze per <code>tpl_set_var()</code> ans Template übergeben wird.

:<code>tpl_BuildTemplate();</code>
stellt schließlich das Template dar und beendet das PHP-Script.

Alle [[Opencaching]]-Seiten außer OC.de und OC.se/no verwenden noch das lib1-Templatesystem.

=== lib2-Templates (Smarty) ===

==== Grundlagen ====

Die neue Bibliothek verwendet die leistungsfähige [[wikipedia:Smarty|Smarty]]-Engine. Smarty-Templates bestehen neben dem HTML/JavaScript-Code im Wesentlichen aus Kontrollstrukturen und Variableneinbindungen. Die Templates sind in {{Codepath|htdocs/templates2/ocstyle}} abgelegt.

Die lib2 definiert die globale Variable
:<code>$tpl</code>
über die alle Zugriffe auf Smarty und die Templates laufen. Am Beginn des PHP-Moduls wird jeweils das Template initialisiert:

$tpl->name = 'newemail'; // Name der Template-Datei
$tpl->menuitem = MNU_MYPROFILE_DATA; // Menü-ID, siehe doc/sql/static-data/data.sql
$tpl->caching = false; // nicht zwischenspeichern

Der ''caching''-Parameter legt fest, ob das Ergebnis der Templateausgabe zwischengespeichert wird; die Dauer der Zwischenspeicherung ist dann ggf. per
$tpl->caching_lifetime = 1800; // halbe Stunde Caching
festzulegen. Dies empfiehlt sich bei häufig aufgerufenen, rechenintensiven Seiten. Seiten mit ständig wechselndem bzw. benutzerabhängigem Inhalt dürfen '''nicht''' "gecacht" werden!

Neben Caching der Template-''Ausgaben'' gibt es auch eine ''Vorcompilierung'' der Templates selbst. Diese erfolgt
* einmalig für alle Templates per <code>bin/clear-webcache.php</code>,
* automatisch, wenn ein geändertes Template abgerufen wird,
* jedesmal bei jedem Template-Aufruf, falls in den Settings der Debug-Schalter <code>DEBUG_TEMPLATES</code> gesetzt ist.

Die zwischengespeicherten Templates werden in <code>htdocs/cache2/smarty</code> abgelegt.

Auf die Initialisierung des Templates folgen Variablen-Zuweisungen (s.u.) und schließlich die Darstellung mit
:<code>$tpl->display();</code>
die das PHP-Script beendet.

;Smarty-Syntax

Im Folgenden sind ein paar grundlegende Smarty-Elemente erklärt; ansonsten sei auf die [http://www.smarty.net/docsv2/de/ Smarty-Dokumentation] verwiesen und auf die vielen Bespiele in {{Codepath2|htdocs|templates2/ocstyle}}. (Achtung: Der OC-Code verwendet eine ältere Smarty-Version; nicht alles was in der Doku steht ist hier auch schon verfügbar!)

Alle Smarty-Elemente stehen in geschweiften Klammern {}. Wenn das Template solche Klammern für andere Zwecke verwendet, z.B. für JavaScript-Kontrollstrukturen, müssen diese von der Smarty-Interpretation ausgeklammert werden:

{literal}
function js_function()
{
...
}
{/literal}

==== Variablen ====

Variablen werden z.B. per
:<code>$tpl->assign('cachename', $cache['name']);</code>
an das Template übergeben und dort als
:<code>{$cachename}</code>
verwendet. Es können auch Arrays übergeben werden, deren Elemente statt [] mit einem Punkt referenziert werden.
:<code>{$cache.name}</code>
steht z.B. für <code>$caches['name']</code>, übergeben per <code>$tpl->assign('caches', ...)</code>. Dies funktioniert auch mit numerischen Indizes – z.B. <code>{$user.0}</code> für das erste Element eines $user-Arrays – und mit mehr als zwei Ebenen.

Auch simple Berechnung sind möglich, z.B. <code>{$waylength*2}</code>.

Zusätzlich zu dem vom PHP-Code übergebenen Variablen kann man auch eigene definieren, z.B.
:<code>{assign var=counter value=1}</code>
Mit <code>{capture}</code> lassen sich u.U. auch komplexere Ausdrücke in einer Variable unterbringen.

==== Kontrollstrukturen ====

Bedingte Einbindung von Template-Komponenten ist mit <code>{if} … {elseif} … {else} … {/if}</code>-Anweisungen möglich. Dabei können auch komplexere PHP-Ausdrucke verwendet werden, die als Boolean ausgewertet werden:

{if $show_statistics && ($statdata|@count > 0)}
... Statistik ausgeben ...
{/if}

(@count ist eine [[#Benutzerdefinierte Erweiterungen; Übersetzungen|benutzerdefinierte Funktion]])

Eine weiter häufig verwendete Struktur ist <code>{foreach}</code> zum iterieren von Arrayelementen:

{foreach from=$caches item=cache}
<td>{$cache.name|escape}</td>
{/foreach}

<code>|escape</code> ist ein ''Modifizierer'', der den Variableninhalt weiterverarbeitet. In diesem Fall werden HTML-Entitäten "escaped".

Mit <code>{strip}...{/strip}</code> lassen sich alle Whitespaces (Leerzeichen, Tabs, Zeilenumbrüche) in einem Abschnitt herausfiltern, was die auszugebende Datenbank reduziert. Aber Vorsicht, falls Whitespaces als Trennzeichen in Ausgaben benötigt werden!

==== Benutzerdefinierte Erweiterungen ====

Smarty lässt sich um eigene
* Elemente ("Blocks"),
* Modifizierer und
* Funktionen
erweitern. Der Opencaching-Code enthält eine Reihe solcher eigener Erweiterungen in {{Codepath2|htdocs|lib2/smarty/ocplugins}}.

Die wichtigste Erweiterung ist das <code>{t}</code>-Element zum Übersetzen von Texten. Alle Texte in den Templates werden in Englisch geschrieben und in <code>{t} ... {/t}</code> eingeschlossen; sie werden dadurch automatisch dem Übersetzungssystem zugeführt. Mehr dazu im Kapitel [[#Übersetzungen|Übersetzungen]].

=== Systemtemplate und Menüsystem ===

Was oben über einzelne Templates geschrieben wurde betrifft nur den Teil der Seite, der im ''Content-Container'' dargestellt wird – also dem Teil unterhalb und rechts des Menüsystems und oberhalb der Fußzeile. Alles "drumherum" wird vom ''Systemtemplate'' erzeugt.

Folgende Codedateien sind daran in der lib1 beteiligt ...
* Systemtemplate: {{Codepath2|htdocs|lang/de/ocstyle/main.tpl.php}}
* Menüdefinitionen: {{Codepath2|htdocs|lang/de/ocstyle/lib/menu.php}}
* PHP-Framework: {{Codepath2|htdocs|lib/common.inc.php}} → tpl_BuildTemplate()
... und in der lib2:
* Systemtemplate: {{Codepath2|htdocs|templates2/ocstyle/sys_main.tpl}}
* Menüsystem: Tabelle 'sys_menu' per {{Codepath2|htdocs|doc/sql/static-data/data.sql}}, {{Codepath2|htdocs|lib2/menu.class.php}}
* PHP-Framework: {{Codepath2|htdocs|lib2/OcSmarty.class.php}}

Zusätzliche Hauptmenü-Punkte sind via [[#Konfigurationsdateien|Konfigurationsdateien]] erzeugbar.

=== Email-Templates ===

Auch der Inhalt (''body'') von Emails wird über Templates erzeugt.

lib1-Email-Templates befinden sich in {{Codepath|htdocs/lang/de/ocstyle/email}}, {{Codepath|htdocs/util/notification}} und {{Codepath|htdocs/util/watchlist}} und werden von den entsprechenden PHP-Modulen direkt per <code>mb_ereg_replace()</code> aufgelöst.

lib2-Email-Templates liegen in {{Codepath|htdocs/templates2/mail}} und werden von <code>mail.class.php</code> per Smarty verarbeitet.

=== OKAPI ===
Die OKAPI hat ein eigenes Templatesystem; mehr dazu im Abschnitt [[#OKAPI|OKAPI]].

== CSS Style Sheets ==
Die Style Sheets befinden sich in {{Codepath|htdocs/resource2/ocstyle/css}}.

== Grafiken ==

Grafiken für Icons und andere Dinge verteilen sich – soweit es keine Drittbibliotheken betrifft – über drei Verzeichnisse:

* {{Codepath|htdocs/images}} (lib1 und lib2)
* {{Codepath|htdocs/lang/de/ocstyle/images}} (lib1)
* {{Codepath|htdocs/resource2/ocstyle/images}} (lib2)

Hier herrscht etwas Chaos. Manches ist mehrfach vorhanden - auch innerhalb ''einer'' Library - oder inkonsistent abgelegt, die Dateitypen wechseln zwischen GIF und PNG. Glattziehen lässt sich das kaum, weil Grafiken auch gerne von anderer Stelle aus verlinkt werden, z.B. aus Cachelistings - teils sogar von anderen Plattformen aus. Schiebt man die Grafiken einfach weg oder ändert das Format, zerstört es unbemerkt Cachebeschreibungen.

Zur Kompatibilität mit alten Cachebeschreibungen und Logs liegen in folgenden Verzeichnissen Grafiken, die anderweitig nicht mehr verwendet werden:

* {{Codepath|htdocs/lang/de/stdstyle/images}}
* {{Codepath|htdocs/lib/tinymce/plugins/emotions/images}}
* {{Codepath|htdocs/resource2/stdstyle/images}}

== Übersetzung ==

Der OC-Code ist mehrsprachig und frei übersetzbar, mit Ausnahme
* der Benachrichtigungs-Emails, die es bislang nur in Deutsch gibt (-> http://redmine.opencaching.de/issues/141)
* des Garmin-Download-Dialogs ({{Codepath2|htdocs|garmin.php}}), dessen untere Hälfte es nur in Deutsch und Englisch gibt (siehe {{Codepath|htdocs/resource2/ocstyle/js/GarminDisplay.js}})
(weitere noch nicht lokalisierbare Module bitte ergänzen!)

Die Lokalisierung je nach gewählte Sprache erfolgt grundsätzlich mit folgenden Mechanismen:
* In Templates über die Smarty-Tags <code>{t}English Text{/t}</code>. Hierbei können auch Variablen eingesetzt werden, z.B.
*:<code>{t 1=$cachename 2=$username}The geocache %1 has been found by %2{/t}</code>
* Notfalls direkt im PHP-Code durch Aufruf von <code>$translate->t()</code>, z.B.
*:<code>$text = $translate->t('New password code', <nowiki>''</nowiki>, basename(__FILE__), __LINE__)</code>
* Bei Artikelseiten, die via {{Codepath|htdocs/articles.php}} dargestellt werden, per Ablage der Templates in Unterverzeichnissen von {{Codepath|htdocs/templates2/ocstyle/articles}}.

Das Übersetzungssystem arbeitet intern mit <code>gettext()</code>. Die Strings dafür befinden sich in der Tabellen ''sys_trans'' und ''sys_trans_text''. Man kann sie direkt via {{Codepath2|htdocs/doc/sql/static-data|data.sql}} einpflegen, oder mit dem "Schnellübersetzungsmodus" + "SQL-Export" von {{Codepath2|htdocs|translate.php}} (Menü Admin|Übersetzung). Letzteres kann allerdings jede Menge Git-Merge-Konflikte beim Zusammenführen verschiedener Branches erzeugen, daher werden OC.de-Übersetzungen derzeit nur direkt in {{Codepath2|htdocs/doc/sql/static-data|data.sql}} eingepflegt.

Achtung: '''Auch für die englische Seitendarstellung läuft nochmal alles durch den Übersetzer''', Artikel ausgenommen. Die englischen Originaltexte in den Templates oder im PHP-Code sind also nur eine Basis für die weitere Übersetzung. Kleinere Fehler dort müssen nicht korrigiert werden, solange die Texte verständlich sind. ''Wenn'' dort etwas korrigiert wird, muss es gleichzeitig auch in der Tabelle ''sys_trans'' in {{Codepath2|htdocs/doc/sql/static-data|data.sql}} geändert werden!

Opencaching.de gibt es zurzeit in Deutsch, Englisch, Italienisch und Spanisch. Die Übersetzungen werden durch den von Opencaching Deutschland eingesetzten Code Maintainer organisiert.

== Fehlerbehandlung ==

Der OC-Code verwendet kein Exception Handling (mit Ausnahme der OKAPI). Wenn etwas fehlschlägt, wird dies durch den Rückgabewert der betreffenden Funktion signalisiert und entsprechend reagiert. Würde man den betroffenen Funktionen noch einen Namenszusatz spendieren, der die mögliche Fehlerrückgabe kennzeichnet, wäre dieses System transparenter und in sich weniger fehleranfällig als ein strukturiertes Exception Handling.

==== fehlerhafte Benutzereingaben ====
Wenn es Probleme mit einer Benutzereingabe gibt, wird das betreffende Template nochmals angezeigt und an passender Stelle eine mit dem CSS-Stil <code>errormsg</code> formatierte Meldung eingeblendet. Dies ist jeweils entsprechend zu implementieren.

==== erkanntes Problem ====
Wenn anderweitig ein nicht handhhabbares Problem erkannt wird, wird das Fehlertemplate angezeigt. In '''lib1''' befindet sich dies in {{Codepath2|htdocs|lang/de/ocstyle/error.tpl.php}} und wird aufgerufen per
:<code>tpl_errorMsg('original_templatename', $fehlermeldung);</code>
z.B.
$error_desc_not_found = t('(internal error) The description is not available.');
...
tpl_errorMsg('editdesc', $error_desc_not_found);

Das '''lib2'''-Fehlertemplate befindet sich in bzw. {{Codepath2|htdocs|templates2/ocstyle/error.tpl}} und wird verwendet mit
:<code>$tpl->error(Fehlernummer)</code>
oder
:<code>$tpl->error($fehlermeldung);</code>
Die Fehlernummern sind in {{Codepath2|htdocs|lib2/error.inc.php}} definiert.

; SQL-Fehler

Bei MySQL-Fehlern wird ein Fehlertemplate anzeigt und eine Admin-Email versandt, sofern in den [[#Konfigurationsdateien|Settings]] eine Mailadresse hinterlegt ist. In der lib1 ist sie in
:<code>$sql_errormail</code>
einzutragen, in der lib2 in
:<code>$opt['db']['error']['mail']</code>.
Entwicklersysteme werden so konfiguriert, dass das komplette SQL-Statement auch direkt angezeigt wird.

Zusätzlich kann man per <code>$sql_warntime</code> (lib1) bzw. <code>$opt['db']['warn']['time']</code> (lib2) eine Warnschwelle für zu lange SQL-Ausführungszeiten festlegen. Bei Überschreitung werden dann Admin-Mails erzeugt.

==== unerkanntes Problem ====

{{Codepath2|htdocs|lib2/errorhandler.inc.php}} enthält ein noch in der Testphase befindlichen Handler für PHP-Fehler, der auch in lib1 eingebunden ist. Er wird bei PHP-Fehlern aktiv, die (abhängig von der ''error_reporting''-Einstellung in der PHP-Konfiguration) zu einem Abbruch des Scripts führen. Es wird dann eine Fehlermeldung anzeigt und ggf. eine Admin-Mail erzeugt. Es wird die gleiche Emailkonfiguration wie für bei SQL-Problemen (s.o.) verwendet.

Dieser PHP-Errorhandler ist derzeit nur aktiviert, wenn in der Konfiguration der Debug-Modus eingeschaltet ist. Ansonsten erscheint bei Fehlern eine leere Seite.

== OKAPI ==

Die Opencaching-API ist ein eigenständiges PHP-Projekt, dessen Code auf verschiedenen OC-Seiten zum Einsatz kommt. Die Projekt-Homepage ist http://code.google.com/p/opencaching-api/. Beiträge, die nicht vom Code-Maintainer selbst kommen, werden üblicherweise in Branches hochgeladen und laufen dann durch ein Code Review.

Die OKAPI wird – erfolgreich! – mit einem wesentlich höheren Anspruch an Codequalität und -Stil entwickelt als die OC-Länderseiten. Dokumentation und Codestruktur sind herausragend. Gleichzeitig steht sie bei einigen Details wie Template-Engine, Datenbank-Library und Konstanten-Definitionen hinter dem OC.de-Code zurück. Der OKAPI-Code ist nur für Webanwendungen geschrieben; Einbindung in Kommandozeilentools kann insbesondere am Exception-Handling scheitern.

Der OKAPI-Code wird aus dem OKAPI-Projekt in die lokalen OC-Code-Repositories (nach {{Codepath|htdocs/okapi}}) repliziert. Bei Opencaching.pl und .nl geschieht dies automatisch über einen SVN-"Commit-Hook", bei Opencaching.de manuell durch den Code-Maintainer nach einem Security Review.

OKAPI-Code kann über die "Facade"-Schnittstelle in OC-Code eingebunden werden ({{Codepath2|htdocs|okapi/facade.php}}). OC.pl macht davon insbesondere bei der Karte Gebrauch, die von der OKAPI generiert wird. OC.de verwendet die Facade bislang nur (experimentell) im Update-Script {{Codepath|bin/okapi-update.php}}, das von {{Codepath2|bin|dbupdate.php}} aufgerufen wird.

Sämtliche OKAPI-Seitenzugriffe laufen über eine Rewrite-Engine ({{Codepath2|htdocs|okapi/.htaccess}} → {{Codepath2|htdocs|okapi/controller.php}}). Man kann daher die PHP-Scripte nicht direkt über ihre URLs idenitifizieren sondern muss schonmal etwas suchen. Methoden befinden sich in {{Codepath2|htdocs|okapi/services}}, Seiten mit HTML-Output in {{Codepath2|htdocs|okapi/views}}.

Für die Dokumentation verwendet die OKAPI ein eigenes XML-Format, das von einem Parser aufbereitet wird.

Templates für Methoden, die HTML- oder sonstiges XML-Output liefern, sind in .tpl.php-Dateien zusammen mit den PHP-Quelltexten abgelegt. Variablen werden per PHP-Code eingebunden, meist per "short open tags", z.B.

<? if (($vars['my_notes'] == 'desc:text') && ($c['my_notes'] != null)) { /* Does user want us to include personal notes? */ ?>
<p><b><?= _("Personal notes") ?>:</b> <?= Okapi::xmlescape($c['my_notes']) ?></p>
<? } ?>

[[Kategorie:Entwicklung|Codedoku]]

Cachearten

2014-04-24T05:56:20Z

Dl6hbo: /* Virtueller Cache */

[[Datei:Cachetypes-oc.png|thumb|hochkant=2|Verteilung der Cachearten auf Opencaching.de, Oktober 2012]]
Siehe auch [http://www.opencaching.de/articles.php?page=cacheinfo auf opencaching.de]

[[Datei:Cacharten.jpg|framed]]

== Normaler Cache („Tradi“) ==
Die eingetragenen Koordinaten geben möglichst genau die Cacheposition an. Der Cache ist z.B. eine Dose mit Logbuch darin, zum Finden und Öffnen des Caches sind keine Rätsel oder Aufgaben zu lösen.

Tradis sind am einfachsten zu [[Fachjargon#Legen|legen]] und zu finden, daher eignen sie sich gut für Anfänger und erhalten mehr [[Log]]s als aufwändigere Caches.

== Drive-In ==
Ein normaler Cache, der direkt bei einem Parkplatz liegt. Es wird keine Spezialausrüstung benötigt.

== [[Multicache]] („Multi“) ==
Die angegebenen Koordinaten geben nicht die Cacheposition, sondern den Startpunkt für die Suche nach dem Cache an. Von dort aus kann er durch das Lösen von Aufgaben oder Rätseln und/oder durch das Finden von Zwischenstationen erreicht werden. Die Lösung der Aufgaben und Rätsel muss vor Ort möglich sein.

== Rätselcache („Mystery“) ==
Um die Koordinaten des Caches herauszufinden, muss zuerst ein Rätsel gelöst werden. Im weiteren Verlauf kann es sich um jede Art von Cache (normal, multi, virtuell usw.) handeln.

Wenn du einen Rätselcache listest kannst du als zusätzlichen Service einen [[Geochecker]] einzubauen. Damit lässt sich vor der Suche überprüfen, ob die errätselten Koordinaten stimmen.

== Mathe-/Physikcache ==
Zur Lösung des Caches müssen eine oder mehrere Mathe- oder Physikaufgaben gelöst werden, die über das kleine Geocacher-1x1 hinaus gehen.

== Beweglicher Cache ==
Der Cache wechselt seine Position. Er kann z. B. von jedem Finder an einem neuen Ort versteckt werden; die neuen Koordinaten und ggf. eine neue Aufgabe werden dann im Logeintrag veröffentlicht. Oder der Cache befindet sich an einem Verkehrsmittel, dessen Koordinaten herauszufinden sind.

[[Datei:OC5E7A Skulptur.JPG|thumb|virtueller Cache [http://www.opencaching.de/OC5E7A OC5E7A]]]
== Virtueller Cache ==
Am Ziel befindet sich weder ein Behälter noch ein Logbuch. Stattdessen ist dort eine Aufgabe zu lösen, bevor man den Cache loggen kann – z. B. indem man etwas abliest, ein Foto macht usw.

Virtuelle Caches sind für Orte gedacht, wo es schwer ist einen Behälter zu verstecken oder wo dies dem Ort schaden könnte, etwa in [[Naturschutz]]gebieten. Dieser Cachetyp eignet sich auch für Orte, bei denen es schwierig oder unmöglich ist, die Erlaubnis zum Legen eines Caches zu bekommen.

== Webcam-Cache ==
Zum Lösen des Caches wird eine öffentliche Webcam genutzt. Meist muss die Webcam an den angegebenen Koordinaten gefunden werden, um von dieser ein Bild mit sich selbst zu machen. Das Bild wird dann beim Logeintrag hinzugefügt. Es gibt weder Tauschbehälter noch Logbuch.

== Event-Cache ==
[[Event|Treffen von Geocachern]] zum gemeinsamen Plausch. Es darf jeder Geocacher teilnehmen, der Lust hat. Vor dem Treffen loggt man, dass man teilnehmen möchte, und danach dass man teilgenommen hat.

== Unbekannter Cachetyp ==
Alles was nicht in die oben aufgelisteten Cachetypen einordnen lässt.

[[Kategorie:Opencaching]]
[[Kategorie:Listings und Logs]]
[[Kategorie:Geocaches]]

[[pl:Typ skrzynki]]

Cachearten

2014-04-24T05:54:17Z

Dl6hbo: /* Webcam-Cache */

[[Datei:Cachetypes-oc.png|thumb|hochkant=2|Verteilung der Cachearten auf Opencaching.de, Oktober 2012]]
Siehe auch [http://www.opencaching.de/articles.php?page=cacheinfo auf opencaching.de]

[[Datei:Cacharten.jpg|framed]]

== Normaler Cache („Tradi“) ==
Die eingetragenen Koordinaten geben möglichst genau die Cacheposition an. Der Cache ist z.B. eine Dose mit Logbuch darin, zum Finden und Öffnen des Caches sind keine Rätsel oder Aufgaben zu lösen.

Tradis sind am einfachsten zu [[Fachjargon#Legen|legen]] und zu finden, daher eignen sie sich gut für Anfänger und erhalten mehr [[Log]]s als aufwändigere Caches.

== Drive-In ==
Ein normaler Cache, der direkt bei einem Parkplatz liegt. Es wird keine Spezialausrüstung benötigt.

== [[Multicache]] („Multi“) ==
Die angegebenen Koordinaten geben nicht die Cacheposition, sondern den Startpunkt für die Suche nach dem Cache an. Von dort aus kann er durch das Lösen von Aufgaben oder Rätseln und/oder durch das Finden von Zwischenstationen erreicht werden. Die Lösung der Aufgaben und Rätsel muss vor Ort möglich sein.

== Rätselcache („Mystery“) ==
Um die Koordinaten des Caches herauszufinden, muss zuerst ein Rätsel gelöst werden. Im weiteren Verlauf kann es sich um jede Art von Cache (normal, multi, virtuell usw.) handeln.

Wenn du einen Rätselcache listest kannst du als zusätzlichen Service einen [[Geochecker]] einzubauen. Damit lässt sich vor der Suche überprüfen, ob die errätselten Koordinaten stimmen.

== Mathe-/Physikcache ==
Zur Lösung des Caches müssen eine oder mehrere Mathe- oder Physikaufgaben gelöst werden, die über das kleine Geocacher-1x1 hinaus gehen.

== Beweglicher Cache ==
Der Cache wechselt seine Position. Er kann z. B. von jedem Finder an einem neuen Ort versteckt werden; die neuen Koordinaten und ggf. eine neue Aufgabe werden dann im Logeintrag veröffentlicht. Oder der Cache befindet sich an einem Verkehrsmittel, dessen Koordinaten herauszufinden sind.

[[Datei:OC5E7A Skulptur.JPG|thumb|virtueller Cache [http://www.opencaching.de/OC5E7A OC5E7A]]]
== Virtueller Cache ==
Am Ziel befindet sich weder ein Behälter noch ein Logbuch. Stattdessen ist dort eine Aufgabe zu lösen, bevor man den Cache loggen kann – z. B. indem man etwas abliest, ein Foto macht usw.

Virtuelle Caches sind für Orte gedacht, wo es schwer ist einen Behälter zu verstecken oder wo dies dem Ort schaden könnte, etwa in [[Naturschutz]]gebieten.

== Webcam-Cache ==
Zum Lösen des Caches wird eine öffentliche Webcam genutzt. Meist muss die Webcam an den angegebenen Koordinaten gefunden werden, um von dieser ein Bild mit sich selbst zu machen. Das Bild wird dann beim Logeintrag hinzugefügt. Es gibt weder Tauschbehälter noch Logbuch.

== Event-Cache ==
[[Event|Treffen von Geocachern]] zum gemeinsamen Plausch. Es darf jeder Geocacher teilnehmen, der Lust hat. Vor dem Treffen loggt man, dass man teilnehmen möchte, und danach dass man teilgenommen hat.

== Unbekannter Cachetyp ==
Alles was nicht in die oben aufgelisteten Cachetypen einordnen lässt.

[[Kategorie:Opencaching]]
[[Kategorie:Listings und Logs]]
[[Kategorie:Geocaches]]

[[pl:Typ skrzynki]]

Caches entlang einer Route

2014-04-01T14:25:30Z

Dl6hbo:

[[Datei:Oc car1.png|200px|thumb|right|Parameter]]Es gibt ein Script das unter Linux läuft, mit dem eine [[GPX-Datei|GPX]] Datei erzeugt werden kann, die alle Caches entlang einer Route beinhaltet. Das Script wurde durch [http://www.opencaching.de/viewprofile.php?userid=214033 ka_be] entwickelt und freundlicherweise im [http://forum.opencaching-network.org/index.php?topic=3784.0 Opencaching-Forum] zur Verfügung gestellt.

Das Script sucht sich entweder selbst die Route oder es wird mit einer GPX Datei gefüttert, die die geplante Route enthält – dieses kann bspw. ganz einfach bei [http://openrouteservice.org Openrouteservice.org] erzeugt werden. Schon sammelt es via [[OKAPI]] alle nötigen Daten zusammen. Es sendet auf Wunsch sogar die GPX Daten zu einer E-Mail Adresse. Ab 500 Caches wird eine weitere GPX Datei angelegt und versendet.

Damit das Script funktioniert, muss GPSBabel installiert sein, es wird für den E-Mail Versand SendEmail, zum Skript-Downloand curl benötigt. Gestartet wird das Script dann ganz einfach im Terminal, wobei man diverse Parameter angeben muss/kann wie Benutzernamen, Start, Ziel.

Folgende Angaben sollten für Start / Ziel funktionieren
* Koordinaten im Format lat,lng ohne Leerzeichen, auf . und , achten-> 48.321,9.123
* Ortsnamen
* Straße,Ortsnamen ohne Leerzeichen -> manchmal gehts, manchmal nicht

Das Script rödelt dann kurz durch und anschließend befindet sich im Scriptverzeichnis das fertige GPX-File mit allen Caches entlang der vorgegebenen Route. Das kann dann ganz bequem mit der Software der eigenen Wahl weiter verarbeitet, direkt auf das GPS geschoben oder ans Handy versendet werden.

== Die Installation unter Linux ==
[[Datei:Oc car.png|200px|thumb|right|Fertig durchgelaufenes Skript]]
Starte Terminal, Shortcut: Strg + Alt + T, das Terminal wird im home Verzeichnis geöffnet

Lege ein neues Verzeichnis an mit<br>
<code>mkdir oc_car</code>

Wechseln ins Verzeichnis mit<br>
<code>cd oc_car</code>

Pakete (unter Debian Linux und Derivaten) installieren - soweit nötig - mit <br>
<code>sudo apt-get install gpsbabel bc</code> <br>
<code>sudo apt-get install sendemail</code> <br>
<code>sudo apt-get install curl</code>

Download Skript mit<br>
<code>curl https://raw.githubusercontent.com/kabegeo/oc_car/master/oc_car_0.3.1.sh > oc_car.sh</code>

Skript ausführbar machen mit<br>
<code>Sudo chmod 744 oc_car.sh</code>

Ausführen mit<br>
<code>./oc_car.sh</code>

Nach dem ersten Durchlauf wird die Datei oc_car.conf erstellt. Hier bitte E-Mail Daten hinterlegen, wenn E-Mail Versand erwünscht.<br>
<code>oc_car.conf</code>

Bilder

2014-03-19T16:54:31Z

Dl6hbo:

[[Datei:OC5E7A-2.jpg|miniatur|hochkant=1.2|Logbild von {{Cachelink|OC5E7A}}]]
In [[Cachebeschreibung (Listing)|Cachebeschreibungen]] und [[Das Onlinelog|Logs]] können Bilder hinzugefügt werden, zum Beispiel um einen Eindruck von der Umgebung des Caches zu vermitteln oder um die Cachesuche zu dokumentieren. Bei [[Cachearten#Webcam-Cache|Webcam-Caches]] gehört zu jedem Log auch eine Webcam-Aufnahme.

Das Hinzufügen von Bildern zu deinen Cachebeschreibungen ist unter [[Erstellen einer Cachebeschreibung/ Listing#Bilder hinzufügen|Erstellen einer Cachebeschreibung]] beschrieben, wie du Logbilder hochlädst unter [[Das Onlinelog#Fotos hinzufügen|Das Onlinelog]]. Die Bilder dürfen maximal 150 KB groß sein und sind ggf. vor dem Hochladen mit einem Bildbearbeitungsprogramm zu verkleinern. Es werden die Dateiformate JPEG, GIF, PNG und BMP unterstützt.

Bilder, deren längere Seite größer als 1024 Pixel ist, werden proportional verkleinert, so dass diese Seite 1024 Pixel misst. Unterstützt werden nur die angegebenen Bildformate deren Größe das genannte Maximum nicht überschreiten.
Dies ist eine neue Funktion. Bitte berichtet uns, falls sie noch nicht wie gewünscht funktioniert.
Die Funktion ist automatisiert und '''''schert daher alles über einen Kamm'''''. Es kann also zur Qualitätsverschlechterung Deiner Bilder kommen. Wenn Du das vermeiden willst, so solltest Du die Verkleinerung mit Deinen optimalen Werkzeugen vor dem Hochladen auf Deinem Rechner erledigen.

== Galerien ==
Logbilder erscheinen in verschiedenen Galerien:
* Die neuesten sechs Bilder direkt auf der [http://www.opencaching.de/ Startseite]. Dabei wird maximal ein Bild pro Benutzer und Tag sowie pro Cache und Tag angezeigt.
* Die neuesten 48 Bilder in auf der Seite „[http://www.opencaching.de/ Logbildgalerie]“, ereichbar im Menü der Startseite; maximal ein Bild pro Benutzer und Tag, das nicht das gleiche sein muss wie auf der Startseite;
* deine sechs neuesten Bilder in deinem [http://www.opencaching.de/myhome.php Benutzerprofil]
* alle deine hochgeladenen Logbilder über den Link [http://www.opencaching.de/myhome.php?allpics=1 alle anzeigen] in deinem (nicht-öffentlichen) Benutzerprofil
* alle hochgeladenen Bilder eines Benutzers – ausgenommen [[Spoiler]] – in dessen öffentlichem Benutzerprofil über den Link „Logbilder - alle anzeigen“, sofern er diesen nicht deaktiviert hat.

In deinen [http://www.opencaching.de/mydetails.php Profileinstellungen] kannst du festlegen, ob deine persönliche Bildstatistik und -galerie für andere Benutzer sichtbar ist oder nicht.

Die Bilder aus einer Galerie lassen sich durchblättern, sobald eines davon per Anklicken vergrößert wurde. Am einfachsten geht dies mit dem Mausrad oder mit den Pfeiltasten nach links und rechts.

== Kartenvorschaubilder ==
Wenn du ein Bild zu einer Cachebeschreibung hochlädst kannst du ankreuzen, dass es sich um das Vorschaubild für die [[Cachekarte]] handelt. Dieses Bild erscheint links oben in der Kartenansicht, wenn jemand auf das Symbol des Caches klickt. War bereits ein anderes Vorschaubild gewählt, so wird dies auf der Karte durch das neue ersetzt.

Die Darstellungsgröße der Vorschaubilder kann jeder Benutzer für sich in den Karteneinstellungen festlegen, und zwar in Prozent der Kartenfläche. Das heißt: Die Breite oder Höhe des Bildes wird dadurch nicht direkt begrenzt. Ein Panoramafoto erscheint z.B. breiter als ein „normales“ Bild im 4x3- oder 16x9-Format. Denkbar ist auch eine Collage mehrerer kleiner Bilder, die untereinader montiert sind und dann als Streifen am linken Kartenrand erscheinen.

[[Datei:Spoiler Vorschau.png|miniatur|hochkant=0.8|Spoiler-Platzhalter]]

== Platzhalter ==
Bei Bildanhängen in Cachebeschreibungen und in Galerien erscheinen Platzhalter, wenn ein Bild dort nicht als Miniatur dargestellt werden kann oder soll. Den [[Spoiler]]-Platzhalter hast du vielleicht schon in dem einen oder anderen Cachelisting gesehen.

[[Datei:Thumbnail-formaterror.png|hochkant=0.8|miniatur]]
Die Anzeige „Unbekanntes Dateiformat“ kann z. B. bei JPEG-Bildern erscheinen, deren Dateiformat-Variante vom Miniaturbildgenerator nicht verstanden wird.

Die Bilder selbst sind immer anzeigbar, indem man auf den Platzhalter klickt.

[[Kategorie:Opencaching]]

Bilder

2014-03-19T16:52:29Z

Dl6hbo:

[[Datei:OC5E7A-2.jpg|miniatur|hochkant=1.2|Logbild von {{Cachelink|OC5E7A}}]]
In [[Cachebeschreibung (Listing)|Cachebeschreibungen]] und [[Das Onlinelog|Logs]] können Bilder hinzugefügt werden, zum Beispiel um einen Eindruck von der Umgebung des Caches zu vermitteln oder um die Cachesuche zu dokumentieren. Bei [[Cachearten#Webcam-Cache|Webcam-Caches]] gehört zu jedem Log auch eine Webcam-Aufnahme.

Das Hinzufügen von Bildern zu deinen Cachebeschreibungen ist unter [[Erstellen einer Cachebeschreibung/ Listing#Bilder hinzufügen|Erstellen einer Cachebeschreibung]] beschrieben, wie du Logbilder hochlädst unter [[Das Onlinelog#Fotos hinzufügen|Das Onlinelog]]. Die Bilder dürfen maximal 150 KB groß sein und sind ggf. vor dem Hochladen mit einem Bildbearbeitungsprogramm zu verkleinern. Es werden die Dateiformate JPEG, GIF, PNG und BMP unterstützt.

Bilder, deren längere Seite größer als 1024 Pixel ist, werden proportional verkleinert, so dass diese Seite 1024 Pixel misst. Unterstützt werden nur die angegebenen Bildformate deren Größe das genannte Maximum nicht überschreiten.
Dies ist eine neue Funktion. Bitte berichtet uns, falls sie noch nicht wie gewünscht funktioniert.
Die Funktion ist automatisiert und ''schert daher alles über einen Kamm''. Es kann also zur Qualitätsverschlechterung Deiner Bilder kommen. Solltest Du das vermeiden wollen, so solltest Du die Verkleinerung mit Deinen optimalen Werkzeugen vor dem Hochladen auf Deinem Rechner erledigen.

== Galerien ==
Logbilder erscheinen in verschiedenen Galerien:
* Die neuesten sechs Bilder direkt auf der [http://www.opencaching.de/ Startseite]. Dabei wird maximal ein Bild pro Benutzer und Tag sowie pro Cache und Tag angezeigt.
* Die neuesten 48 Bilder in auf der Seite „[http://www.opencaching.de/ Logbildgalerie]“, ereichbar im Menü der Startseite; maximal ein Bild pro Benutzer und Tag, das nicht das gleiche sein muss wie auf der Startseite;
* deine sechs neuesten Bilder in deinem [http://www.opencaching.de/myhome.php Benutzerprofil]
* alle deine hochgeladenen Logbilder über den Link [http://www.opencaching.de/myhome.php?allpics=1 alle anzeigen] in deinem (nicht-öffentlichen) Benutzerprofil
* alle hochgeladenen Bilder eines Benutzers – ausgenommen [[Spoiler]] – in dessen öffentlichem Benutzerprofil über den Link „Logbilder - alle anzeigen“, sofern er diesen nicht deaktiviert hat.

In deinen [http://www.opencaching.de/mydetails.php Profileinstellungen] kannst du festlegen, ob deine persönliche Bildstatistik und -galerie für andere Benutzer sichtbar ist oder nicht.

Die Bilder aus einer Galerie lassen sich durchblättern, sobald eines davon per Anklicken vergrößert wurde. Am einfachsten geht dies mit dem Mausrad oder mit den Pfeiltasten nach links und rechts.

== Kartenvorschaubilder ==
Wenn du ein Bild zu einer Cachebeschreibung hochlädst kannst du ankreuzen, dass es sich um das Vorschaubild für die [[Cachekarte]] handelt. Dieses Bild erscheint links oben in der Kartenansicht, wenn jemand auf das Symbol des Caches klickt. War bereits ein anderes Vorschaubild gewählt, so wird dies auf der Karte durch das neue ersetzt.

Die Darstellungsgröße der Vorschaubilder kann jeder Benutzer für sich in den Karteneinstellungen festlegen, und zwar in Prozent der Kartenfläche. Das heißt: Die Breite oder Höhe des Bildes wird dadurch nicht direkt begrenzt. Ein Panoramafoto erscheint z.B. breiter als ein „normales“ Bild im 4x3- oder 16x9-Format. Denkbar ist auch eine Collage mehrerer kleiner Bilder, die untereinader montiert sind und dann als Streifen am linken Kartenrand erscheinen.

[[Datei:Spoiler Vorschau.png|miniatur|hochkant=0.8|Spoiler-Platzhalter]]

== Platzhalter ==
Bei Bildanhängen in Cachebeschreibungen und in Galerien erscheinen Platzhalter, wenn ein Bild dort nicht als Miniatur dargestellt werden kann oder soll. Den [[Spoiler]]-Platzhalter hast du vielleicht schon in dem einen oder anderen Cachelisting gesehen.

[[Datei:Thumbnail-formaterror.png|hochkant=0.8|miniatur]]
Die Anzeige „Unbekanntes Dateiformat“ kann z. B. bei JPEG-Bildern erscheinen, deren Dateiformat-Variante vom Miniaturbildgenerator nicht verstanden wird.

Die Bilder selbst sind immer anzeigbar, indem man auf den Platzhalter klickt.

[[Kategorie:Opencaching]]

Bilder

2014-03-12T15:50:22Z

Dl6hbo:

[[Datei:OC5E7A-2.jpg|miniatur|hochkant=1.2|Logbild von {{Cachelink|OC5E7A}}]]
In [[Cachebeschreibung (Listing)|Cachebeschreibungen]] und [[Das Onlinelog|Logs]] können Bilder hinzugefügt werden, zum Beispiel um einen Eindruck von der Umgebung des Caches zu vermitteln oder um die Cachesuche zu dokumentieren. Bei [[Cachearten#Webcam-Cache|Webcam-Caches]] gehört zu jedem Log auch eine Webcam-Aufnahme.

Das Hinzufügen von Bildern zu deinen Cachebeschreibungen ist unter [[Erstellen einer Cachebeschreibung/ Listing#Bilder hinzufügen|Erstellen einer Cachebeschreibung]] beschrieben, wie du Logbilder hochlädst unter [[Das Onlinelog#Fotos hinzufügen|Das Onlinelog]]. Die Bilder dürfen maximal 150 KB groß sein und sind ggf. vor dem Hochladen mit einem Bildbearbeitungsprogramm zu verkleinern. Es werden die Dateiformate JPEG, GIF, PNG und BMP unterstützt.

Bilder, deren längere Seite größer als 1024 Pixel ist, werden proportional verkleinert, so dass diese Seite 1024 Pixel misst. Unterstützt werden nur die angegebenen Bildformate deren Größe das genannte Maximum nicht überschreiten.
Dies ist eine neue Funktion. Bitte berichtet uns, falls sie noch nicht wie gewünscht funktioniert.

== Galerien ==
Logbilder erscheinen in verschiedenen Galerien:
* Die neuesten sechs Bilder direkt auf der [http://www.opencaching.de/ Startseite]. Dabei wird maximal ein Bild pro Benutzer und Tag sowie pro Cache und Tag angezeigt.
* Die neuesten 48 Bilder in auf der Seite „[http://www.opencaching.de/ Logbildgalerie]“, ereichbar im Menü der Startseite; maximal ein Bild pro Benutzer und Tag, das nicht das gleiche sein muss wie auf der Startseite;
* deine sechs neuesten Bilder in deinem [http://www.opencaching.de/myhome.php Benutzerprofil]
* alle deine hochgeladenen Logbilder über den Link [http://www.opencaching.de/myhome.php?allpics=1 alle anzeigen] in deinem (nicht-öffentlichen) Benutzerprofil
* alle hochgeladenen Bilder eines Benutzers – ausgenommen [[Spoiler]] – in dessen öffentlichem Benutzerprofil über den Link „Logbilder - alle anzeigen“, sofern er diesen nicht deaktiviert hat.

In deinen [http://www.opencaching.de/mydetails.php Profileinstellungen] kannst du festlegen, ob deine persönliche Bildstatistik und -galerie für andere Benutzer sichtbar ist oder nicht.

Die Bilder aus einer Galerie lassen sich durchblättern, sobald eines davon per Anklicken vergrößert wurde. Am einfachsten geht dies mit dem Mausrad oder mit den Pfeiltasten nach links und rechts.

== Kartenvorschaubilder ==
Wenn du ein Bild zu einer Cachebeschreibung hochlädst kannst du ankreuzen, dass es sich um das Vorschaubild für die [[Cachekarte]] handelt. Dieses Bild erscheint links oben in der Kartenansicht, wenn jemand auf das Symbol des Caches klickt. War bereits ein anderes Vorschaubild gewählt, so wird dies auf der Karte durch das neue ersetzt.

Die Darstellungsgröße der Vorschaubilder kann jeder Benutzer für sich in den Karteneinstellungen festlegen, und zwar in Prozent der Kartenfläche. Das heißt: Die Breite oder Höhe des Bildes wird dadurch nicht direkt begrenzt. Ein Panoramafoto erscheint z.B. breiter als ein „normales“ Bild im 4x3- oder 16x9-Format. Denkbar ist auch eine Collage mehrerer kleiner Bilder, die untereinader montiert sind und dann als Streifen am linken Kartenrand erscheinen.

[[Datei:Spoiler Vorschau.png|miniatur|hochkant=0.8|Spoiler-Platzhalter]]

== Platzhalter ==
Bei Bildanhängen in Cachebeschreibungen und in Galerien erscheinen Platzhalter, wenn ein Bild dort nicht als Miniatur dargestellt werden kann oder soll. Den [[Spoiler]]-Platzhalter hast du vielleicht schon in dem einen oder anderen Cachelisting gesehen.

[[Datei:Thumbnail-formaterror.png|hochkant=0.8|miniatur]]
Die Anzeige „Unbekanntes Dateiformat“ kann z. B. bei JPEG-Bildern erscheinen, deren Dateiformat-Variante vom Miniaturbildgenerator nicht verstanden wird.

Die Bilder selbst sind immer anzeigbar, indem man auf den Platzhalter klickt.

[[Kategorie:Opencaching]]

Wie finde ich meinen ersten Cache?

2014-03-06T17:25:43Z

Dl6hbo: /* Einen Geocache auf das Navigationsgerät übertragen */

Erste Schritte auf Opencaching.de

Um einen Cache auf Openaching.de zu suchen, muss man sich '''nicht''' [[Registrierung|registrieren]]!

== Einen Cache aus dem Internet heraussuchen ==

=== Variante 1: Das [[Suchformular]] ===
'''Von der [http://www.opencaching.de/index.php?id=63 Opencaching Startseite] aus den Button ''Caches'' klicken.'''

Dieser öffnet die Auswahl an Parametern nach denen gesucht wird. Dort muss zunächst eine Auswahl getroffen werden, welche Geocaches gewünscht werden. Für den Anfang eignen sich am besten zunächst Caches des Typs [[Cachearten|normaler Geocache]] in den [[Behältergrößen|Größen]] Klein oder Normal, mit [[Schwierigkeitswertung|Schwierigkeits-]] und [[Geländewertung]] 1–2.
Als nächster Schritt wird dann die Gegend gewählt, in der sich der Geocache befinden soll.
Diese bestimmt man zu Beginn am besten über die Postleitzahl oder den Ortsnamen. Hierzu muss in der obersten Reihe bei Ausgabe sortieren nach: Entfernung angehakt sein.

Ist dies eingegeben, musst du nur noch den dahinter liegenden Button Suchen anklicken, und schon wird die Liste der nächstgelegenen Caches in aufsteigender Entfernung angezeigt. Von hier aus können die einzelnen Geocaches angeklickt und näher angeschaut werden.

Rechts oben in der Cachebeschreibung (auch ''Listing'' genannt) befindet sich eine kleine Karte. Klickt man einen der Links darunter an, öffnet sich eine größere Karte, auf der du erkennen kannst, in welcher Umgebung der Cache liegt. Dort findest du auch weitere Caches in der Nähe.

=== Variante 2: Die Karte ===
'''Von der [http://www.opencaching.de/index.php?id=63 Opencaching Startseite] aus den Button ''Karte'' klicken.'''

Es öffnet sich eine [[Cachekarte|Kartenansicht]], auf der Geocaches als Symbole eingezeichnet sind. Die Karte kann, wie z. B. von Google Maps gewohnt, mit der Maus bedient werden (verschieben, zoomen durch das Mausrad, usw.); zusätzlich kann man im Suchfeld nach Orten suchen.
Klickt man eines der Geocachesymbole auf der Karte an, öffnet sich ein Popupfenster mit den wichtigsten Informationen zum betreffenden Geocache; mit einem Klick auf den Namen des Geocaches gelangt man direkt zur vollständigen Cachebeschreibung.

Fortgeschrittene Nutzer können Filter benutzen um nur bestimmte Geocaches auf der Karte anzuzeigen; die Filtereinstellungen befinden sich direkt unterhalb der Kartenansicht. Möchte man beispielsweise nur Geocaches angezeigt bekommen, die einen Behälter haben, in den auf jeden Fall [[Tauschgegenstände]] passen, entfernt man aus der Liste "CACHE BEHÄLTER" alle Häkchen bis auf diejenigen bei ''klein'', ''normal'', ''groß'' und ''extrem groß''.

== Einen Geocache auf das Navigationsgerät übertragen ==
Ist ein bestimmter Geocache ausgewählt, geht es wie folgt weiter:

[[Datei:Cachedownload.png|thumb|rechts|Download-Buttons im Listing|400px]]
[[GPS-Gerät]] per USB-Kabel mit dem PC verbinden, und warten bis der PC dieses erkannt hat. Falls es sich um ein Garmin-Gerät handelt: Im Listing unter dem ersten Datenblock auf '''An GPS-Gerät senden''' klicken, und schon wird die Cachebeschreibung übertragen. Vor der ersten Übertragung muss möglicherweise noch ein „Plugin“ für das entsprechende Gerät heruntergeladen werden. In diesem Fall einfach der dortigen Menüführung folgen.

Wenn es kein Garmin-Gerät ist, kannst du Wegpunkt und Koordinaten dort entweder von Hand eingeben, oder du überträgst das Listing als [[GPX-Datei]]. Dazu lädst du die Daten mit dem Knopf '''Download als …''' (Auswahl: GPX) herunter und mit einem zusätzlichen Programm wie [[OpenCacheManager]] auf das GPS-Gerät. Wahrscheinlich lag deinem Gerät auch entsprechende Software bei.

Ist der Geocache fertig übertragen, kann das Gerät abgestöpselt werden und der Outdoorteil kann beginnen. '''Für den Anfang empfiehlt es sich immer, das Listing noch auszudrucken und mitzunehmen.'''

Kleiner Tip: Viele Geocaches haben sog. [[Hinweise|verschlüsselte Hinweise]]. Diese kann man, wenn man sie nutzen möchte (für Anfänger auf jeden Fall empfohlen) vor dem Ausdruck entschlüsseln, indem man in der Cachebeschreibung auf '''Entschlüsseln''' klickt.

== Der Outdoorteil ==
Ist der Geoache auf das Gerät überspielt, kann der Outdoorteil beginnen.

Zunächst auf dem [[GPS-Gerät]] den zu suchenden Geoache auswählen. Dies funktioniert bei jedem Gerät anders, Bedienungsanleitung beachten. Meist gibt es eine Funktion Suche. In dieser „Geocaches“ auswählen und den gewünschten Geocache anwählen. Los drücken und ab auf die Suche.

Viele Geräte haben ein Kompassfeld, in dem man dann die Annäherung an das Ziel in einem der Datenfelder anzeigen lassen und ablesen kann.
Zeigt dieses null Meter an, steht man nicht automatisch vor dem Geocache, auch wenn das schön wäre. Es gibt immer gewisse Abweichungen in den Koordinaten durch [[GPS#Genauigkeit|Schwankungen der Empfangsqualität]] zu rechnen – 5–10 Meter Abweichung sind normal, aber auch 20 Meter kommen vor. Daher ist vorsichtiges Suchen angesagt, wenn man vor Ort angekommen ist. Hier kann der entschlüsselte Hinweis eine weitere Unterstützung sein. Bitte stets vorsichtig suchen, die [[Naturschutz|Natur]] wird es dir danken. Wenn andere Leute (nach Harry Potter „Muggels“ benannt) in der Nähe sind, besser erst mal warten bis diese verschwunden sind und dann suchen. Nicht jeder hat Verständnis für unser Hobby. Werden Verstecke durch unvorsichtiges Suchen verrraten, kommt es nicht selten vor, dass sie ausgeraubt („gemuggelt“) werden.

== Dose gefunden – und was jetzt? ==
'''Erst mal herzlichen Glückwunsch, Du hast deinen ersten Geocache gefunden!'''

In der Dose befindet sich immer mindestens das [[Logbuch]]. In diesem verewigt man sich mit dem Usernamen, den man sich bei der [[Registrierung]] zugelegt hat, Datum und evtl. Uhrzeit. Befinden sich [[Tauschgegenstände]] in der Dose, kann nach Belieben etwas getauscht werden (besonders beliebt bei Kindern), dabei aber bitte immer '''gleichwertig, oder höherwertig''' tauschen. Nichts ist so frustrierend, gerade für Kinder, wie eine Dose voll Schrott.
Es können sich auch sog. [[Reisende]] in der Dose befinden. Diese können ohne Tausch mitgenommen werden, um sie zu einem anderen Geocache reisen zu lassen. Bitte aber '''nur dann''' Reisende mitnehmen, wenn man sie auch wirklich ordnungsgemäß [[log]]gen will.

Ist dies alles abgeschlossen, wird die Dose wieder versteckt, wie sie vorgefunden wurde. Die Tarnung darf natürlich leicht verbessert werden falls die Dose schlecht getarnt war, aber '''''keinesfalls''''' soll eine Dose [[Fachjargon#umverstecken|an einer anderen Stelle versteckt]] werden, auch wenn eine andere Stelle geeigneter erscheint. '''Einzige Ausnahme:''' Die Dose war offensichtlich nicht mehr in ihrem Versteck und lag offen herum. Dann ist es sinnvoll sie dort zu verstecken, wo man vermutet, dass sie vorher versteckt war. In diesem Fall sollte man am besten zusätzlich noch den [[Owner]] darüber informieren, wie man die Dose vorgefunden und wie man sie versteckt hat (am besten mit Fotos). Sollte es sich dann nicht um das richtige Versteck handeln, kann der Owner darauf reagieren, aber der Cache ist auf jeden Fall erst einmal gerettet.

== Und danach? ==
'''Heim zum [[Das Onlinelog|Onlinelog]].'''

[[Kategorie:Opencaching]]

[[pl:Szukanie skrzynki]]

Smartphone-Apps für Opencaching.de

2013-12-21T14:57:20Z

Dl6hbo:

Diese Seite beschreibt Apps für das [[Smartphone-Caching]] auf Opencaching.de.

Inzwischen ist auch das [[Das Onlinelog|Loggen]] über eine App möglich. Aber nicht alle Apps unterstützen diese Möglichkeit. Des weiteren gibt es einige Möglichkeiten, OC-Caches auf dein Handy zu bringen. Hierzu zeigen wir, wie man die GPX Datei importiert.

''Siehe auch:'' [[Wie erhalte ich eine GPX-Datei?]]

== Android ==
Aktuell ist ein Loggen über eine App nur mit [[OKAPI]] möglich.

=== BikeAtor ===
* [http://www.bikeator.com/ BikeAtor]
* [https://play.google.com/store/apps/details?id=com.bikeator.bikeator_alpha BikeAtor bei Google play]

Wenn Opencaching.de in den Einstellungen aktiviert ist, dann können über das Popupmenü auf der Karte (langes Drücken) Geocaches von Opencaching.de heruntergeladen werden. Die Cachebeschreibungen (ohne Bilder) sind dann Offline verfügbar. Loggen über [[OKAPI]] ist ebenfalls ab Version 0.1.0e möglich.

==== Geocaches installieren für Offlinenutzung ====
BikeAtor speichert alle heruntergeladenen Geocaches in einer Datenbank (Ohne Bilder).

==== Karten installieren für Offlinenutzung ====
BikeAtor speichert alle heruntergeladenen Bilder in einer Datenbank für den Offlinegebrauch. Über das Popupmenü auf der Karte, kann ein Kartenausschnitt in weiteren Zoomstufen herunter geladen werden.

=== c:geo ===
* [http://www.cgeo.org/ c:geo]
* [https://play.google.com/store/apps/details?id=cgeo.geocaching c:geo bei Google play]

==== Direkter Zugriff ====
Ab der Version 2013.08.24 hat c:geo einen direkten Zugriff auf die Cachedatenbank von Opencaching.de via [[OKAPI]].
Über 'Menü' > 'Dienste' kann man Opencaching.de einfach aktivieren. Nun hat man alle Möglichkeiten offen.
<gallery>
CgeoMenue.jpg |Menü --> Einstellungen
CgeoEin1.jpg |Dienste auswählen
CgeoOC1.jpg |Natürlich Opencaching.de
CgeoOC2.jpg |'''1''' Aktivieren und danach noch '''2''' c:geo autorisieren
CgeoOC3.jpg |Die Autoriersung starten, dann öffnet sich automatisch
CgeoOC4.jpg |die OC Website mit einem Code den man kopieren muss (ggf. vorher noch Opencaching.de am Handy einloggen)
CgeoOC5.jpg |Einfügen und dann Fertig.
</gallery>
Ab jetzt kannst du alle OC-Caches mit c:geo unterwegs finden und auch loggen! Da aber nicht immer ein gutes Netz vorhanden ist, kann man die Caches auch vorab über eine .[[Abkürzungen#GPX|gpx]] Datei importieren.

==== GPX Import ====
Kopiere die .[[Abkürzungen#GPX|gpx]] Datei auf dein Handy am besten nach /sdcard/gpx oder falls du diesen nicht findest in einen anderen Ordner auf der SD Karte.

Vorab kann es empfehlenswert sein, in den Einstellungen die Häkchen bei den beiden Statischen Karten-Speicherungen zu entfernen. Das Laden der Statischen Karten benötigt teilweise viel Zeit.
<gallery>
CgeoMenue.jpg |Menü --> Einstellungen
CgeoEin2.jpg |--> Offlinedaten
Cgeooff.jpg |die Statischen Karten abwählen
</gallery>
Dann kannst Du beginnen, die GPX Datei zu importieren.
<gallery>
Cgeoeinstellung21.png|Gespeicherte Caches
Cgeoeinstellung22.png|Menü --> Verwalten (Disketten Symbol)
Cgeoeinstellung23.png|Importiere GPX Datei
Cgeoeinstellung24.png|c:geo durchsucht nun den Speicher
Cgeoeinstellung25.png|Datei auswählen, c:geo lädt nun die Caches. Das kann etwas dauern. '''Happy Opencaching'''
</gallery>

Um nachverfolgen zu können, welche Caches man bereits gefunden hat, kann man die gefundenen Caches in eine andere Liste verschieben.

==== Listen erstellen ====
<gallery>
Cgeoeinstellung21.png|Wähle gespeicherte Caches
Cgeoliste1.png|In der Grundeinstellung ist nur die Standardliste vorhanden. Drücke kurz darauf
Cgeoliste2.png|und es öffnet sich ein Menü, bei dem du eine Neue Liste erstellen kannst.
</gallery>

Es empfehlen sich zum Beispiel die Listen

* OC
* GC
* Zum Loggen

<gallery>
Cgeoliste4.png|Einen Cache kannst du verschieben, indem du lange auf ihn drückst,
Cgeoliste3.png|aus der Liste dann 'Verschieben' auswählst und dann die Liste aussuchst, in die du den Cache verschieben willst.
</gallery>
Zuhause kannst du dann die gefundenen Caches loggen.

=== Columbus ===
* [http://columbus.spacebreak.sk/ Columbus]
* [https://play.google.com/store/apps/details?id=geocaching.columbus Columbus bei Google play]
{{Überarbeiten|Loggen ist Möglich}}

==== Unterwegssuche ====
<gallery>
Columbussuche1.png|Markiere das obere linke Symbol<br> Menü --> Suche
Columbussuche2.png|Nächsten Online
Columbussuche4.png|Entfernung überprüfen, Koordinaten automatisch, Cache site kurz drücken
Columbussuche3.png|opencaching.de auswählen OK --> Caches werden geladen und angezeigt <br /> '''Happy Caching!'''
</gallery>

==== GPX Import ====
Du benötigst eine GPX-Datei von opencaching.de, siehe dazu [[Wie_erhalte_ich_eine_GPX-Datei%3F|Wie erhalte ich eine GPX-Datei?]].
Diese muss auf dem Handy, oder alternativ in einem Dropbox-Konto entpackt gespeichert sein.

<gallery>
Columbusgpx1.png|Markiere das obere rechte Symbol und danach GPX importieren
Columbusgpx2.png|ggf. Gruppe auswählen, Cache Site kann ignoriert werden, auf Ordner klicken
Columbusgpx3.png|Dropbox Konto öffnen, verbinden, Datei auswählen, sie wird geladen, bzw. Datei von der SD-Karte auswählen
Columbusgpx4.png|den Import Starten '''Happy Caching'''
</gallery>

=== GeOrg ===
* [http://android.ranitos.de/ Georg]
* [https://play.google.com/store/apps/details?id=de.ranitos.georg GeOrg bei Google play]
* [https://play.google.com/store/apps/details?id=de.ranitos.georg.connector.oc GeOrg - opencaching.de bei Google play]

GeOrg verwaltet Caches in einer (oder mehreren) "CacheDB". Caches, die in der "CacheDB" vorhanden sind, sind auf dem Smartphone gespeichert und können ohne Datenverbindung abgerufen werden.

Caches von Opencaching.de können auf zwei Arten in die "CacheDB" gelangen: (1) über den OC-Connector, der eine Online-Verbindung mit Opencaching.de herstellt, oder (2) über den Import von GPX-Dateien. Die Variante über den OC-Connector ist vor allem dann praktisch, wenn man unterwegs ist und einzelne OC-Caches in der Umgebung suchen möchte. Über den GPX-Import hingegen können große Mengen an Caches auf einen Schlag in die "CacheDB" gebracht werden.

==== Online Zugriff auf Opencaching.de via Connector ====
Damit GeOrg online auf die Cache-Datenbank von Opencaching.de zugreifen kann, muss zuerst der "OC-Connector" über "Google play" installiert werden ([https://play.google.com/store/apps/details?id=de.ranitos.georg.connector.oc GeOrg - opencaching.de]) und im Optionsmenü unter den "Connector - Options" aktiviert werden:

<gallery>
georg-optionsmenue.png|Im "Optionsmenü"...
georg-connector-aktivieren.png|"OC-Connector" aktivieren
</gallery>

Nun kann der OC-Connector in der Kartenansicht als Quelle ausgewählt werden:

<gallery>
georg-karte.png|In der Kartenansicht...
georg-karte-menue.png|das Menü öffnen...
georg-karte-connector.png|und den OC-Connector als Quelle auswählen.
</gallery>

Ab sofort zeigt die Karte Geocaches von Opencaching.de an!

<gallery>
georg-karte-caches.png|Cache antippen...
georg-karte-popup.png|Ein Popup mit den Cacheinfos erscheint. Klickt man diesen an...
georg-karte-import.png|öffnet sich ein Menü, mit dem man den Cache auf's Smartphone importieren kann.
</gallery>

Alternativ können Caches über die "In der Nähe"-Ansicht gesucht werden:
<gallery>
georg-connector-naechste.png|Nächste Caches bei Opencaching.de
georg-naechste-import.png|Auch von hier kann man Caches auf's Smartphone importieren
</gallery>

Importierte Caches landen in der "CacheDB" und können von dort aus angezeigt werden:

<gallery>
georg-listing.png|Listing
</gallery>

==== Import von GPX-Dateien ====
Kopiere dazu eine GPX-Datei in den Speicher des Smartphones.

Diese kann in der "CacheDB"-Ansicht mit dem Menüpunkt "GPX-Import" importiert werden:

<gallery>
georg-cachedb.png|In der "CacheDB" auf "GPX-Import" tippen
georg-cachedb-import.png|Die passende GPX-Datei wählen...
georg-cachedb-importing.png|...und importieren lassen.
georg-cachedb-imported.png|Die Caches der GPX-Datei sind jetzt der "CacheDB" vorhanden...
georg-listing.png|und können von dort aus angezeigt werden.
</gallery>

=== Locus ===
* [http://www.locusmap.eu/?lang=de Locus]
* [https://play.google.com/store/apps/details?id=menion.android.locus.pro&hl=de Locus Pro bei Google play]
* [https://play.google.com/store/apps/details?id=menion.android.locus&feature=more_from_developer#?t=W251bGwsMSwyLDEwMiwibWVuaW9uLmFuZHJvaWQubG9jdXMiXQ.. Locus Free bei Google play]

Locus ist ein vielfältige Kartenanwendung, unter anderem auch für Geocaching.
Es stehen eine kostenlose und eine kostenpflichtige Version bei Google Play zum Download bereit.

Caches von Opencaching.de können über den Import von GPX-Dateien unter Locus angezeigt und verwaltet werden. Der Import ist unkompliziert und schnell.

==== Import von GPX-Dateien ====
Kopiere dazu eine GPX-Datei in den Speicher des Smartphones.

Diese kann in der Daten-Ansicht importiert werden:

<gallery>
Locus A - Karte.png|In der Kartenansicht auf das Datenbanksymbol tippen
Locus B - Daten.png|Über die "+" Schaltfläche eine neue Kategorie hinzufügen, z.B. "oc.de"
Locus D - Import_auswählen.png|Durch tippen auf die drei Punkte das Importmenü aufrufen
Locus E - Datei_auswählen.png|Die GPX-Datei unter "LOKALE DATEI" auswählen und laden
Locus F - Import_starten.png|Kategorie auswählen, Haken unter "Nach dem Import auf der Karte zeigen" setzen und "Importieren" anwählen
Locus G - Cache_auswählen.png|Cachesymbol antippen
Locus H - Kurzansicht.png|Kurzansicht des Caches, Listing aufrufen durch das Symbol ganz links
Locus I - Cachelisting.png|Ansicht der D/T-Wertung, Behältergröße und Attributen -> Listing und Logs in extra Reiter
</gallery>

==== Karten installieren für Offlinenutzung ====
Locus unterstützt vektorbasiertes Kartenmaterial. Im Vergleich zu Karten, die aus einzelnen Kacheln bestehen, kann so deutlich Speicher eingespart werden.

Auf OSM basierende Karten werden auf verschiedenen Seiten kostenlos angeboten wie z.B.

* [http://www.openandromaps.org openandroidmaps]
* [http://www.vectormaps4locus.eu vectormaps4locus]
* [http://www.easyclasspage.de/maps/index.html Freizeitkarte]

und einigen mehr.

Gerade die Freizeitkarte läßt sich sehr komfortabel in Locus nutzen. Man kann diese Karten auf den PC laden, entpacken und auf die Speicherkarte des Handys laden, oder direkt den Link im Android-Browser öffnen und damit die Karten und das Theme direkt an die richtige Stelle auf der Speicherkarte ablegen.

Automatischer Download über Locus:
* im Android-Browser die [http://www.easyclasspage.de/maps/index.html Freizeitkarte] aufrufen
* gewünschte Karte auswählen und über den entsprechenden Locus-Button den Download starten
* Karte und Design werden direkt an richtiger Stelle auf der Karte abgelegt
* Einstellung unter Locus: Einstellungen → Karte-Erweitert → Thema der Karte → Freizeitkarte auswählen

Manueller Download über PC:
* gewünschte Karte(n) auswählen und herunterladen
* Datei(n) entpacken
* Karte (*.map) auf SD Karte kopierenn → Locus/mapsVector
* Design herunterladen
* Design entpacken
* Design (Verzeichnis freizeitkarte) auf SD Karte kopieren → Locus/mapsVector/_themes
* Einstellung unter Locus: Einstellungen → Karte-Erweitert → Thema der Karte → Freizeitkarte auswählen

Diese Karten können anschließend auch unter c:geo genutzt werden.

=== OCM ===
[http://opencachemanage.sourceforge.net/ocmmobileedition.html OCM Mobile Edition]

Vom OpenCacheManager gibt es auch eine Mobile Edition. Diese wird mit den Daten der [[OpenCacheManager|PC-Version]] versorgt.

{{Unvollständig|Screenshots, Beschreibung}}

== iOS ==
* [http://www.btstsoft.nl/gcbuddy4oc/ Geocaching Buddy 4 OC]

== WindowsPhone ==
* [http://www.windowsphone.com/de-de/store/app/me-caching-geo-oc-de/437b17fe-b701-44cd-bc90-2b93d4a19119 Me Caching Geo OC.DE]

[[Kategorie:Opencaching]]
[[Kategorie:Geocaching-Software]]

{{Überarbeiten|iOS und Windows Phone}}

2013-11-17T08:32:28Z

Dl6hbo: /* Wie kann ich mich vom Newsletter abmelden? */

Um über Neuerungen, Updates, neue Features und sonstige Themen rund um [[Opencaching.de]] zu informieren, wurde im November/ Dezember 2013 eine Newsletterverwaltung eingeführt. Die Häufigkeit des Newsletters ist pro Jahr auf max. 5 Aussendungen begrenzt.

== Wer empfängt den Newsletter? ==
Jeder, der im [[Benutzerprofil]] einen Haken beim Newsletterempfang gesetzt hat. Zum Start dieser Erweiterung wurden standardmäßig alle Optionen eingecheckt, dass heisst jedes Mitglied mit gültiger EMail Adresse wird diesen Newsletter empfangen.

== Wie kann ich mich vom Newsletter abmelden? ==
In eurem Profil habt ihr die Möglichkeit, über den Button '''Ändern''' eure Einstellungen zu bearbeiten. Klickt dazu auf '''Mein Profil''' -> '''Profildaten''' -> '''Ändern''' um dorthin zu gelangen. Wenn ihr etwas geändert habt, vergesst nicht, dies über den Button '''Bestätigen''' zu aktivieren.
Ist der Haken gesetzt, empfangt ihr den Newsletter, ist er nicht gesetzt, werdet ihr von uns auch keine News erhalten.

<gallery>
Newsletter_abbestellen01.png|''Mein Profil'' - ''Profildaten'' - ''Ändern''
Newsletter_abbestellen02.png|entsprechenden Haken entfernen und auf ''Bestätigen'' klicken
</gallery>

[[Kategorie:Opencaching]]

2013-11-17T08:31:11Z

Dl6hbo: /* Wer empfängt den Newsletter? */

Um über Neuerungen, Updates, neue Features und sonstige Themen rund um [[Opencaching.de]] zu informieren, wurde im November/ Dezember 2013 eine Newsletterverwaltung eingeführt. Die Häufigkeit des Newsletters ist pro Jahr auf max. 5 Aussendungen begrenzt.

== Wer empfängt den Newsletter? ==
Jeder, der im [[Benutzerprofil]] einen Haken beim Newsletterempfang gesetzt hat. Zum Start dieser Erweiterung wurden standardmäßig alle Optionen eingecheckt, dass heisst jedes Mitglied mit gültiger EMail Adresse wird diesen Newsletter empfangen.

== Wie kann ich mich vom Newsletter abmelden? ==
In eurem Profil habt ihr die Möglichkeit, über den Button '''Ändern''' eure Einstellungen zu bearbeiten. Klickt dazu auf '''Mein Profil''' -> '''Profildaten''' -> '''Ändern''' um dorthin zu gelangen. Wenn ihr etwas geändert habt, vergesst nicht dies über den Button '''Bestätigen''' zu aktivieren.
Ist der Haken gesetzt, empfangt ihr den Newsletter, ist er nicht gesetzt, werdet ihr von uns auch keine News erhalten.

<gallery>
Newsletter_abbestellen01.png|''Mein Profil'' - ''Profildaten'' - ''Ändern''
Newsletter_abbestellen02.png|entsprechenden Haken entfernen und auf ''Bestätigen'' klicken
</gallery>

[[Kategorie:Opencaching]]

Opencaching-Etikette

2013-11-16T08:16:00Z

Dl6hbo: /* Fair- Play auf Opencaching.de */

Oder die ungeschriebenen Regeln des Geocachens

[[Geocaching]] ist ein Hobby bei dem man, wie überall, auch einige Regeln befolgen sollte, damit alle langfristig Spaß am Hobby haben.

== Grundsätzlich kann man sich an folgende Worte halten: ==

*Verhalte Dich unauffällig und lasse Dich beim Cachen möglichst nicht “erwischen”. Verrate keine Cacheverstecke an [[Muggel]]s.
* Beachte, dass man in [[Naturschutz|Naturschutzgebieten]] den Weg nicht verlassen darf.
* Respektiere kenntlich gemachte Privatgrundstücke (z.B.: Betreten verboten oder Privat).
* Hinterlasse keinen Müll, sondern nimm diesen (falls vor Ort) bitte mit und entsorge ihn ordnungsgemäß.
* Gehe sorgsam mit dem Cache um und versuche Spuren zu vermeiden, die zum Cache führen.
* Bitte verhalte Dich fair beim Tauschen von [[Tauschgegenstände|Tauschgegenständen]].
* Beim Loggen sollten keine obszönen oder destruktiven Kommentare hinterlassen werden.
* Logge online bitte mit mehr als 3 Worten. Beschreibe, wie gut Dir der Cache gefallen hat, aber verrate keine Geheimnisse.
* Auch Fotos sind gern gesehen, aber auch hier gilt, dass diese keinen [[Spoiler|Hinweis auf das Versteck]] geben sollen.
* Ist ein Cache beschädigt oder das [[Logbuch]] nass oder fehlt ganz, so vermerke dies in deinem Log-Eintrag. Nur so kann der Owner nachbessern.
* Einen [[Abkürzungen#DNF|Did not find]] loggen ist nicht peinlich oder böse, sondern hilfreich und vernünftig.
* Wenn ein Cache gegen die [[Opencaching.de-Nutzungsbedingungen]] verstößt, [[Cache melden|melde]] ihn bitte über den Melden-Button oben im Cachelisting.

== Beim Listing gibt es auch einige Hinweise, die beachtet werden sollen: ==

Einer unserer Grundgedanken ist, dass Qualität vor Quantität geht. Das heißt, wir haben lieber einen guten Cache als fünf langweilige [[Leitplankencache]]s.

Daher:

* Bitte trage die [[Wegpunkte]] ein, sofern der Cache auf anderen Plattformen gelistet ist.
* Eine Beschreibung der Örtlichkeit oder warum der Cache an dieser Stelle liegt, ist oft interessant und macht anderen Cachern Lust auf den Cache.
* Beachte [[Naturschutz|Naturschutzgebiete]], [[Privatgrund]] und [[Urheberrecht]]. Bei Missachtung sind wir (opencaching.de) gezwungen, den Cache zu sperren.
* Zur Schonung der Natur bitte [[Hinweise]] und ggf. [[Spoiler]]bilder nutzen.

== Qualität auf Opencaching.de ==
<p class="ocp3">Opencaching.de - Cachen mit Herz und Verstand!</p>

Opencaching.de würde gern eine Plattform zur Verfügung stellen, bei der das Cachen zu einem Erlebnis wird. Wir wünschen uns, dass ein Cache an einem tollen oder sehenswerten Ort versteckt wird, dass ein Cache mit einer schönen, ausgefallenen oder spannenden Geschichte aus dem Leben oder vielleicht auch aus der Fantasie verknüpft wird und dass ein Cache mit einer schönen und haltbaren Dose, vielleicht sogar mit einer Bastelarbeit oder elektronischen Spielerei, versteckt wird. Wir wünschen uns Geocaching mit Herz und Verstand, weil es Dir und uns so mehr Spass macht. Du solltest Dir selbst die Frage stellen, was Du als Erlebnis empfinden würdest.

Mit Deinem [[Das_Onlinelog|Log]] kannst Du Caches loben, dem [[Owner#Besitzer_.2F_Owner|Owner]] Danke sagen, aber auch auf Verbesserungspotenzial hinweisen. Mit solchen Rückmeldungen kann jeder Einzelne die Qualität von Opencaching.de fördern. Eine Bewertungsfunktion für Caches ist angedacht, muss aber noch entwickelt werden.

Im Folgenden einige Statements von Usern, wie sie sich Opencaching.de Caches wünschen, wie sie Qualität definieren

* ein Cache sollte Spaß machen, z.B. ein sehenswerter Ort, auf etwas Besonderes hinweisen, eine schöne Geschichte, eine kreative Bastelarbeit
* Bewusster Umgang mit der Natur in der wir uns bewegen, also Naturschutzgebiete beachten, Futterstellen usw. meiden, Caches umweltverträglich verstecken
* die [[Fachjargon#Location|Location]] ist das Wichtigste
* es gibt auch einige gute Powertrails, aber 50 mal (oder 500 mal) die Filmdose am identischen Versteck suchen ist uninteressant und langweilig
* es gibt auch Stellen, an denen Micros/Nanos die richtige Wahl sind, aber überlege, ob der Cache unbedingt an der Stelle sein muss, wenn nichts größeres möglich ist
* lieber einen [[Cachegrößen#Klein|Kleinen]] Cache legen als einen [[Cachegrößen#Mikro|Mikro]] oder [[Cachegrößen#Nano|Nano]]
* Verstecke keinen Cache, nur um einen Cache zu verstecken, überlege dir eine schöne Story, suche einen schönen Platz und lass dir Zeit
* lieber einen guten Cache als 20 schlechte Caches
* Jeder fängt klein an, bei Fragen / Unsicherheiten zu deinen Ideen melde dich doch im [http://forum.opencaching-network.org/index.php?board=30.0 Forum], wir helfen dir gern.

== Fair- Play auf Opencaching.de ==

Unsere Plattform läßt Dir jede Menge Freiheiten, Dich beim Legen und z.T. auch beim Loggen von Caches kreativ zu betätigen. Dennoch bitten wir Dich einige Dinge zu beherzigen, damit das Spiel für alle schön und fair bleibt.

* schreibe in Deinen Logs immer nur etwas zum Cache, persönliche Meinungen über den Owner haben dort nichts zu suchen!
* sei ehrlich in deinen Logs, mache keinen Cache nieder, weil Du den Owner nicht magst
* logge nur Caches als gefunden, die du auch wirklich gefunden hast
* wenn Du einen Cache nicht gefunden hast logge auch dies, am besten mit Grund
* logge Deinen eigenen Cache nicht als Fund und vor allem
* gib keine Empfehlungen für Deine eigenen Caches!!!!!
* spiele nicht mit "Sockenpuppenaccount", steh zu dem was Du tust und schreibst
* gib bei Deinen Caches immer korrekte Schwierigkeits und Geländewertungen an, Phantasiewerte um die Matrix voll zu bekommen helfen keinem
* beachte das Urheberrecht!!! Bei OCexternen Quellen im Zweifel besser Finger weg, bei OCinternen Quellen reicht sicher eine nette Anfrage damit Du benutzen darfst was du brauchst. Sonst droht vor allem Dir unter Umständen eine teure Abmahnung vom Urheber!!!
* betreibe keinen [[Listingvandalismus]]. Du schädigst dadurch die Cacher, die Deinen Cache bereits gefunden haben. Das kann auch zur Sperrung Deines Accounts führen.

[[Kategorie:Opencaching|Etikette]]

[[pl:Kodeks geocachera]]

Opencaching-Etikette

2013-11-16T08:13:22Z

Dl6hbo: /* Qualität auf Opencaching.de */

Oder die ungeschriebenen Regeln des Geocachens

[[Geocaching]] ist ein Hobby bei dem man, wie überall, auch einige Regeln befolgen sollte, damit alle langfristig Spaß am Hobby haben.

== Grundsätzlich kann man sich an folgende Worte halten: ==

*Verhalte Dich unauffällig und lasse Dich beim Cachen möglichst nicht “erwischen”. Verrate keine Cacheverstecke an [[Muggel]]s.
* Beachte, dass man in [[Naturschutz|Naturschutzgebieten]] den Weg nicht verlassen darf.
* Respektiere kenntlich gemachte Privatgrundstücke (z.B.: Betreten verboten oder Privat).
* Hinterlasse keinen Müll, sondern nimm diesen (falls vor Ort) bitte mit und entsorge ihn ordnungsgemäß.
* Gehe sorgsam mit dem Cache um und versuche Spuren zu vermeiden, die zum Cache führen.
* Bitte verhalte Dich fair beim Tauschen von [[Tauschgegenstände|Tauschgegenständen]].
* Beim Loggen sollten keine obszönen oder destruktiven Kommentare hinterlassen werden.
* Logge online bitte mit mehr als 3 Worten. Beschreibe, wie gut Dir der Cache gefallen hat, aber verrate keine Geheimnisse.
* Auch Fotos sind gern gesehen, aber auch hier gilt, dass diese keinen [[Spoiler|Hinweis auf das Versteck]] geben sollen.
* Ist ein Cache beschädigt oder das [[Logbuch]] nass oder fehlt ganz, so vermerke dies in deinem Log-Eintrag. Nur so kann der Owner nachbessern.
* Einen [[Abkürzungen#DNF|Did not find]] loggen ist nicht peinlich oder böse, sondern hilfreich und vernünftig.
* Wenn ein Cache gegen die [[Opencaching.de-Nutzungsbedingungen]] verstößt, [[Cache melden|melde]] ihn bitte über den Melden-Button oben im Cachelisting.

== Beim Listing gibt es auch einige Hinweise, die beachtet werden sollen: ==

Einer unserer Grundgedanken ist, dass Qualität vor Quantität geht. Das heißt, wir haben lieber einen guten Cache als fünf langweilige [[Leitplankencache]]s.

Daher:

* Bitte trage die [[Wegpunkte]] ein, sofern der Cache auf anderen Plattformen gelistet ist.
* Eine Beschreibung der Örtlichkeit oder warum der Cache an dieser Stelle liegt, ist oft interessant und macht anderen Cachern Lust auf den Cache.
* Beachte [[Naturschutz|Naturschutzgebiete]], [[Privatgrund]] und [[Urheberrecht]]. Bei Missachtung sind wir (opencaching.de) gezwungen, den Cache zu sperren.
* Zur Schonung der Natur bitte [[Hinweise]] und ggf. [[Spoiler]]bilder nutzen.

== Qualität auf Opencaching.de ==
<p class="ocp3">Opencaching.de - Cachen mit Herz und Verstand!</p>

Opencaching.de würde gern eine Plattform zur Verfügung stellen, bei der das Cachen zu einem Erlebnis wird. Wir wünschen uns, dass ein Cache an einem tollen oder sehenswerten Ort versteckt wird, dass ein Cache mit einer schönen, ausgefallenen oder spannenden Geschichte aus dem Leben oder vielleicht auch aus der Fantasie verknüpft wird und dass ein Cache mit einer schönen und haltbaren Dose, vielleicht sogar mit einer Bastelarbeit oder elektronischen Spielerei, versteckt wird. Wir wünschen uns Geocaching mit Herz und Verstand, weil es Dir und uns so mehr Spass macht. Du solltest Dir selbst die Frage stellen, was Du als Erlebnis empfinden würdest.

Mit Deinem [[Das_Onlinelog|Log]] kannst Du Caches loben, dem [[Owner#Besitzer_.2F_Owner|Owner]] Danke sagen, aber auch auf Verbesserungspotenzial hinweisen. Mit solchen Rückmeldungen kann jeder Einzelne die Qualität von Opencaching.de fördern. Eine Bewertungsfunktion für Caches ist angedacht, muss aber noch entwickelt werden.

Im Folgenden einige Statements von Usern, wie sie sich Opencaching.de Caches wünschen, wie sie Qualität definieren

* ein Cache sollte Spaß machen, z.B. ein sehenswerter Ort, auf etwas Besonderes hinweisen, eine schöne Geschichte, eine kreative Bastelarbeit
* Bewusster Umgang mit der Natur in der wir uns bewegen, also Naturschutzgebiete beachten, Futterstellen usw. meiden, Caches umweltverträglich verstecken
* die [[Fachjargon#Location|Location]] ist das Wichtigste
* es gibt auch einige gute Powertrails, aber 50 mal (oder 500 mal) die Filmdose am identischen Versteck suchen ist uninteressant und langweilig
* es gibt auch Stellen, an denen Micros/Nanos die richtige Wahl sind, aber überlege, ob der Cache unbedingt an der Stelle sein muss, wenn nichts größeres möglich ist
* lieber einen [[Cachegrößen#Klein|Kleinen]] Cache legen als einen [[Cachegrößen#Mikro|Mikro]] oder [[Cachegrößen#Nano|Nano]]
* Verstecke keinen Cache, nur um einen Cache zu verstecken, überlege dir eine schöne Story, suche einen schönen Platz und lass dir Zeit
* lieber einen guten Cache als 20 schlechte Caches
* Jeder fängt klein an, bei Fragen / Unsicherheiten zu deinen Ideen melde dich doch im [http://forum.opencaching-network.org/index.php?board=30.0 Forum], wir helfen dir gern.

== Fair- Play auf Opencaching.de ==

Unsere Plattform läßt Dir jede Menge Freiheiten Dich beim Legen und z.T. auch bei, loggen von Caches kreativ zu betätigen. Dennoch bitten wir Dich einige Dinge zu beherzigen, damit das Spiel für alle schön und fair bleibt.

* schreibe in Deinen Logs immer nur etwas zum Cache, persönliche Meinungen über den Owner haben dort nichts zu suchen!
* sei ehrlich in deinen Logs, mache keinen Cache nieder, weil Du den Owner nicht magst
* logge nur Caches als gefunden, die du auch wirklich gefunden hast
* wenn Du einen Cache nicht gefunden hast logge auch dies, am besten mit Grund
* logge Deinen eigenen Caches nicht als Fund und vor allem
* gib keine Empfehlungen für Deine eigenen Caches!!!!!
* spiele nicht mit Sockenpuppenaccount, steh zu dem was Du tust und schreibst
* gib bei Deinen Caches immer korrekte Schwierigkeits und Geländewertungen an, Phantasiewerte um die Matrix voll zu bekommen helfen keinem
* beachte das Urheberrecht!!! Bei OCexternen Quellen im Zweifel besser Finger weg, bei OCinternen Quellen reicht sicher eine nette Anfrage damit Du benutzen darfst was du brauchst. Sonst droht vor allem Dir unter Umständen eine teure Abmahnung vom Urheber!!!
* betreibe keinen [[Listingvandalismus]]. Du schädigst dadurch die Cacher, die Deinen Cache bisher gefunden haben. Das kann auch zur Sperrung Deines Accounts führen.

[[Kategorie:Opencaching|Etikette]]

[[pl:Kodeks geocachera]]

Entwicklung/Datenbankversionierung

2013-10-24T10:00:53Z

Dl6hbo: /* Trigger & Stored Procedures */

Änderungen am Datenbankinhalt werden von den Entwicklern an vier Stellen eingepflegt:

* statische Daten in htdocs/doc/sql/static-data/data.sql
* stored procs & trigger in htdocs/doc/sql/stored-proc/maintain.php
* Änderungen an Tabellenstrukturen und Indizes in bin/dbsv-update.php
* Änderungen an der OKAPI-Datenbank in htdocs/okapi/views/update.php.

Das Script ''bin/dbupdate.php'' spielt alle diese Dinge in eine OC-Installation – z.B. ein [[Entwicklung/Entwicklersystem|Entwicklersystem]] – ein, bringt die Datenbank also auf den aktuellen Stand.

Der OKAPI-Code funktioniert nicht besonders gut, wenn man ihn von der Kommandozeile aus verwendet. Falls das OKAPI-Datenbankupdate einen Fehler produzieren sollte, muss man es anschließend von Hand via http://.../okapi/update aufrufen.

== Versionierung der Datenbankstruktur ==

dbsv-update.php beinhaltet eine Versionierung der Datenbankstruktur.

In der Tabelle 'sysconfig' einer OC-Installation gibt es (ab [https://github.com/OpencachingDeutschland/oc-server3/blob/master/htdocs/doc/sql/db-changes.txt#L64 Datenbankstand April 2013] bzw. Codestand a654761 vom 22. April) den Eintrag 'db_version' mit dem aktuellen Versionsstand der Datenbank, fortlaufend durchnumeriert ab 100. Für jede neue Version gibt es eine "Mutationsfunktion" in dbsv-update.php, die die Datenbank auf den neuen Versionsstand bringt.

Wenn du eine Änderung an einer Datenbanktabelle vornehmen (oder eine neue einfügen) möchtest, vergewissere dich zuerst sorgfältig, welche Folgen dies hat. Neue Informationen zu Caches und Logs müssen an vielen Stellen berücksichtigt werden, inklusive [[XML-Schnittstelle]], [[OKAPI]], evtl. auch [[Ocprop]] etc. Evtl. müssen Änderungen auch in vorhandene Trigger eingebaut werden oder benötigen neue Trigger, um Kosistenz zu gewährleisten (vgl. {{Codepath2|htdocs/doc/sql|modification-dates.txt}} und {{Codepath2|htdocs|restorecaches.php}}). Evtl. müssen Indizes geändert oder neu definiert werden, um die nötige Performance sicherzustellen.

Wenn du sicher bist, die Datenbank ändern zu wollen, ändere sie NICHT direkt, sondern schreibe eine neue Mutationsfunktion in dbsv-update.php, die die Änderung vornimmt. Vorhandene Funktionen können als Vorlage dienen. Teste deine Funktion anschließend mit "php dbsv-update.php" auf der Kommandozeile. Wenn es nicht wie beabsichtigt funktionierte, mache die Änderung rückgängig und setze sysconfig.db_version eins zurück, bevor du es wieder versuchst.

Wenn mehrere Entwickler gleichzeitig neue Mutationen definieren, ist es Aufgabe des Code-Maintainers, diese in passender Reihenfolge zusammenzuführen.

== Felder oder Tabellen löschen oder umbenennen ==

Nicht mehr vorhandene Felder oder Tabellen sind inkompatibel zu älteren Versionsständen. Man kann dann auf einem Entwicklersystem nicht mehr testweise auf eine alte Codeversion zurückgehen, was sehr hilfreich ist um herauszufinden, wann ein Bug entstanden ist. Auch das Umschalten zwischen verschiedenen aktiven Branches kann schon zum Problem werden.

(Es gibt natürlich nie eine Garantie dass ein Downgrade 100%ig funktioniert, weil sich auch Datenbankinhalte in inkompatibler Weise geändert haben können. Im Großen und Ganzen funktioniert es aber.)

Umbenennung oder Löschungen sind daher nicht zu empfehlen. Nicht mehr verwendete Felder und Tabellen werden stattdessen mit dem Kommentar "obsolete" versehen.

== Trigger & Stored Procedures ==

Um das Versionierungskonzept vollständig durchzuhalten, müssten eigentlich auch alle Änderungen an Triggern und Stored Procedures über die Mutationen erfolgen. Es bestünde dann allerdings die Gefahr von Inkonsistenzen zwischen den Mutationen der kompletten Funktionsdefinitionen in maintain.php, die der Übersicht halber weiter benötigt werden.

Solange es kein besseres Konzept gibt, wird daher wie folgt vorgegangen:

* Wenn eine Mutation geänderte/neue Trigger benötigt, die mit dem gleichen Codeupdate eingeführt werden, muss sie diese entweder zunächst definieren oder deren Funktionalität nachbilden (siehe z.B. Version 102: hier wird der neue sp_updateall_hiddenstat()-Code ausgeführt). Dies ist nötig, weil maintain.php erst ''nach'' den Mutationen durchläuft, da es neue Datenbankfelder benötigen kann (Henne-Ei-Problem).

* Bei Definition der Mutationen darauf achten, ob sie irgendwelchen SQL-Code enthalten der auf Trigger angewiesen ist. Wenn ja, entsprechende Maßnahmen ergreifen z.B.
** Diese Trigger in der Mutation neu anlegen, oder
** die Funktionalität der Trigger nachbilden, oder
** eine Zwischenmutation mit einem versionierten Triggerupdate einfügen (siehe Mutation #113).

Als präventive Maßnahme kann in größeren Abständen pauschal ein komplettes Triggerupdate eingefügt werden (siehe Mutation #113).

== OKAPI ==

Der OKAPI-Code greift parallel zum OC.de-Code auf die Datenbank zu. Bei Änderungen an Datenbankstruktur oder -inhalten ist daher immer zu prüfen, ob die OKAPI betroffen ist und angepasst werden muss.

Unter Umständen müssen Trigger aktualisiert werden, damit die OKAPI Änderungen an Cache- oder Logabhängigen Daten mitbekommt; siehe dazu [https://github.com/OpencachingDeutschland/oc-server3/blob/master/htdocs/doc/sql/modification-dates.txt modification-dates.txt].

Änderungen an OKAPI-eigenen Tabellen (okapi_*) werden von der OKAPI selbst verwaltet und spielen hier keine Rolle. Sie werden via <code>okapi/views/update.php</code> eingepflegt.

[[Kategorie:Entwicklung|Datenbankversionierung]]

Der gemeine zweibeinige Sucher

2013-10-13T15:33:24Z

Dl6hbo: /* Beschreibung */

[[Datei:Der gemeine zweibeinige Sucher.jpg|right|thumb|300px|]]
Der gemeine zweibeinige Sucher (vulgare quarere bipes) ist eine Vogelart aus der Familie der sogenannten [[Geocacher|Geologischen Verstecker]]. Die [[Letterboxing#Ursprung|erste Beobachtung]] der geologischen Verstecker wurde gegen 1854 in der Gegend um Dartmoor gemacht. Damals waren die kleinen Vögel aber bei weitem nicht so spezialisiert wie heute. Seit dem [[GPS#Geschichtlicher_.C3.9Cberblick|Jahr 2000]] hat der gemeine zweibeinige Sucher eine enorme Evolution durchgemacht und kann unter anderem GPS-Signale nutzen. Der Ausgangspunkt der Evolution kann in die USA [http://de.wikipedia.org/wiki/Geocaching#Der_erste_Geocache zurückverfolgt] werden.

== Beschreibung ==

Der gemeine zweibeinige Sucher, auch als OC-Vogel oder GC-Vogel bekannt, kann sich seiner Umgebung hervorragend anpassen und schafft es so, bei seiner Tätigkeit nur wenig aufzufallen. Auf Grund dieser Tarneigenschaft ist es schwer, diesen Vogel zu beobachten und genauer zu beschreiben.
Ein optischer Unterschied zwischen Männchen und Weibchen ist bisher nicht bekannt. Es wird angenommen, dass das Männchen größer ist, das Weibchen jedoch eher etwas bunter. Der gemeine zweibeinige Sucher zeichnet sich durch einen hervorragenden Orientierungssinn aus. Im Gegensatz zu anderen Vogelarten nutzt er jedoch nicht das [http://de.wikipedia.org/wiki/Vogelzug#Orientierung Magnetfeld der Erde, die Sonne oder Sterne], sondern verlässt sich ganz auf die [[GPS#Funktionsweise|GPS-Ortung]]. Wie der kleine Vogel die GPS Signale empfängt, ist bisher ungeklärt.

Auffällig ist auch seine Kommunikationsform. Seine Informationen über zu suchende Objekte gewinnt er aus einem ungreifbaren Medium namens [http://de.wikipedia.org/wiki/Internet bibliotheca universus]. Wie er darauf Zugriff nimmt, ist auch eine der vielen Fragen, welche die Wissenschaft beschäftigt. Bevorzugt greift er auf die sogenannte [[Geocaching-Plattformen#Opencaching.de_.28OC.29|"offene Seite"]] zu. Findet er hier nicht das gewünschte Objekt kann es vorkommen, dass er alternativ die [[Geocaching-Plattformen#Geocaching.com_.28GC.29|"kommerzielle Seite"]] nutzt, welche jedoch für einen vollen Funktionsumfang kostenpflichtig ist.

Seine Schnabelspitze ist auch ein eindeutiges Merkmal. Diese besteht aus einem harten [http://de.wikipedia.org/wiki/Bleistift Graphit-Ton-Gemisch], womit er [[Logbuch|Notizen]] in den von ihm [[Geocache|gefundenen Objekten]] macht.

Interessant ist auch ein Beutel, ähnlich dem des Kängurus. Hierbei handelt es sich jedoch nicht um eine Notwendigkeit zur Aufzucht des Nachwuchses, sondern der gemeine zweibeinige Sucher führt damit sogenannte [[Reisende]] sowie [[Tauschgegenstände|Tauschobjekte]] mit sich und transportiert diese von einem [[Geocache|Objekt]] zum nächsten. Besonders beliebt sind bei ihm die kostenlosen [[Reisende#Geokrets|GeoMaulwürfe]], welche er auf unterschiedlichen [[Geocaching-Plattformen|Plattformen]] „loggen“ kann. Die weiter verbreiteten [[Reisende#Travelbugs_und_Geocoins|GeoMünzen und Reisewanzen]] kann er auch transportieren, jedoch ist hierfür die Möglichkeit zu „loggen“ auf eine Plattform eingeschränkt auf Grund des kommerziellen Hintergedankens.

Wichtig sind auch die Fußkrallen des gemeinen zweibeinigen Suchers, welche er sehr flexibel einsetzen kann. Damit ist es ihm möglich, filigrane Dinge wie [[Behältergrößen#Nano|kleine Döschen]] zu bergen oder sogenannte [[Behältergrößen#Mikro|Filmdosen]] aufzumachen. Ebenso kann er damit die beliebten [[Behältergrößen#Normal|„Munitionskisten“ und Kunststoffdosen]] öffnen.

Seine Stimme kann, je näher er seinem Ziel kommt, immer lauter werden. Meistens kann man es als ein Piepsen wahrnehmen. Es wurde aber auch schon von gemeinen zweibeinigen Suchern berichtet, die Ihre Navigation [http://de.wikipedia.org/wiki/Sprachsynthese laut aussprechen].

Beide Arten wurden aber auf Grund seiner hervorragenden optischen und akustischen Anpassungsfähigkeit bisher nur selten beoachtet.

== Ökologie ==

=== Ernährung ===

Der gemeine zweibeinige Sucher ist ein Generalist und ernährt sich hauptsächlich vom [[Cachepflege#Location_entm.C3.BCllen|„Trash“]] in und um die gefundenen Objekte. Dazu kommen aber auch Würmer, Maden und Schnecken, welche die Objekte auch gelegentlich von außen untersuchen.

Interessanterweise verweigert der gemeine zweibeinige Sucher jedoch Tomaten als Nahrungsmittel. Es wird allgemein ein Zusammenhang mit den [http://www.sueddeutsche.de/wissen/sensationelle-forschungsergebnisse-jetzt-zeigt-sich-wozu-unsere-spezies-faehig-ist-1.1322991 durch die Tomaten ausgelösten Aggressionen] (Stichwort Statistik, Plattformabhängigkeit) vermutet.

=== Lebensraum ===

Als [http://de.wikipedia.org/wiki/Standvogel Standvogel] überwintert der gemeine zweibeinige Sucher in seinem angestammten Gebiet.
Er lebt in Wäldern (bevorzugt in alten Laub- oder Mischwäldern), durch ihre große Lern- und Anpassungsfähigkeit inzwischen auch in Gärten, Baumreihen und Stadtparks.

=== Verhalten ===

Der gemeine zweibeinige Sucher hat einen flexiblen Aktivitätsrhythmus. Dieser richtet sich vorgeblich nach den [[Cachearten|zu suchenden Objekten]]. Einige können jederzeit gesucht werden, andere nur zu bestimmten Tageszeiten oder Tagen.

Hat er einmal eine Suche ins Auge gefasst, sucht er so lange, bis er das gewünschte Objekt gefunden hat und mit seinem Schnabel einen „Log“ hinterlassen kann. Ein Austauschen von Reisenden verschafft ihm erhöhte Zufriedenheit.

Ein Revierverhalten ist nicht bekannt. Gerne helfen sich die zweibeinigen Sucher [[Fachjargon#Rudelcachen|gegenseitig]] beim Finden der Objekte.

Da der gemeine zweibeinige Sucher sehr zurückgezogen lebt, ist es bisher nicht gelungen, seine Lebensdauer und sein Paarungsverhalten sowie die Brutpflege ausreichend zu erforschen. Es gibt jedoch ein paar wenige Forscher, die gesehen haben wollen, dass sich der OC-Vogel mit anderen Vogelarten gepaart hätte. Diese Berichte können jedoch nicht wissenschaftlich bestätigt werden und erscheinen sogar ziemlich abwegig. Der gemeine zweibeinige Sucher bleibt nämlich gerne unter seinesgleichen und hält andere Vogelarten, welche er als [[Muggel]] bezeichnet, auf Abstand.

== Wo kann man diese seltenen Vögel beobachten ==

Bisher ist nur ein Ort bekannt, in der Nähe von Regensburg. {{Cachelink|OCDD7B}}

Sobald weitere Standorte entdeckt werden, bitte umgehend melden!

'''Diese Beschreibung darf gerne verwendet werden, jedoch bitte ich, dann den ''pirate'' zu informieren [mailto:pirate@ist-einmalig.de pirate@isteinmalig.de]'''<br />
'''Ebenso darf die Beschreibung gerne erweitert werden, aber auch bitte erst nach Absprache mit mir. DANKE'''

[[Kategorie:Geocacher]]

Entwicklung/Codedoku

2013-10-13T07:41:33Z

Dl6hbo:

Dies ist eine Materialsammlung zum [http://github.com/OpencachingDeutschland/oc-server3 Opencaching-Programmcode]. Sie soll neuen [[Entwicklung|Entwicklern]] einen Überblick über die Grundstruktur und wichtigsten Bestandteile des OC-Codes geben. Mit "OC-Code" ist alles gemeint, was sich im [[Entwicklung/Git|Git-Repository]] befindet.

Weitere Dokumentationen gibt es auch in den Codeverzeichnissen {{Codepath|doc}} und {{Codepath|htdocs/doc}}. Die Datei {{Codepath|doc/directories.txt}} enthält eine Übersicht der Repository-Verzeichnisstruktur. ''(Grüne Pfad- und Dateinamen sind anklickbar.)''

Alle die bereits an Opencaching mitprogrammiert haben, sind eingeladen, ihr Wissen beizusteuern! Wenn du dir zusätzliche Erläuterungen wünschst, kannst du sie auf der Diskussionsseite anfragen – vielleicht findet sich jemand, der den Artikel ergänzt.

Siehe auch: [[Entwicklung/Stil|Style Guidelines]]

== Dateiformat ==

Alle OC-Quelltextdateien haben [[wikipedia:UTF-8|UTF-8]]-Format. Im Kopf der Quelltextdateien befindet sich ein japanisches Wort ("Unicode Reminder"), mit dem geprüft werden kann ob die Zeichencodierung intakt ist. Sollte versehentlich nach ISO-8859-1 o.ä. umcodiert worden sein, erscheinen dort z.B. zwei Fragezeichen oder gar nichts.

{{Codepath|local/tools/find_bad_encodings.php}} prüft alle Quelltexte auf fehlende oder beschädigte Unicode Reminder.

Die Zeilenenden der Quelltexte bestehen grundsätzlich aus einem einfachen LF (line feed). Ausnahmen gibt es z.B. bei [[#Email-Templates|Email-Templates]]; hier ist CR/LF vorgeschrieben.

== Hauptmodule ==

Mit "lib1" und "lib2" sind im Folgenden die OC-eigenen Codebibliotheken in {{Codepath|htdocs/lib}} und {{Codepath|htdocs/lib2}} gemeint. Alle Teile des OC-Codes bauen auf einer dieser beiden Bibliotheken auf.

<div class="widelist">
Der OC-Software besteht aus ...
* Den '''darstellbaren Seiten''' der OC-Website, z.B. Startseite (''index'') oder Cachelisting-Anzeige (''viewcache''). Diese bestehen jeweils aus einem PHP-Script im Verzeichnis {{Codepath|htdocs}} und einem [[#Templates|Template]] in {{Codepath|htdocs/templates2/ocstyle}} (lib1: {{Codepath|htdocs/lang/de/ocstyle}}). Das PHP-Script erzeugt die darzustellenden Inhalte, das Template stellt sie als HTML-Seite dar.

* '''Kommandozeilentools''' für verschiedene Zwecke, z.B. Wartungstools die per Crojob oder von Hand aufgerufen werden. Sie befinden sich in an verschiedenen Stellen:
** {{Codepath|bin}} (Update-Scripte)
** {{Codepath|htdocs/util}} (lib1, Tools für Produktivbetrieb)
** {{Codepath|htdocs/util2}} (lib2, Tools für Produktivbetrieb)
** {{Codepath|local}} (spezielle Tools für lokale Verwendung)

* '''APIs''', also Schnittstellen für Datenabruf oder -upload durch Dritte:
** diverse APIS in {{Codepath|htdocs/api}}
** die [[OKAPI]] in {{Codepath|htdocs/okapi}}, repliziert aus dem [http://code.google.com/p/opencaching-api/source/browse/trunk/#trunk%2Fokapi OKAPI-Repository]
** die [[XML-Schnittstelle]] in {{Codepath|htdocs/xml}}
</div>

* '''Apache-Rewrites'''. Dies sind Konfigurationsdateien mit dem Name ''.htaccess'', die vom Apache-Webserver ausgelesen werden. Sie interpretieren die übergebene URL und leiten auf ein PHP-Script um. Apache-Rewrites kommen an zwei Stellen zum Einsatz:
** Statistikbilder: {{Codepath|htdocs/statpics/htaccess-dist|htdocs/statpics/.htaccess}}
** OC-Kurz-URLs, z.B. http://opencaching.de/OC1234: diese sind direkt im Produktiv-Webserver konfiguriert.

== Bibliotheken ==

Die einzelnen OC-Module verwenden verschiedene Code-Bibliotheken:

=== Eigene Bibliotheken ===

==== lib1 ====
Die alte selbstgeschriebene Bibliothek von OC-Codeversion 1.0, in {{Codepath|htdocs/lib}}. Sie enthält z.B. Funktionen für Datenbankzugriff, Login, Menüs, geographische Berechnungen und ein einfaches Template-System.

lib1 ist veraltet und wird auf OC.de nur noch für das Bearbeiten von Logs und Cachebeschschreibungen, für Benachrichtigungen über beobachtete und neue Caches und für die XML-Schnittstelle verwendet. Mittelfristig soll sie ganz durch lib2 ersetzt werden. (Alle auf OC.pl-Code basierenden [[Opencaching]]-Seiten verwenden weiterhin ausschließlich die lib1).

lib1 wird eingebunden mit
:<code>require 'lib/common.inc.php'</code>

==== lib2 ====
Die Bibliothek der OC.de-Codversion 2.0 und höher in {{Codepath|htdocs/lib2}}, Nachfolger von lib1. Sie ist wesentlich umfangreicher. Der Code ist aufgeteilt in das "Framework" mit allgemeinen Dingen wie Datenbankzugriff, Authentifizierung, Lokalisierung, Templates etc. und die sogenannte "Business Logic" in {{Codepath|htdocs/lib2/logic}} mit allen Geocaching-spezifischen Klassen und Funktionen.

lib2 wird in Bestandteile der Website eingebunden mit
:<code>require 'lib2/web.inc.php'</code>
und in Kommandozeilentools mit
:<code>require 'lib2/cli.inc.php'</code>

;gemeinsamer lib1- und lib2-Code
Manche Bibliotheksmodule werden versionsübergreifend verwendet, z.B. für Übersetzungen und Sprachauswahl. Sie sind in {{Codepath|htdocs/lib2}} abgelegt.

==== libse ====
Eine Klassenbibliothek von Opencaching.se, in {{Codepath|htdocs/libse}}. Im Zuge der Codezusammenführung von OC.de und OC.se wurde sie 2011 mit in den OC.de-Code übernommen. Sie wird für zusätzliche Wegpunkte und persönliche Notizen im Cachelisting verwendet.

==== Autoload ====
Für die Klassen aller drei Bibliotheken sind Autoloader installiert. Das heißt wenn man z.B. ein Cache-Objekt benötigt, muss man dafür nicht {{Codepath2|htdocs|lib2/logic/cache.class.php}} einbinden sondern man erzeugt einfach direkt das Objekt:
:<code>$cache = new cache();</code>
{{Codepath2|htdocs/lib2/logic|cache.class.php}} wird dann automatisch geladen.

=== Fremdbibliotheken ===

Die OC-Software macht ausgiebig Gebrauch von fertigen PHP- und JavaScript-Codebibliotheken. Eine vollständige Aufstellung incl. Codepfade, Bezugsquellen etc. enthält {{Codepath|doc/license.txt}}. Hier seien nur die wichtigsten davon erwähnt:

<div class="widelist">
* [http://www.smarty.net/ '''Smarty'''] wird als "Template-Engine" für lib2 verwendet. OC-spezifische Erweiterungen befinden sich in der Klasse ''OcSmarty'' und in {{Codepath2|htdocs|lib2/smarty/ocplugins}}. Mehr dazu im Abschnitt [[#Templates|Templates]].

* '''[http://htmlpurifier.org/ HTML Purifier]''' dient zum "Säubern" von HTML-Code, den der Benutzer z.B. in Cachebeschreibungen eingeben kann. lib1 und lib2 verwenden getrennte HTML-Purifier-Installationen. In lib2 wird er über die Klasse ''OcHTMLPurifier'' eingebunden und kann dort auch angepasst werden.

* '''[http://www.tinymce.com/ TinyMCE]''' ist ein leistungsfähiger JavaScript-Wysiwyg-Texteditor. Er dient zum Bearbeiten von Cachebeschreibungen, Logs und Profiltexten. lib1 und lib2 verwenden beide die TinyMCE-Installation in {{Codepath|htdocs/resource2/tinymce}}. OC-spezifische Konfigurationsdaten gibt es in {{Codepath2|htdocs/resource2|tinymce/config}}.

Von lib2-Code verwendete Bibliotheken sind in {{Codepath|htdocs/lib2}} (PHP) und {{Codepath|htdocs/resource2}} (JavaScript) angelegt. Bibliotheken für lib1 befinden sich an verschiedenen Stellen.

</div>

== Konfigurationsdateien ==

==== lib1-Konfiguration ====

Die Einstellungen für lib1-Code befinden sich überwiegend in
:''htdocs/lib/settings.inc.php''
Diese Datei ist nur lokal vorhanden. Als Vorlage für das Aufsetzen einer neuen Produktiv-Installation gibt es die Datei {{Codepath2|htdocs/lib|settings-dist.inc.php}}, die nach ''settings.inc.php'' zu kopieren und anzupassen ist.

Für [[Entwicklung/Entwicklersystem|Entwicklersysteme]] gibt es entsprechend die Vorlage {{Codepath2|htdocs/lib|settings-sample-dev.inc.php}}. Sie verwendet die Datei {{Codepath2|htdocs/lib|settings-dev.inc.php}}, in der die Grundeinstellungen für Entwicklersysteme zusammengefasst sind.

Daneben gibt es noch zwei Konfigurationsdateien ''settings.inc.php'' für die Benachrichtigungs-Cronjobs, in {{Codepath|htdocs/util/notification}} und {{Codepath|htdocs/util/watchlist}}.

Weiterhin verwendet lib1 auch Teile der lib2-Konfiguration, insbesondere {{Codepath2|htdocs/config2|locale.inc.php}}.

==== lib2-Konfiguration ====

Die lib2-Einstellungen befinden sich alle in {{Codepath|htdocs/config2}}. Sie werden ''alle'' in folgender Reihenfolge eingebunden, sobald man {{Codepath2|htdocs/lib2|web.inc.php}} oder {{Codepath2|htdocs/lib2|cli.inc.php}} einbindet:

* sprachabhängige Einstellungen: {{Codepath2|htdocs/config2|locale.inc.php}}
* sonstige Default-Einstellungen: {{Codepath2|htdocs/config2|settings-dist.inc.php}}
* lokale Einstellungen: ''settings.inc.php''

Auch hier sind Vorlagen für Produktiv- ({{Codepath2|htdocs/config2|settings-sample.inc.php}}) und Entwicklersystem ({{Codepath2|htdocs/config2|settings-sample-dev.inc.php}}) vorhanden, die nach ''settings.inc.php'' zu kopieren und and die lokale Systeminstallation anzupassen sind.

==== Der Rootpath ====

Wenn man in PHP-Scripte mit <code>include</code> oder <code>require</code> weitere Dateien einbindet, geschieht dies relativ zum Verzeichnispfad des Hauptscripts. (Daneben kann man auch weitere Pfade festlegen, in denen PHP nach passenden Scripten sucht.)

Wie unter [[#Hauptmodule|Hauptmodule]] erläutert, befinden sich die Module der OC-Software auf verschiedenen Verzeichnisebenen Die Startseite liegt z.B. in {{Codepath|htdocs}}, das lib2-Cronjob-Modul dagegen in {{Codepath|htdocs/util2/cron}}. Alle diese Module binden lib1- oder lib2-Bibliothekscode ein, der weitere Unterscripte einbindet. Damit das alles funktioniert, wird im OC-Code ein ''Basispfad'' für alle Includes festgelegt. Dieser heißt
:<code>$opt['rootpath']</code>
in lib2 und
:<code>$rootpath</code>
in lib1.

Sofern man keine weiteren Vorkehrungen trifft, wird dieser Rootpath automatisch als Relativpfad "./" gesetzt. Scripte in Unterverzeichnissen müssen ihn dagegen selbst setzen, z.B. "../" wenn das Script eine Ebene tiefer liegt, oder absolut als <code>dirname(__FILE__).'../'</code>, wenn nicht bekannt ist, aus welchem aktuellen Verzeichnis ein Kommandozeilentool aufgerufen wird.

== Konstanten ==

Globale Konstanten sind an folgenden Stellen definiert:

* {{Codepath|htdocs/lib/consts.inc.php}}
* {{Codepath|htdocs/lib2/const.inc.php}}
* {{Codepath|htdocs/lib2/error.inc.php}}
* {{Codepath|htdocs/lib2/logic/const.inc.php}}

Die lib2-Konstanten werden auch teilweise auch in lib1-Code verwendet.

== Datenbank ==

Die OC-Software ist nur für die Verwendung von MySQL ausgelegt. Zwar werden in lib2 keine MySQL-Funktionen mehr direkt aufgerufen, aber zahlreiche SQL-Statements verlassen sich auf MySQL-Syntax.

=== Grundlegende Datenbankfunktionen ===

Für lib2 befinden sich alle Funktionen in {{Codepath2|htdocs|lib2/db.inc.php}} und sind dort kurz dokumentiert, für lib1 in {{Codepath2|htdocs|lib/clicompatbase.inc.php}}. Datenbankverbindungen werden automatisch entsprechend den Konfigurationseinstellungen hergestellt, sobald man eine Query absetzt.

Die wichtigsten Funktionen seien hier anhand von Beispielen erläutert:

sql("UPDATE `caches` SET `size`='&1' WHERE `cache_id`='&2'",
$newsize, $cacheid);

Hier wird die Größe eines Caches geändert. Variablen werden als fortlaufend numerierte Platzhalter &1, &2 etc. übergeben. Die Funktion ''sql'' ruft dann intern für jede Variable <code>mysql_real_escape_string()</code> auf, was spezielle Zeichen wie " codiert und gleichzeitig [[wikipedia:SQL-Injection|SQL-Injections]] verhindert.

'''Niemals dürfte Variablen direkt in SQL-Statements eingebaut werden!''' Wann immer möglich sind Platzhalter zu verwenden. Notfalls kann auch direkt mit <code>sql_escape()</code> codiert werden, was allerdings Probleme verursacht, wenn ein "&" in den Daten enthalten ist: Die Funktion <code>sql()</code> interpretiert es anschließend als Startzeichen eines Platzhalters.

$cachesize = sql_value("
SELECT `size` FROM `caches`
WHERE `cache_id`='&1'",
null, $cacheid);

Hier wird die Größe eines Caches abgefragt. Falls die Cache-ID nicht gefunden wird, wird der Defaultwert ''null'' zurückgeliefert. Denke immer daran, den Defaultwert als ersten Parameter anzugeben! Ihn zu vergessen ist eine häufige Fehlerquelle.

In der lib1 heißt die Funktion anders und kann nicht mit Platzhaltern umgehen; der entsprechende Code lautet dann:

$cachesize = sqlValue("
SELECT `size` FROM `caches`
WHERE `cache_id`='" . sql_escape($cacheid) . "'",
null);

Das folgende Beispiel demonstriert, wie der Inhalt einer Tabelle ausgelesen wird:

$rs = sql("
SELECT `cache_id`, `name`, `type` `size` FROM `caches`
WHERE `cache_id`='&1'",
$cacheid);
while ($r = sql_fetch_assoc($rs))
{
// ... Weiterverarbeitung von $r['cache_id'], $r['name'] etc.
}
sql_free_result($rs);

=== Slave-Server ===

Beide OC-Libraries sehen eine Lastverteilung auf einen Haupt-Datebankserver (Master) und einen oder mehrere "Slaves" vor, die replizierte Daten des Masters enthalten; siehe {{Codepath|doc/replication.txt}}. Dazu gibt es SQL-Funktionen mit dem Zusatz "_slave", z.B. <code>sql_slave()</code>, die von "datenbankintensiven" Programmmodulen wie z.B. der Suche ({{Codepath2|htdocs|search.php}}) anstatt der Basisfunktionen verwendet werden.

Wenn per ''settings.inc.php'' keine Slave-Server konfiguriert sind, laufen alle Zugriffe über den Master. Zurzeit betreibt kein Opencaching-Knoten Slave-Server; die Kapazität des Masters reicht überall aus.

=== Temporärtabellen ===

Da Subqueries bei MySQL recht ineffizient sind, sind manchmal temporäre Tabellen für Zwischenergebnisse nötig.

lib2 sieht einen speziellen Mechanismus zur Verwaltung von Temporärtabellen vor. Sie werden in einer eigenen Datenbank abgelegt, für die erweiterte Zugriffsrechte (Tabellen anlegen/löschen) vergeben werden, und werden per Cronjob automatisch aufgeräumt, wenn sie nicht gleich wieder gelöscht wurden.

Ein (nicht unbedingt sinnvolles) Beispiel für die Verwendung von lib2-Temporärtabellen. Die temporäre Tabelle heißt "tmp_caches" und wird in SQL-Statements über einen Platzhalter referenziert:

sql_temp_table('tmp_caches'); // Tabelle registrieren
sql(" // Tabelle anlegen
CREATE TEMPORARY TABLE &tmp_caches ENGINE=MEMORY
SELECT `cache_id` FROM `caches`
WHERE `user`.`user_id` = `caches`.`user_id`
AND `user`.`country` = '&1'",
$country);

$rs = sql(" // Tabelle auslesen
SELECT * FROM `cache_desc`, &tmp_caches
WHERE `cache_desc`.`cache_id` = &tmp_caches.`cache_id`");
// ... Daten weiterverarbeiten
sql_free_result($rs);

sql_drop_temp_table('tmp_caches'); // Tabelle löschen

=== Datenbankstruktur; statische Daten ===

Datenbankstruktur und -inhalte werden an folgenden Stellen unter {{Codepath|htdocs/doc/sql}} definiert:

* Tabellen, Felder und Indizes in {{Codepath2|htdocs/doc/sql|tables}}
* Stored Functions, Procedures und Triger in {{Codepath2|htdocs/doc/sql|stored-proc}}
* statische Daten wie z.B. Menüs, Cachetypen und sprachabhängige Texte in {{Codepath2|htdocs/doc/sql|static-data/data.sql}}.

Es gibt weitere (geographische) "statische Daten", die aufgrund ihres Umfangs nicht im Git-Repository enthalten sind; siehe {{Codepath2|htdocs/doc/sql|static-data/static-data.txt}}. Für Entwickler steht auf Anfrage ein Datenbankdump zur Verfügung, der eine vollständig initialisierte OC-Datenbank enthält (Veröffentlichung ist geplant). Weitere Updates können dann per
:{{Codepath|bin/dbupdate.php}}
eingepflegt werden, also man muss die oben aufgelisteten Dateien nicht von Hand weiterverarbeiten.

Siehe auch: [[Entwicklung/Datenbankversionierung|Datenbankversionierung]]

==== OKAPI ====

Die [[OKAPI]]-Tabellen werden zwar in der gleichen Datenbank abgelegt, sind aber unabhängig von den OC-Tabellen und daher ''nicht'' in {{Codepath|htdocs/doc/sql}} definiert. Bei [http://code.google.com/p/opencaching-api/#Installation_/_Update_Instructions Installation der OKAPI] werden sie automatisch angelegt und bei OKAPI-Updates automatisch aktualisiert. {{Codepath2|bin|dbupdate.php}} führt auch OKAPI-Updates durch, falls die OKAPI installiert ist.

Auch der OKAPI-''Code'' ist unabhängig vom OC-Code, d.h. sämtliche Datenbankzugriffe sind dort redundant implementiert. '''Bei Änderungen an Datenstrukturen oder -inhalten ist daher immer zu prüfen, ob eine Anpassung der OKAPI nötig ist!'''

=== Trigger & Stored Procedures ===

Der Opencaching-Code macht reichlich Gebrauch von gespeicherten Datenbank-Funktionen und Triggern. Sie werden dazu eingesetzt, um die Konsistenz der Datenbankinhalte zu gewährleisten. Vor dem Hintergrund, dass drei unabhängige Frameworks parallel auf die Datenbank zugreifen – lib1, lib2 und OKAPI (und manchmal noch ein Administrator von Hand) – ist diese Vorgehensweise ratsam. Sie macht die OC.de-Datenbank ausgesprochen robust.

Alle Datenbankfunktionen sind in
:{{Codepath|htdocs/doc/sql/stored-proc}}
definiert. Der aktuelle Stand befinden sich in {{Codepath2|htdocs/doc/sql/stored-proc|maintain-current.inc.php}}; für die [[Entwicklung/Datenbankversionierung|Datenbankversionierung]] können zusätzliche ältere Stände bzw. Update-Scripte existieren.

Der Inhalt des ''maintain''-Scripts lässt sich grob untergliedern in
* allgemeine Funktionen für komplexe Berechnungen, z.B. <code>DECTOWP</code> für die Berechnung neuer OC-Wegpunkte
* Update-Funktionen für bestimmte Felder (<code>sp_update_*</code>) die entweder von verschiedenen Triggern aufgerufen werden oder zur Datenbankwartung aus {{Codepath2|htdocs|dbmaint.php}} (Menü Admin|Datenbankwartung)
* Trigger-Prozeduren

Eine Besonderheit sind '''globale Variablen''' die zur Parameterübergabe von PHP-Scripten an Datenbankfunktionen oder zwischen Datenbankfunktionen verwendet werden. Sie sind in {{Codepath2|htdocs/doc/sql/stored-proc|maintain-current.inc.php}} erläutert.

=== SQL-Debugger ===

lib1 und lib2 enthalten einen nützlichen SQL-Debugger ({{Codepath2|htdocs|lib/sqldebugger.inc.php}} bzw. {{Codepath2|htdocs|lib2/sqldebugger.class.php}}). Er zeigt für jedes ausgeführte SQL-Statment

* das Statement selbst,
* ein [http://dev.mysql.com/doc/refman/5.1-olh/de/using-explain.html EXPLAIN],
* die ersten zurückgelieferten Datensätze, falls vorhanden,
* die Ausführungszeit,
* eventuelle MySQL-Warnungen.

Der SQL-Debugger muss in den [[#Konfigurationsdateien|Settings]] aktiviert sein – für lib1 per <code>$sql_debug = true</code>, in lib2 durch Setzen des Flags <code>DEBUG_SQLDEBUGGER</code> in <code>$opt['debug']</code>. Wahlweise kann man diese Flags auch nur in einzelnen zu debuggenden PHP-Quelltexten setzen.

Anschließend ist die zu debuggende Seite mit dem URL-Parameter <code>sqldebug=1</code> aufzurufen.

== Temporärdaten und Inhalte im Dateisystem ==

Manche Dinge werden in Dateien statt in der Datenbank abgelegt.

<div class="mediumlist">
* '''Hochgeladene Bilder''' befinden sich üblicherweise in {{Codepath|htdocs/images/uploads}} (in den Settings änderbar), die Thumbnails darunter in {{Codepath2|htdocs/images/uploads|thumbs}}. Generierte Statistikbilder werden in {{Codepath|htdocs/images/statpics}} abgelegt.
* Herunterzuladende, gepackte '''Ausgaben der [[XML-Schnittstelle]]''' werden in {{Codepath|htdocs/download/zip}} zwischengespeichert (ebenfalls konfigurierbar).
* {{Codepath|htdocs/cache2}} enthält zwischengespeicherte [[#Templates|Templates]], [[#Übersetzung|Übersetzungsdateien]] für gettext und verschiedene Temporärdaten. Ein guter Teil dieser Daten wird von {{Codepath|bin/clear-webcache.php}} neu generiert.
* {{Codepath|htdocs/var}} enthält zwischengespeicherte OKAPI-Daten (die OKAPI legt allerdings auch eine Menge "gecachete" in der Datenbank ab) und Fehlerprotokolle.
* {{Codepath|htdocs/cache}} enthält vermutlich nur noch temporäre Prozess-Synchronisationsdateien (.pid-Dateien) der lib1-cronjobs für Log- und Cache-Benachrichtigungen.
</div>

== Templates ==

[[wikipedia:Template (Programmierung)|Templates]] dienen in Webanwendungen dazu, die Generierung von aus- und einzugebenden Daten von deren HTML-Darstellung zu trennen. HTML- und JavaScript-Code wird komplett in den Template-Dateien untergebracht, PHP-Code soweit wie irgend möglich in PHP-Scripten.

Die Einbindung der Templates in den PHP-Programmablauf geschieht wie folgt:
# Festlegung, welche Templatedatei verwendet wird
# Zuweisung von variablen Inhalten an das Template
# Darstellung des Templates
Für alle drei Punkte gibt es entsprechende Bibliotheksfunktionen.

=== lib1-Templates ===

Die alte Library enthält ein selbstgemachtes, simples Templatesystem. Die Templatedateien befinden sich in {{Codepath|htdocs/lang/de/ocstyle}} und enthalten den auszugebenden HTML- und JavaScript-Code. Der Name der Template-Datei wird im PHP-Code über die globale Variable <code>$tplname</code> festgelegt, z.B.
:<code>$tplname = 'newcache';</code>

Für alle variablen Inhalte werden im Template Platzhalter wie z.B. <code>{cachename}</code> verwendet; die PHP-Variable wird dann übergeben mit

:<code>tpl_set_var('cachename', $cachename);</code>

Sofern der variable Teil auch HTML-Code oder etwas zu Übersetzendes enthält, wird dies in speziellen Include-Dateien abgelegt, z.B.

$cachelink = '<a href="viewcache.php?cacheid={cacheid}">{cachename}</a>';
$outputformat_notexist = t('The selected output format is unknown!');

Die Include-Datei wird im PHP-Hauptmodul eingebunden und die Variablen per <code>mb_ereg_replace</code> ersetzt, bevor das Ganze per <code>tpl_set_var()</code> ans Template übergeben wird.

:<code>tpl_BuildTemplate();</code>
stellt schließlich das Template dar und beendet das PHP-Script.

Alle [[Opencaching]]-Seiten außer OC.de und OC.se/no verwenden noch das lib1-Templatesystem.

=== lib2-Templates (Smarty) ===

==== Grundlagen ====

Die neue Bibliothek verwendet die leistungsfähige [[wikipedia:Smarty|Smarty]]-Engine. Smarty-Templates bestehen neben dem HTML/JavaScript-Code im Wesentlichen aus Kontrollstrukturen und Variableneinbindungen. Die Templates sind in {{Codepath|htdocs/templates2/ocstyle}} abgelegt.

Die lib2 definiert die globale Variable
:<code>$tpl</code>
über die alle Zugriffe auf Smarty und die Templates laufen. Am Beginn des PHP-Moduls wird jeweils das Template initialisiert:

$tpl->name = 'newemail'; // Name der Template-Datei
$tpl->menuitem = MNU_MYPROFILE_DATA; // Menü-ID, siehe doc/sql/static-data/data.sql
$tpl->caching = false; // nicht zwischenspeichern

Der ''caching''-Parameter legt fest, ob das Ergebnis der Templateausgabe zwischengespeichert wird; die Dauer der Zwischenspeicherung ist dann ggf. per
$tpl->cachling_lifetime = 1800; // halbe Stunde Caching
festzulegen. Dies empfiehlt sich bei häufig aufgerufenen, rechenintensiven Seiten. Seiten mit ständig wechselndem bzw. benutzerabhängigem Inhalt dürfen '''nicht''' "gecacht" werden!

Neben Caching der Template-''Ausgaben'' gibt es auch eine ''Vorcompilierung'' der Templates selbst. Diese erfolgt
* einmalig für alle Templates per <code>bin/clear-webcache.php</code>,
* automatisch, wenn ein geändertes Template abgerufen wird,
* jedesmal bei jedem Template-Aufruf, falls in den Settings der Debug-Schalter <code>DEBUG_TEMPLATES</code> gesetzt ist.

Die zwischengespeicherten Templates werden in <code>htdocs/cache2/smarty</code> abgelegt.

Auf die Initialisierung des Templates folgen Variablen-Zuweisungen (s.u.) und schließlich die Darstellung mit
:<code>$tpl->display();</code>
die das PHP-Script beendet.

;Smarty-Syntax

Im Folgenden sind ein paar grundlegende Smarty-Elemente erklärt; ansonsten sei auf die [http://www.smarty.net/docsv2/de/ Smarty-Dokumentation] verwiesen und auf die vielen Bespiele in {{Codepath2|htdocs|templates2/ocstyle}}. (Achtung: Der OC-Code verwendet eine ältere Smarty-Version; nicht alles was in der Doku steht ist hier auch schon verfügbar!)

Alle Smarty-Elemente stehen in geschweiften Klammern {}. Wenn das Template solche Klammern für andere Zwecke verwendet, z.B. für JavaScript-Kontrollstrukturen, müssen diese von der Smarty-Interpretation ausgeklammert werden:

{literal}
function js_function()
{
...
}
{/literal}

==== Variablen ====

Variablen werden z.B. per
:<code>$tpl->assign('cachename', $cache['name']);</code>
an das Template übergeben und dort als
:<code>{$cachename}</code>
verwendet. Es können auch Arrays übergeben werden, deren Elemente statt [] mit einem Punkt referenziert werden.
:<code>{$cache.name}</code>
steht z.B. für <code>$caches['name']</code>, übergeben per <code>$tpl->assign('caches', ...)</code>. Dies funktioniert auch mit numerischen Indizes – z.B. <code>{$user.0}</code> für das erste Element eines $user-Arrays – und mit mehr als zwei Ebenen.

Auch simple Berechnung sind möglich, z.B. <code>{$waylength*2}</code>.

Zusätzlich zu dem vom PHP-Code übergebenen Variablen kann man auch eigene definieren, z.B.
:<code>{assign var=counter value=1}</code>
Mit <code>{capture}</code> lassen sich u.U. auch komplexere Ausdrücke in einer Variable unterbringen.

==== Kontrollstrukturen ====

Bedingte Einbindung von Template-Komponenten ist mit <code>{if} … {elseif} … {else} … {/if}</code>-Anweisungen möglich. Dabei können auch komplexere PHP-Ausdrucke verwendet werden, die als Boolean ausgewertet werden:

{if $show_statistics && ($statdata|@count > 0)}
... Statistik ausgeben ...
{/if}

(@count ist eine [[#Benutzerdefinierte Erweiterungen; Übersetzungen|benutzerdefinierte Funktion]])

Eine weiter häufig verwendete Struktur ist <code>{foreach}</code> zum iterieren von Arrayelementen:

{foreach from=$caches item=cache}
<td>{$cache.name|escape}</td>
{/foreach}

<code>|escape</code> ist ein ''Modifizierer'', der den Variableninhalt weiterverarbeitet. In diesem Fall werden HTML-Entitäten "escaped".

Mit <code>{strip}...{/strip}</code> lassen sich alle Whitespaces (Leerzeichen, Tabs, Zeilenumbrüche) in einem Abschnitt herausfiltern, was die auszugebende Datenbank reduziert. Aber Vorsicht, falls Whitespaces als Trennzeichen in Ausgaben benötigt werden!

==== Benutzerdefinierte Erweiterungen ====

Smarty lässt sich um eigene
* Elemente ("Blocks"),
* Modifizierer und
* Funktionen
erweitern. Der Opencaching-Code enthält eine Reihe solcher eigener Erweiterungen in {{Codepath2|htdocs|lib2/smarty/ocplugins}}.

Die wichtigste Erweiterung ist das <code>{t}</code>-Element zum Übersetzen von Texten. Alle Texte in den Templates werden in Englisch geschrieben und in <code>{t} ... {/t}</code> eingeschlossen; sie werden dadurch automatisch dem Übersetzungssystem zugeführt. Mehr dazu im Kapitel [[#Übersetzungen|Übersetzungen]].

=== Systemtemplate und Menüsystem ===

Was oben über einzelne Templates geschrieben wurde betrifft nur den Teil der Seite, der im ''Content-Container'' dargestellt wird – also dem Teil unterhalb und rechts des Menüsystems und oberhalb der Fußzeile. Alles "drumherum" wird vom ''Systemtemplate'' erzeugt.

Folgende Codedateien sind daran in der lib1 beteiligt ...
* Systemtemplate: {{Codepath2|htdocs|lang/de/ocstyle/main.tpl.php}}
* Menüdefinitionen: {{Codepath2|htdocs|lang/de/ocstyle/lib/menu.php}}
* PHP-Framework: {{Codepath2|htdocs|lib/common.inc.php}} → tpl_BuildTemplate()
... und in der lib2:
* Systemtemplate: {{Codepath2|htdocs|templates2/ocstyle/sys_main.tpl}}
* Menüsystem: Tabelle 'sys_menu' per {{Codepath2|htdocs|doc/sql/static-data/data.sql}}, {{Codepath2|htdocs|lib2/menu.class.php}}
* PHP-Framework: {{Codepath2|htdocs|lib2/OcSmarty.class.php}}

Zusätzliche Hauptmenü-Punkte sind via [[#Konfigurationsdateien|Konfigurationsdateien]] erzeugbar.

=== Email-Templates ===

Auch der Inhalt (''body'') von Emails wird über Templates erzeugt.

lib1-Email-Templates befinden sich in {{Codepath|htdocs/lang/de/ocstyle/email}}, {{Codepath|htdocs/util/notification}} und {{Codepath|htdocs/util/watchlist}} und werden von den entsprechenden PHP-Modulen direkt per <code>mb_ereg_replace()</code> aufgelöst.

lib2-Email-Templates liegen in {{Codepath|htdocs/templates2/mail}} und werden von <code>mail.class.php</code> per Smarty verarbeitet.

=== OKAPI ===
Die OKAPI hat ein eigenes Templatesystem; mehr dazu im Abschnitt [[#OKAPI|OKAPI]].

== CSS Style Sheets ==
Die Style Sheets befinden sich in {{Codepath|htdocs/resource2/ocstyle/css}}.

== Grafiken ==

Grafiken für Icons und andere Dinge verteilen sich – soweit es keine Drittbibliotheken betrifft – über drei Verzeichnisse:

* {{Codepath|htdocs/images}} (lib2 und lib2)
* {{Codepath|htdocs/lang/de/ocstyle/images}} (lib1)
* {{Codepath|htdocs/resource2/ocstyle/images}} (lib2)

Hier herrscht etwas Chaos. Manches ist mehrfach vorhanden - auch innerhalb ''einer'' Library - oder inkonsistent abgelegt, die Dateitypen wechseln zwischen GIF und PNG. Glattziehen lässt sich das kaum, weil Grafiken auch gerne von anderer Stelle aus verlinkt werden, z.B. aus Cachelistings - teils sogar von anderen Plattformen aus. Schiebt man die Grafiken einfach weg oder ändert das Format, zerstört es unbemerkt Cachebeschreibungen.

Zur Kompatibilität mit alten Cachebeschreibungen und Logs liegen in folgenden Verzeichnissen Grafiken, die anderweitig nicht mehr verwendet werden:

* {{Codepath|htdocs/lang/de/stdstyle/images}}
* {{Codepath|htdocs/lib/tinymce/plugins/emotions/images}}
* {{Codepath|htdocs/resource2/stdstyle/images}}

== Übersetzung ==

Der OC-Code ist mehrsprachig und frei übersetzbar, mit Ausnahme
* der Benachrichtigungs-Emails, die es bislang nur in Deutsch gibt (-> http://redmine.opencaching.de/issues/141)
* des Garmin-Download-Dialogs ({{Codepath2|htdocs|garmin.php}}), dessen untere Hälfte es nur in Deutsch und Englisch gibt (siehe {{Codepath|htdocs/resource2/ocstyle/js/GarminDisplay.js}})
(weitere noch nicht lokalisierbare Module bitte ergänzen!)

Die Lokalisierung je nach gewählte Sprache erfolgt grundsätzlich mit folgenden Mechanismen:
* In Templates über die Smarty-Tags <code>{t}English Text{/t}</code>. Hierbei können auch Variablen eingesetzt werden, z.B.
*:<code>{t 1=$cachename 2=$username}The geocache %1 has been found by %2{/t}</code>
* Notfalls direkt im PHP-Code durch Aufruf von <code>$translate->t()</code>, z.B.
*:<code>$text = $translate->t('New password code', <nowiki>''</nowiki>, basename(__FILE__), __LINE__)</code>
* Bei Artikelseiten, die via {{Codepath|htdocs/articles.php}} dargestellt werden, per Ablage der Templates in Unterverzeichnissen von {{Codepath|htdocs/templates2/ocstyle/articles}}.

Das Übersetzungssystem arbeitet intern mit <code>gettext()</code>. Die Strings dafür befinden sich in der Tabellen ''sys_trans'' und ''sys_trans_text''. Man kann sie direkt via {{Codepath2|htdocs/doc/sql/static-data|data.sql}} einpflegen, oder mit dem "Schnellübersetzungsmodus" + "SQL-Export" von {{Codepath2|htdocs|translate.php}} (Menü Admin|Übersetzung). Letzteres kann allerdings jede Menge Git-Merge-Konflikte beim Zusammenführen verschiedener Branches erzeugen, daher werden OC.de-Übersetzungen derzeit nur direkt in {{Codepath2|htdocs/doc/sql/static-data|data.sql}} eingepflegt.

Achtung: '''Auch für die englische Seitendarstellung läuft nochmal alles durch den Übersetzer''', Artikel ausgenommen. Die englischen Originaltexte in den Templates oder im PHP-Code sind also nur eine Basis für die weitere Übersetzung. Kleinere Fehler dort müssen nicht korrigiert werden, solange die Texte verständlich sind. ''Wenn'' dort etwas korrigiert wird, muss es gleichzeitig auch in der Tabelle ''sys_trans'' in {{Codepath2|htdocs/doc/sql/static-data|data.sql}} geändert werden!

Opencaching.de gibt es zurzeit in Deutsch, Englisch, Italienisch und Spanisch. Die Übersetzungen werden durch den von Opencaching Deutschland eingesetzten Code Maintainer organisiert.

== Fehlerbehandlung ==

Der OC-Code verwendet kein Exception Handling (mit Ausnahme der OKAPI). Wenn etwas fehlschlägt, wird dies durch den Rückgabewert der betreffenden Funktion signalisiert und entsprechend reagiert. Würde man den betroffenen Funktionen noch einen Namenszusatz spendieren, der die mögliche Fehlerrückgabe kennzeichnet, wäre dieses System transparenter und in sich weniger fehleranfällig als ein strukturiertes Exception Handling.

==== fehlerhafte Benutzereingaben ====
Wenn es Probleme mit einer Benutzereingabe gibt, wird das betreffende Template nochmals angezeigt und an passender Stelle eine mit dem CSS-Stil <code>errormsg</code> formatierte Meldung eingeblendet. Dies ist jeweils entsprechend zu implementieren.

==== erkanntes Problem ====
Wenn anderweitig ein nicht handhhabbares Problem erkannt wird, wird das Fehlertemplate angezeigt. In '''lib1''' befindet sich dies in {{Codepath2|htdocs|lang/de/ocstyle/error.tpl.php}} und wird aufgerufen per
:<code>tpl_errorMsg('original_templatename', $fehlermeldung);</code>
z.B.
$error_desc_not_found = t('(internal error) The description is not available.');
...
tpl_errorMsg('editdesc', $error_desc_not_found);

Das '''lib2'''-Fehlertemplate befindet sich in bzw. {{Codepath2|htdocs|templates2/ocstyle/error.tpl}} und wird verwendet mit
:<code>$tpl->error(Fehlernummer)</code>
oder
:<code>$tpl->error($fehlermeldung);</code>
Die Fehlernummern sind in {{Codepath2|htdocs|lib2/error.inc.php}} definiert.

; SQL-Fehler

Bei MySQL-Fehlern wird ein Fehlertemplate anzeigt und eine Admin-Email versandt, sofern in den [[#Konfigurationsdateien|Settings]] eine Mailadresse hinterlegt ist. In der lib1 ist sie in
:<code>$sql_errormail</code>
einzutragen, in der lib2 in
:<code>$opt['db']['error']['mail']</code>.
Entwicklersysteme werden so konfiguriert, dass das komplette SQL-Statement auch direkt angezeigt wird.

Zusätzlich kann man per <code>$sql_warntime</code> (lib1) bzw. <code>$opt['db']['warn']['time']</code> (lib2) eine Warnschwelle für zu lange SQL-Ausführungszeiten festlegen. Bei Überschreitung werden dann Admin-Mails erzeugt.

==== unerkanntes Problem ====

{{Codepath2|htdocs|lib2/errorhandler.inc.php}} enthält ein noch in der Testphase befindlichen Handler für PHP-Fehler, der auch in lib1 eingebunden ist. Er wird bei PHP-Fehlern aktiv, die (abhängig von der ''error_reporting''-Einstellung in der PHP-Konfiguration) zu einem Abbruch des Scripts führen. Es wird dann eine Fehlermeldung anzeigt und ggf. eine Admin-Mail erzeugt. Es wird die gleiche Emailkonfiguration wie für bei SQL-Problemen (s.o.) verwendet.

Dieser PHP-Errorhandler ist derzeit nur aktiviert, wenn in der Konfiguration der Debug-Modus eingeschaltet ist. Ansonsten erscheint bei Fehlern eine leere Seite.

== OKAPI ==

Die Opencaching-API ist ein eigenständiges PHP-Projekt, dessen Code auf verschiedenen OC-Seiten zum Einsatz kommt. Die Projekt-Homepage ist http://code.google.com/p/opencaching-api/. Beiträge, die nicht vom Code-Maintainer selbst kommen, werden üblicherweise in Branches hochgeladen und laufen dann durch ein Code Review.

Die OKAPI wird – erfolgreich! – mit einem wesentlich höheren Anspruch an Codequalität und -Stil entwickelt als die OC-Länderseiten. Dokumentation und Codestruktur sind herausragend. Gleichzeitig steht sie bei einigen Details wie Template-Engine, Datenbank-Library und Konstanten-Definitionen hinter dem OC.de-Code zurück. Der OKAPI-Code ist nur für Webanwendungen geschrieben; Einbindung in Kommandozeilentools kann insbesondere am Exception-Handling scheitern.

Der OKAPI-Code wird aus dem OKAPI-Projekt in die lokalen OC-Code-Repositories (nach {{Codepath|htdocs/okapi}}) repliziert. Bei Opencaching.pl und .nl geschieht dies automatisch über einen SVN-"Commit-Hook", bei Opencaching.de manuell durch den Code-Maintainer nach einem Security Review.

OKAPI-Code kann über die "Facade"-Schnittstelle in OC-Code eingebunden werden ({{Codepath2|htdocs|okapi/facade.php}}). OC.pl macht davon insbesondere bei der Karte Gebrauch, die von der OKAPI generiert wird. OC.de verwendet die Facade bislang nur (experimentell) im Update-Script {{Codepath|bin/okapi-update.php}}, das von {{Codepath2|bin|dbupdate.php}} aufgerufen wird.

Sämtliche OKAPI-Seitenzugriffe laufen über eine Rewrite-Engine ({{Codepath2|htdocs|okapi/.htaccess}} → {{Codepath2|htdocs|okapi/controller.php}}). Man kann daher die PHP-Scripte nicht direkt über ihre URLs idenitifizieren sondern muss schonmal etwas suchen. Methoden befinden sich in {{Codepath2|htdocs|okapi/services}}, Seiten mit HTML-Output in {{Codepath2|htdocs|okapi/views}}.

Für die Dokumentation verwendet die OKAPI ein eigenes XML-Format, das von einem Parser aufbereitet wird.

Templates für Methoden, die HTML- oder sonstiges XML-Output liefern, sind in .tpl.php-Dateien zusammen mit den PHP-Quelltexten abgelegt. Variablen werden per PHP-Code eingebunden, meist per "short open tags", z.B.

<? if (($vars['my_notes'] == 'desc:text') && ($c['my_notes'] != null)) { /* Does user want us to include personal notes? */ ?>
<p><b><?= _("Personal notes") ?>:</b> <?= Okapi::xmlescape($c['my_notes']) ?></p>
<? } ?>

[[Kategorie:Entwicklung|Codedoku]]

Urheberrecht

2013-10-13T07:14:26Z

Dl6hbo:

Wenn du [[Erstellen einer Cachebeschreibung/ Listing|Cachebeschreibungen]] oder [[Das Onlinelog|Logeinträge]] erstellst oder Bilder dazu hochlädst bestätigst du, dass diese sowohl auf Opencaching.de als auch durch Dritte in unveränderter Form veröffentlicht werden dürfen (kommerzielle Nutzung ausgenommen). '''Dies gilt auch für Texte und Bilder, die nicht von dir selbst stammen'''.

Falls du Texte und Bilder von Dritten für deine Caches verwenden möchtest, musst du daher sicherstellen, dass '''deren Urheber eine solche Verwendung und Veröffentlichung ausdrücklich gestattet''' und dies im Zweifelsfall nachweisen können; zum Beispiel durch eine schriftliche Einverständniserklärung. Stehen die Inhalte unter einer Lizenz, die eine Verwendung nur unter Namensnennung gestattet – so wie z.B. auch in diesem Wiki oder in der Wikipedia –, dann ''musst'' du den Name des oder der Urheber in deiner Cachebeschreibung bzw. deinem Log mit angeben. (Bei Wiki-Artikeln genügt dazu ein Link auf die Original-Versionsgeschichte). Oft wird auch eine Quellenangabe gefordert; daher ist es ratsam, immer die '''Quelle mit anzugeben''', z.B. eine Internet-Adresse.

Wenn du dies nicht beachtest kann es sein, dass du eine Urheberrechtsverletzung begehst, die kostenpflichtige Abmahnungen und strafbewehrte Unterlassungserklärungen nach sich ziehen kann.

== Recht am eigenen Bild ==

Wenn auf einem Foto Personen klar identifizierbar sind, so muss eine Einverständniserklärung dieser Personen vorliegen, um das Foto veröffentlichen zu können. Andernfalls können sie Schadensersatzansprüche geltend machen.

== Vorgehensweise bei Urheberrechtsverletzungen auf Opencaching.de ==

Erster Ansprechpartner bei (mutmaßlichen) Urheberrechtsverletzungen sollte der [[Besitzer|Cachebesitzer]] sein. Als [[Registrierung|registrierter]] Benutzer kannst du ihn über die E-Mail-Funktion in seinem [[Benutzerprofil|Opencaching-Profil]] anschreiben.

Wahlweise besteht die Möglichkeit, den Cache an das Opencaching-Team zu melden. Verwende dazu die [[Cache melden|Meldefunktion]] für den jeweiligen Cache, wähle als Grund „Urheberrechtsverletzung“ und gib nähere Erläuterungen an, zum Beispiel die Internetseite von der ein Bild oder Text stammt. Opencaching wird den Cache nach Prüfung vorerst sperren, sodass das Listing nicht mehr einsehbar ist, und den [[Besitzer|Cachebesitzer]] kontaktieren.

Eine dritte Möglichkeit ist eine Email an [mailto:contact@opencaching.de contact@opencaching.de].

{{Rechtshinweis}}

[[Kategorie:Listings und Logs]]
[[Kategorie:Recht]]

Privatgrund

2013-10-13T07:07:21Z

Dl6hbo: /* Grundsätzlich gilt */

{{deutschlandlastig}}

Als '''Privatgrund''' gelten in Deutschland Grundstücke und Gebäude, deren Nutzung – insbesondere das Betreten – durch den Eigentümer eingeschränkt ist. Der Eigentümer<ref>Die Begriffe „Grundeigentum“ und „Grundbesitz“ werden in der Umgangssprache oft synonym gebraucht. Im Folgenden ist mit beidem immer – im juristischen Sinne – Eigentum gemeint.</ref> muss keine Privatperson oder -organisation sein, sondern es kann sich auch um die öffentliche Hand handeln. Im Gegensatz hierzu steht das ''Betretungsrecht'',<ref>Das Betretungsrecht wird in Deutschland bundesweit durch Naturschutzgesetz, Waldgesetz und Wasserhaushaltsgesetz geregelt. Zusätzlich kann es durch weitere Rechtsvorschriften auf Landes- und kommunaler Ebene eingeschränkt werden.</ref> das die Nutzung bestimmter Flächen durch die Allgemeinheit erlaubt, solange es vor Ort keine ausdrückliche Einschränkung gibt.

Die Suche nach der [[Wie verstecke ich einen Cache?#Die richtige Stelle für eine Cacheversteck|richtigen Stelle für ein Cacheversteck]] kann so manche Stolperfalle in Richtung Privatgrund bereithalten.
__NOTOC__
== Eingefriedete Grundstücke ==
[[Datei:BetretenVerboten.JPG|thumb|300px|Hier haben wir nichts verloren und nichts zu suchen.]]
Besonders sensibel sind von uns diejenigen Grundstücke und Orte zu behandeln, die deutlich als Privatgrund erkennbar sind, sei es durch aufgestellte Schilder, Einfriedungen (Mauern, Zäune, Hecken, etc. oder sonstige Abgrenzung). Diese sollten für uns sowohl als Sucher, besonders aber als [[Owner]] absolute Tabuzonen sein, es sei denn, man hat vorher ausdrücklich und nachweisbar (am besten schriftlich) die Genehmigung des Besitzers erhalten. Liegt eine solche Genehmigung nicht vor und wir betreten diese Grundstücke, machen wir uns des Hausfriedensbruchs schuldig bzw. stiften als Owner sogar andere dazu an. Dies kann für alle Beteiligten zu nicht unerheblichen rechtlichen Konsequenzen führen.

Liegt eine solche Genehmigung des Grundbesitzers vor, ist es zunächst mal machbar an einem solchen Ort einen Cache zu verstecken; dennoch gibt es hier einiges zu beachten. Ein solcher Cache sollte möglichst „minimal invasiv“ versteckt sein, d.h. er sollte so versteckt sein, dass er

# nah am offiziellen Weg ist
# schnell und ohne großes Suchen gefunden werden kann
# kein fremdes Eigentum beschädigt
# niemanden stört

und die Erlaubnis sollte deutlich im Listing erwähnt sein.
Weiterhin sollte man in einem solchen Fall als Owner immer im Auge haben, dass sich Besitzverhältnisse auch ändern können und dann Genehmigungen u.U. hinfällig sind.

Wenn man bei der Suche nach einem OC-Cache feststellt, dass diese Regeln nicht eingehalten werden, sollte man die Suche abbrechen und über die Funktion [[Cache melden]], die in der oberen Buttonleiste eines jeden Caches zu finden ist, an Opencaching.de melden. Wenn man hier weitersucht, kann man mit etwas Pech genau DERjenige sein, der erwischt und bestraft wird …

== Wälder ==

Auch jeder Wald hat einen Eigentümer, der über seine Nutzung mitentscheiden kann. Wälder sind in der Regel nicht eingefriedet, und es gibt z. B. in Deutschland ein Betretungsrecht. Ungeachtet dessen kann jeder Waldbesitzer in seinem eigenen Wald bestimmte Tätigkeiten untersagen, auch das Verstecken von Geocaches. Wer diesem Verlangen des Grundstückseigentümers nicht nachkommt, riskiert kostenpflichtig auf Unterlassung und/oder Beseitigung in Anspruch genommen zu werden.

Bei Wäldern ist es oft kaum möglich, den Besitzer herauszufinden um vorher um Erlaubnis zu fragen, auch wenn dies streng genommen nötig ist. Daher ist es besonders wichtig, dass jeder Cache einen [[Stash Note|Hinweis für Zufallsfinder]] enthält. Dieser sollte nicht nur über den Zweck des Behälters aufklären, sondern muss entsprechend den [[Opencaching.de-Nutzungsbedingungen]] auch eine Kontaktmöglichkeit mit dem [[Owner]] aufzeigen, an den sich der Grundstücksbesitzer wenden kann, wenn er den Cache entfernt haben möchte, z. B. eine E-Mail-Adresse und/oder eine Mobiltelefonnummer. (Diese Angabe ist im Übrigen für alle Caches verpflichtend, nicht nur für solche im Wald.)

== Grundsätzlich gilt ==

Sollte sich ein Grundstücksbesitzer an einen Owner wenden und ihn um Entfernung seines Caches bitten, ist dem selbstverständlich sofort Folge zu leisten.

== Anmerkungen ==
<references />

{{Rechtshinweis}}

[[Kategorie:Recht]]

Privatgrund

2013-10-13T07:05:23Z

Dl6hbo: /* Grundsätzlich gilt */

{{deutschlandlastig}}

Als '''Privatgrund''' gelten in Deutschland Grundstücke und Gebäude, deren Nutzung – insbesondere das Betreten – durch den Eigentümer eingeschränkt ist. Der Eigentümer<ref>Die Begriffe „Grundeigentum“ und „Grundbesitz“ werden in der Umgangssprache oft synonym gebraucht. Im Folgenden ist mit beidem immer – im juristischen Sinne – Eigentum gemeint.</ref> muss keine Privatperson oder -organisation sein, sondern es kann sich auch um die öffentliche Hand handeln. Im Gegensatz hierzu steht das ''Betretungsrecht'',<ref>Das Betretungsrecht wird in Deutschland bundesweit durch Naturschutzgesetz, Waldgesetz und Wasserhaushaltsgesetz geregelt. Zusätzlich kann es durch weitere Rechtsvorschriften auf Landes- und kommunaler Ebene eingeschränkt werden.</ref> das die Nutzung bestimmter Flächen durch die Allgemeinheit erlaubt, solange es vor Ort keine ausdrückliche Einschränkung gibt.

Die Suche nach der [[Wie verstecke ich einen Cache?#Die richtige Stelle für eine Cacheversteck|richtigen Stelle für ein Cacheversteck]] kann so manche Stolperfalle in Richtung Privatgrund bereithalten.
__NOTOC__
== Eingefriedete Grundstücke ==
[[Datei:BetretenVerboten.JPG|thumb|300px|Hier haben wir nichts verloren und nichts zu suchen.]]
Besonders sensibel sind von uns diejenigen Grundstücke und Orte zu behandeln, die deutlich als Privatgrund erkennbar sind, sei es durch aufgestellte Schilder, Einfriedungen (Mauern, Zäune, Hecken, etc. oder sonstige Abgrenzung). Diese sollten für uns sowohl als Sucher, besonders aber als [[Owner]] absolute Tabuzonen sein, es sei denn, man hat vorher ausdrücklich und nachweisbar (am besten schriftlich) die Genehmigung des Besitzers erhalten. Liegt eine solche Genehmigung nicht vor und wir betreten diese Grundstücke, machen wir uns des Hausfriedensbruchs schuldig bzw. stiften als Owner sogar andere dazu an. Dies kann für alle Beteiligten zu nicht unerheblichen rechtlichen Konsequenzen führen.

Liegt eine solche Genehmigung des Grundbesitzers vor, ist es zunächst mal machbar an einem solchen Ort einen Cache zu verstecken; dennoch gibt es hier einiges zu beachten. Ein solcher Cache sollte möglichst „minimal invasiv“ versteckt sein, d.h. er sollte so versteckt sein, dass er

# nah am offiziellen Weg ist
# schnell und ohne großes Suchen gefunden werden kann
# kein fremdes Eigentum beschädigt
# niemanden stört

und die Erlaubnis sollte deutlich im Listing erwähnt sein.
Weiterhin sollte man in einem solchen Fall als Owner immer im Auge haben, dass sich Besitzverhältnisse auch ändern können und dann Genehmigungen u.U. hinfällig sind.

Wenn man bei der Suche nach einem OC-Cache feststellt, dass diese Regeln nicht eingehalten werden, sollte man die Suche abbrechen und über die Funktion [[Cache melden]], die in der oberen Buttonleiste eines jeden Caches zu finden ist, an Opencaching.de melden. Wenn man hier weitersucht, kann man mit etwas Pech genau DERjenige sein, der erwischt und bestraft wird …

== Wälder ==

Auch jeder Wald hat einen Eigentümer, der über seine Nutzung mitentscheiden kann. Wälder sind in der Regel nicht eingefriedet, und es gibt z. B. in Deutschland ein Betretungsrecht. Ungeachtet dessen kann jeder Waldbesitzer in seinem eigenen Wald bestimmte Tätigkeiten untersagen, auch das Verstecken von Geocaches. Wer diesem Verlangen des Grundstückseigentümers nicht nachkommt, riskiert kostenpflichtig auf Unterlassung und/oder Beseitigung in Anspruch genommen zu werden.

Bei Wäldern ist es oft kaum möglich, den Besitzer herauszufinden um vorher um Erlaubnis zu fragen, auch wenn dies streng genommen nötig ist. Daher ist es besonders wichtig, dass jeder Cache einen [[Stash Note|Hinweis für Zufallsfinder]] enthält. Dieser sollte nicht nur über den Zweck des Behälters aufklären, sondern muss entsprechend den [[Opencaching.de-Nutzungsbedingungen]] auch eine Kontaktmöglichkeit mit dem [[Owner]] aufzeigen, an den sich der Grundstücksbesitzer wenden kann, wenn er den Cache entfernt haben möchte, z. B. eine E-Mail-Adresse und/oder eine Mobiltelefonnummer. (Diese Angabe ist im Übrigen für alle Caches verpflichtend, nicht nur für solche im Wald.)

== Grundsätzlich gilt ==

Sollte sich ein Grundstücksbesitzer an einen Owner wenden und ihn um Entfernung eines Caches bitten, ist dem selbstverständlich sofort Folge zu leisten.

== Anmerkungen ==
<references />

{{Rechtshinweis}}

[[Kategorie:Recht]]

GPS

2013-10-12T12:58:01Z

Dl6hbo: /* Geschichtlicher Überblick */

[[Datei:GPS-Satelliten.gif|rechts]]
'''GPS''' (''Global Positioning System'') ist ein Navigations-Satellitensystem, das zur Positionsbestimmung und Zeitmessung dient. Es bildet die technische Grundlage des [[Geocaching]]s.

== Funktionsweise ==
Ein Empfänger auf der Erde – zum Beispiel ein [[GPS-Gerät]] – empfängt Signale von Satelliten, welche sich in einer Umlaufbahn um die Erde befinden und ständig Datenpakete mit verschiedenenen Informationen (insbesondere der Sendezeit und augenblicklichen Position des Satelliten) versenden. Der GPS-Empfänger vergleicht die Ankunftszeiten der Signale und berechnet die Entfernung zu den einzelnen Satelliten. Zur Bestimmung der Position des Empfängers im Raum (Breitengrad, Längengrad und Höhe) werden mindestens drei verschiedenen Satelliten benötigt.

Die Anforderungen an die Genauigkeit der Systems sind durch die Übertragung der Signale mit Lichtgeschwindigkeit sehr hoch gesteckt: Weicht die Laufzeit um eine tausendstel Sekunde ab, so entsteht ein Distanzfehler von 300 km. Damit wäre das System unbrauchbar. Um eine brauchbare Genauigkeit zu erreichen, benötigt man daher oft das Signal eines vierten Satelliten.

Um einen Kontakt des GPS-Empfängers mit mindestens vier Satelliten zu gewährleisten, sind ingesamt mindestens 24 Satelliten im Einsatz, welche die Erde zweimal täglich in über 20.000 km Höhe umkreisen.

== Genauigkeit ==
Mit einem guten GPS-Gerät lässt sich bei optimalen Empfangsbedingungen eine Genauigkeit von 2–3 Metern erzielen. Dabei kann man sich nicht immer auf die Anzeige des Geräts verlassen: Manchmal schwanken die Messwerte in einem größeren Bereich als angegeben, weshalb es sich beim Einmessen eines Geocaches immer empfiehlt, die Koordinaten aus mehreren Messungen zu [[Wie verstecke ich einen Cache?#Koordinaten messen|mitteln]].

Um einen optimalen Signalempfang zu ermöglichen, ist eine direkte Sichtverbindung zu den Satelliten erforderlich. Wenn man unter nassen Bäumen unterwegs ist, kann es je nach Qualität des Empfängers Abweichungen geben.

Größere Ungenauigkeiten treten vor allem in geschlossenen Gebäuden oder zwischen hohen Gebäuden auf. Sie können auch durch ungünstige Stellung der Satelliten entstehen (beispielsweise bei dicht beieinander stehenden Satelliten); demnach sind für eine genaue Positionsbestimmung Satellitensignale aus verschiedenen Himmelsrichtungen vom Vorteil. In Gebäudenähe ist oft das Phänomen der „springenden Koordinaten“ zu beobachten: Man macht nur wenige Schritte, und plötzlich befindet sich der Cache 20 Meter weiter vorn oder hinten. Hier empfehlen sich mehrere Anläufe aus verschiedenen Richtungen, um das Versteck aufzuspüren.

Die GPS-Signale werden durch das Wetter (Bewölkung, Niederschlag) nur wenig beeinflusst.

== Geschichtlicher Überblick ==
Der erste GPS-Satellit startete im Jahr 1978, nachdem fünf Jahre zuvor das GPS-Programm gestartet worden war. 1985 wird dann die volle Funktionsbereitschaft bekannt gegeben. Zu dieser Zeit befanden sich bereits 24 Satelliten im Einsatz.

Um militärische Gegner auszuschließen, wurde die Genauigkeit für alle Nutzer ohne Zugangsschlüssel künstlich verschlechtert. Die Fehler waren dabei größer als 100 m und ließen somit keine genaue Positionsbestimmung zu.

Zum 1. Mai 2000 schaltete man diese künstliche Ungenauigkeit wieder ab. Seitdem ist das System für alle Anwendungsbereiche zur präzisen Positionsbestimmung nutzbar. Dies führte zum Aufschwung von Navigationssystemen und in den USA und zum Legen des ersten „[[Geocache|Geocaches]]“ (damals gab es den Begriff noch nicht). Diese neue Freizeitbeschäftigung verbreitete sich schnell in viele weitere Länder.

== Weblinks ==
* [http://de.wikipedia.org/wiki/GPS Global Positioning System] – ausführlicher Artikel in der Wikipedia
* [http://www.youtube.com/watch?v=u0cmsCVonSQ Trickfilm zur Funktionsweise]

[[Kategorie:Geocaching]]

[[pl:GPS]]

FTF

2013-10-12T12:51:46Z

Dl6hbo: /* FTF-Jäger */

'''FTF''' steht für engl. ''First to find'' und bezeichnet den ersten Finder eines neuen Geocaches. STF und TTF stehen für den zweiten und dritten Finder (''Second / Third to Find'').

Den Behälter als Erster aus dem Versteck zu holen und sich als Erster ins jungfräuliche [[Logbuch]] einzutragen hat für viele Geocacher einen besonderern Reiz. Bei [[PETling]]-[[Cachegrößen#Mikro|Mikros]] darf man oft auch noch den „Siegelverschluss“ des Deckels als Erster öffnen. Neue Caches sind allerdings meist noch ungetestet, d.h. es sind auch negative Überraschungen möglich wie Tippfehler bei den Koordinaten, zu niedrig angegebene [[Schwierigkeitswertung]] etc.

Achtung: Dass ein Cache keine [[Das Onlinelog|Online-Logs]] hat heißt nicht, dass er noch nicht gefunden wurde – FTF-Banausen vergessen manchmal das Loggen oder lassen sich damit Zeit.

[[Datei:SchrottieCache.JPG|thumb|vorbereiteter Cache mit FTF-Urkunden]]
== FTF-Urkunde ==
Manche Cachebesitzer legen ihrem Frischling eine oder mehrere ''FTF-Urkunden'' bei, die sich die ersten Finder mitnehmen dürfen.

→ [[Vorlagen zum Ausdrucken#Urkunden|FTF-Urkunden zum Ausdrucken]]

== FTF-Jäger ==
Den FTF zu „machen“ ist oft mit einem sportlichen Wettbewerb verbunden. Sobald die [[Benachrichtigungen]] über einen neuen Cache rausgehen, alarmiert dies die FTF-Jäger, die sich umgehend auf die Suche machen. Ob die [[Location]] gut gewählt und der Cache schön gestaltet ist, spielt dabei leider oft keine Rolle; stattdessen geht es um einen Punkt für die persönliche FTF-[[Statistikcacher|Statistik]] und die FTF-Bekanntgabe im Log.

Falls dich das als Opencaching-[[Owner]] stört und du den Erstfund lieber dem Zufall überlassen möchtest, kannst du die FTF-Jäger überlisten:
# Lege das neue Listing mit der Einstellung ''noch nicht veröffentlichen'' an.
# Bearbeite das Listing; ändere den [[Cachestatus|Status]] in ''momentan nicht verfügbar'' und wähle gleichzeitig ''sofort veröffentlichen''.
# Bearbeite das Listings nochmals und ändere den Status in ''kann gesucht werden''.
Bei dieser Vorgehensweise werden keine Benachrichtigungen für den neuen Cache verschickt.

== Ungefundene Caches ==
Die [[OKAPI]] besitzt eine „FTF-Hunter“-Funktion, mit der sich Caches ohne Fundlogs heraussuchen lassen; siehe [http://www.opencaching.de/okapi/services/caches/search/all.html#arg_ftf_hunter Dokumentation für Programmierer].

[[Kategorie:Geocaching]]

[[pl:FTF]]

API-Clients

2013-10-12T12:49:17Z

Dl6hbo: /* Sonstiges */

Diese Seite listet Programme und Webseiten auf, die die [[Opencaching-API]] (OKAPI) oder die [[XML-Schnittstelle]] verwenden und auf Opencaching.de-Daten zugreifen (können). Weitere Programme sind in Arbeit.

Wenn du ein eigenes Programm oder eine eigene Webseite mit API-Zugriff veröffentlicht hast, kannst du es/sie hier eintragen.

== OKAPI-Clients ==
=== Smartphone-Apps ===

* [http://www.cgeo.org c:geo]
* [[Smartphone-Apps_für Opencaching.de#Columbus|Columbus]]
* [http://noname043.cba.pl/?page_id=11 Mobicaching]
* [https://play.google.com/store/apps/details?id=net.rygielski.roadrunner QuickFind]
* [https://play.google.com/store/apps/details?id=pl.b64.opencaching B64-OpenCaching for Android]

=== Desktop-Programme ===
* [[GSAK|GSAK-Makro]]

=== Webseiten ===

* [[Flopps Tolle Karte]] / [http://www.flopp.net/okapi/ OKAPI-Karte] / [http://www.flopp.net/safari/ Safari-Cache-Karte]
* [http://www.xctrails.org/map.html XCTrails] / [http://www.xctrails.org/oc-mobile/oc.html Opencaching.de Mobile Seite]

== XML-Clients ==
=== Smartphone-Apps ===
* [[Smartphone-Apps für Opencaching.de#GeOrg|GeOrg]]

=== Desktop-Programme ===
* [[CacheWolf]]

=== Webseiten ===

== Sonstiges ==
[[Ocprop]] greift direkt auf Opencaching.de-Seiten zu, um Cachebeschreibungen oder Logs einzustellen. Diese Vorgehensweise ist fehleranfällig und daher nicht empfehlenswert.

Falls Funktionen benötigt werden, die die bestehenden APIs nicht bereitstellen, können diese ggf. nachgerüstet werden. Wer mag, kann solche Erweiterungen auch selbst in die OKAPI oder die OC-Software einbauen.

[[Kategorie:Geocaching-Software]]
[[Kategorie:Opencaching]]

Garmin Mapsource

2013-10-12T12:18:19Z

Dl6hbo:

'''Mapsource''' (bis Oktober 2010) bzw. '''Basecamp''' (ab Oktober 2010) sind kostenlose Windows- und MacOS Programme der Firma Garmin, die verschiedene nützliche Funktionen für die von Garmin hergestellten [[GPS-Gerät]]e bieten. Man kann damit [[Wegpunkte]], Routen und Tracks (aufgezeichnete Wege) auf sein GPSr hochladen oder davon herunterladen. Außerdem können Karten verwaltet und auf das Gerät geladen werden.

Mapsource und Basecamp selbst beinhalten nur eine primitive Karte mit Autobahnen und Großstädten, aber es lassen sich zusätzliche Karten wie die [[OSM-Karte]] installieren und darstellen. Auf der Karte kann man dann auch Wegpunkte eintragen, Entfernungen messen, sich die Lage von Geocaches im Gelände anschauen etc.

== Opencaching-Suche via Mapsource ==
Bei Mapsource gibt es die Möglichkeit, Websites über sogenannte ''Weblink-Erweiterungen'' einzubinden, die Aktionen für die aktuelle Koordinate ausführen. Für Opencaching.de gibt es eine Weblink-Erweiterung, die einen direkten Aufruf der Opencaching-[[Suchformular|Umkreissuche]] aus Mapsource heraus ermöglicht.

=== Installation ===
Lade zunächst die entsprechende Datei herunter ([[#Weblinks|siehe unten]]). Dies geschieht durch einen Rechtsklick mit der Maus und dann '''Speichern unter ...'''.<br />
Jetzt richtet man die Erweiterung ein:
* Mapsource öffnen
* Menü Bearbeiten → Voreinstellungen
* Reiter Weblinks
* '''Weblink hinzufügen ...'''
Jetzt gibst du die heruntergeladene Datei an und bestätigst den Dialog. (Falls es in deinem Mapsource keinen Reiter „Weblinks“ geben sollte, ist sie zu alt. Unten findest du einen Download-Link für die neueste Version.)

Die Umkreissuche kann nun verwendet werden. Dazu klickt man in Mapsource ein Wegpunkt oder eine freie Fläche mit der rechten Maustaste an, wodurch die Umkreissuche von Opencaching.de geöffnet werden kann.

Das deutsche Weblink-Makro basiert auf einer polnischen Version von [http://www.opencaching.pl Opencaching.pl].

== Weblinks ==
* [http://www.opencaching.de/resource2/misc/mapsource/opencachingde.wlx Download der Weblink-Erweiterung für Opencaching]
* [http://www8.garmin.com/support/download_details.jsp?id=209 Download von Garmin MapSource]
* [http://www.garmin.com/de/map/basecamp Download von Garmin Basecamp]

[[Kategorie:Geocaching-Software]]

OCDL

2013-10-11T15:13:07Z

Dl6hbo: /* Verfügbare gespeicherte Suchen auslesen */

'''OCDL''' ('''O'''pen'''c'''aching '''D'''own'''l'''oader) ist ein [[wikipedia:Python_(Programmiersprache)|Python]]-Skript zum Download von [[Suchformular#Gespeicherte Suche|gespeicherten Suchen]] als [[GPX-Datei|GPX-Dateien]]. OCDL ist besonders dann nützlich, wenn man regelmäßig gespeicherte Suchen herunterladen möchte, beispielsweise um die Cache-Datenbank von [[OpenCacheManager]] auf einem aktuellen Stand zu halten. Das Skript ist dabei weniger für die manuelle und interaktive Verwendung gedacht, als für den automatisierten, zeitgesteuerten Aufruf, beispielsweise via [[wikipedia:Cron|Cron]].

== Systemvoraussetzungen ==
OCDL ist ein betriebssystemunabhängiges Skript und sollte auf allen Systemen lauffähig sein, auf denen eine aktuelle Python-Version installiert ist. Typische Unixe bringen Python bereits mit; unter Windows ist meist eine manuelle Installation von Python notwendig (z.B. [http://www.activestate.com/activepython ActivePython]).

== Allgemein ==
OCDL ist ein Kommandozeilenprogramm und wird daher innerhalb der Kommandozeile (Linux/Unix: Terminalfenster, Windows: Eingabeaufforderung) verwendet.
Wie für Kommandozeilenprogramme üblich, verfügt OCDL über eine integrierte Hilfsfunktion, die über den Parameter <tt>--help</tt> aufgerufen werden kann:
<pre>
user@host:~/GPX> ./ocdl.py --help
Usage: ocdl.py [options] [ID...]

Options:
--version show program's version number and exit
-h, --help show this help message and exit
-s, --setup create the necessary directories; ask the user for
login credentials
-c CONFIGDIR, --configdir=CONFIGDIR
specify directory for config files (cookies, login
information); default is '~/.ocdl'
-l, --list list available queries, do not download them
-n STYLE, --name=STYLE
select naming style of downloaded queries, STYLE={ ID,
ID+DATE, NAME, NAME+DATE }, default is 'ID'
-d TARETDIR, --dir=TARETDIR
select target directory for downloaded queries;
default is the current directory
-v, --verbose print verbose status messages

ocdl.py logs in to opencaching.de using login credentials which are stored |
| in '~/.ocdl/config.txt' (the actual directory is configurable using the |
| '--configdir' command line option). |
| |
| You can use the command line option '--setup' to create the configuration |
| directory and to initialize the config file with your login credentials. |
| |
| Alternatively, you can manually create the configuration directory and |
| the config file: |
| Make sure the directory '~/.ocdl/' (or whatever you chose by |
| '--configdir') exists and contains the file 'config.txt' with the |
| following two lines: |
| |
| OCDE_LOGIN='username' |
| OCDE_PASSWORD='password' |
| |
| where username and password are your login credentials for opencaching.de |
| |
| |
| Moreover, ocdl.py stores the login cookie 'cookies.txt' in the selected |
| config directory for future logins. |
</pre>

== Konfiguration ==
OCDL hat eine Setup-Funktion, die die notwendigen Verzeichnisse anlegt und den Nutzer nach seinen Zugangsdaten für Opencaching.de fragt. Dazu ruft man OCDL mit dem Parameter <tt>--setup</tt> auf und gibt seine Zugangsdaten ein:
<pre>
user@host:~/GPX> ./ocdl.py --setup
Performing setup.
Enter your username for OC.de: XXX
Enter your password for OC.de: YYY
Setup done. You may re-run 'ocdl.py' in normal mode.
</pre>
Danach ist OCDL fertig konfiguriert und kann normal verwendet werden. Falls sich die Zugangsdaten ändern sollten, kann die Setup-Funktion jederzeit wieder aufgerufen werden.

== Verfügbare gespeicherte Suchen auslesen ==
Mit dem Kommandozeilenparameter <tt>--list</tt> wird die Liste der im [[Benutzerprofil|Opencaching-Benutzerprofil]] gespeicherten Suchen abgefragt und ausgegeben:
<pre>
user@host:~/GPX> ./ocdl.py --list
11339629/'Tradis in Berlin'
42325999/'OC-only Deutschland'
</pre>
In obigem Beispiel sind zwei Suchen verfügbar, nämlich „Tradis Berlin“ mit der ID 11339629 und „OC-only Deutschland“ mit der ID 42325999. Die ID-Nummern werden für den Download der Suchen benötigt.

== Download der Suchen ==
Hat man festgestellt, welche Suchen überhaupt verfügbar sind, kann man diese auch herunterladen. Dazu übergibt man die entsprechende ID als Parameter an OCDL.

Mit folgendem Aufruf läd man die Suche „OC-only Deutschland“ als ZIP-komprimierte GPX-Datei herunter:
<pre>
user@host:~/GPX> ./ocdl.py 42325999
</pre>

Die heruntergeladene Datei wird dann '''42325999.zip''' genannt und im aktuellen Verzeichnis abgelegt bzw. in dem Verzeichnis, dass über den Parameter <tt>--dir</tt> festgelegt wurde.

Die Benennung der Dateien kann über den Parameter <tt>--name</tt> beeinflusst werden:
* <tt>--name ID</tt> erzeugt Dateien nach dem Schema '''ID.zip''', im Beispiel: '''42325999.zip'''
* <tt>--name ID+DATE</tt> erzeugt Dateien nach dem Schema '''ID_Datum.zip''', hängt also das aktuelle Datum an die ID an; im Beispiel: '''42325999_2012-10-26.zip'''
* <tt>--name NAME</tt> erzeugt Dateien nach dem Schema '''Name.zip''', wobei '''Name''' der Name der gespeicherten Suche ist; Leerzeichen im Name werden dabei durch Unterstriche ersetzt; im Beispiel: '''OC-only_Deutschland.zip'''
* <tt>--name NAME+DATE</tt> erzeugt Dateien nach dem Schema '''Name_Datum.zip'''; im Beispiel: '''OC-only_Deutschland_2012-10-26.zip'''

== Weblinks ==
* [https://raw.github.com/flopp/ocdl.py/master/ocdl.py Direkt-Download von OCDL]
* [https://github.com/flopp/ocdl.py OCDL bei github.com]
* [http://www.python.org/ Python]

[[Kategorie:Geocaching-Software]]
[[Kategorie:Opencaching]]

Garmin Mapsource

2013-10-11T15:08:03Z

Dl6hbo:

'''Mapsource''' (bis Oktober 2010) bzw. '''Basecamp''' (ab Oktober 2010) sind kostenlose Windows- und MAC OS X Programme der Firma Garmin, die verschiedene nützliche Funktionen für die von Garmin hergestellten [[GPS-Gerät]]e bieten. Man kann damit [[Wegpunkte]], Routen und Tracks (aufgezeichnete Wege) auf sein GPSr hochladen oder davon herunterladen. Außerdem können Karten verwaltet und auf das Gerät geladen werden.

Mapsource und Basecamp selbst beinhalten nur eine primitive Karte mit Autobahnen und Großstädten, aber es lassen sich zusätzliche Karten wie die [[OSM-Karte]] installieren und darstellen. Auf der Karte kann man dann auch Wegpunkte eintragen, Entfernungen messen, sich die Lage von Geocaches im Gelände anschauen etc.

== Opencaching-Suche via Mapsource ==
Bei Mapsource gibt es die Möglichkeit, Websites über sogenannte ''Weblink-Erweiterungen'' einzubinden, die Aktionen für die aktuelle Koordinate ausführen. Für Opencaching.de gibt es eine Weblink-Erweiterung, die einen direkten Aufruf der Opencaching-[[Suchformular|Umkreissuche]] aus Mapsource heraus ermöglicht.

=== Installation ===
Lade zunächst die entsprechende Datei herunter ([[#Weblinks|siehe unten]]). Dies geschieht durch einen Rechtsklick mit der Maus und dann '''Speichern unter ...'''.<br />
Jetzt richtet man die Erweiterung ein:
* Mapsource öffnen
* Menü Bearbeiten → Voreinstellungen
* Reiter Weblinks
* '''Weblink hinzufügen ...'''
Jetzt gibst du die heruntergeladene Datei an und bestätigst den Dialog. (Falls es in deinem Mapsource keinen Reiter „Weblinks“ geben sollte, ist sie zu alt. Unten findest du einen Download-Link für die neueste Version.)

Die Umkreissuche kann nun verwendet werden. Dazu klickt man in Mapsource ein Wegpunkt oder eine freie Fläche mit der rechten Maustaste an, wodurch die Umkreissuche von Opencaching.de geöffnet werden kann.

Das deutsche Weblink-Makro basiert auf einer polnischen Version von [http://www.opencaching.pl Opencaching.pl].

== Weblinks ==
* [http://www.opencaching.de/resource2/misc/mapsource/opencachingde.wlx Download der Weblink-Erweiterung für Opencaching]
* [http://www8.garmin.com/support/download_details.jsp?id=209 Download von Garmin MapSource]
* [http://www.garmin.com/de/map/basecamp Download von Garmin Basecamp]

[[Kategorie:Geocaching-Software]]

GPS-Gerät

2013-10-11T14:53:33Z

Dl6hbo: /* Funktionen */

[[Datei:Garmin Oregon 550.jpg|thumb|hochkant=0.7]]
Als '''GPS-Gerät''' (kurz: '''GPSr''') bezeichnen Geocacher kompakte und robuste Navigationsgeräte im Format eines älteren Handys oder kleinen Funkgeräts. Die Geräte empfangen Signale von Satelliten des [[GPS|GPS-Systems]] und berechnen daraus die aktuelle Position, unter guten Bedingungen auf wenige Meter genau. Außerdem verfügen sie immer über die exakte Uhrzeit.

Eine Alternative zum GPS-Gerät sind [[Smartphone]]s mit [[Smartphone-Apps für Opencaching.de|Geocaching-Apps]]. Nicht empfehlenswert sind dagegen Straßen-Navigationssysteme – sie sind nicht für Outdoor-Einsatz gebaut und bieten wenig Geocaching-Komfort.

Fragen zu GPS-Geräten kannst du jederzeit im [http://forum.geocaching-network.com/index.php?board=31.0 Opencaching-Forum] stellen.

== Funktionen ==
Moderne GPS-Geräte besitzen eine Fülle von Funktionen. Folgende sind für das Geocaching wichtig:

; Koordinatenanzeige
Die ersten GPS-Geräte beherrschten nur diese eine Grundfunktion: Anzeige von Längen- und Breitengrad, mit weiterer Unterteilung in Minuten und Sekunden oder Tausendstel-Minuten. Für die Geocaching-Pioniere genügte dies, um einen Cache zu finden und auch heute noch so manchem Puristen.

[[Datei:ETrexx Wegpunkt mitteln.JPG|thumb|Wegpunkteingabe]]
; [[Wegpunkte]] speichern
Das können alle heute angebotenen Geräte: Koordinaten mit einer Bezeichung versehen und speichern – entweder von Hand, oder indem man sie per [[Abkürzungen#GPX|GPX-Datei]] auf das Gerät [[Wie finde ich meinen ersten Cache?#Einen Geocache auf das Navigationsgerät übertragen|überträgt]]. Anschließend wählt man einen Wegpunkt als Ziel der Cachesuche, und die Entfernung bis zum Ziel wird laufend angezeigt.

; Kompass
Sobald man unterwegs ist und sich zumindest im Schritttempo bewegt, kann das GPS-Gerät aus der sich verändernden Position Richtung und Geschwindigkeit ermitteln. Die Richtung zu einem gewählten Ziel zeigt es auf einem Kompass an.<br/>
Bessere Geräte besitzen einen elektronischen Kompass, der auch dann noch funktioniert wenn man stehenbleibt oder durchs Gebüsch kriecht.

; Karte
Die meisten GPS-Geräte können heute Geländekarten darstellen. Dies ist eine große Hilfe bei der Cachesuche – jeder der schonmal auf der falschen Seite eines Bahngleises oder reißenden Baches stand weiß sie zu schätzen. Es gibt freie und kostenlose [[OpenStreetMap|OpenStreetMap-Karten]] sowie teure Karten zum Kaufen.

== Weblinks ==
* [http://forum.geocaching-network.com/index.php?topic=1924.0 Welche GPS-Geräte verwenden OpenCacher?]

[[Kategorie:GPS-Geräte]]

[[pl:Odbiornik GPS]]

Letterboxing

2013-10-11T10:05:23Z

Dl6hbo: /* Situation in Deutschland */

Beim Letterboxing handelt es sich um ein Hobby, welches starke Ähnlichkeiten zu Geocaching aufweist. ''Letterbox'' ist ein englisches Wort für Briefkasten.

== Ursprung ==
Die Anfänge des Letterboxing findet man im Jahr 1854. Zu dieser Zeit gab es einen Führer in England (Dartmoor), welcher an Wanderwegen Behälter hinterließ, welche er mit Postkarten bzw. Briefen bestückte. Der Name dieser Freizeitbeschäftigung erinnert an diese Art von Briefkästen.

== Besonderheiten ==
Da es zu Gründungszeiten des ''Letterboxing'' noch keine [[GPS-Gerät]]e gab, wird dieser Beschäftigung auch heute noch ohne solch ein Gerät nachgegangen – zum einen, um die Tradition zu bewahren, zum anderen, da ein Großteil der Menschen, die dieses Hobby betreiben, über kein entsprechendes Gerät verfügt. Stattdessen stützt man sich auf eine Beschreibung (''Clues''), in der Peilungen, Entfernungsangaben oder Rätsel etc. enthalten sind.

Analog zu [[Geocache|Geocaches]] findet man auch hier ein [[Logbuch]] vor. Neben dem Hinterlassen einer Nachricht wird zusätzlich erwartet, dass man mit einem persönlichen Stempel seine Anwesehenheit „unterschreibt“. Außerdem findet man in jeder Letterbox einen Stempel, mit welchem man als Beweis seines Besuches einen Abdruck in sein eigenes Logbuch machen darf. Dieser Stempel ist meistens selbst erstellt und darf auf '''keinem''' Fall mitgenommen werden.

Eine weitere Besonderheit sind die Postkarten, welche in Letterboxen hinterlegt sind und mit der Adresse des Besitzers versehen sind. Um seinen Fund zu dokumentieren, soll der Finder eine von diesen mitnehmen und dann abschicken, um den Fund der Box zu „loggen“. Dieses Vorgehen entstammt einerseits dem Ursprung des Letterboxing, andererseits ist ein Onlinelog, wie es beim Geocaching der Fall ist, auf den traditionellen Letterboxing-Seiten nicht üblich. Jedoch ist diese Tradition durch die vermehrte Nutzung von E-Mails vom Aussterben bedroht.

Üblicherweise findet man in Letterboxen keine [[Tauschgegenstände]], sondern nur ein Logbuch, einen Stift, einen Stempel und evtl. Postkarten.

Der Zeitaufwand führ Letterboxen liegt zumeist nicht unter einer Stunde.<br />
Auch beim Letterboxing findet man [[Reisende]], welche als ''Hitchhiker'' (Tramper, Anhalter) bezeichnet werden. Jedoch haben diese eine nicht so große Verbreitung wie [[Geokret]]s.

== Situation in Deutschland ==
Durch das Eröffnen eines Forums wurde im Jahr 2006 durch die deutsche Letterboxing-Seite das öffentliche Loggen ermöglicht. Jedoch ist in Deutschland nur eine geringe Anzahl an Letterboxen versteckt. Im Gegensatz zu anderen Ländern, allen voran die USA, ist diese Anzahl extrem niedrig.

Bei den deutschen Letterboxen liegen meist längere Wanderungen zugrunde, bei denen vieles über Kultur und Geschichte erzählt wird. Vordergründig ist dabei der Weg und nicht die Suche der Box. Die Anzahl der Reisenden hält sich in Deutschland in Grenzen, wobei es in den USA weitaus mehr gibt.

== Listing auf Opencaching ==
[[Datei:Letterbox-attribut.png|thumb|Letterbox-Attribut]]
Wenn Letterboxen den Nutzungsbedingungen der Webseite entsprechen, so dürfen sie auf Opencaching.de gelistet werden. Dabei muss das Letterbox-[[Attribute|Attribut]] gewählt werden, wodurch eine gezielte Suche nach Letterboxen über das [[Suchformular]] möglich ist.<br />
'''Beim Doppellisting auf Opencaching.de und Letterboxing-Germany.de sollte darauf geachtet werden, dass immer beide Beschreibungen aktuell sind.'''

Für Geocaching-Neulinge sind solche „Letterbox-Hybride“ eine interessante Möglichkeit, um in das Hobby reinzuschnuppern, ohne sich zuvor ein [[GPS-Gerät]] zu besorgen.

== Weblinks ==
* [http://www.opencaching.de/search.php?searchto=searchbyname&showresult=1&expert=0&output=HTML&utf8=1&sort=bydistance&orderRatingFirst=0&f_userowner=0&f_userfound=0&f_inactive=1&f_ignored=0&f_otherPlatforms=0&country=&cachetype=1%3B2%3B3%3B4%3B5%3B6%3B7%3B8%3B9%3B10&cachesize=1%3B2%3B3%3B4%3B5%3B6%3B7&difficultymin=0&difficultymax=0&terrainmin=0&terrainmax=0&cache_attribs=8&cache_attribs_not=7&cachename=%25 Letterboxen auf Opencaching.de]
* [http://www.Letterboxing-Germany.de Letterboxing in Deutschland]
* [http://michael-wilhelm.info/lbg_forum/ Forum zu Letterboxing-Germany.de]
* [http://www.letterboxing.org Letterboxing in Nord-Amerika] (englisch)
* [http://www.atlasquest.com Internationale Letterboxing-Seite] (englisch)

[[Kategorie:Geocaching]]

[[pl:Letterboxing]]

Letterboxing

2013-10-11T10:03:55Z

Dl6hbo: /* Besonderheiten */

Beim Letterboxing handelt es sich um ein Hobby, welches starke Ähnlichkeiten zu Geocaching aufweist. ''Letterbox'' ist ein englisches Wort für Briefkasten.

== Ursprung ==
Die Anfänge des Letterboxing findet man im Jahr 1854. Zu dieser Zeit gab es einen Führer in England (Dartmoor), welcher an Wanderwegen Behälter hinterließ, welche er mit Postkarten bzw. Briefen bestückte. Der Name dieser Freizeitbeschäftigung erinnert an diese Art von Briefkästen.

== Besonderheiten ==
Da es zu Gründungszeiten des ''Letterboxing'' noch keine [[GPS-Gerät]]e gab, wird dieser Beschäftigung auch heute noch ohne solch ein Gerät nachgegangen – zum einen, um die Tradition zu bewahren, zum anderen, da ein Großteil der Menschen, die dieses Hobby betreiben, über kein entsprechendes Gerät verfügt. Stattdessen stützt man sich auf eine Beschreibung (''Clues''), in der Peilungen, Entfernungsangaben oder Rätsel etc. enthalten sind.

Analog zu [[Geocache|Geocaches]] findet man auch hier ein [[Logbuch]] vor. Neben dem Hinterlassen einer Nachricht wird zusätzlich erwartet, dass man mit einem persönlichen Stempel seine Anwesehenheit „unterschreibt“. Außerdem findet man in jeder Letterbox einen Stempel, mit welchem man als Beweis seines Besuches einen Abdruck in sein eigenes Logbuch machen darf. Dieser Stempel ist meistens selbst erstellt und darf auf '''keinem''' Fall mitgenommen werden.

Eine weitere Besonderheit sind die Postkarten, welche in Letterboxen hinterlegt sind und mit der Adresse des Besitzers versehen sind. Um seinen Fund zu dokumentieren, soll der Finder eine von diesen mitnehmen und dann abschicken, um den Fund der Box zu „loggen“. Dieses Vorgehen entstammt einerseits dem Ursprung des Letterboxing, andererseits ist ein Onlinelog, wie es beim Geocaching der Fall ist, auf den traditionellen Letterboxing-Seiten nicht üblich. Jedoch ist diese Tradition durch die vermehrte Nutzung von E-Mails vom Aussterben bedroht.

Üblicherweise findet man in Letterboxen keine [[Tauschgegenstände]], sondern nur ein Logbuch, einen Stift, einen Stempel und evtl. Postkarten.

Der Zeitaufwand führ Letterboxen liegt zumeist nicht unter einer Stunde.<br />
Auch beim Letterboxing findet man [[Reisende]], welche als ''Hitchhiker'' (Tramper, Anhalter) bezeichnet werden. Jedoch haben diese eine nicht so große Verbreitung wie [[Geokret]]s.

== Situation in Deutschland ==
Durch das Eröffnen eines Forums wurde im Jahr 2006 durch die deutsche Letterboxing-Seite das öffentliche Loggen ermöglicht. Jedoch ist in Deutschland nur eine geringe Anzahl an Letterboxen versteckt. Im Gegensatz zu anderen Ländern, allen voran die USA, ist diese Anzahl extrem niedrig.

Bei den deutschen Letterboxen liegen meist längere Wanderungen zugrunde, bei denen vieles über Kultur und Geschichte erzählt wird. Vordegründlich ist dabei der Weg und nicht die Suche der Box. Die Anzahl der Reisenden hält sich in Deutschland in Grenzen, wobei es in den USA weitaus mehr gibt.

== Listing auf Opencaching ==
[[Datei:Letterbox-attribut.png|thumb|Letterbox-Attribut]]
Wenn Letterboxen den Nutzungsbedingungen der Webseite entsprechen, so dürfen sie auf Opencaching.de gelistet werden. Dabei muss das Letterbox-[[Attribute|Attribut]] gewählt werden, wodurch eine gezielte Suche nach Letterboxen über das [[Suchformular]] möglich ist.<br />
'''Beim Doppellisting auf Opencaching.de und Letterboxing-Germany.de sollte darauf geachtet werden, dass immer beide Beschreibungen aktuell sind.'''

Für Geocaching-Neulinge sind solche „Letterbox-Hybride“ eine interessante Möglichkeit, um in das Hobby reinzuschnuppern, ohne sich zuvor ein [[GPS-Gerät]] zu besorgen.

== Weblinks ==
* [http://www.opencaching.de/search.php?searchto=searchbyname&showresult=1&expert=0&output=HTML&utf8=1&sort=bydistance&orderRatingFirst=0&f_userowner=0&f_userfound=0&f_inactive=1&f_ignored=0&f_otherPlatforms=0&country=&cachetype=1%3B2%3B3%3B4%3B5%3B6%3B7%3B8%3B9%3B10&cachesize=1%3B2%3B3%3B4%3B5%3B6%3B7&difficultymin=0&difficultymax=0&terrainmin=0&terrainmax=0&cache_attribs=8&cache_attribs_not=7&cachename=%25 Letterboxen auf Opencaching.de]
* [http://www.Letterboxing-Germany.de Letterboxing in Deutschland]
* [http://michael-wilhelm.info/lbg_forum/ Forum zu Letterboxing-Germany.de]
* [http://www.letterboxing.org Letterboxing in Nord-Amerika] (englisch)
* [http://www.atlasquest.com Internationale Letterboxing-Seite] (englisch)

[[Kategorie:Geocaching]]

[[pl:Letterboxing]]

Event

2013-10-11T09:57:31Z

Dl6hbo: /* Wie organisiere ich ein Event? */

[[Datei:Eventliste.png|thumb|300px|Eventliste auf der Opencaching-Startseite]]
Ein '''Event''' ist eine Veranstaltung, bei der sich Geocacher treffen und kennenlernen können. Er wird wie ein zu suchender [[Geocache]] [[Erstellen einer Cachebeschreibung/ Listing|gelistet]]: Als Cacheart wird [[Cachearten#Event-Cache|Event-Cache]] gewählt, die Koordinaten geben den Ort des Treffens an und das Versteckdatum den geplanten Termin. Daher liegt dieses Versteckdatum beim Anlegen des Listings – im Gegensatz zu einem gewöhnlichen Geocache – stets in der Zukunft. Der Event erscheint dann auf der [[Cachekarte]] und in einer Übersicht direkt auf der Startseite von Opencaching.de. Außerdem ist er natürlich per [[Suchformular]] findbar.

Ein Event kann ein Treffen in einer Gaststätte sein (z.B. als Stammtisch) oder draußen stattfinden (z.B. als Aufräumevent/[[Abkürzungen#CITO|CITO]]). Da man sich im kleinen Kreis besser unterhalten kann, sollte das Listing als [[OConly]] eingestellt werden, also nur auf der [[Geocaching-Plattformen|Plattform]] Opencaching.de veröffentlicht werden. Falls jedoch viele Teilnehmer erwünscht sind (z.B. bei einem Flashmob), dann sollte das Event auch auf anderen Plattformen gelistet sein.

=== Wie organisiere ich ein Event? ===
[[Datei:OC6E6B Newbie-Event Berlin.jpg|thumb|links|{{Cachelink|OC6E6B|Newbie-Event in Berlin}}, September 2011]]
Falls du selber ein Event organsieren willst, dann reserviere vorher einen entsprechend großen Raum in deinem Lieblingsrestaurant. Sprich frühzeitig mit dem Gastwirt die Bezahlweise ab, denn der Spruch „Der Letzte zahlt die Zeche“ gilt nicht. Hier hat sich die Durchnummerierung der Teilnehmer oder der Bierdeckel bewährt, völlig unproblematisch ist natürlich eine Sofort-Kasse. Damit die Teilnehmer einfacher in Kontakt kommen, bieten sich Namensschilder (z.B. Klebeetiketten) an. Ein Logbuch, in das sich die Geocacher eintragen können, ist zwar keine Pflicht, aber eine nette Erinnerung für später. Bitte vergiss nicht, den Event hinterher auch zu archivieren, wobei eine zeitliche Verzögerung von einem Monat angemessen ist.

Bei einer Außenveranstaltung sollte ein Programm existieren. Ein Beispiel wäre das gemeinsame Aufräumen einer vermüllten [[Location]] ([[Abkürzungen#CITO|CITO]]). Dieses Programm sollte dann im Listing detailliert aufgeführt werden, damit es vor Ort gleich reibungslos losgehen kann.

=== Wie logge ich ein Event? ===
Als Logtyp wird vor der Veranstaltung ein „[[Das Onlinelog#Möchte teilnehmen|möchte teilnehmen]]“ geloggt, so dass im [[Listing]] eine Teilnehmerliste entsteht. Wenn der Event stattgefunden hat, dann wird die Teilnahme als „[[Das Onlinelog#Teilgenommen|teilgenommen]]“ geloggt. Auch ein Organisator darf seinen Event so loggen, schließlich war er mit dabei.

[[Kategorie:Geocaching]]

[[pl:Skrzynka typu Wydarzenie]]

Nachtcache

2013-10-11T09:54:38Z

Dl6hbo: /* Pflege */

Bei einem '''Nachtcache''' handelt es sich um einen [[Geocache]], welcher nur bei Dunkelheit gefunden werden kann. Das [[Listing|Cachelisting]] sollte mit dem „Nur-bei-Nacht“-[[Attribute|Attribut]] gekennzeichnet sein, sodass man auf Opencaching.de gezielt nach Nachtcaches [[Cachekarte#Suchen_eines_Caches|suchen]] kann.

Meist handelt es sich um [[Multicache]]s oder auch [[Rätselcache]]s, deren Weg mit [[#Reflektoren|Reflektoren]] gekennzeichnet ist. Dabei können unterschiedliche Reflektorfarben den Weg und bestimmte Orte (Gabelungen, Zwischenstationen, Finale etc.) signalisieren.

== Nachtcaches suchen ==
[[Datei:OC00C5 Nachtcache.jpg|200px|thumb|rechts|Impression während eines Nachtcaches]]
Der besondere Reiz an Nachtcaches ist das Erlebnis, in vollkommener Dunkelheit durch eine Gegend zu laufen, welche man bisher noch nie so erlebt hat. Es dringen ganz neue Geräusche und andere Sinneseindrücke zum Cacher und alles hat etwas Mystisches.

Da die Reflektoren zumeist in größeren Abständen angebracht sind, ist eine starke [[Taschenlampe]] vom Vorteil ([[Naturschutz]] beachten). Manchmal kommt es auch vor, dass eine [[UV-Lampe]] oder ähnliche Spezialwerkzeuge benötigt werden. Dies ist dann jedoch in der Beschreibung des Caches vermerkt.

Im Wald kann es passieren, dass wichtige Elemente von Ästen etc. verdeckt sind. Diese müssen dann erst gesucht werden, da man sonst Probleme mit der weiteren Wegführung bekommen könnte.

== Nachtcaches legen ==
Wie bei allen Cachearten gilt: Bevor du einen Nachtcache legst, solltest du schon einige gesucht und gefunden haben. So lernst du, was man dabei richtig und falsch machen kann (→ [[Wie verstecke ich einen Cache?#Der richtige Zeitpunkt für den ersten eigenen Geocache|Der richtige Zeitpunkt für den ersten eigenen Geocache]]).

Beim Legen eines Nachtcaches sollte man sich bewusst sein, dass man als Eigentümer eine große Verantwortung trägt. Man sollte darauf achten, dass der Weg ungefährlich ist, d. h. einigermaßen „stolperfrei“, möglichst nicht in der Nähe von Tieren (Wildschweinsuhlen etc.) und nicht im Umfeld eines Jägers. Möchte man dennoch einen Nachtcache in einem Jagdgebiet legen, so ist eine Absprache mit dem zuständigen Revierförster empfehlenswert.

=== Reflektoren ===
[[Datei:OC318A Nachtcache 01.jpg|200px|thumb|rechts|Reflektoren]]
Es ist üblich, unterschiedliche Stationen des Caches mit verschiedenfarbige Reflektoren zu kennzeichnen. Je nach Farbe markieren sie beispielsweise eine Weggabelung, eine Zwischenstation und das Ziel.

Reflektoren bekommt man am günstigsten im Baumarkt. Dort gibt es Reflektorbänder in allen möglichen Farben für einen niedrigen Preis. Jedoch sollte auch auf eine gute Qualität geachtet werden, da die Reflektoren durch Wettereinflüsse altern und ein häufiger Wechsel der Reflektoren notwendig sein könnte.

Die Abstände zwischen den Reflektoren sollten so gewählt sein, dass sie nicht zu nah aneinander, aber auch nicht zu weit entfernt voneinander befestigt sind. Sie sollten sich immer im Erfassungsbereich einer starken Taschenlampe befinden.

Die Reflektoren sollten im Sinne des [[Naturschutz]]es so angebracht sein, dass sie die Umwelt nicht schädigen.

[[Datei:Nachcache-Attribute.png|thumb]]
=== Listing ===
Im Listing muss der Cache als Nachtcache ausgewiesen werden. Dies geschieht am besten durch das „Nur-bei-Nacht“-Attribut. Zusätzlich sollte das Taschenlampen-Attribut gesetzt sein.<br />
Desweiteren sollte im Listing vermerkt sein, was die einzelnen Reflektorfarben bedeuten. Sonst kann es vor Ort zu ziemlichen Irritationen kommen.

=== Pflege ===
Gelegentlich sollte kontrolliert werden, ob am Weg des Caches keine neuen Gefahrenquellen (wie z. B. die bereits erwähnten Wildschweinsuhlen) entstanden sind; ggf. ist der Weg zu verändern.

Reflektoren können durch äußere Einflüsse beschädigt werden oder verschwinden. Daher sollten sie gelegentlich kontrolliert und ggf. ersetzt werden. Man sollte immer genügend Reparaturmaterial haben, um in diesem Fall möglichst bald reagieren zu können.

[[Kategorie:Geocaches]]

OConly

2013-10-10T09:49:34Z

Dl6hbo: /* Wie finde ich OConlys */

Die OConlys sind ganz besondere Caches!
[[Datei:OConly.jpeg|Das OConly Logo|right]]

== Was ist ein OConly? ==

Ein OConly ist ein Cache, der '''nur''' auf opencaching.de veröffentlicht ist. Er wird vom Besitzer mit dem OConly-[[Attribute|Attribut]] markiert. Diese besonderen, exklusiven Caches machen "das Herz" von Opencaching.de aus. Sie sind nur bei uns zu finden und locken somit immer neue Cacher zu Opencaching.de. Durch ein Veröffentlichen von OConly-Caches kannst du uns aktiv unterstützen. Zurzeit gibt es rund 3000 Caches mit OConly-Attribut, und weitere ca. 3000 OConlys, bei denen das Attribut fehlt.

== Wie finde ich OConlys ==

Auf unserer Opencaching-[http://www.opencaching.de/map2.php Karte] kannst du unten bei 'Attribute' auf 'OConly' klicken. Dann werden dir nur Caches mit OConly-Attribut angezeigt. Stattdessen kannst du auch unter 'Ausblenden' das Häkchen bei 'auf GC gelistet' entfernen. Dann werden Dir nur Caches angezeigt, bei denen der Besitzer keinen GC-[[Wegpunkte|Wegpunkt]] angegeben hat - also auch die OConlies ohne Attribut.

Da die externen Wegpunkte nicht immer eingetragen werden, unterhält das [[Datenpflege]]team zusätzlich eine Liste mit weiteren GC-Wegpunkten, die in den [[Listing|Cachelistings]] fehlen. Auch diese Caches werden mit ausgeblendet.

; Die OCony-Karte

Eine weitere Möglicheit ist die [http://oconly.de OConly-Karte], die nicht von Opencaching.de betrieben wird, aber ebenfalls die Daten des [[Datenpflege]]teams verwendet.

:<imagemap>
Datei:OConly.de.png
rect 10 11 55 43 [http://oconly.de/?auswahl=1]
rect 65 11 113 43 [http://oconly.de/?auswahl=2]
rect 123 11 168 43 [http://oconly.de/?auswahl=3]
desc none
</imagemap>

* Wennn du auf das rechte Symbol (non-GC) klickst erscheinen alle Caches, die auf Opencaching, aber nicht auf geocaching.com gelistet sind - das heißt alle OConlies und ein paar Caches, die es auch auf sonstigen Plattformen wie Navicache gibt.

* Das mittlere, blaue Symbol zeigt nur Caches mit OConly-Attribut an.

* Das ? zeigt alle OConly-Caches an, bei denen die OC-Datenpfleger nicht herausfinden konnten, ob sie noch findbar und logbar sind. Du kannst uns unterstützen, indem du solche Caches in deiner Gegend suchst und loggst, und uns mit dem Link über der [http://oconly.de?auswahl=1 OConly-Karte] Rückmeldungen gibst.

== Wie markiere ich einen eigenen Cache als OConly? ==

Dazu bearbeitest du den Cache und setzt im Abschnitt „[[Attribute#Attribute eingeben |Cacheattribute]]“ die OConly-Markierung.

== OConly-81 ==

''OConly-81'' ist eine sportliche Herausforderung bei der es darum geht, OConly-Caches in möglichst vielen [[Schwierigkeitswertung|Schwierigkeits-]] und [[Geländewertung]]en zu finden. In deinen [[Benutzerprofil]]-Einstellungen kannst du unter „Details“ die OConly-81-Statistik aktivieren, die dann in deinem [http://www.opencaching.de/viewprofile.php öffentlichen Benutzerprofil] erscheint.

Weitere Informationen gibt es auf der [http://www.opencaching.de/oconly81.php OConly-81-Seite].

== Siehe auch ==
* [[Mehrfachlisting]], das Gegenteil eines OConlies
* [[Vorlagen zum Ausdrucken#Informationsmaterial|OConly-Hinweis zum Ausdrucken]]

[[Kategorie:Opencaching]]
[[Kategorie:Geocaches]]

{{unvollständig|
* Farbige Hervorhebung der OConlys auf der Karte}}

OConly

2013-10-10T09:47:08Z

Dl6hbo: /* Was ist ein OConly? */

Die OConlys sind ganz besondere Caches!
[[Datei:OConly.jpeg|Das OConly Logo|right]]

== Was ist ein OConly? ==

Ein OConly ist ein Cache, der '''nur''' auf opencaching.de veröffentlicht ist. Er wird vom Besitzer mit dem OConly-[[Attribute|Attribut]] markiert. Diese besonderen, exklusiven Caches machen "das Herz" von Opencaching.de aus. Sie sind nur bei uns zu finden und locken somit immer neue Cacher zu Opencaching.de. Durch ein Veröffentlichen von OConly-Caches kannst du uns aktiv unterstützen. Zurzeit gibt es rund 3000 Caches mit OConly-Attribut, und weitere ca. 3000 OConlys, bei denen das Attribut fehlt.

== Wie finde ich OConlys ==

Auf unserer Opencaching-[http://www.opencaching.de/map2.php Karte] kannst du unten bei 'Attribute' auf 'OConly' klicken. Dann werden dir nur Caches mit OConly-Attribut angezeigt. Stattdessen kannst du auch unter 'Ausblenden' das Häkchen bei 'auf GC gelistet' entfernen. Dann werden Dir nur Caches angezeigt, bei denen der Besitzer keinen GC-[[Wegpunkte|Wegpunkt]] angegeben hat - also auch die OConlies ohne Attribut.

Da die externen Wegpunkte nicht immer eingetragen werden, unterhält das [[Datenpflege]]team zusätzlich eine Liste mit weiteren GC-Wegpunkten, die in den [[Listing|Cachelistings]] fehlen. Auch diese Caches werden mit ausgeblendet.

; Die OCony-Karte

Eine weitere Möglicheit ist die [http://oconly.de OConly-Karte], die nicht von Opencaching.de betrieben wird, aber ebenfalls die Daten des [[Datenpflege]]teams verwendet.

:<imagemap>
Datei:OConly.de.png
rect 10 11 55 43 [http://oconly.de/?auswahl=1]
rect 65 11 113 43 [http://oconly.de/?auswahl=2]
rect 123 11 168 43 [http://oconly.de/?auswahl=3]
desc none
</imagemap>

* Wennn du auf das rechte Symbol (non-GC) klickst erscheinen alle Caches, die auf Opencaching, aber nicht auf geocaching.com gelistet sind - das heißt alle OConlies und ein paar Caches, die es auch auf sonstigen Plattformen wie Navicache gibt.

* Das mittlere, blaue Symbol zeigt nur Caches mit OConly-Attribut an.

* Das ? zeigt alle OConly-Caches an, bei denen die OC-Datenpfleger nicht herausfinden konnte, ob sie noch findbar und logbar sind. Du kannst uns unterstützen, indem du solche Caches in deiner Gegend suchst und loggst, und uns mit dem Link über der [http://oconly.de?auswahl=1 OConly-Karte] Rückmeldungen gibst.

== Wie markiere ich einen eigenen Cache als OConly? ==

Dazu bearbeitest du den Cache und setzt im Abschnitt „[[Attribute#Attribute eingeben |Cacheattribute]]“ die OConly-Markierung.

== OConly-81 ==

''OConly-81'' ist eine sportliche Herausforderung bei der es darum geht, OConly-Caches in möglichst vielen [[Schwierigkeitswertung|Schwierigkeits-]] und [[Geländewertung]]en zu finden. In deinen [[Benutzerprofil]]-Einstellungen kannst du unter „Details“ die OConly-81-Statistik aktivieren, die dann in deinem [http://www.opencaching.de/viewprofile.php öffentlichen Benutzerprofil] erscheint.

Weitere Informationen gibt es auf der [http://www.opencaching.de/oconly81.php OConly-81-Seite].

== Siehe auch ==
* [[Mehrfachlisting]], das Gegenteil eines OConlies
* [[Vorlagen zum Ausdrucken#Informationsmaterial|OConly-Hinweis zum Ausdrucken]]

[[Kategorie:Opencaching]]
[[Kategorie:Geocaches]]

{{unvollständig|
* Farbige Hervorhebung der OConlys auf der Karte}}

Benutzerprofil

2013-10-10T08:39:47Z

Dl6hbo:

[[Datei:Profil.png|thumb|rechts|330px|Beispiel für ein Benutzerprofil]]
Das '''Benutzerprofil''' ist dein persönliches „Opencaching-Kontrollzentrum“. Hier kannst du sehen, welche Geocaches du [[Das Onlinelog|geloggt]], [[Wie verstecke ich einen Cache?|versteckt]] und [[Empfehlungen|empfohlen]] hast, und hier kannst du alle deine Benutzereinstellungen ändern.

Um ein Profil zu erhalten, musst du dich zunächst bei Opencaching.de [[Registrierung|registrieren]]. Sobald du dich [[Login auf Opencaching.de|eingeloggt]] hast, kannst du dein Profil mit dem Knopf MEIN PROFIL in der Menüleiste aufrufen.

Andere Benutzer können sich dein ''öffentliches Profil'' anschauen, indem sie in einem deiner Logs oder [[Listing|Cachelistings]] auf deinen Benutzername klicken, genauso wie du dir die Profile anderer Benutzer ansehen kannst. Sie sehen dort das Datum deiner Registrierung, eine grobe Angabe über den Zeitraum seit deinem letzten Login und eine Statistik deiner versteckten und gefundenen Caches. Weitere Informationen kannst du auf Wunsch eingeben bzw. einblenden – siehe „Details“ im nachfolgender Abschnitt.

Du kannst dir dein öffentliches Profil auch selbst anschauen, indem du links im Menü auf „Öffentliches Profil“ klickst.

== Statistik ==
Die Zahl der gefundenen Caches im ersten Abschnitt bezieht sich auf alle geloggten Funde und [[Event|Eventteilnahmen]] – einschließlich Caches, die zwischenzeitlich [[Cachestatus#Gesperrt + Versteckt|gesperrt/versteckt]] wurden. Wenn ein Cache mehrfach geloggt wurde – z.B. ein wiederkehrendes Event oder ein beweglicher Cache – zählt er mehrfach.

Wenn du auf „alle Funde anzeigen“ klickst, wird jeder Cache nur einmal aufgelistet, und versteckte Caches sind ausgeblendet. Daher kann die Zahl in dieser Liste geringer sein als die Gesamtzahl der Funde auf deiner Profilseite.

Bei der Versteckstatistik im dritten Abschnitt zählen die gesperrt/versteckten Caches ebenfalls mit. In deinem öffentlichen Profil und deinem [[Statistikbild]] werden sie dagegen nicht mitgezählt, da andere Benutzer sie nicht sehen können.

== Einstellungen ==
Folgende Einstellungen kannst du in deinem Profil vornehmen bzw. ändern; außer Benutzername und Email-Adresse sind diese alle freiwillig:

* „Profildaten“:
** '''[[Registrierung#Benutzername|Benutzername]]'''
** '''[[Registrierung#Nachname / Vorname|Vor- und Nachname]]'''
** das '''[[Registrierung#Land|Land]]''' in dem du gerade „geocachst“
** die '''[[Koordinaten]]''' deines Standortes
** [[Benachrichtigungen#Benachrichtigung über neue Caches|'''Benachrichtiungsradius''' für neue Caches]]
** '''Emailadresse''': Zum Ändern der Adresse erhältst du an die neue Adresse eine Mail mit einem Sicherheitscode, mit dem du sie aktivieren kannst. Die Adresse wird verwendet, um dir [[Benachrichtigungen]] und [[#Emailversand|Emails]] anderer Benutzer (inklusive von Opencaching-[[Support]]mitarbeitern) zuzustellen.

<div class="widelist">
* „Details“:
** '''Zoomstufe''' für die Mini-Karte, die in den [[Listing|Cachelistings]] angezeigt wird (''von–bis?'')
** '''Statistikdetails''': Dies bewirkt, dass andere Benutzer in deinem Profil zusätzlich eine Fund- und Versteckstatistik nach Cachetypen sehen sowie die Summe deiner Hinweis- und DNF-Logs. Bitte beachte, dass sich solche Statistiken unabhängig von dieser Einstellung auch über die [[Suchformular|Suchfunktion]] oder aus [[XML-Schnittstelle|heruntergeladenen]] Daten erstellen lassen; sie sind also nicht völlig verhinderbar.
** '''Bildstatistik''' und Galerie: Zeigt in deinem Profil die Anzahl deiner hochgeladenen Logbilder an, mit der Möglichkeit, sich eine Galerie aller deiner Logbilder anzusehen.
** '''[[OConly#OConly-81|OConly-81]]'''-Statistik
** '''Wohnort und Alter''': Wird für andere Benutzer angezeigt, falls angegeben
** '''Beschreibungstext''': ein belieber Text, der anderen Benutzern angezeigt wird.
* gewünschtes '''[[Statistikbild]]'''
* '''Passwort''': Änderung erfolgt wie bei der E-Mail-Adresse durch Zusendung eines Sicherheitscodes
* Einstellungen für [[Benachrichtigungen#Beobachten von Caches |'''beobachtete Caches''']]
</div>

== Weitere Funktionen ==
In deinem Profil findest du auch:
* eine Übersicht aller gespeicherten Suchen; siehe [[Suchformular]]
* eine Übersicht aller [[Benachrichtigungen#Beobachtung von Caches|beobachteten Caches]]
* eine Übersicht aller [[Caches ignorieren|ignorierten Caches]]
* eine Übersicht deiner abgegebenen [[Empfehlungen]]
* die Möglichkeit, [[Adoption#Cache adoptioeren|Adoptionsangebote]] anzunehmen

== Emailversand ==
Jeder registrierte Opencaching-Benutzer ist für andere registrierte Benutzer per Email erreichbar; dazu dient der Link „Email senden“ oben rechts im Profil. Wenn du eine Email verschickst kannst du wählen, ob die in deinem Profil hinterlegte Email-Adresse als Absender mitgeschicht wird oder nicht. Ohne Absenderadresse sieht der Empfänger nur deinen Benutzernamen und einen Link auf dein Opencaching-Profil. Dort kann er dir dann per „Email senden“ antworten. Mit Absenderadresse ist die Chance höher, dass du eine Antwort erhältst.

Hin und wieder kommt es vor, dass eine Email in einem Spamordner landet und übersehen wird. Wenn du den Besitzer eines Caches nicht per Mail erreichst, kannst du stattdessen auch ein [[Das Onlinelog#Hinweis|Hinweislog]] bei dem Cache hinterlassen. Vielleicht hast du hier mehr Glück, und die [[Benachrichtigungen|Benachrichtigungsmail]] über deinen Logeintrag kommt an.

== Persönliche Daten löschen ==
Mit Ausnahme der Emailadresse kannst du alle persönlichen Daten selbst aus deinem Profil löschen. Wenn du auch die Emailadresse löschen lassen möchtest, geht dies nur durch eine [[Account deaktivieren|Deaktivierung]] deines Benutzerkontos. Dies lässt sich nicht mehr rückgäng machen, und alle deine eigenen Caches werden dadurch [[Cachestatus|gesperrt]]! Daher überlege dir, ob du stattdessen nicht lieber bei einem der vielen kostenlosen Email-Anbieter eine neue Adresse anlegen möchtest, die du im Profil angeben kannst.

Mehr zum Umgang mit persönlichen Daten findest du in der [http://www.opencaching.de/articles.php?page=dsb Datenschutzbelehrung].

[[Kategorie:Opencaching]]

Suchformular

2013-10-09T16:10:15Z

Dl6hbo:

Das '''[http://www.opencaching.de/search.php Opencaching-Suchformular]''' ermöglicht eine gezielte Auswahl von Caches in einer bestimmten Region und/oder mit bestimmten Eigenschaften. Es handelt sich um die leistungsfähigste Suchfunktion aller [[Geocaching-Plattformen]]. Häufig benötigte Suchen können im [[Benutzerprofil]] gespeichert und wieder abgerufen werden. Die Suchergebnisse können auch als [[GPX-Datei]] heruntergeladen werden, um sie auf ein [[GPS-Gerät]], auf ein [[Smartphone-Apps für Opencaching.de|Smartphone]] oder in ein [[Geocaching-Software#GPX-Dateien einlesen / Cachebeschreibungen verwalten|Cacheverwaltungsprogramm]] zu übertragen.

Um eine neue Suche zu starten, klicke in der Menüleiste von Opencaching.de auf '''Caches'''.

Eine Alternative zum Suchformular ist die Suche via [[Cachekarte]].

== Suchkriterien ==
[[Datei:Suchformular01.png|hochkant=1.5|miniatur|rechts|Auswahl von Cacheeigenschaften]]
Im oberen Teil des Suchformulars findest du verschiedene miteinander kombinierbare Einstellungen, zum Beispiel die gewünschte [[Behältergrößen|Cachegröße]] und [[Cachearten|-art]], die [[Geländewertung|Gelände-]] und [[Schwierigkeitswertung]] etc. Beachte dabei bitte, dass die Schwierigkeit oft schwer abschätzbar ist; viele [[Owner]] geben hier zu niedrige Werte an.

Im unteren Teil musst du dich dann für ''ein'' weiteres Suchkriterium entscheiden, beispielsweise die Suche in einem bestimmten Umkreis oder nach einem bestimmten Cachenamen. Es wird jeweils nur nach dem Kriterium gesucht, bei dem du auf den '''Suchen'''-Button klickst. Wahlweise kannst du auch nach sämtlichen passenden Caches suchen.

Groß- und Kleinschreibung der Suchbegriffe spielt keine Rolle. In den Namens- und Textfeldern können auch Teile angegeben werden, z.B. „Wald“ bei der ''Suche nach Text'', um alle Caches zu finden bei denen „Wald“ im Beschreibungstext vorkommt.

=== [[Attribute]] ===
Bei der Attributauswahl kannst du jeweils mit mehreren Klicks zwischen drei Zuständen wechseln: Egal (grau), vorhanden (blau) oder nicht vorhanden (grau/durchgestrichen). Da die Attribute in den [[Listing]]s teilweise fehlen, wirst du hiermit aber immer nur einen Teil der passenden Caches finden – bzw. bei Negativauswahl (grau/durchgestrichen) auch eine Menge unpassende Caches.

Nur bei Opencaching gelistete Caches findest du mit dem [[OConly]]-Attribut, wobei auch hier bei ungefähr jedem zweiten Cache das Attribut fehlt. Eine annähernd vollständige Übersicht der OConlys bietet die von Hand gewartete [[OConly#Wie finde ich OConlys|OConly-Karte]].

Standardmäßig werden im Suchformular nur die am häufigsten benutzten Attribute angezeigt. Durch einen Klick auf '''Alle anzeigen''' erscheinen auch alle weiteren.

== Ausgabe sortieren nach ... ==

Hier kannst du wählen, in welcher Reihenfolge die Suchergebnisse erscheinen sollen:
* alphabetisch nach Cachename
* nach Entfernung ...
** zu Ortszentrum bzw. den angegebenen Koordinaten bei einer Suche nach Ort, Postleitzahl oder Umkreis
** zu den Heimatkoordinaten in deinem [[Benutzerprofil#Einstellungen|Benutzerprofil]] für alle übrigen Suchen; wenn nicht eingeloggt oder konfiguriert, wird nach Name sortiert
* nach Zeitpunkt des letzten Logs oder deines letzten Logs.

== Suchergebnisse ==
[[Datei:Suchformular02.png|hochkant=1.6|thumb|rechts|Beispiel für Suchergebnisse]]
Nach dem Absenden der Suche wird von links nach rechts angezeigt
* Entfernung zu deinen Heimatkoordinaten, falls bekannt
* [[Cachearten|Cacheart]], [[Schwierigkeitswertung|Schwierigkeits-]] und [[Geländewertung]]
* Cachename und Kurzbeschreibung
* [[OConly]]-Attribut
* Datum des letzten Logs, und Überblick der letzten fünf Logs

=== Herunterladen ===
Mit den beiden Buttons oben rechts kannst du entweder die gerade angezeigten Caches (max. 20) oder ein Paket mit bis zu 500 Caches herunterladen, z. B. um sie auf ein [[GPS-Gerät]] zu übertragen oder in ein [[Geocaching-Software|Cacheverwaltungsprogramm]] einzulesen. Es stehen verschiedene gängige Dateiformate zur Verfügung, insbesondere das häufig verwendete [[Abkürzungen#GPX|GPX-Format]].

Siehe auch: [[Wie erhalte ich eine GPX-Datei?#Umgehen der Größenbegrenzung|Umgehen der Größenbegrenzung]]

=== Kriterien ändern ===
Wenn das Ergebnis nicht passt oder du die Suche weiter einschränken möchtest, kannst du mit dem Link ''Optionen bearbeiten'' oben rechts zurück ins Suchformular wechseln und die Einstellung ändern.

== Gespeicherte Suchen ==
[[Datei:Suche speichern.png|miniatur]]
=== Neue Suche speichern ===
Wenn du häufig nach den gleichen Kriterien suchst, lohnt es sich die Suche zu speichern. Dazu klickst du rechts über den Suchergebnissen auf '''Optionen speichern''' und gibst anschließend einen Namen für die Suche ein. Nach einem Klick auf '''Speichern''' erscheint sie dann bei den [http://www.opencaching.de/query.php gespeicherten Suchen] in deinem [[Benutzerprofil]].

<div style="clear:both"></div>
[[Datei:Suchformular09.png|miniatur|hochkant=2]]
=== Gespeicherte Suche abrufen ===
Gehe auf dein Profil und klicke im linken Menü auf [http://www.opencaching.de/query.php Gespeicherte Suchen]. Klicke auf den Namen der gewünschten Suche, um sie auszuführen – es erscheinen die [[#Suchergebnisse|Suchergebnisse]].

=== Gespeichete Suche ändern ===
Hierzu rufst du deine gespeicherten Suchen im Profil auf und klickst bei der gewünschten Suche auf '''Bearbeiten''' – es erscheint das Suchformular mit den entsprechenden Einstellungen. Um die geänderten Optionen wieder zu speichern, musst du die Suche zunächst ausführen und dann rechts über der Suchergebnisliste auf '''Optionen speichern''' klicken. Dort wählst den Namen der Suche aus und klickst darunter auf '''Speichern'''.

=== Suchergebnisse als [[GPX-Datei]] herunterladen ===
Hierfür gibt es zwei Möglichkeiten:
* Von Hand, indem du im Profil die gespeicherten Suchen aufrufst und dort unter „Download“ auf '''GPX''' klickst;
* automatisch mit dem Tool [[OCDL]].

[[Kategorie:Opencaching]]

[[pl:Wyszukiwanie w bazie skrzynek OpenCaching PL]]

Cachekarte

2013-10-09T15:57:07Z

Dl6hbo: /* Cache anzeigen */

[[Datei:Cachekarte groß.png|300px|thumb|rechts|Kartenausschnitt Heidelberg/Mannheim]]

Die '''[http://www.opencaching.de/map2.php Cachekarte]''' ist neben dem [[Suchformular]] die zweite Möglichkeit, um auf Opencaching nach interessanten Caches zu stöbern. In der Grundeinstellung zeigt sie alle aktiven Caches (Status: [[Cachestatus#Kann_gesucht_werden|kann gesucht werden]]) in Kartenausschnitt an, ausgenommen [[Caches ignorieren|ignorierte Caches]].

== Zielgebiet wählen ==
Der Kartenausschnitt kann durch Klicken und Ziehen mit der Maus oder mit den Pfeiltasten verschoben werden. Rein- und rausgezoomt wird mit dem Mausrad, durch Ziehen am Zoomregler links oben oder mit den Plus/Minus-Tasten. Durch Drücken der Umschalttaste und „Aufziehen“ mit der Maus kann man auch direkt einen bestimmten Ausschnitt vergrößern.

In der Suchleiste über der Karte kannst du einen Ortsnamen eingeben, einen Teil der gesuchten Cachenamen oder – falls bekannt – einen [[Wegpunkte#Wegpunkt eines Listings|OC-Wegpunkt]]. Es erscheint eine Auswahl der passenden Orte und Caches und von dort geht es weiter zum entsprechenden Kartenausschnitt.

[[Datei:Cachekarte Cacheauswahl.png|miniatur|200px]]

== Cache anzeigen ==
Mit einem Klick auf ein Cachesymbol öffnet sich ein kleines Fenster mit den wichtigsten Informationen zum Cache. Von dort gelangst du per Klick auf den Cachenamen weiter zur [[Cachebeschreibung (Listing)|Cachebeschreibung]].

Falls der Cache [[Wegpunkte#Interne, zusätzliche Wegpunkte|zusätzliche Wegpunkte]] besitzt, erscheinen diese gleichzeitig mit den Cacheinfo-Fenster auf der Karte. Sie bleiben auch nach Schließen des Fensters sichtbar, solange kein anderer Cache ausgewählt wird. Auch die Wegpunkte sind anklickbar, um zusätzliche Informationen zu erhalten.

Außerdem wird – falls vorhanden – das [[Bilder#Kartenvorschaubilder| Kartenvorschaubild]] des Caches angezeigt. Für jeden deiner Caches kannst du ein Vorschaubild festlegen, das in der Kartenansicht erscheint.

[[Datei:Cachekarte Attributwahl aufgeklappt.png|miniatur|links|300px]]

== Cacheauswahl einschränken ==
Nach einem Klick auf den Pfeil oben rechts öffnet sich ein Fenster mit Filtereinstellungen. Hier kannst du wählen, welche [[Cachearten]], [[Behältergrößen]], [[Schwierigkeitswertung|Schwierigkeitsgrade]] etc. dich interessieren. Es erscheinen dann nur noch solche Caches auf der Karte, die dieser Auswahl entsprechen. Auch nach Namensbestandteilen wie z. B. „Nacht“ oder „Wald“ kann gefiltert werden.

Tipp: Wenn du das Fenster schließt – dazu genügt ein Klick irgendwo auf die Karte – wird die Auswahl sofort übernommen. Ansonsten dauert es zwei Sekunden, um zu verhindern dass beim Ändern mehrerer Einstellungen jedesmal Daten von Opencaching.de abgerufen werden.

Die Filtereinstellungen bleiben so lange aktiv, bis du sie mit dem „Zurücksetzen“-Knopf verwirfst oder den Webbrowser beendest. Danach erscheinen wieder alle aktiven Caches auf der Karte. Wahlweise kannst du die Einstellungen auch mit dem „Speichern“-Knopf dauerhaft speichern. Dann erscheint nach dem Neustart des Browsers oder nach dem Zurücksetzen wieder die von dir gespeicherte Cacheauswahl.

== Kartenfunktionen ==
Neben dem Suchfeld oberhalb der Karte sind zusätzlich folgende Funktionen abrufbar:

{|
|style="vertical-align:top"|[[Datei:Cachekarte-Haus.png]]
|springt zu deinen Heimatkoordinaten. Dies funktioniert nur, wenn du [[Login|angemeldet]] bist und die Koordinaten in deinem [[Benutzerprofil]] hinterlegt hast.
|-
|style="vertical-align:top"|[[Datei:Cachekarte-GPX.png]]
|lädt die Daten der Caches im aktuellen Kartenausschnitt als Zip-gepackte [[GPX-Datei]] herunter. Dazu dürfen maximal 500 Caches sichtbar sein; verkleinere ggf. den Kartenausschnitt.
|-
|style="vertical-align:top"|[[Datei:Cachekarte-Stern.png]]
|erzeugt einen Link auf den aktuellen Kartenausschnitt, den du z. B. kopieren und bei den Lesezeichen / Favoriten deines Webbrowsers speichern oder per Email verschicken kannst. Bei Firefox und dem Internet Explorer lässt er sich auch direkt in die Lesezeichen übernehmen.
|-
|style="vertical-align:top"|[[Datei:Cachekarte-Einstellungen.png]]
|öffnet ein Fenster, indem du verschiedene Karteneigenschaften festlegen kannst:
* ob der Menüpunkt „Karte“ die Vollbild- oder die kleinere Karte (s.u.) aufruft;
* ob in der rechten unteren Ecke der Karte eine kleine Übersichtskarte erscheinen soll;
* wieviele Caches maximal auf der Karte angezeigt werden; wenn du 0 angibst, sind es maximal 2500 auf der großen und 1600 auf der kleinen Karte, bzw. max. 200 bei Verwendung des Microsoft Internet Explorers;
* ob auf der Karte die üblichen Opencaching.de-Symbole erscheinen sollen, oder die kleineren und moderneren von [http://www.opencaching.pl Opencaching Polen];
* ob und in welcher Größe [[Bilder#Kartenvorschaubilder|Vorschaubilder]] auf der Karte dargestellt werden sollen.
|-
|style="vertical-align:top"|[[Datei:Cachekarte-verkleinern.png]]
|wechselt von der Vollbildkarte zu einer kleineren Darstellung. Dort ist die übliche Menüleiste sichtbar, die Filtereinstellungen befinden sich unterhalb der Karte, und links gibt es eine Direktauswahl der Bundeshauptstädte.
|-
|style="vertical-align:top"|[[Datei:Cachekarte-vergrößern.png]]
|wechselt von der kleinen Karte zurück zur großen.
|}

== Kartenarten ==
In der rechten oberen Ecke der Karte wird das Kartenmaterial gewählt:

;OSM
Die Karte des freien [[OpenStreetMap]]-Projekts. Diese ist oft aktueller als die „kommerziellen“ Karten und enthält zusätzliche Details.

;MapQuest (MQ)
Eine andere Aufbereitung des OpenStreetMap-Materials. Die Karte ist übersichtlicher, durch dezentere Farbwahl und weil sie Details erst bei größerer Zoomstufe anzeigt oder teilweise ganz darauf verzichtet.

;OpenCycleMap (OCM)
Eine Fahrradkarte, die ebenfalls auf OpenStreetMap-Karte basiert und auf ähnliche Weise in einem offenen und freien Projekt zusammengetragen wird.

;Karte
Die Google-Straßenkarte, wahlweise umschaltbar auf Geländeansicht. Die Google-Karten sind sehr genau und enthalten zusätzliche Informationen über interessante Orte.

;Satellit
Die Google-Satellitenkarte, mit zu- oder abschaltbaren Straßen und Beschriftungen.

== Wegpunkte eines einzelnen Caches anzeigen ==
Manchmal sind die zusätzlichen Wegpunkte eines Caches auf einer vollen Karte schwer auszumachen. Hier hilft folgender Trick:

* Rufe das Cachelisting auf,
* klicke rechts unter der kleinen Karte auf „Opencaching.de“,
* öffne die Filtereinstellungen der Karte und schalte alle Caches mit einem Klick auf das Kästchen neben „Cacheart“ ab,
* schließe die Filtereinstellungen und drücke den Neuladen-Knopf deines Browsers.

Nun sind nur noch die Wegpunkte des einen Caches sichtbar.

== Vollbildkarte verlassen ==
Es gibt mehrere Wege, um von der Vollbildkarte „zurück“ ins Menüsystem oder auf andere Seiten zu gelangen:

* Mit einem Klick auf das Opencaching-Logo oben links gelangst du auf die Startseite,
* mit einem Klick auf den Benutzername oben links – falls du angemeldet bist – auf deine Profilseite,
* mit einem Klick auf einen Cachename, nachdem du dessen Info-Fenster geöffnet hast, in die Cachebeschreibung, oder
* mit einem Klick auf das Verkleinern-Symbol in die kleine Kartenansicht, wo alles Weitere über das Menü wählbar ist.

[[Kategorie:Opencaching]]

Cachekarte

2013-10-09T15:55:17Z

Dl6hbo: /* Zielgebiet wählen */

[[Datei:Cachekarte groß.png|300px|thumb|rechts|Kartenausschnitt Heidelberg/Mannheim]]

Die '''[http://www.opencaching.de/map2.php Cachekarte]''' ist neben dem [[Suchformular]] die zweite Möglichkeit, um auf Opencaching nach interessanten Caches zu stöbern. In der Grundeinstellung zeigt sie alle aktiven Caches (Status: [[Cachestatus#Kann_gesucht_werden|kann gesucht werden]]) in Kartenausschnitt an, ausgenommen [[Caches ignorieren|ignorierte Caches]].

== Zielgebiet wählen ==
Der Kartenausschnitt kann durch Klicken und Ziehen mit der Maus oder mit den Pfeiltasten verschoben werden. Rein- und rausgezoomt wird mit dem Mausrad, durch Ziehen am Zoomregler links oben oder mit den Plus/Minus-Tasten. Durch Drücken der Umschalttaste und „Aufziehen“ mit der Maus kann man auch direkt einen bestimmten Ausschnitt vergrößern.

In der Suchleiste über der Karte kannst du einen Ortsnamen eingeben, einen Teil der gesuchten Cachenamen oder – falls bekannt – einen [[Wegpunkte#Wegpunkt eines Listings|OC-Wegpunkt]]. Es erscheint eine Auswahl der passenden Orte und Caches und von dort geht es weiter zum entsprechenden Kartenausschnitt.

[[Datei:Cachekarte Cacheauswahl.png|miniatur|200px]]

== Cache anzeigen ==
Mit einem Klick auf ein Cachesymbol öffnet sich ein kleines Fenster mit den wichtigsten Informationen zum Cache. Von dort gelangst du per Klick auf den Cachename weiter zur [[Cachebeschreibung (Listing)|Cachebeschreibung]].

Falls der Cache [[Wegpunkte#Interne, zusätzliche Wegpunkte|zusätzliche Wegpunkte]] besitzt, erscheinen diese gleichzeitig mit den Cacheinfo-Fenster auf der Karte. Sie bleiben auch nach Schließen des Fensters sichtbar, solange kein anderer Cache ausgewählt wird. Auch die Wegpunkte sind anklickbar, um zusätzliche Informationen zu erhalten.

Außerdem wird – falls vorhanden – das [[Bilder#Kartenvorschaubilder| Kartenvorschaubild]] des Caches angezeigt. Für jeden deiner Caches kannst du ein Vorschaubild festlegen, dass in der Kartenansicht erscheint.

[[Datei:Cachekarte Attributwahl aufgeklappt.png|miniatur|links|300px]]
== Cacheauswahl einschränken ==
Nach einem Klick auf den Pfeil oben rechts öffnet sich ein Fenster mit Filtereinstellungen. Hier kannst du wählen, welche [[Cachearten]], [[Behältergrößen]], [[Schwierigkeitswertung|Schwierigkeitsgrade]] etc. dich interessieren. Es erscheinen dann nur noch solche Caches auf der Karte, die dieser Auswahl entsprechen. Auch nach Namensbestandteilen wie z. B. „Nacht“ oder „Wald“ kann gefiltert werden.

Tipp: Wenn du das Fenster schließt – dazu genügt ein Klick irgendwo auf die Karte – wird die Auswahl sofort übernommen. Ansonsten dauert es zwei Sekunden, um zu verhindern dass beim Ändern mehrerer Einstellungen jedesmal Daten von Opencaching.de abgerufen werden.

Die Filtereinstellungen bleiben so lange aktiv, bis du sie mit dem „Zurücksetzen“-Knopf verwirfst oder den Webbrowser beendest. Danach erscheinen wieder alle aktiven Caches auf der Karte. Wahlweise kannst du die Einstellungen auch mit dem „Speichern“-Knopf dauerhaft speichern. Dann erscheint nach dem Neustart des Browsers oder nach dem Zurücksetzen wieder die von dir gespeicherte Cacheauswahl.

== Kartenfunktionen ==
Neben dem Suchfeld oberhalb der Karte sind zusätzlich folgende Funktionen abrufbar:

{|
|style="vertical-align:top"|[[Datei:Cachekarte-Haus.png]]
|springt zu deinen Heimatkoordinaten. Dies funktioniert nur, wenn du [[Login|angemeldet]] bist und die Koordinaten in deinem [[Benutzerprofil]] hinterlegt hast.
|-
|style="vertical-align:top"|[[Datei:Cachekarte-GPX.png]]
|lädt die Daten der Caches im aktuellen Kartenausschnitt als Zip-gepackte [[GPX-Datei]] herunter. Dazu dürfen maximal 500 Caches sichtbar sein; verkleinere ggf. den Kartenausschnitt.
|-
|style="vertical-align:top"|[[Datei:Cachekarte-Stern.png]]
|erzeugt einen Link auf den aktuellen Kartenausschnitt, den du z. B. kopieren und bei den Lesezeichen / Favoriten deines Webbrowsers speichern oder per Email verschicken kannst. Bei Firefox und dem Internet Explorer lässt er sich auch direkt in die Lesezeichen übernehmen.
|-
|style="vertical-align:top"|[[Datei:Cachekarte-Einstellungen.png]]
|öffnet ein Fenster, indem du verschiedene Karteneigenschaften festlegen kannst:
* ob der Menüpunkt „Karte“ die Vollbild- oder die kleinere Karte (s.u.) aufruft;
* ob in der rechten unteren Ecke der Karte eine kleine Übersichtskarte erscheinen soll;
* wieviele Caches maximal auf der Karte angezeigt werden; wenn du 0 angibst, sind es maximal 2500 auf der großen und 1600 auf der kleinen Karte, bzw. max. 200 bei Verwendung des Microsoft Internet Explorers;
* ob auf der Karte die üblichen Opencaching.de-Symbole erscheinen sollen, oder die kleineren und moderneren von [http://www.opencaching.pl Opencaching Polen];
* ob und in welcher Größe [[Bilder#Kartenvorschaubilder|Vorschaubilder]] auf der Karte dargestellt werden sollen.
|-
|style="vertical-align:top"|[[Datei:Cachekarte-verkleinern.png]]
|wechselt von der Vollbildkarte zu einer kleineren Darstellung. Dort ist die übliche Menüleiste sichtbar, die Filtereinstellungen befinden sich unterhalb der Karte, und links gibt es eine Direktauswahl der Bundeshauptstädte.
|-
|style="vertical-align:top"|[[Datei:Cachekarte-vergrößern.png]]
|wechselt von der kleinen Karte zurück zur großen.
|}

== Kartenarten ==
In der rechten oberen Ecke der Karte wird das Kartenmaterial gewählt:

;OSM
Die Karte des freien [[OpenStreetMap]]-Projekts. Diese ist oft aktueller als die „kommerziellen“ Karten und enthält zusätzliche Details.

;MapQuest (MQ)
Eine andere Aufbereitung des OpenStreetMap-Materials. Die Karte ist übersichtlicher, durch dezentere Farbwahl und weil sie Details erst bei größerer Zoomstufe anzeigt oder teilweise ganz darauf verzichtet.

;OpenCycleMap (OCM)
Eine Fahrradkarte, die ebenfalls auf OpenStreetMap-Karte basiert und auf ähnliche Weise in einem offenen und freien Projekt zusammengetragen wird.

;Karte
Die Google-Straßenkarte, wahlweise umschaltbar auf Geländeansicht. Die Google-Karten sind sehr genau und enthalten zusätzliche Informationen über interessante Orte.

;Satellit
Die Google-Satellitenkarte, mit zu- oder abschaltbaren Straßen und Beschriftungen.

== Wegpunkte eines einzelnen Caches anzeigen ==
Manchmal sind die zusätzlichen Wegpunkte eines Caches auf einer vollen Karte schwer auszumachen. Hier hilft folgender Trick:

* Rufe das Cachelisting auf,
* klicke rechts unter der kleinen Karte auf „Opencaching.de“,
* öffne die Filtereinstellungen der Karte und schalte alle Caches mit einem Klick auf das Kästchen neben „Cacheart“ ab,
* schließe die Filtereinstellungen und drücke den Neuladen-Knopf deines Browsers.

Nun sind nur noch die Wegpunkte des einen Caches sichtbar.

== Vollbildkarte verlassen ==
Es gibt mehrere Wege, um von der Vollbildkarte „zurück“ ins Menüsystem oder auf andere Seiten zu gelangen:

* Mit einem Klick auf das Opencaching-Logo oben links gelangst du auf die Startseite,
* mit einem Klick auf den Benutzername oben links – falls du angemeldet bist – auf deine Profilseite,
* mit einem Klick auf einen Cachename, nachdem du dessen Info-Fenster geöffnet hast, in die Cachebeschreibung, oder
* mit einem Klick auf das Verkleinern-Symbol in die kleine Kartenansicht, wo alles Weitere über das Menü wählbar ist.

[[Kategorie:Opencaching]]

Cachestatus

2013-10-09T15:45:48Z

Dl6hbo: /* Gesperrt/ Sperrlog */

[[Datei:Statusänderungen per Log.png|thumb|300px|right|Ändern des Cachestatus]]
Der Status eines Geocaches gibt hauptsächlich an, ob der Cache momentan gesucht/gefunden werden kann, oder ob Probleme vorliegen, die ein Suchen verhindern.

Seit der [http://www.opencaching.de/articles.php?page=changelog#v3.0.8 Opencaching-Version 8] sind Statusänderungen an ein [[Das Onlinelog|Log]] gebunden, wie es auf anderen Plattformen schon länger üblich war. Dadurch verpassen Beobachter zum einen keine einzige Statusänderung mehr, zum anderen ist auch für Nicht-Beobachter klar erkennbar, wann ein Cache suchbar oder nicht suchbar war. Ein Geocache bei Opencaching.de kann folgende Stati annehmen, die vom [[Besitzer]] oder einem Mitglied des [[Support|Support-Teams]] gesetzt werden können:

==== Noch nicht veröffentlicht ====
Diesen Status erhält ein neues Opencaching-[[Listing]], wenn du zunächst „[[Erstellen einer Cachebeschreibung/ Listing#Veröffentlichung|Noch nicht veröffentlichen]]“ gewählt hast. Es bleibt für andere Benutzer unsichtbar, bis du es zur Veröffentlichung freigibst.

Damit man keinen Cache versehentlich veröffentlicht, geschieht die Freigabe nicht per Log, sondern man bearbeitet das Cachlisting und ändert zwei Einträge:
* Status = „kann gesucht werden“
* Veröffentlichung = „sofort veröffentlichen“

==== Kann gesucht werden/ Wartungslog ====
[[Datei:Wartungslog 2.png|thumb|300px|right|Wartungslog im Logzähler]]
[[Datei:Wartungslog.png|thumb|300px|left|Wartungslog schreiben]]
Das ist der Normalzustand eines Caches. Die Bedeutung ist klar: Mit dem Geocache ist alles in Ordnung; die Dose kann gefunden werden.

Beim Loggen hat dieser Status noch eine weitere Bedeutung: Er fungiert auch als „Wartungsinfo“ für andere User. Wird im Zustand „Kann gesucht werden“ erneut ein „Kann-gesucht-werden“-Log geschrieben, so signalisiert dies den Suchenden, dass der Cache kontrolliert wurde und dass alles OK ist. Dieser Logtyp kann vom Owner beliebig oft verwendet werden um immer wieder deutlich zu machen, dass der Cache gewartet worden ist und wirklich vorhanden ist.

Das Wartungslog wird ebenfalls benötigt, um ein nicht verfügbares Listing wieder frei zu geben. Es reicht '''nicht''', aus den Statuslog „Nicht verfügbar“ zu entfernen.

Wurde ein Wartungslog geschrieben, erschein dieses in der Logstatistik oben rechts im Listig. Wird ein Listing durch ein „Kann-gesucht-werden“-Log wieder freigegeben, wird dies oben ebenfalls als Wartung aufgeführt.

Das neue Loglabel seht ihr hier:

[[Datei:Wartungslog 3.png|Logtyp Wartung durchgeführt]]

==== Momentan nicht verfügbar/ Deaktivierungslog====
Dieser Zustand wird vom [[Besitzer]] gesetzt, wenn mit dem Cache etwas nicht in Ordnung ist und die Dose nicht gefunden werden kann. Die Gründe dafür können vielfältig sein: die Dose ist verschwunden, das [[Logbuch]] ist nass und muss erst getauscht werden, der Ort des Cacheverstecks kann wegen einer Baustelle momentan nicht betreten werden, usw.
Der Owner ist anschließend dafür verantwortlich, den Geocache wieder suchbar zu machen (z.B. durch Auslegen einer neuen Dose) und den Status durch ein „Kann-gesucht-werden“-Log wieder auf '''kann gesucht werden''' zu setzen. Ist ein Instandsetzen des Caches nicht möglich, sollte der Cache per Archivierungslog '''archiviert''' werden.

Auch dieser Status kann mehrfach geloggt werden. Dies kann Sinn machen, wenn z.B. ein Cache wegen Waldarbeiten nicht verfügbar ist. So kann dann deutlich gemacht werden: ich habe die Lage im Auge, aber die Arbeiten dauern noch an.

Und so sieht dann das fertige Log aus:

[[Datei:Nicht verfügbar Log.png|Logtyp Nicht verfügbar]]

Außerdem erscheint ein rotes Banner mit dem Hinweis „Dieser Geocache ist nicht verfügbar...“ ganz oben im Listing.

==== Archiviert/ Archivierungslog ====
Dieser Status zeigt an, dass der Cache definitiv nicht mehr gefunden werden kann. Archivierte Caches werden standardmäßig nicht auf der [[Cachekarte]] von Opencaching.de angezeigt. Archiviert ein [[Besitzer]] seinen Geocache, ist es wichtig, dass die ausgelegten Dosen (Finaldose und möglicherweise Dosen von [[Stage|Stationen]]) wieder eingesammelt werden. Ansonsten entsteht [[Geomüll]].

Zur Archivierung wird dann das Archivierungslog geschrieben. Es sieht im Listing so aus:

[[Datei:Archivierung.png|Archivierungslog]]

Außerdem erscheint ein rotes Banner mit dem Hinweis „Dieser Geocache ist archiviert....“ ganz oben im Listing.

==== Gesperrt/ Sperrlog ====
Ein '''gesperrter''' Cache entspricht einem '''archivierten''', mit dem Unterschied, dass im Listing keine Logeinträge mehr möglich sind. Außerdem ist der Cache nicht mehr auf der [[Cachekarte|Karte]] anzeigbar und kann nicht per [[API-Clients#OKAPI-Clients|OKAPI]] abgerufen werden.

Das Sperren eines Listings kann z.B. dann sinnvoll sein, wenn es in den [[Das Onlinelog|Onlinelogs]] zu beleidigenden Diskussionen kommt oder der Owner bei einem Lost Place o.ä. ausdrücklich nicht mehr möchte, dass sich noch Sucher an den Ort begeben und vor allem den Cache hinterher noch loggen. Besonders hier sollte der Logeintrag ausführlich ausfallen um die Gründe dessen deutlich zu machen.
Der fertige Logeintrag sieht dann so aus:

[[Datei:Sperrung.png|Sperrungslog]]

Außerdem erscheint ein Schloßsymbol mit dem Hinweis „Dieser Geocache ist gesperrt....“ ganz oben im Listing.
/* Schloßsymbol war: rotes Banner */

==== Gesperrt + Versteckt ====
Das Listing eines gesperrten und versteckten Caches kann nur vom Owner und vom [[Support|Support-Team]] eingesehen werden. Der Cache ist daher auch nicht auf der [[Cachekarte]] sichtbar. Dieser Status kann nur durch das Support-Team gesetzt und wieder zurückgenommen werden.
Der Status wird nur in Ausnahmefällen verwendet, beispielsweise wenn durch das Listing rechtliche Verstöße wie strafrechtlich relevante Texte/Textpassagen oder [[Urheberrecht|Urheberrechtsverstöße]] vorliegen.

[[Kategorie:Opencaching]]
[[Kategorie:Listings und Logs]]

[[pl:Status skrzynki]]

Cachestatus

2013-10-09T15:44:11Z

Dl6hbo: /* Gesperrt/ Sperrlog */

[[Datei:Statusänderungen per Log.png|thumb|300px|right|Ändern des Cachestatus]]
Der Status eines Geocaches gibt hauptsächlich an, ob der Cache momentan gesucht/gefunden werden kann, oder ob Probleme vorliegen, die ein Suchen verhindern.

Seit der [http://www.opencaching.de/articles.php?page=changelog#v3.0.8 Opencaching-Version 8] sind Statusänderungen an ein [[Das Onlinelog|Log]] gebunden, wie es auf anderen Plattformen schon länger üblich war. Dadurch verpassen Beobachter zum einen keine einzige Statusänderung mehr, zum anderen ist auch für Nicht-Beobachter klar erkennbar, wann ein Cache suchbar oder nicht suchbar war. Ein Geocache bei Opencaching.de kann folgende Stati annehmen, die vom [[Besitzer]] oder einem Mitglied des [[Support|Support-Teams]] gesetzt werden können:

==== Noch nicht veröffentlicht ====
Diesen Status erhält ein neues Opencaching-[[Listing]], wenn du zunächst „[[Erstellen einer Cachebeschreibung/ Listing#Veröffentlichung|Noch nicht veröffentlichen]]“ gewählt hast. Es bleibt für andere Benutzer unsichtbar, bis du es zur Veröffentlichung freigibst.

Damit man keinen Cache versehentlich veröffentlicht, geschieht die Freigabe nicht per Log, sondern man bearbeitet das Cachlisting und ändert zwei Einträge:
* Status = „kann gesucht werden“
* Veröffentlichung = „sofort veröffentlichen“

==== Kann gesucht werden/ Wartungslog ====
[[Datei:Wartungslog 2.png|thumb|300px|right|Wartungslog im Logzähler]]
[[Datei:Wartungslog.png|thumb|300px|left|Wartungslog schreiben]]
Das ist der Normalzustand eines Caches. Die Bedeutung ist klar: Mit dem Geocache ist alles in Ordnung; die Dose kann gefunden werden.

Beim Loggen hat dieser Status noch eine weitere Bedeutung: Er fungiert auch als „Wartungsinfo“ für andere User. Wird im Zustand „Kann gesucht werden“ erneut ein „Kann-gesucht-werden“-Log geschrieben, so signalisiert dies den Suchenden, dass der Cache kontrolliert wurde und dass alles OK ist. Dieser Logtyp kann vom Owner beliebig oft verwendet werden um immer wieder deutlich zu machen, dass der Cache gewartet worden ist und wirklich vorhanden ist.

Das Wartungslog wird ebenfalls benötigt, um ein nicht verfügbares Listing wieder frei zu geben. Es reicht '''nicht''', aus den Statuslog „Nicht verfügbar“ zu entfernen.

Wurde ein Wartungslog geschrieben, erschein dieses in der Logstatistik oben rechts im Listig. Wird ein Listing durch ein „Kann-gesucht-werden“-Log wieder freigegeben, wird dies oben ebenfalls als Wartung aufgeführt.

Das neue Loglabel seht ihr hier:

[[Datei:Wartungslog 3.png|Logtyp Wartung durchgeführt]]

==== Momentan nicht verfügbar/ Deaktivierungslog====
Dieser Zustand wird vom [[Besitzer]] gesetzt, wenn mit dem Cache etwas nicht in Ordnung ist und die Dose nicht gefunden werden kann. Die Gründe dafür können vielfältig sein: die Dose ist verschwunden, das [[Logbuch]] ist nass und muss erst getauscht werden, der Ort des Cacheverstecks kann wegen einer Baustelle momentan nicht betreten werden, usw.
Der Owner ist anschließend dafür verantwortlich, den Geocache wieder suchbar zu machen (z.B. durch Auslegen einer neuen Dose) und den Status durch ein „Kann-gesucht-werden“-Log wieder auf '''kann gesucht werden''' zu setzen. Ist ein Instandsetzen des Caches nicht möglich, sollte der Cache per Archivierungslog '''archiviert''' werden.

Auch dieser Status kann mehrfach geloggt werden. Dies kann Sinn machen, wenn z.B. ein Cache wegen Waldarbeiten nicht verfügbar ist. So kann dann deutlich gemacht werden: ich habe die Lage im Auge, aber die Arbeiten dauern noch an.

Und so sieht dann das fertige Log aus:

[[Datei:Nicht verfügbar Log.png|Logtyp Nicht verfügbar]]

Außerdem erscheint ein rotes Banner mit dem Hinweis „Dieser Geocache ist nicht verfügbar...“ ganz oben im Listing.

==== Archiviert/ Archivierungslog ====
Dieser Status zeigt an, dass der Cache definitiv nicht mehr gefunden werden kann. Archivierte Caches werden standardmäßig nicht auf der [[Cachekarte]] von Opencaching.de angezeigt. Archiviert ein [[Besitzer]] seinen Geocache, ist es wichtig, dass die ausgelegten Dosen (Finaldose und möglicherweise Dosen von [[Stage|Stationen]]) wieder eingesammelt werden. Ansonsten entsteht [[Geomüll]].

Zur Archivierung wird dann das Archivierungslog geschrieben. Es sieht im Listing so aus:

[[Datei:Archivierung.png|Archivierungslog]]

Außerdem erscheint ein rotes Banner mit dem Hinweis „Dieser Geocache ist archiviert....“ ganz oben im Listing.

==== Gesperrt/ Sperrlog ====
Ein '''gesperrter''' Cache entspricht einem '''archivierten''', mit dem Unterschied, dass im Listing keine Logeinträge mehr möglich sind. Außerdem ist der Cache nicht mehr auf der [[Cachekarte|Karte]] anzeigbar und kann nicht per [[API-Clients#OKAPI-Clients|OKAPI]] abgerufen werden.

Das Sperren eines Listings kann z.B. dann sinnvoll sein, wenn es in den [[Das Onlinelog|Onlinelogs]] zu beleidigenden Diskussionen kommt oder der Owner bei einem Lost Place o.ä. ausdrücklich nicht mehr möchte, dass sich noch Sucher an den Ort begeben und vor allem den Cache hinterher noch loggen. Besonders hier sollte der Logeintrag ausführlich ausfallen um die Gründe dessen deutlich zu machen.
Der fertige Logeintrag sieht dann so aus:

[[Datei:Sperrung.png|Sperrungslog]]

Außerdem erscheint ein Schloßsymbol mit dem Hinweis „Dieser Geocache ist gesperrt....“ ganz oben im Listing.
/* rotes Banner */

==== Gesperrt + Versteckt ====
Das Listing eines gesperrten und versteckten Caches kann nur vom Owner und vom [[Support|Support-Team]] eingesehen werden. Der Cache ist daher auch nicht auf der [[Cachekarte]] sichtbar. Dieser Status kann nur durch das Support-Team gesetzt und wieder zurückgenommen werden.
Der Status wird nur in Ausnahmefällen verwendet, beispielsweise wenn durch das Listing rechtliche Verstöße wie strafrechtlich relevante Texte/Textpassagen oder [[Urheberrecht|Urheberrechtsverstöße]] vorliegen.

[[Kategorie:Opencaching]]
[[Kategorie:Listings und Logs]]

[[pl:Status skrzynki]]

Cachestatus

2013-10-09T15:42:28Z

Dl6hbo: /* Gesperrt/ Sperrlog */

[[Datei:Statusänderungen per Log.png|thumb|300px|right|Ändern des Cachestatus]]
Der Status eines Geocaches gibt hauptsächlich an, ob der Cache momentan gesucht/gefunden werden kann, oder ob Probleme vorliegen, die ein Suchen verhindern.

Seit der [http://www.opencaching.de/articles.php?page=changelog#v3.0.8 Opencaching-Version 8] sind Statusänderungen an ein [[Das Onlinelog|Log]] gebunden, wie es auf anderen Plattformen schon länger üblich war. Dadurch verpassen Beobachter zum einen keine einzige Statusänderung mehr, zum anderen ist auch für Nicht-Beobachter klar erkennbar, wann ein Cache suchbar oder nicht suchbar war. Ein Geocache bei Opencaching.de kann folgende Stati annehmen, die vom [[Besitzer]] oder einem Mitglied des [[Support|Support-Teams]] gesetzt werden können:

==== Noch nicht veröffentlicht ====
Diesen Status erhält ein neues Opencaching-[[Listing]], wenn du zunächst „[[Erstellen einer Cachebeschreibung/ Listing#Veröffentlichung|Noch nicht veröffentlichen]]“ gewählt hast. Es bleibt für andere Benutzer unsichtbar, bis du es zur Veröffentlichung freigibst.

Damit man keinen Cache versehentlich veröffentlicht, geschieht die Freigabe nicht per Log, sondern man bearbeitet das Cachlisting und ändert zwei Einträge:
* Status = „kann gesucht werden“
* Veröffentlichung = „sofort veröffentlichen“

==== Kann gesucht werden/ Wartungslog ====
[[Datei:Wartungslog 2.png|thumb|300px|right|Wartungslog im Logzähler]]
[[Datei:Wartungslog.png|thumb|300px|left|Wartungslog schreiben]]
Das ist der Normalzustand eines Caches. Die Bedeutung ist klar: Mit dem Geocache ist alles in Ordnung; die Dose kann gefunden werden.

Beim Loggen hat dieser Status noch eine weitere Bedeutung: Er fungiert auch als „Wartungsinfo“ für andere User. Wird im Zustand „Kann gesucht werden“ erneut ein „Kann-gesucht-werden“-Log geschrieben, so signalisiert dies den Suchenden, dass der Cache kontrolliert wurde und dass alles OK ist. Dieser Logtyp kann vom Owner beliebig oft verwendet werden um immer wieder deutlich zu machen, dass der Cache gewartet worden ist und wirklich vorhanden ist.

Das Wartungslog wird ebenfalls benötigt, um ein nicht verfügbares Listing wieder frei zu geben. Es reicht '''nicht''', aus den Statuslog „Nicht verfügbar“ zu entfernen.

Wurde ein Wartungslog geschrieben, erschein dieses in der Logstatistik oben rechts im Listig. Wird ein Listing durch ein „Kann-gesucht-werden“-Log wieder freigegeben, wird dies oben ebenfalls als Wartung aufgeführt.

Das neue Loglabel seht ihr hier:

[[Datei:Wartungslog 3.png|Logtyp Wartung durchgeführt]]

==== Momentan nicht verfügbar/ Deaktivierungslog====
Dieser Zustand wird vom [[Besitzer]] gesetzt, wenn mit dem Cache etwas nicht in Ordnung ist und die Dose nicht gefunden werden kann. Die Gründe dafür können vielfältig sein: die Dose ist verschwunden, das [[Logbuch]] ist nass und muss erst getauscht werden, der Ort des Cacheverstecks kann wegen einer Baustelle momentan nicht betreten werden, usw.
Der Owner ist anschließend dafür verantwortlich, den Geocache wieder suchbar zu machen (z.B. durch Auslegen einer neuen Dose) und den Status durch ein „Kann-gesucht-werden“-Log wieder auf '''kann gesucht werden''' zu setzen. Ist ein Instandsetzen des Caches nicht möglich, sollte der Cache per Archivierungslog '''archiviert''' werden.

Auch dieser Status kann mehrfach geloggt werden. Dies kann Sinn machen, wenn z.B. ein Cache wegen Waldarbeiten nicht verfügbar ist. So kann dann deutlich gemacht werden: ich habe die Lage im Auge, aber die Arbeiten dauern noch an.

Und so sieht dann das fertige Log aus:

[[Datei:Nicht verfügbar Log.png|Logtyp Nicht verfügbar]]

Außerdem erscheint ein rotes Banner mit dem Hinweis „Dieser Geocache ist nicht verfügbar...“ ganz oben im Listing.

==== Archiviert/ Archivierungslog ====
Dieser Status zeigt an, dass der Cache definitiv nicht mehr gefunden werden kann. Archivierte Caches werden standardmäßig nicht auf der [[Cachekarte]] von Opencaching.de angezeigt. Archiviert ein [[Besitzer]] seinen Geocache, ist es wichtig, dass die ausgelegten Dosen (Finaldose und möglicherweise Dosen von [[Stage|Stationen]]) wieder eingesammelt werden. Ansonsten entsteht [[Geomüll]].

Zur Archivierung wird dann das Archivierungslog geschrieben. Es sieht im Listing so aus:

[[Datei:Archivierung.png|Archivierungslog]]

Außerdem erscheint ein rotes Banner mit dem Hinweis „Dieser Geocache ist archiviert....“ ganz oben im Listing.

==== Gesperrt/ Sperrlog ====
Ein '''gesperrter''' Cache entspricht einem '''archivierten''', mit dem Unterschied, dass im Listing keine Logeinträge mehr möglich sind. Außerdem ist der Cache nicht mehr auf der [[Cachekarte|Karte]] anzeigbar und kann nicht per [[API-Clients#OKAPI-Clients|OKAPI]] abgerufen werden.

Das Sperren eines Listings kann z.B. dann sinnvoll sein, wenn es in den [[Das Onlinelog|Onlinelogs]] zu beleidigenden Diskussionen kommt oder der Owner bei einem Lost Place o.ä. ausdrücklich nicht mehr möchte, dass sich noch Sucher an den Ort begeben und vor allem den Cache hinterher noch loggen. Besonders hier sollte der Logeintrag ausführlich ausfallen um die Gründe dessen deutlich zu machen.
Der fertige Logeintrag sieht dann so aus:

[[Datei:Sperrung.png|Sperrungslog]]

Außerdem erscheint ein rotes Banner mit dem Hinweis „Dieser Geocache ist gesperrt....“ ganz oben im Listing.

==== Gesperrt + Versteckt ====
Das Listing eines gesperrten und versteckten Caches kann nur vom Owner und vom [[Support|Support-Team]] eingesehen werden. Der Cache ist daher auch nicht auf der [[Cachekarte]] sichtbar. Dieser Status kann nur durch das Support-Team gesetzt und wieder zurückgenommen werden.
Der Status wird nur in Ausnahmefällen verwendet, beispielsweise wenn durch das Listing rechtliche Verstöße wie strafrechtlich relevante Texte/Textpassagen oder [[Urheberrecht|Urheberrechtsverstöße]] vorliegen.

[[Kategorie:Opencaching]]
[[Kategorie:Listings und Logs]]

[[pl:Status skrzynki]]

Cachestatus

2013-10-09T15:40:20Z

Dl6hbo: /* Archiviert/ Archivierungslog */

[[Datei:Statusänderungen per Log.png|thumb|300px|right|Ändern des Cachestatus]]
Der Status eines Geocaches gibt hauptsächlich an, ob der Cache momentan gesucht/gefunden werden kann, oder ob Probleme vorliegen, die ein Suchen verhindern.

Seit der [http://www.opencaching.de/articles.php?page=changelog#v3.0.8 Opencaching-Version 8] sind Statusänderungen an ein [[Das Onlinelog|Log]] gebunden, wie es auf anderen Plattformen schon länger üblich war. Dadurch verpassen Beobachter zum einen keine einzige Statusänderung mehr, zum anderen ist auch für Nicht-Beobachter klar erkennbar, wann ein Cache suchbar oder nicht suchbar war. Ein Geocache bei Opencaching.de kann folgende Stati annehmen, die vom [[Besitzer]] oder einem Mitglied des [[Support|Support-Teams]] gesetzt werden können:

==== Noch nicht veröffentlicht ====
Diesen Status erhält ein neues Opencaching-[[Listing]], wenn du zunächst „[[Erstellen einer Cachebeschreibung/ Listing#Veröffentlichung|Noch nicht veröffentlichen]]“ gewählt hast. Es bleibt für andere Benutzer unsichtbar, bis du es zur Veröffentlichung freigibst.

Damit man keinen Cache versehentlich veröffentlicht, geschieht die Freigabe nicht per Log, sondern man bearbeitet das Cachlisting und ändert zwei Einträge:
* Status = „kann gesucht werden“
* Veröffentlichung = „sofort veröffentlichen“

==== Kann gesucht werden/ Wartungslog ====
[[Datei:Wartungslog 2.png|thumb|300px|right|Wartungslog im Logzähler]]
[[Datei:Wartungslog.png|thumb|300px|left|Wartungslog schreiben]]
Das ist der Normalzustand eines Caches. Die Bedeutung ist klar: Mit dem Geocache ist alles in Ordnung; die Dose kann gefunden werden.

Beim Loggen hat dieser Status noch eine weitere Bedeutung: Er fungiert auch als „Wartungsinfo“ für andere User. Wird im Zustand „Kann gesucht werden“ erneut ein „Kann-gesucht-werden“-Log geschrieben, so signalisiert dies den Suchenden, dass der Cache kontrolliert wurde und dass alles OK ist. Dieser Logtyp kann vom Owner beliebig oft verwendet werden um immer wieder deutlich zu machen, dass der Cache gewartet worden ist und wirklich vorhanden ist.

Das Wartungslog wird ebenfalls benötigt, um ein nicht verfügbares Listing wieder frei zu geben. Es reicht '''nicht''', aus den Statuslog „Nicht verfügbar“ zu entfernen.

Wurde ein Wartungslog geschrieben, erschein dieses in der Logstatistik oben rechts im Listig. Wird ein Listing durch ein „Kann-gesucht-werden“-Log wieder freigegeben, wird dies oben ebenfalls als Wartung aufgeführt.

Das neue Loglabel seht ihr hier:

[[Datei:Wartungslog 3.png|Logtyp Wartung durchgeführt]]

==== Momentan nicht verfügbar/ Deaktivierungslog====
Dieser Zustand wird vom [[Besitzer]] gesetzt, wenn mit dem Cache etwas nicht in Ordnung ist und die Dose nicht gefunden werden kann. Die Gründe dafür können vielfältig sein: die Dose ist verschwunden, das [[Logbuch]] ist nass und muss erst getauscht werden, der Ort des Cacheverstecks kann wegen einer Baustelle momentan nicht betreten werden, usw.
Der Owner ist anschließend dafür verantwortlich, den Geocache wieder suchbar zu machen (z.B. durch Auslegen einer neuen Dose) und den Status durch ein „Kann-gesucht-werden“-Log wieder auf '''kann gesucht werden''' zu setzen. Ist ein Instandsetzen des Caches nicht möglich, sollte der Cache per Archivierungslog '''archiviert''' werden.

Auch dieser Status kann mehrfach geloggt werden. Dies kann Sinn machen, wenn z.B. ein Cache wegen Waldarbeiten nicht verfügbar ist. So kann dann deutlich gemacht werden: ich habe die Lage im Auge, aber die Arbeiten dauern noch an.

Und so sieht dann das fertige Log aus:

[[Datei:Nicht verfügbar Log.png|Logtyp Nicht verfügbar]]

Außerdem erscheint ein rotes Banner mit dem Hinweis „Dieser Geocache ist nicht verfügbar...“ ganz oben im Listing.

==== Archiviert/ Archivierungslog ====
Dieser Status zeigt an, dass der Cache definitiv nicht mehr gefunden werden kann. Archivierte Caches werden standardmäßig nicht auf der [[Cachekarte]] von Opencaching.de angezeigt. Archiviert ein [[Besitzer]] seinen Geocache, ist es wichtig, dass die ausgelegten Dosen (Finaldose und möglicherweise Dosen von [[Stage|Stationen]]) wieder eingesammelt werden. Ansonsten entsteht [[Geomüll]].

Zur Archivierung wird dann das Archivierungslog geschrieben. Es sieht im Listing so aus:

[[Datei:Archivierung.png|Archivierungslog]]

Außerdem erscheint ein rotes Banner mit dem Hinweis „Dieser Geocache ist archiviert....“ ganz oben im Listing.

==== Gesperrt/ Sperrlog ====
Ein '''gesperrter''' Cache entspricht einem '''archivierten''', mit dem Unterschied, dass im Listing keine Logeinträge mehr möglich sind. Außerdem ist der Cache nicht mehr auf der [[Cachekarte|Karte]] anzeigbar und kann nicht per [[API-Clients#OKAPI-Clients|OKAPI]] abgerufen werden.

Das Sperren eines Listings kann z.B. dann sinnvoll sein, wenn es in den [[Das Onlinelog|Onlinelogs]] zu beleidigenden Diskussionen kommt oder der Owner bei einem Lost Place o.ä. ausdrücklich nicht mehr möchte, dass sich noch Sucher an den Ort begeben und vor allem dem Cache hinterher noch loggen. Besonders hier sollte der Log ausführlich ausfallen um die Gründe dessen deutlich zu machen.
Der fertige Log sieht dann so aus:

[[Datei:Sperrung.png|Sperrungslog]]

Außerdem erscheint ein rotes Banner mit dem Hinweis „Dieser Geocache ist gesperrt....“ ganz oben im Listing.

==== Gesperrt + Versteckt ====
Das Listing eines gesperrten und versteckten Caches kann nur vom Owner und vom [[Support|Support-Team]] eingesehen werden. Der Cache ist daher auch nicht auf der [[Cachekarte]] sichtbar. Dieser Status kann nur durch das Support-Team gesetzt und wieder zurückgenommen werden.
Der Status wird nur in Ausnahmefällen verwendet, beispielsweise wenn durch das Listing rechtliche Verstöße wie strafrechtlich relevante Texte/Textpassagen oder [[Urheberrecht|Urheberrechtsverstöße]] vorliegen.

[[Kategorie:Opencaching]]
[[Kategorie:Listings und Logs]]

[[pl:Status skrzynki]]

Spoiler

2013-10-09T15:28:55Z

Dl6hbo: /* Spoiler in Cachebeschreibungen */

[[Datei:Spoiler.jpg|200px|thumb|right|Ein Spoilerbild von Opencaching.de]]
== Spoiler in Cachebeschreibungen ==
Spoiler sind Bilder, welche die Suche nach einem Cache erleichtern und [[Naturschutz|Natur und Umwelt schonen]].

Viele Eigentümer von Geocaches verwenden Spoiler, um den Suchradius (beispielsweise bei schlechtem Empfang) am Cache einzugrenzen. Dadurch haben die Cacher, die diesen Cache suchen, die Möglichkeit, sich schneller zu orientieren und dadurch die Natur zu schonen.

Spoilerbilder zeigen oft nicht direkt auf den Cache, sondern auf einen markanten Punkt in der Nähe, um nicht das eigentliche Versteck zu offenbaren, sondern nur als Unterstützung bei der Suche behilflich zu sein. Eine andere Variante ist, das Versteck aus einer ungewohnten Perspektive etc. zu fotografieren.

[[Datei:Spoiler Vorschau.png|200px|thumb|links|Das Vorschausymbol auf Opencaching.de]]
Die Spoilerbilder auf Opencaching.de werden in der Regel nicht als Vorschau angezeigt, sondern erst nach einem Klick auf das Platzhalter-Bild. Dazu müssen sie beim [[Erstellen einer Cachebeschreibung/ Listing#Bilder hinzufügen|Hochladen]] als Spoiler gekennzeichnet worden sein.

== Spoiler in Logs ==
In [[Das Onlinelog|Logeinträgen]] sollten normalerweise keine Spoilerbilder hochgeladen werden. Wenn es im Ausnahmefall doch einmal sinnvoll erscheint, z.B. um Probleme mit dem Versteck zu dokumentieren, aktiviere beim Hochladen bitte das Spoiler-Kästchen. Die Bilder erhalten dann den Zusatz „(Spoiler)“ und erscheinen nicht in öffentlichen [[Logbild-Galerien]].

Falls dir ungekennzeichnete Spoiler in Logs auffallen, informiere bitte den Logger per Email, damit er die Markierung nachtragen kann.

[[Kategorie:Listings und Logs]]
[[Kategorie:Opencaching]]

Attribute

2013-10-09T15:24:43Z

Dl6hbo:

Mit '''Attributen''' lassen sich genauere Angaben zum [[Listing|Cachelisting]] machen, welche auch als Suchkriterium verwendet werden können. Bei vielen Attributen handelt es sich um Erfahrungswerte (z. B. die Zeckengefahr).

Als Finder eines Geocaches kann man den Eigentümer darauf hinweisen, dass dem Cache entsprechende Attribute zugeordnet werden können. Bei den Angaben für eigene Caches solltest du von gewöhnlichen, trockenen Witterungsverhältnissen ausgehen.

== Vorteile ==
Attribute vereinfachen die Online-Suche nach Geocaches. Im [[Suchformular]] und bei der [[Cachekarte|Kartendarstellung]] kann man auswählen, welche „Eigenschaften“ die gesuchten Caches haben sollen.

Mit Attributen kann man sich auch optimal auf die bevorstehende Cachesuche vorbereiten. Welche Gefahren erwarten mich? Wie ist der Weg? Wie sieht es mit der Infrastruktur aus? Ist am Cache bzw. auf dem Weg etwas Besonderes? Benötige ich besondere Hilfsmittel? Welche Einschränkungen sind zu beachten? Ist dieser Cache für alle Personengruppen (Kinder, Erwachsene etc.) geeignet?

Durch die Vergabe der passenden Attribute wird das Geocachen gleich noch interessanter.

[[Datei:Attribute Cache erstellen.png|200px|thumb|rechts|Aktivierte Attribute im Vergleich zu deaktivierten Attributen auf der Bearbeitungsseite des jeweiligen Caches]]

== Attribute eingeben ==
[[Datei:Attribute Cache.png|200px|thumb|rechts|Ansicht der Attribute auf der Seite der Cachebeschreibung]]
Beim Erstellen eines eigenen Caches werden Attribute auf der Beschreibungsseite eingegeben, indem man die grau hinterlegten Felder der einzelnen Kategorien anklickt. Dadurch färben sie sich (je nach Attributgruppe) und werden nach dem Speichern der Beschreibung auf der Cacheseite angezeigt.

Setze alle zutreffenden Attribute, die du finden kannst, und achte dabei auf die Erläuterungen zu den Attributen!

== OC-Only ==
Auf Opencaching.de ist das OC-Only-Symbol besonders wichtig. Es kennzeichnet einen Cache, welcher nur auf OC gelistet ist und auch nur dort gefunden werden kann und sollte grundsätzlich bei allen Caches dieser Art gesetzt sein. Weitere Informationen hierzu findest du im Artikel [[OConly]].

Falls du dich nachträglich für ein [[Mehrfachlisting]] entscheiden solltest denke bitte daran, das OC-Only-Attribut wieder zu entfernen.

== Erklärung aller Symbole ==
Eine Erklärung aller Symbole findest du [http://www.opencaching.de/articles.php?page=cacheinfo hier].

[[Kategorie:Opencaching]]
[[Kategorie:Listings und Logs]]

[[pl:Atrybuty skrzynki]]
[[en:New cache attributes]]

Wegpunkte

2013-10-09T15:19:23Z

Dl6hbo: /* Externe Wegpunkte */

Ein Geocaching-'''Wegpunkt''' kann sein

# eine gespeicherte Koordinate, die irgendwie benannt oder beschrieben ist, oder
# ein Kürzel, das ein [[Listing|Cachelisting]] bezeichnet.

Diese beiden Wegpunkttypen sind im Folgenden mit (1) bzw. (2) gekennzeichnet.

__NOTOC__

== Wegpunkte bei Opencaching.de ==

=== Wegpunkt eines Listings ===
[[Datei:Wegpunktsuche.png|thumb|Suche nach Wegpunkt]]

Wenn man ein [[Erstellen einer Cachebeschreibung/ Listing|neues Cachelisting anlegt]], erhält es automatisch einen neuen Wegpunkt (2). Die ersten beiden Buchstaben des Wegpunkts bezeichnen die [[Geocaching-Plattformen|Geocaching-Plattform]], in diesem Fall ''OC''; danach folgt eine [http://de.wikipedia.org/wiki/Hexadezimalsystem hexadezimale] Zahl. Beispiel: {{Cachelink|OCCA2E}}

Mit diesem Wegpunkt kann man auf Opencaching.de nach dem Cache suchen. Durch Voranstellen von www.opencaching.de kann man auch direkt darauf zugreifen, z.B. http://www.opencaching.de/OCE793.

=== Externe Wegpunkte ===
Damit hat der Besitzer eines Cachelistings die Möglichkeit, darauf hinzuweisen dass der Cache auch auf einer anderen Plattform gelistet ist. <br>
Bei Opencaching ist es ausdrücklich erwünscht diese Wegpunkte (2) einzutragen. Dafür kann der Owner beim Cache bearbeiten einfach unter „Wegpunkte (optional)" den entsprechenden Wegpunkt eintragen.<br>
* Geocaching.com Wegpunkt: GC + Zahlen-/Buchstabenfolge z.B. GC2YQP6<br>
* Navicache.com Wegpunkt: NC + hexadezimale Zahl

[[Datei:Wegpunkt extern.png|rechts|Externer Wegpunkt]]
Im Listing erscheint bei eingetragenem Wegpunkt „Auch gelistet auf: geocaching.com“, und man kann durch Klicken auf ''geocaching.com'' direkt das Zweitlisting erreichen.

=== Interne, zusätzliche Wegpunkte ===
[[Datei:Zusätzliche Wegpunkte.png|thumb|zusätzliche Wegpunkte von {{Cachelink|OCCA2E}}|right]]
Damit kann der Owner einen Parkplatz, einzelne Stationen oder bestimmte Stellen markieren. Dazu bearbeitet er das Listing und fügt jeweils einen Wegpunkt (1) hinzu, der einen der folgenden Typen haben kann:
* Parkplatz – siehe unten
* Station oder Referenzpunkt – die Station eines [[Multicache]]s, oder ein anderer Punkt der für das Lösen/Finden des Caches von Bedeutung ist
* Pfad – Beginn des Weges oder ein Punkt auf dem Weg zum Cache
* Ziel – Das Zielgebiet, in dem der Cache versteckt ist.
* interessanter Ort – Sehenswürdigkeit, Aussichtspunkt etc.

Neben den Koordinaten kann eine zusätzliche Beschreibung angeben werden, um den Wegpunkt zu erklären.

Diese Wegpunkte werden in der Cachebeschreibung angezeigt, und auf der [[Cachekarte|Karte]], sobald man den Cache dort anklickt. Außerdem sind sie in heruntergeladenen [[Wie erhalte ich eine GPX-Datei?|GPX-Dateien]] enthalten und werden an das [[Cachedaten an GPS-Gerät senden|GPS-Gerät gesendet]].

==== Parkplatz, ein besonders wichtiger Wegpunkt ====
Die Angabe eines Parkplatzes kann sehr hilfreich sein. Oft kommen Cacher von weiter her, um Caches zu suchen. An den Cachekoordinaten selbst kann nicht immer geparkt werden, und manchmal ist es etwas schwierig, einen Parkplatz in angemessener Nähe zu finden. Manchmal gibt es auch von einem vom Besitzer des Caches vorgesehenen Parkplatz aus einen besonders günstigen Weg zum Cache, den ein Fremder selbst kaum finden kann. Um sinnloses Querfeldeinlaufen oder lange Parkplatzsuche mit entsprechendem Spritverbrauch zu vermeiden, ist die Angabe eines Parkplatzes bei solchen Caches eine sinnvolle Zeitinvestition.

[[Kategorie:Listings und Logs]]
[[Kategorie:Opencaching]]

[[pl:Waypoint]]

Geländewertung

2013-10-09T15:11:50Z

Dl6hbo: /* Gelände 5 */

Die Gelände- oder Terrainwertung eines Caches gibt an, mit welchem Gelände zu rechnen ist. Auf der jeweiligen Cacheseite wird diese Wertung mit grünen Balken dargestellt. Die Spanne reicht dabei von 1 bis 5. Als Kurzbezeichnung dient auch der Buchstabe „T“ mit angehängter Ziffer, z.B. ''T2'' für Geländewertung 2.

Die folgenden Angaben dienen als Anhaltspunkte. Sie beziehen sich jeweils auf trockene, gewöhnliche Witterungsverhältnisse.

''Siehe auch:'' [[Schwierigkeitswertung]]

== Gelände 1 ==
{|
|style="vertical-align:top"|[[Datei:Terr-10.gif]] 
|Man befindet sich in flachem Gelände mit asphaltierten oder glatt gepflasterten Wegen. Es ist deutlich weniger als ein Kilometer zu gehen. Diese Caches sind häufig auch für Behinderte und Rollstuhlfahrer geeignet.
|}

[[Datei:OCE6DA Park.jpg|thumb|{{Cachelink|OCE6DA}}: Gelände 2]]

== Gelände 2 ==
{|
|style="vertical-align:top"|[[Datei:Terr-20.gif]] 
|Es gibt befestigte Wege und kaum Höhenunterschiede, Rasenflächen etc. Es sind nur wenige Kilometer zu gehen. Die Caches sind auch für kleine Kinder geeignet.
|}

== Gelände 3 ==
{|
|style="vertical-align:top"|[[Datei:Terr-30.gif]] 
|Es geht durch unwegsames oder steiles Gelände oder leichtes Unterholz. Im Rahmen einer kleinen Wanderung wird diese Geländewertung gewählt. Das Gelände ist für kleine Kinder nicht geeignet.
|}

== Gelände 4 ==
[[Datei:6e2b99f6-1173-410e-bd82-c7327b60e9e9.jpg|thumb|hochkant=0.8|Gelände 4–5]]
{|
|style="vertical-align:top"|[[Datei:Terr-40.gif]] 
|Das Gelände ist weglos, sehr steil, so dass man seine Hände einsetzen muss, oder hat sehr dichtes Unterholz. Jedoch kann es sich dabei auch um eine lange Wanderung handeln.
|}

== Gelände 5 ==
{|
|style="vertical-align:top"|[[Datei:Terr-50.gif]] 
|Besondere Ausrüstung oder Erfahrung sind Pflicht für diesen Schwierigkeitsgrad. Es muss beispielsweise geklettert oder getaucht werden etc.
|}

== Zwischenwerte ==
{|
|style="vertical-align:top"|[[Datei:Terr-25.gif]] 
|Es sind auch Zwischenwerte möglich (1,5 / 2,5 / 3,5 / 4,5). Diese werden dann gewählt, wenn die Geländewertung zwischen zwei der oben beschriebenen Stufen liegt.
|}

[[Kategorie:Schwierigkeiten]]

[[pl:Stopień trudności terenu]]

Geländewertung

2013-10-09T15:10:54Z

Dl6hbo: /* Gelände 4 */

Die Gelände- oder Terrainwertung eines Caches gibt an, mit welchem Gelände zu rechnen ist. Auf der jeweiligen Cacheseite wird diese Wertung mit grünen Balken dargestellt. Die Spanne reicht dabei von 1 bis 5. Als Kurzbezeichnung dient auch der Buchstabe „T“ mit angehängter Ziffer, z.B. ''T2'' für Geländewertung 2.

Die folgenden Angaben dienen als Anhaltspunkte. Sie beziehen sich jeweils auf trockene, gewöhnliche Witterungsverhältnisse.

''Siehe auch:'' [[Schwierigkeitswertung]]

== Gelände 1 ==
{|
|style="vertical-align:top"|[[Datei:Terr-10.gif]] 
|Man befindet sich in flachem Gelände mit asphaltierten oder glatt gepflasterten Wegen. Es ist deutlich weniger als ein Kilometer zu gehen. Diese Caches sind häufig auch für Behinderte und Rollstuhlfahrer geeignet.
|}

[[Datei:OCE6DA Park.jpg|thumb|{{Cachelink|OCE6DA}}: Gelände 2]]

== Gelände 2 ==
{|
|style="vertical-align:top"|[[Datei:Terr-20.gif]] 
|Es gibt befestigte Wege und kaum Höhenunterschiede, Rasenflächen etc. Es sind nur wenige Kilometer zu gehen. Die Caches sind auch für kleine Kinder geeignet.
|}

== Gelände 3 ==
{|
|style="vertical-align:top"|[[Datei:Terr-30.gif]] 
|Es geht durch unwegsames oder steiles Gelände oder leichtes Unterholz. Im Rahmen einer kleinen Wanderung wird diese Geländewertung gewählt. Das Gelände ist für kleine Kinder nicht geeignet.
|}

== Gelände 4 ==
[[Datei:6e2b99f6-1173-410e-bd82-c7327b60e9e9.jpg|thumb|hochkant=0.8|Gelände 4–5]]
{|
|style="vertical-align:top"|[[Datei:Terr-40.gif]] 
|Das Gelände ist weglos, sehr steil, so dass man seine Hände einsetzen muss, oder hat sehr dichtes Unterholz. Jedoch kann es sich dabei auch um eine lange Wanderung handeln.
|}

== Gelände 5 ==
{|
|style="vertical-align:top"|[[Datei:Terr-50.gif]] 
|Besondere Ausrüstung oder Erfahrung sind Pflicht für diese Geländeschwierigkeit. Es muss beispielsweise geklettert oder getaucht werden etc.
|}

== Zwischenwerte ==
{|
|style="vertical-align:top"|[[Datei:Terr-25.gif]] 
|Es sind auch Zwischenwerte möglich (1,5 / 2,5 / 3,5 / 4,5). Diese werden dann gewählt, wenn die Geländewertung zwischen zwei der oben beschriebenen Stufen liegt.
|}

[[Kategorie:Schwierigkeiten]]

[[pl:Stopień trudności terenu]]