KSI: Mise à jour des liens officiels : vidéo, fiche KSIDol, démo et notice

2026-10-19T16:06:49Z

Mise à jour des liens officiels : vidéo, fiche KSIDol, démo et notice

← Older revision		Revision as of 16:06, 19 October 2026
Line 92:		Line 92:

	== Official links ==		== Official links ==
			* Demo video : [https://youtu.be/rGmtjyqEJCE TempsSupport — demo (YouTube)]
	* ~~Demonstration~~ video: [https://youtu.be/rGmtjyqEJCE TempsSupport — demo (YouTube)]		* Module page : [https://www.ksidol.io/en/modules/detail?module=main_module_tempssupport TempsSupport on KSIDol]
	* ~~Shop~~: [https://www.ksidol.io KSIDol~~.io~~]		* Online demo : [https://www.ksidol.io/t/demo-erp/custom/tempssupport/list.php?mainmenu=tempssupport TempsSupport — open the demo]
	* ~~Module page~~: [https://www.ksidol.io/en/~~modules~~/~~detail~~?~~module~~=~~main_module_tempssupport~~ ksidol.io/en]		* Module user guide : [https://www.ksidol.io/notices/ksidol_notice_en/tempssupport.html TempsSupport — read the guide]
	* K.S.I publisher page on DoliStore: [https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search= K.S.I modules on DoliStore]		* K.S.I publisher page on DoliStore: [https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search= K.S.I modules on DoliStore]

KSI: Création fiche module TempsSupport (KSIDol)

2026-07-26T07:41:01Z

Création fiche module TempsSupport (KSIDol)

New page

[[Category:Complementary modules]]
[[Category:K.S.I]]
[[Category:CRM]]
[[Category:Interface]]

{{TemplateDocDev}}
{{TemplateDocUtil}}

<div style="border:1px solid #d7e3f4; border-radius:14px; padding:22px; margin:12px 0 22px 0; background:linear-gradient(135deg,#f6faff,#ffffff); box-shadow:0 2px 10px rgba(20,60,110,0.08);">
<div style="font-size:28px; font-weight:700; color:#17365d; margin-bottom:8px;">TempsSupport for Dolibarr</div>
<div style="font-size:18px; color:#345; margin-bottom:14px;">Track phone-support time per customer and bill it directly in Dolibarr, monthly allowance included</div>
<div style="display:flex; flex-wrap:wrap; gap:8px; margin-top:10px;">
<span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Call timer</span>
<span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Phone support</span>
<span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Floating headset button</span>
<span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Time billing</span>
<span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Monthly allowance</span>
<span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Third-party tab</span>
<span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Per-customer KPIs</span>
</div>
</div>

== Overview ==

'''TempsSupport''' is an external module for '''Dolibarr ERP/CRM''' (publisher KSIDol) that adds phone-support time tracking, from the call to the invoice.

A floating button (headset icon) is present on every page: with one click you start a timer linked to a customer, describe the call subject, then save the time. Each third-party record gets a tab listing its times and letting you bill them, individually or in bulk, with a '''monthly allowance included'''.

The module does not modify any Dolibarr core file.

== Publisher and support ==

{| class="wikitable" style="width:100%; border-collapse:collapse;"
! style="width:24%; background:#f0f6ff;" | Item
! style="background:#f0f6ff;" | Information
|-
| '''Publisher'''
| '''KSIDol'''
|-
| '''Specialty'''
| Dolibarr integrator
|-
| '''Services'''
| Custom development, SaaS hosting, Dolibarr support
|-
| '''Website'''
| https://www.ksidol.io
|-
| '''Support'''
| support@ksidol.io
|-
| '''Dolistore modules'''
| https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search=
|}

== Module information ==

{| class="wikitable" style="width:100%;"
! style="width:24%; background:#f7f7f7;" | Information
! style="background:#f7f7f7;" | Detail
|-
| '''Module name'''
| TempsSupport
|-
| '''Main use'''
| Track phone-support time per customer and bill it
|-
| '''Type'''
| Dolibarr external module
|-
| '''Family'''
| CRM / Customer relationship
|-
| '''Documented version'''
| 24.0.0
|-
| '''Dolibarr compatibility'''
| Dolibarr 18.0 to 24.x
|-
| '''PHP compatibility'''
| PHP 7.4 or higher
|-
| '''Dolibarr core modification'''
| No
|-
| '''License'''
| GNU GPLv3
|-
| '''Available languages'''
| French, English, German, Spanish, Italian
|}

== Official links ==

* Demonstration video: [https://youtu.be/rGmtjyqEJCE TempsSupport — demo (YouTube)]
* Shop: [https://www.ksidol.io KSIDol.io]
* Module page: [https://www.ksidol.io/en/modules/detail?module=main_module_tempssupport ksidol.io/en]
* K.S.I publisher page on DoliStore: [https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search= K.S.I modules on DoliStore]

== Module goals ==

Let service providers, software publishers, after-sales and hotlines '''precisely measure''' the time spent on the phone with each customer, without an external tool, then turn that time into an invoice:

* time each call (inbound or outbound) from any Dolibarr page;
* attach the time to the right customer and subject;
* bill the time individually or in bulk, with rounding and a minimum duration;
* handle '''flat-rate''' support offers (minutes included per month, billing only the overage).

== Who is it for? ==

* '''Service providers and software publishers''' offering billable phone support.
* '''After-sales and hotlines''' that want to track and value phone time.
* Any organisation offering '''flat-rate support''' with a monthly included volume of minutes.

== Main features ==

* '''Floating headset button''': present on every page, whatever the theme (eldy, moderntemplate), without core modification; can be enabled/disabled in the configuration.
* '''Call timer''': search (or create) a third party, choose the direction (inbound / outbound), start the timer, enter the subject, then "End call". The timer persists while you navigate (browser local storage).
* '''Record''': each call becomes a time entry (reference, third party, contact, direction, start/end, actual duration, billed duration, subject, status).
* '''Third-party tab''': list of the customer's times (actual and billed duration) with Bill / Edit / Do not bill / Make billable actions, and checkboxes for bulk billing.
* '''Billing''': creates a draft invoice with one line per time entry (quantity in hours); the price comes from the configured product/service or a fallback hourly rate. Rounding (step) and a minimum duration are applied to the billed duration.
* '''Per-third-party KPIs''': number of recorded times, cumulative actual duration and time to bill.

== Monthly allowance included ==

Each third party can have a volume of '''minutes included per month''' (or a default module allowance). The tracking shows the '''used''', the '''remaining''' and the '''overage''':

* the time covered by the allowance is marked "Included" and '''generates no invoice''';
* the overage is billed at the '''additional-hour price''' (per-third-party extrafield).

== Menus ==

The module adds a main menu '''Support Time''' with:

* '''Times list''' — all recorded times
* '''To bill''' — times with status "To bill"
* '''Configuration''' — module settings

A '''Support Time''' tab is also added to the third-party record.

== Configuration ==

From Home → Setup → Modules → Support Time:

* show the floating button (yes/no);
* billing product/service (reference on invoice lines);
* use the product price (yes/no);
* fallback hourly rate (if the product has no price);
* billed-duration rounding (minutes; 0 = actual duration);
* minimum billed duration (minutes; 0 = none);
* default support allowance / month (minutes).

Two extrafields are added on the third-party record: '''included allowance / month''' and '''additional-hour price'''.

== User permissions ==

The module defines five permissions:

* '''Read''' the support times (read)
* '''Create / edit''' the support times (write)
* '''Bill''' the support times (bill)
* '''Delete''' the support times (delete)
* '''Configure''' the module (config)

== Daily use ==

# The phone rings: click the headset button.
# Search the customer, direction "Inbound call", "Start timer".
# During the call, browse Dolibarr freely — the timer keeps running.
# Enter the subject, "End call": the time is recorded.
# At month end, the customer's "Support Time" tab: select the times, "Bill the selection".
# The draft invoice is created (one line per call); time covered by the allowance is marked "Included".

== Technical note ==

* Table: <code>llx_tempssupport_ticket</code> (one record per support time).
* Assets loaded on every page via <code>module_parts</code> (main hook, module CSS and JS).
* Timer persistence on the browser side (local storage).
* Dolibarr standards respected: hooks, permissions, CSRF tokens, <code>GETPOST</code>, escaping.
* '''No Dolibarr core modification.'''

== Installation ==

# Unzip the archive to get a <code>tempssupport/</code> folder.
# Copy it into <code>htdocs/custom/</code> of your Dolibarr.
# Check write permissions on <code>documents/tempssupport/</code>.
# Enable the module from Home → Setup → Modules/Applications.
# On activation, the required table and extrafields are created automatically.

== Update ==

# Replace the <code>htdocs/custom/tempssupport/</code> folder with the new version.
# Reload an administration page: the schema (columns, extrafields) is checked and completed automatically, idempotently.
# No existing data is deleted by the update.

== Troubleshooting ==

* '''The button does not appear''': check that the "Show floating button" option is set to Yes and that the user has read permission.
* '''Nothing to bill''': times must have the "To bill" status and belong to the same third party; a time fully covered by the allowance produces no line.
* '''Zero price on the invoice''': set a price on the product/service or a fallback hourly rate.

== See also ==

* '''KSIDol Signature Terminal''': signing of all native Dolibarr records, compatible with every KSIDol module.
* Compatibility: Dolibarr 18.0 to 24.x — PHP 7.4+ — GPLv3 license — Publisher: KSIDol.

== Summary ==

TempsSupport times your customers' phone-support from any Dolibarr page (headset button), records it per third party and turns it into an invoice — individually or in bulk, with rounding, a minimum duration and a monthly included allowance (billing only the overage).

Support time tracking and billing for Dolibarr - Revision history

KSI: Mise à jour des liens officiels : vidéo, fiche KSIDol, démo et notice

KSI: Création fiche module TempsSupport (KSIDol)