Updated thunderbird howto

Added meta information and licensing information
Updated pictures and gifs

pages/03.Cloud/04.Clients/01.Desktop/01.Multiplatform/01.thunderbird-calendar-contacts/docs.en.md

@@ -9,142 +9,177 @@ taxonomy:
         - docs
 ---
 
-The contact and calendar features in Disroot/Nexcloud are pretty cool but if you have your Disroot email connected to an email client like Thunderbird it's nice to have the contacts and calendars from Disroot integrated with Thunderbird as well and access them from one place on your desktop.
+---
 
----------
+# Meta information
+This howto was last updated on **08-04-2019** and it reffers to:<br>
+
+**- Thunderbird: version - 60.5.3.1 For Arch Linux**<br>
+**- Lightning Add-on: version 6.2.5.3**<br>
+**- CardBook Add-on: version 35.5**
+
+**NOTE:** If the howto refers to an older software version than the provided by **Disroot**, or the one you're using in your device, there could be missing features or small parts of the information that may have changed.<br><br>
+**Disroot**'s how-to documentation is a community driven process. We try to keep it as updated as we can.
+
+---
+
+The contact, calendar and tasks features in **Disroot Cloud** can be connected to an email client like Thunderbird allowing emails, contacts, tasks, calendar to be managed from one place in your desktop.
 
 
-# Installing Needed Add-ons
+# Installing the necessary Add-ons
 
-In order to sync all your calendars, tasks and contacts to thunderbird, you will need to install those Add-ons:
+In order to sync all your calendars, tasks and contacts to Thunderbird, you will need to install the following Add-on:
 
-* **Lightning** - a calendar for Thunderbird
-* **SoGo Connector**  -to sync you contacts
+- **CardBook**  -to sync you contacts
 
