From 874e76d797f1bce1267340f29f0beead5f2d6528 Mon Sep 17 00:00:00 2001 From: ubnt-marc-khouri <35465461+ubnt-marc-khouri@users.noreply.github.com> Date: Fri, 19 Jan 2018 16:53:53 -0500 Subject: [PATCH] Documentation tweak (#4466) * Add Wink to "discovery" component docs * Views (groups with `view: yes`) cannot be nested in other views This commit documents that groups with `view: yes` cannot be used as entities within another group with `view: yes`. Several forum users have been confused by this behaviour -- and me too! :) Example posts: - https://community.home-assistant.io/t/groups-not-appearing/23593 - https://community.home-assistant.io/t/group-cards-not-showing/1052/14 - https://community.home-assistant.io/t/groups-not-shown-on-state-tab/30395/2 --- source/_components/discovery.markdown | 4 +++- source/_components/group.markdown | 8 ++++---- 2 files changed, 7 insertions(+), 5 deletions(-) diff --git a/source/_components/discovery.markdown b/source/_components/discovery.markdown index 18ac58261ce..f6629e31598 100644 --- a/source/_components/discovery.markdown +++ b/source/_components/discovery.markdown @@ -36,6 +36,7 @@ Home Assistant can discover and automatically configure [zeroconf](https://en.wi * [Samsung TVs](https://home-assistant.io/components/media_player.samsungtv/) * [Sonos speakers](https://home-assistant.io/components/media_player.sonos/) * [Telldus Live](https://home-assistant.io/components/tellduslive/) + * [Wink](https://home-assistant.io/components/wink/) * [Yamaha media player](https://home-assistant.io/components/media_player.yamaha/) * [Yeelight Sunflower bulb](https://home-assistant.io/components/light.yeelightsunflower/) @@ -79,9 +80,10 @@ Valid values for ignore are: * `samsung_tv`: Samsung TVs * `sonos`: Sonos speakers * `tellduslive`: Telldus Live + * `wink`: Wink Hub * `yamaha`: Yamaha media player * `yeelight`: Yeelight Sunflower bulb - +

Home Assistant must be on the same network as the devices for uPnP discovery to work. If running Home Assistant in a [Docker container](/docs/installation/docker/) use switch `--net=host` to put it on the host's network. diff --git a/source/_components/group.markdown b/source/_components/group.markdown index 74f07dc49bb..9a515fafc6f 100644 --- a/source/_components/group.markdown +++ b/source/_components/group.markdown @@ -22,7 +22,7 @@ By default, every group appears in the HOME tab. If you create a group `default_ group: default_view: view: yes - icon: mdi:home + icon: mdi:home entities: - group.kitchen - group.awesome_people @@ -56,7 +56,7 @@ group: Configuration variables: -- **view** (*Optional*): If yes then the entry will be shown as a view (tab) at the top. +- **view** (*Optional*): If yes then the entry will be shown as a view (tab) at the top. Groups that are set to `view: yes` cannot be used as entities in other views. - **name** (*Optional*): Name of the group. - **icon** (*Optional*): If the group is a view, this icon will show at the top in the frontend instead of the name. If the group is a view and both name and icon have been specified, the icon will appear at the top of the frontend and the name will be displayed as the mouse-over text. If it's not a view, then the icon shows when this group is used in another group. - **control** (*Optional*): Set value to `hidden`. If hidden then the group switch will be hidden. @@ -69,7 +69,7 @@ Example of groups shown as views in the frontend. If all entities in a group are switches or lights then Home Assistant adds a switch at the top of the card that turns them all on/off at once. If you want to hide this switch, set `control` to `hidden`. -You can create views (tabs) that contain other groups. +You can create views (tabs) that contain other groups (but not other groups which are marked as `view: yes`). Notice in the example below that in order to refer to the group "Living Room", you use `group.living_room` (lowercase and spaces replaced with underscores). ```yaml @@ -86,7 +86,7 @@ Notice in the example below that in order to refer to the group "Living Room", y entities: - group.living_room - group.bedroom -``` +``` ## {% linkable_title Default groups %}