Skip to content

Contacts#

Defaults#

contacts.xml
  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
<?xml version="1.0" encoding="utf-8"?>
<!-- Describes a contacts setup -->
<contacts version="1.26.11">
  <!-- Describes a ldap setup -->
  <ldap>
    <!-- use this service or not
         type: boolean -->
    <active>false</active>
    <!-- ldap server address fqdn or ip address
         type: string -->
    <server>ldap.example.org</server>
    <!-- ldap lts modes
         type: enum
         accepted values:
           ldap
           ldapStartTls
           ldaps -->
    <ldapProtocol>ldap</ldapProtocol>
    <!-- ldap server port 389 or 636 (LDAPS)
         type: integer
         minimum: 1
         maximum: 65535 -->
    <port>389</port>
    <!-- ldap protocol version 2 or 3
         type: enum
         accepted values:
           two
           three -->
    <ldapVersion>three</ldapVersion>
    <!-- username to login
         type: string -->
    <username>telephoneNumber=1234, dc=example</username>
    <!-- The password to authenticate the for the ldap server
         type: string -->
    <password></password>
    <!-- name filter according to RFC2254
         type: string -->
    <nameFilter>(|(cn=%*)(cn=* %*)(sn=%*)(sn=* %*)(givenName=%*)(givenName=* %*))</nameFilter>
    <!-- number filter according to RFC2254 for reverse number lookup
         type: string -->
    <numberFilter>(|(telephoneNumber=*%)(mobile=*%)(homePhone=*%))</numberFilter>
    <!-- number filter according to RFC2254 for the number suggestion list in the dialer
         type: string -->
    <dialerNumberFilter>(|(telephoneNumber=*%*)(mobile=*%*)(homePhone=*%*))</dialerNumberFilter>
    <!-- scope that will be searched
         type: string -->
    <baseDN>dc=example</baseDN>
    <!-- maximum size of a result list for a filtered search
         type: integer
         minimum: 1
         maximum: 32000 -->
    <maxHits>20</maxHits>
    <!-- Maximum size of a result list for an unfiltered search when starting the contacts app
         type: integer
         maximum: 32000 -->
    <maxEntriesOnStart>100</maxEntriesOnStart>
    <!-- what names are you looking for
         type: string -->
    <nameAttributes>cn sn givenName company o</nameAttributes>
    <!-- what numbers are you looking for
         type: string -->
    <numberAttributes>mobile telephoneNumber homePhone</numberAttributes>
    <!-- find contact by incoming call number
         type: boolean -->
    <reverseNumberLookupIncoming>true</reverseNumberLookupIncoming>
    <!-- find contact by outgoing call number
         type: boolean -->
    <reverseNumberLookupOutgoing>true</reverseNumberLookupOutgoing>
  </ldap>
  <!-- set of smoothSync configuration parameters
       type: list -->
  <smoothSync>
    <!-- parameters:
           name: the name of this smooth Sync config
                 type: string -->
    <smoothSyncConfiguration name="">
      <!-- username to login on the server
           type: string -->
      <username></username>
      <!-- password to login on the server
           type: string -->
      <password>secretPassword</password>
      <!-- whether the services are read-only or not
           type: boolean -->
      <readonly>false</readonly>
      <!-- type: list -->
      <services>
        <smoothSyncService>
          <!-- type: enum
               accepted values:
                 CalDAV
                 CardDAV -->
          <serviceType>CardDAV</serviceType>
          <!-- The URL of the service
               type: string -->
          <uri></uri>
        </smoothSyncService>
      </services>
    </smoothSyncConfiguration>
  </smoothSync>
  <!-- name sorting order for contact query results
       type: enum
       accepted values:
         orderByFirstname
         orderByLastname -->
  <orderBy>orderByFirstname</orderBy>
  <!-- name format for contact query results
       type: enum
       accepted values:
         givenNameFirst
         surnameFirst -->
  <nameFormat>givenNameFirst</nameFormat>
</contacts>