config
1 year ago
core
1 year ago
js
1 year ago
lang
1 year ago
libs
1 year ago
node_modules
2 years ago
plugins
1 year ago
vendor
1 year ago
.htaccess
6 years ago
DIObject.php
2 years ago
LEGALNOTICE
1 year ago
LICENSE
2 years ago
LegacyAutoloader.php
2 years ago
PRIVACY.md
5 years ago
README.md
3 years ago
SECURITY.md
2 years ago
bootstrap.php
1 year ago
console
6 years ago
favicon.ico
2 years ago
index.php
2 years ago
matomo.js
1 year ago
matomo.php
2 years ago
offline-service-worker.js
5 years ago
piwik.js
1 year ago
piwik.php
2 years ago
robots.txt
5 years ago
README.md
126 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. » |
| 25 | |
| 26 | Or in short: |
| 27 | > « Liberate Web Analytics » |
| 28 | |
| 29 | ## License |
| 30 | |
| 31 | Matomo is released under the GPL v3 (or later) license, see [](LICENSELICENSE](LICENSE](LICENSE). |
| 32 | |
| 33 | ## Requirements |
| 34 | |
| 35 | * PHP 7.2.5 or greater |
| 36 | * MySQL version 5.5 or greater, or MariaDB |
| 37 | * PHP extension pdo and pdo_mysql, or the MySQLi extension |
| 38 | * Matomo is OS / server independent |
| 39 | |
| 40 | See https://matomo.org/docs/requirements/. |
| 41 | |
| 42 | ## Install Matomo |
| 43 | |
| 44 | * [](https://matomo.org/download/Download Matomo](https://matomo.org/download/](https://matomo.org/download/) |
| 45 | * Upload matomo to your webserver |
| 46 | * Point your browser to the directory |
| 47 | * Follow the steps |
| 48 | * Add the given javascript code to your pages |
| 49 | * (You may also generate fake data to experiment, by enabling the plugin VisitorGenerator) |
| 50 | |
| 51 | See https://matomo.org/docs/installation/. |
| 52 | |
| 53 | (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/)). |
| 54 | |
| 55 | ## Free trial |
| 56 | |
| 57 | If you do not have a server or don't want to host yourself you can use our Matomo Cloud partner service (21 day free trial): https://matomo.org/start-free-analytics-trial/ |
| 58 | |
| 59 | ## Online Demo |
| 60 | |
| 61 | Check out the online demo for Matomo at [](https://demo.matomo.cloud/demo.matomo.cloud](https://demo.matomo.cloud/](https://demo.matomo.cloud/). |
| 62 | |
| 63 | ## Changelog |
| 64 | |
| 65 | 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). |
| 66 | |
| 67 | ## Get involved! |
| 68 | |
| 69 | We believe in liberating Web Analytics, providing a free platform for simple and advanced analytics. Matomo was built by dozens of people like you, |
| 70 | 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). |
| 71 | |
| 72 | ## Translations |
| 73 | |
| 74 | Our translations are managed on [](https://hosted.weblate.org/engage/matomo/Weblate](https://hosted.weblate.org/engage/matomo/](https://hosted.weblate.org/engage/matomo/). |
| 75 | |
| 76 | [](https://hosted.weblate.org/engage/matomo/](https://hosted.weblate.org/engage/matomo/](https://hosted.weblate.org/engage/matomo/) |
| 77 | |
| 78 | ## Quality Assurance |
| 79 | |
| 80 | 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). |
| 81 | |
| 82 | 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. |
| 83 | |
| 84 | ## Security |
| 85 | |
| 86 | 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. |
| 87 | |
| 88 | [](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). |
| 89 | |
| 90 | ## Support for Matomo |
| 91 | |
| 92 | 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/) |
| 93 | |
| 94 | For **Professional paid support**, purchase a Matomo On-Premises Support Plan: [](https://matomo.org/support-plans/matomo.org/support-plans](https://matomo.org/support-plans/](https://matomo.org/support-plans/) |
| 95 | |
| 96 | ## Contact |
| 97 | |
| 98 | Website: [](https://matomo.orgmatomo.org](https://matomo.org](https://matomo.org) |
| 99 | |
| 100 | About us: [](https://matomo.org/team/matomo.org/team/](https://matomo.org/team/](https://matomo.org/team/) |
| 101 | |
| 102 | Contact us: [](https://matomo.org/contact/matomo.org/contact/](https://matomo.org/contact/](https://matomo.org/contact/) |
| 103 | |
| 104 | |
| 105 | ## More information |
| 106 | |
| 107 | What makes Matomo unique from the competition: |
| 108 | |
| 109 | * 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. |
| 110 | |
| 111 | * Matomo is a Free Software which can easily be configured to respect your visitors' privacy. |
| 112 | |
| 113 | * Modern, easy to use User Interface: you can fully customize your dashboard, drag and drop widgets and more. |
| 114 | |
| 115 | * Matomo features are built inside plugins: you can add new features and remove the ones you don’t need. |
| 116 | You can build your own web analytics plugins or hire a consultant to have your custom feature built-in Matomo. |
| 117 | |
| 118 | * A vibrant international Open community of more than 200,000 active users (tracking even more websites!) |
| 119 | |
| 120 | * Advanced Web Analytics capabilities such as E-commerce Tracking, Goal tracking, Campaign tracking, |
| 121 | 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/) |
| 122 | |
| 123 | Documentation and more info on https://matomo.org. |
| 124 | |
| 125 | We are together creating the best open analytics platform in the world! |
| 126 |