Dostosuj paski narzędzi Collabora CODE bez edycji kodu źródłowego

Aby uprościć edytor Collabora Online Development Edition (CODE), wybierz opcję Kompaktowy lub Zakładkowy dla całego układu, a następnie skorzystaj z integracji PostMessage hosta WOPI, aby ukryć poszczególne polecenia, przyciski lub karty Notebookbar. Zwinięcie paska narzędzi to wygodna zmiana w widoku; ukrycie kontrolki za pośrednictwem hosta jest bardziej odpowiednie, gdy zależy Ci na spójnym interfejsie dla każdej sesji edycji.

Który interfejs CODE należy dostosować?

CODE oferuje układ kompaktowy z tradycyjnymi menu i paskami narzędzi oraz układ z zakładkami z paskiem Notatnika. Zacznij od zidentyfikowania, który z nich widzą użytkownicy: identyfikator przycisku paska narzędzi i identyfikator zakładki paska Notatnika nie są zamienne. Wskazówki dotyczące wsparcia technicznego Collabora wskazują, że starsze nazwy classiczostały notebookbarwycofane na rzecz compactserii tabbed21.11. Zobacz wskazówki dotyczące konfiguracji interfejsu Collabora .

Czy powinieneś zmienić domyślne ustawienia serwera czy sesję użytkownika?

Zmień ustawienia domyślne serwera tylko wtedy, gdy większość użytkowników powinna zacząć od tego samego układu. W instalacjach zarządzanych samodzielnie, ustawienie user_interface.modew opcji coolwsd.xmlakceptuje default, compactlub tabbed. Utwórz kopię zapasową konfiguracji, a następnie zmień istniejącą modewartość zamiast dodawać kolejny element XML:

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

Ten skrócony kod XML demonstruje ustawienie, a nie zastępuje całej sekcji konfiguracji. Zastosuj zmianę poprzez standardową konfigurację wdrożenia i proces ponownego uruchomienia usługi, a następnie ponownie otwórz dokument. Wdrożenia kontenerów mogą zamiast tego przekazać --o:user_interface.mode=tabbedistniejące nadpisania startowe CODE. Aplikacja osadzona może również wpływać na tryb uruchamiania poprzez swoją ui_defaultswartość WOPI. Preferencje hosta mogą mieć znaczenie, gdy serwer używa default, więc nie zakładaj, że edycja serwera nadpisze wybór specyficzny dla integracji.

Czy można ukryć cały pasek narzędzi bez edytowania kodu źródłowego?

Aby uzyskać więcej miejsca podczas czytania, kliknięcie aktualnie wybranej karty może zwinąć pasek Notatnika; ponowne kliknięcie go rozwinie. Collabora opisuje to zachowanie w oficjalnym wprowadzeniu do paska Notatnika . Interfejs API PostMessage również dokumentuje Collapse_Notebookbarfunkcję ukrywania przycisków paska Notatnika lub paska przycisków Kompakt. Jest to odwracalny stan wyświetlania, a nie stała polityka administratora.

Aby uzyskać większą kontrolę, wybierz akcję PostMessage pasującą do elementu. Poniższe mapowania są wymienione w podręczniku Collabora Online SDK :

Akcja specyficzna dla karty jest udokumentowana od wersji 24.04.11.1 . Zestaw SDK informuje również o rozszerzonym zakresie menu kontekstowego Hide_Commandw wersji 24.04.11.2 . Przed skorzystaniem z któregokolwiek z tych rozwiązań sprawdź wdrożoną kompilację KODU.

Jak wysłać polecenia ukrycia z hosta WOPI?

Te akcje są wysyłane przez aplikację osadzającą kod CODE w ramce iframe, a nie wpisywane w oknie dialogowym ustawień kodu CODE. Potrzebujesz kontroli nad tą integracją hosta, działającej CheckFileInfoodpowiedzi WOPI oraz PostMessageOriginwartości odpowiadającej źródłu aplikacji internetowej hosta. Jeśli korzystasz z spakowanej integracji Nextcloud lub ownCloud, może ona nie udostępniać dowolnych niestandardowych haków PostMessage; w takim przypadku wprowadź zmianę w samej integracji lub skorzystaj z jej obsługiwanych ustawień.

