f6147a0787
- Add main card implementation with full/compact/super_compact modes - Support for sparkline and bars widgets with effects - Price color coding based on best/worst price ranges - Alert system for high/low price thresholds - Polish/English translations support - HACS integration configuration - Development guidelines in AGENTS.md
95 lines
3.9 KiB
Markdown
95 lines
3.9 KiB
Markdown
# 🏠 Pstryk Energy Card dla Home Assistant
|
||
|
||
  
|
||
|
||
---
|
||
|
||
## ✨ Co potrafi?
|
||
|
||
* 🎨 Trzy tryby wyświetlania: **pełny**, **kompaktowy**, **super kompaktowy**
|
||
* 📊 Widgety: słupki lub linia z animacją
|
||
* 🚨 Alerty: ostrzeżenia, gdy cena przekracza ustalone progi
|
||
* 🔴🟢 Zmiana koloru na czerwony/zielony w zależności od ustawień cen w integracji
|
||
* 🌍 Obsługa PL i EN – karta sama wykryje język
|
||
* 🎯 Efekty i zbędne bajery
|
||
|
||
|
||
|
||
|
||
|
||
## 📦 Jak zainstalować?
|
||
|
||
**1. HACS (najprościej)**
|
||
|
||
1. Otwórz HACS → **+**
|
||
2. Wybierz **Custom repositories**
|
||
3. Wklej URL: `https://github.com/balgerion/ha_Pstryk_card`
|
||
4. W kategorii zaznacz **Dashboard** i kliknij **Add**
|
||
5. Zainstaluj **Pstryk Energy Card**
|
||
6. Zrestartuj Home Assistant
|
||
|
||
**2. Ręcznie**
|
||
|
||
1. Ściągnij plik `pstryk-card.js` i wrzuć do `/www/community/pstryk-card`
|
||
2. W Home Assistant: **Settings → Dashboards → Resources → Add Resource**
|
||
|
||
* URL: `/local/community/pstryk-card/pstryk-card.js`
|
||
* Typ: **JavaScript Module**
|
||
3. Zrestartuj
|
||
|
||
---
|
||
|
||
## 🚀 Szybki start - przykłady
|
||
|
||
##full
|
||
|
||
```yaml
|
||
type: custom:pstryk-card
|
||
buy_entity: sensor.pstryk_current_buy_price
|
||
sell_entity: sensor.pstryk_current_sell_price
|
||
card_mode: full # full | compact | super_compact
|
||
show_title: true # true | false
|
||
show_legend: true # true | false
|
||
show_widget: sparkline # none | bars | sparkline
|
||
widget_effect: pulse # none | pulse (sparkline) | fill (bars)
|
||
widget_hours: 24 # 1-48
|
||
alert_buy_above: 1.15 # liczba lub null
|
||
alert_sell_below: 0.25 # liczba lub null
|
||
hover_effect: lift # none | lift | glow | shake | pulse
|
||
click_action: none # none | more-info
|
||
```
|
||
##Kompaktowy z słupkami
|
||
```yaml
|
||
type: custom:pstryk-card
|
||
buy_entity: sensor.pstryk_current_buy_price
|
||
sell_entity: sensor.pstryk_current_sell_price
|
||
card_mode: compact # full | compact | super_compact
|
||
show_widget: bars # none | bars | sparkline
|
||
widget_effect: fill # none | fill (bars) | pulse (sparkline)
|
||
widget_hours: 12 # 1-48
|
||
hover_effect: glow # none | lift | glow | shake | pulse
|
||
attribute_config: average_24 # next_hour | average_remaining | average_24 | null | custom_attribute
|
||
```
|
||
|
||
##Super kompaktowy (minimalny)
|
||
```yaml
|
||
type: custom:pstryk-card
|
||
buy_entity: sensor.pstryk_current_buy_price
|
||
sell_entity: sensor.pstryk_current_sell_price
|
||
card_mode: super_compact # full | compact | super_compact
|
||
alert_buy_above: 1.0 # liczba lub null
|
||
alert_sell_below: 0.1 # liczba lub null
|
||
```
|
||
|
||
## ⚙️ Wszystkie opcje
|
||
|
||
* **buy\_entity** (`string`) – encja z ceną zakupu (np. `sensor.pstryk_current_buy_price`)
|
||
* **sell\_entity** (`string`) – encja z ceną sprzedaży
|
||
* **card\_mode** (`full`/`compact`/`super_compact`) – wybierz wygląd karty
|
||
* **title** (`string`) – tekst nagłówka (domyślnie "Energy Prices")
|
||
* **show\_title** (`true`/`false`) – wyświetl tytuł
|
||
* **show\_legend** (`true`/`false`) – legenda kolorów (tylko w `full`)
|
||
* **attribute\_config** (`next_hour`/`average_remaining`/`average_24`/`null`/`custom`) – dodatkowy atrybut
|
||
* **show\_widget** (`none`/`bars`/`sparkline`) – typ wykresu
|
||
* **widget\_effect** (`none`/`pulse`/`fill`) – animacja wykresu (pulse (sparkline), fill (bars))
|