Configuration: Difference between revisions

From Davical
Jump to navigationJump to search
m (relink orphaed debugging page)
(link gitlab instead of repo.or.cz)
 
(3 intermediate revisions by one other user not shown)
Line 1: Line 1:
{{Languages|Configuration}}
{{TOCright}}
{{TOCright}}
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.
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.
Line 10: Line 9:


Absolute paths searched for DAViCal's configuration file:
Absolute paths searched for DAViCal's configuration file:
# /etc/davical/server.domain.net-conf.php
# <code>/etc/davical/server.domain.net-conf.php</code>
# /etc/davical/config.php
# <code>/etc/davical/config.php</code>
# /usr/local/etc/davical/server.domain.net-conf.php
# <code>/usr/local/etc/davical/server.domain.net-conf.php</code>
# /usr/local/etc/davical/config.php
# <code>/usr/local/etc/davical/config.php</code>


Relative (to DAViCal's index.php) paths searched for the configuration file:
Relative (to DAViCal's index.php) paths searched for the configuration file:
# ../config/config.php
# <code>../config/config.php</code>
# config/config.php
# <code>config/config.php</code>


'''Make sure config.php is readable for your webserver!'''
'''Make sure config.php is readable for your webserver!'''
Line 29: Line 28:
== General Configuration Settings ==
== General Configuration Settings ==


* [[Problems And Solutions]]
* [[Permissions|User and Group Permissions]]
* [[Configuration/Database_Settings|Database Settings]]
* [[Configuration/Database_Settings|Database Settings]]
* [[Configuration/Authentication_Settings|Authentication Settings]] - configuring external authentication methods like LDAP, AD, AD with SSO, etc.
* [[Configuration/Authentication_Settings|Authentication Settings]] - configuring external authentication methods like LDAP, AD, AD with SSO, etc.
* [[Debugging|Debugging Settings]]
* [[Debugging|Debugging Settings]]
* [[Configuration/hooks]] - pages about hooks for interacting with DAViCal's operation
* [[Configuration/settings]] - a list of pages for each configuration setting


==Example Configurations==
==Example Configurations==
Line 38: 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

Template:TOCright 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

{{#subpages:}}