Table of Contents

  1. Introduction

  2. What Is the Oblyon Theme?

  3. Benefits of Using Oblyon in Dolibarr

  4. Prerequisites and Compatibility

  5. Installing the Oblyon Theme

  6. Activating Oblyon in Dolibarr

  7. Exploring Oblyon's User Interface Enhancements

  8. Customizing Oblyon: Colors, Logos, Fonts

  9. Advanced Customization via CSS and TPL Files

  10. Using Oblyon with Modules and Extensions

  11. Mobile Responsiveness and UX Improvements

  12. Real-World Examples of Oblyon Usage

  13. Performance Considerations

  14. Troubleshooting and Support

  15. Tips for Maintaining a Consistent Brand Identity

  16. Conclusion

1. Introduction

Dolibarr is a modular ERP/CRM widely appreciated for its flexibility and open-source nature. One of the aspects that users often seek to improve is the visual appearance of the platform. This is where the Oblyon theme comes in—a modern, responsive, and customizable front-end theme that transforms the look and usability of Dolibarr. This article explores how to activate, configure, and customize the Oblyon theme for a more intuitive and visually appealing experience.

2. What Is the Oblyon Theme?

Oblyon is a professionally developed theme for Dolibarr, designed to improve user interface (UI) aesthetics, navigation, and responsiveness. It replaces the default Dolibarr look with a cleaner layout, refined menus, and modern design principles.

Key features include:

  • Responsive layout for tablets and phones

  • Modern UI components

  • Customizable color palette

  • Enhanced dashboard elements

Oblyon is particularly useful for businesses that use Dolibarr in client-facing environments or those that prioritize brand consistency.

3. Benefits of Using Oblyon in Dolibarr

  • Improved Navigation: Better structured menus and layout increase productivity.

  • Mobile Ready: Responsive design ensures usability across devices.

  • Branding: Supports custom logos and colors to align with company identity.

  • Professional Look: A polished UI builds user trust and comfort.

  • Integration: Works well with most Dolibarr core modules and third-party tools.

4. Prerequisites and Compatibility

Before installing Oblyon, ensure:

  • Your Dolibarr version is supported (typically v12 or newer).

  • You have administrator access.

  • Backup your Dolibarr instance before installing any third-party theme.

  • PHP version is compatible (usually PHP 7.4+).

5. Installing the Oblyon Theme

Option 1: Dolistore (Official Marketplace)

  1. Go to dolistore.com

  2. Search for "Oblyon Theme"

  3. Purchase or download the free/light version

  4. Extract and upload files to htdocs/theme/oblyon

Option 2: GitHub (If Open-Sourced)

  • Clone or download the repository

  • Place theme files in the appropriate theme directory

Once installed, clear your browser cache and reload Dolibarr.

6. Activating Oblyon in Dolibarr

  1. Log in as an admin

  2. Navigate to Home > Setup > Display

  3. Locate the theme dropdown and select Oblyon

  4. Click Save

All users will now see the updated Oblyon UI, unless overridden by individual preferences.

7. Exploring Oblyon's User Interface Enhancements

Notable changes after activation:

  • Horizontal and vertical menu options

  • Enhanced dashboard widgets

  • Icon refinements and font updates

  • Sticky headers and floating menus

  • Larger clickable zones for mobile UX

Oblyon also supports light and dark modes, depending on version and user settings.

8. Customizing Oblyon: Colors, Logos, Fonts

To personalize the theme:

  • Go to Home > Setup > Display > Theme Configuration (if available)

  • Upload a new logo (mysoc.png in theme/common/company/)

  • Change background and menu colors via the UI or CSS

  • Use Google Fonts or custom fonts by editing the oblyon.css or injecting styles

Common tweaks include:

  • Replacing the default favicon

  • Changing button shapes and corner radius

  • Applying gradients to menus

9. Advanced Customization via CSS and TPL Files

Developers can dive deeper by editing:

  • theme/oblyon/style.css

  • theme/oblyon/theme_vars.inc.php

  • .tpl.php files for header/footer in core/tpl

Use child themes or maintain a version-controlled environment to avoid conflicts after updates.

10. Using Oblyon with Modules and Extensions

Oblyon works seamlessly with:

  • Core Dolibarr modules (Invoices, Proposals, Projects)

  • CRM features (Third Parties, Contacts)

  • External modules from Dolistore, with rare layout issues

For unsupported modules, minor CSS adjustments may be required.

11. Mobile Responsiveness and UX Improvements

Oblyon is optimized for smartphones and tablets:

  • Menus collapse into mobile nav bars

  • Tables adapt to small screens

  • Touch-friendly buttons and input fields

This makes it ideal for field sales teams, warehouse scanning, or on-the-go management.

12. Real-World Examples of Oblyon Usage

  • Consulting Firm: Customized Oblyon with brand colors and embedded charts on the dashboard.

  • E-commerce Company: Used mobile-ready layout for sales reps in showrooms.

  • Healthcare Provider: Enhanced readability for daily reporting and patient records.

These implementations demonstrate Oblyon's flexibility in professional environments.

13. Performance Considerations

While visually richer, Oblyon may increase page load slightly:

  • Minify CSS and JS when deploying

  • Use browser caching

  • Consider turning off unused UI elements

  • Monitor using browser dev tools or external monitoring

14. Troubleshooting and Support

Common issues include:

  • Theme not appearing: check file permissions and path

  • Broken layout: clear browser and Dolibarr caches

  • Logo not displaying: ensure correct file format and location

Resources:

  • Dolibarr GitHub

  • Community forums and Discord groups

  • Paid support from theme developers

15. Tips for Maintaining a Consistent Brand Identity

  • Use the same color palette across modules

  • Upload high-resolution logos

  • Customize PDF generation templates to match the UI

  • Document your theme settings for future upgrades

16. Conclusion

The Oblyon theme is one of the most effective ways to enhance the visual presentation and usability of Dolibarr. From smoother navigation to full mobile compatibility and branding options, it transforms Dolibarr into a more refined ERP experience. Whether you're an admin, developer, or end-user, Oblyon offers the tools and flexibility to adapt Dolibarr’s look and feel to your business's unique identity.