plasma-framework/templates/cpp-plasmoid
Friedrich W. H. Kossebau 98e64e01a6 Templates: consistent naming, fix translation catalog names & more
Summary:
* remove unneeded cmake includes
* consistently use org.kde.plasma.* prefix for names
* fix catalog names to match applet identifier
* bump min cmake version to 3.0
* remove duplicated X-KDE-PluginInfo-Name entries
* remove no longer (Plasma >=5.8) needed i18nd in wallpaper code
* prepare qml extension for ki18n usage

Reviewers: mart

Reviewed By: mart

Subscribers: kde-frameworks-devel, apol

Tags: #frameworks

Differential Revision: https://phabricator.kde.org/D10848
2018-05-21 14:08:04 +02:00
..
src Templates: consistent naming, fix translation catalog names & more 2018-05-21 14:08:04 +02:00
CMakeLists.txt Templates: consistent naming, fix translation catalog names & more 2018-05-21 14:08:04 +02:00
cpp-plasmoid.kdevtemplate SVN_SILENT made messages (.desktop file) - always resolve ours 2018-05-10 05:25:52 +02:00
cpp-plasmoid.png make preview naming consistent with template name 2015-12-03 02:28:58 +01:00
Messages.sh Templates: consistent naming, fix translation catalog names & more 2018-05-21 14:08:04 +02:00
README Templates: consistent naming, fix translation catalog names & more 2018-05-21 14:08:04 +02:00

Plasma Applet mixed C++/QML 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/applet/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 applet 
(in a terminal type: 
kquitapp plasmashell 
and then
plasmashell)

or view it with 
plasmoidviewer -a YourAppletName

-- Tutorials and resources --
The explanation of the template
https://techbase.kde.org/Development/Tutorials/Plasma5/QML2/GettingStarted

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