nextcloud / server

lib/public/RichObjectStrings/Definitions.php

Indentation +627 added lines, -627 removed lines

@@ -34,633 +34,633 @@
  * @since 11.0.0
  */
 class Definitions {
-	/**
-	 * @var array
-	 * @since 11.0.0
-	 */
-	public $definitions = [
-		'addressbook' => [
-			'author' => 'Nextcloud',
-			'app' => 'dav',
-			'since' => '11.0.0',
-			'parameters' => [
-				'id' => [
-					'since' => '11.0.0',
-					'required' => true,
-					'description' => 'The id used to identify the addressbook on the instance',
-					'example' => '42',
-				],
-				'name' => [
-					'since' => '11.0.0',
-					'required' => true,
-					'description' => 'The display name of the addressbook which should be used in the visual representation',
-					'example' => 'Contacts',
-				],
-			],
-		],
-		'addressbook-contact' => [
-			'author' => 'Nextcloud',
-			'app' => 'dav',
-			'since' => '11.0.0',
-			'parameters' => [
-				'id' => [
-					'since' => '11.0.0',
-					'required' => true,
-					'description' => 'The id used to identify the contact on the instance',
-					'example' => '42',
-				],
-				'name' => [
-					'since' => '11.0.0',
-					'required' => true,
-					'description' => 'The display name of the contact which should be used in the visual representation',
-					'example' => 'John Doe',
-				],
-			],
-		],
-		'announcement' => [
-			'author' => 'Joas Schilling',
-			'app' => 'announcementcenter',
-			'since' => '11.0.0',
-			'parameters' => [
-				'id' => [
-					'since' => '11.0.0',
-					'required' => true, 'description' => 'The id used to identify the announcement on the instance',
-					'example' => '42',
-				],
-				'name' => [
-					'since' => '11.0.0',
-					'required' => true,
-					'description' => 'The announcement subject which should be used in the visual representation',
-					'example' => 'file.txt',
-				],
-				'link' => [
-					'since' => '11.0.0',
-					'required' => false,
-					'description' => 'The full URL to the file',
-					'example' => 'http://localhost/index.php/apps/announcements/#23',
-				],
-			],
-		],
-		'app' => [
-			'author' => 'Nextcloud',
-			'app' => 'updatenotification',
-			'since' => '11.0.0',
-			'parameters' => [
-				'id' => [
-					'since' => '11.0.0',
-					'required' => true, 'description' => 'The app id',
-					'example' => 'updatenotification',
-				],
-				'name' => [
-					'since' => '11.0.0',
-					'required' => true,
-					'description' => 'The name of the app which should be used in the visual representation',
-					'example' => 'Update notification',
-				],
-			],
-		],
-		'calendar' => [
-			'author' => 'Nextcloud',
-			'app' => 'dav',
-			'since' => '11.0.0',
-			'parameters' => [
-				'id' => [
-					'since' => '11.0.0',
-					'required' => true,
-					'description' => 'The id used to identify the calendar on the instance',
-					'example' => '42',
-				],
-				'name' => [
-					'since' => '11.0.0',
-					'required' => true,
-					'description' => 'The display name of the calendar which should be used in the visual representation',
-					'example' => 'Personal',
-				],
-			],
-		],
-		'calendar-event' => [
-			'author' => 'Nextcloud',
-			'app' => 'dav',
-			'since' => '11.0.0',
-			'parameters' => [
-				'id' => [
-					'since' => '11.0.0',
-					'required' => true,
-					'description' => 'The id used to identify the event on the instance',
-					'example' => '42',
-				],
-				'name' => [
-					'since' => '11.0.0',
-					'required' => true,
-					'description' => 'The display name of the event which should be used in the visual representation',
-					'example' => 'Workout',
-				],
-				'link' => [
-					'since' => '19.0.0',
-					'required' => false,
-					'description' => 'A link to the page displaying the calendar',
-					'example' => 'http://localhost/index.php/apps/calendar/dayGridMonth/2020-01-20/edit/sidebar/base64string/1579046400'
-				]
-			],
-		],
-		'call' => [
-			'author' => 'Nextcloud',
-			'app' => 'spreed',
-			'since' => '11.0.2',
-			'parameters' => [
-				'id' => [
-					'since' => '11.0.2',
-					'required' => true,
-					'description' => 'The id used to identify the call on the instance',
-					'example' => '42',
-				],
-				'name' => [
-					'since' => '11.0.2',
-					'required' => true,
-					'description' => 'The display name of the call which should be used in the visual representation',
-					'example' => 'Company call',
-				],
-				'call-type' => [
-					'since' => '11.0.2',
-					'required' => true,
-					'description' => 'The type of the call: one2one, group or public',
-					'example' => 'one2one',
-				],
-				'link' => [
-					'since' => '19.0.0',
-					'required' => false,
-					'description' => 'The link to the conversation',
-					'example' => 'https://localhost/index.php/call/R4nd0mToken',
-				],
-			],
-		],
-		'circle' => [
-			'author' => 'Maxence Lange',
-			'app' => 'circles',
-			'since' => '12.0.0',
-			'parameters' => [
-				'id' => [
-					'since' => '12.0.0',
-					'required' => true,
-					'description' => 'The id used to identify the circle on the instance',
-					'example' => '42',
-				],
-				'name' => [
-					'since' => '12.0.0',
-					'required' => true,
-					'description' => 'The display name of the circle which should be used in the visual representation',
-					'example' => 'My friends',
-				],
-				'link' => [
-					'since' => '12.0.0',
-					'required' => true,
-					'description' => 'The full URL to the circle',
-					'example' => 'http://localhost/index.php/apps/circles/#42',
-				],
-			],
-		],
-		'deck-board' => [
-			'author' => 'Nextcloud',
-			'app' => 'deck',
-			'since' => '21.0.0',
-			'parameters' => [
-				'id' => [
-					'since' => '21.0.0',
-					'required' => true,
-					'description' => 'The id used to identify the board on the instance',
-					'example' => '1',
-				],
-				'name' => [
-					'since' => '21.0.0',
-					'required' => true,
-					'description' => 'The display name of the deck board',
-					'example' => 'Personal',
-				],
-				'link' => [
-					'since' => '21.0.0',
-					'required' => true,
-					'description' => 'The full URL to the board',
-					'example' => 'http://localhost/index.php/apps/deck/#/board/1',
-				],
-			],
-		],
-		'deck-card' => [
-			'author' => 'Nextcloud',
-			'app' => 'deck',
-			'since' => '21.0.0',
-			'parameters' => [
-				'id' => [
-					'since' => '21.0.0',
-					'required' => true,
-					'description' => 'The id used to identify the card on the instance',
-					'example' => '1',
-				],
-				'name' => [
-					'since' => '21.0.0',
-					'required' => true,
-					'description' => 'The title of the deck card',
-					'example' => 'Foo Bar',
-				],
-				'boardname' => [
-					'since' => '21.0.0',
-					'required' => true,
-					'description' => 'The display name of board which contains the card',
-					'example' => 'Personal',
-				],
-				'stackname' => [
-					'since' => '21.0.0',
-					'required' => true,
-					'description' => 'The display name of the stack which contains the card in the board',
-					'example' => 'To do',
-				],
-				'link' => [
-					'since' => '21.0.0',
-					'required' => true,
-					'description' => 'The full URL to the card directly',
-					'example' => 'https://nextcloud21.local/index.php/apps/deck/#/board/1/card/1',
-				],
-			],
-		],
-		'email' => [
-			'author' => 'Nextcloud',
-			'app' => 'sharebymail',
-			'since' => '11.0.0',
-			'parameters' => [
-				'id' => [
-					'since' => '11.0.0',
-					'required' => true,
-					'description' => 'The mail-address used to identify the event on the instance',
-					'example' => 'test@localhost',
-				],
-				'name' => [
-					'since' => '11.0.0',
-					'required' => true,
-					'description' => 'The display name of a matching contact or the email (fallback) which should be used in the visual representation',
-					'example' => 'Foo Bar',
-				],
-			],
-		],
-		'file' => [
-			'author' => 'Nextcloud',
-			'app' => 'dav',
-			'since' => '11.0.0',
-			'parameters' => [
-				'id' => [
-					'since' => '11.0.0',
-					'required' => true,
-					'description' => 'The id used to identify the file on the instance',
-					'example' => '42',
-				],
-				'name' => [
-					'since' => '11.0.0',
-					'required' => true,
-					'description' => 'The file name which should be used in the visual representation',
-					'example' => 'file.txt',
-				],
-				'size' => [
-					'since' => '21.0.0',
-					'required' => false,
-					'description' => 'The file size in bytes',
-					'example' => '3145728',
-				],
-				'path' => [
-					'since' => '11.0.0',
-					'required' => true,
-					'description' => 'The full path of the file for the user, should not start with a slash',
-					'example' => 'path/to/file.txt',
-				],
-				'link' => [
-					'since' => '11.0.0',
-					'required' => false,
-					'description' => 'The full URL to the file',
-					'example' => 'http://localhost/index.php/f/42',
-				],
-				'mimetype' => [
-					'since' => '16.0.0',
-					'required' => false,
-					'description' => 'The mimetype of the file/folder to allow clients to show a placeholder',
-					'example' => 'text/plain',
-				],
-				'preview-available' => [
-					'since' => '16.0.0',
-					'required' => false,
-					'description' => 'Whether or not a preview is available. If `no` the mimetype icon should be used',
-					'example' => 'yes',
-				],
-				'mtime' => [
-					'since' => '25.0.0',
-					'required' => false,
-					'description' => 'The mtime of the file/folder as unix timestamp',
-					'example' => '1661854213',
-				],
-			],
-		],
-		'forms-form' => [
-			'author' => 'Nextcloud',
-			'app' => 'forms',
-			'since' => '21.0.1',
-			'parameters' => [
-				'id' => [
-					'since' => '21.0.1',
-					'required' => true,
-					'description' => 'The form-hash of the form',
-					'example' => 'q72GGqbfbLBC6xNB',
-				],
-				'name' => [
-					'since' => '21.0.1',
-					'required' => true,
-					'description' => 'The title of the form',
-					'example' => 'Nice Form',
-				],
-				'link' => [
-					'since' => '21.0.1',
-					'required' => true,
-					'description' => 'The full URL to the board',
-					'example' => 'http://localhost/index.php/apps/forms/q72GGqbfbLBC6xNB',
-				],
-			],
-		],
-		'guest' => [
-			'author' => 'Nextcloud',
-			'app' => 'spreed',
-			'since' => '17.0.0',
-			'parameters' => [
-				'id' => [
-					'since' => '17.0.0',
-					'required' => true,
-					'description' => 'The id used to identify the guest user',
-					'example' => '42',
-				],
-				'name' => [
-					'since' => '17.0.0',
-					'required' => true,
-					'description' => 'Potential displayname of the guest user',
-					'example' => 'Foobar Cats',
-				],
-			],
-		],
-		'highlight' => [
-			'author' => 'Nextcloud',
-			'app' => 'core',
-			'since' => '13.0.0',
-			'parameters' => [
-				'id' => [
-					'since' => '13.0.0',
-					'required' => true,
-					'description' => 'The id used to identify the highlighted object on the instance',
-					'example' => '42',
-				],
-				'name' => [
-					'since' => '13.0.0',
-					'required' => true,
-					'description' => 'The string that should be highlighted.',
-					'example' => 'Hello World',
-				],
-				'link' => [
-					'since' => '13.0.0',
-					'required' => false,
-					'description' => 'The full URL that should be opened when clicking the highlighted text.',
-					'example' => 'http://localhost/index.php/f/42',
-				],
-			],
-		],
-		'geo-location' => [
-			'author' => 'Nextcloud',
-			'app' => 'core',
-			'since' => '22.0.0',
-			'parameters' => [
-				'id' => [
-					'since' => '22.0.0',
-					'required' => true,
-					'description' => 'The geo URI (https://en.wikipedia.org/wiki/Geo_URI_scheme) to identify the location',
-					'example' => 'geo:52.5450511,13.3741463',
-				],
-				'name' => [
-					'since' => '22.0.0',
-					'required' => true,
-					'description' => 'A description of the location',
-					'example' => 'Nextcloud Berlin Office',
-				],
-				'latitude' => [
-					'since' => '22.0.0',
-					'required' => true,
-					'description' => 'The latitude of the location MUST be the same as in the id',
-					'example' => '52.5450511',
-				],
-				'longitude' => [
-					'since' => '22.0.0',
-					'required' => true,
-					'description' => 'The longitude of the location MUST be the same as in the id',
-					'example' => '13.3741463',
-				],
-			],
-		],
-		'open-graph' => [
-			'author' => 'Maxence Lange',
-			'app' => 'mood',
-			'since' => '12.0.0',
-			'parameters' => [
-				'id' => [
-					'since' => '12.0.0',
-					'required' => true,
-					'description' => 'The id used to identify the open graph data on the instance',
-					'example' => '42',
-				],
-				'name' => [
-					'since' => '12.0.0',
-					'required' => true,
-					'description' => 'The open graph title of the website',
-					'example' => 'This is a website',
-				],
-				'description' => [
-					'since' => '12.0.0',
-					'required' => false,
-					'description' => 'The open graph description from the website',
-					'example' => 'This is the description of the website',
-				],
-				'thumb' => [
-					'since' => '12.0.0',
-					'required' => false,
-					'description' => 'The full URL of the open graph thumbnail',
-					'example' => 'http://localhost/index.php/apps/mood/data/image?url=https%3A%2F%2Fthumb.example.com%2Fimage.png',
-				],
-				'website' => [
-					'since' => '12.0.0',
-					'required' => false,
-					'description' => 'The name of the described website',
-					'example' => 'Nextcloud - App Store',
-				],
-				'link' => [
-					'since' => '12.0.0',
-					'required' => false,
-					'description' => 'The full link to the website',
-					'example' => 'https://apps.nextcloud.com/apps/mood',
-				],
-			],
-		],
-		'pending-federated-share' => [
-			'author' => 'Nextcloud',
-			'app' => 'dav',
-			'since' => '11.0.0',
-			'parameters' => [
-				'id' => [
-					'since' => '11.0.0',
-					'required' => true,
-					'description' => 'The id used to identify the federated share on the instance',
-					'example' => '42',
-				],
-				'name' => [
-					'since' => '11.0.0',
-					'required' => true,
-					'description' => 'The name of the shared item which should be used in the visual representation',
-					'example' => 'file.txt',
-				],
-			],
-		],
-		'systemtag' => [
-			'author' => 'Nextcloud',
-			'app' => 'core',
-			'since' => '11.0.0',
-			'parameters' => [
-				'id' => [
-					'since' => '11.0.0',
-					'required' => true,
-					'description' => 'The id used to identify the systemtag on the instance',
-					'example' => '23',
-				],
-				'name' => [
-					'since' => '11.0.0',
-					'required' => true,
-					'description' => 'The display name of the systemtag which should be used in the visual representation',
-					'example' => 'Project 1',
-				],
-				'visibility' => [
-					'since' => '11.0.0',
-					'required' => true,
-					'description' => 'If the user can see the systemtag',
-					'example' => '1',
-				],
-				'assignable' => [
-					'since' => '11.0.0',
-					'required' => true,
-					'description' => 'If the user can assign the systemtag',
-					'example' => '0',
-				],
-			],
-		],
-		'talk-attachment' => [
-			'author' => 'Nextcloud',
-			'app' => 'talk',
-			'since' => '18.0.0',
-			'parameters' => [
-				'id' => [
-					'since' => '18.0.0',
-					'required' => true,
-					'description' => 'The id used to identify the attachment on the instance',
-					'example' => '12345',
-				],
-				'name' => [
-					'since' => '18.0.0',
-					'required' => true,
-					'description' => 'The name of the attachment',
-					'example' => 'John Doe',
-				],
-				'conversation' => [
-					'since' => '18.0.0',
-					'required' => true,
-					'description' => 'The token of the conversation',
-					'example' => 'a1b2c3d4',
-				],
-				'mimetype' => [
-					'since' => '18.0.0',
-					'required' => false,
-					'description' => 'The mimetype of the file/folder to allow clients to show a placeholder',
-					'example' => 'text/plain',
-				],
-				'preview-available' => [
-					'since' => '18.0.0',
-					'required' => false,
-					'description' => 'Whether or not a preview is available. If `no` the mimetype icon should be used',
-					'example' => 'yes',
-				],
-			],
-		],
-		'talk-poll' => [
-			'author' => 'Nextcloud',
-			'app' => 'talk',
-			'since' => '25.0.0',
-			'parameters' => [
-				'id' => [
-					'since' => '25.0.0',
-					'required' => true,
-					'description' => 'The id used to identify the poll on the instance',
-					'example' => '12345',
-				],
-				'name' => [
-					'since' => '25.0.0',
-					'required' => true,
-					'description' => 'The poll question',
-					'example' => 'What is the question?',
-				],
-			],
-		],
-		'user' => [
-			'author' => 'Nextcloud',
-			'app' => 'core',
-			'since' => '11.0.0',
-			'parameters' => [
-				'id' => [
-					'since' => '11.0.0',
-					'required' => true,
-					'description' => 'The id used to identify the user on the instance',
-					'example' => 'johndoe',
-				],
-				'name' => [
-					'since' => '11.0.0',
-					'required' => true,
-					'description' => 'The display name of the user which should be used in the visual representation',
-					'example' => 'John Doe',
-				],
-				'server' => [
-					'since' => '11.0.0',
-					'required' => false,
-					'description' => 'The URL of the instance the user lives on',
-					'example' => 'localhost',
-				],
-			],
-		],
-		'user-group' => [
-			'author' => 'Nextcloud',
-			'app' => 'core',
-			'since' => '11.0.0',
-			'parameters' => [
-				'id' => [
-					'since' => '11.0.0',
-					'required' => true,
-					'description' => 'The id used to identify the group on the instance',
-					'example' => 'supportteam',
-				],
-				'name' => [
-					'since' => '11.0.0',
-					'required' => true,
-					'description' => 'The display name of the group which should be used in the visual representation',
-					'example' => 'Support Team',
-				],
-			],
-		],
-	];
+    /**
+     * @var array
+     * @since 11.0.0
+     */
+    public $definitions = [
+        'addressbook' => [
+            'author' => 'Nextcloud',
+            'app' => 'dav',
+            'since' => '11.0.0',
+            'parameters' => [
+                'id' => [
+                    'since' => '11.0.0',
+                    'required' => true,
+                    'description' => 'The id used to identify the addressbook on the instance',
+                    'example' => '42',
+                ],
+                'name' => [
+                    'since' => '11.0.0',
+                    'required' => true,
+                    'description' => 'The display name of the addressbook which should be used in the visual representation',
+                    'example' => 'Contacts',
+                ],
+            ],
+        ],
+        'addressbook-contact' => [
+            'author' => 'Nextcloud',
+            'app' => 'dav',
+            'since' => '11.0.0',
+            'parameters' => [
+                'id' => [
+                    'since' => '11.0.0',
+                    'required' => true,
+                    'description' => 'The id used to identify the contact on the instance',
+                    'example' => '42',
+                ],
+                'name' => [
+                    'since' => '11.0.0',
+                    'required' => true,
+                    'description' => 'The display name of the contact which should be used in the visual representation',
+                    'example' => 'John Doe',
+                ],
+            ],
+        ],
+        'announcement' => [
+            'author' => 'Joas Schilling',
+            'app' => 'announcementcenter',
+            'since' => '11.0.0',
+            'parameters' => [
+                'id' => [
+                    'since' => '11.0.0',
+                    'required' => true, 'description' => 'The id used to identify the announcement on the instance',
+                    'example' => '42',
+                ],
+                'name' => [
+                    'since' => '11.0.0',
+                    'required' => true,
+                    'description' => 'The announcement subject which should be used in the visual representation',
+                    'example' => 'file.txt',
+                ],
+                'link' => [
+                    'since' => '11.0.0',
+                    'required' => false,
+                    'description' => 'The full URL to the file',
+                    'example' => 'http://localhost/index.php/apps/announcements/#23',
+                ],
+            ],
+        ],
+        'app' => [
+            'author' => 'Nextcloud',
+            'app' => 'updatenotification',
+            'since' => '11.0.0',
+            'parameters' => [
+                'id' => [
+                    'since' => '11.0.0',
+                    'required' => true, 'description' => 'The app id',
+                    'example' => 'updatenotification',
+                ],
+                'name' => [
+                    'since' => '11.0.0',
+                    'required' => true,
+                    'description' => 'The name of the app which should be used in the visual representation',
+                    'example' => 'Update notification',
+                ],
+            ],
+        ],
+        'calendar' => [
+            'author' => 'Nextcloud',
+            'app' => 'dav',
+            'since' => '11.0.0',
+            'parameters' => [
+                'id' => [
+                    'since' => '11.0.0',
+                    'required' => true,
+                    'description' => 'The id used to identify the calendar on the instance',
+                    'example' => '42',
+                ],
+                'name' => [
+                    'since' => '11.0.0',
+                    'required' => true,
+                    'description' => 'The display name of the calendar which should be used in the visual representation',
+                    'example' => 'Personal',
+                ],
+            ],
+        ],
+        'calendar-event' => [
+            'author' => 'Nextcloud',
+            'app' => 'dav',
+            'since' => '11.0.0',
+            'parameters' => [
+                'id' => [
+                    'since' => '11.0.0',
+                    'required' => true,
+                    'description' => 'The id used to identify the event on the instance',
+                    'example' => '42',
+                ],
+                'name' => [
+                    'since' => '11.0.0',
+                    'required' => true,
+                    'description' => 'The display name of the event which should be used in the visual representation',
+                    'example' => 'Workout',
+                ],
+                'link' => [
+                    'since' => '19.0.0',
+                    'required' => false,
+                    'description' => 'A link to the page displaying the calendar',
+                    'example' => 'http://localhost/index.php/apps/calendar/dayGridMonth/2020-01-20/edit/sidebar/base64string/1579046400'
+                ]
+            ],
+        ],
+        'call' => [
+            'author' => 'Nextcloud',
+            'app' => 'spreed',
+            'since' => '11.0.2',
+            'parameters' => [
+                'id' => [
+                    'since' => '11.0.2',
+                    'required' => true,
+                    'description' => 'The id used to identify the call on the instance',
+                    'example' => '42',
+                ],
+                'name' => [
+                    'since' => '11.0.2',
+                    'required' => true,
+                    'description' => 'The display name of the call which should be used in the visual representation',
+                    'example' => 'Company call',
+                ],
+                'call-type' => [
+                    'since' => '11.0.2',
+                    'required' => true,
+                    'description' => 'The type of the call: one2one, group or public',
+                    'example' => 'one2one',
+                ],
+                'link' => [
+                    'since' => '19.0.0',
+                    'required' => false,
+                    'description' => 'The link to the conversation',
+                    'example' => 'https://localhost/index.php/call/R4nd0mToken',
+                ],
+            ],
+        ],
+        'circle' => [
+            'author' => 'Maxence Lange',
+            'app' => 'circles',
+            'since' => '12.0.0',
+            'parameters' => [
+                'id' => [
+                    'since' => '12.0.0',
+                    'required' => true,
+                    'description' => 'The id used to identify the circle on the instance',
+                    'example' => '42',
+                ],
+                'name' => [
+                    'since' => '12.0.0',
+                    'required' => true,
+                    'description' => 'The display name of the circle which should be used in the visual representation',
+                    'example' => 'My friends',
+                ],
+                'link' => [
+                    'since' => '12.0.0',
+                    'required' => true,
+                    'description' => 'The full URL to the circle',
+                    'example' => 'http://localhost/index.php/apps/circles/#42',
+                ],
+            ],
+        ],
+        'deck-board' => [
+            'author' => 'Nextcloud',
+            'app' => 'deck',
+            'since' => '21.0.0',
+            'parameters' => [
+                'id' => [
+                    'since' => '21.0.0',
+                    'required' => true,
+                    'description' => 'The id used to identify the board on the instance',
+                    'example' => '1',
+                ],
+                'name' => [
+                    'since' => '21.0.0',
+                    'required' => true,
+                    'description' => 'The display name of the deck board',
+                    'example' => 'Personal',
+                ],
+                'link' => [
+                    'since' => '21.0.0',
+                    'required' => true,
+                    'description' => 'The full URL to the board',
+                    'example' => 'http://localhost/index.php/apps/deck/#/board/1',
+                ],
+            ],
+        ],
+        'deck-card' => [
+            'author' => 'Nextcloud',
+            'app' => 'deck',
+            'since' => '21.0.0',
+            'parameters' => [
+                'id' => [
+                    'since' => '21.0.0',
+                    'required' => true,
+                    'description' => 'The id used to identify the card on the instance',
+                    'example' => '1',
+                ],
+                'name' => [
+                    'since' => '21.0.0',
+                    'required' => true,
+                    'description' => 'The title of the deck card',
+                    'example' => 'Foo Bar',
+                ],
+                'boardname' => [
+                    'since' => '21.0.0',
+                    'required' => true,
+                    'description' => 'The display name of board which contains the card',
+                    'example' => 'Personal',
+                ],
+                'stackname' => [
+                    'since' => '21.0.0',
+                    'required' => true,
+                    'description' => 'The display name of the stack which contains the card in the board',
+                    'example' => 'To do',
+                ],
+                'link' => [
+                    'since' => '21.0.0',
+                    'required' => true,
+                    'description' => 'The full URL to the card directly',
+                    'example' => 'https://nextcloud21.local/index.php/apps/deck/#/board/1/card/1',
+                ],
+            ],
+        ],
+        'email' => [
+            'author' => 'Nextcloud',
+            'app' => 'sharebymail',
+            'since' => '11.0.0',
+            'parameters' => [
+                'id' => [
+                    'since' => '11.0.0',
+                    'required' => true,
+                    'description' => 'The mail-address used to identify the event on the instance',
+                    'example' => 'test@localhost',
+                ],
+                'name' => [
+                    'since' => '11.0.0',
+                    'required' => true,
+                    'description' => 'The display name of a matching contact or the email (fallback) which should be used in the visual representation',
+                    'example' => 'Foo Bar',
+                ],
+            ],
+        ],
+        'file' => [
+            'author' => 'Nextcloud',
+            'app' => 'dav',
+            'since' => '11.0.0',
+            'parameters' => [
+                'id' => [
+                    'since' => '11.0.0',
+                    'required' => true,
+                    'description' => 'The id used to identify the file on the instance',
+                    'example' => '42',
+                ],
+                'name' => [
+                    'since' => '11.0.0',
+                    'required' => true,
+                    'description' => 'The file name which should be used in the visual representation',
+                    'example' => 'file.txt',
+                ],
+                'size' => [
+                    'since' => '21.0.0',
+                    'required' => false,
+                    'description' => 'The file size in bytes',
+                    'example' => '3145728',
+                ],
+                'path' => [
+                    'since' => '11.0.0',
+                    'required' => true,
+                    'description' => 'The full path of the file for the user, should not start with a slash',
+                    'example' => 'path/to/file.txt',
+                ],
+                'link' => [
+                    'since' => '11.0.0',
+                    'required' => false,
+                    'description' => 'The full URL to the file',
+                    'example' => 'http://localhost/index.php/f/42',
+                ],
+                'mimetype' => [
+                    'since' => '16.0.0',
+                    'required' => false,
+                    'description' => 'The mimetype of the file/folder to allow clients to show a placeholder',
+                    'example' => 'text/plain',
+                ],
+                'preview-available' => [
+                    'since' => '16.0.0',
+                    'required' => false,
+                    'description' => 'Whether or not a preview is available. If `no` the mimetype icon should be used',
+                    'example' => 'yes',
+                ],
+                'mtime' => [
+                    'since' => '25.0.0',
+                    'required' => false,
+                    'description' => 'The mtime of the file/folder as unix timestamp',
+                    'example' => '1661854213',
+                ],
+            ],
+        ],
+        'forms-form' => [
+            'author' => 'Nextcloud',
+            'app' => 'forms',
+            'since' => '21.0.1',
+            'parameters' => [
+                'id' => [
+                    'since' => '21.0.1',
+                    'required' => true,
+                    'description' => 'The form-hash of the form',
+                    'example' => 'q72GGqbfbLBC6xNB',
+                ],
+                'name' => [
+                    'since' => '21.0.1',
+                    'required' => true,
+                    'description' => 'The title of the form',
+                    'example' => 'Nice Form',
+                ],
+                'link' => [
+                    'since' => '21.0.1',
+                    'required' => true,
+                    'description' => 'The full URL to the board',
+                    'example' => 'http://localhost/index.php/apps/forms/q72GGqbfbLBC6xNB',
+                ],
+            ],
+        ],
+        'guest' => [
+            'author' => 'Nextcloud',
+            'app' => 'spreed',
+            'since' => '17.0.0',
+            'parameters' => [
+                'id' => [
+                    'since' => '17.0.0',
+                    'required' => true,
+                    'description' => 'The id used to identify the guest user',
+                    'example' => '42',
+                ],
+                'name' => [
+                    'since' => '17.0.0',
+                    'required' => true,
+                    'description' => 'Potential displayname of the guest user',
+                    'example' => 'Foobar Cats',
+                ],
+            ],
+        ],
+        'highlight' => [
+            'author' => 'Nextcloud',
+            'app' => 'core',
+            'since' => '13.0.0',
+            'parameters' => [
+                'id' => [
+                    'since' => '13.0.0',
+                    'required' => true,
+                    'description' => 'The id used to identify the highlighted object on the instance',
+                    'example' => '42',
+                ],
+                'name' => [
+                    'since' => '13.0.0',
+                    'required' => true,
+                    'description' => 'The string that should be highlighted.',
+                    'example' => 'Hello World',
+                ],
+                'link' => [
+                    'since' => '13.0.0',
+                    'required' => false,
+                    'description' => 'The full URL that should be opened when clicking the highlighted text.',
+                    'example' => 'http://localhost/index.php/f/42',
+                ],
+            ],
+        ],
+        'geo-location' => [
+            'author' => 'Nextcloud',
+            'app' => 'core',
+            'since' => '22.0.0',
+            'parameters' => [
+                'id' => [
+                    'since' => '22.0.0',
+                    'required' => true,
+                    'description' => 'The geo URI (https://en.wikipedia.org/wiki/Geo_URI_scheme) to identify the location',
+                    'example' => 'geo:52.5450511,13.3741463',
+                ],
+                'name' => [
+                    'since' => '22.0.0',
+                    'required' => true,
+                    'description' => 'A description of the location',
+                    'example' => 'Nextcloud Berlin Office',
+                ],
+                'latitude' => [
+                    'since' => '22.0.0',
+                    'required' => true,
+                    'description' => 'The latitude of the location MUST be the same as in the id',
+                    'example' => '52.5450511',
+                ],
+                'longitude' => [
+                    'since' => '22.0.0',
+                    'required' => true,
+                    'description' => 'The longitude of the location MUST be the same as in the id',
+                    'example' => '13.3741463',
+                ],
+            ],
+        ],
+        'open-graph' => [
+            'author' => 'Maxence Lange',
+            'app' => 'mood',
+            'since' => '12.0.0',
+            'parameters' => [
+                'id' => [
+                    'since' => '12.0.0',
+                    'required' => true,
+                    'description' => 'The id used to identify the open graph data on the instance',
+                    'example' => '42',
+                ],
+                'name' => [
+                    'since' => '12.0.0',
+                    'required' => true,
+                    'description' => 'The open graph title of the website',
+                    'example' => 'This is a website',
+                ],
+                'description' => [
+                    'since' => '12.0.0',
+                    'required' => false,
+                    'description' => 'The open graph description from the website',
+                    'example' => 'This is the description of the website',
+                ],
+                'thumb' => [
+                    'since' => '12.0.0',
+                    'required' => false,
+                    'description' => 'The full URL of the open graph thumbnail',
+                    'example' => 'http://localhost/index.php/apps/mood/data/image?url=https%3A%2F%2Fthumb.example.com%2Fimage.png',
+                ],
+                'website' => [
+                    'since' => '12.0.0',
+                    'required' => false,
+                    'description' => 'The name of the described website',
+                    'example' => 'Nextcloud - App Store',
+                ],
+                'link' => [
+                    'since' => '12.0.0',
+                    'required' => false,
+                    'description' => 'The full link to the website',
+                    'example' => 'https://apps.nextcloud.com/apps/mood',
+                ],
+            ],
+        ],
+        'pending-federated-share' => [
+            'author' => 'Nextcloud',
+            'app' => 'dav',
+            'since' => '11.0.0',
+            'parameters' => [
+                'id' => [
+                    'since' => '11.0.0',
+                    'required' => true,
+                    'description' => 'The id used to identify the federated share on the instance',
+                    'example' => '42',
+                ],
+                'name' => [
+                    'since' => '11.0.0',
+                    'required' => true,
+                    'description' => 'The name of the shared item which should be used in the visual representation',
+                    'example' => 'file.txt',
+                ],
+            ],
+        ],
+        'systemtag' => [
+            'author' => 'Nextcloud',
+            'app' => 'core',
+            'since' => '11.0.0',
+            'parameters' => [
+                'id' => [
+                    'since' => '11.0.0',
+                    'required' => true,
+                    'description' => 'The id used to identify the systemtag on the instance',
+                    'example' => '23',
+                ],
+                'name' => [
+                    'since' => '11.0.0',
+                    'required' => true,
+                    'description' => 'The display name of the systemtag which should be used in the visual representation',
+                    'example' => 'Project 1',
+                ],
+                'visibility' => [
+                    'since' => '11.0.0',
+                    'required' => true,
+                    'description' => 'If the user can see the systemtag',
+                    'example' => '1',
+                ],
+                'assignable' => [
+                    'since' => '11.0.0',
+                    'required' => true,
+                    'description' => 'If the user can assign the systemtag',
+                    'example' => '0',
+                ],
+            ],
+        ],
+        'talk-attachment' => [
+            'author' => 'Nextcloud',
+            'app' => 'talk',
+            'since' => '18.0.0',
+            'parameters' => [
+                'id' => [
+                    'since' => '18.0.0',
+                    'required' => true,
+                    'description' => 'The id used to identify the attachment on the instance',
+                    'example' => '12345',
+                ],
+                'name' => [
+                    'since' => '18.0.0',
+                    'required' => true,
+                    'description' => 'The name of the attachment',
+                    'example' => 'John Doe',
+                ],
+                'conversation' => [
+                    'since' => '18.0.0',
+                    'required' => true,
+                    'description' => 'The token of the conversation',
+                    'example' => 'a1b2c3d4',
+                ],
+                'mimetype' => [
+                    'since' => '18.0.0',
+                    'required' => false,
+                    'description' => 'The mimetype of the file/folder to allow clients to show a placeholder',
+                    'example' => 'text/plain',
+                ],
+                'preview-available' => [
+                    'since' => '18.0.0',
+                    'required' => false,
+                    'description' => 'Whether or not a preview is available. If `no` the mimetype icon should be used',
+                    'example' => 'yes',
+                ],
+            ],
+        ],
+        'talk-poll' => [
+            'author' => 'Nextcloud',
+            'app' => 'talk',
+            'since' => '25.0.0',
+            'parameters' => [
+                'id' => [
+                    'since' => '25.0.0',
+                    'required' => true,
+                    'description' => 'The id used to identify the poll on the instance',
+                    'example' => '12345',
+                ],
+                'name' => [
+                    'since' => '25.0.0',
+                    'required' => true,
+                    'description' => 'The poll question',
+                    'example' => 'What is the question?',
+                ],
+            ],
+        ],
+        'user' => [
+            'author' => 'Nextcloud',
+            'app' => 'core',
+            'since' => '11.0.0',
+            'parameters' => [
+                'id' => [
+                    'since' => '11.0.0',
+                    'required' => true,
+                    'description' => 'The id used to identify the user on the instance',
+                    'example' => 'johndoe',
+                ],
+                'name' => [
+                    'since' => '11.0.0',
+                    'required' => true,
+                    'description' => 'The display name of the user which should be used in the visual representation',
+                    'example' => 'John Doe',
+                ],
+                'server' => [
+                    'since' => '11.0.0',
+                    'required' => false,
+                    'description' => 'The URL of the instance the user lives on',
+                    'example' => 'localhost',
+                ],
+            ],
+        ],
+        'user-group' => [
+            'author' => 'Nextcloud',
+            'app' => 'core',
+            'since' => '11.0.0',
+            'parameters' => [
+                'id' => [
+                    'since' => '11.0.0',
+                    'required' => true,
+                    'description' => 'The id used to identify the group on the instance',
+                    'example' => 'supportteam',
+                ],
+                'name' => [
+                    'since' => '11.0.0',
+                    'required' => true,
+                    'description' => 'The display name of the group which should be used in the visual representation',
+                    'example' => 'Support Team',
+                ],
+            ],
+        ],
+    ];
 
-	/**
-	 * @param string $type
-	 * @return array
-	 * @throws InvalidObjectExeption
-	 * @since 11.0.0
-	 */
-	public function getDefinition($type) {
-		if (isset($this->definitions[$type])) {
-			return $this->definitions[$type];
-		}
+    /**
+     * @param string $type
+     * @return array
+     * @throws InvalidObjectExeption
+     * @since 11.0.0
+     */
+    public function getDefinition($type) {
+        if (isset($this->definitions[$type])) {
+            return $this->definitions[$type];
+        }
 
-		throw new InvalidObjectExeption('Object type is undefined');
-	}
+        throw new InvalidObjectExeption('Object type is undefined');
+    }
 }

