Merge branch 'current' into rc

Gemfile.lock

@@ -79,7 +79,7 @@ GEM
       forwardable-extended (~> 2.6)
     public_suffix (4.0.7)
     racc (1.6.0)
-    rack (2.2.3)
+    rack (2.2.3.1)
     rack-protection (2.2.0)
       rack
     rake (13.0.6)

source/_dashboards/picture-elements.markdown

@@ -135,41 +135,6 @@ state_color:
   description: Set to `true` to have icons colored when entity is active.
   type: boolean
   default: true
-tap_action:
-  required: false
-  description: Action to take on tap.
-  type: map
-  keys:
-    action:
-      required: true
-      description: "Action to perform (`more-info`, `toggle`, `call-service`, `navigate`, `url`, `none`)."
-      type: string
-      default: "`more-info`"
-    navigation_path:
-      required: false
-      description: "Path to navigate to (e.g., `/lovelace/0/`) when `action` defined as `navigate`."
-      type: string
-      default: none
-    url_path:
-      required: false
-      description: "Path to navigate to (e.g., `https://www.home-assistant.io`) when `action` defined as `url`."
-      type: string
-      default: none
-    service:
-      required: false
-      description: "Service to call (e.g., `media_player.media_play_pause`) when `action` defined as `call-service`."
-      type: string
-      default: none
-    data:
-      required: false
-      description: "Service data to include (e.g., `entity_id: media_player.bedroom`) when `action` defined as `call-service`."
-      type: string
-      default: none
-    confirmation:
-      required: false
-      description: "Present a confirmation dialog to confirm the action. See `confirmation` object below."
-      type: [boolean, map]
-      default: "false"
 tap_action:
   required: false
   description: Action taken on card tap. See [action documentation](/dashboards/actions/#tap-action).

source/_integrations/calendar.markdown

@@ -36,11 +36,22 @@ automation:
       offset: -00:15:00
 ```
 
-### Example Automation
+Calendar triggers should should generally not use automation mode `single` to ensure the trigger
+can fire when multiple events start at the same time (e.g. use `queued` or `parallel` instead)
 
-This is an example of an automation that sends a notification with details about the event that
-triggered the automation. See [Automation Trigger Variables: Calendar](/docs/automation/templating/#calendar) for additional trigger data available for conditions or actions.
+See [Automation Trigger Variables: Calendar](/docs/automation/templating/#calendar) for additional trigger data available for conditions or actions.
 
+### Automation Recipes
+
+Below are a few example ways you can use Calendar triggers.
+
+{% details "Example: Calendar Event Notification " %}
+
+This example automation consists of:
+- For the calendar entity `calendar.personal`
+- At the start of any calendar event
+- Send a notification with the title and start time of the event
+- Allowing multiple events starting at the same time
 
 {% raw %}
 ```yaml
@@ -56,6 +67,42 @@ automation:
         message: >-
           Event {{ trigger.calendar_event.summary }} @
           {{ trigger.calendar_event.start }}
-  mode: single
+  mode: queued
 ```
 {% endraw %}
+
+{% enddetails %}
+
+{% details "Example: Calendar Event Light Schedule " %}
+
+This example consists of:
+- For the calendar entity ` calendar.device_automation`
+- When event summary contains `Front Lights`
+- Turn on and off light named `light.front` when the event starts and ends
+
+{% raw %}
+```yaml
+automation:
+  alias: Front Light Schedule
+  trigger:
+    - platform: calendar
+      event: start
+      entity_id: calendar.device_automation
+    - platform: calendar
+      event: end
+      entity_id: calendar.device_automation
+  condition:
+    - condition: template
+      value_template: "{{ 'Front Lights' in trigger.calendar_event.summary }}"
+  action:
+    - if:
+        - "{{ trigger.event == 'start' }}"
+      then:
+        - service: light.turn_on
+      else:
+        - service: light.turn_off
+  mode: queued
+```
+{% endraw %}
+
+{% enddetails %}

source/_posts/2022-05-29-matter-in-home-assistant-workshop-announcement.markdown

@@ -0,0 +1,38 @@
+---
+layout: post
+title: "Matter in Home Assistant workshop announcement"
+description: "On June 15 we're showing how Matter will work and guide you in getting it set up."
+date: 2022-05-29 00:00:00
+date_formatted: "May 29, 2022"
+author: Paulus Schoutsen
+author_twitter: balloob
+comments: true
+categories:
+- Announcements
+og_image: /images/blog/2022-05-matter-in-home-assistant-workshop-announcement/social.png
+---
+
+<img src='/images/blog/2022-05-matter-in-home-assistant-workshop-announcement/header.png' alt="Decorative header." class='no-shadow'>
+
+Matter is a new [smart home standard](https://csa-iot.org/all-solutions/matter/) that is scheduled to launch in fall. Across the industry, companies like Hue, IKEA, Google and Apple are working together to try and solve connectivity, ease of setup and interoperability once and for all. Development is happening as part of the [Connectivity Standards Alliance](https://csa-iot.org/) (CSA) of which we ([Nabu Casa](https://www.nabucasa.com)) are also a participating member.
+
+<center><img src='/images/supported_brands/matter.png' alt='Matter logo' class='no-shadow'></center><br>
+
+We’ve been hard at work on Matter support for Home Assistant. The [Home Assistant Yellow](/yellow/) hub will come with a radio that supports Thread, required to talk to low power Matter devices. We also have some tricks up our sleeves for devices used to run Home Assistant without such a radio, like Raspberry Pi’s. We want to show what we’re up to and allow you to test it out.
+
+**On June 15 @ 12:00 PDT / 21:00 CET we will be hosting our free Matter in Home Assistant workshop.**
+
+The workshop will be held on YouTube. [Go to the listing to set a reminder to be notified when we start.](https://www.youtube.com/watch?v=9fOHBl5w0_k)
+
+The workshop will contain two parts. In the first part we will talk about what Matter is and how it will work in Home Assistant. In the second part we will walk you through how to add experimental Matter support to your Home Assistant installation and integrate your first Wi-Fi based Matter device.
+
+The workshop will be free but you will need a couple of things if you want to be able to follow along with the second part:
+
+- Home Assistant OS 8.0 or newer (Matter relies on an add-on and Bluetooth)
+- [Home Assistant Community Store](https://hacs.xyz/) installed
+- Espressif ESP32-C3-DevKitM-1 ($9 @ [Mouser](https://www.mouser.com/ProductDetail/356-ESP32-C3DEVKITM1), €13.50 @ [Reichelt](https://www.reichelt.com/nl/en/developmentkit-esp32-c3-mini-1-esp32c3devkitm-p311730.html))
+- Bluetooth. If you use a Raspberry Pi to run Home Assistant you’re set. If you have a Home Assistant Blue or another device without Bluetooth, get a Bluetooth USB adapter that is supported by Home Assistant OS ([like this one](https://www.amazon.com/gp/product/B09DMP6T22/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=B09DMP6T22&linkCode=as2&tag=homeassista0e-20&linkId=c5046239bf04d5b21835299dfb393f0e)).
+
+Even if you can’t follow along, it will still be an informative session!
+
+_It is possible to get the experimental Matter support working with other Home Assistant installation methods and other dev kits, but we won’t be covering those in our workshop._

source/dashboards/actions.markdown

@@ -28,7 +28,7 @@ tap_action:
 {% configuration tap-action %}
 tap_action:
   required: false
-  description: Action to take on tap.
+  description: Action taken on tap.
   type: map
   keys:
     action:
@@ -75,7 +75,7 @@ hold_action:
 {% configuration hold_action %}
 hold_action:
   required: false
-  description: Action to take on tap-and-hold
+  description: Action taken on tap-and-hold
   type: map
   keys:
     action:
@@ -122,7 +122,7 @@ double_tap_action:
 {% configuration double_tap_action %}
 double_tap_action:
   required: false
-  description: Action to take on double tap
+  description: Action taken on double tap
   type: map
   keys:
     action:

source/dashboards/header-footer.markdown

@@ -34,11 +34,11 @@ tap_action:
   type: map
 hold_action:
   required: false
-  description: Action to take on tap-and-hold. See [action documentation](/dashboards/actions/#hold-action).
+  description: Action taken on tap-and-hold. See [action documentation](/dashboards/actions/#hold-action).
   type: map
 double_tap_action:
   required: false
-  description: Action to take on double tap. See [action documentation](/dashboards/actions/#double-tap-action).
+  description: Action taken on double tap. See [action documentation](/dashboards/actions/#double-tap-action).
   type: map
 {% endconfiguration %}
 
@@ -79,6 +79,29 @@ entities:
       required: false
       description: Label for the button.
       type: string
+    show_icon:
+      required: false
+      description: Show entity icon.
+      type: boolean
+      default: "true"  
+    show_name:
+      required: false
+      description: Show entity name.
+      type: boolean
+      default: "false"
+    tap_action:
+      required: false
+      description: Action taken on button tap. See [action documentation](/dashboards/actions/#tap-action).
+      type: map
+    hold_action:
+      required: false
+      description: Action taken on tap-and-hold. See [action documentation](/dashboards/actions/#hold-action).
+      type: map
+    double_tap_action:
+      required: false
+      description: Action taken on double tap. See [action documentation](/dashboards/actions/#double-tap-action).
+      type: map
+    
 {% endconfiguration %}
 
 ## Graph header & footer

source/help/index.markdown

@@ -34,8 +34,8 @@ Have you found an issue in your Home Assistant installation? Please report it. R
 - [Why we can't have the Internet of Nice Things: A home automation primer](https://www.openwest.org/custom/description.php?id=92) at [OpenWest 2017](https://www.openwest.org) - July 2017
 - [Home Automation with Home Assistant](https://github.com/jjmontesl/talk-hass-pydaygalicia2017) at [PyDay Galicia 2017](https://pyday2017.python-vigo.es/gl/) - June 2017
 - [Home Automation with Python](https://www.youtube.com/watch?v=KNFZSSCPUyM) at [GLT 2017](https://glt17.linuxtage.at) - April 2017
-- [Home Assistant workshop](https://github.com/home-assistant/home-assistant-assets/tree/master/german/2017-clt-workshop) at [CLT 2017](https://chemnitzer.linux-tage.de/2017/de/) - March 2017
-- [Home Assistant - Erweiterungen (Platforms/Components)](https://github.com/home-assistant/home-assistant-assets/tree/master/german/2016-puzzle) at [Puzzle ITC](https://www.puzzle.ch/de/) - December 2016
+- [Home Assistant workshop](https://github.com/home-assistant-ecosystem/workshops/tree/main/2017-clt-workshop) at [CLT 2017](https://chemnitzer.linux-tage.de/2017/de/) at [CLT 2017](https://chemnitzer.linux-tage.de/2017/de/) - March 2017
+- [Home Assistant - Erweiterungen (Platforms/Components)](https://github.com/home-assistant-ecosystem/workshops/tree/main/2016-puzzle) at [Puzzle ITC](https://www.puzzle.ch/de/) - December 2016
 - [Automating Your Life - Home Automation](https://slides.com/teagan42/life_automation#/) at Develop Denver 2016 - August
 - [Building Online Communities: Home Assistant](https://medium.com/@gitter/building-online-communities-home-assistant-8818dff671ad#.och4x4rhx) - July 2016
 - [Home Assistant Support 101 - Getting around in Home Assistant](https://www.youtube.com/watch?v=dRfk9JAlPJk) (Slides) - June 2016
@@ -77,7 +77,6 @@ Don't miss the regular [Home Assistant podcasts](https://hasspodcast.io/).
 - [Castálio Podcast - Episódio 102: Marcelo Mello - Red Hat e Automação Residencial com Home Assistant](https://youtu.be/hZq8ucpzjCs) - May 2017
 - [Paulus Schoutsen and Home Assistant - Episode 8](https://codepop.com/open-sourcecraft/episodes/paulus-schoutsen/) - March 2017
 - [Zammad, Home Assistant and Freifunk - are the winner of the Thomas-Krenn-Awards 2017](https://www.thomas-krenn.com/de/tkmag/allgemein/zammad-home-assistant-und-freifunk-das-sind-die-gewinner-des-thomas-krenn-awards-2017/) - March 2017
-- [10 open source software tools for developing IoT applications](https://www.cbronline.com/news/internet-of-things/10-open-source-software-tools-developing-iot-applications/) - March 2017
 - [Home Assistant with Paulus Schoutsen - Episode 94](https://www.podcastinit.com/episode-94-home-assistant-with-paulus-schoutsen/) - January 2017
 - [Episode #11](https://pythonbytes.fm/episodes/show/11/django-2.0-is-dropping-python-2-entirely-pipenv-for-profile-functionality-and-pythonic-home-automation) at minute 15:20 by [Python Bytes](https://pythonbytes.fm/) - January 2017
 - [Now you can hide your smart home on the darknet](https://www.wired.com/2016/07/now-can-hide-smart-home-darknet/) - July 2016