TempoMail WPBay Commercial Documentation

Overview & Architecture

TempoMail is an enterprise-grade disposable temporary email SaaS application built with modern Laravel and clean architectural boundaries. It allows webmasters to run a turnkey disposable email service with multi-domain support, custom mailbox prefixes, attachment handling, auto-expiry schedules, and a high-converting customer portal.

Visual Feature Tour & Marketing Graphics

High-resolution previews and marketing infographics showcasing TempoMail's core capabilities, user interface, and integrations:

10 Core Features Infographic

Plugins & Integrations Showcase

Multi-Language & RTL Support

Modern Glassmorphic Frontend

Superadmin Analytics Dashboard

High-Impact Frontend Features

Powerful Admin Control Center

The administrative dashboard puts complete operational control at your fingertips:

Turnkey Plugins & Integrations

Enable or disable modular extensions directly from Admin -> Plugins:

Demo Credentials & Live Sandbox

Server Requirements

Ensure your hosting environment meets the following specifications before launching the installer:

7-Step Modern Web Installer

TempoMail features an interactive, guided 7-step visual installation wizard designed to eliminate deployment errors:

Commercial Licensing & Complete External Disclosures

TempoMail WPBay Commercial Edition is distributed 100% unlocked out-of-the-box without DRM locks, domain restrictions, or phone-home license verification.

Complete External Services & Dependencies Disclosure

TempoMail operates privately on your web server. In accordance with marketplace transparency policies, the table below provides a comprehensive disclosure of external services, third-party APIs, CDNs, and optional integrations supported in this application:

1-Click Auto-Setup Addon Guide

The 1-Click cPanel Auto-Installer Addon is an official productivity enhancement that saves 30+ minutes on every server deployment by communicating with cPanel UAPI:

How to Generate Your cPanel API Token in 30 Seconds:

1. Log into your hosting cPanel account (e.g. https://yourdomain.com:2083).
2. In the search box at the top, type "API Tokens" and click the result under the Security section.
3. Click the blue "Create API Token" button.
4. Enter a Token Name (e.g., TempoMailAutoSetup).
5. Under Privileges, check the Email privilege checkbox.
6. Click Create and copy the generated token string into the installer.

What the 1-Click Engine Automates:

• Generates a cryptographically secure 20-character encrypted password.
• Executes Email::add_pop to provision a dedicated catch-all mailbox on your server.
• Executes Email::set_default_address to route all incoming emails (*@yourdomain.com) into this mailbox.
• Pre-wires SSL IMAP (Port 993) and SSL SMTP (Port 465) directly into your database.
• Adds the domain to the active receiving domains table.

Manual Mailbox & Catch-All Guide

If you prefer manual mailbox configuration, or if you are using a non-cPanel environment (CyberPanel, Plesk, DirectAdmin, Postfix, Docker, or bare VPS), you can configure your mailbox manually in under 5 minutes:

Step-by-Step Manual cPanel Configuration:

1. Create Mailbox: In cPanel, navigate to Email Accounts → Create. Create an account such as catchall@yourdomain.com with a strong password.
2. Enable Catch-All (Default Address): Navigate to Default Address in cPanel. Select your domain, choose "Forward to Email Address", and enter catchall@yourdomain.com.
3. Connect in TempoMail Admin: Log in to TempoMail Admin Panel → Settings → IMAP Settings. Enter:
   • Host: mail.yourdomain.com
   • Port: 993
   • Encryption: SSL
   • Username: catchall@yourdomain.com
   • Password: Your mailbox password
4. Add Active Domain: Go to Admin → Domains → Add New Domain and enter yourdomain.com.

DNS, MX & SPF Records Setup

For your domain to accept incoming emails from Gmail, Yahoo, Outlook, and other providers, your DNS records must be configured correctly:

Background Cron Jobs & Automation

TempoMail requires a single Laravel background cronjob to process incoming emails, purge expired mailboxes, and maintain performance:

* * * * * cd /home/username/public_html && php artisan schedule:run >> /dev/null 2>&1

How to Add via cPanel:

1. In cPanel, search for "Cron Jobs" under the Advanced section.
2. Under Common Settings, choose "Once Per Minute (* * * * *)".
3. In the Command field, enter:
   php /home/YOUR_CPANEL_USER/path-to-script/artisan schedule:run >> /dev/null 2>&1
4. Click "Add New Cron Job".

REST API Documentation

Integrate TempoMail with third-party software, mobile apps, or browser extensions using our authenticated JSON REST API:

Authorization: Bearer YOUR_API_TOKEN
Accept: application/json
Content-Type: application/json

Troubleshooting & FAQ