feat: Add support for templates in actions (#1891)

- Closes #1878

docs/configuration/actions/_sidebar.md

@@ -3,6 +3,7 @@
   - [`actions`](README.md)
     - [Custom Actions](./custom/README.md)
     - [Stock Actions](./stock/README.md)
+    - [Templates](./templates.md)
   - [`automations`](../automations.md)
   - [`cameras`](../cameras/README.md)
   - [`conditions`](../conditions.md)

docs/configuration/actions/custom/_sidebar.md

@@ -3,6 +3,7 @@
   - [`actions`](../README.md)
     - [Custom Actions](README.md)
     - [Stock Actions](../stock/README.md)
+    - [Templates](../templates.md)
   - [`automations`](../../automations.md)
   - [`cameras`](../../cameras/README.md)
   - [`conditions`](../../conditions.md)

docs/configuration/actions/stock/README.md

@@ -73,13 +73,13 @@ elements:
       action: toggle
   - type: icon
     icon: mdi:numeric-3-box
-    title: Call Service action
+    title: Perform Action / Call Service action
     style:
       left: 200px
       top: 150px
     tap_action:
-      action: call-service
-      service: homeassistant.toggle
+      action: perform-action
+      perform_action: homeassistant.toggle
       data:
         entity_id: light.office_main_lights
   - type: icon

docs/configuration/actions/stock/_sidebar.md

@@ -3,6 +3,7 @@
   - [`actions`](../README.md)
     - [Custom Actions](../custom/README.md)
     - [Stock Actions](README.md)
+    - [Templates](../templates.md)
   - [`automations`](../../automations.md)
   - [`cameras`](../../cameras/README.md)
   - [`conditions`](../../conditions.md)

docs/configuration/actions/templates.md

@@ -0,0 +1,57 @@
+# Templates
+
+Before actions are executed, template values (if present) are replaced within
+each action. This allows a variety of Home Assistant data to be automatically
+populated in your actions, as well as some Advanced Camera Card data.
+
+## Stock Templates
+
+The Advanced Camera Card uses
+[ha-nunjucks](https://github.com/Nerwyn/ha-nunjucks) to process templates.
+Consult its documentation for the wide variety of different template values
+supported.
+
+See [an example](../../examples.md?id=accessing-home-assistant-state) that
+accesses Home Assistant state.
+
+## Custom Templates
+
+Custom template values must be proceeded by `advanced_camera_card` (or `acc` for
+short).
+
+| Template | Replaced with                                      |
+| -------- | -------------------------------------------------- |
+| `camera` | The currently selected camera.                     |
+| `view`   | The current [view](../view.md?id=supported-views). |
+
+See [an example](../../examples.md?id=accessing-advanced-camera-card-state) that
+accesses Advanced Camera Card state.
+
+## Triggers
+
+If the action is called by an [Advanced Camera Card
+Automation](../automations.md), additional data is available representing the
+current and prior state of whatever triggered the action.
+
+Trigger template values must be proceeded by `advanced_camera_card.trigger` (or
+`acc.trigger` for short).
+
+| Template       | Replaced with                                                                                     |
+| -------------- | ------------------------------------------------------------------------------------------------- |
+| `camera.to`    | For [camera conditions](../conditions.md?id=camera), the currently selected camera.               |
+| `camera.from`  | For [camera conditions](../conditions.md?id=camera), the previously selected camera.              |
+| `view.to`      | For [view conditions](../conditions.md?id=view), the currently selected view.                     |
+| `view.from`    | For [view conditions](../conditions.md?id=view), the previously selected view.                    |
+| `state.entity` | For [state conditions](../conditions.md?id=state), the entity state that triggered the condition. |
+| `state.to`     | For [state conditions](../conditions.md?id=state), the current state of the entity.               |
+| `state.from`   | For [state conditions](../conditions.md?id=state), the previous state of the entity.              |
+
+!> If an action is triggered with multiple [state
+conditions](../conditions.md?id=state), only data from the last listed state
+condition is available.
+
+Please [request](https://github.com/dermotduffy/advanced-camera-card/issues) if
+you need data from additional conditions.
+
+See [an example](../../examples.md?id=accessing-trigger-state) that accesses
+trigger state.