From 6152cfaedc3fa0e66e7ae86464f48c0519ff5666 Mon Sep 17 00:00:00 2001
From: ildyria <ildyria@users.noreply.github.com>
Date: Tue, 12 Nov 2024 09:16:48 +0000
Subject: [PATCH] =?UTF-8?q?Deploying=20to=20gh-pages=20from=20@=20LycheeOr?=
 =?UTF-8?q?g/LycheeOrg.github.io@957de0fd2935e7f0f6ede1bbc37986e7f1bf753e?=
 =?UTF-8?q?=20=F0=9F=9A=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/external_tracking.html | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/docs/external_tracking.html b/docs/external_tracking.html
index 8a8e425e..b453b4b4 100644
--- a/docs/external_tracking.html
+++ b/docs/external_tracking.html
@@ -108,6 +108,11 @@ <h1>External tracking with Matomo,<br>Google Analytics & Co</h1>
 <li><a href="#add-custom-javascript_1">Add custom JavaScript</a></li>
 </ul>
 </li>
+<li><a href="#set-up-for-umami-analytics">Set up for Umami Analytics</a><ul>
+<li><a href="#allow-loading-tracking-script_2">Allow loading tracking script</a></li>
+<li><a href="#add-custom-javascript_2">Add custom JavaScript</a></li>
+</ul>
+</li>
 <li><a href="#other-tools-custom-tracking">Other tools / custom tracking</a><ul>
 <li><a href="#configuration-adjustments">Configuration adjustments</a></li>
 <li><a href="#track-view-changes">Track view changes</a></li>
@@ -187,6 +192,31 @@ <h3 id="add-custom-javascript_1"><a class="toclink" href="#add-custom-javascript
   trackPageView()
 });
 </code></pre>
+<h2 id="set-up-for-umami-analytics"><a class="toclink" href="#set-up-for-umami-analytics">Set up for Umami Analytics</a></h2>
+<blockquote>
+<p>⚠️ Make sure to use your actual values for DOMAIN SCRIPT URL and <WEBSITE_ID></p>
+</blockquote>
+<h3 id="allow-loading-tracking-script_2"><a class="toclink" href="#allow-loading-tracking-script_2">Allow loading tracking script</a></h3>
+<p>Set the following env vars:</p>
+<pre><code class="language-ini">SECURITY_HEADER_SCRIPT_SRC_ALLOW=https://umami.example.com/script.js
+SECURITY_HEADER_CSP_CONNECT_SRC=https://umami.example.com/script.js
+</code></pre>
+<h3 id="add-custom-javascript_2"><a class="toclink" href="#add-custom-javascript_2">Add custom JavaScript</a></h3>
+<p>Add the following to Settings &gt; Custom JS</p>
+<pre><code class="language-javascript">(function() {
+    var d = document, s = d.createElement('script'), g = d.getElementsByTagName('script')[0];
+    s.defer = true;
+    s.src = 'https://umami.example.com/script.js';
+    s.setAttribute('data-website-id', '&lt;WEBSITE_ID&gt;');
+    g.parentNode.insertBefore(s, g);
+})();
+
+navigation.addEventListener(&quot;navigate&quot;, function (e) {
+    if (window.umami &amp;&amp; typeof umami.trackView === 'function') {
+        umami.trackView(document.title, window.location.pathname);
+    }
+});
+</code></pre>
 <h2 id="other-tools-custom-tracking"><a class="toclink" href="#other-tools-custom-tracking">Other tools / custom tracking</a></h2>
 <h3 id="configuration-adjustments"><a class="toclink" href="#configuration-adjustments">Configuration adjustments</a></h3>
 <p>To make the frontend load the tracking script you need to change two environment variables:</p>