diff --git a/user_manual/images/KAddressBook.png b/user_manual/images/KAddressBook.png new file mode 100644 index 000000000..6f8edd681 Binary files /dev/null and b/user_manual/images/KAddressBook.png differ diff --git a/user_manual/images/KOrganizer.png b/user_manual/images/KOrganizer.png new file mode 100644 index 000000000..8785471d7 Binary files /dev/null and b/user_manual/images/KOrganizer.png differ diff --git a/user_manual/images/KOrganizer_add_calendar.png b/user_manual/images/KOrganizer_add_calendar.png new file mode 100644 index 000000000..8e683c9af Binary files /dev/null and b/user_manual/images/KOrganizer_add_calendar.png differ diff --git a/user_manual/images/KOrganizer_groupware_server.png b/user_manual/images/KOrganizer_groupware_server.png new file mode 100644 index 000000000..6792989b5 Binary files /dev/null and b/user_manual/images/KOrganizer_groupware_server.png differ diff --git a/user_manual/images/KOrganizer_pick_resources.png b/user_manual/images/KOrganizer_pick_resources.png new file mode 100644 index 000000000..77913768f Binary files /dev/null and b/user_manual/images/KOrganizer_pick_resources.png differ diff --git a/user_manual/images/KOrganizer_server_address.png b/user_manual/images/KOrganizer_server_address.png new file mode 100644 index 000000000..fa734293e Binary files /dev/null and b/user_manual/images/KOrganizer_server_address.png differ diff --git a/user_manual/images/KOrganizer_test1.png b/user_manual/images/KOrganizer_test1.png new file mode 100644 index 000000000..25ecee397 Binary files /dev/null and b/user_manual/images/KOrganizer_test1.png differ diff --git a/user_manual/images/KOrganizer_test2.png b/user_manual/images/KOrganizer_test2.png new file mode 100644 index 000000000..3e7acbdd9 Binary files /dev/null and b/user_manual/images/KOrganizer_test2.png differ diff --git a/user_manual/images/app_password_created.png b/user_manual/images/app_password_created.png new file mode 100644 index 000000000..bda955b55 Binary files /dev/null and b/user_manual/images/app_password_created.png differ diff --git a/user_manual/images/app_password_naming.png b/user_manual/images/app_password_naming.png new file mode 100644 index 000000000..35beabd1c Binary files /dev/null and b/user_manual/images/app_password_naming.png differ diff --git a/user_manual/images/korganizer_credentials.png b/user_manual/images/korganizer_credentials.png new file mode 100644 index 000000000..3eab059fa Binary files /dev/null and b/user_manual/images/korganizer_credentials.png differ diff --git a/user_manual/images/korganizer_resource_choice.png b/user_manual/images/korganizer_resource_choice.png new file mode 100644 index 000000000..7cf6e6521 Binary files /dev/null and b/user_manual/images/korganizer_resource_choice.png differ diff --git a/user_manual/pim/index.rst b/user_manual/pim/index.rst index 80ec61ab8..75d2d5553 100644 --- a/user_manual/pim/index.rst +++ b/user_manual/pim/index.rst @@ -14,5 +14,6 @@ their respective Apps > Productivity entries. sync_ios sync_osx sync_thunderbird + sync_kde troubleshooting diff --git a/user_manual/pim/sync_kde.rst b/user_manual/pim/sync_kde.rst new file mode 100644 index 000000000..d9feb69bb --- /dev/null +++ b/user_manual/pim/sync_kde.rst @@ -0,0 +1,58 @@ +======================================= +Synchronizing with KDE PIM +======================================= + +KOrganizer and KAddressbook can synchronize data with a Nextcloud server. + +This can be done by following these steps: + +1. Open KOrganizer and in the calendar list (bottom left) right-click and choose ``Add Calendar`` + +.. image:: ../images/KOrganizer_add_calendar.png + +2. In the resulting list of resources, pick ``DAV groupware resource`` + +.. image:: ../images/korganizer_resource_choice.png + +3. Enter your user name and password, or, if you have two-factor authentication enabled, use an App Password. Then click next. + +.. image:: ../images/korganizer_credentials.png + +To create an App Password if you have two-factor authentication: + + * in Nextcloud, go to your user settings and look under security. + * Look for the button ``create new App password`` and before it, enter a unique name, like ``KOrganizer on my laptop`` + + .. image:: ../images/app_password_naming.png + + * then click ``create new App password``. Copy-paste the password! + +.. image:: ../images/app_password_created.png + +4. As Groupware Server, choose ownCloud or Nextcloud in the drop-down menu. Click next. + +.. image:: ../images/KOrganizer_groupware_server.png + +5. Enter your Nextcloud server url and, if needed, installation path (anything that comes after the first /, for example ``mynextcloud`` in ``https://exampe.com/mynextcloud``). Then click next. + +.. image:: ../images/KOrganizer_server_address.png + +6. You can now test the connection. If it does not work, you can go back and try to fix it with other settings. + +.. image:: ../images/KOrganizer_test1.png + +.. image:: ../images/KOrganizer_test2.png + +**Note:** the test can take a while! + +7. Pick a name for this resource, for example ``work`` or ``private`` By default, both CalDav and CardDav are synced, that is, both calendar and contacts. Choose a refresh time, 5 minutes is default but quite often for use on a laptop. Perhaps you want to save power and be a bit slower, like once every 30 minutes. Note that you can update with a right-click on the item in the calendar list and when you create a new appointment it is synced to Nextcloud right away. + +.. image:: ../images/KOrganizer_pick_resources.png + +done +~~~~ + +After a few seconds to minutes (the sync can take a while on a slow connection) KOrganizer will show your calendars and KAddressBook will show your contacts! + +.. image:: ../images/KOrganizer.png +.. image:: ../images/KAddressBook.png