Status overview

[rullzer]

Summary

It would be nice if in your Nextcloud you could relay your own status to other users. So they know what you are doing.

Details

A lot of modern communication platforms have statuses. Something like that would be useful for Nextcloud as well. That way you can signal that you are busy, on holiday, on site somewhere etc.

To be extended

API

Details

DB:

1. New table: user_status

• id (unsigned int, not null, autoincrement)
• user_id (string, not null)
• status_type (string, not null) => available, busy, unavailable
• status_icon (string) => 1 unicode character
• message (string) => custom message
• created_at (unsigned int, not null) => unixtime
• clear_at (unsigned int) => unixtime

API spec (OCS):

1. Expose user_status capability
   Req: GET /ocs/v1.php/cloud/capabilities
   Res:

{
  "ocs": {
    ...
    "data": {
      ...
      "capabilities": {
        ...
        "user_status": {
          "enabled": true
        }
      }
    }
  }
}

2. Read all user-statuses
   Req: GET /ocs/v1.php/apps/user_status/api/v1/statuses
   Res:

{
  "ocs": {
    "meta": {
      "status": "ok",
      "statuscode": 200,
      "message": null
    },
    "data": [
      {
        "userId": "admin",
        "statusType": "busy",
        "createdAt": 1589795903
      },
      {
        "userId": "user",
        "statusType": "holiday",
        "statusIcon": "🏝",
        "message": "On Vacation",
        "createdAt": 1589795903,
        "clearAt": 1589795904,
      }
    ]
  }
}

Allowed parameters:

• limit
• offset

3. Read status of specific user:
   Req: GET /ocs/v1.php/apps/user_status/api/v1/statuses/admin
   Res:

{
  "ocs": {
    "meta": {
      "status": "ok",
      "statuscode": 200,
      "message": null
    },
    "data": {
      "userId": "admin",
      "statusType": "busy",
      "createdAt": 1589795903
    }
  }
}

3. Read status of authenticated user:
   Req: GET /ocs/v1.php/apps/user_status/api/v1/status
   Res:

{
  "ocs": {
    "meta": {
      "status": "ok",
      "statuscode": 200,
      "message": null
    },
    "data": {
      "userId": "admin",
      "statusType": "busy",
      "createdAt": 1589795903
    }
  }
}

4. Set a new status:
   Req: PUT /ocs/v1.php/apps/user_status/api/v1/status

5. Clear status:
   Req: DELETE /ocs/v1.php/apps/user_status/api/v1/status

Notes on privacy:

The APIs should respect the sharing privacy settings. (e.g. only allow to fetch status within own groups, etc.)

Acceptance criteria

To be extended.

• I want to be able to see my own status overlayed on my avatar in the top right
• I want to be able to set my status
• I want to have at least the available statuses
  • Available
  • Busy
  • Holiday
• In places where appropiat (specify @georgehrke @jancborchardt) I want to see the status of other users on the system
• I want to have an API that can be used by our mobile apps as well

[go2sh]

It would be nice to set a certain time span or end date for a status, e.g. "Holiday until 17.05.2020".

[georgehrke]

@go2s Yes, the plan is to have a "Clear status in 1 hour / 1 day / 1 week" feature.

[ChristophWurst]

Holiday

Nitpick: this is a bit specific. How about unavailable, which covers vacation, out of office and being sick

[go2sh]

I think the reason, why someone is unavailable, provides a good value for communication, because you can express a grading. If someone is sick or on vaction, you might get no answere, but if someone is out of office, or doing homeoffice, you might get answer.

[ChristophWurst]

Fair enough, out of office does not mean unavailable. But being sick, public holiday and vacation can be seen as unavailable IMO :)

[georgehrke]

@go2sh You will have the ability to set a custom icon and custom message like 🌴 On Vacation or 🤒 On sick leave.

The status should really be on a lower level:

• 🟢 Available
• 🟠 Busy (e.g. in a meeting right now, but i will be available after)
• 🔴 Unavailable.

[go2sh]

Ah nice, that wasn't clear to me. :-)

[tobiasKaminsky]

So for mobile it would be great to have it in:

• propfind "nc:sharees" of files/folders, so that we can directly show it in file list
• search for users when sharing (should be "ocs/v2.php/apps/files_sharing/api/v1/sharees")

[georgehrke]

@rullzer @jancborchardt Should the user-status be visible on public pages as well or should it only be visible to other users?