{"id":13490130,"url":"https://github.com/DevDavido/performance-audit-plugin","last_synced_at":"2025-03-28T05:31:59.933Z","repository":{"id":47276250,"uuid":"278916128","full_name":"DevDavido/performance-audit-plugin","owner":"DevDavido","description":"Daily performance audits of all your sites in Matomo.","archived":false,"fork":false,"pushed_at":"2024-08-14T14:09:33.000Z","size":1807,"stargazers_count":12,"open_issues_count":5,"forks_count":4,"subscribers_count":8,"default_branch":"5.x-dev","last_synced_at":"2024-08-17T12:07:35.825Z","etag":null,"topics":["audit","cumulative-layout-shift","first-contentful-paint","interactive","interactive-to-interactive","largest-contentful-paint","lighthouse","matomo","measure","monitor","performance","report","speed-index","total-blocking-time","web-vitals"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DevDavido.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":"Audits/.gitkeep","citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"buy_me_a_coffee":"devdavido"}},"created_at":"2020-07-11T18:06:13.000Z","updated_at":"2024-08-17T12:07:35.826Z","dependencies_parsed_at":"2023-12-25T00:19:02.438Z","dependency_job_id":"97e06924-5cac-40da-aa32-82204771c127","html_url":"https://github.com/DevDavido/performance-audit-plugin","commit_stats":{"total_commits":200,"total_committers":3,"mean_commits":66.66666666666667,"dds":"0.43999999999999995","last_synced_commit":"acaa1139e1ede76ca25cafe7e30e0ff3abfd1cd8"},"previous_names":[],"tags_count":27,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevDavido%2Fperformance-audit-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevDavido%2Fperformance-audit-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevDavido%2Fperformance-audit-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevDavido%2Fperformance-audit-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DevDavido","download_url":"https://codeload.github.com/DevDavido/performance-audit-plugin/tar.gz/refs/heads/5.x-dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222351189,"owners_count":16970636,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audit","cumulative-layout-shift","first-contentful-paint","interactive","interactive-to-interactive","largest-contentful-paint","lighthouse","matomo","measure","monitor","performance","report","speed-index","total-blocking-time","web-vitals"],"created_at":"2024-07-31T19:00:41.277Z","updated_at":"2024-10-31T03:31:14.224Z","avatar_url":"https://github.com/DevDavido.png","language":"PHP","funding_links":["https://buymeacoffee.com/devdavido","https://www.buymeacoffee.com/devdavido"],"categories":["PHP"],"sub_categories":[],"readme":"# Performance Audit Plugin for Matomo\n\n[![Stable Version](https://img.shields.io/github/v/release/DevDavido/performance-audit-plugin)](https://github.com/DevDavido/performance-audit-plugin/releases)\n[![GPL Licensed](https://img.shields.io/github/license/DevDavido/performance-audit-plugin?color=yellow)](LICENSE.md)\n[![Tests Badge](https://img.shields.io/github/actions/workflow/status/DevDavido/performance-audit-plugin/tests.yml)](https://github.com/DevDavido/performance-audit-plugin/actions/workflows/tests.yml)\n\n## Description\nDaily performance audits of all your sites in Matomo for the following metrics based on Google Lighthouse:\n- First Contentful Paint\n- Speed Index\n- Largest Contentful Paint\n- Time To Interactive\n- Total Blocking Time\n- Cumulative Layout Shift\n- Overall Score\n\nContinuously monitor those Web Vital metrics over time, allowing detection of underlying problems before they have an adverse effect for users or simply track changes made to the web application, allowing you to establish a baseline for comparison too.\n\n**Note:** Requires minimum NPM v10.x (part of Node.js 20.x LTS) to be installed on your server, otherwise plugin cannot be activated.\n\n## Support me\nIf you installed this plugin and it was useful for you or your business, please don't hesitate to make a donation, I would highly appreciate it. Thank you!\n\n\u003ca href=\"https://www.buymeacoffee.com/devdavido\" target=\"_blank\"\u003e\u003cimg src=\"https://github.com/DevDavido/performance-audit-plugin/assets/997605/0c4e6a4c-9852-4410-a153-fa379fa7aa17\" width=\"180\" alt=\"Buy me a coffee\"\u003e\u003c/a\u003e\n\n## Installation\nPreferably you install [this plugin](https://plugins.matomo.org/PerformanceAudit) automatically by:\n1. Login to Matomo as Super User\n2. Navigate in your Matomo Installation to `Administration` › `Marketplace` (categorized under `Platform`)\n3. Search for `Performance Audit`\n4. Click on `Install` and wait up to 5 minutes for the installation to finish\n\nYou can also install this plugin manually by:\n1. [downloading the latest plugin zip file](https://github.com/DevDavido/performance-audit-plugin/releases/latest)\n2. Login to Matomo as Super User\n3. Navigate in your Matomo Installation to `Administration` › `Marketplace` (categorized under `Platform`)\n4. Click on `upload a Plugin` and upload the zip file from step 1\n5. Activate this plugin `PerformanceAudit` and wait up to 5 minutes for the process to finish\n\nNote: If plugin upload is disabled, enable it in your `config/config.ini.php` like that:\n```ini\n[General]\nenable_plugin_upload = 1\n```\nIf any errors occur during activation, please follow the instruction or information of the error message.\n\n## Minimum requirements\n- Matomo 5.0\n- PHP 7.2.5\n- NPM v10.x (part of [Node.js](https://nodejs.org/en/download/) 20.x LTS) to be installed on your server, otherwise plugin cannot be activated.\n- If you use a UNIX based OS [these dependencies are required](https://github.com/puppeteer/puppeteer/blob/main/docs/troubleshooting.md#chrome-doesnt-launch-on-linux)\n\n## Impact on server\nPlease keep in mind that Performance Audit uses Lighthouse internally in order to perform performance audits in the background for every Matomo tracked URL within the last 1 month.\nIf the Matomo installation has more than 10,000 tracked unique URLs within the last 1 month, it's suggested to either reduce the number of performed audit iterations in the website settings,\ngroup URLs in website settings or increase the server resources. For Matomo installations with over 100,000 tracked unique URLs within the last 1 month,\nthis plugin architecture is rather unsuitable and therefor not recommended.\n\n## Screenshots\n### Dashboard\n![Dashboard](/screenshots/Dashboard.png?raw=true)\n\n### Overall Scores\n![Overall Scores](/screenshots/OverallScores.png?raw=true)\n\n### First Contentful Paint\n![First Contentful Paint](/screenshots/FirstContentfulPaint.png?raw=true)\n\nFor more screenshots, check out the [screenshot overview](/screenshots/OVERVIEW.md).\n\n## Testing\nRun the integration and unit tests with:\n\n```shell\n./console tests:run PerformanceAudit\n```\n## Changelog\nPlease see the [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.\n\n## Contact\nIf you have any questions or inquiries, you can contact `github{at}diskoboss{døt}de`.\n\n## Security\nIf you discover any security related issues, please contact `github{at}diskoboss{døt}de` instead of using the issue tracker.\n\nPlease note that the performance audits will be performed with Chromium which renders Matomo-tracked web pages on your server without the sandbox mode of Chromium. You can find more information about this possible issue on the [lighthouse-cli repository](https://github.com/GoogleChrome/lighthouse-ci/tree/master/docs/recipes/docker-client#--no-sandbox-issues-explained).\n\n## License\nLicensed under the [GPLv3 License](LICENSE.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDevDavido%2Fperformance-audit-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FDevDavido%2Fperformance-audit-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDevDavido%2Fperformance-audit-plugin/lists"}