From 482e2f736e99516a0ced8d5c0299aa76f5fa5aeb Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Tue, 10 Feb 2026 10:03:13 +0100
Subject: [PATCH] Add confirmation dialog before submitting a user note (#1281)

A native HTML dialog with checkboxes requires users to confirm their
note is not a bug report, support question, code collaboration, or
in a language other than English before submission.
---
 public/manual/add-note.php | 62 +++++++++++++++++++++++++++++++++++++-
 1 file changed, 61 insertions(+), 1 deletion(-)

diff --git a/public/manual/add-note.php b/public/manual/add-note.php
index 508bdaa01e..d440894390 100644
--- a/public/manual/add-note.php
+++ b/public/manual/add-note.php
@@ -344,7 +344,7 @@
 
 // Everything is in place, so we can display the form
 else {?>
-<form method="post" action="/manual/add-note.php">
+<form method="post" action="/manual/add-note.php" id="addnote-form">
  <p>
   <input type="hidden" name="sect" value="<?php echo clean($_POST['sect']); ?>">
   <input type="hidden" name="redirect" value="<?php echo clean($_POST['redirect']); ?>">
@@ -390,6 +390,66 @@
 <?php
 }
 
+?>
+<dialog id="note-confirm-dialog">
+  <form method="dialog">
+    <h3>Before submitting your note</h3>
+    <p>Please confirm that your note:</p>
+    <ul>
+      <li><label><input type="checkbox" required> Is <strong>not</strong> a bug report or feature request</label></li>
+      <li><label><input type="checkbox" required> Is <strong>not</strong> a support question</label></li>
+      <li><label><input type="checkbox" required> Is <strong>not</strong> a code collaboration or link to an external site</label></li>
+      <li><label><input type="checkbox" required> Is written in <strong>English</strong></label></li>
+    </ul>
+    <p>
+      <button type="submit" value="confirm">I confirm, submit my note</button>
+      <button type="submit" value="cancel">Cancel</button>
+    </p>
+  </form>
+</dialog>
+<script>
+(function() {
+    var form = document.getElementById('addnote-form');
+    if (!form) return;
+
+    form.addEventListener('submit', function(e) {
+        var action = e.submitter ? e.submitter.value : '';
+        if (action !== 'Add Note') return;
+
+        var dialog = document.getElementById('note-confirm-dialog');
+        if (!dialog || form.dataset.confirmed === '1') {
+            form.dataset.confirmed = '';
+            return;
+        }
+
+        e.preventDefault();
+        dialog.showModal();
+
+        dialog.querySelector('form').onsubmit = function(de) {
+            var checkboxes = dialog.querySelectorAll('input[type="checkbox"]');
+            for (var i = 0; i < checkboxes.length; i++) {
+                if (!checkboxes[i].checked) {
+                    de.preventDefault();
+                    return;
+                }
+            }
+        };
+
+        dialog.addEventListener('close', function handler() {
+            dialog.removeEventListener('close', handler);
+            if (dialog.returnValue === 'confirm') {
+                form.dataset.confirmed = '1';
+                e.submitter.click();
+            }
+            var checkboxes = dialog.querySelectorAll('input[type="checkbox"]');
+            for (var i = 0; i < checkboxes.length; i++) {
+                checkboxes[i].checked = false;
+            }
+        });
+    });
+})();
+</script>
+<?php
 // Print out common footer
 site_footer();
 ?>