Thunderbird integration with Nextcloud (#500)

* Thunderbird integration with Nextcloud

* Edited guide and screen shots.

* added go to new tab to list of available packages.

* Resize image

* More url blackouts

* Final image resize

site/source/guides/service-guides/nextcloud/nextcloud-apps/index.rst

@@ -31,3 +31,4 @@ Integrations
   :maxdepth: 1
 
   joplin
+  thunderbird

site/source/guides/service-guides/nextcloud/nextcloud-apps/thunderbird.rst

@@ -0,0 +1,84 @@
+.. _nc-thunderbird:
+
+===========
+Thunderbird
+===========
+
+.. contents::
+  :depth: 2 
+  :local:
+
+Calendar & Contacts Syncing
+===========================
+You can set up your devices using their :ref:`integrations<nextcloud-setup>`, but if you wish to use a standalone client for your Calendar and Contacts syncing, we recommend Mozilla's `Thunderbird <https://www.thunderbird.net>`_.
+
+1. Install the :ref:`Calendar<nc-calendar>` and :ref:`Contacts<nc-contacts>` apps in Nextcloud if they are not currently installed.
+2. Add your :ref:`RootCA<trust-ca>` to your system and then configure :ref:`Thunderbird<lan-thunderbird>`.
+
+3. Select Calendar or Contacts from below to complete each unique setup:
+
+.. tabs::
+
+  .. group-tab:: Calendar 
+
+    1. In Thunderbird, click on the calendar icon, then "New Address Book" in the bottom-left.
+
+      .. figure:: /_static/images/nextcloud/thunderbird-calendar-step1.png
+          :width: 60%
+          :alt: thunderbird add calendar
+
+    2. Choose "On the network," then click "Next".
+
+      .. figure:: /_static/images/nextcloud/thunderbird-calendar-step2.png
+          :width: 40%
+          :alt: thunderbird add calendar checkbox
+
+    3. Fill in the Username and Location fields with the credentials from Nextcloud > Properties on your Start9 server.  Click "Find calendars".
+
+      .. figure:: /_static/images/nextcloud/thunderbird-calendar-step3.png
+          :width: 40%
+          :alt: thunderbird add calendar checkbox
+
+    4. Create a unique app password - In your Nextcloud WebUI, visit the top-right-hand menu and select "Personal Settings" -> "Security." At the bottom, under "Devices & Sessions," create a new app password with a name of your choice, such as "CalDAV." Copy the resulting password and paste it into Thunderbird.
+
+      .. figure:: /_static/images/nextcloud/native-nextcloud-integration-macos-step3.1.png
+        :width: 60%
+        :alt: nextcloud app password 
+
+      .. figure:: /_static/images/nextcloud/thunderbird-contact-step3.png
+          :width: 40%
+          :alt: thunderbird add password
+
+    5. Check which calendars you want to integrate and click "Subscribe".
+
+      .. figure:: /_static/images/nextcloud/thunderbird-calendar-step5.png
+          :width: 40%
+          :alt: thunderbird add calendar subscribe
+
+    Your Nextcloud calendar will now sync with Thunderbird.  Click on the "Contacts" tab above to add your contacts.
+  
+  .. group-tab:: Contacts
+
+    1. Click on the Address Book icon, open the drop-down menu for "New Address Book" and click "Add CarDav Address Book".
+
+      .. figure:: /_static/images/nextcloud/thunderbird-contact-step1.png
+          :width: 60%
+          :alt: thunderbird add new contact book
+
+    2. Fill in the Username and Location fields with the credentials from Nextcloud > Properties on your Start9 server. Click "Continue".
+
+      .. figure:: /_static/images/nextcloud/thunderbird-contact-step2.png
+          :width: 60%
+          :alt: thunderbird add new contact book
+
+    3. Create a unique app password - In your Nextcloud WebUI, visit the top-right-hand menu and select "Personal Settings" -> "Security." At the bottom, under "Devices & Sessions," create a new app password with a name of your choice, such as "CalDAV." Copy the resulting password and paste it into Thunderbird.
+
+      .. figure:: /_static/images/nextcloud/native-nextcloud-integration-macos-step3.1.png
+        :width: 60%
+        :alt: nextcloud app password 
+
+      .. figure:: /_static/images/nextcloud/thunderbird-contact-step3.png
+          :width: 40%
+          :alt: thunderbird add password
+
+    Your Nextcloud contacts will now sync with Thunderbird.

site/source/guides/service-guides/nextcloud/nextcloud-setup/nextcloud-linux.rst

@@ -33,7 +33,7 @@ For if your desktop environment does not support account integrations, or if you
 
 File Syncing - Nextcloud Desktop
 ================================
-This is Nextcloud's official client application for file syncing and account management.  It is available in your favorite package manager (usually as `nextcloud`).  You can also see this `full list of available packages <https://help.nextcloud.com/t/linux-packages-status/>`.   or you can get the latest version as an AppImage from the `Download for Desktop <https://nextcloud.com/install/#install-clients>`_ section of Nextcloud's website.
+This is Nextcloud's official client application for file syncing and account management.  It is available in your favorite package manager (usually as `nextcloud`).  You can also see this `full list of available packages <https://help.nextcloud.com/t/linux-packages-status/>`_.   or you can get the latest version as an AppImage from the `Download for Desktop <https://nextcloud.com/install/#install-clients>`_ section of Nextcloud's website.
 
 LAN Setup
 .........
@@ -57,22 +57,4 @@ You will first need to have the :ref:`Tor daemon running<tor-linux>`.
 2. Close the Settings screen and click the account in the top left again, then "Add Account."
 3. On the following screen, click "Log in," then enter your Nextcloud Tor server address, which you can copy from the Nextcloud page on your Embassy -> Interfaces -> Tor. This must start with `http://` and end with `.onion`. Click Next.
 4. This will launch your browser and prompt you to log in to your account. Log in and then grant access as we did for LAN.
-5. That's it! You may wish to set up some select folders for remote sync, but for large files, it is best to sync on LAN only, so you can "Skip folders configuration" on the resulting screen if you wish. Check your connection by clicking the newly created account in the client app.
-
-Calendar & Contacts Syncing - Thunderbird
-=========================================
-If you wish to use a standalone client for Calendar and Contacts, we recommend Mozilla's `Thunderbird <https://www.thunderbird.net>`_.
-
-1. Install the Contacts and Calendar apps in Nextcloud.
-2. Make sure you are on Thunderbird version 102.3.0 or greater and then import your LAN certificate:
-
-    - First, follow the :ref:`instructions for adding your Root CA to your system<ca-linux>` and then the :ref:`Thunderbird-specific instructions<lan-thunderbird>`.
-
-3. Download the `TBSync` and `Provider for CalDAV & CardDAV` add-ons by searching for them in the "Tools -> Add-ons and Themes" menu.
-4. Go back to "Tools -> Add-ons and Themes -> Extensions" and click the 'wrench' icon next to TBSync.
-5. Click "Account Actions" in the bottom left of the resulting screen, then "Add New Account -> CalDAV & CardDAV"
-6. Select "Automatic Configuration" and click `Next`
-7. Enter a name for your account, your nextcloud user name (found in Properties, default is 'admin'), password (found in Properties), and server LAN address (found in Interfaces, ending in `.local`) - then click "Next."
-8.  After connecting, click "Finish."
-9.  In the resulting window, click "Enable and synchronize this account."
-10. Select the items you want to sync, such as contacts and a calendar.
+5. That's it! You may wish to set up some select folders for remote sync, but for large files, it is best to sync on LAN only, so you can "Skip folders configuration" on the resulting screen if you wish. Check your connection by clicking the newly created account in the client app.

site/source/guides/service-guides/nextcloud/nextcloud-setup/nextcloud-mac.rst

@@ -182,22 +182,4 @@ You will first need to have the :ref:`Tor daemon running<tor-mac>`.
 
 5. This will launch your browser and prompt you to log in to your account. Log in and then grant access as we did for LAN.
 
-6. That’s it! You may wish to set up some select folders for remote sync, but for large files, it is best to sync on LAN only, so you can “Skip folders configuration” on the resulting screen if you wish. Check your connection by clicking the newly created account in the client app.
-   
-Calendar & Contacts Syncing - Thunderbird
-=========================================
-If you wish to use a standalone client for Calendar and Contacts, we recommend Mozilla's `Thunderbird <https://www.thunderbird.net>`_.
-
-1. Install the Contacts and Calendar apps in Nextcloud.
-2. Make sure you are on Thunderbird version 102.3.0 or greater and then import your LAN certificate:
-
-    - First, follow the :ref:`instructions for adding your Root CA to your system<ca-mac>` and then the :ref:`Thunderbird-specific instructions<lan-thunderbird>`.
-
-3. Download the `TBSync` and `Provider for CalDAV & CardDAV` add-ons by searching for them in the "Tools -> Add-ons and Themes" menu.
-4. Go back to "Tools -> Add-ons and Themes -> Extensions" and click the 'wrench' icon next to TBSync.
-5. Click "Account Actions" in the bottom left of the resulting screen, then "Add New Account -> CalDAV & CardDAV"
-6. Select "Automatic Configuration" and click `Next`
-7. Enter a name for your account, your nextcloud user name (found in Properties, default is 'admin'), password (found in Properties), and server LAN address (found in Interfaces, ending in `.local`) - then click "Next."
-8.  After connecting, click "Finish."
-9.  In the resulting window, click "Enable and synchronize this account."
-10. Select the items you want to sync, such as contacts and a calendar.
+6. That’s it! You may wish to set up some select folders for remote sync, but for large files, it is best to sync on LAN only, so you can “Skip folders configuration” on the resulting screen if you wish. Check your connection by clicking the newly created account in the client app.

site/source/guides/service-guides/nextcloud/nextcloud-setup/nextcloud-windows.rst

@@ -63,22 +63,4 @@ You will first need to have the :ref:`Tor daemon running<tor-windows>`.
 2. Close the Settings screen and click the account in the top left again, then "Add Account."
 3. On the following screen, click "Log in," then enter your Nextcloud Tor server address, which you can copy from Nextcloud -> Interfaces - Tor. This must start with `http://` and end with .onion. Click Next.
 4. This will launch your browser and prompt you to log in to your account. Log in and then grant access as we did for LAN.
-5. That's it! You may wish to set up some select folders for remote sync, but for large files, it is best to sync on LAN only, so you can "Skip folders configuration" on the resulting screen if you wish. Check your connection by clicking the newly created account in the client app.
-
-Calendar & Contacts Syncing - Thunderbird
-=========================================
-If you wish to use a standalone client for Calendar and Contacts, we recommend Mozilla's `Thunderbird <https://www.thunderbird.net>`_.
-
-1. Install the Contacts and Calendar apps in Nextcloud.
-2. Make sure you are on Thunderbird version 102.3.0 or greater and then import your LAN certificate:
-
-    - First, follow the :ref:`instructions for adding your Root CA to your system<ca-windows>` and then the :ref:`Thunderbird-specific instructions<lan-thunderbird>`.
-
-3. Download the `TBSync` and `Provider for CalDAV & CardDAV` add-ons by searching for them in the "Tools -> Add-ons and Themes" menu.
-4. Go back to "Tools -> Add-ons and Themes -> Extensions" and click the 'wrench' icon next to TBSync.
-5. Click "Account Actions" in the bottom left of the resulting screen, then "Add New Account -> CalDAV & CardDAV"
-6. Select "Automatic Configuration" and click `Next`
-7. Enter a name for your account, your nextcloud user name (found in Properties, default is 'admin'), password (found in Properties), and server LAN address (found in Interfaces, ending in `.local`) - then click "Next."
-8.  After connecting, click "Finish."
-9.  In the resulting window, click "Enable and synchronize this account."
-10. Select the items you want to sync, such as contacts and a calendar.
+5. That's it! You may wish to set up some select folders for remote sync, but for large files, it is best to sync on LAN only, so you can "Skip folders configuration" on the resulting screen if you wish. Check your connection by clicking the newly created account in the client app.