Changes

no edit summary
Line 1: Line 1: −
<pre style="background-color: #EEEEEE; color: Black; border-radius: 10px; padding: 10px;">
+
<pre class="header-style">This trigger enables an application shortcut for this macro. The trigger will be invoked whenever the appropriate shortcut is launched. This trigger enables you to invoke actions from other apps/launchers which support launching shortcuts.</pre>
This trigger was originally used to expose a macro to be available to other apps that are able to launch Android shortcuts.
     −
It is now possible to select from any macro for an Android shortcut regardless of what triggers are configured, therefore this trigger is now not necessary and really equivalent to the empty trigger.
+
''' Options '''
   −
For macros that are only designed to be invoked from Android shortcuts it still makes sense to use this trigger to make it clear this is the intended use.
+
This trigger has no configurable options. Adding this trigger to a macro simply marks the macro as being intended for shortcut invocation.
</pre>
  −
<br>
  −
'''Example Usage'''<br/>
     −
<pre style="background-color: #AC2424; color: white; border-radius: 10px; padding: 10px;">
+
''' Current Status '''
Triggers
      +
It is now possible to select from any macro for an Android shortcut regardless of what triggers are configured, therefore this trigger is not strictly necessary. However, for macros that are only designed to be invoked from Android shortcuts, it still makes sense to use this trigger to make it clear this is the intended use.
   −
</pre><br>
+
''' Examples '''
<pre style="background-color: #1665B0; color: white; border-radius: 10px; padding: 10px;">
  −
Actions
      +
'''Example 1: Quick settings shortcut'''
   −
</pre><br>
+
Create a shortcut to toggle WiFi:
<pre style="background-color: green; color: white; border-radius: 10px; padding: 10px;">
  −
Constraints
      +
  <pre class="trigger-style">Triggers
   −
</pre><br>
+
Shortcut Launched</pre>
<pre style="background-color: teal; color: white; border-radius: 10px; padding: 10px;">
+
  <pre class="action-style">Actions
Local variables
      +
WiFi: Toggle</pre>
   −
</pre><br>
+
'''Example 2: Home screen automation shortcut'''
 +
 
 +
Create a shortcut for your morning routine:
 +
 
 +
  <pre class="trigger-style">Triggers
 +
 
 +
Shortcut Launched</pre>
 +
  <pre class="action-style">Actions
 +
 
 +
WiFi: Enable
 +
Bluetooth: Enable
 +
Speak Text: "Good morning"
 +
Launch Application: News App</pre>
 +
 
 +
'''Example 3: Quick note shortcut'''
 +
 
 +
Create a shortcut to quickly create a note:
 +
 
 +
  <pre class="trigger-style">Triggers
 +
 
 +
Shortcut Launched</pre>
 +
  <pre class="action-style">Actions
 +
 
 +
Input Dialog: "Enter note"
 +
Set Variable: [note_text] = [user_input]
 +
Write to file: [note_text]</pre>
 +
 
 +
''' Creating Shortcuts '''
 +
 
 +
To create a shortcut for a macro with this trigger:
 +
# Long-press on your home screen
 +
# Select Widgets or Shortcuts (varies by launcher)
 +
# Find and select MacroDroid
 +
# Choose "Macro Shortcut"
 +
# Select the macro you want to create a shortcut for
 +
 
 +
Alternatively, from within MacroDroid:
 +
# Open the macro
 +
# Tap the three-dot menu
 +
# Select "Create Shortcut"
 +
 
 +
''' Notes '''
 +
 
 +
* While this trigger is no longer technically required (any macro can be invoked via shortcut), it serves as useful documentation to indicate the macro's intended purpose
 +
* The trigger does not perform any actual trigger registration - it simply acts as a marker
 +
* Shortcuts created for macros will appear in your launcher with the MacroDroid icon unless you customize it
 +
* Some launchers may have specific requirements or limitations for shortcut support
 +
* This trigger is equivalent to the Empty Trigger when it comes to actual functionality
 +
 
 +
''' See Also '''
 +
 
 +
* [[Trigger:_Empty_Trigger|Empty Trigger]]
 +
* [[Trigger:_Widget_Button|Widget Button Trigger]]
 +
* [[Action:_Macro_run|Macro Run]]