< Plasma This document outlines the features provided by Plasma 5's plasmashell "universal shell binary" tool. Contents 1 Shell Package 2 Applet Alternatives 3 Desktop Scripting 3.1 Interactive Console 4 Activities 5 Views 6 Containments 7 Configuration 8 Widget Explorer 9 On-Screen Display (OSD) 10 Shell Manager 11 DBus Interface Shell Package The QML files and other configuration files that define the behavior of the plasma shell, are contained in a Package defined by the Shell package structure Applet Alternatives The applet alternatives interface allows the user to select another functionally equivalent applet to replace a currently running one. An example might be a clock: the default might be a digital clock (sensible) but the user may wish to have an anolog or a fuzzy clock instead. Using the alternatives interface, the user can select one of these options and have it replace the digital clock currently active. To enable this feature, containments must emit the Plasma::Containment::appletAlternativesRequested signal and the shell package must provide the contents/explorer/AppletAlternatives.qml file. The AppletAlternatives.qml file is responsible for the entire UI, including the top level dialog if that is appropriate. The top level item in that QML file must provide the following property: boolean visible, with visibleChanged(bool) changed signal which should follow the visibility of the user interface. When set to false it will be deleted by plasmashell Desktop Scripting Interactive Console The interactive console is an optional user interface that allows the user to write and run desktop scripts within the current, live session. To provide a console, the shell package must provide the contents/InteractiveConsole.qml file. The top level item in that QML file must provide the following properties: boolean visible, with visibleChanged(bool) changed signal which should follow the visibility of the user interface. When set to false it will be deleted by plasmashell string script: used to optionally set a path to a script on disk to load It may also optionally provide the following property: string property named mode for which the following values may be set by plasmashell: "desktop": the scripting is focused on the desktop and panels "windowmanager": the scripting is focused on the window manager The shell sets a scriptEngine property in the global context which has the following interface: function evaluateScript(string) signal print(string) signal printError(string) Activities Views Containments Configuration Widget Explorer On-Screen Display (OSD) Shell Manager DBus Interface Retrieved from "https://community.kde.org/index.php?title=Plasma/PlasmaShellFeatures&oldid=39417" This page was last edited on 2 September 2014, at 17:13. Content is available under Creative Commons License SA 4.0 unless otherwise noted.