From f3f983dc5b6d0d54eb607947d90aad43209a1197 Mon Sep 17 00:00:00 2001 From: Karl Kemister-Sheppard Date: Thu, 16 Jul 2026 09:13:59 +1000 Subject: [PATCH 1/3] Docs: TINYDOC-3558 - Add Welcome chat actions section to AI Chat page --- modules/ROOT/pages/tinymceai-chat.adoc | 39 ++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) diff --git a/modules/ROOT/pages/tinymceai-chat.adoc b/modules/ROOT/pages/tinymceai-chat.adoc index 133c94430a..0f8997fd1c 100644 --- a/modules/ROOT/pages/tinymceai-chat.adoc +++ b/modules/ROOT/pages/tinymceai-chat.adoc @@ -94,6 +94,45 @@ Reasoning in Chat models turns on the ability to think through problems, draw lo Some models use reasoning automatically, while others may require manual activation. Whether the "Enable reasoning" button image:icons-premium/reasoning.svg[Reasoning icon,24px] below the prompt input needs to be toggled depends on the model and sometimes even how the prompt is worded. For models that support reasoning, use the toggle button to enable it. +[[welcome-chat-actions]] +== Welcome chat actions + +Welcome chat actions customize the empty state of the Chat sidebar, replacing a blank prompt with a welcome message and a set of suggested starting points. When a user opens Chat before sending any messages, the sidebar can present an introductory message alongside clickable buttons that run common tasks, helping users understand what the AI can do and begin a conversation with a single click. + +The welcome actions are shown only before the first request is sent in a conversation. They are hidden once the first message is sent and shown again when a new conversation is started. + +Each suggested action is a button that runs an editor command when selected. Commands can be Quick Actions, Chat commands, the core `+ToggleSidebar+` command, or any other registered editor command. Descriptive text items and action buttons can be interleaved to group related actions under short headings. + +[[welcome-chat-actions-configuration]] +=== Configuration + +Welcome chat actions are configured using two options: + +* `tinymceai_chat_welcome_message`: Sets the welcome message displayed at the top of the Chat sidebar empty state. +* `tinymceai_chat_welcome_actions`: Defines the descriptive text and suggested action buttons shown below the welcome message. + +Full schemas, supported item types, and command examples are documented under xref:tinymceai.adoc#tinymceai_chat_welcome_message[`+tinymceai_chat_welcome_message+`] and xref:tinymceai.adoc#tinymceai_chat_welcome_actions[`+tinymceai_chat_welcome_actions+`]. + +[source,js] +---- +tinymce.init({ + selector: '#editor', + plugins: 'tinymceai', + toolbar: 'tinymceai-chat tinymceai-quickactions tinymceai-review', + tinymceai_chat_welcome_message: '

Welcome! How can I help you today?

', + tinymceai_chat_welcome_actions: [ + { text: 'Here are some actions to get started:' }, + { title: 'Summarize the document', command: 'TinyMCEAIQuickActionsSummarize' }, + { title: 'Continue writing', command: 'TinyMCEAIQuickActionContinueWriting' }, + { title: 'Review my document', command: 'ToggleSidebar', value: 'tinymceai-review' } + ], + // Required for authentication + tinymceai_token_provider: () => { + return fetch('/api/token').then(r => r.text()).then(token => ({ token })); + } +}); +---- + [[adding-context-to-conversations]] == Adding context to conversations From 4eea7dd7807beab33569a16710266fa6f00345be Mon Sep 17 00:00:00 2001 From: Karl Kemister-Sheppard Date: Thu, 16 Jul 2026 09:22:20 +1000 Subject: [PATCH 2/3] TINYDOC-3558: remove backticks from links for more visibility. --- modules/ROOT/pages/tinymceai-chat.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/tinymceai-chat.adoc b/modules/ROOT/pages/tinymceai-chat.adoc index 0f8997fd1c..ae29c23926 100644 --- a/modules/ROOT/pages/tinymceai-chat.adoc +++ b/modules/ROOT/pages/tinymceai-chat.adoc @@ -111,7 +111,7 @@ Welcome chat actions are configured using two options: * `tinymceai_chat_welcome_message`: Sets the welcome message displayed at the top of the Chat sidebar empty state. * `tinymceai_chat_welcome_actions`: Defines the descriptive text and suggested action buttons shown below the welcome message. -Full schemas, supported item types, and command examples are documented under xref:tinymceai.adoc#tinymceai_chat_welcome_message[`+tinymceai_chat_welcome_message+`] and xref:tinymceai.adoc#tinymceai_chat_welcome_actions[`+tinymceai_chat_welcome_actions+`]. +Full schemas, supported item types, and command examples are documented under xref:tinymceai.adoc#tinymceai_chat_welcome_message[tinymceai_chat_welcome_message] and xref:tinymceai.adoc#tinymceai_chat_welcome_actions[tinymceai_chat_welcome_actions]. [source,js] ---- From a7ca8e03891fb3960d64b8506528927e33491402 Mon Sep 17 00:00:00 2001 From: Karl Kemister-Sheppard Date: Thu, 16 Jul 2026 11:36:21 +1000 Subject: [PATCH 3/3] TINYDOC-3558: Reframe welcome section heading and opening per review --- modules/ROOT/pages/tinymceai-chat.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/modules/ROOT/pages/tinymceai-chat.adoc b/modules/ROOT/pages/tinymceai-chat.adoc index ae29c23926..408036f9f9 100644 --- a/modules/ROOT/pages/tinymceai-chat.adoc +++ b/modules/ROOT/pages/tinymceai-chat.adoc @@ -95,9 +95,9 @@ Reasoning in Chat models turns on the ability to think through problems, draw lo Some models use reasoning automatically, while others may require manual activation. Whether the "Enable reasoning" button image:icons-premium/reasoning.svg[Reasoning icon,24px] below the prompt input needs to be toggled depends on the model and sometimes even how the prompt is worded. For models that support reasoning, use the toggle button to enable it. [[welcome-chat-actions]] -== Welcome chat actions +== Customizing the welcome message -Welcome chat actions customize the empty state of the Chat sidebar, replacing a blank prompt with a welcome message and a set of suggested starting points. When a user opens Chat before sending any messages, the sidebar can present an introductory message alongside clickable buttons that run common tasks, helping users understand what the AI can do and begin a conversation with a single click. +When a user opens Chat before sending any messages, the sidebar can present an introductory message alongside clickable buttons that run common tasks, helping users understand what the AI can do and begin a conversation with a single click. The welcome actions are shown only before the first request is sent in a conversation. They are hidden once the first message is sent and shown again when a new conversation is started.