From 084c9c5a47542df9c487dde91897b35cdf921f58 Mon Sep 17 00:00:00 2001
From: Sunil Mohan Adapa <sunil@medhas.org>
Date: Fri, 7 Nov 2025 20:52:53 -0800
Subject: [PATCH] matrixsynapse: Explain federation and link to testing tool

- Create a separate section for federation as it is so important.

Tests:

- Federation description and TLS warning are shown in a separate section on the
app's post-setup page.

- Clicking on the testing tool link takes the user to the testing tool and the
current server's domain is automatically tested.

Signed-off-by: Sunil Mohan Adapa <sunil@medhas.org>
Reviewed-by: James Valleroy <jvalleroy@mailbox.org>
---
 .../matrixsynapse/templates/matrix-synapse.html     | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/plinth/modules/matrixsynapse/templates/matrix-synapse.html b/plinth/modules/matrixsynapse/templates/matrix-synapse.html
index 4458e4f2d..0fd4f054a 100644
--- a/plinth/modules/matrixsynapse/templates/matrix-synapse.html
+++ b/plinth/modules/matrixsynapse/templates/matrix-synapse.html
@@ -75,6 +75,19 @@
     </div>
   {% endif %}
 
+  <h3>{% trans "Federation" %}</h3>
+
+  <p>
+    {% blocktrans trimmed with tester_url="https://federationtester.matrix.org/" %}
+      Matrix Synapse is configured to work with other Matrix servers on the
+      internet. This allows {{ box_name }} users to participate in rooms that
+      are hosted elsewhere and Matrix users on other servers to participate
+      in rooms hosted here. If you face problems with federation, try the
+      <a href="{{ tester_url }}#{{ domain_name }}">
+      federation tester tool</a>.
+    {% endblocktrans %}
+  </p>
+
   {% if certificate_status != "valid" %}
     <div class="alert alert-warning d-flex align-items-center" role="alert">
       <div class="me-2">