CloudCusp Mailer Docs

Appearance

Installation & Setup ​

System Requirements ​

Before installing CloudCusp Mailer, ensure your WordPress environment meets these requirements:

WordPress:

  • Minimum WordPress 6.4
  • Tested up to WordPress 7.0
  • Recommended: Latest WordPress version

PHP:

  • Minimum PHP 8.0
  • Recommended: PHP 8.1 or higher
  • Required Extensions: cURL, JSON, SPL

MySQL/Database:

  • MySQL 5.7+ or MariaDB 10.2+
  • Recommended: MySQL 8.0+
  • Table Prefix: Standard wp_ or custom prefix

Web Server:

  • Apache or Nginx
  • mod_rewrite enabled (for Apache)
  • SSL/HTTPS certificate (recommended for security)

PHP Functions:

  • wp_remote_post() - For email provider API calls
  • wp_mail() - For default WordPress mail
  • Cron jobs (wp-cron or system cron)

Plugin Installation ​

From WordPress Admin ​

  1. Go to Plugins → Add New
  2. Search for "CloudCusp Mailer"
  3. Click Install Now
  4. Click Activate

Manual Installation ​

  1. Download the plugin files
  2. Upload the ccsp-mailer folder to /wp-content/plugins/ directory
  3. Go to Plugins in WordPress admin
  4. Find "CloudCusp Mailer" and click Activate

Via SFTP ​

  1. Connect to your server via SFTP
  2. Navigate to /wp-content/plugins/
  3. Upload the ccsp-mailer folder
  4. Activate through WordPress admin

Initial Configuration ​

Step 1: Database Setup ​

The plugin automatically creates required database tables on activation:

  • ccspmailer_subscribers - Subscriber records
  • ccspmailer_subscriber_lists - List memberships
  • ccspmailer_subscriber_tags - Tag assignments
  • ccspmailer_campaigns - Campaign data
  • ccspmailer_analytics - Email tracking data
  • ccspmailer_automation - Automation workflows
  • ccspmailer_webhooks - Webhook configurations

No manual setup required; tables are created automatically.

Step 2: Email Provider Configuration ​

  1. Go to CloudCusp Mailer → Settings

  2. Navigate to Email Provider tab

  3. Select your email provider:

    • WordPress Mail (default)
    • SendGrid
    • Mailgun
    • Amazon SES
    • Custom SMTP

  4. Enter provider credentials

  5. Test connection

  6. Save settings

See Email Providers Guide for detailed setup instructions.

Step 3: Sender Information ​

  1. Go to CloudCusp Mailer → Settings

  2. Navigate to Sender Settings

  3. Configure:

    • From Name
    • From Email Address
    • Reply-To Email
    • Reply-To Name

  4. Save settings

Step 4: Create First Subscriber List ​

  1. Go to CloudCusp Mailer → Lists
  2. Click Create List
  3. Enter list name
  4. Configure:
    • Confirmation method (single/double opt-in)
    • Subscription welcome message
  5. Save

Upgrading the Plugin ​

Automatic Updates ​

The plugin includes automatic update checking. When updates are available:

  1. Go to Dashboard → Updates
  2. Click Update next to CloudCusp Mailer
  3. Wait for upgrade to complete

Manual Update ​

  1. Download latest version
  2. Upload to /wp-content/plugins/ccsp-mailer/ (overwrite files)
  3. Database schema updates run automatically
  4. No data loss occurs

Troubleshooting Installation ​

Plugin Not Appearing in List ​

  • Check PHP version (minimum 8.0)
  • Check WordPress version (minimum 6.4)
  • Clear browser cache
  • Check /wp-content/plugins/ folder exists

Activation Fails ​

  • Check PHP error logs
  • Verify database user permissions
  • Ensure write permissions on /wp-content/plugins/
  • Check available server memory

Missing Email Table ​

  • Go to CloudCusp Mailer → Settings
  • Click Recreate Tables
  • Verify database permissions

Database Connection Error ​

  • Check database credentials in wp-config.php
  • Verify database user permissions
  • Check database host is accessible
  • Verify database exists

Next Steps ​

After installation:

  1. Quick Start Guide - Get up and running
  2. Email Campaigns - Create your first campaign
  3. Subscriber Management - Build your list
  4. Email Providers - Configure delivery method

Support & Documentation ​