Locale Button Plug-in requires Locale version 1.0 or later for operation. Locale is available on the Android Market
Locale Button Plug-in provides button widgets that can be installed on an Android device's home screen. These buttons can be used both as controls and as indicators. When used as controls, they are queried by Locale as Conditions and affect which Locale Situations become active. When used as indicators, Locale controls the state of the buttons as Settings. Four colored simple on/off buttons are provided as well as a very cute Maneki Neko (Welcoming Cat), which raises its paw in a friendly greeting to indicate "On".
Locale Button Plug-in works very well with the Locale Toast Plug-in, which can provide additional visual feedback when a Situation is activated or deactivated.
The only way to install Locale Button Plug-in is to purchase it from the Android Market. In order to use the plug-in, Locale version 1.0 or later must also be installed.
Before trying to use the plug-in within Locale, you must first create a button on the home screen. Do this by long-pressing in a blank area of the home screen until the "Add to Home screen" menu appears. Now choose "Widgets", then "Locale Button Plug-in". A page will then appear allowing you to customize the button which will be added to your home screen. You can return to this page later in order to reconfigure the buttons by launching Locale Button Plug-in directly, without using Locale. Buttons are deleted by dragging to the trash on the home screen.
The Locale Button Plug-in automatically provides an "On/Off Button" in Locale in both the "Conditions" and "Settings" sections of the Edit Situation screen. When adding a button as a Setting or Condition, you can choose from the buttons you already created on your home screen.
When a button widget is first created, you will be presented with some choices for the configuration of the button. You may also reconfigure existing buttons at any time by launching Locale Button Plug-in directly and choosing a button to configure. The following settings may be adjusted.
The text that will appears underneath the button on the home screen, and in Locale for choosing which button to use.
Controls wehther the button will respond to being pressed. A touch sensitive button will change state when pressed. A button which is not touch sensitive is useful as an indicator.
Controls which icon will be used on the home screen. The colored buttons all appear the same when off, as a simple black and white double rectangle with the word Off inside. When On, they have the word On surrounded by the chosen color. Maneki Neko is a Welcoming Cat which can be used in place of the simple icons. When the cat's paw is up, in the welcoming gesture, the button is on.
When a button changes state, it can optionally provide feedback using the device vibrator. The button will make one short buzz when switching off and two short buzzes when switching on.
Click on "Add Condition" in a Locale Situation, then choose On/Off Button.
When a button is used as a Condition in a Locale Situation, the state of the button is queried in order to enable or disable a Situation. The button state may be controlled by pressing the button, or by a Situation changing the button state. (see below)
Click on "Add Setting" in a Locale Situation, then choose On/Off Button.
When a button is used as a Setting in a Locale Situation, the button's state and touch sensitivity can be changed by the Locale Situation. This feature allows a button displayed on your home screen to indicate which Situation is active, or to enable the use of a button as a control based on which Situation is active.
In each setting is a Do not change choice. When Do not change is chosen, then this setting is not affected when this situation is activated. Leave a setting as Do not change when the situation does not require changing that particular setting.
These examples are short descriptions of Situations that might be useful starting points for Situations you can create.
Result: When "Momentary Button" is pressed, the "Momentary Situation" briefly become active and the phrase "Just a moment" will appear on the screen. All Settings in "Momentary Situation" will be fired, but then Locale will go back to the previous Situation.
Use this configuration to provide for turning back on functionality that is automatically disabled when the battery is low, such as all K-9 Mail folder synchronization, as illustrated in this example. A similar configuration can be created which allows overriding a reduced functionality "night time" mode.