Development/Tutorials/Plasma4/ContainmentAction
You can use Plasma ContainmentAction e.g. for Context Menus on your Plasma Desktop. They will run as plugins meaning you can add and remove them after compilation. If they exist, their name will be stored in .desktop files.
Example
A simple example for Plasma ContainmentAction plugins can be found at https://github.com/tstaerk/kde-contextmenu/tree/0.1. Let's look at it here:
[Desktop Entry] Name=KDE Context Menu Type=Service Icon=favorites Comment=Simple application launcher ServiceTypes=Plasma/ContainmentActions X-KDE-Library=kde-contextmenu X-KDE-PluginInfo-Author=R. Hacker [email protected] X-KDE-PluginInfo-Name=kde-contextmenu X-KDE-PluginInfo-Version=pre0.1 X-KDE-PluginInfo-Website=http://techbase.kde.org X-KDE-PluginInfo-EnabledByDefault=true
CMakeLists.txt
project(kde-contextmenu) set(KDE_MIN_VERSION "4.3.85") # for the < 4.2 macro find_package(KDE4 4.3.85 REQUIRED) include(MacroLibrary) include(KDE4Defaults) add_definitions(${QT_DEFINITIONS} ${KDE4_DEFINITIONS}) include_directories(${CMAKE_SOURCE_DIR} ${CMAKE_BINARY_DIR} ${KDE4_INCLUDES}) set(contextmenu_SRCS launch.cpp ) kde4_add_plugin(kde-contextmenu ${contextmenu_SRCS}) target_link_libraries(kde-contextmenu ${KDE4_PLASMA_LIBS} ${KDE4_KIO_LIBS}) install(TARGETS kde-contextmenu DESTINATION ${PLUGIN_INSTALL_DIR}) install(FILES kde-contextmenu.desktop DESTINATION ${SERVICES_INSTALL_DIR})
launch.h
#ifndef CONTEXTMENU_HEADER #define CONTEXTMENU_HEADER #include <plasma/containmentactions.h> class QAction; class KMenu; class ConTextMenu : public Plasma::ContainmentActions { Q_OBJECT public: ConTextMenu(QObject* parent, const QVariantList& args); ~ConTextMenu(); void init(const KConfigGroup &config); void contextEvent(QEvent *event); //returns true if something (other than a separator) was successfully added bool addApps(QMenu *menu); public slots: void switchTo(QAction *action); protected: void makeMenu(); private: KMenu *m_menu; QAction *m_action; }; K_EXPORT_PLASMA_CONTAINMENTACTIONS(favorites, ConTextMenu) #endif
Install it
Compile, link and install it using the command
cmake -DCMAKE_INSTALL_PREFIX=`kde4-config --prefix` . && make -j8 && make install
Test it
To test it, right-click onto your desktop and select "Folder View Settings". Then select Mouse Actions and the context menu:
Then click "Apply". Next time you middle-click (or whatever you selected) onto your desktop, your own context menu will appear:
Debugging
To debug your Plasma ContainmentAction call
kdebugdialog --fullmode
search for "plasma" and direct kDebug's output to /tmp/whatever.txt