Plasma/Guidelines: Difference between revisions

From KDE Community Wiki
(Replaced content with 'Moved to Plasma/PlasmoidGuidelines')
 
Line 1: Line 1:
== Guidelines ==
Moved to [[Plasma/PlasmoidGuidelines]]
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 ===
[http://techbase.kde.org/Policies/Kdelibs_Coding_Style Kdelibs coding conventions] should be used

Latest revision as of 05:51, 28 August 2010