Difference between revisions of "Configuration"

From Davical
Jump to: navigation, search
m (link to permission configuration page was pointing at an obsoleted site)
(link gitlab instead of repo.or.cz)
 
Line 41: Line 41:
  
 
You can, however, download these example configurations from the source code, here:  
 
You can, however, download these example configurations from the source code, here:  
* [http://repo.or.cz/w/davical.git?a=blob;f=config/example-config.php;hb=HEAD Example Config] - examples of the general settings.  
+
* [https://gitlab.com/davical-project/davical/blob/master/config/example-config.php Example Config] - examples of the general settings.  
* [http://repo.or.cz/w/davical.git?a=blob;f=config/other-config.php;hb=HEAD Other Config] - examples of the more unusual settings.  
+
* [https://gitlab.com/davical-project/davical/blob/master/config/other-config.php Other Config] - examples of the more unusual settings.  
* [http://repo.or.cz/w/davical.git?a=blob;f=config/debug-config.php;hb=HEAD Debugging Config] - examples of the debugging settings.
+
* [https://gitlab.com/davical-project/davical/blob/master/config/debug-config.php Debugging Config] - examples of the debugging settings.
  
 
There is also an start on a wikified version of the main example above, at [[Configuration settings]].
 
There is also an start on a wikified version of the main example above, at [[Configuration settings]].

Latest revision as of 19:06, 31 December 2015

This page, and related sub-pages, give details of the configuration of DAViCal itself. If you haven't yet got Apache, PHP and PostgreSQL working correctly to get DAViCal operating in a basic manner then you need to sort those issues out first. Take a look at the Apache Config, PHP Config and PostgreSQL Config pages.

Location

The configuration file for DAViCal is looked for in several places, but the best choice is probably /etc/davical/config.php if you only want to run a single DAViCal instance.

If you want to do something different, DAViCal searches first for a number of absolute paths, and then for some relative paths, in the following order:

Absolute paths searched for DAViCal's configuration file:

  1. /etc/davical/server.domain.net-conf.php
  2. /etc/davical/config.php
  3. /usr/local/etc/davical/server.domain.net-conf.php
  4. /usr/local/etc/davical/config.php

Relative (to DAViCal's index.php) paths searched for the configuration file:

  1. ../config/config.php
  2. config/config.php

Make sure config.php is readable for your webserver!

Configuration is PHP Code

The DAViCal configuration file is a piece of PHP code which is included very early in the processing of each page. If that does not exist, you'll get a nice error page telling you what to put in it. If the file exists but is not readable, it will be silently ignored.

If the file has a PHP syntax error you will have problems! Make sure all assignments are enclosed in quotes (or are numbers) and that each statement is correctly ended with a semicolon.

General Configuration Settings

Example Configurations

Some commented example configurations are available in the source code. Unfortunately these did not ship in the past but they should be included in future versions in /usr/share/doc/davical/examples.

You can, however, download these example configurations from the source code, here:

There is also an start on a wikified version of the main example above, at Configuration settings.

See Also

Sub Pages