Jak włączyć tryb deweloperski w Odoo? 4 sprawdzone metody

Tryb deweloperski (debug mode) w Odoo to niezbędne narzędzie dla każdego programisty, konsultanta i administratora systemu. Umożliwia dostęp do zaawansowanych funkcji, technicznych informacji oraz narzędzi diagnostycznych, które są ukryte w standardowym interfejsie użytkownika. W tym przewodniku przedstawimy wszystkie metody aktywacji trybu deweloperskiego oraz pokażemy, jak efektywnie z niego korzystać.

Czym jest tryb deweloperski w Odoo?

Tryb deweloperski w Odoo to specjalny tryb pracy systemu, który odsłania dodatkowe opcje techniczne i narzędzia diagnostyczne. Po jego aktywacji użytkownik otrzymuje dostęp do informacji o strukturze bazy danych, metadanych widoków, możliwości edycji pól technicznych oraz wielu innych funkcji niedostępnych dla standardowych użytkowników.

Włączenie trybu deweloperskiego jest szczególnie przydatne podczas:

• Tworzenia i modyfikacji niestandardowych modułów
• Debugowania błędów w systemie
• Analizy struktury danych i relacji między modelami
• Dostosowywania widoków i interfejsu użytkownika
• Testowania nowych funkcjonalności
• Pracy nad integracjami i API

Metoda 1: Aktywacja przez URL (najszybsza)

Najprostsza i najszybsza metoda włączenia trybu deweloperskiego w Odoo polega na dodaniu parametru do adresu URL. Ta metoda działa we wszystkich wersjach Odoo i nie wymaga żadnych uprawnień specjalnych poza standardowym dostępem do systemu.

Standardowy tryb deweloperski:

Dodaj ?debug=1 na końcu aktualnego URL (lub &debug=1 jeśli URL zawiera już inne parametry), np.:

https://twoja-domena.odoo.com/web?debug=1

lub

https://twoja-domena.odoo.com/web#action=123&debug=1

Tryb deweloperski z assetsami:

Jeśli pracujesz nad plikami JavaScript lub CSS i chcesz zobaczyć nieskompilowane wersje zasobów (bez minifikacji), użyj:

https://twoja-domena.odoo.com/web?debug=assets

Ten tryb ładuje pojedyncze pliki JS i CSS zamiast skompilowanych bundli, co ułatwia debugowanie kodu frontendowego i identyfikację źródła błędów.

Tryb deweloperski z testami:

Dla zaawansowanych deweloperów dostępny jest również tryb z aktywnym frameworkiem testowym (tours):

https://twoja-domena.odoo.com/web?debug=tests

Ta opcja jest przydatna podczas uruchamiania testów funkcjonalnych i tours w przeglądarce.

Metoda 2: Aktywacja przez menu użytkownika

W nowszych wersjach Odoo (17+) tryb deweloperski można aktywować bezpośrednio z menu użytkownika, bez konieczności wchodzenia w ustawienia systemu.

Krok po kroku:

1. Zaloguj się do swojej instancji Odoo
2. Kliknij ikonę swojego profilu w prawym górnym rogu ekranu
3. W rozwijanym menu znajdziesz opcję Aktywuj tryb deweloperski (może być wyświetlana jako "Developer Mode" lub "Debug Mode" w zależności od wersji językowej)
4. Kliknij tę opcję

Po wykonaniu tych kroków strona zostanie przeładowana, a w prawym górnym rogu pojawi się ikona błędu/narzędzi deweloperskich (zazwyczaj wygląda jak ikona robaka lub narzędzi), oznaczająca aktywny tryb deweloperski.

Uwaga: W niektórych wersjach Odoo ta opcja może być dostępna tylko w menu Ustawień. Jeśli nie widzisz jej w menu użytkownika, przejdź do Ustawień i przewiń stronę do dołu, gdzie znajdziesz sekcję z narzędziami deweloperskimi.

Metoda 3: Aktywacja przez Settings (Ustawienia)

Tradycyjna metoda aktywacji trybu deweloperskiego, która działa we wszystkich wersjach Odoo i zapewnia najpełniejszy dostęp do opcji.

