Follow-up from "Add docs for migration of plasma 5 themes to plasma 6"
The following discussions from !345 (closed) should be addressed:
-
@thiagosueto started a discussion: Probably just an accident rather than intentional
😸 ## Renamed QML Imports
-
@thiagosueto started a discussion: Let's make different topics be full paragraphs (so it's easier to scan the text for useful info) and use lists.
Custom Lock Screens of your theme are normally placed in `contents/lockscreen/LockScreen.qml` and need to be adapted for Plasma 6. The handling of the kscreenlocker-provided `authenticator` object has been changed due to support for passwordless authentication. If your Plasma 5 theme is using a `Connections { target: authenticator }`, the event listeners for that connection need to be adapted for Plasma 6: * The listener `onPrompt` was changed to `onPromptChanged` * The listeners `onInfoMessage`/`onErrorMessage` were changed to `onInfoMessageChanged`/`onErrorMessageChanged`.
-
@thiagosueto started a discussion: The Plasma 6 Lock Screen authentication process is now started with `authenticator.startAuthenticating()` instead of the previously used `authenticator.tryUnlock()`. The `onPromptForSecret` event listener was renamed to `onPromptForSecretChanged`. The transmission of the actual password via `authenticator.respond(myPasswordInput.text)` remains the same as before.
-
@thiagosueto started a discussion: ## Changes for custom Window Switchers (KWin TabBox)
-
@thiagosueto started a discussion: If your theme uses a Window Switcher (called a `TabBox` within KWin), please note that it is also affected by the renaming of QML imports. There are some specific KWin renames that might affect custom Window Switchers such as from `KWin.WindowThumbnailItem` to `KWin.WindowThumbnail` which are mostly documented in the [KWin source code repository](https://invent.kde.org/plasma/kwin).
-
@thiagosueto started a discussion: Certain imports for SDDM themes have been changed: `import QtGraphicalEffect` should become `import Qt5Compat.GraphicalEffects` in order to work with Qt6. As SDDM themes are not the main focus of this article, theme creators should consult the SDDM documentation for further details.
-
@thiagosueto started a discussion: Layout scripts such as `contents/layouts/org.kde.plasma.desktop-layout.js` have not changed very much. The API mostly stays the same. The version of the Plasma Javascript Scripting API that is frequently used in boilerplate code such as `var plasma = getApiVersion(1);` has not been changed. However, the configuration options for panels and widgets have been adapted due to the introduction of new features, such as the floating panel setting. Further details should be looked up in the [Plasma 6 source code repository](https://invent.kde.org/plasma/plasma-workspace).
Shouldn't it be plasma-framework though?
-
@ngraham started a discussion: @thiagosueto given the proximity to the release and the lack of changes in the past week, how do you feel about merging this now and we make your proposed changes afterwards? Better to have something rather than nothing etc.