Changes for developers & admins for Nextcloud 25

Continuation of #29914

Front-end

Theming redone: [stable25] New theming, how to make your app compatible #32060
body.theme--dark classes removed. See above
SCSS support removed! ⚠️ [stable25] New theming, how to make your app compatible #32060
https://help.nextcloud.com/t/scss-support-dropped-with-nextcloud-25/
Files app ID changes in the DOM, to remove duplicate IDs for accessibility:
Non-Vue dialogs will stop working if triggered on top of Vue dialogs because of focus trap, example here: Port password confirmation dialog to vue #33675.
We changed the container layout to adapt to the design changes with Nextcloud 25
- The body is no longer the main scroll area but instead the app content
- ⚗️ Proof of concept: Redesign app-content #33568
- Scroll listeners need to be adapted to watch for the scroll on the NcAppContent container instead of the main document
- If you are using sticky headers in your app you might need to adjust the css top property as the app content container is now the scrollable element. For any contained sticky that had a header height top spacing before you should be able to set that to 0
- If @nextcloud/vue components are used you'll need to update to the major release 7 of the library
  - Migration help for that can be found in https://github.com/nextcloud/nextcloud-vue/blob/master/CHANGELOG.md#v700-beta0-2022-09-01
  - v6.0.0 included a rename of the components to be prefixed with Nc which is something that would also be required if not already done
A global option to disable keyboard shortcuts was added to the accessibility settings. Since it heavily depends on the screenreader and tools that you use if Ctrl and/or Alt or other things are okay to use or not and maintaining a more detailed list is too much effort, we went for a global on/off switch. Apps can use this public javascript API call to determine whether the user used the opt-out: OCP.Accessibility.disableKeyboardShortcuts(). If that is the case, no additional shortcuts shall be registered by any app. Only space to toggle checkboxes and enter to submit the currently active buttons/links are okay: Add global setting to disable keyboad shortcuts #34081

Backend

The christophwurst/nextcloud composer package was replaced with a now Nextcloud owned nextcloud/ocp package. The content is the same and all older versions were generated, so you can transition right away no matter which versions you support. We also have a GitHub Actions cron job template available at https://github.com/nextcloud/.github/blob/master/workflow-templates/update-nextcloud-ocp.yml which updates the packages every sunday, so you can make sure your app is still compatible with the latest OCP.
CSP policies now have merge priority: true wins over false: Add CSP policy merge priority for booleans #32113
IShareProvider::getSharesInFolder now has a new argument $shallow to support shallow and deep searches of shares in a folder. Update owner of subdir on move into/out of share #31728
Use IUserManager::getDisplayName(): ?string when you only want the display name of the user. This will avoid fetching all the user properties and generating useless DB/LDAP queries
Use \OCP\Server::get(className) instead of the private \OC::$server->get when dependency injection is not possible.
Dashboard widgets are soon displayed in the mobile clients. With Extend dashboard api to allow listing of widgets #33658 buttons to see more information can be added and you can now already implement your widget as an OCP\Dashboard\IAPIWidget so the data is available to the clients. Also check the new documentation https://docs.nextcloud.com/server/latest/developer_manual/digging_deeper/dashboard.html
ICreateFromString::handleIMipMessage(string $name, string $calendarData) must be supported

Removed from public namespace:

…

Removed from private namespace:

…

Deprecations

…

Deprecations of Events & Hooks

Deprecate \OCP\Collaboration\Resources::loadAdditionalScripts Add event to load additional scripts for projects #32349

Behavorial changes

…

Changes for admins

Probably #33320 should be mentioned, I know some applications relying on those ids

Added:

Backend

Dashboard widgets are soon displayed in the mobile clients. With Extend dashboard api to allow listing of widgets #33658 buttons to see more information can be added and you can now already implement your widget as an OCP\Dashboard\IAPIWidget so the data is available to the clients

Added:

Frontend

