KSIDol documentation > KSIDol modules > 3D configurator (Concept3D)
Module guide: 3D configurator (Concept3D)
A non-technical user guide: what the module is for, how to use it day to day, and how it fits together with Dolibarr.
Plan drawn to scaleWalls, doors, windows and objects at their real dimensions, in metres
Instant 3D viewEye-level walk, capture, 360° panorama and presentation mode
Live costingQuantities, discounts, automatic installation, margin under a dedicated permission
Native quote in one clickDolibarr quote as a draft, plan PDF attached, project linked
1. Module overview
Concept3D is a visual configurator for Dolibarr. You draw your customer's room to scale, drag in your products exactly as they exist in your catalogue, show the result in 3D, then get the quote in one click. It is aimed at kitchen designers, interior fitters, sellers of furniture, bathrooms, closets, terraces or swimming pools, and shops laying out their aisles. Everything that is priced stays a native Dolibarr product or service: there is no catalogue to re-enter, and no double entry.
A dedicated "Concept3D" menu: the plan list, plan creation, the plan editor, the configurator's products and services, the 3D model library and its sources.
A complete workflow: measuring up the room, laying out the products, presenting to the customer, the quote, then the installation file and the orders to suppliers.
Seven ready-to-use usage profiles (kitchen, bathroom, closet, furniture, terrace, swimming pool, shop) that set the defaults for the trade in one go.
A 3D display engine embedded in the module: no outside service is called. The 3D models of your products are imported into your own library.
Five languages (French, English, German, Spanish, Italian).
2. The plan list and sales follow-up
The module's entry point, designed for keeping track of projects in progress.
Counters at the top of the list give the total number of plans, the drafts, the plans converted to a quote, and the sales breakdown: in study, presented, won, lost.
A line chart shows the plans created over the last twelve months.
Each plan carries a sales status: "In study", "Presented", "Won" or "Lost", the last one with its reason. As soon as the quote is signed or declined in Dolibarr, the quote takes precedence and the plan's status follows it.
The list can be filtered by reference, title, status and sales status, like any native Dolibarr list.
3. Creating a plan
A plan is the record of a customer's project.
You choose the third party, a title, the usage profile, the dimensions of the area in metres and, if needed, the Dolibarr project to link the plan to.
The plan background is a plain colour or an imported image (JPEG, PNG or WebP), for example the measured drawing supplied by the customer.
A presentation text for the project can be entered: it is printed at the top of the PDF given to the customer.
A room template, specific to each trade, lays down the walls and openings of a typical room in one move and adjusts the plan dimensions; the objects already placed are kept.
4. The plan editor: walls, doors and windows
The screen where you measure up the room.
Two-point scaling: you draw a known distance on the imported image, enter its real length, and the whole plan is scaled to match.
Walls are drawn as a chain, click after click, snapping to corners and to 15-degree steps; thickness and height are adjustable.
Doors and windows are dropped onto a wall, with their width, height and sill.
Four opening types: interior door, exterior door, French window and window. In the 3D view, a window, French window or exterior door opens onto a garden; an interior door shows the neighbouring room.
The dimensions, the grid and the background plan can be shown or hidden; undo reverses the last action.
The editor's default values (wall thickness and height, door dimensions, sill) are set in the module setup and follow the usage profile.
5. Rooms and measurements
As soon as walls form a closed outline, the module recognises the room.
The floor area and the perimeter of each room are worked out automatically and shown live in the editor.
The table of rooms appears on the plan card, with the total of the areas.
These measurements are included in the PDF given to the customer.
6. Placing products on the plan
The heart of the configurator: the catalogue on the left, the plan in the centre, the summary on the right.
The catalogue shows the Dolibarr products with their photo, filtered by category, subcategories included.
A product is dragged onto the plan and drawn there at its real dimensions, read from its product card.
Services (labour, installation, delivery, fees) are dragged straight into the summary, with no position on the plan.
On a tablet or a showroom touchscreen, products and objects are moved with a finger.
Zoom, a fullscreen mode and a double-click to return to 100% make it easier to work on large plans.
7. Handling placed objects
Every object on the plan is adjusted in place.
Rotation in quarter turns or free rotation, height from the floor (wall units, shelves), locking against accidental moves, duplication.
The magnet snaps the edges of the object to other objects, to walls and to the plan borders; holding Shift suspends it for the duration of a free move.
Keyboard shortcuts: R to rotate, Delete to remove, Ctrl+D to duplicate, L to lock, the arrow keys to move.
Objects are numbered: the same number is found on the plan, in the installation list and on the elevations.
8. Finishes and made-to-measure
Two ways of adapting a product to the project.
Fronts drawn by the module: a cabinet without a 3D model receives a generated front — doors, drawers, door and drawer, glazed, open — with its style, handle and finish (wood, matt or gloss lacquer, stainless steel). It is set in the “3D object” tab of the product card, with a live preview.
A variant inherits the front of its parent product, and its finish is recognised in its label (“Oak”, “Walnut”, “Gloss white”…).
Finishes: if the product has native Dolibarr variants (colour, material, front), you choose the finish when placing it, and you can change it afterwards on the placed object. This feature requires the native Product Variants module.
Made-to-measure: for a product sold in variable dimensions, you set the limits and the step of each dimension on its product card; the object can then be resized on the plan within those limits.
The quantity by the metre and the pro rata price are recalculated every time a dimension changes.
The plan also hosts low-voltage and electrical installations.
About fifty pieces of equipment are drawn by the module: floor or wall network racks, servers, NAS, UPS, Wi-Fi access points and repeaters, network sockets, alarm panels, detectors, cameras, speakers, screens, projectors, sockets and switches.
Each one has its real dimensions and a default mounting height (floor, wall, ceiling); simply link a product to the chosen equipment in the “3D object” tab.
Small point devices (sockets, detectors) do not trigger overlap alerts with furniture.
10. The 3D view
The plan can be walked through in three dimensions, with nothing to install.
The 3D view is built in real time from the plan: walls, openings and objects at their dimensions and at their height from the floor.
Realistic rendering: ambient light, shadows, textured materials (wood, stone, tiles), sinks and hobs set into the worktop.
Placement guard: an object can neither pass through another one nor through a wall; the move is refused and the conflict is shown in red. An object can, however, be placed on another one that supports it, such as a microwave on a cabinet.
A product linked to a 3D model is displayed with its real shape; the others appear as simple volumes at their dimensions.
The eye-level walk lets you move around the room as the customer will.
Materials: you choose the floor covering (parquet, tiles, concrete, stone, decking, lawn, water) and the colour of the walls.
The scene can be exported in GLB format, readable by common 3D viewers.
11. The 3D model library
Giving a product its true shape.
The import accepts GLB and glTF, OBJ and Collada files, or a ZIP archive bundling the model and its textures, up to 20 MB.
Before saving, you adjust the scale, the orientation, the placement on the floor and the tint; the resulting dimensions are shown live.
A model is linked to a product from the "3D Object" tab of the product card, and can be unlinked without being deleted from the library.
The library states the source and the licence of each model, and counts the models that are linked and not linked.
One page lists free 3D model libraries, with their licence. The module downloads nothing by itself: you get the file from the source, then you import it.
Models are sorted by category: kitchen, bathroom, living room, office, outdoor, and also network and IT, alarm and remote monitoring, audio, video and entertainment.
12. Presenting the project to the customer
Tools made for the appointment and the showroom.
The capture saves the 3D view as it is shown on screen; it is included in the plan PDF.
The 360° panorama is built from the current viewpoint, opens in a viewer and can be downloaded for the customer.
Presentation mode displays the project in fullscreen and read-only: nothing can be changed by mistake in front of the customer.
Kiosk mode removes the Dolibarr menus as well, for a showroom screen.
13. The summary and costing
The price of the project builds up as you place objects.
Each product placed and each service added feeds the summary: quantity, unit price, line discount.
The quantity is derived from the native unit of the product: a worktop sold by the linear metre or a covering sold by the square metre is priced from its placed dimensions.
A global discount applies to the whole; the gross total, the discounts and the net total can still be read separately.
The purchase price is frozen when the line is added. The purchase total, the margin and the margin rate are shown only to users who hold the permission.
14. Automatic installation rules
Labour is added automatically, based on what has been placed.
A rule ties a product category (or all products) to a Dolibarr service and to a calculation mode.
Five modes: percentage of the net amount (excluding tax) of the objects concerned, flat fee per object, price per linear metre placed, price per square metre placed, hours per object at the service's hourly rate.
The generated line is recalculated on every change of the plan; only its discount is entered by hand.
Deleting a rule removes nothing from existing plans: the lines already generated stay there as ordinary lines.
15. Usage profiles, room templates and zones
Adapting the tool to your trade.
Seven profiles are supplied: kitchen, bathroom, closet, furniture, terrace, swimming pool, shop. You can edit them and create others.
A profile sets the default plan dimensions, the catalogue category offered, the wall height, the sill, the minimum aisle and the tiling values.
Technical zones are defined on the plan, in metres: a zone where no objects are allowed, an aisle to keep clear, a technical reservation, a work mark. A zone can be restricted to a single product category.
16. Plan checks
The module flags whatever cannot be installed as it stands.
An object extending beyond the plan.
Two objects overlapping, taking their height into account: a wall unit above a base unit is not an error.
An object going through a wall.
An aisle that is too narrow between two objects, judged against the minimum aisle of the profile.
An object placed in a zone where no objects are allowed or in an aisle to keep clear.
The alerts are shown on the plan card and the object concerned is highlighted; they inform without blocking the quote.
17. The tiling calculator
For coverings: tiles, decking boards, slabs.
You enter the area to cover, or start from the area of a detected room.
The module works out the number of elements needed from their dimensions, the joint width and the waste percentage.
The result is added to the costing in one click.
18. From plan to quote
The "Validate -> create quote" button turns the plan into a quote.
A Dolibarr quote (commercial proposal) is created as a draft with all the lines, the line discounts, the global discount and the purchase prices.
The project linked to the plan is passed on to the quote.
The plan then becomes read-only: any correction is made on the native quote, which avoids having two versions of the same costing.
From the quote, a link leads back to the original plan; from the plan, you open the quote.
Once the quote is signed, the plan gives access to the invoice or the deposit invoice.
If the quote is deleted, the plan becomes a draft again: it can be edited and converted again normally.
A customer, project or user that holds plans cannot be deleted: a message says so, instead of a technical error.
19. Project variants
Offering the same customer several solutions.
A plan can be duplicated as a variant: same room, a different layout or a different range.
The plan card compares the variants with one another, along with their costing, so that you can choose with the customer.
20. Documents
What you hand over to the customer and to the installation team.
Presentation PDF: presentation text, layout plan to scale, captured 3D view, room areas and priced details. It can be downloaded or attached to the quote in one click.
Installation file: plan with numbered objects, installation list, wall-by-wall elevations, with no prices at all. It is intended for the installers.
Elevations: each wall can be viewed on screen, from the front, with the objects standing against it and their height from the floor.
Export of the plan in SVG format, at a scale of 1:50, for reuse in drawing software.
A plan's documents (PDF, captures, panorama, imported background) are served only by the module, after checking the user's rights.
21. Purchasing
Placing orders without re-entering the project.
The purchasing page groups the products of the plan by supplier, based on the supplier purchase prices held in Dolibarr.
One click creates the native supplier order as a draft, linked to the plan.
A draft order already created for the same supplier is not duplicated: the module tells you so.
22. The electrical file with SchémaConcept
With two companion modules, Bridge Concept3D / SchémaConcept and SchémaConcept, the layout plan becomes an electrical file.
From the kitchen or office you have drawn, the bridge works out, room by room, the sockets, lighting, network and alarm points required. Each point is explained in the "Why this point" column.
The "Plan analysis" tab sums up the rooms, points, circuits, supply rating and main circuit breaker.
In one click, SchémaConcept receives the diagram, the distribution board and its circuits, the single-line diagram and a layout plan at 1:50 scale. What you have drawn yourself is never changed.
The layout plan numbers the points in colour by domain, with a legend and layers; it can be downloaded as SVG or PDF.
In SchémaConcept, the distribution board is shown as rows of devices. Built-in checks flag unprotected circuits, insufficient spare space in the board and inconsistencies before you hand over the quote.
Each device is a Dolibarr product: the diagram's bill of materials is priced live, with the total excluding tax and the margin, and becomes a Dolibarr quote in one click.
On the plan card, the "Electrical" tab shows the link and its status: "Synchronised", or "Out of sync" when a change is still to be sent.
The rules follow a country standards profile, with its sources: they are proposals to be validated by a qualified professional, not a certificate of compliance.
23. Permissions and setup
Who does what, and where the module is set up.
Five separate permissions: read the plans, create and modify them, validate them (generate the quote), delete them, see the margin and the purchase prices.
Purchase prices and margin are sent only to users allowed to see them, on screen as well as in exchanges with the browser.
External accounts (customers logged into Dolibarr) never have access to plans or their documents, even if a module permission was granted to them by mistake.
Settings: default dimensions of a plan, number of products shown in the catalogue, default values of the editor.
Installation rules and usage profiles are managed in their own setup tabs.
The “Companion modules” tab presents the KSIDol modules that complement Concept3D — quote signature, Bridge Concept3D / SchémaConcept — with their status on your installation.
Requirements: Dolibarr 18 to 24, PHP 8.1 or later, with the Third Parties, Products and Proposals modules enabled.
24. Links with Dolibarr
The module does not work in isolation: it integrates with the native building blocks of Dolibarr.
Third parties : each plan is linked to a Dolibarr customer, chosen at creation.
Products and services : the configurator's catalogue is Dolibarr's own, with its photos, categories, dimensions, units and prices. A "3D Object" tab is added to the product card.
Tags/categories : they filter the catalogue and designate the products targeted by an installation rule or a usage profile.
Product variants : the finishes offered when placing a product are the native variants; without the Product Variants module, the rest of the configurator works in exactly the same way.
Commercial proposals (quotes) : validating the plan creates a native quote as a draft; the plan PDF is attached to its documents and the quote card links back to the plan.
Projects : the project chosen on the plan is passed on to the quote.
Invoices : a plan whose quote is signed gives access to the creation of the native invoice or deposit invoice.
Purchase orders (supplier orders) : the purchases of the plan become native supplier orders as drafts, linked to the plan in the related objects.
Purchase prices and margins : the purchase price of the lines comes from the supplier prices in Dolibarr and feeds the margin of the quote.
User permissions : the five permissions of the module are managed on the user and group cards.
Cookies
KSIDol uses cookies required for the cart, login and payment. Non-essential cookies remain disabled until you accept them.
Hello, I am KSIAssistantIA, the assistant built into your management software. For example, I can give you a summary of how your business is doing. Would you like to see what I can do?