Patch:AdvancedSystemMenus

From WebOS Internals
Jump to navigation Jump to search

Overview

The Advanced System Menus patches are a handful of highly customizable patches for webOS 2.x and later.

The Advanced System Menus patches have been designed to give a consistent look and feel across the webOS top bar. Having all of the Advanced System Menus patches installed will give the best overall experience; however, you can choose to install just the menus you want. Utilizing all or some of the menus and their functionality will not affect the performance of your device.

The Advanced System Menus patches consist of the following set of individual patches:

REQUIRED:

Advanced System Menus - Framework:

Provides the foundation for the Advanced System Menus patches. This patch is required for the other Advanced Systems Menus patches to function properly.


OPTIONAL:

Advanced System Menus - Mode Menu:

Extends the functionality of the Mode Switcher application. This patch is not required to use Mode Switcher, but is highly recommended.


Advanced System Menus - Today Menu:

Extends the functionality of your calendars by giving you quick access to your calendar events.


Advanced System Menus - Device Menu:

Extends the functionality of the device menu by giving you quick access to the following options/settings: the system radios (phone, wifi, bluetooth and gps) and preferences, VPN settings, volume levels (system, ringtone and media), screen brightness, flashlight (using the device LED), networks (auto, 2g, 3g), security (unlock, pin, password), voice and data roaming, and data connection. (Note: After installing this patch, a full restart is required for the flashlight (using the device LED) to work correctly.)


Advanced System Menus - Power Menu:

Extends the functionality of the power menu by simplifying the power menu and adds way to configure the shown actions in the menu. Currently supported actions are: Airplane mode toggle, device sleep toggle (prevent/allow device sleeping), device restart/shutdown and luna restart.


Advanced System Menus - App Menu:

Extends the functionality of an application's app menu to be full width across the top bar when an app is in the foreground. The background of the menu is transparent so you can still see the top bar behind it, however tapping anywhere on the top bar will open the application's app menu and prevents the other top bar menus from being activated. This makes the app menu more accessible when using the phone with one hand. Currently the behavior is not configurable, but it will be in the future.


Installation

The following information will help with installing the Advanced Systems Menus patches.

Method

The following method can be used to install the Advanced System Menus patches.

Preware
  1. Open Preware
  2. Start typing “Advanced System” (no quotes)
  3. Tap the corresponding patch from the list
  4. Tap the Install button
  5. Tap the Ok button to restart Luna

Or

  1. Open Preware
  2. Tap Available Packages
  3. Tap Patch > Advanced > Patch name (e.g. Advanced System Menus - Today Menu)
  4. Tap the Install button
  5. Tap the Ok button to restart Luna


(Note: After installing the Advanced System Menus - Device Menu patch, a full restart is required for the flashlight (using the device LED) to work correctly.)


Updating

webOS OTA Updates

The Advanced System Menus patches are not OTA (over-the-air) update safe. When there is an OTA update to a newer version of webOS from your carrier, you must remove these patches before updating. If you do not remove them prior to running the OTA update, you most likely will need to run the Emergency Patch Recovery tool from Preware.


Patch Updates

Updated versions of the Advanced System Menus patches can be applied via Preware.


Troubleshooting/FAQs

Q: What version of webOS are these patches available for?
A: The Advanced System Menus patches are available for webOS 2.x and later.

Q: The flashlight toggle in the Advanced System Menus - Device Menu doesn't seem to work. What's wrong?
A: You need to do a full restart of your device for the flashlight (using the device LED) to work properly.


Usage

Each Advanced System Menus patch is listed below with information on how you access, use and configure the menus.

Throughout the menus, tapping an item in the menu will perform a certain function or present you with more choices (e.g. like a submenu).

Some of the more advanced functionality (e.g. Accessing the menu configuration) might require the use of the Option Key + Tap or Option Key + Swipe. The Option Key is the Orange or Silver key on your device's (depending on your device) keyboard. The Option Key + Swipe simply means to press the Option Key while swiping down the menu.

Another way to access the menu's configuration options would be to Tap and hold your finger on the menu spot which will then open the menu in the edit mode.

Advanced System Menus - Mode Menu

Accessing The Menu:

Tap or Swipe down the left of the screen/top bar (when an app is not in focus).

Using The Menu:

The Mode Menu utilizes the carrier string area of the top bar to display the current mode/status of the Mode Switcher app.

  • If Mode Switcher's Default Mode is active, the carrier string will appear as normal (e.g. Sprint, Verizon, ATT, etc...).
  • If Mode Switcher is running a Normal Mode, the carrier string will be overwritten with the name of that Normal Mode.
  • If Mode Switcher is running a Modifier Mode, the carrier string will have a plus (+) sign appended to the end.
  • If Mode Switcher's mode triggers are locked, the carrier string will be displayed in yellow to signify that the triggers are locked.


