Tasks App update

pages/02.tutorials/02.Cloud/04.Apps/01.Tasks/01.Web/docs.en.md

@@ -1,11 +1,11 @@
 ---
-title: Tasks: Web
+title: 'Tasks: Web'
 published: true
 visible: false
 updated:
-        last_modified: "July 2019"
+        last_modified: "October 2020"
         app: Nextcloud
-        app_version: 15
+        app_version: 18
 taxonomy:
     category:
         - docs
@@ -17,37 +17,77 @@ page-toc:
     active: false
 ---
 
-## Tasks on web-interface
-
-The Tasks app allows you to add and delete tasks. A task could be a meeting date reminder, a job that needs to be done, a personal or a group activity and a lot of other things.<br> In this howto we'll see how to create, edit and share tasks.
+# Tasks
 
 ![](en/main.png)
 
-#### Adding a new task
-Click in the item box and enter the name of the new task.
+The **Tasks** app allows you to add and delete tasks, edit their title, description, start and due dates and mark them as important. A task could be a meeting date reminder, a job that needs to be done, a personal or a group activity and a lot of other things.
 
-![](en/add_task_box.png)
+In this short howto we'll see how it works.
+
+# Adding a new task
+To start, click on **+ Add list...**, write the name of your new list of tasks and press enter.
+
+![](en/add_task.gif)
 
 Once you did it, a new section will show at the right.
 
-![](en/add_tasks.png)
+![](en/add_tasks_window.png)
 
-Here you can set:
+Type in the name of the new task you want to add and then press enter. Click on the three-dots icon at the right if you want to add subtasks.
 
-- **The start date and due date**
+![](en/add_tasks.gif)
 
-![](en/add_tasks_date_01.png) ![](en/add_tasks_date_02.png)
-By clicking on the Start/Due option you can set the day and the hour of it. You can also set the task as an all day activity
+## Tasks options
+Click on the task or subtask title to access the options.
 
+![](en/tasks_options.png)
 
-- **The priority of the task**
+Here you can:
 
-![](en/add_tasks_priority.png)
-By moving the bar, you can set the priority level from 1 to 9.
+- **Set the start date and due date**<br>
+By clicking on the Start/Due option you can set the day and the hour of it.
 
-- **Set and edit the progress level of the task**
+  ![](en/start_due_date.gif)
 
-![](en/task_completed.png)
-By moving the bar, you can set the task progress from 0% to 100%.
+  You can also set the task as an all day activity.
 
-- **Tags**
+  ![](en/all_day.png)
+
+- **Assign / change the tasks list**<br>
+  You can change / assign a task or sub-task to different lists or calendar. Just select one from the drop-down menu and the tasks will change to the new one.
+
+  ![](en/assign_list.gif)
+
+- **Select a classification**<br>
+  You can assign the task list to a previously created calendar and choose how it should be shown.
+
+  ![](en/show.png)
+
+- **Select a status**<br>
+  Select if the task **needs an action**, if it is **in process**, **completed** or **cancelled**.
+
+  ![](en/status.gif)
+
+- **Assign a priority level to the task**
+  By moving the bar, you can set the priority level where 1 to 4 is **High**, 5 is **Medium** and 6 to 9 is **Low**.
+
+  ![](en/priority.gif)
+
+- **Set and edit the progress level of the task**<br>
+  By moving the bar, you can set the task progress from 0% to 100%.
+
+  ![](en/progress.gif)
+
+- **Categories and Comments**<br>
+  Assigning categories and adding comments can be very useful when working in a group. Click on **Select categories**, select or create one and press Enter. To write a comment, simply type it in the box.
+
+  ![](en/categories_comments.gif)
+
+  When the task has a category assigned or a comment added, you can see it in the description, next to the title.
+
+  ![](en/categories_comments.png)
+
+- Finally, at the bottom of the tasks details you will see a bar with the delete and info options.
+
+  ![](en/info.png)

