growattStats

Package Description

Display Growatt solar generation, interactive Apache ECharts history charts, and a Manager dashboard widget. Includes English and Russian translations and scheduled updates through CronManager. Requires a Growatt API token and Plant ID. Initial public beta for MODX 2.8.x, with further improvements planned, feedback is welcome on GitHub.

Usage/Installation Instructions

Requirements: MODX Revolution 2.8.x, PHP 7.4+ with cURL and JSON, CronManager 1.2.2+, and a valid Growatt API token and Plant ID. 1. Install CronManager through MODX Package Management. 2. Install growattStats and enter growattstats_token and growattstats_plant_id when prompted. 3. In System Settings, select the growattstats namespace and set growattstats_plant_name. 4. Add [[!growattShowChart]] to a resource. 5. Add the growattStats widget to your Manager dashboard if required. Installation creates an active CronManager job with a 15-minute interval. An external scheduler must invoke CronManager every minute. The cron service must be running. Example user crontab entry: * * * * * /usr/bin/php /path/to/modx/assets/components/cronmanager/cron.php Replace both paths with the correct server paths. On shared hosting, configure this command in the hosting control panel. On Windows, use Task Scheduler. Verify successful execution in the CronManager job log. CronManager documentation: https://jako.github.io/CronManager/usage/ Crontab documentation: https://man7.org/linux/man-pages/man5/crontab.5.html Frontend language follows the context's cultureKey setting (en or ru). Dashboard language follows the Manager language. To customize the layout, copy the growattShowChart chunk under a new name and call: [[!growattShowChart? &tpl=`MySolarChart`]] Keep the [[+chart]] placeholder in custom chunks. Upgrades replace bundled chunks. Leave credential fields blank during upgrades to retain their current values. History accumulates from successful refreshes. Missing historical dates are not recovered automatically. Full documentation: https://github.com/ant-tar/growattStats/blob/main/README.md