With the Mode Menu open, you will see (by default) all of the custom modes listed in the menu.

  • Tapping a mode opens a submenu with options for toggling the mode on/off and for opening Mode Switcher directly to that mode for editing.
  • Option + Tap/Tap + Hold a mode toggles the mode on/off.


The first line (Status:) of the menu when opened, changes based on the current mode/status of the Mode Switcher app as such:

  • Default - Default Mode is active and unmodified
  • Normal - A Normal mode is active and unmodified
  • Modified - The current active mode is being modified by a Modifier mode.

Configuring The Menu:

Option + Tap/Swipe or Tap and Hold the Mode Menu to configure the menu.

  • Tapping a mode name will toggle whether or not it is shown in the menu.
  • Tapping the last menu item will cycle between all available modes and "Toggle Triggers Locking." Choosing a mode will set the last menu item as a quick toggle for that mode. Choosing "Toggle Triggers Locking" will set the last menu item to a On/Off toggle for Mode Switcher.


Advanced System Menus - Today Menu

Accessing The Menu:

Tap or Swipe down the middle of the screen/top bar (when an app is not in focus).

Using The Menu:

  • Tapping the date in the menu will open the Calendar app to that day.
  • Tapping a calendar event will open the Calendar app to that event's details.
  • Tapping the "Show Tomorrow's Events" will show the next day's events.
  • Gesture + Tapping an event (non all day events) will toggle the event's start/end time information.
  • Gesture + Tap the "Show Tomorrow's Events" will show the previous day's events.
  • Gesture + Tapping a weather event will toggle between low/high temperature information.

Configuring The Menu:

Option + Tap/Swipe or Tap and Hold the Today Menu to configure the menu.

  • Tapping a calendar will toggle whether or not it is shown in the menu.
  • Tapping the "Show Events for x Days" will toggle between 3 and 7 days worth of events to display.
  • Gesture + Tapping a calendar will toggle between the calendar source (e.g. Google, Local, Exchange) and the calendar name.


Advanced System Menus - Device Menu

Accessing The Menu:

Tap or Swipe down the right of the screen/top bar (when an app is not in focus).

Using The Menu:

  • Tapping a menu item will expand the submenu for that item, displaying the settings that can be toggled.
  • Tapping the quick action (last menu item) can be used to quickly toggle once custom configured setting.
  • Tapping the volume heading (e.g. Ringtone, System or Media) in the Device submenu will toggle between the three volume controls.
  • Gesture + Tapping the Roaming Enabled setting under the Phone submenu will toggle Forced Roaming on/off.
  • Gesture + Tapping a menu item will perform the first action that exists in the submenu for that menu item. (e.g. Gesture + Tapping the WiFi menu item will toggle the WiFi radio on/off instead of opening the WiFi submenu.

Configuring The Menu:

Option + Tap/Swipe or Tap and Hold the Device Menu to configure the menu.

  • Tapping a menu item will toggle whether or not it is shown in the menu.
  • Tapping the quick action (last menu item) will toggle between the different settings groups. The item selected will become the toggle for the quick action in the Device menu.


Advanced System Menus - Power Menu

Accessing The Menu:

Hold down the device's power button for a few seconds.

Using The Menu:

  • Tapping a menu item will execute the function selected.

Configuring The Menu:

With the Power Menu already open, press and hold the power button for a few seconds to configure the menu.

  • Tapping a menu item will toggle whether or not it is shown in the menu.


Advanced System Menus - App Menu

Accessing The Menu:

Tap or Swipe down anywhere along the top of the screen/top bar (when an app is in focus).

Using The Menu:

  • Tapping the application menu provides you with the default options, preferences, help, etc... available for the app you have open (in focus, not card view).

Configuring The Menu:

Current customization of the Advanced System Menus App Menu is not available.


Resources

Official Forum
Donation to Developer
  • Please see the official PreCentral Forum thread opening post for the donation link.


Status

Changelog

Advanced System Menus - Framework

2.1.0-20 - Current Release - (Released Mar. 10th, 2011)
  • Fixed all reaming bugs (hopefully)



Advanced System Menus - Mode Menu

2.1.0-20 - Current Release - (Released Mar. 10th, 2011)
  • Fixed all reaming bugs (hopefully)



Advanced System Menus - Today Menu

2.1.0-20 - Current Release - (Released Mar. 10th, 2011)
  • Fixed all reaming bugs (hopefully)



Advanced System Menus - Device Menu

2.1.0-20 - Current Release - (Released Mar. 10th, 2011)
  • Fixed all reaming bugs (hopefully)



Advanced System Menus - Power Menu

2.1.0-20 - Current Release - (Released Mar. 10th, 2011)
  • Fixed all reaming bugs (hopefully)



Advanced System Menus - App Menu

2.1.0-20 - Current Release - (Released Mar. 10th, 2011)
  • Fixed all reaming bugs (hopefully)


Future Releases
  • Maybe configurable displaying of the first item in the menus