Diskusi: Cara Kustomisasi Icon Modul di Antarmuka Odoo ERP
Diposting pada 01 Jun 2026, 00:42
Halo rekan-rekan Odoo User di sini!
Saya Kurniawan dari tim IT, kebetulan di kantor kami sedang pakai Odoo ERP dan lagi coba explore untuk merapikan tampilan user interface-nya. Nah, saya ada pertanyaan nih terkait bagaimana cara mengubah atau kustomisasi icon-icon modul yang muncul di dashboard utama Odoo.
Tujuannya sih biar tampilan Odoo kami lebih intuitif dan sesuai dengan branding perusahaan. Misalnya, icon default untuk modul Sales atau Purchases itu kan bawaan Odoo, saya pengen ganti pakai logo atau icon spesifik yang sudah kami siapkan sendiri.
Saya sudah coba explore di bagian General Settings atau ke menu Users & Companies, tapi belum menemukan opsi yang jelas untuk mengubah icon per modul ini. Apakah ada fitur built-in di Odoo yang memungkinkan kita untuk mengupload atau memilih icon kustom untuk setiap modul? Atau apakah ini membutuhkan kustomisasi lebih lanjut via mode developer, atau bahkan pengembangan modul baru?
Mungkin ada rekan-rekan di sini yang sudah pernah melakukan hal serupa dan bisa share tips atau langkah-langkahnya? Sangat appreciate sekali kalau ada yang mau berbagi pengalaman. Terima kasih banyak sebelumnya!
Balasan (1)
Halo Mas Kurniawan, Sobat Odoo!
Wah, ide yang sangat bagus sekali Mas untuk membuat tampilan Odoo lebih intuitif dan sesuai dengan branding perusahaan! Ini memang langkah cerdas untuk membuat pengalaman pengguna lebih baik dan konsisten dengan identitas brand.
Untuk saat ini, fitur built-in Odoo secara langsung memang tidak menyediakan opsi tombol 'Upload Icon' per modul di bagian General Settings atau Users & Companies seperti yang Mas Kurniawan cari. Odoo dirancang untuk memberikan fleksibilitas, dan kustomisasi semacam ini biasanya dilakukan melalui pendekatan yang sedikit lebih teknis.
Icon-icon modul di dashboard Odoo itu sebenarnya didefinisikan dalam kode setiap modul. Lebih spesifiknya, icon tersebut diatur melalui atribut web_icon yang terkait dengan entri menu utama modul tersebut (yang tersimpan di model ir.ui.menu).
Oleh karena itu, cara paling standar, aman, dan disarankan untuk kustomisasi icon modul adalah melalui pengembangan modul kustom (custom module). Jangan khawatir, prosesnya tidak sesulit kedengarannya, terutama jika Mas Kurniawan sudah terbiasa dengan sedikit pengembangan.
Berikut adalah gambaran langkah-langkah yang bisa Mas Kurniawan ikuti:
1. Aktifkan Developer Mode: Ini langkah pertama yang krusial. Dengan mode developer aktif, Mas Kurniawan bisa melihat informasi teknis seperti External ID dari menu atau modul yang ingin diubah. Caranya, masuk ke General Settings, scroll ke bawah, dan klik 'Activate the developer mode'. Atau lebih cepat, tambahkan `?debug=1` atau `?debug=assets` di URL Odoo setelah `web#`.
2. Identifikasi Menu ID: Setelah mode developer aktif, arahkan kursor ke icon modul di dashboard Odoo. Akan muncul tooltip yang menunjukkan External ID dari menu tersebut (misalnya, `sales.menu_sales_root` untuk modul Sales). ID ini yang akan kita targetkan.
3. Buat Modul Kustom Baru: Buatlah sebuah modul Odoo kosong yang baru. Modul ini hanya akan berisi definisi perubahan icon. Beri nama yang unik, misalnya `branding_kustom_perusahaan`. Di dalam modul ini, buat folder `static/src/img` atau `static/description` untuk menyimpan file-file icon kustom Mas Kurniawan (pastikan formatnya sesuai, umumnya PNG atau SVG).
4. Update Record Menu melalui XML: Di dalam modul kustom yang Mas Kurniawan buat, Mas Kurniawan bisa membuat file XML (misalnya `views/menu_override_view.xml`). File XML ini akan berisi perintah untuk meng-update record `ir.ui.menu` yang sesuai dengan External ID yang sudah ditemukan sebelumnya.
Di sinilah Mas Kurniawan akan menunjuk ke lokasi file icon baru yang sudah disiapkan. Misalnya, jika icon Sales kustom Mas Kurniawan bernama `sales_logo.png` dan diletakkan di `static/src/img/sales_logo.png` di dalam modul kustom Mas Kurniawan, maka kodenya akan mengarahkan ke path tersebut. Intinya, Mas Kurniawan akan mengubah nilai atribut web_icon dari menu yang dituju.
5. Install Modul Kustom: Setelah modul kustom selesai dibuat dan di-install, Odoo akan membaca definisi perubahan tersebut, dan icon modul di dashboard utama akan langsung berganti sesuai dengan gambar yang Mas Kurniawan upload.
Metode ini sangat disarankan karena:
Maintainable: Kustomisasi Mas Kurniawan tidak akan terganggu saat melakukan update Odoo di masa mendatang.
Organized: Semua kustomisasi terkait branding berada di satu tempat (modul kustom).
Upgrade-friendly: Modul kustom Mas Kurniawan hanya menimpa bagian yang spesifik, bukan mengubah kode inti Odoo.
Selain icon, dengan modul kustom Mas Kurniawan juga bisa explore kustomisasi theme Odoo secara keseluruhan untuk mengubah warna, font, atau bahkan logo di header agar benar-benar sesuai dengan branding perusahaan.
Semoga info ini membantu ya Mas Kurniawan! Kalau ada pertanyaan lebih lanjut atau butuh panduan lebih detail, jangan sungkan tanya lagi di komunitas. Kami siap bantu!
Wah, ide yang sangat bagus sekali Mas untuk membuat tampilan Odoo lebih intuitif dan sesuai dengan branding perusahaan! Ini memang langkah cerdas untuk membuat pengalaman pengguna lebih baik dan konsisten dengan identitas brand.
Untuk saat ini, fitur built-in Odoo secara langsung memang tidak menyediakan opsi tombol 'Upload Icon' per modul di bagian General Settings atau Users & Companies seperti yang Mas Kurniawan cari. Odoo dirancang untuk memberikan fleksibilitas, dan kustomisasi semacam ini biasanya dilakukan melalui pendekatan yang sedikit lebih teknis.
Icon-icon modul di dashboard Odoo itu sebenarnya didefinisikan dalam kode setiap modul. Lebih spesifiknya, icon tersebut diatur melalui atribut web_icon yang terkait dengan entri menu utama modul tersebut (yang tersimpan di model ir.ui.menu).
Oleh karena itu, cara paling standar, aman, dan disarankan untuk kustomisasi icon modul adalah melalui pengembangan modul kustom (custom module). Jangan khawatir, prosesnya tidak sesulit kedengarannya, terutama jika Mas Kurniawan sudah terbiasa dengan sedikit pengembangan.
Berikut adalah gambaran langkah-langkah yang bisa Mas Kurniawan ikuti:
1. Aktifkan Developer Mode: Ini langkah pertama yang krusial. Dengan mode developer aktif, Mas Kurniawan bisa melihat informasi teknis seperti External ID dari menu atau modul yang ingin diubah. Caranya, masuk ke General Settings, scroll ke bawah, dan klik 'Activate the developer mode'. Atau lebih cepat, tambahkan `?debug=1` atau `?debug=assets` di URL Odoo setelah `web#`.
2. Identifikasi Menu ID: Setelah mode developer aktif, arahkan kursor ke icon modul di dashboard Odoo. Akan muncul tooltip yang menunjukkan External ID dari menu tersebut (misalnya, `sales.menu_sales_root` untuk modul Sales). ID ini yang akan kita targetkan.
3. Buat Modul Kustom Baru: Buatlah sebuah modul Odoo kosong yang baru. Modul ini hanya akan berisi definisi perubahan icon. Beri nama yang unik, misalnya `branding_kustom_perusahaan`. Di dalam modul ini, buat folder `static/src/img` atau `static/description` untuk menyimpan file-file icon kustom Mas Kurniawan (pastikan formatnya sesuai, umumnya PNG atau SVG).
4. Update Record Menu melalui XML: Di dalam modul kustom yang Mas Kurniawan buat, Mas Kurniawan bisa membuat file XML (misalnya `views/menu_override_view.xml`). File XML ini akan berisi perintah untuk meng-update record `ir.ui.menu` yang sesuai dengan External ID yang sudah ditemukan sebelumnya.
Di sinilah Mas Kurniawan akan menunjuk ke lokasi file icon baru yang sudah disiapkan. Misalnya, jika icon Sales kustom Mas Kurniawan bernama `sales_logo.png` dan diletakkan di `static/src/img/sales_logo.png` di dalam modul kustom Mas Kurniawan, maka kodenya akan mengarahkan ke path tersebut. Intinya, Mas Kurniawan akan mengubah nilai atribut web_icon dari menu yang dituju.
5. Install Modul Kustom: Setelah modul kustom selesai dibuat dan di-install, Odoo akan membaca definisi perubahan tersebut, dan icon modul di dashboard utama akan langsung berganti sesuai dengan gambar yang Mas Kurniawan upload.
Metode ini sangat disarankan karena:
Maintainable: Kustomisasi Mas Kurniawan tidak akan terganggu saat melakukan update Odoo di masa mendatang.
Organized: Semua kustomisasi terkait branding berada di satu tempat (modul kustom).
Upgrade-friendly: Modul kustom Mas Kurniawan hanya menimpa bagian yang spesifik, bukan mengubah kode inti Odoo.
Selain icon, dengan modul kustom Mas Kurniawan juga bisa explore kustomisasi theme Odoo secara keseluruhan untuk mengubah warna, font, atau bahkan logo di header agar benar-benar sesuai dengan branding perusahaan.
Semoga info ini membantu ya Mas Kurniawan! Kalau ada pertanyaan lebih lanjut atau butuh panduan lebih detail, jangan sungkan tanya lagi di komunitas. Kami siap bantu!