addons/document_webdav/doc/well-known.rst

   1 =================
   2 Well-known URIs
   3 =================
   4
   5 In accordance to IETF RFC 5785 [1], we shall publish a few locations
   6 on the root of our http server, so that clients can discover our
   7 services (CalDAV, eg.).
   8
   9 This module merely installs a special http request handler, that will
  10 redirect the URIs from "http://our-server:port/.well-known/xxx' to
  11 the correct path for each xxx service.
  12
  13 Note that well-known URIs cannot have a database-specific behaviour,
  14 they are server-wide. So, we have to explicitly chose one of our databases
  15 to serve at them. By default, the database of the configuration file
  16 is chosen
  17
  18 Example config:
  19
  20 [http-well-known]
  21 num_services = 2
  22 db_name = openerp-main ; must define that for path_1 below
  23 service_1 = caldav
  24 path_1 = /webdav/%(db_name)s/Calendars/
  25 service_2 = foo
  26 path_2 = /other_db/static/Foo.html
  27
  28
  29 [1] http://www.rfc-editor.org/rfc/rfc5785.txt