Version 1.2.0 – Client Area & DNS Configuration Redesign

Client Area Redesign

Complete rebuild of the client area template

Unified layout improvements for desktop and mobile

Cleaner structure and better information hierarchy

Improved readability and usability across all screen sizes

DNS Configuration Improvements

DNS configuration moved from popup modal to a dedicated layout

Eliminated popup-related issues that prevented correct DNS setup

Clear, structured DNS instructions per record type

Improved reliability when copying and applying DNS records

Better guidance for both technical and non-technical users

UX & Stability

Reduced user errors during DNS configuration

Fewer support tickets caused by unclear instructions

More consistent behavior across browsers and devices

Technical

No breaking changes

Fully backward compatible

================================================================================ ISSUE RESOLVED - Mailcow WHMCS Module

ERROR: "HTTP Error 400: Request body doesn't contain valid json!"

WHAT WAS DONE: The module now automatically detects whether to use HTTP or HTTPS based on the configured port (443 = HTTPS, 80 = HTTP).

RESULT: Domain and mailbox creation working normally on all servers.

Date: 11/15/2025

================================================================== CHANGELOG - Mailcow WHMCS Module

All notable changes to this project will be documented here.

================================================================== Version 1.1.0 - November 15, 2025

CRITICAL BUG FIXES

*** UNAUTHORIZED Error When Accessing Webmail (SOGo) ***

Problem: When creating a new domain via WHMCS, the SOGo service was not automatically restarted, causing "UNAUTHORIZED" error when users tried to access webmail for the first time.

Root Cause: Domain creation payload did not include the "restart_sogo" parameter in Mailcow API.

Solution Implemented:

• Added "restart_sogo: 1" parameter in mailcow_CreateAccount() function in mailcow.php file (line 117)
• Modified MailcowAPI::createDomain() method to ensure "restart_sogo" is always sent, even when called with different data formats (lines 164-192 of MailcowAPI.php)
• Implemented automatic verification: if parameter doesn't exist in data array, it's automatically added with value "1"

Impact: Clients can now access webmail immediately after account creation, without need for manual SOGo restart by administrator.

Files Modified:

• mailcow.php
• lib/MailcowAPI.php

MAJOR IMPROVEMENTS

*** DNS Configuration Modal Completely Redesigned ***

Problem: Original DNS modal only showed raw values without explanation, making configuration difficult for clients.

Improvements Implemented:

• DNS fields visually separated (like Cloudflare, GoDaddy, etc)
• Each record type (MX, SRV, TXT, CNAME) now shows individual fields:
  • MX: Name, Server, Priority, TTL with recommended value hints
  • SRV: Name, Priority, Weight, Port, Target, TTL with explanations for each field
  • TXT: Name, Value, TTL with exact copy instructions
  • CNAME: Name, Target, TTL
• Added contextual hints for each field:
  • "Use @ for domain root"
  • "0-65535, lower = higher priority" for MX
  • "Ex: 443, 587, 993" for ports
  • "Target server" for target fields
• Support for two SRV record formats:
  • Complete format: "0 0 443 mail.example.com"
  • Simplified format: "mail.example.com 443"
• Detailed instructions at top of modal with panel examples (Cloudflare, Registro.br, GoDaddy)
• Warning box highlighting records that need updating
• "Copy full value" button for each record
• Responsive and professional design with colors and icons

User Experience: Client now knows exactly where to place each value in DNS panel.

Files Modified:

• templates/clientarea.tpl (lines 189-240, 536-639)
• Added 21 new translation strings in multiple languages

*** Complete Translation System for DNS ***

• Added 21 new translation strings for DNS fields
• Supported languages: Portuguese, English, Spanish, German, French, Italian, Dutch, Russian, Turkish
• Strings include: field labels, value hints, help messages

Files Created/Modified:

• lang/pt.json
• lang/en.json
• lang/es.json
• lang/de.json
• lang/fr.json
• lang/it.json
• lang/nl.json
• lang/ru.json
• lang/tr.json

============================================================

1. OVERVIEW ============================================================ This addon integrates WHMCS with Mailcow so your customers can manage their email domain from the WHMCS Client Area, while you control domain provisioning in Mailcow. Standard flow:

1. The customer orders the product in WHMCS.
2. WHMCS provisions the DOMAIN only in Mailcow.
3. The customer creates/manages their own mailboxes and aliases in the Client Area.
4. The admin can manage the domain via the module's Admin Area.