Mailcow WHMCS Self-hosted Mail Solution v1.2.0

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
  

Still working on its own page. if you want to see more details like screenshots just dm on private I will be happy to show you.

================================================================================
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

PROFESSIONAL EMAIL TEMPLATES
------------------------------------------------------------------

* Complete Rewrite of Welcome Templates *

Previous Format: Templates with emojis and markdown that didn't
work in WHMCS

New Format: Plain text optimized for WHMCS

Improvements:

• Removed all emojis (not supported by WHMCS)
• Removed markdown formatting (bold/italic doesn't work)
• Added ASCII borders for visual section separation
• Completely organized sections:

- Account information
- Email client configuration (IMAP/SMTP/POP3)
- Required DNS configuration (all records)
- Webmail access
- Recommended mobile apps
- Support and contact
- Security tips

Detailed DNS Configuration:

• MX Record with priority explanation
• SPF Record with function description
• DMARC Record with policy
• DKIM Record (if available)
• Additional records: Autodiscover, Autoconfig, SRV
• DNS propagation time and test link (mxtoolbox.com)

Complete Client Configuration:

• IMAP: Port 993 (SSL/TLS) and 143 (STARTTLS)
• SMTP: Port 587 (STARTTLS) and 465 (SSL/TLS)
• POP3: Port 995 and 110
• Instructions for iOS and Android
• 6 important security tips

Files:

• email_templates/mailcow_welcome_pt.txt (Portuguese)
• email_templates/mailcow_welcome_en.txt (English)

EXPANDED DOCUMENTATION
------------------------------------------------------------------

New Guide Created:
1, Setup email templates (OPTIONAL NOT REQUIRED).txt
- Same content in English
- Step-by-step for WHMCS v8.0+ and v7.x
- How to use templates in products
- Complete Smarty variables table
- Customization guide
- Testing procedures
- Troubleshooting section


TECHNICAL CHANGES
------------------------------------------------------------------

• Organized file structure
• Improved error logs
• Input data validation
• Enhanced exception handling