Plasma/Guidelines
< Plasma
Guidelines
The Plasma widgets should follow some simple guidelines in both style and code to be included in the official widget set for the KDE Plasma workspaces.
Graphics style
- Applets should use the Plasma::Applet default background
- Only widgets of the libplasma widget set should be used
- If custom widgets are created, they should be styled with svgs from the Plasma theme, using Plasma::Svg and Plasma::FrameSvg
- All text should always be painted using the colors from Plasma::Theme
Behavioural conventions
- Applets should always work in any form factor, Planar, Horizontal and Vertical
- Applets should be tested on all Containments provided in the standard distribution: Desktop, Panel, Newspaper, Search and launch, and Grouping Desktop
- If an applet should look like an icon when it is in a panel (or if it should have a popup anyways) it should inherit Plasma::PopupApplet
- Applets should do just strictly "visualization" related tasks, as much of the work as possible should be done with implementations of Plasma::DataEngine (data fetcing) and Plasma::Service (data writing)
Coding conventions
Kdelibs coding conventions should e used