growattStats

Growatt solar generation statistics and charts for MODX 2

Creator: Anton Tarasov (antar)

Need help installing this extra?

Screenshots

About growattStats

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.

Information

Released
September 24, 2026

Supported Database
MySQL

License
GPLv2

Supported Versions
2.8 - <3.0

Downloads
0

Documentation
growattStats Documentation

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.

  • Install CronManager through MODX Package Management.
  • Install growattStats and enter growattstats_token and growattstats_plant_id when prompted.
  • In System Settings, select the growattstats namespace and set growattstats_plant_name.
  • Add [[!growattShowChart]] to a resource.
  • 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

    New in 1.0.2-beta12

    Initial public beta for MODX Revolution 2.8.x.

    • Growatt generation cards and interactive Apache ECharts history charts
    • Frontend snippet and MODX Manager dashboard widget
    • English and Russian translations, including chart dates
    • Automatic CronManager refresh job registration
    • Multiple independent charts and dashed indicators for missing readings
    • Installer prompts for the Growatt API token and Plant ID
    • Existing credentials, history and customized schedules are preserved during upgrades

    Further improvements are planned. Feedback and bug reports are welcome on GitHub. MODX 3 support is planned for a separate future release

    Current releases

    1.0.2-beta12
    View | Download
    September 24, 2026
    2.8 - <3.0