MyJustDial is a complete helpdesk and ticketing system that automatically fetches emails from multiple inboxes, converts them to tickets, tracks time, manages clients, and generates invoices.

---

📋 System Requirements (All Platforms)

• PHP 7.4 – 8.4
• MySQL / MariaDB (5.7+ / 10.2+)
• Web Server: Apache (recommended) or Nginx
• PHP Extensions (must be enabled):
  • mysqli
  • openssl – required for SMTP (SSL/TLS)
  • sockets – required for SMTP communication
  • imap – required for fetching emails
  • mbstring
  • json
  • session
  • date

✉️ SMTP Configuration (Sending Emails)

MyJustDial uses PHPMailer to send emails via SMTP. No separate PHP extension is needed – PHPMailer works with standard PHP functions.

Required PHP Extensions for SMTP

• openssl – encrypts the connection (SSL/TLS)
• sockets – low-level network communication
• mbstring – handles UTF-8 encoding in email subjects/bodies

Enabling SMTP in MyJustDial

1. Log in as Admin → Go to Email Settings.
2. Edit or add an email account.
3. In the SMTP (Outgoing) tab, fill in:
   • SMTP Host – e.g., smtp.gmail.com
   • SMTP Port – 465 (SSL) or 587 (TLS)
   • Encryption – ssl for port 465, tls for port 587
   • SMTP Username – full email address
   • SMTP Password – use an App Password if 2FA is enabled on Gmail
4. Save the settings.
5. Go to Email Test and click Send Test Email to verify.

Common SMTP Providers

Provider	SMTP Host	Port	Encryption
Gmail	smtp.gmail.com	465	ssl
Gmail (alternative)	smtp.gmail.com	587	tls
Outlook/Hotmail	smtp-mail.outlook.com	587	tls
Yahoo	smtp.mail.yahoo.com	465	ssl
cPanel (shared hosting)	mail.yourdomain.com	465	ssl

Testing SMTP

After configuring SMTP, use the Email Test page to send a test email. If it succeeds, your SMTP is working correctly.

🪟 Windows Installation (XAMPP)

1. Install XAMPP

Download from Apache Friends and install with default options (e.g., C:\xampp).

2. Enable Required PHP Extensions

• Open XAMPP Control Panel → Stop Apache
• Click Config next to Apache → PHP (php.ini)
• Find and uncomment (remove the semicolon) these lines:

extension=imap
extension=mysqli
extension=openssl
extension=sockets
extension=mbstring

• Save the file and restart Apache

3. Create Database

• Start Apache and MySQL from XAMPP Control Panel
• Open browser → http://localhost/phpmyadmin
• Click New → enter database name (e.g., myjustdial) → choose utf8mb4_general_ci → Create

4. Extract MyJustDial Files

Unzip the downloaded package into: C:\xampp\htdocs\myjustdial

5. Run the Installer

Open browser → http://localhost/myjustdial/install.php
Follow the wizard:

• Step 1: Database credentials (host: localhost, database name, user: root, password: empty)
• Step 2: Import schema (automatic)
• Step 3: Create admin account (your name, email, password)

After completion, delete install.php from the folder for security.

6. Login

Go to http://localhost/myjustdial/index.php with your admin credentials.

🐧 Linux Installation (Two Options)

Option A (Recommended for servers): Native LAMP stack (command line)

1. Install LAMP Stack & Required PHP Extensions

Open a terminal and run:

sudo apt update
sudo apt install apache2 mysql-server php php-mysqli php-imap php-mbstring php-openssl

For other distributions (CentOS/RHEL), use yum install httpd mariadb-server php php-mysqli php-imap php-mbstring php-openssl.

2. Enable PHP Modules

sudo phpenmod mysqli imap mbstring openssl sockets
sudo systemctl restart apache2

3. Create Database

sudo mysql -u root -p

Inside the MySQL prompt:

CREATE DATABASE myjustdial CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
GRANT ALL PRIVILEGES ON myjustdial.* TO 'myjustdial_user'@'localhost' IDENTIFIED BY 'your_strong_password';
FLUSH PRIVILEGES;
EXIT;

4. Upload MyJustDial Files

sudo cp -r myjustdial /var/www/html/
sudo chown -R www-data:www-data /var/www/html/myjustdial

5. Run the Installer

Open browser → http://your-server-ip/myjustdial/install.php
Fill in the database details (host: localhost, database name myjustdial, user myjustdial_user, your password)
Complete the wizard and then delete install.php:

sudo rm /var/www/html/myjustdial/install.php

6. Login

Access http://your-server-ip/myjustdial/index.php with your admin credentials.

Option B (For desktop / GUI users): XAMPP for Linux

1. Download XAMPP for Linux

Go to Apache Friends and download the XAMPP for Linux version (PHP 8.2 or 8.3).

2. Install XAMPP

chmod +x xampp-linux-*-installer.run
sudo ./xampp-linux-*-installer.run

A graphical installer will guide you – install to the default location /opt/lampp.

3. Start XAMPP

Use the GUI manager:

sudo /opt/lampp/manager-linux-x64.run

Or from the command line:

sudo /opt/lampp/lampp start

4. Enable Required PHP Extensions

Edit /opt/lampp/etc/php.ini (as root):

sudo nano /opt/lampp/etc/php.ini

Find and uncomment these lines:

extension=imap
extension=mysqli
extension=openssl
extension=sockets
extension=mbstring

Save the file and restart XAMPP.

5. Create Database

Open browser → http://localhost/phpmyadmin → Click New → enter database name → choose utf8mb4_general_ci → Create.

6. Extract MyJustDial Files

sudo cp -r myjustdial /opt/lampp/htdocs/

7. Run the Installer

Open browser → http://localhost/myjustdial/install.php
Follow the wizard (database host: localhost, database name, user: root, password: empty).
After completion, delete install.php:

sudo rm /opt/lampp/htdocs/myjustdial/install.php

8. Login

Go to http://localhost/myjustdial/index.php with your admin credentials.

✅ Verification & Optional Cron Setup

Test IMAP Connection

Log in as admin → Go to Email Test from the menu. If you see Connected successfully!, the IMAP extension is working.

Test SMTP Sending

In the same Email Test page, click Send Test Email for any configured email account. You will receive a test message if SMTP is configured correctly.

Automatic Email Fetching (Cron Job)

To fetch new emails every 5 minutes, add a cron job:

• On Linux (native LAMP): */5 * * * * php /var/www/html/myjustdial/triage.php?ajax_fetch=1
• On Linux (XAMPP): */5 * * * * /opt/lampp/bin/php /opt/lampp/htdocs/myjustdial/triage.php?ajax_fetch=1
• On Windows (Task Scheduler): Create a task running "C:\xampp\php\php.exe" -f "C:\xampp\htdocs\myjustdial\triage.php?ajax_fetch=1" every 5 minutes.

🔐 License Activation

• The software includes a 30‑day demo period.
• After demo expires, you will be prompted to enter a license key.
• Purchase a license from MyJustDial and enter the key on the activation page (activate.php).
• Activation contacts our license server once, then works offline (periodic validation).

🛠️ Troubleshooting

📞 Support

• Documentation: https://myjustdial.com/docs.php
• Email: puspendu.biswas82@gmail.com
• Purchase / Renewal: https://myjustdial.com/purchase.php

---