Personaliza las barras de herramientas de Collabora CODE sin editar el código fuente.

Para simplificar el editor Collabora Online Development Edition (CODE), seleccione Compacto o con pestañas para el diseño general y, a continuación, utilice la integración PostMessage del host WOPI para ocultar comandos, botones o pestañas de la barra de herramientas. Ocultar una barra de herramientas facilita la visualización; ocultar un control a través del host es más apropiado cuando se desea una interfaz uniforme en cada sesión de edición.

¿Qué interfaz de CODE debería personalizar?

CODE ofrece un diseño compacto con menús y barras de herramientas tradicionales, y un diseño con pestañas y una barra de bloc de notas. Comience por identificar cuál ven sus usuarios: el ID de un botón de la barra de herramientas y el ID de una pestaña de la barra de bloc de notas no son intercambiables. La guía de soporte de Collabora indica que los nombres anteriores classicquedaron notebookbarobsoletos a favor de compacty tabbeda partir de la serie 21.11. Consulte la guía de configuración de la interfaz de Collabora .

¿Deberías cambiar la configuración predeterminada del servidor o la sesión de un usuario?

Cambie la configuración predeterminada del servidor solo cuando la mayoría de los usuarios deban comenzar con el mismo diseño. En instalaciones autogestionadas, la user_interface.modeconfiguración coolwsd.xmlacepta default, compact, o tabbed. Realice una copia de seguridad de la configuración y luego cambie el modevalor existente en lugar de agregar otro elemento XML:

<user_interface>
  <mode>tabbed</mode>
</user_interface>

Este XML abreviado muestra la configuración, no reemplaza la sección de configuración completa. Aplique el cambio mediante la configuración normal de su implementación y el proceso de reinicio del servicio, luego vuelva a abrir un documento. Las implementaciones de contenedores pueden, en cambio, pasar --o:user_interface.mode=tabbedsus anulaciones de inicio de CODE existentes. Una aplicación integrada también puede influir en el modo de inicio a través de su ui_defaultsvalor WOPI. La preferencia del host puede ser importante cuando el servidor usa default, por lo que no asuma que una edición del servidor anulará una elección específica de la integración.

¿Es posible ocultar una barra de herramientas completa sin editar el código fuente?

Para disponer de más espacio al leer, al hacer clic en la pestaña seleccionada se puede contraer la barra de Notebookbar; al volver a hacer clic, se expande. Collabora describe este comportamiento en su introducción oficial a la barra de Notebookbar . La API PostMessage también documenta Collapse_Notebookbaresta función, que oculta los botones de la barra de Notebookbar o la tira de botones Compact. Se trata de un estado de visualización reversible, no de una política de administrador permanente.

Para un control más preciso, seleccione la acción PostMessage que coincida con el elemento. Las siguientes asignaciones se enumeran en el manual del SDK de Collabora Online :

La acción específica de la pestaña está documentada a partir de la versión 24.04.11.1 . El SDK también indica una cobertura ampliada del menú contextual Hide_Commanden la versión 24.04.11.2 . Verifique su compilación de CODE implementada antes de confiar en cualquiera de estos comportamientos.

¿Cómo se envían los comandos de ocultación desde el host WOPI?

Estas acciones se envían mediante la aplicación que integra CODE en un iframe, no se introducen en un cuadro de diálogo de configuración de CODE. Necesitas tener control sobre esa integración de host, una CheckFileInforespuesta WOPI funcional y un PostMessageOriginvalor que coincida con el origen de tu aplicación web de host. Si utilizas una integración empaquetada de Nextcloud o ownCloud, es posible que no exponga ganchos PostMessage personalizados; en ese caso, realiza el cambio en la propia integración o utiliza su configuración compatible.

1. Espere a que el CÓDIGO termine de cargarse.

