From 0ea95b1af40d0d128b8b72fbe24cec955ca312e3 Mon Sep 17 00:00:00 2001 From: Simon Schoeters Date: Sun, 25 Aug 2013 15:00:34 +0200 Subject: [PATCH 1/3] Add configuration instructions for Contacts on OS X --- pages/user_documentation.rst | 30 +++++++++++++++++++++++++----- 1 file changed, 25 insertions(+), 5 deletions(-) diff --git a/pages/user_documentation.rst b/pages/user_documentation.rst index 9bc1b8b8..c7ed0473 100644 --- a/pages/user_documentation.rst +++ b/pages/user_documentation.rst @@ -285,7 +285,7 @@ Contacts interested in this feature, please check this `bug report `_. -iCal +OS X ~~~~ .. note:: @@ -331,9 +331,30 @@ now set-up. You can close the ``Preferences`` window. Contacts ++++++++ -**Contacts do not work yet with Radicale and Apple's clients.** If you are -interested in this feature, please check this `bug report -`_. +In Contacts 7 (previously known as AddressBook): + +1. Open the ``Preferences`` dialog and select the ``Accounts`` tab. +2. Click the ``+`` button at the lower left to open the account creation wizard. +3. As ``Account type`` select ``CardDAV``. +4. Add any ``User name`` you like. +5. The ``Password`` field can be left empty (if we didn't configure + authentication). +6. As ``Server address`` use ``domain:port``, for example ``localhost:5232`` + (this would be the case if you start an unconfigured radicale server on your local + machine). +7. Click ``Create``. Contacts will complain about an `Unsecured Connection` if you + don't have SSL enabled. Click ``Create`` again. +8. You might want to change the ``Description`` of the newly added account to + something more readable. (optional) +9. Switch to the ``General`` tab in the preferences and select the radicale server + as ``Default Account`` at the bottom of the screen. It probably shows up as + ```domain:port`` or the name you choose if you changed the description. Newly + added contacts are added to the default account and by default this will be the + local `On My Mac` account. + +.. important:: + You'll need version 0.8.1 or up for this to work. Earlier version can read CardDAV + contacts but can't add new contacts. syncEvolution ~~~~~~~~~~~~~ @@ -341,7 +362,6 @@ syncEvolution You can find more information about syncEvolution and Radicale on the `syncEvolution wiki page `_. - Complex Configuration ===================== From 3062efb8034a82b798b1ba579e4fd87ecf491b6c Mon Sep 17 00:00:00 2001 From: Simon Schoeters Date: Sun, 25 Aug 2013 15:21:44 +0200 Subject: [PATCH 2/3] Add configuration instructions for Contacts on iOS --- pages/user_documentation.rst | 33 +++++++++++++++++++++++++++------ 1 file changed, 27 insertions(+), 6 deletions(-) diff --git a/pages/user_documentation.rst b/pages/user_documentation.rst index c7ed0473..95278330 100644 --- a/pages/user_documentation.rst +++ b/pages/user_documentation.rst @@ -257,7 +257,7 @@ that are critical for proper operation. 1. From the Home screen, open ``Settings`` 2. Select ``Mail, Contacts, Calendars`` -3. Select ``Add Account`` → ``Other`` → ``Add CalDAV Account`` +3. Select ``Add Account...`` → ``Other`` → ``Add CalDAV Account`` 4. Enter the server URL here, including ``https``, the port, and the user/calendar path, ex: https://myserver.domain.com:3000/bob/birthdays/ 5. Enter your username and password as defined in your server config @@ -281,9 +281,30 @@ that are critical for proper operation. Contacts ++++++++ -**Contacts do not work yet with Radicale and Apple's clients.** If you are -interested in this feature, please check this `bug report -`_. +Contacts +++++++++ + +In Contacts on iOS 6: + +1. From the Home screen, open ``Settings`` +2. Select ``Mail, Contacts, Calendars`` +3. Select ``Add Account...`` → ``Other`` → ``Add CardDAV Account`` +4. As ``Server`` use the radicale server URL with port, for example ``localhost:5232`` +5. Add any ``User name`` you like (if you didn't configure authentication) +6. Add any ``Password`` you like (again, if you didn't configure authentication) +7. Change the ``Description`` to something more readable (optional) +8. Tap ``Next`` +9. An alert showing `Cannot Connect Using SSL` will pop up as we haven't configured + SSL yet, ``Continue`` for now +10. Back on the ``Mail, Contacts, Calendars`` screen you scroll to the ``Contacts`` section, + select the radicale server as ``Default Account`` when you want to save new contacts to + the radicale server +11. Exit to the Home screen and open ``Contacts``, tap ``Groups``, you should see the + radicale server + +.. note:: + You'll need version 0.8.1 or up for this to work. Earlier versions will forget your new + settings after a reboot. OS X ~~~~ @@ -352,8 +373,8 @@ In Contacts 7 (previously known as AddressBook): added contacts are added to the default account and by default this will be the local `On My Mac` account. -.. important:: - You'll need version 0.8.1 or up for this to work. Earlier version can read CardDAV +.. note:: + You'll need version 0.8.1 or up for this to work. Earlier versions can read CardDAV contacts but can't add new contacts. syncEvolution From 72d2becd69511bc49f702a359d0d058c3e756509 Mon Sep 17 00:00:00 2001 From: Simon Schoeters Date: Sun, 25 Aug 2013 15:23:54 +0200 Subject: [PATCH 3/3] Replace radicale with Radicale when talking about the service --- pages/user_documentation.rst | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/pages/user_documentation.rst b/pages/user_documentation.rst index 95278330..18610dc5 100644 --- a/pages/user_documentation.rst +++ b/pages/user_documentation.rst @@ -289,7 +289,7 @@ In Contacts on iOS 6: 1. From the Home screen, open ``Settings`` 2. Select ``Mail, Contacts, Calendars`` 3. Select ``Add Account...`` → ``Other`` → ``Add CardDAV Account`` -4. As ``Server`` use the radicale server URL with port, for example ``localhost:5232`` +4. As ``Server`` use the Radicale server URL with port, for example ``localhost:5232`` 5. Add any ``User name`` you like (if you didn't configure authentication) 6. Add any ``Password`` you like (again, if you didn't configure authentication) 7. Change the ``Description`` to something more readable (optional) @@ -297,10 +297,10 @@ In Contacts on iOS 6: 9. An alert showing `Cannot Connect Using SSL` will pop up as we haven't configured SSL yet, ``Continue`` for now 10. Back on the ``Mail, Contacts, Calendars`` screen you scroll to the ``Contacts`` section, - select the radicale server as ``Default Account`` when you want to save new contacts to - the radicale server + select the Radicale server as ``Default Account`` when you want to save new contacts to + the Radicale server 11. Exit to the Home screen and open ``Contacts``, tap ``Groups``, you should see the - radicale server + Radicale server .. note:: You'll need version 0.8.1 or up for this to work. Earlier versions will forget your new @@ -326,12 +326,12 @@ In iCal 4.0 or iCal 5.0: 5. The ``Password`` field can be left empty (we did not configure authentication) 6. As ``Server address`` use ``domain:port``, for example ``localhost:5232`` - (this would be the case if you start an unconfigured radicale on your local + (this would be the case if you start an unconfigured Radicale on your local machine) Click ``Create``. The wizard will now tell you, that no encryption is in place (``Unsecured Connection``). This is expected and will change if you configure -radicale to use SSL. Click ``Continue``. +Radicale to use SSL. Click ``Continue``. .. warning:: In iCal 5.x, please check twice that the ``Sync all entries`` option is @@ -361,13 +361,13 @@ In Contacts 7 (previously known as AddressBook): 5. The ``Password`` field can be left empty (if we didn't configure authentication). 6. As ``Server address`` use ``domain:port``, for example ``localhost:5232`` - (this would be the case if you start an unconfigured radicale server on your local + (this would be the case if you start an unconfigured Radicale server on your local machine). 7. Click ``Create``. Contacts will complain about an `Unsecured Connection` if you don't have SSL enabled. Click ``Create`` again. 8. You might want to change the ``Description`` of the newly added account to something more readable. (optional) -9. Switch to the ``General`` tab in the preferences and select the radicale server +9. Switch to the ``General`` tab in the preferences and select the Radicale server as ``Default Account`` at the bottom of the screen. It probably shows up as ```domain:port`` or the name you choose if you changed the description. Newly added contacts are added to the default account and by default this will be the