Add replaces configuration for editor context menus (#4714)

CHANGELOG.md

@@ -11,6 +11,7 @@
 * Context menus can be supplied a `menuId` so that interested components can listen to their opening/closing.
 * Add batch operations to pages.
 * Add shortcuts to pages manager.
+* Add `replaces` (boolean, `false` by default) option to the context operation definition (registered via `apos.doc.addContextOperation()`) to allow the operation to require a replace confirmation before being executed. The user confirmation results in the Editor modal being closed and the operation being executed. The operation is not executed if the user cancels the confirmation.
 
 ### Changes
 

modules/@apostrophecms/doc-type/ui/apos/logic/AposDocContextMenu.js

@@ -429,6 +429,18 @@ export default {
 
     },
     async customAction(doc, operation) {
+      if (operation.replaces) {
+        const confirm = await apos.confirm({
+          heading: 'apostrophe:replaceHeadingPrompt',
+          description: this.$t('apostrophe:replaceDescPrompt'),
+          affirmativeLabel: 'apostrophe:replace',
+          icon: false
+        });
+        if (!confirm) {
+          return;
+        }
+        this.$emit('close', doc);
+      }
       const props = {
         moduleName: operation.moduleName || this.moduleName,
         // For backwards compatibility

modules/@apostrophecms/i18n/i18n/en.json

@@ -405,6 +405,8 @@
   "removeLink": "Remove Link",
   "removeRichTextAnchor": "Remove Rich Text Anchor",
   "replace": "Replace",
+  "replaceHeadingPrompt": "Replace Document?",
+  "replaceDescPrompt": "This operation will replace the contents of this document. Are you sure?",
   "resolveErrorsBeforeSaving": "Resolve errors before saving.",
   "resolveErrorsFirst": "Resolve errors first.",
   "restore": "Restore",