Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Integrate with Nextcloud CalDAV API [$185] #15

Closed
juliusknorr opened this issue Feb 1, 2017 · 61 comments
Closed

Integrate with Nextcloud CalDAV API [$185] #15

juliusknorr opened this issue Feb 1, 2017 · 61 comments

Comments

@juliusknorr
Copy link
Member

juliusknorr commented Feb 1, 2017

This issue is about integrating deck with Nextclouds CalDAV API.

Current plan from the discussion below:

Deck CalDAV Tasks
Board VCALENDAR List
Stack VTODO without RELATED-TO property Root-Task
Card VTODO with RELATED-TO (UUID of the Root-Task / Stack) Subtask
Tags CATEGORIES or custom implementation (Nextcloud tagging system) Currently uses CATEGORIES, integration with Nextcloud tags would be better, see nextcloud/tasks#89
Assigned users ATTENDEE or custom implementation ATTENDEE or custom implementation, see nextcloud/tasks#72
Recurring stacks & cards RRULE Recurring tasks & subtasks, see nextcloud/tasks#34
Attachments ATTACH or custom implementation ATTACH or custom implementation, see nextcloud/tasks#91

Tags, assigning users, attachments and recurrence is not supported by Tasks yet either, but it would make much sense to implement these features. And if we see that it is not really possible to implement this with pure CalDAV I would be open to implement it without syncing it via CalDAV and have it only available in the webinterface. This would still be better than not having it at all in Tasks and would not limit Deck.

  1. Expose deck boards as VCALENDAR, try to map as much data from deck to the VTODO (read only access) Expose boards as calendars #1545
  2. Allow updating VCALENDAR entries, try to map as much as possible from vtodo to the deck database and store the rest as plain vtodo data, so we can still push it out over CalDAV (write access) Write access over CalDAV #2399
  3. Deck data could be moved to the DAV backend.
@joergmschulz
Copy link

joergmschulz commented Feb 1, 2017

as sharing the cards is essential, a log of changes to

Activities

would be nice.

@poVoq
Copy link

poVoq commented Feb 19, 2017

Would it be possible to have a common due date that is linked with the calendar as a shared event between multiple cards as a "milestone" with its own colored label displayed on the card? I.e. some sort of way to link labels to CalDav events?

@poVoq
Copy link

poVoq commented Feb 19, 2017

Another possible integration would be to link cards to CalDAV task categories, so that if a user creates a new CalDAV task in an external application (lets say OpenTasks on Android) and chooses the right category for it, Deck automatically uses the name of that category to sort it to the card with the same name.

@juliusknorr
Copy link
Member Author

I thought a lot about how to integrate with the Nextcloud WebDAV/CalDAV/CardDAV interfaces, it will be not as simple as i initially thought. I'll take some time next week to write up what i had in mind and publish some kind of roadmap. 😉

@simonpostma
Copy link

If subtasks become a thing in Deck, it can easily compete with whatever kanban system out there. Keeping the syncing with Tasks optional would be great imo.

Perhaps a functionality to make multiple decks if that is possible?

@9662
Copy link

9662 commented Feb 26, 2017

XMPP group-chat notifications for activities would be also nice.

It is a reasonable idea, but it belongs to the notifications part of Nextcloud, not to Deck.

Would it be possible to have a common due date that is linked with the calendar as a shared event between multiple cards as a "milestone" with its own colored label displayed on the card? I.e. some sort of way to link labels to CalDav events?

Reinventing the bug tracker? They're supposed to complement, not duplicate each other. You can probably do this already via webhooks from your bug tracker anyway.

@poVoq
Copy link

poVoq commented Feb 26, 2017

@9662:
Regarding the first comment: maybe, but you might not want to spam your group-chat with all the file etc. changes, while deck and task updates might be more interesting.

Regarding the second: no, what have milestone dates to do with a bug-tacker? I think it is worth to have common event linked date labels on the cards so that it is quickly visible to the users what kind of common deadlines might be related to which cards.

@juliusknorr
Copy link
Member Author

nextcloud/server#2829 will allow apps to register custom sabre plugins, if this is in we could create our own CalDAV endpoint at /dav/deck that will allow users to subscribe to within their calendar apps.

Here is a short summary of what I planned for that endpoint:

  • A board should exposed as a VCALENDAR
  • Cards will be exposed as VTODO
  • Due dates can be added and exposed as VEVENT
    My first plan was to just add the due dates to existing calendars, but it looks like there is no easy way to do that at the moment. Also there are to many issues with calendar permissions and adding to much complexity, so I think the above proposed solution will be the best way.

