config
3 months ago
core
6 days ago
js
3 months ago
lang
2 weeks ago
libs
1 month ago
node_modules
4 months ago
plugins
6 days ago
vendor
6 days ago
.htaccess
6 years ago
AGENTS.md
2 weeks ago
DIObject.php
2 years ago
LEGALNOTICE
6 months ago
LICENSE
2 years ago
LegacyAutoloader.php
2 years ago
PRIVACY.md
5 years ago
README.md
6 months ago
SECURITY.md
2 years ago
bootstrap.php
1 month ago
console
6 years ago
favicon.ico
2 years ago
index.php
2 years ago
matomo.js
3 months ago
matomo.php
2 years ago
offline-service-worker.js
5 years ago
piwik.js
3 months ago
piwik.php
6 months ago
robots.txt
5 years ago
README.md
134 lines
| 1 | # Matomo (formerly Piwik) - matomo.org |
| 2 | |
| 3 | [](https://matomo.org/download/](https://matomo.org/download/](https://matomo.org/download/) |
| 4 | [](https://builds.matomo.org/](https://builds.matomo.org/](https://builds.matomo.org/) |
| 5 | [](https://matomo.org/free-software/](https://matomo.org/free-software/](https://matomo.org/free-software/) |
| 6 | |
| 7 | ## Code Status |
| 8 | |
| 9 | [](https://github.com/matomo-org/matomo/actions/workflows/matomo-tests.yml](https://github.com/matomo-org/matomo/actions/workflows/matomo-tests.yml](https://github.com/matomo-org/matomo/actions/workflows/matomo-tests.yml) |
| 10 | [](http://isitmaintained.com/project/matomo-org/matomo "Percentage of issues still open"](http://isitmaintained.com/project/matomo-org/matomo "Percentage of issues still open"](http://isitmaintained.com/project/matomo-org/matomo "Percentage of issues still open") |
| 11 | |
| 12 | ## Description |
| 13 | |
| 14 | Matomo is the leading Free/Libre open analytics platform. |
| 15 | |
| 16 | Matomo is a full-featured PHP MySQL software program that you download and install on your own webserver. |
| 17 | At the end of the five-minute installation process, you will be given a JavaScript code. |
| 18 | Simply copy and paste this tag on websites you wish to track and access your analytics reports in real-time. |
| 19 | |
| 20 | Matomo aims to be a Free software alternative to Google Analytics and is already used on more than 1,400,000 websites. Privacy is built-in! |
| 21 | |
| 22 | ## Mission Statement |
| 23 | |
| 24 | > « To create, as a community, the leading international open source digital analytics platform, that gives every user full control of their data, to empower better decisions. » |
| 25 | |
| 26 | Our purpose is to: |
| 27 | |
| 28 | > « Empower People Ethically » |
| 29 | |
| 30 | ## License |
| 31 | |
| 32 | Matomo is released under the GPL v3 (or later) license, see [](LICENSELICENSE](LICENSE](LICENSE). |
| 33 | |
| 34 | ## Requirements |
| 35 | |
| 36 | * PHP 7.2.5 or greater |
| 37 | * MySQL version 5.5 or greater, or MariaDB |
| 38 | * PHP extension pdo and pdo_mysql, or the MySQLi extension |
| 39 | * Matomo is OS / server independent |
| 40 | |
| 41 | See https://matomo.org/docs/requirements/. |
| 42 | |
| 43 | ## Install Matomo |
| 44 | |
| 45 | * [](https://matomo.org/download/Download Matomo](https://matomo.org/download/](https://matomo.org/download/) |
| 46 | * Upload Matomo to your webserver |
| 47 | * Point your browser to the directory |
| 48 | * Follow the steps |
| 49 | * Add the given JavaScript code to your pages |
| 50 | * (You may also generate fake data to experiment, by enabling the plugin VisitorGenerator) |
| 51 | |
| 52 | See https://matomo.org/docs/installation/. |
| 53 | |
| 54 | ## Develop for Matomo |
| 55 | |
| 56 | When using Matomo for development you need to [](https://matomo.org/faq/how-to-install/faq_18271/install Matomo from the Git repository](https://matomo.org/faq/how-to-install/faq_18271/](https://matomo.org/faq/how-to-install/faq_18271/). |
| 57 | |
| 58 | This will also give you access to a DDEV environment you can use. More details can be found in the [](.ddev/README.mdDDEV README](.ddev/README.md](.ddev/README.md). |
| 59 | |
| 60 | ## Free trial |
| 61 | |
| 62 | If you do not have a server or don't want to host yourself, you can use our Matomo Cloud service (21 day free trial): https://matomo.org/start-free-analytics-trial/ |
| 63 | |
| 64 | ## Online Demo |
| 65 | |
| 66 | Check out the online demo for Matomo at [](https://demo.matomo.cloud/demo.matomo.cloud](https://demo.matomo.cloud/](https://demo.matomo.cloud/). |
| 67 | |
| 68 | ## Changelog |
| 69 | |
| 70 | For the list of all tickets closed in the current and past releases, see [](https://matomo.org/changelog/matomo.org/changelog/](https://matomo.org/changelog/](https://matomo.org/changelog/). For the list of technical changes in the Matomo platform, see [](https://developer.matomo.org/changelogdeveloper.matomo.org/changelog](https://developer.matomo.org/changelog](https://developer.matomo.org/changelog). |
| 71 | |
| 72 | ## Get involved! |
| 73 | |
| 74 | We believe in liberating Web Analytics, providing a free platform for simple and advanced analytics. Matomo was built by dozens of people like you, |
| 75 | and we need your help to make Matomo better… Why not participate in a useful project today? [](https://matomo.org/get-involvedLearn how you can contribute to Matomo](https://matomo.org/get-involved](https://matomo.org/get-involved). |
| 76 | |
| 77 | ## Careers at Matomo |
| 78 | |
| 79 | We're hiring! Learn more on our [](https://matomo.org/jobs/Careers page](https://matomo.org/jobs/](https://matomo.org/jobs/). |
| 80 | |
| 81 | ## Translations |
| 82 | |
| 83 | Our translations are managed on [](https://hosted.weblate.org/engage/matomo/Weblate](https://hosted.weblate.org/engage/matomo/](https://hosted.weblate.org/engage/matomo/). |
| 84 | |
| 85 | [](https://hosted.weblate.org/engage/matomo/](https://hosted.weblate.org/engage/matomo/](https://hosted.weblate.org/engage/matomo/) |
| 86 | |
| 87 | ## Quality Assurance |
| 88 | |
| 89 | The Matomo project uses an ever-expanding comprehensive set of thousands of unit tests and hundreds of automated integration tests, system tests, JavaScript tests, and screenshot UI tests, running on a continuous integration server as part of its software quality assurance. [](https://developer.matomo.org/guides/testsLearn more](https://developer.matomo.org/guides/tests](https://developer.matomo.org/guides/tests). |
| 90 | |
| 91 | We use [](https://www.browserstack.com/BrowserStack.com](https://www.browserstack.com/](https://www.browserstack.com/) testing tool to help check the Matomo user interface is compatible with many browsers. |
| 92 | |
| 93 | ## Security |
| 94 | |
| 95 | Security is a top priority at Matomo. As potential issues are discovered, we validate, patch and release fixes as quickly as we can. We have a security bug bounty program in place that rewards researchers for finding security issues and disclosing them to us. |
| 96 | |
| 97 | [](https://matomo.org/security/Learn more](https://matomo.org/security/](https://matomo.org/security/) or check out our [](https://hackerone.com/matomoHackerOne program](https://hackerone.com/matomo](https://hackerone.com/matomo). |
| 98 | |
| 99 | ## Support for Matomo |
| 100 | |
| 101 | For **Free support**, post a message in our community forums: [](https://forum.matomo.org/forum.matomo.org](https://forum.matomo.org/](https://forum.matomo.org/) |
| 102 | |
| 103 | For **Professional paid support**, purchase a Matomo On-Premise Support Plan: [](https://matomo.org/support-plans/matomo.org/support-plans](https://matomo.org/support-plans/](https://matomo.org/support-plans/) |
| 104 | |
| 105 | ## Contact |
| 106 | |
| 107 | Website: [](https://matomo.orgmatomo.org](https://matomo.org](https://matomo.org) |
| 108 | |
| 109 | About us: [](https://matomo.org/team/matomo.org/team/](https://matomo.org/team/](https://matomo.org/team/) |
| 110 | |
| 111 | Contact us: [](https://matomo.org/contact/matomo.org/contact/](https://matomo.org/contact/](https://matomo.org/contact/) |
| 112 | |
| 113 | ## More information |
| 114 | |
| 115 | What makes Matomo unique from the competition: |
| 116 | |
| 117 | * You own your web analytics data: since Matomo is installed on your server, the data is stored in your own database and you can get all the statistics using the powerful Matomo Analytics API. |
| 118 | |
| 119 | * Matomo is a Free Software which can easily be configured to respect your visitors' privacy. |
| 120 | |
| 121 | * Modern, easy to use User Interface: you can fully customize your dashboard, drag and drop widgets and more. |
| 122 | |
| 123 | * Matomo features are built inside plugins: you can add new features and remove the ones you don’t need. |
| 124 | You can build your own web analytics plugins or hire a consultant to have your custom feature built-in Matomo. |
| 125 | |
| 126 | * A vibrant international Open community of more than 200,000 active users (tracking even more websites!) |
| 127 | |
| 128 | * Advanced Web Analytics capabilities such as E-commerce Tracking, Goal tracking, Campaign tracking, |
| 129 | Custom Variables, Email Reports, Custom Segment Editor, Geo Location, Real-time visits and maps, [](https://matomo.org/feature-overview/and a lot more!](https://matomo.org/feature-overview/](https://matomo.org/feature-overview/) |
| 130 | |
| 131 | Documentation and more info on https://matomo.org. |
| 132 | |
| 133 | We are together creating the best open analytics platform in the world! |
| 134 |