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
This commit is contained in:
ubnt-marc-khouri 2018-01-19 16:53:53 -05:00 committed by Fabian Affolter
parent 9186821adf
commit 874e76d797
2 changed files with 7 additions and 5 deletions

View File

@ -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/) * [Samsung TVs](https://home-assistant.io/components/media_player.samsungtv/)
* [Sonos speakers](https://home-assistant.io/components/media_player.sonos/) * [Sonos speakers](https://home-assistant.io/components/media_player.sonos/)
* [Telldus Live](https://home-assistant.io/components/tellduslive/) * [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/) * [Yamaha media player](https://home-assistant.io/components/media_player.yamaha/)
* [Yeelight Sunflower bulb](https://home-assistant.io/components/light.yeelightsunflower/) * [Yeelight Sunflower bulb](https://home-assistant.io/components/light.yeelightsunflower/)
@ -79,9 +80,10 @@ Valid values for ignore are:
* `samsung_tv`: Samsung TVs * `samsung_tv`: Samsung TVs
* `sonos`: Sonos speakers * `sonos`: Sonos speakers
* `tellduslive`: Telldus Live * `tellduslive`: Telldus Live
* `wink`: Wink Hub
* `yamaha`: Yamaha media player * `yamaha`: Yamaha media player
* `yeelight`: Yeelight Sunflower bulb * `yeelight`: Yeelight Sunflower bulb
<p class='note'> <p class='note'>
Home Assistant must be on the same network as the devices for uPnP discovery to work. 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. If running Home Assistant in a [Docker container](/docs/installation/docker/) use switch `--net=host` to put it on the host's network.

View File

@ -22,7 +22,7 @@ By default, every group appears in the HOME tab. If you create a group `default_
group: group:
default_view: default_view:
view: yes view: yes
icon: mdi:home icon: mdi:home
entities: entities:
- group.kitchen - group.kitchen
- group.awesome_people - group.awesome_people
@ -56,7 +56,7 @@ group:
Configuration variables: 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. - **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. - **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. - **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`. 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). 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 ```yaml
@ -86,7 +86,7 @@ Notice in the example below that in order to refer to the group "Living Room", y
entities: entities:
- group.living_room - group.living_room
- group.bedroom - group.bedroom
``` ```
## {% linkable_title Default groups %} ## {% linkable_title Default groups %}