Another possible integration would be to link cards to CalDAV task categories, so that if a user creates a new CalDAV task in an external application (lets say OpenTasks on Android) and chooses the right category for it, Deck automatically uses the name of that category to sort it to the card with the same name.

@poVoq That should be possible with the above solution.

Would it be possible to have a common due date that is linked with the calendar as a shared event between multiple cards as a "milestone" with its own colored label displayed on the card? I.e. some sort of way to link labels to CalDav events?

@poVoq This is a far more advanced feature. Let's just focus on the basics for now.

If subtasks become a thing in Deck, it can easily compete with whatever kanban system out there. Keeping the syncing with Tasks optional would be great imo.

@simonpostm That should not be a problem, if there will be a dedicated dav endpoint for the deck app.

Perhaps a functionality to make multiple decks if that is possible?

@simonpostma Not sure if I understand that correctly. Can you describe that a bit more?

XMPP group-chat notifications for activities would be also nice.

It is a reasonable idea, but it belongs to the notifications part of Nextcloud, not to Deck.

👍

Hope I didn't forgot to comment on something. 😉

@simonpostma
Copy link

simonpostma commented Mar 4, 2017

@juliushaertl

I uninstalled Deck because i need my kanban to have more features at this point in time (cant wait for the next update so i can drop my current Kanban service and start using Deck :D), hasty as i was i didn't remember that Deck already has the feature to make multiple boards. Sorry for that.

@simonpostma
Copy link

Is there any ETA on the next update? Not trying to pressure you, just can't wait to exchange kanbanflow with Deck

@juliusknorr
Copy link
Member Author

Sorry for the delay, I've been quite busy this week. It is on my list for the upcoming week.

@simonpostma
Copy link

It's clear you're very busy. Do take your time! I'll be looking to donate some to you after it's released.

@andreasjacobsen93
Copy link
Member

I think we should explore more how deck and tasks can be integrated? I think it could result in some really valuable features.

@poVoq
Copy link

poVoq commented Jul 5, 2017

Any update on the CalDAV tasks and calendar integrations?

@e-alfred
Copy link

e-alfred commented Aug 6, 2017

Would a Deck webdav endpoint be automatically added to the Calendar/Tasks app or do users have to manually add them?

@juliusknorr juliusknorr changed the title Integration with other Nextcloud apps Integration with other Nextcloud apps [$100] Sep 27, 2017
@juliusknorr
Copy link
Member Author

nextcloud/server#2829 will allow apps to register custom sabre plugins, if this is in we could create our own CalDAV endpoint at /dav/deck that will allow users to subscribe to within their calendar apps.

I've just updated the PR to nextcloud/server#6835 to get this moving again.

Would a Deck webdav endpoint be automatically added to the Calendar/Tasks app or do users have to manually add them?

The only issue I see after digging a bit into the sabredav/Nextcloud dav code is, that we cannot easily add the boards to the list of a users calendars. Maybe we need some API for that on the server side. Without that you would need to add it manually.

@juliusknorr juliusknorr changed the title Integration with other Nextcloud apps [$100] Integrate with Nextcloud DAV API [$100] Oct 14, 2017
@juliusknorr juliusknorr changed the title Integrate with Nextcloud DAV API [$100] Integrate with Nextcloud CalDAV API [$100] Oct 14, 2017
@juliusknorr
Copy link
Member Author

I took some time to dig into the Nextcloud dav app. Here are some notes about the planned implementation. Feedback is very welcome.

Implementation

  • Extend classes from \OCA\DAV\CalDAV (CalendarRoot, Calendar, Home, Calendar, CalendarObject, CalDavBackend)

  • With Let apps register Sabre plugins or collections (v2) server#6835 register our own sabre collection

  • add a collection at /deck with calendar collections at /deck/user/deck-1

  • add VTODO entries for every card there

  • Showing them in the calendar is part of the caldav client (Thunderbird already has an option for that)

  • We should have an additional field for every card to store vtodo properties we don't have mapped to card values (and show them in the ui, like PERCENT-COMPLETE, PRIORITY

Mapping VTODO -> Card

  • DUE: duedate
  • SUMMARY: title
  • DESCRIPTION: text
  • CATEGORY: tags
  • STATUS: archived/unarchived
  • URL: url to the card

Open issues to discuss

calendar-home-set

Calendar collections cannot be added to the principals calendar-home-set. Maybe we need to extend Nextclouds CalendarHome::getChildren so apps can add their own entries to the home collection

Stack representation

Since nested calendar collections are not possible (something like deck-1/stack-1/card-1.ics) are not possible, we still need to figure out how we can represent the current stack in the caldav representation:

  • we could just obmit it, users can then access their cards for now but not move them between stacks (that is what i would prefer for now)
  • we could create a calendar collection for each stack ( deck-1-stack-1/ deck-1-stack-2/) but that would lead to a huge amount of calendars that would appear in the caldav clients ui
  • We could use the category property, but that should imo be used for tags.

