Merge pull request 'docs(ajax): correct preupdateAck docblock' (#254) from docs/preupdateack-docblock into dev

2026-07-12 23:33:00 +00:00
parent 0562d3effd f62b1ec72e
commit a60f7ac032
1 changed files with 5 additions and 5 deletions
@@ -89,11 +89,11 @@ class AjaxController extends BaseController
 	 *
 	 * Called by the full-screen backup screen after a successful backup so the
 	 * imminent server-side onExtensionBeforeUpdate / onExtensionBeforeUninstall
-	 * backup is skipped — it arms the same 10-minute throttle keys the system
-	 * plugin checks, preventing a duplicate backup when the update / uninstall
-	 * then proceeds. Arms BOTH keys so a single ack covers whichever action the
-	 * full-screen backup was fronting.
-	 * POST: task=ajax.preupdateAck
+	 * backup is skipped once — it sets a ONE-SHOT skip flag (keyed by the
+	 * `action` the backup was fronting) that plg_system_mokosuitebackup
+	 * consumes on the re-fired update/uninstall request, so exactly that one
+	 * action is not double-backed-up while later, distinct actions still are.
+	 * POST: task=ajax.preupdateAck&action=update|uninstall
 	 */
 	public function preupdateAck(): void
 	{