-**Note!** Even if you just want to sync your contacts you will still need the lightning add-on. So says the Nextcloud manual [here](https://docs.nextcloud.com/server/9.0/user_manual/pim/sync_thunderbird.html)
+- **Lightning** - is already pre-installed in Thunderbird (should be already installed by default in Thunderbird)
 
-## Installing Lightning
+**Install CardBook**
 
-In Thunderbird go to > tools > Add-ons
-![](en/thunderbird_1.png)
-In the Add-ons page on the upper right corner you will find a search bar. Just search for "Lightning". Once thunderbird finds it for you, press install.
+- Go to the **Display Thunderbird menu** button on the the upper right corner
+- Press the button **Add-ons**
+- Go to extentions on the left bar
+- You will find a search bar. Just search for **"Cardbook"**, when Thunderbird finds it, press install.
+- Restart Thunderbird
 
-![](en/thunderbird_2.png)
+![](en/01_thunderbird_install_addons.gif)
 
-You will need to restart Thunderbird in order to finish the installation of both Add-ons
-
-## Installing So Go Connector
-
-This Add-on is not listed in the Add-ons menu so we have to download it straight from the developers website [here](https://sogo.nu/download.html#/frontends)
-
-On the website select **"SoGo Connector"**. Then once downaloaded, go back to thunderbird's  Add-ons menu and select install from file option.
-
-![](en/thunderbird_3.png)
-
-Now select SoGo connector file (.xpi extension) you've just downloaded from the website.
-The following image should appear next, just press install
-
-![](en/thunderbird_4.png)
-
-For both Add-ons to finish their installations you will need to restart Thunderbird
+If for some reason you don't have the **Lightning** add-on pre-installed in Thunderbird. You can follow the the same process as above to install it.
 
 
 # Integrating calendar with Thunderbird
 
-First login to your [Disroot cloud](https://cloud.disroot.org) and go to calendar app. Select options of the calendar you want to sync to thunderbird.
-Now, copy the link URL of your calendar. You will need it to sync with thunderbird.
+First login to your **[Disroot cloud](https://cloud.disroot.org)**
+- Go to calendar app
+- Select the calendar you want to sync to Thunderbird.
+- Press the **"three dots"** button to the right of the calendar
+- Press **"Link"** and copy the link URL of your calendar. You will need it to sync with Thunderbird.
 
- ![](en/thunderbird_6.png)
 
-Now in Thunderbird. Either go to: File > New > Calendar or go directly to Calendar window and select *"New calendar"* by right clicking on the calendar list.
+![](en/02_thunderbird_copy_calender_link.gif)
 
-![](en/thunderbird_7.png)
 
-Now configure your calendar to sync:
-1- select the option **CalDAV**
-2 - In the location field, paste the link of your Disroot Calendar that you copied earlier
-3 - Select offline support, if you want to keep a local copy of you calendar, in case you need to work offline
-4 - Press next
-![](en/thunderbird_8.png)
+Now in Thunderbird:
+- Go to Calendar or go directly to Calendar window and
+- Select **"New calendar"** by right clicking on the calendar list with the mouse on the calendar list.
 
-Give your calendar a name and assign a color.
-Then press next.
+![](en/01_add_new_calendar.png)
 
-![](en/thunderbird_9.png)
+Now configure your new calendar to sync with your remote calendar:
+- Select the option **"On the Network"**
+- Select the option **CalDAV**
+- In the location field, paste the link of your **Disroot** Calendar that you copied earlier
+- Select offline support, if you want to keep a local copy of you calendar, in case you need to work offline
+- Press next
+- Give your calendar a name and assign a color.
+- Then press **Next** and them **Finish**.
 
-Then press finish.
-Your calendar is now synced with Thunderbird. Any event created in thunderbird will apear on disroot cloud and vice versa.
+![](en/03_setup_calendar.gif)
 
-![](en/thunderbird_10.png)
+You will be prompted for your credentials:
+- **Username:** *Your_Disroot_username*
+- **Password:** *Your_super_secret_Disroot_password*
+
+- Select the option **"Use password manager to remember this password"** (so you don't get asked for it every time you connect)
+- Press **"OK"**
+
+![](en/02_calendar_credentials.png)
+
+Your calendar is now synced with Thunderbird. Any event created in Thunderbird will appear on **Disroot Cloud** and vice versa.
+
+![](en/03_calendar_is_synced.png)
+
+**Note:** If you have multiple calendars in your **Disroot** account, just repeat this process for each calendar. You can use a different color to each calendar to set them apart. This method works for any Nextcloud provider out there.
+Additionally you can sync any calendars form any provider as long as they support caldav protocol (check with your provider for more details).
 
-**Note!**
-If you have multiple calendars in your Disroot account, just repeat this process for each calendar. You can use a different color to each calendar to set them apart. This method works for any nextcloud/owncloud provider out there.
-Additionally you can sync any calendars form any provider as long as they support caldav protocol (check with your provider for more details)
 
-![](en/thunderbird_11.png)
 
 ## Adding events with multiple calendars
 If you have multiple calendars in Thunderbird, when creating an event you need to to select to which calendar it goes to, otherwise you maybe end up looking for it online in the wrong place
 
-![](en/thunderbird_12.png)
+![](en/04_events_multiple_calendars.png)
 
-If you right click the calendars in Thunderbird you will have a set of options, from:
 
-* Show or hide a Calendar
-* Export Calendar
-* Unsubscribe Calendar (remove it from Thunderbird)
-* Making it read only (in Thunderbird)
-* Synchronize Calendar  
+## Extra options
+If you right click the calendars in Thunderbird you will have a set of options:
+
+- Show or hide a Calendar
+- Export Calendar
+- Unsubscribe Calendar (remove it from Thunderbird)
+- Making it read only (in Thunderbird)
+- Synchronize Calendar  
+
+![](en/05_extra_options.png)
+
+# Tasks - Integration with with Thunderbird
+Tasks are automatically synchronized when you integrate a calendar with Thunderbird.
+
+Any task you create in Thunderbird assigned to the calendar in question will be synchronized to your **Disroot Cloud Tasks app**. And vice versa.
 
-![](en/thunderbird_13.png)
 
 # Contacts - Integration with Thunderbird
 
-The process is similar to the integration of Calendars in Thunderbird. First you need to get the link from the contacts in your Disroot account.
+The process is similar to the integration of calendars in Thunderbird. First you need to get the link from the contacts in your **Disroot** account.
 
-Go to the contacts app in Disroot webapp, then go to settings ('gear' icon in the bottom left-panel).Select the share "url button" so that it presents you with a link.
-Copy that link and save it, you will need it later.
+- Go to the contacts app in **Disroot Cloud**
+- Go to settings ('gear' icon in the bottom left-panel)
+- Select the **three dots** button on the right of the address book you want to synchronize
+- Press **"Copy link"**
 
-![](en/thunderbird_contacts-1.png)
-
-In Thunderbird, select Tools > Address Book
-![](en/thunderbird_contacts-2.png)
-
-Then select: File > New > Remote Address Book
-
-![](en/thunderbird_contacts-3.png)
-
-In the next panel you will be asked to set the name and url:
-
-* The name is the name you want to give to your address book in thunderbird
-* The url is the link that you got earlier from the contact app in Disroot
-
-In this same panel
-You can set the periodic syncing to 5 minutes (the default is 15 minutes)
-You can set the contacts to read only if you want to (but if you do that you wont be able to edit the contacts in Thunderbird)
-
-When you are done press "ok"
-
-![](en/thunderbird_contacts-4.png)
-
-Right click your new remote address book and select Synchronize
-
-![](en/thunderbird_contacts-5.png)
-
-You will be prompted to insert your Disroot account credentials
-Username: your Disroot Username
-Password: your Disroot password
-
-Select the option: **"Use password manager to remember this password"** so that Thunderbird remembers the password and doesn’t ask for it every time you use Thunderbird
-
-Then press **"ok"**
+The link was saved to your machine clipboard, save it, you will need it later.
 
 
-Your contacts in your Disroot account are now synced with the remote contacts address book you created in Thunderbird
+![](en/04_copy_contact_link.gif)
+
+In Thunderbird
+- Select CardBook (In the upper bar)
+- Right click and select **"New Address Book"**
+- Select **"Remote"**, and press **"Next"**
+- Select **"CardDav"**
+- In **"URL"**, paste the link to the remote Address Book
+
+Fill your credentials:
+- **Username:** *your_Disroot_username*
+- **Password:** *your_Disroot_Account_Password*
+
+- Press **"Validate"** to check if the credentials are correct. (you cannot finish the process without this step)
+- Press **"Next"**
+
+![](en/05_setup_address_book.gif)
+
+Next you will be asked:
+- Select the Address Book you want to sync
+- You can change the mane of the Address Book (only affects Thunderbird)
+- Set a color for it. In case you have several Address Books, might be a good idea to use different colors.
+
+- Select **"Work Offline"** if you want a copy of the Address Book to be stored locally in Thunderbird
+- Press **"Next"**, and then **"Finish"**
 
 
-Any contacts you add/remove/edit in your Disroot account will be altered accordingly in your Thunderbird remote calendar and vice versa.
+![](en/06_finish_contacts_setup.png)
 
-If you want to move contacts from your Thunderbird Personal Address Book or Collected Addresses to your new remote address book so that they sync to your Disroot contacts, just select and drag the contact to your remote address book.
+Your contacts in your **Disroot Cloud** contacts app are now synced with the remote contacts address book you created in Thunderbird
 
-However it is advised that you create backups of your contacts. Just in case :wink:
+![](en/07_show_book_1.png)
+
+![](en/08_show_book_2.png)
+
+Any contacts you add/remove/edit in your **Disroot Cloud** account will be altered accordingly in your Thunderbird remote calendar and vice versa.
+
+Synchronization between the local and remote calendar happens every few minutes.
+
+But you can force a synchronization by:
+- Right click on the calendar in question in Thunderbird
+- Press **"Synchronize Address Book"**
+
+If you want to move contacts from your Thunderbird Personal Address Book or Collected Addresses to your new remote address book:
+
+- Select and drag the contact to your remote address book.
+
+However it is advised that you create backups of your contacts.
+
+---
+
+ <center><a rel="license" href="http://creativecommons.org/licenses/by- sa/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by-sa/4.0/88x31.png" /></a><br />This work is licensed under a <br><a rel="license" href="http://creativecommons.org/licenses/by-sa/4.0/">Creative Commons Attribution-ShareAlike 4.0 International License</a>.</center>
+
+---