Big Brother

Google Analytics dashboard

Creator: Stephane Boulard (lossendae)
Updated By: markh

2.2.0-pl (3970 KB) Other Versions Need help installing this extra?


About Big Brother

A Google Analytics dashboard for MODX, brought to you by modmore. Originally developed in 2011 by Stephane Boulard (lossendae), rebuild completely in 2021 for Google Analytics 4

Big Brother v2 only supports Google Analytics v4. To use Big Brother with Google Analytics v3 ("Universal Analytics"), you need to install Big Brother v1.5 instead.

Learn about the difference between Google Analytics v3 ("Universal Analytics") and v4.

Big Brother gives you a quick overview of the most important metrics from Google Analytics, directly on the MODX dashboard.

The following data is provided:

  • Line-chart showing your daily visitors in the last 4 weeks, compared against the previous period
  • Number of sessions, page views, unique visitors, average engagement rate, and average time on site over the past 4 weeks
  • Acquisition sources
  • Most popular pages by page views
  • Top countries by unique users
  • Top referring domains

Authorization with your Google account is easy and secure; just follow the steps when prompted to authorize. The information to access information for an authorized profile never leaves your site. It's also possible to configure custom credentials.

Have issues authenticating your Google Analytics account on a site that used v1.3.2 or earlier, or 2.1.0 or earlier versions? Remove the bigbrother.native_app_client_id and `bigbrother.native_app_client_secret` system settings from your site, and reinstall Big Brother.


October 1, 2021
Supported Versions
2.0 – Current
Supported Database



  • Download & install via the MODX Package Manager. Note that if you want to use v1.5, you need to use the modmore package provider.
  • In System > Dashboards, add the Google Analytics dashboard widget to a dashboard. As MODX 2 overwrites the default dashboards on upgrade, use a custom dashboard and in System > Access Control Lists > edit user group select the appropriate dashboard widget.
  • Navigate to the dashboard
  • Follow the instructions to authorize access to your Google Analytics account.

The source code and issue tracker for bugs and feature requests can be found on GitHub


New in Big Brother 2.2.0

Big Brother v2 is a complete rewrite for use with Google Analytics v4. If your property uses Google Analytics v3 ("Universal Analytics"), downgrade to v1.5 instead.

Big Brother 2.2.0-pl

Released on 2021-10-02

  • Add new "Top Referrers" widget to show common domain referrals. This is a standalone widget, so add it to your dashboard to use.
  • Catch JS errors when instantiating widgets to avoid subsequent widgets from breaking if one fails
  • Fix error in acquisitions widget if only one time period is returned (i.e. on freshly created properties)
  • Fix incorrect values and comparison arrow in popular pages and top countries widgets
  • Fix "Invalid argument supplied for foreach()" in key metrics widget if only one time period is returned [S29809]

Big Brother 2.1.1-pl

Released on 2021-09-25

  • Fix default credentials missing from the v2 build. If you installed an earlier v2 release and do not want to use custom oAuth credentials, delete the bigbrother.native_app_client_id and bigbrother.native_app_client_secret system settings (yes, delete them entirely) and reinstall the package to return to the default. [S29488]

Big Brother 2.1.0-pl

Released on 2021-09-16

  • Fix javascript error when profiles can't be loaded in the authorized screen, and adjust error message to indicate potential reasons [#78]
  • Add BigBrother Admin policy/template and assign to admin on install
  • Restrict authorization page to users with the bigbrother_authorize permission
  • Update dependencies: chart.js to 3.5.1, luxon to 1.28.0, chartjs-adapter-luxon to 1.1.0, uglify-js to 3.14.2, google/analytics-admin to 0.4.0, google/analytics-data to 0.7.0

Big Brother 2.0.2-pl

Released on 2021-08-03

  • Fix issue installing guzzle7 due to incorrect version requirement

Big Brother 2.0.1-pl

Released on 2021-08-03

Big Brother 2.0.0-pl

Released on 2021-08-02

  • Bump minimum PHP version to 7.2; this matches the updated MODX3 minimum version and resolves a Guzzle version conflict
  • On MODX3 alpha4+, use the core-provided PSR7 Client with the Google SDK
  • Update dependencies (uglify-js 3.14.1, chart.js 3.5.0, luxon 1.28, google/analytics-data 0.5.1, google/analytics-admin 0.3.0)
  • Fix v1 widget not being replaced correctly on upgrade
  • Remove v1 menu item on upgrade

Big Brother 2.0.0-dev4

Released on 2021-06-08

  • Fail installation if bcmath extension is not loaded; this is a requirement in the Google Protobuf dependency
  • Catch API errors in listing accounts/properties, generating reports, verifying oAuth code, and refreshing access token [#47]
  • Downgrade some dependencies to allow installation on 7.1 and up (once requirement goes up to 7.3+ this can be reverted)

Big Brother 2.0.0-dev3

Released on 2021-06-07

  • Make sure v1 widget is removed on upgrade to v2, attempt to automatically migrate
  • Adjust the build to be more in line with our other packages

Big Brother 2.0.0-dev2

Released on 2021-06-07

  • Fix broken lexicons in the dashboard widget selection
  • Fix requirements disallowing MODX3 (left-over from 1.5)

Big Brother 2.0.0-dev1

Released on 2021-06-07

This is the first development build of Big Brother v2, containing 6 dashboard widgets.

Big Brother v2 is a complete rewrite to support Google Analytics v4 and MODX3. It cannot be used with Universal Analytics. It can be used on MODX 2.8 and up.


Current Releases

October 1, 2021
2.0 – Current
September 25, 2021
2.0 – Current
August 3, 2021
2.0 – Current
View Deprecated Releases

More from Stephane Boulard



An image gallery manager for MODx Revolution


Trendy - Manager theme

A manager theme for MODx Revolution 2.2


My Journal

An Article Manager for MODx Revolution


Soft Manager Theme

Alternative manager theme for MODx RevolutionCredits   …