Projects/Usability/HIG/KNS: Difference between revisions

From KDE TechBase
< Projects‎ | Usability‎ | HIG
m (typo--)
(Refreshed, added Implementation section)
Line 1: Line 1:
== Purpose ==
K New Stuff (or Get Hot New Stuff) is an integrated data service which allows users to share and download themes, templates, wallpapers, and more through a single click of a button in the application.  
K New Stuff (or Get Hot New Stuff) is an integrated data service which allows users to share and download themes, templates, wallpapers, and more through a single click of a button in the application.  


Because of translation issues, a single class cannot be created which controls the icon and label automatically. Developers must manually create the button in their application. The following are recommendations on what that button should look like.  
[[File:KNS_Button.png]]


For more information about the usability issues regarding the KNS button, see [http://obso1337.org/hci/kde/KNS_Review_July_14_2009.pdf this report].
== Guidelines ==
 
KNS is not able to install files that are hosted on third-party websites, it is important that every KNS button is accompanied by a button to install a resource from a local file.
Also, because KNS is not able to install files that are hosted on third-party websites, it is important that every KNS button is accompanied by a button to install a resource from a local file.
 
A KNS button has four parts:


The text of a KNS button should be made of these parts:
*Icon: use get-hot-new-stuff.png  
*Icon: use get-hot-new-stuff.png  
*Instruction: "Get New"  
*Instruction: "Get New"  
Line 14: Line 13:
*Ellipsis: To indicate the user must provide additional input to complete the task
*Ellipsis: To indicate the user must provide additional input to complete the task


KNS has its own oxygen '''icon''', get-hot-new-stuff.png. This is placed on the left side of the button. The button label is a combination of the '''instruction''', '''object''', and '''ellipsis'''. For example, if the button will help the user download new wallpapers, the button label would be "Get New Wallpapers...".  
== Implementation ==
* [http://api.kde.org/4.10-api/kdelibs-apidocs/knewstuff/html/classKNS3_1_1Button.html KNS3::Button]
* [http://api.kde.org/4.10-api/kdelibs-apidocs/knewstuff/html/namespaceKNS3.html KNS3 namespace]


Here are some examples of KNS buttons:
== See also ==


[[File:Kns.png]]
For more information about the usability issues regarding the KNS button, see [http://obso1337.org/hci/kde/KNS_Review_July_14_2009.pdf this report].

Revision as of 15:15, 27 June 2013

Purpose

K New Stuff (or Get Hot New Stuff) is an integrated data service which allows users to share and download themes, templates, wallpapers, and more through a single click of a button in the application.

Guidelines

KNS is not able to install files that are hosted on third-party websites, it is important that every KNS button is accompanied by a button to install a resource from a local file.

The text of a KNS button should be made of these parts:

  • Icon: use get-hot-new-stuff.png
  • Instruction: "Get New"
  • Object: The type of file the user will download
  • Ellipsis: To indicate the user must provide additional input to complete the task

Implementation

See also

For more information about the usability issues regarding the KNS button, see this report.