Add UI instructions, examples, and standard actions include to Peblar RFID docs

Author: Frank Klaassen

source/_actions/peblar.add_rfid_token.markdown

@@ -14,6 +14,33 @@ The **Add RFID token** action adds a new RFID token to the Peblar charger's stan
 
 {% include actions/try_it.md %}
 
+{% include actions/ui_header.md %}
+
+To add an RFID token from an automation or a script:
+
+1. Go to {% my automations title="**Settings** > **Automations & scenes**" %}.
+2. Open an existing automation or script, or select **Create** to start a new one.
+3. In the **Then do** section, select **Add action**.
+4. From the search box, search for and select **Peblar: Add RFID token**.
+5. Under **Config entry**, select the Peblar charger to add the token to.
+6. Enter the **UID** of the RFID token. This is typically printed on the card or key fob.
+7. Enter a **Description** to identify the token, for example, the name of the person it belongs to.
+8. Select **Save**.
+
+### Options in the UI
+
+{% options_ui %}
+Config entry:
+  description: The Peblar charger to add the RFID token to.
+  required: true
+UID:
+  description: The unique identifier of the RFID token to add. This is typically printed on the card or key fob.
+  required: true
+Description:
+  description: A human-readable label for this RFID token, for example, the name of the person it belongs to.
+  required: true
+{% endoptions_ui %}
+
 {% include actions/yaml_header.md %}
 
 In YAML, refer to this action as `peblar.add_rfid_token`. A basic example looks like this:
@@ -46,3 +73,26 @@ description:
   required: true
   type: string
 {% endoptions_yaml %}
+
+{% include actions/more_examples.md %}
+
+### Automation: add a new RFID token when an input text is updated
+
+When you update an input text helper with a new token UID and description, automatically add it to the charger.
+
+{% details "YAML example for adding an RFID token from an input text" %}
+
+{% example %}
+automation: |
+  triggers:
+    - trigger: state
+      entity_id: input_text.new_rfid_uid
+  actions:
+    - action: peblar.add_rfid_token
+      data:
+        config_entry_id: "01234567890abcdef01234567890abcd"
+        uid: "{{ states('input_text.new_rfid_uid') }}"
+        description: "{{ states('input_text.new_rfid_description') }}"
+{% endexample %}
+
+{% enddetails %}

source/_actions/peblar.list_rfid_tokens.markdown

@@ -6,12 +6,33 @@ description: "Returns all RFID tokens currently configured in the Peblar charger
 related:
   - docs: /integrations/peblar/
     title: Peblar
+  - action: peblar.add_rfid_token
+  - action: peblar.remove_rfid_token
 ---
 
-The **List RFID tokens** action retrieves all RFID tokens stored in the Peblar charger's standalone authorization list. The action returns the full list as response data, which you can use in an automation or script to inspect or filter the tokens configured on your charger.
+The **List RFID tokens** action retrieves all RFID tokens stored in the Peblar charger's standalone authorization list. The action returns the full list as response data, which you can use in an automation or script to inspect or react to the tokens configured on your charger.
 
 {% include actions/try_it.md %}
 
+{% include actions/ui_header.md %}
+
+To retrieve the RFID token list from an automation or a script:
+
+1. Go to {% my automations title="**Settings** > **Automations & scenes**" %}.
+2. Open an existing automation or script, or select **Create** to start a new one.
+3. In the **Then do** section, select **Add action**.
+4. From the search box, search for and select **Peblar: List RFID tokens**.
+5. Under **Config entry**, select the Peblar charger to retrieve the tokens from.
+6. Select **Save**.
+
+### Options in the UI
+
+{% options_ui %}
+Config entry:
+  description: The Peblar charger to retrieve the RFID token list from.
+  required: true
+{% endoptions_ui %}
+
 {% include actions/yaml_header.md %}
 
 In YAML, refer to this action as `peblar.list_rfid_tokens`. A basic example looks like this:
@@ -32,3 +53,31 @@ config_entry_id:
   required: true
   type: string
 {% endoptions_yaml %}
+
+{% include actions/more_examples.md %}
+
+### Automation: send a notification with the current RFID token list
+
+Retrieve all configured tokens and send yourself a summary as a notification.
+
+{% details "YAML example for notifying with the RFID token list" %}
+
+{% example %}
+automation: |
+  triggers:
+    - trigger: time
+      at: "08:00:00"
+  actions:
+    - action: peblar.list_rfid_tokens
+      data:
+        config_entry_id: "01234567890abcdef01234567890abcd"
+      response_variable: rfid_tokens
+    - action: notify.mobile_app_your_phone
+      data:
+        title: "Peblar RFID tokens"
+        message: >
+          Currently authorized tokens:
+          {{ rfid_tokens | map(attribute='description') | join(', ') }}
+{% endexample %}
+
+{% enddetails %}

source/_actions/peblar.remove_rfid_token.markdown

@@ -14,6 +14,29 @@ The **Remove RFID token** action deletes an RFID token from the Peblar charger's
 
 {% include actions/try_it.md %}
 
+{% include actions/ui_header.md %}
+
+To remove an RFID token from an automation or a script:
+
+1. Go to {% my automations title="**Settings** > **Automations & scenes**" %}.
+2. Open an existing automation or script, or select **Create** to start a new one.
+3. In the **Then do** section, select **Add action**.
+4. From the search box, search for and select **Peblar: Remove RFID token**.
+5. Under **Config entry**, select the Peblar charger to remove the token from.
+6. Enter the **UID** of the RFID token to remove.
+7. Select **Save**.
+
+### Options in the UI
+
+{% options_ui %}
+Config entry:
+  description: The Peblar charger to remove the RFID token from.
+  required: true
+UID:
+  description: The unique identifier of the RFID token to remove.
+  required: true
+{% endoptions_ui %}
+
 {% include actions/yaml_header.md %}
 
 In YAML, refer to this action as `peblar.remove_rfid_token`. A basic example looks like this:
@@ -40,3 +63,26 @@ uid:
   required: true
   type: string
 {% endoptions_yaml %}
+
+{% include actions/more_examples.md %}
+
+### Automation: remove an RFID token when a person leaves
+
+When a person is marked as away from home, automatically remove their RFID token from the charger.
+
+{% details "YAML example for removing an RFID token when someone leaves" %}
+
+{% example %}
+automation: |
+  triggers:
+    - trigger: state
+      entity_id: person.jane
+      to: "not_home"
+  actions:
+    - action: peblar.remove_rfid_token
+      data:
+        config_entry_id: "01234567890abcdef01234567890abcd"
+        uid: "04A1B2C3D4E5F6"
+{% endexample %}
+
+{% enddetails %}

source/_integrations/peblar.markdown

@@ -229,13 +229,7 @@ Although this integration uses local polling, any configuration changes you make
 Peblar charger from Home Assistant will appear on the charger almost
 instantly.
 
-## Actions
-
-The Peblar integration provides the following actions to manage the RFID tokens in the charger's standalone authorization list.
-
-- [List RFID tokens](/actions/peblar.list_rfid_tokens/) — returns all RFID tokens currently configured on the charger.
-- [Add RFID token](/actions/peblar.add_rfid_token/) — adds a new RFID token using a UID and description.
-- [Remove RFID token](/actions/peblar.remove_rfid_token/) — removes an RFID token by its UID.
+{% include integrations/actions.md %}
 
 ## Examples