pages/02.tutorials/02.Cloud/04.Apps/01.Tasks/02.Desktop/docs.en.md

@@ -1,9 +1,9 @@
 ---
-title: Tasks: Desktop
+title: 'Tasks: Desktop'
 published: true
 visible: false
 updated:
-        last_modified: "July 2019"
+        last_modified: "October 2020"
 taxonomy:
     category:
         - docs
@@ -15,13 +15,13 @@ page-toc:
     active: false
 ---
 
-## Tasks desktop Integration
+## Tasks on the desktop
 
-You can read the tutorials below in order to get your **Tasks** synchronized via a multi-platform desktop client.
+There are several ways you can sync and work with **Nextcloud Tasks** from your desktop. Below you will find some tutorials to get it.
 
-- [Thunderbird: Calendar / Contacts / Tasks sync](/tutorials/cloud/clients/desktop/multiplatform/thunderbird-calendar-contacts)
+### Multi-platform desktop clients
+ - [Thunderbird: Calendar / Contacts / Tasks sync](/tutorials/cloud/clients/desktop/multiplatform/thunderbird-calendar-contacts)
 
-Alternatively, you can use and set up the desktop integration.
-
- - [GNOME: Desktop Integration](/tutorials/cloud/clients/desktop/gnu-linux/gnome-desktop-integration)
- - [KDE: Desktop Integration](/tutorials/cloud/clients/desktop/gnu-linux/kde-desktop-integration)
+### GNU/Linux
+ - [GNOME Desktop Integration](/tutorials/cloud/clients/desktop/gnu-linux/gnome-desktop-integration)
+ - [KDE Desktop Integration](/tutorials/cloud/clients/desktop/gnu-linux/kde-desktop-integration)

pages/02.tutorials/02.Cloud/05.Clients/01.Desktop/01.Multiplatform/01.thunderbird-calendar-contacts/docs.en.md

@@ -2,9 +2,9 @@
 title: 'Thunderbird: Syncing Contacts, Calendars and Tasks'
 visible: false
 updated:
-        last_modified: "08 April 2019"
+        last_modified: "October 2020"
         app: Thunderbird
-        app_version: 60.5.3.1 for Arch Linux / Lightning Add-on, version 6.2.5.3 / CardBook Add-on, version 35.5
+        app_version: 68.12.0 on Manjaro Linux
 page-toc:
   active: true
 published: true
@@ -19,156 +19,218 @@ taxonomy:
         - contacts
 ---
 
-# Syncing Contacts, Calendars and Tasks with Thunderbird
+# Thunderbird...
+... is a free and open-source multi-platform email client and personal information manager with news, RSS and chat client integrated.<br>
+We will learn how to connect your **Cloud** contacts, calendars and tasks to **Thunderbird** in order to manage them from one place in your desktop.
 
