Home

2015-07-22: We're moving to GitHub! Repository is temporarily read-only.

OpenCaching.PL - official project repository

Brief introduction in Polish

-> Jeśli zawsze chciałeś zajrzeć w kod źródłowy którejś ze stron OpenCaching.PL, ale nie bardzo wiedziałeś jak, to dobrze trafiłeś.

Skocz do:

• Instrukcja instalacji serwera deweloperskiego - czyli jak uruchomić własny serwer OC w 10 minut,
• Przeglądarka kodu - dokładna kopia kodu, który działa w tym momencie na http://opencaching.pl/ (i paru innych domenach),
• Zapoznaj się z wprowadzeniem do kodu OCPL (dokument może być średnio świeży).
• Jak przesłać swoje poprawki?

---

Brief introduction in English

This is the source code of OpenCaching.PL site. It is one of the branches of the "OpenCaching National Sites" project. There are two main "branches" of this project:

• OpenCaching.PL branch (http://code.google.com/p/opencaching-pl/), deployed at MULTIPLE servers, every one of each is connected to ONE national OC domain (opencaching.pl, opencaching.us, opencaching.org.uk, etc.); all these sites are separate and they run on different code which have branched from opencaching.pl.
  • Some of these sites are always up-to-date (there's a postcommit script connected to the repository): opencaching.pl, opencaching.nl, opencaching.ro... (this list is apt to grow)
  • Some other sites use older copies of the code (e.g. opencaching.org.uk and opencaching.us). There are plans to switch their databases to the latest OCPL version (and subscribe them up to OCPL postcommit hook).
  • If other nodes would like to use it, we encourage you to try. However, it is NOT a travial task to add support for other languages into OCPL code. We may give you access to our repository if you'd like to internationalize it, but be warned - there's some work to be done here!
• OpenCaching.DE branch - (https://github.com/OpencachingDeutschland/oc-server3),
  • The up-to-date version is deployed as ONE server which is connected to THREE national domains (opencaching.de, opencaching.it, opencachingspain.es); all these sites run on one server (one code and database),
  • There are also some other domains which have branched from OCDE, but they haven't been updated for some time - opencachind.se/no (one site), opencaching.nl (which is currently being switched to OCPL).
• Well, there is also the OpenCaching.CZ site, which uses the VERY old code. It has branched from OCDE before OCPL. As far as we know, it has not been much developed since.

The projects have branched a couple of years ago. However, both of the primary branches are using the same public API (called OKAPI, see http://opencaching.pl/okapi/).

There's a virtual machine with the running instance of OCPL code. It can used by the developers to verify their changes before commit.

Some of our developers are not fluid in English, therefore most of this document will also remain in Polish, to encourage our local development. We encourage our developers to use English whereever they can (SVN log messages and the code itself). Contact us (rt@opencaching.pl) if you need any information.