Instrukcja:

1. Zaloguj się do Odoo z uprawnieniami administratora lub użytkownika z dostępem do Ustawień
2. Przejdź do aplikacji Ustawienia (Settings)
3. Przewiń stronę do samego dołu
4. Znajdź sekcję Narzędzia deweloperskie (Developer Tools)
5. Kliknij przycisk Aktywuj tryb deweloperski

W tej sekcji dostępne są różne warianty trybu deweloperskiego:

• Aktywuj tryb deweloperski - standardowa wersja z pełnym dostępem do funkcji technicznych
• Aktywuj tryb deweloperski (z assetsami) - wersja dla programistów frontend pracujących nad JS/CSS

Metoda 4: Konfiguracja w pliku odoo.conf (dla środowisk deweloperskich)

Jeśli masz dostęp do serwera i chcesz włączyć tryb deweloperski permanentnie dla całej instancji lub aktywować dodatkowe funkcje deweloperskie na poziomie serwera, możesz to zrobić poprzez plik konfiguracyjny lub parametry uruchomieniowe.

Edycja pliku konfiguracyjnego:

1. Zlokalizuj plik odoo.conf (zazwyczaj w /etc/odoo/, /etc/odoo-server/ lub w katalogu instalacyjnym)
2. Otwórz plik w edytorze tekstowym z uprawnieniami administratora
3. Dodaj jedną z następujących opcji w sekcji [options]:

Dla automatycznego przeładowywania kodu przy zmianach:

dev_mode = reload,xml

Lub przy uruchamianiu serwera z linii komend:

./odoo-bin --dev=all

Dostępne parametry dla opcji --dev:

• reload - automatyczne przeładowanie serwera przy zmianach w plikach Python
• xml - przeładowanie widoków XML bez restartu serwera
• qweb - przeładowanie szablonów QWeb
• all - włączenie wszystkich powyższych opcji

Zapisz plik i zrestartuj usługę Odoo:

sudo systemctl restart odoo

Uwaga: Ta metoda jest zalecana wyłącznie dla środowisk deweloperskich i testowych, nigdy dla instancji produkcyjnych. Automatyczne przeładowywanie znacząco obniża wydajność i może prowadzić do niestabilności systemu. Jeśli pracujesz nad instalacją Odoo 19, upewnij się, że tryb deweloperski i opcje --dev są wyłączone przed uruchomieniem systemu produkcyjnego.

Co zyskujesz po włączeniu trybu deweloperskiego?

Po aktywacji trybu deweloperskiego otrzymujesz dostęp do szeregu zaawansowanych funkcji, które znacząco ułatwiają pracę z systemem Odoo:

Menu narzędzi deweloperskich:

Po włączeniu trybu deweloperskiego w prawym górnym rogu interfejsu pojawia się ikona narzędzi (bug icon), która po kliknięciu oferuje dostęp do następujących opcji:

• Edytuj widok - bezpośrednia modyfikacja XML aktualnego widoku (formularz, lista, kanban itp.)
• Zobacz metadane - szczegółowe informacje techniczne o aktualnym rekordzie, w tym ID, daty utworzenia/modyfikacji, użytkownik
• Zarządzaj filtrami - tworzenie i edycja zaawansowanych filtrów oraz grup
• Zarządzaj widokami - podgląd i edycja hierarchii widoków dla danego modelu
• Edytuj akcję - modyfikacja parametrów akcji okna (window action)
• Ustaw wartości domyślne - definiowanie domyślnych wartości pól dla użytkowników

Menu techniczne w Ustawieniach:

W aplikacji Ustawienia pojawia się nowa sekcja Techniczne (Technical), która zawiera:

• Modele danych - przeglądanie i edycja struktury bazy danych, pól, relacji
• Widoki - zarządzanie wszystkimi widokami w systemie
• Akcje - konfiguracja akcji okien, serwerowych, raportów, scheduled actions
• Menu - edycja struktury menu aplikacji
• Tłumaczenia - import/eksport i edycja tłumaczeń
• Reguły rekordów - konfiguracja zabezpieczeń na poziomie rekordów (record rules)
• Sekwencje - zarządzanie numeracją dokumentów
• Parametry systemowe - edycja ir.config_parameter