-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 Thunderbird
+If you do not have it installed, go to [**Thunderbird** page](https://www.thunderbird.net/en-US/) and select the download for your operating system and language. Additionally, if you use a GNU/Linux based operating system you will almost certainly find it in the software manager of your distribution.
 
 
-# Installing the necessary Add-ons
+# Configuring a calendar
+## 01. Getting the calendar address
+To configure a calendar in **Thunderbird**, you will need to know its address first.
 
-In order to sync all your calendars, tasks and contacts to Thunderbird, you will need to install the following Add-on:
+- Login to the **[Cloud](https://cloud.disroot.org)**
+- Go to the **Calendar** app
 
-- **CardBook**  -to sync you contacts
-- **Lightning** - is already pre-installed in Thunderbird (should be already installed by default in Thunderbird)
+ ![](en/calendar_select.png)
 
-**Install CardBook**
+- Select or create a calendar you want to sync.
+- Press the **"three dots"** button to the right of the calendar.
 
-- 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/calendar_select_02.png)
 
-![](en/01_thunderbird_install_addons.gif)
+- Press **Copy private link**. The address will be saved in the computer's clipboard.
 
-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.
+ ![](en/copy_link.png)
+
+- You will see the next message:
+
+  ![](en/link_copied.png)
+
+A good way to verify that we have the URL copied properly would be to paste it into a notepad, check it and save it. With this first step completed, we will now move on to configure **Thunderbird**.
+
+## 02. Configuring Thunderbird
+- Click on the **Calendar** icon at the top right.
+
+  ![](en/tb_calendar_01.png)
+
+- Right click on the calendar list and select **New calendar**.
+
+  ![](en/tb_calendar_02.png)
+
+- **Create New Calendar** process will start. Select **On the Network** (the calendar is stored in the cloud).
+
+  ![](en/tb_calendar_03.png)
+
+- Select the **CalDAV** format and enter your username.
+
+  ![](en/tb_calendar_04.png)
+
+- In the **Location** field, paste the link of your **Disroot Calendar**, the one you previously copied from the **Cloud**. Select **Offline Support** if you want to keep a local copy of your calendar to work offline. Press **Next**.
+
+  ![](en/tb_calendar_05.png)
+
+- Give a name to your calendar. You can also assign it a color and enable/disable reminders.
+
+  ![](en/tb_calendar_06.png)
+
+- Then press **Next** and then **Finish**.
+
+  ![](en/tb_calendar_07.png)
+
+- You will be prompted for your credentials:
+  - **Username:** *Your_Disroot_username*
+  - **Password:** *Your_Disroot_password*
+  - You can 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/tb_credentials.png)
+
+Your calendar is now synced with **Thunderbird**. Any event created in it will appear on **Disroot Cloud** and vice versa.
+
+- ![](en/calendar_sync.png)
+
+!! #### Tip<br>
+!! 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 identify them. This method works for any **Nextcloud** provider.<br>
+!! Additionally you can sync any calendars from any provider as long as they support **CalDAV** protocol (you can check with your provider for more details).
+
+## 03. Adding events
+- Right click on the date you want to add an event.
+
+  ![](en/add_event_01.png)
+
+- The **New Event** window will open. Now you can assign a name to the event.
+
+  ![](en/add_event_02.png)
+
+- Add or create a category for the event.
+
+  ![](en/add_event_03.png)
+
+- Select to which calendar the event goes to (useful in case you have multiple calendars and you want to avoid end up looking for it online in the wrong place).
+
+  ![](en/add_event_04.png)
+
+- You can also set:
+  - If it is an **All day Event**.
+  - The **Start** and **End** of the event.
+  - If you want/need the event to be repeated and how often.
+  - Set a reminder for the event.
+  - Add a description, attachments or the attendees' names if it is a meeting, for example.
+
+  ![](en/add_event_05.png)
+
+Once you've done, click **Save and Close**.
+
+  ![](en/event_added.png)
+
+### Additional options
+If you right click a calendar you will find a set of options:
+
+- Show/Hide Calendars.
+- New Calendar... (To add a new one).
+- Unsubscribe Calendar... (To remove it from **Thunderbird**).
+- Export Calendar...
+- Publish Calendar...
+- Synchronize Calendars.
+- Properties of a Calendar.
+
+  ![](en/additional_options.png)
+
+# Tasks
+Tasks are automatically synchronized when you integrate a calendar into **Thunderbird**.<br>
+Any task you create in **Thunderbird** assigned to a calendar will be synchronized to your **Cloud Tasks** app and vice versa.
+
+# Contacts
+To integrate your **Cloud** contacts into **Thunderbird** you will first need to install an add-on called **CardBook**.
+
+## 01. Installing CardBook addon
+- Go to **Tools** and select **Add-ons**.
+
+  ![](en/cardbook_01.png)
+
+- In the **Find more extensions** field write **cardbook** and press Enter.
+
+  ![](en/cardbook_02.png)
+
+- Select the **CardBook** add-on and add it to **Thunderbird**.
+
+  ![](en/cardbook_03.png)
+
+ **Thunderbird** will download the add-on, ask if you want to add it and finally ask you to restart.
+
+  ![](en/cardbook_addon.png)
+
+## 02. Adding a remote Address Book
+The process is pretty similar to the calendars integration. First you need to get the link from the contacts in your **Disroot** account.
+
+### Getting the Address Book URL
+- Go to the **Contacts** app in the **Disroot Cloud** (1)
+- Then go to the **Settings** (2) (the 'gear' icon in the bottom left-panel) and click on the **three dots** button on the right of the address book you want to synchronize.
+
+  ![](en/contact_address.png)
+
+- Select **Copy link**.
+
+  ![](en/link_menu.png)
+
+The URL is now copied in your computer clipboard and, as it was suggested before, it is better to save it, you will need it in the next step.
 
 
-# Integrating calendar with Thunderbird
+### Configuring Contacts
+- Click **CardBook** in the email tools bar.
 
