maxkratz/community-tutorials
1
0
Fork 0
mirror of https://github.com/maxkratz/community-tutorials.git synced 2024-09-08 00:02:56 +00:00
Code Issues Projects Releases Packages Wiki Activity

Update 01-en.md

Browse source
This commit is contained in:
Christoph 2023-11-06 16:37:16 +01:00 committed by GitHub
parent f863852ad3
commit 286e7ae781
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 36 additions and 47 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

83
community-tutorials/how-to-install-matomo/01-en.md
View file

@ -8,18 +8,7 @@ author_name: Konstantin Protzen
author_url: https://github.com/cuzimbisonratte
author_image: https://github.com/cuzimbisonratte.png
author_bio:
tags:
[
webhosting,
tracking,
analytics,
matomo,
privacy,
gdpr,
dsgvo,
website,
homepage,
]
tags: [webhosting, tracking, analytics, matomo, privacy, gdpr, dsgvo, website, homepage,]
netcup_product_url: https://www.netcup.de/bestellen/produkt.php?produkt=3319
language: en
available_languages: [en, de]
@ -32,46 +21,46 @@ Matomo allows you to gain valuable insights into your website's performance and
In this guide, we will walk you through the step-by-step process of installing Matomo on your server, from creating a subdomain to configuring the necessary settings.
By the end of this tutorial, you'll have Matomo up and running, providing you with essential data to make informed decisions about your website.
# Step 1 - Setup of a new Subdomain
# Step 1 - Setup of a new subdomain
If you dont want to use a subdomain, you can skip this step.
If you don't want to use a subdomain, you can skip this step.
1. Log in to the CCP (CustomerControlPanel) under https://www.customercontrolpanel.de.
2. On the Left side, click on "Products".
1. Log in to the CCP (Customer Control Panel) under https://www.customercontrolpanel.de.
2. On the left side, click on "Products".
3. If you have multiple products, select the one you want to use by clicking on the magnifying glass symbol next to it.
4. Because you will need this value later, copy the value of the "MySQL-Server:" field (e.g. `mysqlexyz.netcup.net`).
5. In the new window, on the bottom, click on "Plesk Overview".
6. In the new browser tab, click on "Add Subdomain".
7. In the Input field, enter your subdomain name (e.g. `matomo`).
8. In the Dropdown menu, select the domain you want to use.
7. In the input field, enter your subdomain name (e.g. `matomo`).
8. In the dropdown menu, select the domain you want to use.
9. Click on "OK".
# Step 2 - Getting a SSL Certificate
# Step 2 - Getting an SSL Certificate
1. Under "Security" click on "SSL/TLS Certificates".
2. Click on the "Install"-Button.
1. Under "Security", click on "SSL/TLS Certificates".
2. Click on the "Install" button.
3. Enter your email address.
4. Check the last checkbox.
5. Click on "Get it free".
6. On the left side, toggle the Switch with "Redirect from http to https" to "On".
7. On the left side, toggle the Switch with "OCSP Stapling" to "On".
6. On the left side, toggle the "Redirect from http to https" switch to "On".
7. On the left side, toggle the "OCSP Stapling" switch to "On".
8. On the top, click on your subdomain (e.g. `matomo.example.com`).
# Step 3 - Creating the Database
# Step 3 - Creating the database
1. Click on "Databases" on the left side.
2. Click on "Add Database".
3. In the first input field, enter `matomo`
3. In the first input field, enter `matomo`.
4. In the "Related site" dropdown menu, select the subdomain you created in step 1.
5. On the bottom, in the input field for "Database user name" enter `matomo`.
6. Click on the "Generate" button next to the input field for "Database user password" to generate a secure password.
7. Click on the "Show" button next to the input field for "Database user password" to show the password and then copy it.
5. On the bottom, in the "Database user name" input field, enter `matomo`.
6. Click on the "Generate" button next to the "Database user password" input field to generate a secure password.
7. Click on the "Show" button next to the "Database user password" input field to show the password, and then copy it.
8. Click on "OK".
# Step 4 - Downloading Matomo
1. In the Plesk-Sidemenu on the left side, click on "Files".
2. Click on the folder named after your subdomain (e.g. `matomo.example.com`) and then on `httpdocs`.
1. In the Plesk side menu on the left side, click on "Files".
2. Click on the folder named after your subdomain (e.g. `matomo.example.com`), and then on `httpdocs`.
3. Click on `+` and then on `Import file via URL`.
4. Copy the following URL and paste it into the input field: `https://builds.matomo.org/matomo-latest.zip`.
5. Click on `Import`.
@ -79,15 +68,15 @@ If you dont want to use a subdomain, you can skip this step.
# Step 5 - Extracting Matomo
1. Click on `matomo-latest.zip`
1. Click on `matomo-latest.zip`.
2. Click on `OK`.
3. Select all checkboxes that are not for the `matomo`-Folder.
3. Select all checkboxes that are not for the `matomo` folder.
4. Click on `Remove` in the menu on the top.
5. Open the `matomo`-Folder by clicking on it.
6. Click the topmost checkbox to select all files and folders. (In the table header, next to the `Name`-Column)
5. Open the `matomo` folder by clicking on it.
6. Click the topmost checkbox to select all files and folders (in the table header, next to the `Name` column).
7. Click on `Move` in the menu on the top.
8. Double click on the Folder named after your subdomain (e.g. `matomo.example.com`).
9. Click on the `httpdocs`-Folder.
8. Double-click on the folder named after your subdomain (e.g. `matomo.example.com`).
9. Click on the `httpdocs` folder.
10. Click on `OK`.
# Step 6 - Installing Matomo
@ -98,18 +87,18 @@ If you dont want to use a subdomain, you can skip this step.
4. Click on `Next`.
5. Enter your database credentials (database name, database user name, database user password) from step 1.4 and 2 (Warning: The username and database name have a prefix which is your user-id followed by an underscore, e.g. `k123456_matomo`).
6. You can leave the "Table Prefix" setting as it is.
7. Change the "Adapter" setting to `MYSQLI` (This is because the current version has shown some issues with the `PDO`-Adapter whilst testing).
7. Change the "Adapter" setting to `MYSQLI` (This is because the current version has shown some issues with the `PDO` adapter during testing).
8. Click on `Next`.
9. Click on `Next`.
10. Enter credentials for a new superuser account - This will be the account you will use to log in to Matomo as an administrator.
10. Enter credentials for a new superuser account. This will be the account you will use to log in to Matomo as an administrator.
11. Click on `Next`.
# Step 7 - Finishing the Installation
# Step 7 - Finishing the installation
1. Enter a Identifier for your website (e.g. `My Homepage`).
1. Enter an identifier for your website (e.g. `My Homepage`).
2. Enter the domain of the website you want to track (e.g. `example.com`).
3. Set the timezone to your timezone.
4. If your website is a Ecommerce-Website, toggle the respective switch to `On`.
4. If your website is an ecommerce website, toggle the respective switch to `On`.
5. Click on `Next`.
6. Now you can copy the tracking code and paste it into your website.
7. Click on `Next`.
@ -117,13 +106,13 @@ If you dont want to use a subdomain, you can skip this step.
# Conclusion
Now you have successfully installed Matomo on your server.
You have successfully installed Matomo on your server.
From now on it will be available under your subdomain (e.g. `https://matomo.example.com`).
From now on Matomo will be available under your subdomain (e.g. `https://matomo.example.com`).
Thank you for using this tutorial!
# Licence
# License
Copyright (c) 2023 Konstantin Protzen
@ -137,10 +126,10 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
By making a contribution to this project, I certify that:
1. The contribution was created in whole or in part by me and I have the right to submit it under the licence indicated in the file; or
1. The contribution was created in whole or in part by me and I have the right to submit it under the license indicated in the file; or
2. The contribution is based upon previous work that, to the best of my knowledge, is covered under an appropriate licence and I have the right under that licence to submit that work with modifications, whether created in whole or in part by me, under the same license (unless I am permitted to submit under a different licence), as indicated in the file; or
2. The contribution is based upon previous work that, to the best of my knowledge, is covered under an appropriate license and I have the right under that license to submit that work with modifications, whether created in whole or in part by me, under the same license (unless I am permitted to submit under a different license), as indicated in the file; or
3. The contribution was provided directly to me by some other person who certified (a), (b) or (c) and I have not modified it.
4. I understand and agree that this project and the contribution are public and that a record of the contribution (including all personal information I submit with it, including my sign-off) is maintained indefinitely and may be redistributed consistent with this project or the licence(s) involved.
4. I understand and agree that this project and the contribution are public and that a record of the contribution (including all personal information I submit with it, including my sign-off) is maintained indefinitely and may be redistributed consistent with this project or the license(s) involved.