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
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