Registre un receptor de mensajes en la página del host. Verifique tanto la ventana del remitente como el origen. Cuando CODE informe App_LoadingStatuscon Status: Document_Loaded, envíe Host_PostmessageReadyantes de los mensajes de personalización. Sin ese protocolo de enlace, CODE puede ignorar los comandos del host, un fallo que se explica en el problema n.º 13224 de Collabora .

2. Ocultar una pestaña y un comando de formato

El siguiente código JavaScript del lado del host asume que su página ya tiene un iframe con ID collabora-frame. Establezca editorOriginel origen HTTPS exacto que sirve a su editor de CODE, no el servidor de almacenamiento WOPI. Registre el oyente antes de la inicialización del documento en su aplicación real:

const frame = document.getElementById('collabora-frame');
const editorOrigin = 'https://office.example.com';

function sendToCode(MessageId, Values = {}) {
  frame.contentWindow.postMessage(JSON.stringify({
    MessageId, SendTime: Date.now(), Values
  }), editorOrigin);
}

window.addEventListener('message', (event) => {
  if (event.source !== frame.contentWindow ||
      event.origin !== editorOrigin) return;
  let message;
  try {
    message = typeof event.data === 'string'
      ? JSON.parse(event.data) : event.data;
  } catch { return; }
  if (message?.MessageId !== 'App_LoadingStatus' ||
      message?.Values?.Status !== 'Document_Loaded') return;

  sendToCode('Host_PostmessageReady');
  sendToCode('Hide_NotebookTab', { id: 'Help' });
  sendToCode('Hide_Command', { id: '.uno:ThemeDialog' });
});

Aquí Helpestá el destino de la pestaña Notebookbar, que .uno:ThemeDialogidentifica un comando de LibreOffice UNO. Los desarrolladores de Collabora describen específicamente este último ID en su guía sobre cómo ocultar elementos UNO . Para ocultar un botón específico de la barra de herramientas Compact, reemplace la acción con Hide_Buttony proporcione el ID del botón verificado. No intente adivinar el ID a partir del título visible; consulte el código fuente instalado o la guía de ID de la barra de herramientas del SDK.

¿Qué ocurre si la pestaña o la barra de herramientas no desaparece?

Antes de modificar archivos CODE, compruebe la consola del navegador y la actividad de red. Las causas más comunes son la ausencia Host_PostmessageReadyde protocolo de enlace, una discrepancia en el protocolo PostMessageOrigin, el envío de mensajes antes de tiempo Document_Loadedo la selección de un elemento del menú Compacto mientras el editor está en modo de pestañas. Al volver a abrir el archivo, se inicia una nueva sesión, por lo que debe aplicar la opción de ocultar mensajes cada vez.

También existen defectos específicos de cada versión. Por ejemplo, el problema n.° 15910 de Collabora describe un Hide_NotebookTaberror de JavaScript en la versión CODE 25.04.9.4, reportado en junio de 2026; si bien el problema está marcado como cerrado, esto no garantiza que las versiones implementadas incluyan la corrección. Si observa el error reportado, verifique su versión exacta y sus notas de lanzamiento.

Finalmente, ocultar no es control de acceso. Un botón de Imprimir o Descargar oculto puede dejar disponibles API equivalentes u otras rutas. Si el objetivo es prohibir esas operaciones, utilice la documentación de WOPI DisablePrinto DisableExportlas banderas y aplique sus permisos de almacenamiento según corresponda, en lugar de depender de Hide_Buttono Hide_Command.

¿Cómo se puede verificar que la personalización funcionó?

Abra un documento nuevo con el diseño deseado. Confirme que la Helppestaña no aparece en el modo con pestañas y que el comando Tema ya no está disponible donde antes era visible. A continuación, edite y guarde un documento de prueba para confirmar que la edición normal sigue funcionando. Repita la comprobación con otro tipo de documento y después de recargar la página, ya que el servidor debe volver a aplicar los comandos de ocultación específicos de la sesión.