lib/private/Collaboration/Reference/File/FileReferenceProvider.php

Indentation +145 added lines, -145 removed lines

@@ -41,149 +41,149 @@
 use OCP\L10N\IFactory;
 
 class FileReferenceProvider extends ADiscoverableReferenceProvider {
-	private IURLGenerator $urlGenerator;
-	private IRootFolder $rootFolder;
-	private ?string $userId;
-	private IPreview $previewManager;
-	private IMimeTypeDetector $mimeTypeDetector;
-	private IL10N $l10n;
-
-	public function __construct(
-		IURLGenerator $urlGenerator,
-		IRootFolder $rootFolder,
-		IUserSession $userSession,
-		IMimeTypeDetector $mimeTypeDetector,
-		IPreview $previewManager,
-		IFactory $l10n
-	) {
-		$this->urlGenerator = $urlGenerator;
-		$this->rootFolder = $rootFolder;
-		$this->userId = $userSession->getUser() ? $userSession->getUser()->getUID() : null;
-		$this->previewManager = $previewManager;
-		$this->mimeTypeDetector = $mimeTypeDetector;
-		$this->l10n = $l10n->get('files');
-	}
-
-	public function matchReference(string $referenceText): bool {
-		return $this->getFilesAppLinkId($referenceText) !== null;
-	}
-
-	private function getFilesAppLinkId(string $referenceText): ?int {
-		$start = $this->urlGenerator->getAbsoluteURL('/apps/files/');
-		$startIndex = $this->urlGenerator->getAbsoluteURL('/index.php/apps/files/');
-
-		$fileId = null;
-
-		if (mb_strpos($referenceText, $start) === 0) {
-			$parts = parse_url($referenceText);
-			parse_str($parts['query'] ?? '', $query);
-			$fileId = isset($query['fileid']) ? (int)$query['fileid'] : $fileId;
-			$fileId = isset($query['openfile']) ? (int)$query['openfile'] : $fileId;
-		}
-
-		if (mb_strpos($referenceText, $startIndex) === 0) {
-			$parts = parse_url($referenceText);
-			parse_str($parts['query'] ?? '', $query);
-			$fileId = isset($query['fileid']) ? (int)$query['fileid'] : $fileId;
-			$fileId = isset($query['openfile']) ? (int)$query['openfile'] : $fileId;
-		}
-
-		if (mb_strpos($referenceText, $this->urlGenerator->getAbsoluteURL('/index.php/f/')) === 0) {
-			$fileId = str_replace($this->urlGenerator->getAbsoluteURL('/index.php/f/'), '', $referenceText);
-		}
-
-		if (mb_strpos($referenceText, $this->urlGenerator->getAbsoluteURL('/f/')) === 0) {
-			$fileId = str_replace($this->urlGenerator->getAbsoluteURL('/f/'), '', $referenceText);
-		}
-
-		return $fileId !== null ? (int)$fileId : null;
-	}
-
-	public function resolveReference(string $referenceText): ?IReference {
-		if ($this->matchReference($referenceText)) {
-			$reference = new Reference($referenceText);
-			try {
-				$this->fetchReference($reference);
-			} catch (NotFoundException $e) {
-				$reference->setRichObject('file', null);
-				$reference->setAccessible(false);
-			}
-			return $reference;
-		}
-
-		return null;
-	}
-
-	/**
-	 * @throws NotFoundException
-	 */
-	private function fetchReference(Reference $reference): void {
-		if ($this->userId === null) {
-			throw new NotFoundException();
-		}
-
-		$fileId = $this->getFilesAppLinkId($reference->getId());
-		if ($fileId === null) {
-			throw new NotFoundException();
-		}
-
-		try {
-			$userFolder = $this->rootFolder->getUserFolder($this->userId);
-			$files = $userFolder->getById($fileId);
-
-			if (empty($files)) {
-				throw new NotFoundException();
-			}
-
-			/** @var Node $file */
-			$file = array_shift($files);
-
-			$reference->setTitle($file->getName());
-			$reference->setDescription($file->getMimetype());
-			$reference->setUrl($this->urlGenerator->getAbsoluteURL('/index.php/f/' . $fileId));
-			if ($this->previewManager->isMimeSupported($file->getMimeType())) {
-				$reference->setImageUrl($this->urlGenerator->linkToRouteAbsolute('core.Preview.getPreviewByFileId', ['x' => 1600, 'y' => 630, 'fileId' => $fileId]));
-			} else {
-				$fileTypeIconUrl = $this->mimeTypeDetector->mimeTypeIcon($file->getMimeType());
-				$reference->setImageUrl($fileTypeIconUrl);
-			}
-
-			$reference->setRichObject('file', [
-				'id' => $file->getId(),
-				'name' => $file->getName(),
-				'size' => $file->getSize(),
-				'path' => $userFolder->getRelativePath($file->getPath()),
-				'link' => $reference->getUrl(),
-				'mimetype' => $file->getMimetype(),
-				'mtime' => $file->getMTime(),
-				'preview-available' => $this->previewManager->isAvailable($file)
-			]);
-		} catch (InvalidPathException|NotFoundException|NotPermittedException|NoUserException $e) {
-			throw new NotFoundException();
-		}
-	}
-
-	public function getCachePrefix(string $referenceId): string {
-		return (string)$this->getFilesAppLinkId($referenceId);
-	}
-
-	public function getCacheKey(string $referenceId): ?string {
-		return $this->userId ?? '';
-	}
-
-	public function getId(): string {
-		return 'files';
-	}
-
-	public function getTitle(): string {
-		return $this->l10n->t('Files');
-	}
-
-	public function getOrder(): int {
-		return 0;
-	}
-
-	public function getIconUrl(): string {
-		return $this->urlGenerator->imagePath('files', 'folder.svg');
-	}
+    private IURLGenerator $urlGenerator;
+    private IRootFolder $rootFolder;
+    private ?string $userId;
+    private IPreview $previewManager;
+    private IMimeTypeDetector $mimeTypeDetector;
+    private IL10N $l10n;
+
+    public function __construct(
+        IURLGenerator $urlGenerator,
+        IRootFolder $rootFolder,
+        IUserSession $userSession,
+        IMimeTypeDetector $mimeTypeDetector,
+        IPreview $previewManager,
+        IFactory $l10n
+    ) {
+        $this->urlGenerator = $urlGenerator;
+        $this->rootFolder = $rootFolder;
+        $this->userId = $userSession->getUser() ? $userSession->getUser()->getUID() : null;
+        $this->previewManager = $previewManager;
+        $this->mimeTypeDetector = $mimeTypeDetector;
+        $this->l10n = $l10n->get('files');
+    }
+
+    public function matchReference(string $referenceText): bool {
+        return $this->getFilesAppLinkId($referenceText) !== null;
+    }
+
+    private function getFilesAppLinkId(string $referenceText): ?int {
+        $start = $this->urlGenerator->getAbsoluteURL('/apps/files/');
+        $startIndex = $this->urlGenerator->getAbsoluteURL('/index.php/apps/files/');
+
+        $fileId = null;
+
+        if (mb_strpos($referenceText, $start) === 0) {
+            $parts = parse_url($referenceText);
+            parse_str($parts['query'] ?? '', $query);
+            $fileId = isset($query['fileid']) ? (int)$query['fileid'] : $fileId;
+            $fileId = isset($query['openfile']) ? (int)$query['openfile'] : $fileId;
+        }
+
+        if (mb_strpos($referenceText, $startIndex) === 0) {
+            $parts = parse_url($referenceText);
+            parse_str($parts['query'] ?? '', $query);
+            $fileId = isset($query['fileid']) ? (int)$query['fileid'] : $fileId;
+            $fileId = isset($query['openfile']) ? (int)$query['openfile'] : $fileId;
+        }
+
+        if (mb_strpos($referenceText, $this->urlGenerator->getAbsoluteURL('/index.php/f/')) === 0) {
+            $fileId = str_replace($this->urlGenerator->getAbsoluteURL('/index.php/f/'), '', $referenceText);
+        }
+
+        if (mb_strpos($referenceText, $this->urlGenerator->getAbsoluteURL('/f/')) === 0) {
+            $fileId = str_replace($this->urlGenerator->getAbsoluteURL('/f/'), '', $referenceText);
+        }
+
+        return $fileId !== null ? (int)$fileId : null;
+    }
+
+    public function resolveReference(string $referenceText): ?IReference {
+        if ($this->matchReference($referenceText)) {
+            $reference = new Reference($referenceText);
+            try {
+                $this->fetchReference($reference);
+            } catch (NotFoundException $e) {
+                $reference->setRichObject('file', null);
+                $reference->setAccessible(false);
+            }
+            return $reference;
+        }
+
+        return null;
+    }
+
+    /**
+     * @throws NotFoundException
+     */
+    private function fetchReference(Reference $reference): void {
+        if ($this->userId === null) {
+            throw new NotFoundException();
+        }
+
+        $fileId = $this->getFilesAppLinkId($reference->getId());
+        if ($fileId === null) {
+            throw new NotFoundException();
+        }
+
+        try {
+            $userFolder = $this->rootFolder->getUserFolder($this->userId);
+            $files = $userFolder->getById($fileId);
+
+            if (empty($files)) {
+                throw new NotFoundException();
+            }
+
+            /** @var Node $file */
+            $file = array_shift($files);
+
+            $reference->setTitle($file->getName());
+            $reference->setDescription($file->getMimetype());
+            $reference->setUrl($this->urlGenerator->getAbsoluteURL('/index.php/f/' . $fileId));
+            if ($this->previewManager->isMimeSupported($file->getMimeType())) {
+                $reference->setImageUrl($this->urlGenerator->linkToRouteAbsolute('core.Preview.getPreviewByFileId', ['x' => 1600, 'y' => 630, 'fileId' => $fileId]));
+            } else {
+                $fileTypeIconUrl = $this->mimeTypeDetector->mimeTypeIcon($file->getMimeType());
+                $reference->setImageUrl($fileTypeIconUrl);
+            }
+
+            $reference->setRichObject('file', [
+                'id' => $file->getId(),
+                'name' => $file->getName(),
+                'size' => $file->getSize(),
+                'path' => $userFolder->getRelativePath($file->getPath()),
+                'link' => $reference->getUrl(),
+                'mimetype' => $file->getMimetype(),
+                'mtime' => $file->getMTime(),
+                'preview-available' => $this->previewManager->isAvailable($file)
+            ]);
+        } catch (InvalidPathException|NotFoundException|NotPermittedException|NoUserException $e) {
+            throw new NotFoundException();
+        }
+    }
+
+    public function getCachePrefix(string $referenceId): string {
+        return (string)$this->getFilesAppLinkId($referenceId);
+    }
+
+    public function getCacheKey(string $referenceId): ?string {
+        return $this->userId ?? '';
+    }
+
+    public function getId(): string {
+        return 'files';
+    }
+
+    public function getTitle(): string {
+        return $this->l10n->t('Files');
+    }
+
+    public function getOrder(): int {
+        return 0;
+    }
+
+    public function getIconUrl(): string {
+        return $this->urlGenerator->imagePath('files', 'folder.svg');
+    }
 }

