Deprecations

[kulmann]

The purpose of this issue is to keep track of deprecations and dates of code removal. Please subscribe to this issue if you are a developer and want to stay informed about deprecations / code deletion.

Upcoming

registering quick actions via the quickactions property of an app

• deprecated on 2023-12-01
• to be removed in major version 9
• migration: register quick actions via extension registry as type action and with scope files.quick-action
• reasoning: the extension registry was built exactly for things like this and is the new way of registering extended functionality for apps. It's also more comfortable to work with since extensions are always built in Vue's injection context, which let's you use e.g. composables.

vuex modal implementation

• deprecated on 2023-12-22
• to be removed in major version 9
• migration: use the new composable for creating modals: useModals(). See refactor: modal implementation #10212 for more details on the changes.
• reasoning: we want to get rid of the vuex store.

OCS user

• deprecated on 2024-01-03
• to be removed in major version 9
• migration: use the graph user from @ownclouders/web-client/src/helpers. This also means that the quota needs to be handled on a user's personal drive instead of on the user itself. Furthermore, retrieving the user from the vuex store is no longer possible. Use the new pinia composable instead: useUserStore. See refactor: move vuex user to pinia #10240 for more details on the changes.
• reasoning: the OCS API is deprecated and we're slowly transitioning to the Graph API and we want to get rid of the vuex store.

vuex store removal

• deprecated on 2024-01-22
• to be removed in major version 9
• migration: see refactor: remove vuex store #10372 for a full list of changes and how to migrate to the new pinia stores.
• reasoning: we removed the vuex store in favour of pinia because it gives us proper typing and integrates seamlessly into composition API.

home folder option

• deprecated on 2024-01-05
• to be removed in major version 9
• migration: use spaces (see chore: remove homeFolder option #10122 for more details).
• reasoning: this was originally implemented and used by CERN but isn't needed anymore.

Already removed

Version 6

web runtime

getToken getter in the user store module (global namespace)

• deprecated on 2022-07-07
• to be removed in major version 6
• migration: use the runtime/auth/accessToken getter
• reasoning: user state is not supposed to deal with authentication details. We introduced the namespaced auth module for user and public-link related authentication contexts.

mediaSource helper function and v-image-source directive

• deprecated on 2022-07-27
• to be removed in major version 6
• migration: use loadPreview from web-pkg when it's published. Unfortunately it's not published yet.
• reasoning: loadPreview is the new default mechanism. We want to get rid of magical everywhere-available helpers.

Version 8

admin settings

app was renamed from user-management to admin-settings

• deprecated on tbd (when version 7 is released)
• to be removed in major version 8
• migration: use the name admin-settings when referencing the app (in your configs for example)
• reasoning: the app is supposed to hold a variety of general settings in the future, not just user-related settings.