Changes for developers & admins for Nextcloud 27

[nickvergessen]

Continuation of #34692

Readme

📝 Please always leave a comment when editing, so subscribed developers and admins are notified.

Front-end

• Files Router API feat(files): add default action support and expose router #37824
  Allows you to control the files router service and update views, querys or param without page reload

  // https://github.com/nextcloud/server/blob/master/apps/files/src/services/RouterService.ts
  OCP.Files.Router.goTo('/trashbin?dir=/Unsplash.d1680193199')
  OCP.Files.Router.goToRoute('fileslist', { view: 'files' }, { dir: '/Folders/Group folder' })

• ...

Backend

• \OCP\AppFramework\Utility\ITimeFactory is now a \PSR\Clock\ClockInterface following the PSR-20 standard. Therefore ITimeFactory::getTime and ITimeFactory::getDateTime were deprecated: feat(appframework): ⌚ Make ITimeFactory extend \PSR\Clock\ClockInterface #35872
• OCP\Accounts\IAccountManager::PROPERTY_DISPLAYNAME_LEGACY was added to be used for keeping the provisioning API compatible: Always set displayname and display-name for user data #36665
• A new system config ratelimit.protection.enabled (boolean, default true) was added to allow developers to disable rate limiting. It is not recommended to disable this on a production/live system. feat(security): Allow to opt-out of ratelimit protection, e.g. for te… #37542
• A new OCP API under OCP\SpeechToText was introduced to allow automatic transcription of media: feat(SpeechToText): Add SpeechToText OCP provider API #37674
• Added a new interface OCP\BackgroundJob\IParallelAwareJob that OCP\BackgroundJob\Job now implements. It can be used to allow specifying that multiple instances of a job should not be run at the same time. Also added IJobList#hasReservedJob($className = null) method for this: feat(BackgroundJobs): Allow preventing parallel runs for a job class #37835
• A new property has been added to the \OCP\Files\Template\TemplateFileCreator class with a respective setter and getter. Namely the TemplateFileCreator::$actionLabel protected property and TemplateFileCreator::setActionLabel + TemplateFileCreator::getActionLabel public methods. Create new file/folder labels #37929 + fix: Empty fallback for template creator action label #37955
• A new interface OCP\Group\Backend\ISearchableGroupBackend was added for group backends supporting new method searchInGroup to search among a group users in an efficient way. Optimize retrieving display name when searching for users in a group #32866
• As a result usersInGroup from GroupInterface is deprecated.

Removed from public namespace:

• Intermediate transition event classes OCP\WorkflowEngine\IEntityCompat and OCP\WorkflowEngine\IOperationCompat have been removed as advertised for 2023: techdebt(workflowengine): Remove transition event classes #37040

Removed from private namespace:

• …

Deprecations

• \OCP\AppFramework\Utility\ITimeFactory is now a \PSR\Clock\ClockInterface following the PSR-20 standard. Therefore ITimeFactory::getTime and ITimeFactory::getDateTime were deprecated: feat(appframework): ⌚ Make ITimeFactory extend \PSR\Clock\ClockInterface #35872

Deprecations of Events & Hooks

• …

Behavorial changes

• CacheEntryRemovedEvent will now be dispatched for all files and folders inside the deleted node. Dispatch event for all removed entries #34773

Client APIs

• The OCS translation API was extended to return the from language attribute so in case no from was given, clients can afterwards show in the UI which language was detected and used for translating. Improve translations api with detecting languages #38003

Changes for admins

• …

[nickvergessen]

Added:

Removed from public namespace:

• Intermediate transition event classes OCP\WorkflowEngine\IEntityCompat and OCP\WorkflowEngine\IOperationCompat have been removed as advertised for 2023: techdebt(workflowengine): Remove transition event classes #37040

[nickvergessen]

Added:

Backend

• \OCP\AppFramework\Utility\ITimeFactory is now a \PSR\Clock\ClockInterface following the PSR-20 standard. Therefore ITimeFactory::getTime and ITimeFactory::getDateTime were deprecated: feat(appframework): ⌚ Make ITimeFactory extend \PSR\Clock\ClockInterface #35872

[artonge]

Added:

Behavorial changes

* `CacheEntryRemovedEvent` will now be dispatched for all files and folders inside the deleted node.

[provokateurin]

Added:

Backend

• OCP\Accounts\IAccountManager::PROPERTY_DISPLAYNAME_LEGACY was added to be used for keeping the provisioning API compatible: Always set displayname and display-name for user data #36665

[nickvergessen]

Added:

Backend

• A new system config ratelimit.protection.enabled (boolean, default true) was added to allow developers to disable rate limiting. It is not recommended to disable this on a production/live system. feat(security): Allow to opt-out of ratelimit protection, e.g. for te… #37542

[marcelklehr]

Added:

Backend

• A new OCP API under OCP\SpeechToText was introduced to allow automatic transcription of media: feat(SpeechToText): Add SpeechToText OCP provider API #37674

[nickvergessen]

Added:

Backend

• BruteForceProtection can now be enabled using a native PHP attribute feat(middleware): Migrate BruteForceProtection annotation to PHP Attribute and allow multiple #36928 feat(bruteforce): Document the new BruteForceProtection attribute documentation#9742

[nickvergessen]

Added:

Backend

• Rate limits can now be enabled using native PHP attributes feat(ratelimit): Add Attributes support to rate limit middleware #37864 https://docs.nextcloud.com//server/stable/developer_manual/basics/controllers.html#rate-limiting

Deprecations

• @BruteForceProtection annotation for controllers is now deprecated in favor of the #[BruteForceProtection] attribute https://docs.nextcloud.com//server/stable/developer_manual/basics/controllers.html#brute-force-protection
• @UserRateThrottle annotation for controllers is now deprecated in favor of the #[UserRateLimit] attribute https://docs.nextcloud.com//server/stable/developer_manual/basics/controllers.html#rate-limiting
• @AnonRateThrottle annotation for controllers is now deprecated in favor of the #[AnonRateLimit] attribute https://docs.nextcloud.com//server/stable/developer_manual/basics/controllers.html#rate-limiting

[marcelklehr]

Added:

Backend

• Added a new interface OCP\BackgroundJob\IParallelAwareJob that OCP\BackgroundJob\Job now implements. It can be used to allow specifying that multiple instances of a job should not be run at the same time. Also added IJobList#hasReservedJob($className = null) method for this: feat(BackgroundJobs): Allow preventing parallel runs for a job class #37835

[Pytal]

Added:

Backend

• A new property has been added to the \OCP\Files\Template\TemplateFileCreator class with a respective setter and getter. Namely the TemplateFileCreator::$actionLabel protected property and TemplateFileCreator::setActionLabel + TemplateFileCreator::getActionLabel public methods. Create new file/folder labels #37929 + fix: Empty fallback for template creator action label #37955

[come-nc]

Added:

Backend

• A new interface OCP\Group\Backend\ISearchableGroupBackend was added for group backends supporting new method searchInGroup to search among a group users in an efficient way. Optimize retrieving display name when searching for users in a group #32866
• As a result usersInGroup from GroupInterface is deprecated.

[skjnldsv]

Added:

Front-end

• Files Router API feat(files): add default action support and expose router #37824
  Allows you to control the files router service and update views, querys or param without page reload

  // https://github.com/nextcloud/server/blob/master/apps/files/src/services/RouterService.ts
  OCP.Files.Router.goTo('/trashbin?dir=/Unsplash.d1680193199')
  OCP.Files.Router.goToRoute('fileslist', { view: 'files' }, { dir: '/Folders/Group folder' })

[nickvergessen]

Added:

Client APIs

• The OCS translation API was extended to return the from language attribute so in case no from was given, clients can afterwards show in the UI which language was detected and used for translating. Improve translations api with detecting languages #38003

[nickvergessen]

Copied over to the docs.
Please send new things directly to the documentation repo:
nextcloud/documentation#10414