A global option to disable keyboard shortcuts was added to the accessibility settings. Since it heavily depends on the screenreader and tools that you use if Ctrl and/or Alt or other things are okay to use or not and maintaining a more detailed list is too much effort, we went for a global on/off switch. Apps can use this public javascript API call to determine whether the user used the opt-out: OCP.Accessibility.disableKeyboardShortcuts(). If that is the case, no additional shortcuts shall be registered by any app. Only space to toggle checkboxes and enter to submit the currently active buttons/links are okay: Add global setting to disable keyboad shortcuts #34081

<default_enable/> within info.xml will not work anymore. The listing of app enabled by default during installation of Nextcloud is now done within core/shipped.json, using key defaultEnabled

Added:

Backend

The christophwurst/nextcloud composer package was replaced with a now Nextcloud owned nextcloud/ocp package. The content is the same and all older versions were generated, so you can transition right away no matter which versions you support. We also have a GitHub Actions cron job template available at https://github.com/nextcloud/.github/blob/master/workflow-templates/update-nextcloud-ocp.yml which updates the packages every sunday, so you can make sure your app is still compatible with the latest OCP.

@nickvergessen

@nickvergessen @ChristophWurst

Added:

Backend

The christophwurst/nextcloud composer package was replaced with a now Nextcloud owned nextcloud/ocp package. The content is the same and all older versions were generated, so you can transition right away no matter which versions you support. We also have a GitHub Actions cron job template available at https://github.com/nextcloud/.github/blob/master/workflow-templates/update-nextcloud-ocp.yml which updates the packages every sunday, so you can make sure your app is still compatible with the latest OCP.

Sorry for disturbing this meta issue, but

there is no possibility to create issues in the new OCP repository: https://github.com/nextcloud-deps/ocp . Please allow issues over there!
there is no (beta) release for 25 on Packagist: https://packagist.org/packages/nextcloud/ocp . Could you please release a release? That would help apps preparing for the next server release.

Thanks!

there is no (beta) release for 25 on Packagist: https://packagist.org/packages/nextcloud/ocp . Could you please release a release? That would help apps preparing for the next server release.

Instead of working with releases you should use the dev-stable25 branch:
https://github.com/nextcloud/spreed/blob/stable25/composer.json#L45

There is also a github action cron job available which updates this on a weekly basis so you immediately know when the target + your app is not compatible anymore.

there is no possibility to create issues in the new OCP repository: https://github.com/nextcloud-deps/ocp . Please allow issues over there!

This was because it's a fork of the old location. Enabled.

26 list in Changes for developers & admins for Nextcloud 26 #34692

@CarlSchwan

#32363 from @CarlSchwan

Breaking change backend:

#33001 - ICreateFromString

/**
	 * @since 25.0.0
	 *
	 * @throws CalendarException
	 */
	public function handleIMipMessage(string $name, string $calendarData): void;

must be supported

Added

ICreateFromString::handleIMipMessage(string $name, string $calendarData) must be supported

26 follow up in #34692

Navigation Menu

Repository navigation

Changes for developers & admins for Nextcloud 25 #32117

Front-end

Backend

Removed from public namespace:

Removed from private namespace:

Deprecations

Deprecations of Events & Hooks

Behavorial changes

Changes for admins

Backend

Frontend

Backend

Backend

Added

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Changes for developers & admins for Nextcloud 25 #32117

Description

Front-end

Backend

Removed from public namespace:

Removed from private namespace:

Deprecations

Deprecations of Events & Hooks

Behavorial changes

Changes for admins

Activity

susnux commented on Jul 26, 2022

nickvergessen commented on Sep 13, 2022

Backend

nickvergessen commented on Sep 15, 2022

Frontend

ArtificialOwl commented on Sep 18, 2022

nickvergessen commented on Sep 27, 2022

Backend

korelstar commented on Oct 2, 2022

Backend

nickvergessen commented on Oct 2, 2022

nickvergessen commented on Oct 20, 2022

come-nc commented on Oct 24, 2022

miaulalala commented on Nov 8, 2022

Added

Happy86 commented on Nov 22, 2022

Happy86 commented on Nov 22, 2022

nickvergessen commented on Feb 21, 2023

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions