From a0beaa92ece7d3e8302234bf9324ad06565a6d3d Mon Sep 17 00:00:00 2001
From: Derek <derek.antosiek@gmail.com>
Date: Mon, 30 Oct 2017 16:58:13 -0400
Subject: [PATCH] Added an icon template as well as general improvements.
 (#3762)

* Added an icon template as well as general improvements.

Added an icon template example as well as a friendly name option, this way no customizing needs to take place outside of the sensor itself.
Also added the entity_id option for best practice.

* Added raw/endraw

* Title was confusing, reverted to previous title.

* Move raw
---
 source/_cookbook/track_battery_level.markdown | 26 +++++++++++++++----
 1 file changed, 21 insertions(+), 5 deletions(-)

diff --git a/source/_cookbook/track_battery_level.markdown b/source/_cookbook/track_battery_level.markdown
index 0e76fd083e5..9de6b14cfb0 100644
--- a/source/_cookbook/track_battery_level.markdown
+++ b/source/_cookbook/track_battery_level.markdown
@@ -12,21 +12,36 @@ ha_category: Automation Examples
 
 ### {% linkable_title iOS Devices %}
 
-If you have a device running iOS (iPhone, iPad, etc), The [iCloud](/components/device_tracker.icloud/) is gathering various details about your device including the battery level. To display it in the Frontend use a [template sensor](/components/sensor.template/).
+If you have a device running iOS (iPhone, iPad, etc), The [iCloud](/components/device_tracker.icloud/) is gathering various details about your device including the battery level. To display it in the Frontend use a [template sensor](/components/sensor.template/). You can also use the icon template option to create a dynamic icon that changes with the battery level.
 
+{% raw %}
 ```yaml
 sensor:
   - platform: template
     sensors:
       battery_iphone:
+        friendly_name: iPhone Battery
+        # "entity_id:" ensures that this sensor will only update when your device tracker does.
+        entity_id: device_tracker.iphone
         unit_of_measurement: '%'
         value_template: >-
-            {% raw %}{%- if states.device_tracker.iphone.attributes.battery %}
+            {%- if states.device_tracker.iphone.attributes.battery %}
                 {{ states.device_tracker.iphone.attributes.battery|round }}
             {% else %}
                 {{ states.sensor.battery_iphone.state }}
-            {%- endif %}{% endraw %}
+            {%- endif %}
+        icon_template: >
+            {% set battery_level = states.sensor.battery_iphone.state|default(0)|int %}
+            {% set battery_round = (battery_level / 10) |int * 10 %}
+            {% if battery_round >= 100 %}
+              mdi:battery
+            {% elif battery_round > 0 %}
+              mdi:battery-{{ battery_round }}
+            {% else %}
+              mdi:battery-alert
+            {% endif %}
 ```
+{% endraw %}
 
 The `else` part is used to have the sensor keep it's last state if the newest [iCloud](/components/device_tracker.icloud/) update doesn't have any battery state in it (which happens sometimes). Otherwise the sensor will be blank.
 
@@ -34,12 +49,13 @@ The `else` part is used to have the sensor keep it's last state if the newest [i
 
 While running the [Owntracks](/components/device_tracker.owntracks/) device tracker you can retrieve the battery level with a MQTT sensor. Replace username with your MQTT username (for the embedded MQTT it's simply homeassistant), and deviceid with the set Device ID in Owntracks.
 
+{% raw %}
 ```yaml
 sensor:
   - platform: mqtt
     state_topic: "owntracks/username/deviceid"
     name: "Battery Tablet"
     unit_of_measurement: "%"
-    value_template: {% raw %}'{{ value_json.batt }}'{% endraw %}
+    value_template: '{{ value_json.batt }}'
 ```
-
+{% endraw %}