-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/tb_contacts_cbook.png)
 
-![](en/02_thunderbird_copy_calender_link.gif)
+- Right click and select **New Address Book**
 
-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.
+  ![](en/tb_contacts_new_book.png)
 
-![](en/01_add_new_calendar.png)
+- Select **Remote** and press **Next**
 
-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**.
+  ![](en/tb_contacts_remote.png)
 
-![](en/03_setup_calendar.gif)
+- Select **CardDAV** and paste the remote address book you copied before in the **URL** field.
 
-You will be prompted for your credentials:
-- **Username:** *Your_Disroot_username*
-- **Password:** *Your_super_secret_Disroot_password*
+  ![](en/tb_contacts_cardav.png)
 
-- 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 it 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).
+- Enter your credentials
+  - **Username:** *your_Disroot_username*
+  - **Password:** *your_Disroot_Password*
 
 
+- Press **Validate** to check if the credentials are correct (you cannot finish the process without this step)
+- Once the credentials are validated, press **Next**
+- Now you can
+  - change the name of the Address Book
+  - set a color for it
+  - and select to **Work Offline** if you want a copy of the Address Book to be stored locally.
 
-## 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/tb_contacts_properties.png)
 
-![](en/04_events_multiple_calendars.png)
+- Press **Next** and then **Finish**.
 
+ ![](en/tb_contacts_finish.png)
 
-## Extra options
-If you right click the calendars in Thunderbird you will have a set of options:
+Your contacts in your **Cloud** are now synced with the **Thunderbird** address book.
 
-- Show or hide a Calendar
-- Export Calendar
-- Unsubscribe Calendar (remove it from Thunderbird)
-- Making it read only (in Thunderbird)
-- Synchronize Calendar  
+ ![](en/tb_contacts_synced.png)
 
-![](en/05_extra_options.png)
+From now on, any contacts you add/remove/edit in the **Cloud** will be altered accordingly in your **Thunderbird** remote calendar and vice versa.
 
-# Tasks - Integration with Thunderbird
-Tasks are automatically synchronized when you integrate a calendar with Thunderbird.
+### Synchronization
+The synchronization between the local (**Thunderbird**) and the remote calendar (**Disroot Cloud**) happens every few minutes. But you can force it doing:
 
-Any task you create in Thunderbird assigned to the calendar in question will be synchronized to your **Disroot Cloud Tasks app**. And vice versa.
+- Right click on the calendar in question in **Thunderbird**. You will find a large set of options. Select **Synchronize Address Book**.
 
+  ![](en/tb_sync.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.
-
-- 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"**
-
-The link was saved to your machine clipboard, save it, you will need it later.
-
-
-![](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 name 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"**
-
-
-![](en/06_finish_contacts_setup.png)
-
-Your contacts in your **Disroot Cloud** contacts app are now synced with the remote contacts address book you created in Thunderbird
-
-![](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:
+If you want to move contacts from your **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.
+ ![](en/contacts_drag.png)
+
+!! **It is highly recommended that you do not forget to backup your contacts from time to time.**