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 (will be removed with v12)

web-runtime

• ApplicationMenuItem and applicationMenu prop of ApplicationInformation - Register app menu items via the appMenuExtensionPoint instead (feat: add extension point for application menu items #11258)
• ApplicationQuickAction - Register quick actions as extension instead (refactor: register file quick actions as extensions #10102)
• isFileEditor prop of ApplicationInformation (67ce21c)
• type prop of ApplicationInformation (5e8ac91)

web-pkg

• ocsUserContext and ocsPublicLinkContext of ClientService - use ocs instead (refactor: use request interceptors in client service  #11656)

web-client

• client init method - Use graph(), ocs() and webdav() to initialize and use clients (refactor: use request interceptors in client service  #11656)

Already removed

Version 9

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.

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.