Skip to content

Release history

Live Helper Chat releases

Live Support chat for your website.

All releases

21 shown

Review required
4.86v Breaking risk
Auth

Performance dashboard + auth hardening

4.85v Security relevant
Security fixes
  • Chat operation permissions now require explicit read/write access checks; additional permission hardening applied across related flows.
Notable features
  • CSP parser integration with policy exposure hardening
  • Widget-theme option to disable voice messages
  • DeepL model and formality options in translation workflow
Full changelog
  1. Notable changes since 4.84v

    • Security and access control: tightened chat operation permissions by requiring proper read/write access checks; additional permission hardening was applied across related flows.
    • CSP and policy handling: completed CSP parser integration and follow-up fixes, including policy exposure hardening and parser/library alignment.
    • Voice messaging and widget UX: improved voice-message flow and UX, updated voice app behavior, kept cursor focus on desktop, and added a widget-theme option to disable voice messages.
    • Translation workflow: improved automatic translation reliability, added DeepL model/formality options, enhanced metadata/error handling, and refined start/stop and old-message translation flows.
    • Analytics and timing metrics: improved chat duration/response-time calculations, participant timing accounting, and operator duration output in reports.
    • REST API and diagnostics: added optional custom REST API messages, improved exception visibility/traceback details, and enabled direct log viewing from back office.
    • Invitations and online-hours logic: enhanced invitation alias/profile handling and improved overlapping online-hours period calculations.
    • UI/translations/dependencies: updated translations, refreshed JS dependencies (including html-react-parser migration), and applied multiple package/security updates.
    • Misc fixes: delivered issue-specific fixes and regressions cleanup (including #2378, #2379, #2382), plus release workflow updates.
  2. Summary

    • This release focuses on security hardening, CSP maturity, and operator productivity, while also improving voice messaging UX and translation automation quality.
    • It also improves chat/mail timing metrics and diagnostics, with additional stability updates across UI, dependencies, and release automation.

No new DB migration script required for this release.

Full Changelog: https://github.com/LiveHelperChat/livehelperchat/compare/4.84v...4.85v

4.84v New feature
⚠ Upgrade required
  • Execute `doc/update_db/update_351.sql` as part of the upgrade procedure
  • New schema updates and tables added; ensure database migration runs successfully
Security fixes
  • Enhanced uploaded file validation to prevent unsafe file execution (file preview upload flow)
Notable features
  • Expanded widget theme customization options including color controls, applied to offline form
  • Added assignment notification preferences (assigned pending chats vs all pending chats) and quick auto‑assignment action
  • Strengthened uploaded file verification with expanded MIME type handling
Full changelog
  1. Notable changes since 4.83v

    • REST API and bot workflow: improved REST API trigger execution and request body handling with attachment support; added skipped-body debug preview; enhanced chat locking behavior for streaming and chunked responses while preserving typing indicators.
    • Widget and UI: expanded widget theme customization options (including color controls), applied theme colors to offline form, improved message delivery indicator styling, fixed height adjustments and zoom/icon interaction issues, and added support for custom nick from admin themes.
    • Notifications and operator workflow: added assignment notification preferences (assigned pending chats vs all pending chats), quick action for auto-assignment, and persistent disabling of mobile notifications.
    • Chat filters and analytics: added participant filters to chat search, improved filters and restored pagination behavior, added participant-aware export enhancements, and introduced average chat duration by agent/participant.
    • File validation and security hardening: expanded MIME type handling for common file types and strengthened uploaded file verification (including file preview upload flow).
    • Translation and UX polish: improved translation error handling and transaction flow, added operator notice for active chat translation state, and updated translations across modules.
    • Core/codebase maintenance: added new tables and schema updates, improved error/log reporting and timing diagnostics (render and DB connection timing), and modernized PHP code style in core files.
  2. Summary

    • This release focuses on reliability and operator experience: stronger REST API/bot handling, better widget customization and messaging UX, richer notification controls, and improved chat search/export analytics.
    • It also includes security-oriented file validation improvements, translation workflow refinements, and core maintenance updates for better observability and long-term stability.

execute doc/update_db/update_351.sql for update

What's Changed

  • Msg fix by @remdex in https://github.com/LiveHelperChat/livehelperchat/pull/2370
  • refactor: modernize syntax and simplify code by @NullSablex in https://github.com/LiveHelperChat/livehelperchat/pull/2371
  • 4.84v by @remdex in https://github.com/LiveHelperChat/livehelperchat/pull/2374

Full Changelog: https://github.com/LiveHelperChat/livehelperchat/compare/4.83v...4.84v

4.83v Bug fix
⚠ Upgrade required
  • Run `doc/update_db/update_350.sql` to apply database migration for this release
Notable features
  • Chat list sorting options for highest/lowest message count with validation warning for date range >31 days
  • Webhook debug mode in `processEvent` and new validation conditions `notempty` and `in_list`
  • Multi-select dropdowns now include "Select all" and "Unselect all" buttons
Full changelog
  1. Notable changes since 4.82v

    • Chat list sorting: added sort options for highest and lowest message count in chat lists; a validation warning is shown when sorting by message count without a date range of 31 days or less.
    • Webhooks: debug mode support added to processEvent in both chat and mail conversation continuous webhook classes; new validation conditions notempty and in_list; improved error handling and logging; webhook form updated with chat ID testing and improved button styling; test pattern module enhanced with webhook ID validation.
    • Dropdown: "Select all" and "Unselect all" buttons added to multi-select dropdowns across the back-office; dropdown plugin and render helper updated accordingly.
    • Subject filter: subject filter conditions added to the chat list search panel and mail conversation search panel; department user dep logic enhanced.
    • Widget: bumped to version 272; improved screenAttributesUpdate height/width calculations for better responsiveness across screen sizes; wrapper now passes its version to the API; fixed proper termination in wrapper source.
    • Canned messages: fixed auto-uppercase breaking text input in the new rich-text editor (LHCEditor).
    • REST API: fixed authentication validator regression.
    • Chat core: added support for dashes in chat handling logic.
    • Templates: minor fixes in chat lists template and survey fill-widget template.
  2. Summary

    • This release improves chat list usability with message count sorting, strengthens webhook debugging with debug mode and new validation conditions, and enhances multi-select dropdowns with select-all/unselect-all controls.
    • Widget responsiveness and wrapper version reporting are improved; canned message auto-uppercase and REST API auth issues are resolved.

execute doc/update_db/update_350.sql for update

Full Changelog: https://github.com/LiveHelperChat/livehelperchat/compare/4.82v...4.83v

4.82v Security relevant
⚠ Upgrade required
  • Run `execute doc/update_db/update_349.sql` after upgrading to apply required database migration.
Security fixes
  • L01 – SSRF via incoming webhook image download (CWE-918)
  • L06 – Mass assignment in REST API file PUT leading to arbitrary file read (CWE-915, CWE-22)
  • L11 – Stored XSS via Content‑Type spoofing in file upload (CWE-79, CWE-345)
Notable features
  • Widget expand mode with configurable width/height ratios
  • Chat search/statistics filters by operator, visitor, bot message counts and ID range
  • Operator quick‑action toggle for chat tab visibility
Full changelog
  1. Notable changes since 4.81v

    • Security/file handling: enhanced MIME type validation across file download endpoints (downloadfile.php, inlinedownload.php, REST API file.php); MIME type constants added in mail conversation parser; all operator/visitor uploads validated against var folder path; resolved security issues L01, L02, L04, L05, L06, L11, L13.
    • Widget: added expand mode with configurable width/height ratios and new shrink_text/expand_text UI fields; widget communication updated to include user session prefill variables in sent messages; fixed reloadWidget function; updated wrapper version.
    • Chat search/statistics: added message count filters (operators, visitors, bots) to search panel and statistics tabs; added total messages count input field; added search by message ID range.
    • Chat tab visibility: operators can toggle chat tab visibility (show/hide chat tabs) via quick actions in user settings.
    • User settings: added auto-accept chats option and alert preference for transferred chats.
    • Variables/prefill: support for passing custom back-office vars as lhc_var variables; encrypted prefilled variables always applied; variable only set when replaceable variable is non-empty; proactive invitations now update vars when custom vars are passed.
    • Theme/translations: widget theme translate method accepts user context; REST API modules (checkchatstatus, getinvitation, initchat, onlinesettings, settings) use user context for theme translations; multilanguage support for custom fields; fetchByVid includes caching option.
    • Canned messages: refactored retrieval with getCannedMessages method; added auto_send filter and ignore_subjects parameter.
    • Extensions: support for extensions to contribute custom side-menu items.
    • Configuration: folder/directory write-permission checks added to the configuration page with per-directory success/error indicators.
    • Bot: support for background workers in REST API bot action; improved bot detection filtering.
    • Message history: previous-message loading always uses all messages when the page limit is not reached; safe inclusion of all chat messages.
  2. Summary

    • This release strengthens file handling security with MIME type validation, file path checks, and resolves multiple L-series security issues.
    • Operator UX improvements include widget expand mode, chat tab visibility toggles, and richer user settings (auto-accept, transfer alerts).
    • Search and statistics gain new message count filters; extensions gain custom side-menu support; theme translations now respect user context.
  3. Contributors

  • L01: SSRF via incoming webhook image download (CWE-918)
  • L06: Mass assignment in REST API file PUT leading to arbitrary file read (CWE-915, CWE-22)
  • L11: Stored XSS via Content-Type spoofing in file upload (CWE-79, CWE-345)
  • L13: Unsafe deserialization in configuration loader (CWE-502)

Vulnerability Researcher: Pedro J. Núñez-Cacho Fuentes (https://blogs.tunelko.com)

execute doc/update_db/update_349.sql for update

Full Changelog: https://github.com/LiveHelperChat/livehelperchat/compare/4.81v...4.82v

4.81v Breaking risk
⚠ Upgrade required
  • Run the migration script `doc/update_db/update_348.sql` to apply database changes for one-time chat invitations.
  • PHP 8.5 compatibility issues resolved; ensure server runs PHP 8.5 or later.
Notable features
  • One-time proactive chat invitation tracking via `lh_abstract_proactive_chat_invitation_one_time` table
  • Provider‑based CAPTCHA support with Google reCAPTCHA v3 and Cloudflare Turnstile using shared validation layer (`CaptchaValidator`, `erLhcoreClassUserValidator`)
  • Translation workflow enhancements: automatic translation UX, operator/visitor message differentiation, skipping already‑translated messages, updated configuration UI
Full changelog
  1. Notable changes since 4.80v

    • One-time proactive chat invitations: new DB table lh_abstract_proactive_chat_invitation_one_time tracks which visitors have already seen an invitation, preventing repeat displays.
    • Proactive invitations: cleanup logic added for stale one-time invitation records; widget now records when a one-time invitation is shown; edit module enhanced with custom actions for proactive invitations.
    • Captcha: added provider-based captcha support — Google reCAPTCHA v3 and Cloudflare Turnstile are now both supported with a shared validation layer (CaptchaValidator, erLhcoreClassUserValidator).
    • Captcha admin UI: provider selector with provider-specific field sections; shared key labels across providers; CSRF redirect fix.
    • Translation system: UX improvements for automatic translations; operator and visitor message translation differentiated; messages with existing translations are now skipped; translation configuration UI updated.
    • Bot/Widget: custom HTML buttons and bot buttons are now disabled when a form is in progress status; alert messages added; placeholder for name field in widget start form.
    • Editor: fixed infinite loop issue in the new rich-text editor (LHCEditor).
    • Dashboard: removed legacy old dashboard; cleaned up related options and switch logic.
    • Security/permissions: added permission access checks in block user, hold action, transfer chat, and chat widget closed flows.
    • PHP 8.5 compatibility: resolved deprecation and compatibility issues.
    • Translations: updated translation catalogs including new captcha-related and translation-workflow keys.
  2. Summary

    • This release introduces one-time proactive chat invitations, a flexible multi-provider captcha system, and several translation workflow improvements.
    • Includes editor stability fixes, dashboard cleanup, PHP 8.5 compatibility, and stricter permission checks across chat action endpoints.

execute doc/update_db/update_348.sql for update

What's Changed

  • feat(captcha): add provider-based captcha support (Google v3 + Cloudflare Turnstile) by @NullSablex in https://github.com/LiveHelperChat/livehelperchat/pull/2364

New Contributors

  • @NullSablex made their first contribution in https://github.com/LiveHelperChat/livehelperchat/pull/2364

Full Changelog: https://github.com/LiveHelperChat/livehelperchat/compare/4.80v...4.81v

4.80v New feature
⚠ Upgrade required
  • Run doc/update_db/update_347.sql to apply required database schema update
Notable features
  • Language-specific warning messages for ghosting/masking rules
  • Redesigned back-office editor with multilingual tabs and per-language fields
  • Runtime masking now resolves warnings by chat locale (full and short fallback)
Full changelog
  1. Notable changes since 4.79v

    • Message content protection: added language-specific warning message support for ghosting/masking rules.
    • UI (back office): redesigned message protection warning editor with multilingual tabs and per-language message fields.
    • Runtime masking: warning text can now be translated by chat locale (full locale and short locale fallback).
    • Data/model layer: added languages persistence support in lh_abstract_msg_protection model/POS mapping.
    • Frontend cleanup: simplified multilingual tab content rendering in Svelte component used by admin forms.
  2. Summary

    • This release extends message protection rules with localized warning messages and wires the full stack (DB, model, UI, and runtime locale resolution).

execute doc/update_db/update_347.sql for update

Full Changelog: https://github.com/LiveHelperChat/livehelperchat/compare/4.79v...4.80v

4.79v New feature
⚠ Upgrade required
  • Execute `doc/update_db/update_346.sql` for database schema update.
Notable features
  • Added subject filter options (Name, Pinned, Internal) in abstract/back office
  • Implemented generic abstract object cloning support and user clone action in user list
  • Expanded bot & proactive invitation condition operators to include `(` and `||` and added more checks
Full changelog
  1. Notable changes since 4.78v

    • Abstract/Back office: added subject filter options (Name, Pinned, Internal) and corrected autoresponder filter form routing.
    • Cloning: added generic abstract object cloning support and user clone action in user list.
    • Bot & proactive invitations: expanded condition operator support (( and ||) and added more proactive invitation condition checks.
    • Mail conversations: improved reliability of ticket fetch/send flow, better scheduled-state handling, and replaceable variable support for send e-mail templates.
    • Chat/Webhooks: enhanced chat state tracking and logging across chat validators, dispatchers, and webhook handlers.
    • Forms & UI: added reusable custom form args, extension-specific login sizing, theme existence checks, online users attribute fixes, and widget cache/version updates.
    • Translations: updated translation packs, including Japanese language/default translation updates.
  2. Summary

    • This release focuses on reliability improvements in mail/chat workflows and stronger bot/proactive condition handling.
    • It also includes operator-facing UX improvements (filtering and cloning) and broad translation/frontend update refreshes.

execute doc/update_db/update_346.sql for update

Full Changelog: https://github.com/LiveHelperChat/livehelperchat/compare/4.78v...4.79v

4.78v New feature
⚠ Upgrade required
  • Run the migration script `doc/update_db/update_345.sql` to update the database schema.
Notable features
  • Bot: support for bot short name.
  • Message masking: mask last message from visitor.
  • Webhooks/Conditions: additional comparison variables and accept all params for condition checks.
Full changelog
  1. Notable changes since 4.77v

    • Bot: support for bot short name.
    • Message masking: mask last message from visitor.
    • Webhooks/Conditions: support additional comparison variables and accept all params for condition checks.
    • Events: included more information for main chat attributes change event.
    • Debugging: added debug message handling inside chat messages.
    • Guardrails: added whitelist support for phone guardrails.
    • Misc: small typo fixes.
  2. Summary

    • Improvements across bot, webhooks, and message masking to increase reliability and observability.
    • Several small bug fixes and developer-facing debug improvements.

execute doc/update_db/update_345.sql for update

Full Changelog: https://github.com/LiveHelperChat/livehelperchat/compare/4.77v...4.78v

4.77v Bug fix
Notable features
  • Auto-Submitted header added to mail actions
  • Chat messages preview modal with backend support
  • Chat widget: improved iframe integration, scroll-to-last-message, internal refactor
Full changelog
  1. Features

    • Add Auto-Submitted header to mail actions (automatic mail handling improvements).
    • Chat messages preview modal with backend support for message previews.
    • Chat widget updates: improved integration with third-party iframes, scroll-to-last-message on show, and refactor of widget internals.
    • Migration and build updates: Svelte 5 migration, Node 22 (bot/node) updates, and package upgrades.
  2. Fixes

    • Do not mark our own responses as undelivered (prevents false undelivered status).
    • Ignore auto-submitted e-mails as new to avoid duplicate imports.
    • Fixes for issues reported (e.g. #2359, #2357) and improved error logging (#2347).
    • Various UI/UX fixes: React parsing issue, height flickering, trigger body object support, and trimmed/encoded URLs.
    • Mail handling: do not set custom from-email unless explicitly provided; set custom recipient handling improvements.
  3. Performance & Reliability

    • Avoid loading/fetching message bodies when not required (reduce unnecessary DB/IO work).
    • Use static version cache for assets and additional cache improvements.
    • Check and respect rfc822 body presence before processing.
  4. Compatibility & UX

    • Support for older browsers and related compatibility fallbacks.
    • UX improvements for canned messages dropdown and related interactions.
  5. Chore/Dependencies

    • Dependency and package updates across frontend and backend (React/Node/bot tooling and other packages).
    • Miscellaneous maintenance: hashed payload handling, migration tweaks, and merge/cleanup commits.

execute doc/update_db/update_344.sql for update

What's Changed

Full Changelog: https://github.com/LiveHelperChat/livehelperchat/compare/4.76v...4.77v

4.76v New feature
Security fixes
  • Message ghosting hides sensitive information from operators lacking permission to see full messages when guardrails are enabled
Notable features
  • Pending import functionality for mail import retries with automatic retry mechanism and `lhc_mailconv_pending_import` table
  • `wtop` option for widget position from top spacing control enhancing layout flexibility
  • Conditions support for maintenance mode in pre-chat forms
Full changelog

What's Changed

  1. Mail Conversation System Enhancements

    • Added pending import functionality for mail import retries with automatic retry mechanism
    • New lhc_mailconv_pending_import table for tracking failed mail imports
    • Manual import interface for retrying failed email imports
    • Improved IMAP retry logic for handling temporary failures
  2. Message Masking and Security

    • Added message ghosting for sensitive information protection when guardrails are enabled
    • Operators without permission to see full messages will not see just-sent messages
    • Enhanced regex rules with optional name field and optional replacement variable
    • Additional masking options for PII protection
    • Improved guardrails validation for sensitive information
  3. Widget Theme Configuration

    • Added wtop option for widget position from top spacing control
    • Enhanced widget positioning options for better layout flexibility
  4. Tab Navigation and UX

    • Improved tab state persistence for chats and mails
    • Direct API implementation for remembering tab states
    • Enhanced tab navigation across multiple interfaces
  5. Pre-chat Form Conditions

    • Added conditions support for maintenance mode in pre-chat forms
    • Enhanced validator logic for conditional maintenance mode display
  6. Developer Documentation

    • Comprehensive copilot instructions reorganization
    • Added detailed integration points documentation
    • New data flows, testing strategies, and security model documentation
    • Domain-specific guides for API, auth, bot, caching, config, data-layer, departments, events, extensions, routing, UI, and users
  7. Bug Fixes and Improvements

    • Improved error handling for robustness and better user experience
    • Enhanced cache management and clearing functionality
    • Various sync and performance improvements

Full Changelog: https://github.com/LiveHelperChat/livehelperchat/compare/4.75v...4.76v

4.75v Breaking risk
⚠ Upgrade required
  • Run execute doc/update_db/update_342.sql for database update before upgrading
Notable features
  • Added data-remember attribute to tab navigation elements for state persistence
  • Implemented Safari browser support for tab navigation
  • Enhanced replaceable variables UI with remembered tabs functionality
Full changelog
  1. Tab Navigation and UX Improvements

    • Added data-remember attribute to tab navigation elements across multiple templates for better state persistence
    • Implemented Safari browser support for tab navigation
    • Enhanced replaceable variables UI with remembered tabs functionality
  2. Bot System Enhancements

    • Added 'Keep chat locked' option in bot action text to maintain chat lock from visitor messages
    • Refactored condition handling in bot workflow to support JSON parsing for dynamic conditions
    • Enhanced attribute filtering in bot action text with improved non-empty value processing
    • Updated CURL building UI for better usability
  3. Mail Conversation System

    • Added signature fetching functionality with AJAX endpoint for improved email handling
    • Added button to append fetched signature to email templates
    • Enhanced input field layout for better usability and accessibility
  4. Bot Conditions Form

    • Added datalist options for filter fields in conditions form with predefined options
    • Options include Chat ID, Status, Department ID, User ID, Email, Phone, Nickname, and Country Code
  5. System and Configuration

    • Added ability to clear cache from command line
    • Implemented opcache cache clearing functionality
    • Added fallback if default config file is not found
    • Inform operator when external operator is writing messages
  6. Performance Optimizations

    • Various performance optimizations in core components
    • Improved command title handling as argument
    • Enhanced proper checking mechanisms
  7. Bug Fixes and Improvements

    • Removed unnecessary variable declarations
    • Various sync improvements

execute doc/update_db/update_342.sql for update

What's Changed

Full Changelog: https://github.com/LiveHelperChat/livehelperchat/compare/4.74v...4.75v

4.74v Breaking risk
Notable features
  • Option to keep chat locked from visitor via bot actions
  • Override back button option for widget offline mode
  • Enhanced audit logging capabilities for mail conversations
Full changelog
  1. Bot System and Actions Enhancements

    • Added option to keep chat locked from visitor via bot actions
    • Enhanced variable replacement logic in bot actions with custom arguments handling
    • Implemented option to remove chat_variables variable through bot commands
    • Improved command action to update only required fields for better performance
    • Enhanced text actions with advanced variable replacement capabilities
    • Fixed masking message in REST API that sometimes broke JSON body structure
    • Added logging for first response in streaming mode for REST API actions
    • Added use cases modal and validation for bots with comprehensive documentation
    • Improved bot name display in REST API use cases
    • Added modal for REST API use cases with dynamic content
  2. Widget and Interface Improvements

    • Added override back button option for widget offline mode
    • Updated widget logic and survey redirect handling for offline scenarios
    • Improved image sizing in widget interface
    • Removed default colors from widget theme configuration
    • Fixed scroll behavior on mobile devices in popup mode
    • Enhanced offline chat handling with better redirect logic
  3. Mail Conversation System

    • Enhanced audit logging capabilities for mail conversations
    • Added merge conversation audit logging
    • Improved send email audit tracking
    • Added option to set reply-to email only to mailbox
    • Fixed UI elements in mail conversation templates
  4. Proactive Invitations and Auto Responder

    • Fixed auto responder display logic to ensure proper handling of empty values
    • Enhanced auto responder display with improved formatting
    • Added proactive invitation and auto responder templates to chat interface
    • Improved webhook link formatting in bot forms
    • Activity period now applies to all types of invitations
    • Added explanatory text that limit numbers are inclusive
  5. User Interface and UX Improvements

    • Added explanatory notices for inclusive limit numbers in department forms
    • Enhanced chat information display with better template organization
    • Improved spacing and layout in various templates
    • Updated default translations with new strings
  6. System and Configuration

    • Updated environment variable handling in settings
    • Improved system variable checking in core components
    • Fixed null handling in cronjob/test mode
    • Updated .gitignore configuration
    • Added GitHub workflow for triggering Laravel tests
    • Removed editor-specific settings from repository
  7. Statistics and Reporting

    • Included user with id 0 in default user filter for statistics
    • Enhanced user filtering for edge cases
  8. Bug Fixes and Improvements

    • Fixed missing column reference in user department management
    • Fixed transfer to human action to update only relevant attributes
    • Various UI fixes and spacing adjustments
    • Improved template consistency across modules

This time there is no database update. Make sure you replace all necessary files and run

php composer.phar dump-autoload -o -a

or

php composer.phar install

Full Changelog: https://github.com/LiveHelperChat/livehelperchat/compare/4.73v...4.74v

4.73v Maintenance
⚠ Upgrade required
  • Run `doc/update_db/update_340.sql` to perform the required database update.
Full changelog
  1. Only priority field was missed for grouping operation and disabled user flow.

execute doc/update_db/update_340.sql for update

What's Changed

Full Changelog: https://github.com/LiveHelperChat/livehelperchat/compare/4.72v...4.73v

4.72v Breaking risk
⚠ Upgrade required
  • Run doc/update_db/update_340.sql after upgrading to satisfy the new minimum database version requirement (60).
Breaking changes
  • Database version limit validation enforced: minimum required version is now 60
Notable features
  • 'only_priority' operator assignment feature to receive chats of specific priority levels
  • Per-session invitation support for all invitation types with automatic reset for returning visitors
  • Mathematical parsing in bot conditions and {rnumber} random‑number variable
Full changelog
  1. Operator Assignment and Priority Management

    • Added 'only_priority' feature for operator assignment allowing operators to receive only chats with specific priority levels
    • Enhanced chat priority search functionality in the back office
    • Improved UX for priority display with better visual indicators
    • Added priority filtering to chat search panel
    • Refactored department group saving process with transactions for improved error handling and data integrity
  2. Proactive Invitations System Enhancements

    • Implemented per-session invitation support for all invitation types
    • Enhanced dynamic invitation logic with better state management
    • Improved invitation expiration handling with proper cleanup of invitation_id
    • Added automatic invitation reset for returning visitors
    • Enhanced invitation seen count tracking for better analytics
    • Updated UX for invitation management with better visual feedback
    • Implemented operator message reset when invitation is assigned
    • Added filtering for online operators by their status
  3. Bot System and Conditions

    • Added support for mathematical parsing in bot conditions for complex logic evaluation
    • Implemented {rnumber} variable support for random number generation
    • Enhanced NodeTriggerActionConditions with execution notices and theme fetching
    • Added debugging capabilities for specific trigger output
    • Improved bot message translation handling to assume visitor language
    • Added CSS class support for bot holder elements
    • Enhanced match event handling in bot workflows
    • Added presence checking for variables before processing
  4. Canned Messages and Variables

    • Implemented replaceable variable option to canned messages with change logging
    • Added default replaceable variable method for consistent variable handling
    • Enhanced variable replacement process with better error handling
    • Added support for context-aware variable replacement
  5. Mail Conversation System Improvements

    • Enhanced mail conversation handling and storage management
    • Added option to include mail body in forward e-mail while skipping in reply
    • Implemented copy e-mail function for easier message handling
    • Added option to copy raw message body for debugging
    • Implemented sender address length limitation for better database handling
    • Enhanced search functionality with improved filters
    • Added JSON view for better debugging of mail conversations
    • Implemented option to split messages into separate API calls for mixed content handling
    • Added support for debugging specific messages
    • Improved IMAP connection testing with shorter timeouts
    • Enhanced header value handling and exclusion of debug messages from system logs
    • PDF Checking for suspicious content
  6. Survey and Widget Enhancements

    • Implemented survey styling through widget themes for better customization
    • Enabled CSS cache for survey to improve loading performance
    • Updated widget version to 263 with enhanced cookie handling
    • Added support for subject filter override in surveys
    • Implemented subject title override capability
  7. Chat System Improvements

    • Added bulk fetching for pending messages in chat sync for better performance
    • Implemented whisper message support for private operator notes
    • Added context menu support for previous messages
    • Enhanced UI with various fixes and spacing adjustments
    • Improved online dashboard tab persistence as default view
    • Added reset functionality for online visitors filter on widget filters reset action
    • PDF Checking for suspicious content
  8. User Interface and Experience

    • Implemented editor options for better content management
    • Enhanced form height for improved usability
    • Added minimize text printing functionality
    • Improved spacing and layout adjustments throughout the interface
    • Enhanced auto responder debugging with better object visibility
  9. REST API and Protocol Management

    • Added REST API protocol choosing option for flexible integration
    • Enhanced header value handling and skip functionality
    • Improved error messaging with more precise error descriptions
  10. System Configuration and Permissions

    • Added missing permissions for various operations
    • Enhanced permission checking throughout the system
    • Implemented database version limit validation (minimum 60)
    • Updated database version tracking
  11. Bug Fixes and Improvements

    • Fixed issue #2321 related to system functionality
    • Addressed discussion #2320 with appropriate fixes
    • Improved invitation logic with multiple fixes
    • Enhanced variable presence checking before processing
    • Fixed translation issues for empty messages
    • Corrected method echo behavior in debug output
    • Various UX fixes and improvements throughout the application

execute doc/update_db/update_340.sql for update

What's Changed

Full Changelog: https://github.com/LiveHelperChat/livehelperchat/compare/4.71v...4.72v

4.71v Breaking risk
Breaking changes
  • Requires execution of `doc/update_db/update_339.sql` for schema update
Full changelog
  1. Department Management and User Administration

    • Enhanced department group statistics modal for better oversight of group performance
    • Implemented read-only status toggle for department assignments with visual feedback
    • Added confirmation modal for assigned department edits to prevent accidental changes
    • Improved user department management with transaction handling for data integrity
    • Added utility to cleanup orphan departments and maintain database consistency
    • Enhanced department assignment UI with better UX and simultaneous request prevention
    • Added filtering for users by assigned departments for improved navigation
    • Implemented department limitation handling and cache version updates on changes
    • Added red/green color indicators for operator online status visibility
  2. Bot System and Webhook Improvements

    • Enhanced bot conditions handling with condition identifiers for better query filtering
    • Updated trigger link display to show bot name alongside trigger name for clarity
    • Disabled cache for bot actions and conditions to ensure real-time updates
    • Added 'single_event' support to webhook functionality for better event handling
    • Implemented webhook search panel with filtering capabilities for easier management
    • Added event field to webhook search panel and configuration options
    • Enhanced bot trigger validation with improved button assignment verification
    • Added support for conditional text generation in bot responses
    • Implemented 'sub_source' parameter to sendBotResponse for better tracking
    • Added option to check chat status after REST API calls
  3. File Management and Image Processing

    • Added HEIC image conversion support in verifyaccess.php for modern image formats
    • Implemented file download restrictions and settings to mail conversation module
    • Enhanced image verification process with re-verification features
    • Added modal display for attached image files with better user experience
    • Implemented resize support for form files to optimize storage and performance
    • Added option to download files inline with modal interface
    • Enhanced file extension detection and validation for security
    • Added fallback options when browser cannot render images
    • Implemented option to ignore specific image files during verification
    • Added resize functionality for large mail message screenshots
  4. Chat System and Message Handling

    • Added system message indicating when chat was accepted by operator
    • Enhanced image handling and conditions in the chat system
    • Implemented separate events for messages added via incoming webhooks
    • Added loading spinner overlay to main widget for better user feedback
    • Enhanced form submission experience with spinner on submit button
    • Added option to inherit start chat form settings for consistency
    • Improved message handling with better error display and validation
    • Enhanced chat search capabilities with message ID search functionality
    • Added support for raw file embed syntax in chat messages
    • Implemented conditional text generation for dynamic responses
  5. Security and Performance Improvements

    • Implemented strict locking mechanisms for critical operations
    • Added transaction handling for operator transfers and chat attribute updates
    • Enhanced permission checking in export functions for better security
    • Implemented proper transaction handling for icon operations
    • Added cache clearing mechanisms for improved performance
    • Enhanced error handling for failed file downloads and operations
    • Implemented audit log truncation option from back office
    • Added better logging for auto assignment operations and error tracking
    • Enhanced REST API with option to skip empty body requests
  6. User Interface and Experience Enhancements

    • Enhanced department assignment functionality with improved UI feedback
    • Added 'user-select-none' class to labels for better user experience
    • Implemented lazy load option for widget theme optimization
    • Added argument titles to command execution for better clarity
    • Enhanced form styling with improved input field appearance
    • Added link to documentation for better user guidance
    • Updated React app version with enhanced network failure handling
    • Improved checkbox re-enabling logic after request completion
    • Added nowrap styling for department group lists for better display
  7. System Maintenance and Bug Fixes

    • Fixed issue #2298, #2304, #2305, #2306 addressing various system bugs
    • Updated dependencies and php-imap reference for security and compatibility
    • Enhanced error handling for non-existing users in reports
    • Fixed replacement process and edge case scenarios
    • Improved file type validation and extension setting for known formats
    • Fixed undefined display issues in pending wait time calculations
    • Enhanced aggregation queries by removing duplicates for better performance
    • Updated default translations for better internationalization support

execute doc/update_db/update_339.sql for update

Full Changelog: https://github.com/LiveHelperChat/livehelperchat/compare/4.70v...4.71v

4.70v New feature
⚠ Upgrade required
  • Run `doc/update_db/update_337.sql` to apply the required database structure update.
Notable features
  • Major offline form tight integration using React Components instead of legacy system
  • Added conditions for prefilling offline form fields from previous chat sessions
Full changelog
  1. REST API and Bot Enhancements

    • Added retry options for REST API calls with configurable retry attempts and delays
    • Enhanced bot trigger validation to ensure buttons are correctly assigned to triggers
    • Improved trigger argument importing to support all available trigger arguments
    • Enhanced bot condition support with new "Not in list" condition type for more flexible logic flows
    • Better error handling and continuation logic when customers don't set matching triggers
  2. File Management and Search Improvements

    • Enhanced file search functionality with new chat ID and user ID filters
    • Added display of attached files in chat modification view for better file visibility
    • Improved file search panel UI with better styling and user experience
    • Enhanced JavaScript for dynamic form submission on input changes
    • Implemented indefinite file download capability for better file access management
  3. Forms and Offline Chat Integration

    • Major offline form tight integration (#2286) with React Component migration
    • Enhanced offline form to use React Components instead of legacy offline form system
    • Added conditions for offline form prefilling fields from previous chat sessions
    • Improved form error rendering for number field types
    • Better handling of input_data passing to offline templates
    • Enhanced forms integration with edge case scenario updates
  4. Chat and Message Handling Improvements

    • Added support for image requests with visitor messages
    • Improved file attachment flow to prevent message overlapping during file uploads
    • Enhanced scroll positioning for file preview functionality
    • Better handling of visitor message display and file attachment rendering
    • Improved message object passing for enhanced chat functionality
  5. Security and Permissions

    • Fixed permission handling issues (#2288, #2291)
    • Enhanced file verification events for attachment flows
    • Better access control and security validations throughout the system
  6. UI and User Experience Enhancements

    • Enhanced file list module to support new search parameters
    • Improved styling of input fields for better user experience
    • Better JavaScript handling for dynamic form interactions
    • Enhanced chat modification interface with file display capabilities
  7. System and Internal Improvements

    • Increased length of internal type fields for better data handling
    • Updated database structure with new field length requirements
    • Enhanced schedule checks with new ActionConditions class
    • Better chat blocking tests and validation logic
  8. Technical Infrastructure

    • Updated widget React components for better offline form handling
    • Enhanced translation system and updated translation files

execute doc/update_db/update_337.sql for update

What's Changed

  • Offline form tight integration by @remdex in https://github.com/LiveHelperChat/livehelperchat/pull/2286

Full Changelog: https://github.com/LiveHelperChat/livehelperchat/compare/4.69v...4.70v

4.69v Breaking risk
⚠ Upgrade required
  • Run `doc/update_db/update_337.sql` to apply the database schema update for temporary file handling
Breaking changes
  • Updated database structure with new temporary `tmp` field in `lh_chat_file` table
Notable features
  • Comprehensive file and image preview system before sending to operator
  • Dedicated top-level attachment templates for enhanced rendering
  • New file configuration options for finer control over uploads
Full changelog
  1. File and Image Preview System Enhancement

    • Implemented comprehensive file and image preview functionality before sending to operator
    • Added temporary file handling with new tmp field in lh_chat_file table
    • Enhanced widget React components to support file preview with better user experience
    • File attachments are now rendered at the top of messages for better visibility
    • Improved file upload workflow with progress indicators and preview capabilities
    • This enhancement prepares the foundation for future OpenAI Responses API for images implementation
  2. Widget and Chat Interface Improvements

    • Enhanced attachment rendering system with dedicated top-level templates
    • Improved AI-generated content checks and validation
    • Better file uploader component with enhanced preview functionality
    • Optimized widget React components for better performance and user experience
    • Enhanced chat file handling with improved meta message rendering
  3. Department and Chat Management Enhancements

    • Added support for using department alias when provided in chat widget and status checks
    • Improved department handling logic for better chat routing
    • Enhanced chat widget functionality with streamlined department selection
  4. Export and Data Handling Improvements

    • Fixed JSON export formatting with proper UTF-8 charset headers for Unicode support and pretty printing (#2283)
    • Enhanced bot export functionality with correct content-type headers
    • Improved REST API export with proper encoding
    • Better theme export handling with Unicode support
  5. File Configuration and Management

    • Added new file configuration options for better file handling control
    • Enhanced file upload settings with improved validation and processing
    • Better integration between file upload API and widget components
    • Improved file metadata handling and storage
  6. Technical Infrastructure Improvements

    • Updated database structure with new temporary file handling capabilities
    • Enhanced widget REST API endpoints for better file and chat management
    • Improved translation support and internationalization
  7. User Experience Enhancements

    • Streamlined file attachment workflow with instant preview
    • Better visual feedback for file operations
    • Enhanced message rendering with improved attachment display
    • Optimized loading and rendering performance for file-heavy conversations

execute doc/update_db/update_337.sql for update

What's Changed

Full Changelog: https://github.com/LiveHelperChat/livehelperchat/compare/4.68v...4.69v

4.68v New feature
⚠ Upgrade required
  • Run `doc/update_db/update_336.sql` after upgrade
Notable features
  • Comprehensive mail file management system with listing, viewing, searching, and archive table consistency
  • URL whitelist functionality for BBCode configuration to control link visibility
  • New permission system for file verification with granular access control
Full changelog
  1. Mail module enhancements

    • Added comprehensive mail file management system with listing, viewing, and searching functionalities
    • Enhanced mail image verification flow with protection mechanisms and sensitive content handling
    • New components: MailChatAttachment and MailChatImage for better mail attachment handling
    • Mail files archive tables now maintain consistent structure
    • Improved file details display in mail history
    • Better handling of mail file verification and download permissions
  2. User management improvements

    • Added job title field to user department alias functionality
    • Enhanced user department attributes with additional customization options
    • Improved validation and structure for user department relationships
  3. BBCode and URL handling enhancements

    • Added URL whitelist functionality for BBCode configuration to control link visibility
    • Enhanced URL obfuscation in BBCode parser with whitelist support
    • Improved BBCode URL handling and file extraction in messages
    • Added Message class for better file extraction functionality
    • Enhanced security and user control over link visibility
  4. File and image handling improvements

    • New permission system for file verification with granular access control
    • Allow non-image files to download with proper verification
    • Enhanced file reveal functionality and logging capabilities
    • Improved image attributes display in file edit window
    • Better styling for reveal image actions
  5. Mail search and performance optimizations

    • Enhanced mail search using message_id for improved performance
    • Better handling of mail file operations and verification flow
    • Optimized database queries for mail-related operations
  6. System configuration enhancements

    • Added default system time zone variable for better timezone handling
    • Option to see SMTP debug information for troubleshooting
    • Enhanced SMTP settings form and tab navigation
    • Improved audit configuration and logging capabilities
  7. Security and data handling

    • Fixed JSON export formatting with Unicode support and pretty printing (#2283)
    • Enhanced security for file downloads and verification
    • Better handling of sensitive information in mail attachments
    • Improved agent name escaping in various contexts
  8. Performance and stability improvements

    • Combined department and department group results for better consistency
    • Merged department ID filters for improved data consistency in statistics retrieval
    • Enhanced message handling logic in fetch operations
    • React app version updates and script reference adjustments
    • Better content fetching and caching mechanisms
  9. UI and UX improvements

    • Enhanced file body parsing and embed functionality for chat files
    • Improved styling and visual feedback for various components
    • Better handling of verification states and user interactions
    • Enhanced modal windows and form interactions
  10. Developer and debugging improvements

    • Option to skip request body in logging for performance
    • Enhanced debugging capabilities with better logging options
    • Improved database structure documentation and references
    • Better error handling and validation throughout the system

execute doc/update_db/update_336.sql for update

Full Changelog: https://github.com/LiveHelperChat/livehelperchat/compare/4.67v...4.68v

4.67v Breaking risk
⚠ Upgrade required
  • Update database schema to include new fields in lh_chat_file and lh_mailconv_file tables
  • Adjust configurations to set appropriate 'img_download_policy' values
Breaking changes
  • Added 'img_download_policy' configuration option altering image download permissions
  • Updated database schema: added 'meta_msg', 'width', and 'height' fields to lh_chat_file and lh_mailconv_file tables
Notable features
  • Configurable 'img_download_policy' for managing image download permissions
  • Chat tabs React component now supports custom attributes for styling
  • Enhanced offline forms with proper cookie handling and headers
Full changelog

Related article - https://doc.livehelperchat.com/docs/bot/image-file-verification-flow

  1. Image download verification and protection features
    • Introduced 'img_download_policy' configuration option to manage image download permissions
    • Enhanced file download logic to include image verification and protection checks
    • Added new verifyaccess.php module to handle image access verification requests
    • Updated database schema to include 'meta_msg', 'width', and 'height' fields in lh_chat_file and lh_mailconv_file tables
    • Implemented Svelte component for image handling with verification and protection features
    • Added translations for image access verification messages
    • Updated module.php to include new permissions for downloading verified and unverified files
    • Added sensitive information image to the default theme
  2. Chat tabs and dashboard improvements
    • Chat tabs React component now supports custom attributes for styling
    • Enhanced tabs flow with better navigation and user experience
    • Dashboard chat tabs improvements with better state management
  3. Bot and webhook enhancements
    • Added support for overriding bot ID in webhook processing for better event handling
    • Implemented chat file variable handling in generic bot action command for dynamic variable updates
    • Enhanced REST API action to support chat file messages
    • Option to sync attribute from database in bot conditions
    • Modal window will show error message when trying to delete a bot that cannot be deleted
  4. Form and file handling improvements
    • Fixed reCAPTCHA in offline form when file is submitted
    • Enhanced offline forms with proper cookie handling and headers
    • Better file upload handling with proper content headers
    • Store partial encoded data for better file processing
  5. Chat experience enhancements
    • Hide "Switch to Human" button when chat transitions to survey mode
    • System message is now logged when "Switch to Human" button is clicked
    • Custom template support for extensions below chat messages
    • Improved image reveal logic in Svelte components for better scrolling behavior
  6. Security and compatibility
    • Fixed deprecated PHP constant E_STRICT for better PHP 8+ compatibility
    • Enhanced file download verification process with user data in event dispatch
    • Improved security for image access and verification
  7. UI and UX improvements
    • Better error handling and user feedback
    • Enhanced modal dialogs and confirmation windows
    • Improved responsive design elements
    • Updated sponsors section
4.66v Mixed
Notable features
  • New modal confirm window replacing browser native confirms
  • Pronoun inclusivity improvements: he/him/his changed to they/them throughout UI
Full changelog
  1. IMAP and SMTP connection testing features in mailbox settings. You can now test your mail configuration directly from the interface.
  2. Enhanced mailbox management with delete folder functionality for better organization.
  3. Bot chart generation using Mermaid diagrams for visual workflow representation of bot flows.
  4. New configuration option for departments: "Do not transfer to destination department if it has no online operators" to improve chat transfer handling.
  5. Enhanced user settings management and dashboard tab management with improved visibility options.
  6. Conditions support for replaceable variables, allowing more dynamic content generation.
  7. Option to investigate use cases of various objects for better debugging and analysis.
  8. Priority rule testing - you can now test priority rules directly from the interface.
  9. Enhanced bot message handling and trigger management with better control options.
  10. Direct magic attribute support in bot text fields with new direct_ prefix option.
  11. Enhanced REST API trigger execution logging and handling for better debugging.
  12. Option to suspend/resume online visitors updating in main window for performance control.
  13. Canned messages now have max result configuration for display optimization.
  14. Enhanced email anonymization features and chat status improvements.
  15. n8n integration support for workflow automation.
  16. Improved quote handling in messages - quotes will be preserved as plain text.
  17. Enhanced access control for displaying user attributes in online user info.
  18. Better handling of chat continuation and message rendering.
  19. Updated dependencies including TinyMCE, Svelte, and other packages for security and performance.
  20. Switch to new modal confirm windows replacing browser native confirms.
  21. Enhanced character validation and node identifiers in bot chart generation.
  22. Improved debug output with better state attribute handling and clarity.
  23. Enhanced bot trigger builder functionality with better workflow management.
  24. Fixed chat closing in popup scenarios that sometimes triggered false alerts.
  25. Better handling of button payload text values as default triggers.
  26. Enhanced message processing with improved direct value handling.
  27. Various fixes for online operator department conditions and user management.
  28. Pronoun inclusivity improvements changing he/him/his references to they/them.
  29. Enhanced template compilation with preserved newline characters.
  30. Better background worker exception handling.
  31. Enhanced department query to include online hours check for better availability management.
  32. React app version updates and chat widget reducer state management improvements.

execute doc/update_db/update_334.sql for update

What's Changed

  • Switch to new modal confirm window by @remdex in https://github.com/LiveHelperChat/livehelperchat/pull/2263
  • he/him/his changes to they/them and other minor tweaks. by @adrianbj in https://github.com/LiveHelperChat/livehelperchat/pull/2273
  • Improvements all around by @remdex in https://github.com/LiveHelperChat/livehelperchat/pull/2275

New Contributors

  • @adrianbj made their first contribution in https://github.com/LiveHelperChat/livehelperchat/pull/2273

Full Changelog: https://github.com/LiveHelperChat/livehelperchat/compare/4.65v...4.66v

Beta — feedback welcome: [email protected]