apps/files/lib/Listener/RenderReferenceEventListener.php

Indentation +6 added lines, -6 removed lines

@@ -29,11 +29,11 @@
 use OCP\EventDispatcher\IEventListener;
 
 class RenderReferenceEventListener implements IEventListener {
-	public function handle(Event $event): void {
-		if (!$event instanceof RenderReferenceEvent) {
-			return;
-		}
+    public function handle(Event $event): void {
+        if (!$event instanceof RenderReferenceEvent) {
+            return;
+        }
 
-		\OCP\Util::addScript('files', 'reference-files');
-	}
+        \OCP\Util::addScript('files', 'reference-files');
+    }
 }

apps/files/lib/AppInfo/Application.php

Indentation +113 added lines, -113 removed lines

@@ -69,119 +69,119 @@
 use Psr\Container\ContainerInterface;
 
 class Application extends App implements IBootstrap {
-	public const APP_ID = 'files';
-
-	public function __construct(array $urlParams = []) {
-		parent::__construct(self::APP_ID, $urlParams);
-	}
-
-	public function register(IRegistrationContext $context): void {
-		/**
-		 * Controllers
-		 */
-		$context->registerService('APIController', function (ContainerInterface $c) {
-			/** @var IServerContainer $server */
-			$server = $c->get(IServerContainer::class);
-
-			return new ApiController(
-				$c->get('AppName'),
-				$c->get(IRequest::class),
-				$c->get(IUserSession::class),
-				$c->get(TagService::class),
-				$c->get(IPreview::class),
-				$c->get(IShareManager::class),
-				$c->get(IConfig::class),
-				$server->getUserFolder(),
-				$c->get(UserConfig::class),
-			);
-		});
-
-		/**
-		 * Services
-		 */
-		$context->registerService(TagService::class, function (ContainerInterface $c) {
-			/** @var IServerContainer $server */
-			$server = $c->get(IServerContainer::class);
-
-			return new TagService(
-				$c->get(IUserSession::class),
-				$c->get(IActivityManager::class),
-				$c->get(ITagManager::class)->load(self::APP_ID),
-				$server->getUserFolder(),
-				$server->getEventDispatcher()
-			);
-		});
-
-		/*
+    public const APP_ID = 'files';
+
+    public function __construct(array $urlParams = []) {
+        parent::__construct(self::APP_ID, $urlParams);
+    }
+
+    public function register(IRegistrationContext $context): void {
+        /**
+         * Controllers
+         */
+        $context->registerService('APIController', function (ContainerInterface $c) {
+            /** @var IServerContainer $server */
+            $server = $c->get(IServerContainer::class);
+
+            return new ApiController(
+                $c->get('AppName'),
+                $c->get(IRequest::class),
+                $c->get(IUserSession::class),
+                $c->get(TagService::class),
+                $c->get(IPreview::class),
+                $c->get(IShareManager::class),
+                $c->get(IConfig::class),
+                $server->getUserFolder(),
+                $c->get(UserConfig::class),
+            );
+        });
+
+        /**
+         * Services
+         */
+        $context->registerService(TagService::class, function (ContainerInterface $c) {
+            /** @var IServerContainer $server */
+            $server = $c->get(IServerContainer::class);
+
+            return new TagService(
+                $c->get(IUserSession::class),
+                $c->get(IActivityManager::class),
+                $c->get(ITagManager::class)->load(self::APP_ID),
+                $server->getUserFolder(),
+                $server->getEventDispatcher()
+            );
+        });
+
+        /*
 		 * Register capabilities
 		 */
-		$context->registerCapability(Capabilities::class);
-		$context->registerCapability(DirectEditingCapabilities::class);
-
-		$context->registerEventListener(LoadAdditionalScriptsEvent::class, LegacyLoadAdditionalScriptsAdapter::class);
-		$context->registerEventListener(LoadSidebar::class, LoadSidebarListener::class);
-		$context->registerEventListener(RenderReferenceEvent::class, RenderReferenceEventListener::class);
-
-		$context->registerSearchProvider(FilesSearchProvider::class);
-
-		$context->registerNotifierService(Notifier::class);
-	}
-
-	public function boot(IBootContext $context): void {
-		$context->injectFn(Closure::fromCallable([$this, 'registerCollaboration']));
-		$context->injectFn([Listener::class, 'register']);
-		$context->injectFn(Closure::fromCallable([$this, 'registerSearchProvider']));
-		$this->registerTemplates();
-		$context->injectFn(Closure::fromCallable([$this, 'registerNavigation']));
-		$this->registerHooks();
-	}
-
-	private function registerCollaboration(IProviderManager $providerManager): void {
-		$providerManager->registerResourceProvider(ResourceProvider::class);
-	}
-
-	private function registerSearchProvider(ISearch $search): void {
-		$search->registerProvider(File::class, ['apps' => ['files']]);
-	}
-
-	private function registerTemplates(): void {
-		$templateManager = \OC_Helper::getFileTemplateManager();
-		$templateManager->registerTemplate('application/vnd.oasis.opendocument.presentation', 'core/templates/filetemplates/template.odp');
-		$templateManager->registerTemplate('application/vnd.oasis.opendocument.text', 'core/templates/filetemplates/template.odt');
-		$templateManager->registerTemplate('application/vnd.oasis.opendocument.spreadsheet', 'core/templates/filetemplates/template.ods');
-	}
-
-	private function registerNavigation(IL10N $l10n): void {
-		\OCA\Files\App::getNavigationManager()->add(function () use ($l10n) {
-			return [
-				'id' => 'files',
-				'appname' => 'files',
-				'script' => 'list.php',
-				'order' => 0,
-				'name' => $l10n->t('All files')
-			];
-		});
-		\OCA\Files\App::getNavigationManager()->add(function () use ($l10n) {
-			return [
-				'id' => 'recent',
-				'appname' => 'files',
-				'script' => 'recentlist.php',
-				'order' => 2,
-				'name' => $l10n->t('Recent')
-			];
-		});
-		\OCA\Files\App::getNavigationManager()->add(function () use ($l10n) {
-			return [
-				'id' => 'favorites',
-				'appname' => 'files',
-				'script' => 'simplelist.php',
-				'order' => 5,
-				'name' => $l10n->t('Favorites'),
-			];
-		});
-	}
-
-	private function registerHooks(): void {
-		Util::connectHook('\OCP\Config', 'js', '\OCA\Files\App', 'extendJsConfig');
-	}
+        $context->registerCapability(Capabilities::class);
+        $context->registerCapability(DirectEditingCapabilities::class);
+
+        $context->registerEventListener(LoadAdditionalScriptsEvent::class, LegacyLoadAdditionalScriptsAdapter::class);
+        $context->registerEventListener(LoadSidebar::class, LoadSidebarListener::class);
+        $context->registerEventListener(RenderReferenceEvent::class, RenderReferenceEventListener::class);
+
+        $context->registerSearchProvider(FilesSearchProvider::class);
+
+        $context->registerNotifierService(Notifier::class);
+    }
+
+    public function boot(IBootContext $context): void {
+        $context->injectFn(Closure::fromCallable([$this, 'registerCollaboration']));
+        $context->injectFn([Listener::class, 'register']);
+        $context->injectFn(Closure::fromCallable([$this, 'registerSearchProvider']));
+        $this->registerTemplates();
+        $context->injectFn(Closure::fromCallable([$this, 'registerNavigation']));
+        $this->registerHooks();
+    }
+
+    private function registerCollaboration(IProviderManager $providerManager): void {
+        $providerManager->registerResourceProvider(ResourceProvider::class);
+    }
+
+    private function registerSearchProvider(ISearch $search): void {
+        $search->registerProvider(File::class, ['apps' => ['files']]);
+    }
+
+    private function registerTemplates(): void {
+        $templateManager = \OC_Helper::getFileTemplateManager();
+        $templateManager->registerTemplate('application/vnd.oasis.opendocument.presentation', 'core/templates/filetemplates/template.odp');
+        $templateManager->registerTemplate('application/vnd.oasis.opendocument.text', 'core/templates/filetemplates/template.odt');
+        $templateManager->registerTemplate('application/vnd.oasis.opendocument.spreadsheet', 'core/templates/filetemplates/template.ods');
+    }
+
+    private function registerNavigation(IL10N $l10n): void {
+        \OCA\Files\App::getNavigationManager()->add(function () use ($l10n) {
+            return [
+                'id' => 'files',
+                'appname' => 'files',
+                'script' => 'list.php',
+                'order' => 0,
+                'name' => $l10n->t('All files')
+            ];
+        });
+        \OCA\Files\App::getNavigationManager()->add(function () use ($l10n) {
+            return [
+                'id' => 'recent',
+                'appname' => 'files',
+                'script' => 'recentlist.php',
+                'order' => 2,
+                'name' => $l10n->t('Recent')
+            ];
+        });
+        \OCA\Files\App::getNavigationManager()->add(function () use ($l10n) {
+            return [
+                'id' => 'favorites',
+                'appname' => 'files',
+                'script' => 'simplelist.php',
+                'order' => 5,
+                'name' => $l10n->t('Favorites'),
+            ];
+        });
+    }
+
+    private function registerHooks(): void {
+        Util::connectHook('\OCP\Config', 'js', '\OCA\Files\App', 'extendJsConfig');
+    }
 }