Dodatkowe funkcje dostępne w widokach:

• Pola techniczne - możliwość wyświetlenia i edycji ukrytych pól systemowych jak ID, create_date, create_uid, write_date, write_uid
• Przyciski techniczne - dostęp do przycisków debugowania, jak "Wymuś dostępność" czy "Odśwież widok"
• Zaawansowane opcje wyszukiwania - możliwość tworzenia filtrów z użyciem domeny Odoo
• SQL w listach - w niektórych widokach dostęp do wygenerowanych zapytań SQL

Jeśli pracujesz nad konfiguracją wielojęzyczności, tryb deweloperski znacznie ułatwi dostęp do interfejsu tłumaczeń i pozwoli na eksport/import plików PO.

Jak wyłączyć tryb deweloperski?

Wyłączenie trybu deweloperskiego jest równie proste jak jego włączenie. Dostępne są następujące metody:

Metoda przez menu narzędzi deweloperskich:

1. Kliknij ikonę narzędzi deweloperskich (bug icon) w prawym górnym rogu
2. Z rozwijanego menu wybierz Wyłącz tryb deweloperski
3. Strona zostanie automatycznie przeładowana bez trybu deweloperskiego

Metoda przez URL:

Dodaj do adresu URL parametr: ?debug=0 lub po prostu usuń parametr debug z URL i odśwież stronę.

Metoda przez menu użytkownika:

1. Kliknij ikonę profilu w prawym górnym rogu
2. Wybierz opcję Wyłącz tryb deweloperski (jeśli jest dostępna w Twojej wersji)

Metoda przez Ustawienia:

1. Przejdź do aplikacji Ustawienia
2. Przewiń do sekcji Narzędzia deweloperskie
3. Kliknij przycisk Wyłącz tryb deweloperski

Najlepsze praktyki i ostrzeżenia

Podczas pracy z trybem deweloperskim warto pamiętać o kilku istotnych kwestiach:

Bezpieczeństwo:

• Nigdy nie włączaj trybu deweloperskiego na instancjach produkcyjnych dostępnych dla użytkowników końcowych - ujawnia on wrażliwe informacje techniczne
• Tryb deweloperski pozwala na dostęp do struktury bazy danych, pól systemowych, zapytań SQL i innych informacji, które mogą stanowić zagrożenie bezpieczeństwa
• Ogranicz możliwość aktywacji trybu deweloperskiego tylko dla zaufanych administratorów i deweloperów
• W środowiskach produkcyjnych rozważ użycie grup dostępu, które blokują dostęp do menu technicznych nawet z włączonym trybem deweloperskim
• Pamiętaj, że każdy użytkownik może włączyć tryb deweloperski przez URL, więc samo ukrycie przycisku w interfejsie nie jest wystarczającym zabezpieczeniem

Wydajność:

• Standardowy tryb deweloperski (debug=1) ma minimalny wpływ na wydajność w nowszych wersjach Odoo
• Tryb debug=assets znacząco wydłuża czas ładowania strony, gdyż zasoby JS i CSS nie są kompilowane ani cache'owane - używaj go tylko gdy pracujesz nad kodem frontendowym
• Opcje --dev=reload w pliku konfiguracyjnym wpływają na wydajność serwera, monitorując zmiany w plikach
• Dodatkowe informacje diagnostyczne i logowanie zwiększają obciążenie systemu

Kopie zapasowe:

Przed wprowadzaniem zmian w trybie deweloperskim, szczególnie modyfikacją widoków, akcji czy struktury bazy danych, zawsze wykonaj kopię zapasową bazy danych. W razie problemów będziesz mógł łatwo przywrócić system ze backupu.

Dokumentacja zmian:

• Wszystkie modyfikacje wykonywane bezpośrednio w interfejsie (edycja widoków, tworzenie akcji) są zapisywane w bazie danych, a nie w modułach
• Takie zmiany są trudniejsze do przeniesienia między środowiskami i mogą być przypadkowo nadpisane przez aktualizacje modułów
• Dla zmian długoterminowych lepiej jest tworzyć dedykowane moduły
• Dokumentuj wszystkie wprowadzone modyfikacje, aby inni deweloperzy mogli je zrozumieć

Typowe przypadki użycia trybu deweloperskiego

Dostosowywanie widoków:

Tryb deweloperski pozwala na szybką edycję widoków bez konieczności tworzenia modułów. Kliknij ikonę narzędzi deweloperskich, wybierz "Edytuj widok", a następnie modyfikuj XML bezpośrednio w edytorze. Jest to idealne rozwiązanie do szybkich testów i prototypowania, ale pamiętaj, że dla zmian produkcyjnych lepiej stworzyć dedykowany moduł.

Debugowanie błędów:

Tryb deweloperski daje dostęp do szczegółowych komunikatów błędów, pełnych traceback'ów i logów systemowych. Opcja "Zobacz metadane" pozwala sprawdzić dokładne wartości pól, daty modyfikacji i użytkowników, co jest nieocenione przy diagnozowaniu problemów z danymi.

Analiza struktury danych:

Menu Techniczne → Modele danych pozwala przeglądać wszystkie modele w systemie, ich pola, typy, relacje i ograniczenia. To kluczowe narzędzie podczas projektowania nowych funkcjonalności, tworzenia integracji czy zrozumienia działania istniejących modułów.

Konfiguracja zaawansowanych funkcji:

Niektóre funkcje Odoo, takie jak:

• Automated Actions (akcje automatyczne) - wykonywanie operacji na podstawie warunków czasowych lub zmian danych
• Server Actions - tworzenie niestandardowych akcji Python, które można wywoływać z interfejsu
• Scheduled Actions (cron jobs) - zadania wykonywane cyklicznie
• Email Templates - zaawansowana edycja szablonów z użyciem QWeb
• Record Rules - precyzyjna kontrola dostępu do rekordów

wymagają dostępu do menu technicznych dostępnych tylko w trybie deweloperskim.

Praca z tłumaczeniami:

Menu Techniczne → Tłumaczenia pozwala eksportować terminy do plików PO, tłumaczyć je masowo w edytorach typu Poedit, a następnie importować z powrotem. Można też bezpośrednio edytować tłumaczenia w interfejsie, wyszukując konkretne terminy.

Testowanie i rozwój modułów:

Podczas tworzenia własnych modułów tryb deweloperski jest niezbędny. Pozwala na:

• Szybkie sprawdzanie efektów zmian w widokach i modelach
• Testowanie akcji serwera przed zapisaniem ich w kodzie
• Debugowanie przepływów danych między modelami
• Analizę wydajności zapytań SQL (w połączeniu z logami)

FAQ - Najczęściej zadawane pytania

Czy tryb deweloperski jest dostępny w wersji Community i Enterprise?

Tak, tryb deweloperski jest dostępny zarówno w wersji Community, jak i Enterprise Odoo. Wszystkie opisane metody aktywacji działają w obu edycjach systemu. Różnice między wersjami dotyczą dostępnych funkcjonalności biznesowych (jak Marketing Automation, Studio, IoT), nie zaś narzędzi deweloperskich. Funkcje techniczne, edycja widoków, dostęp do menu technicznych - wszystko to działa tak samo w obu wersjach.

Czy mogę używać trybu deweloperskiego na produkcji?

Zdecydowanie nie zaleca się włączania trybu deweloperskiego na instancjach produkcyjnych dostępnych dla użytkowników końcowych. Tryb ten ujawnia wrażliwe informacje techniczne (strukturę bazy danych, ID rekordów, kod źródłowy widoków), może obniżyć wydajność systemu (szczególnie debug=assets) i stanowi zagrożenie bezpieczeństwa. Używaj go wyłącznie w środowiskach deweloperskich i testowych. Jeśli absolutnie musisz użyć trybu deweloperskiego na produkcji do jednorazowej diagnozy problemu, włącz go tylko na czas niezbędny i upewnij się, że jesteś jedynym zalogowanym użytkownikiem.

Co zrobić, gdy nie mogę wyłączyć trybu deweloperskiego?

