Add capability for room descriptions

Signed-off-by: Daniel Calviño Sánchez <danxuliu@gmail.com>

docs/capabilities.md

@@ -61,5 +61,6 @@ title: Capabilities
 * `listable-rooms` - Conversations can searched for even when not joined. A "listable" attribute set on rooms defines the scope of who can find it.
 * `phonebook-search` - Is present when the server has the endpoint to search for phone numbers to find matches in the accounts list
 * `raise-hand` - Participants can raise or lower hand, the state change is sent through signaling messages.
+* `room-description` - A description can be get and set for conversations.
 * `config => chat => read-privacy` - See `chat-read-status`
 * `config => previews => max-gif-size` - Maximum size in bytes below which a GIF can be embedded directly in the page at render time. Bigger files will be rendered statically using the preview endpoint instead. Can be set with `occ config:app:set spreed max-gif-size --value=X` where X is the new value in bytes. Defaults to 3 MB.

docs/conversation.md

@@ -47,7 +47,7 @@
         `type` | int | * | See list of conversation types in the [constants list](constants.md#Conversation-types)
         `name` | string | * | Name of the conversation (can also be empty)
         `displayName` | string | * | `name` if non empty, otherwise it falls back to a list of participants
-        `description` | string | v3 | Description of the conversation (can also be empty)
+        `description` | string | v3 | Description of the conversation (can also be empty) (only available with `room-description` capability)
         `participantType` | int | * | Permissions level of the current user
         `attendeeId` | int | v3 | Unique attendee id
         `attendeePin` | string | v3 | Unique dial-in authentication code for this user, when the conversation has SIP enabled (see `sipEnabled` attribute)

lib/Capabilities.php

@@ -86,6 +86,7 @@ class Capabilities implements IPublicCapability {
 				'chat-read-status',
 				'phonebook-search',
 				'raise-hand',
+				'room-description',
 			],
 			'config' => [
 				'attachments' => [

tests/php/CapabilitiesTest.php

@@ -83,6 +83,7 @@ class CapabilitiesTest extends TestCase {
 			'chat-read-status',
 			'phonebook-search',
 			'raise-hand',
+			'room-description',
 		];
 	}