1. Poczekaj, aż KODEKS zostanie załadowany

Zarejestruj nasłuchiwacza wiadomości na stronie hosta. Zweryfikuj zarówno okno nadawcy, jak i źródło. Gdy CODE zgłasza App_LoadingStatusbłąd Status: Document_Loaded, wyślij go Host_PostmessageReadyprzed wiadomościami dostosowującymi. Bez tego uzgadniania CODE może zignorować polecenia hosta — błąd opisany w zgłoszeniu Collabora nr 13224 .

2. Ukryj kartę i polecenie formatowania

Poniższy kod JavaScript po stronie hosta zakłada, że ​​Twoja strona ma już ramkę iframe o identyfikatorze collabora-frame. Ustaw editorOriginna dokładne źródło HTTPS obsługujące edytor CODE, a nie serwer pamięci masowej WOPI. Zarejestruj nasłuchiwacz przed inicjalizacją dokumentu w swojej rzeczywistej aplikacji:

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' });
});

Oto Helpcel zakładki Notebookbar, który .uno:ThemeDialogidentyfikuje polecenie LibreOffice UNO. Twórcy Collabora szczegółowo opisują ten ostatni identyfikator w swoich wskazówkach dotyczących ukrywania elementów UNO . Aby ukryć konkretny przycisk Kompaktowego paska narzędzi, zastąp akcję Hide_Buttoni podaj zweryfikowany identyfikator przycisku. Nie zgaduj identyfikatora na podstawie widocznego podpisu; sprawdź zainstalowany kod źródłowy lub wskazówki dotyczące identyfikatorów paska narzędzi w pakiecie SDK.

Co się stanie, jeśli karta lub pasek narzędzi nie zniknie?

Przed zmianą plików CODE sprawdź konsolę przeglądarki i aktywność sieciową. Najczęstszymi przyczynami są brak Host_PostmessageReadyuzgadniania, niedopasowanie PostMessageOrigin, wysyłanie komunikatów przed Document_Loadedlub wybieranie pozycji menu Kompakt, gdy edytor jest w trybie kart. Ponowne otwarcie pliku rozpoczyna nową sesję, dlatego za każdym razem stosuj opcję ukrywania komunikatów.

Istnieją również defekty specyficzne dla danej wersji. Na przykład, zgłoszenie Collabora nr 15910 opisuje Hide_NotebookTabbłąd JavaScript w CODE 25.04.9.4, zgłoszony w czerwcu 2026 roku; problem jest oznaczony jako zamknięty, ale samo to nie określa, które wdrożone kompilacje zawierają poprawkę. Sprawdź swoją wersję i jej informacje o wydaniu, jeśli widzisz zgłoszony błąd.

Wreszcie, ukrywanie nie jest kontrolą dostępu. Ukryty przycisk „Drukuj” lub „Pobierz” może pozostawić dostępne równoważne interfejsy API lub inne ścieżki. Jeśli celem jest zablokowanie tych operacji, należy użyć udokumentowanego pliku WOPI DisablePrintlub DisableExportflag i wymusić odpowiednie uprawnienia do przechowywania danych, zamiast polegać na Hide_Buttonlub Hide_Command.

Jak można sprawdzić, czy dostosowanie zadziałało?

Otwórz nowy dokument w odpowiednim układzie. Sprawdź, czy Helpzakładka jest nieobecna w trybie kart i czy polecenie Motyw nie jest już dostępne tam, gdzie było wcześniej widoczne. Następnie edytuj i zapisz dokument testowy, aby upewnić się, że normalne tworzenie nadal działa. Powtórz sprawdzenie z innym typem dokumentu i po ponownym załadowaniu strony, ponieważ host musi ponownie zastosować polecenia ukrywania specyficzne dla sesji.