Jeśli standardowe metody wyłączania nie działają, spróbuj następujących rozwiązań:

1. Wyczyść cache przeglądarki i pliki cookie, a następnie zaloguj się ponownie
2. Ręcznie dodaj do URL parametr ?debug=0 i odśwież stronę
3. Spróbuj w trybie incognito/prywatnym przeglądarki
4. Wyloguj się i zaloguj ponownie
5. Sprawdź czy w pliku konfiguracyjnym serwera nie ma ustawionej opcji dev_mode
6. W skrajnych przypadkach zrestartuj usługę Odoo na serwerze

Jeśli problem nadal występuje, może to wskazywać na problem z cache lub sesją - skontaktuj się z administratorem systemu.

Czy zmiany wprowadzone w trybie deweloperskim są trwałe?

Tak, większość zmian wykonanych w trybie deweloperskim (edycja widoków, tworzenie akcji, modyfikacja pól) jest zapisywana w bazie danych i pozostaje po wyłączeniu trybu. Jednak zmiany te są przechowywane jako customizacje w bazie, a nie jako część modułów, co oznacza, że:

• Nie są automatycznie przenoszone między środowiskami (dev → test → prod)
• Mogą być trudniejsze do śledzenia i dokumentowania
• Przy aktualizacji modułów bazowych mogą wymagać ręcznego przeniesienia

Dla zmian długoterminowych zaleca się tworzenie dedykowanych modułów.

Czy tryb deweloperski wpływa na wydajność systemu?

Wpływ zależy od użytego wariantu:

• debug=1 - minimalny wpływ na wydajność w nowszych wersjach Odoo
• debug=assets - znaczący wpływ, strony ładują się wolniej (brak kompilacji i minifikacji JS/CSS)
• --dev=reload - wpływa na wydajność serwera (monitorowanie zmian w plikach)

W środowiskach produkcyjnych nawet minimalny spadek wydajności może być odczuwalny przy dużej liczbie użytkowników.

Podsumowanie

Włączenie trybu deweloperskiego w Odoo to podstawowa umiejętność każdego developera, konsultanta i administratora systemu. Przedstawione metody - od najprostszej aktywacji przez dodanie parametru do URL, przez aktywację z menu użytkownika, po zaawansowaną konfigurację w pliku odoo.conf - pozwalają dostosować sposób pracy do indywidualnych potrzeb i preferencji.

Kluczowe punkty do zapamiętania:

• Najprostsza metoda to dodanie ?debug=1 do URL
• Tryb deweloperski daje dostęp do menu technicznych, edycji widoków i zaawansowanych narzędzi diagnostycznych
• Używaj go tylko w środowiskach deweloperskich i testowych, nigdy na produkcji
• Zawsze twórz kopie zapasowe przed wprowadzaniem zmian
• Dla zmian długoterminowych twórz dedykowane moduły zamiast edytować bezpośrednio w bazie

Pamiętaj, że tryb deweloperski to potężne narzędzie, które wymaga odpowiedzialnego użytkowania. Stosuj go wyłącznie w środowiskach deweloperskich, zawsze twórz kopie zapasowe przed wprowadzaniem zmian i nigdy nie udostępniaj instancji z aktywnym trybem deweloperskim użytkownikom końcowym.

Opanowanie pracy w trybie deweloperskim znacząco przyspieszy Twoją pracę z systemem Odoo i pozwoli na pełne wykorzystanie jego możliwości customizacyjnych. To fundament efektywnej pracy z platformą Odoo, niezależnie od tego, czy zajmujesz się prostymi konfiguracjami, czy zaawansowanym rozwojem modułów.

Potrzebujesz wsparcia przy konfiguracji Odoo?

KK Innovations to zespół doświadczonych specjalistów Odoo, którzy pomogą Ci w pełni wykorzystać potencjał systemu. Oferujemy kompleksowe wsparcie - od instalacji i konfiguracji, przez tworzenie dedykowanych modułów, po szkolenia dla Twojego zespołu.

Skontaktuj się z nami już dziś i dowiedz się, jak możemy usprawnić Twoje procesy biznesowe dzięki Odoo!