@slowhand93
Copy link

First of all: thanks for your work Julius! I love Deck.

Regarding stack representation:
I would prefer your second option because I use Deck to organize my days/weeks. So I often move cards between stacks. When I'm understanding you right, this wouldn't be possible if I will use the caldav feature?!

@poVoq
Copy link

poVoq commented Oct 16, 2017

Hmm... while not perfect, it might be doable to represent stacks via the priority value as usually the stacks are related to some sort of todo, backlog etc. system that is similar to priorities.

@juliusknorr
Copy link
Member Author

@poVoq That could be a solution, either that or maybe we abuse the LOCATION field which is a string value so we could at least show the stacks name.

@juliusknorr

This comment has been minimized.

@laurentiu2
Copy link

laurentiu2 commented May 28, 2020

didn't I moved it once?
50685757-26101a00-1023-11e9-8002-17d38f0c4962

maybe showing all calendars as a drop-down list?

@animorphcoop
Copy link

Thanks to everyone for continuing the development, we've just made a contribution via Bountysource supporting Deck&Calendar integration!

@juliusknorr
Copy link
Member Author

Hey there,

I'd just like to let you know that due to the ongoing issue with Bountysource we're discussing ways to move to a different platform. As it looks right now, Bountysource might claim some of the money that was contributed by the community. We will try our best to prevent that. Historically we – the Nextcloud GmbH employees – simply put the claimed bounties back to other tickets until one was solved by a community member. So the money was always from the community and for the community. We'll therefore move to a better platform and currently don't post any new bounties until this situation is resolved. The current goal is to move/donate the money to Nextcloud include but details will follow in the forum post.

Hope this makes sense. If you have any questions please ask them on the forum. This comment will be copy-pasted to all open issues with bounties.

@makayabou
Copy link

Will wait for it to send a bounty, then. thanks

@rfc2822
Copy link

rfc2822 commented Oct 5, 2020

I have just tested CalDAV read access and it works fine with DAVx5!

Just wanted to now that on Android / with the OpenTasks API, task lists can't be set as write-only (yet): dmfs/opentasks#851

So people can edit/modify tasks locally, but the changes can't be synchronized to the server. → Write access over CalDAV would be really nice 😏

@juliusknorr
Copy link
Member Author

Moved out #2399 for the write support so we have an individual ticket to track this.

@juliusknorr juliusknorr removed this from the 1.2.0 milestone Oct 8, 2020
@q-wertz
Copy link
Contributor

q-wertz commented Oct 15, 2020

Didn't find this in the discussions and not sure if it is worth an issue.
So far all the tasks of a Deck where one is participant are published as ToDo. Wouldn't it be more straight forward to only see the tasks one is assigned to?
It makes it quite confusing to have now dozen of Tasks one is not assigned to.

@alphashuro

This comment has been minimized.

@stefan-niedermann

This comment has been minimized.

@juliusknorr
Copy link
Member Author

Closing this as the first integration part is done and we will track write access in #2399

@devvv4ever
Copy link

Having a CalDAV integration is crucial for us, so I was thinking a little bit about the integration... In Oct 2017 you guys were discussing about whether or not categories should be used for stacks. I'd strongly vote for it.

The reason is that you should keep in mind how a client, that isn't aware of a Kanban-style tasks list, would represent these tasks. Just think of the "demo board":

demo board

Creating a VTODO per card would create the tasks "Write a press release", "Take nice screenshots", "Write a blog" and "Think of a slogan". This is without any doubt what a user would expect. But also creating a VTODO per stack would also create the tasks "Todo", "In progress" and "Done". What are these tasks supposed to represent? Those tasks can't be assigned to anyone, they can't ever be completed, because that's not what stacks are for, and they will dangle around in every other CalDAV client.

Just a small addition here: why not considering implementing https://tools.ietf.org/html/rfc5545#section-3.6.3 VJOURNAL for such things? VJOURNAL is part of the CalDAV API and it can be used more straightforward as a note or a "simple" task without the need of an end-date or progress. With the RELATED-TO field they could be assigned to an existing VEVENT or VTODO. We hope to get VJOURNAL synchronization into DAVx5 in the future. We want to get that into a supporting app that can display VTODO and VJOURNAL at the same time.

@HLFH
Copy link

HLFH commented Apr 20, 2021

@devvv4ever Create a feature request?

@PhrozenByte
Copy link

@HLFH See #2399 (comment), it's an implementation detail of this partially implemented feature, i.e. no separate feature request.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests