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 https://github.com/nextcloud/server/pull/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: https://github.com/nextcloud/server/pull/35872
• OCP\Accounts\IAccountManager::PROPERTY_DISPLAYNAME_LEGACY was added to be used for keeping the provisioning API compatible: https://github.com/nextcloud/server/pull/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. #37542
• A new OCP API under OCP\SpeechToText was introduced to allow automatic transcription of media: #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: https://github.com/nextcloud/server/pull/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. https://github.com/nextcloud/server/pull/37929 + https://github.com/nextcloud/server/pull/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. https://github.com/nextcloud/server/pull/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: https://github.com/nextcloud/server/pull/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: https://github.com/nextcloud/server/pull/35872

Deprecations of Events & Hooks

• …

Behavorial changes

• CacheEntryRemovedEvent will now be dispatched for all files and folders inside the deleted node. https://github.com/nextcloud/server/pull/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. https://github.com/nextcloud/server/pull/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: https://github.com/nextcloud/server/pull/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: https://github.com/nextcloud/server/pull/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: https://github.com/nextcloud/server/pull/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. #37542

[marcelklehr]

Added:

Backend

• A new OCP API under OCP\SpeechToText was introduced to allow automatic transcription of media: #37674

[nickvergessen]

Added:

Backend

• BruteForceProtection can now be enabled using a native PHP attribute #36928 https://github.com/nextcloud/documentation/pull/9742

[nickvergessen]

Added:

Backend

• Rate limits can now be enabled using native PHP attributes https://github.com/nextcloud/server/pull/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: https://github.com/nextcloud/server/pull/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. https://github.com/nextcloud/server/pull/37929 + https://github.com/nextcloud/server/pull/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. https://github.com/nextcloud/server/pull/32866
• As a result usersInGroup from GroupInterface is deprecated.

[skjnldsv]

Added:

Front-end

• Files Router API https://github.com/nextcloud/server/pull/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. https://github.com/nextcloud/server/pull/38003

[nickvergessen]

Copied over to the docs. Please send new things directly to the documentation repo: https://github.com/nextcloud/documentation/pull/10414