Home · All Namespaces · All Classes · Main Classes

Applet categories

Description

Applets are organized in a menu hierarchy, which is formed from applet categories. Applet categories are stored in ini format files under

    /usr/share/duicontrolpanel/categories/*.cpcategory

Categorizing applets

Specifying a category for an applet

Each applet specifies in which category it should appear. For this an applet is using the "Category" key in its .desktop file.

A category can be referred by its name or the logical id of its name. To get all such ids you can use:

    grep '^Name' /usr/share/duicontrolpanel/categories/*

These are the categories shipping with controlpanel:

Name Translation id Ids maintained for compatibility
"About this product" qtn_sett_main_aboutmy "About,About my device,About my NXX"
Accessories qtn_sett_main_accessories
Applications qtn_sett_main_applications Uncategorized
Bluetooth qtn_sett_main_bluetooth
"Events feed" qtn_home_events_settings_title
"Installations" qtn_pmgr_appname
"Manage applications" qtn_pmgr_plug_pmgr
"Notifications" qtn_noti_settings_title
"Notifications & Events" qtn_sett_main_notifications
Phone qtn_sett_main_phone qtn_sett_main_battery
Reset qtn_sett_main_reset qtn_sett_main_reset
Security qtn_sett_main_security
"Sounds & Vibra" qtn_sett_main_sounds
"Sync & Backup" qtn_sett_main_syncbackup qtn_sett_main_backup
"Time & Language" qtn_sett_main_timelanguage "qtn_sett_main_timedate,Time & Date"
Wallpaper qtn_sett_main_wallpaper

Wrong category identifiers

Applets specifying no or wrong category identifiers as the category they belong to, would just disappear. To avoid this, there can be categories (currently the Applications category) which is flagged to display all applets. To do so, the category should also have the special alias "Uncategorized".

Category description format

Parent
The parent of the category. The category will be displayed as a submenu of its parent.
Name
The name of the category. The category can be identified by its name, and additionally also suits for the engineering english translation (when no translation is available).
Name-logical-id
The translation id of the category's name. It can also be used to identify the category.
Value
A second line of text that is shown on the launch button representing the category. (engineering translation)
Value-logical-id
The translation id of Value.
Icon
The icon of the launch button representing the category.
Aliases
Other names for identifying the category. Its goal is to provide compatibility in case the Name changes. If "Uncategorized" appears as an alias here, the category will also contain applets with no / wrong category identifiers.
Translation-catalogs
The list of translation catalogs which are needed for the title/subtitle of the category.
Order
A number which will determine the position of the launch button in the category list. Lower numbers will be on upper positions (closer to top), higher numbers will be at the bottom.
ComponentOrder
The category both contains applets and other categories. This key defines the sequence of those in the list which represents the category content. If it has the value "AppletsFirst", the list will contain the applets above the categories. If it contains any other value ("CategoriesFirst", the default), the categories will be above the applets.
AppletSort
Defines the way the applets in the category are sorted. Its value can be "SortByTitle" or "SortByOrder" (default). First one means that the applets will be sorted by their translated title, second is that the applets themselves defines their sequence through the "Order" key in their .desktop file.
AutoStartApplet
This key can override applet autostarting. If it has the value "1", autostart is on, in which case the applet list will not be shown for the user if the category has only 1 applet, but instead, the applet will be opened directly. Default value is "0", by default autostarting is disabled.
HelpId
Its value can define a help id for the category. If it is present, a help button will appear next to the title of the page, and if the user clicks on that, the specified help content will be opened in the current userguide application.
TitleStyle
Its value can override the style name for the title in case the default is not acceptable.

Example:

Parent=MainPage

Name=Applications
Name-logical-id=qtn_sett_main_applications

Value="Installations, Application settings"
Value-logical-id=qtn_sett_main_applictions_label2

Icon=icon-m-settings-applications

Aliases=Uncategorized
Translation-catalogs=

Order=30

Copyright © 2009 Nokia Corporation Generated on Tue Jul 5 2011 15:01:31
Doxygen 1.7.1
Meego control panel