plasma-framework

History

Nate Graham 5447cef2d8 Port to singleton Units The context property version is slower to access and won't be supported in Qt6. Let's port away from it and use the singleton version instead. Here was my full process for making this change: 1. Made the change with `find . -name '*.qml' \| xargs perl -pi -e 's/units\./PlasmaCore\.Units\./g'` 2. Verified no more occurrences with `grep -r " units."` 3. Made sure this didn't change any comments in a silly way by inspecting the output of `git diff \| grep "+ " \| grep "//"` 4. Manually inspected the full git diff to make sure there were no other unintentional or silly changes (there were none) 5. verified that all changed files have the PlasmaCore import with the correct name with `for FILE in `git status \| grep modified \| cut -d ":" -f 3`; do grep -q "as PlasmaCore" $FILE \|\| echo "$FILE needs the PlasmaCore import"; done` (one needed the import)		2021-03-07 13:34:47 +00:00
..
LICENSES	templates: Convert license statements to SPDX headers	2020-02-29 13:25:01 +01:00
package	Port to singleton Units	2021-03-07 13:34:47 +00:00
CMakeLists.txt	Remove explicit use of ECM_KDE_MODULE_DIR, part of ECM_MODULE_PATH	2019-01-19 16:09:29 +01:00
Messages.sh	Add a kapptemplate for Plasma Wallpaper	2016-08-05 16:02:14 +02:00
plasma-wallpaper.kdevtemplate	SVN_SILENT made messages (.desktop file) - always resolve ours	2020-09-08 06:34:57 +02:00
README	Templates: consistent naming, fix translation catalog names & more	2018-05-21 14:08:04 +02:00

README

Plasma Wallpaper Template
----------------------

-- Namespace adaption --

Each Plasma plugin has a unique identifier, which is also used to find related
resources (like the translation catalogs).
To avoid naming collisions, Plasma plugins use a reverse domain name notation
for that identifier:

* org.kde.plasma.* - plugins coming from Plasma modules
* org.kde.*        - plugins coming from other software from KDE
* $(my.domain).*   - plugins of your 3rd-party

The generated code uses the "org.kde.plasma" namespace for the plugin identifier.
As this namespace is reserved for use by plugins part of Plasma modules, you will
need to adapt this namespace if you are writing a plugin which is not intended to
end up in the Plasma modules.


-- Build instructions --

cd /where/your/wallpaper/is/generated
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=MYPREFIX ..
make
make install

(MYPREFIX is where you install your Plasma setup, replace it accordingly)

Restart plasma to load the wallpaper
(in a terminal or in krunner type:
kquitapp plasmashell
and then
plasmashell)
then go to wallpaper settings and select it

-- Tutorials and resources --
Plasma QML API explained
https://techbase.kde.org/Development/Tutorials/Plasma2/QML2/API