Overview

CoinTrail's Newsletter System provides a complete solution for keeping your users informed about cryptocurrency news, market updates, and platform announcements. The system includes both manual newsletter campaigns and fully automated email newsletters.

Features

Automated Newsletter Types

CoinTrail includes three types of automated newsletters that are sent based on user preferences:

Newsletter-Specific Cron Commands

# Send daily newsletter manually
php artisan newsletter:send-daily

# Send weekly roundup manually
php artisan newsletter:send-weekly

# Send portfolio summary manually
php artisan portfolio:send-summary

# View all scheduled tasks including newsletters
php artisan schedule:list

Scheduled Newsletter Tasks

When cron is properly configured, the following newsletter tasks run automatically:

News API Sources

The newsletter system can pull news from multiple configured sources. Configure these in Admin > Settings > Third Party.

Configuring News Sources

1. Go to Admin Panel > Settings > Third Party
2. Scroll to the News API section
3. Enter your API keys for the services you want to use
4. Click Save

Managing Subscribers

View and manage all newsletter subscribers from the admin panel.

1. Go to Admin Panel > Marketing > Newsletters
2. View all subscribers with email, date subscribed, and status
3. Filter by status (active, unsubscribed)
4. Export subscribers to CSV for external use

Newsletter Subscription Form

Newsletter subscription forms are automatically included in the site footer. Visitors can subscribe by entering their email address.

AJAX Subscription Endpoint

Subscriptions are handled via AJAX:

POST /ajax/newsletter-subscribe
Content-Type: application/json

{
    "email": "user@example.com"
}

Response

// Success
{
    "success": true,
    "message": "Thank you for subscribing!"
}

// Error (already subscribed)
{
    "success": false,
    "message": "This email is already subscribed."
}

User Communication Preferences

Registered users can manage their email preferences to choose which newsletters they receive.

Available Preferences

Users access preferences at: /user/communication-preferences

Enable/Disable Newsletter Feature

You can enable or disable the newsletter feature from the admin panel:

1. Go to Admin Panel > Settings > Features
2. Find the Enable Newsletter toggle
3. Toggle ON to enable, OFF to disable
4. Click Save

Sending Manual Newsletters

In addition to automated newsletters, you can send manual email campaigns:

1. Go to Admin Panel > Marketing > Compose Newsletter
2. Enter a subject line
3. Compose email content using the WYSIWYG editor
4. Preview the email
5. Select recipient list (all subscribers or filtered)
6. Click Send

Email Templates

Newsletter email templates are located in:

resources/views/emails/
├── daily_newsletter.blade.php      # Daily newsletter template
├── weekly_roundup.blade.php        # Weekly roundup template
├── portfolio_summary.blade.php     # Portfolio summary template
└── newsletter.blade.php            # Manual newsletter template

You can customize these templates to match your branding. The templates support:

• Blade templating syntax
• Dynamic data injection (market data, news, user data)
• Responsive email design
• Unsubscribe links (automatically included)

Best Practices

• Always include an unsubscribe link - Automatically added by the system
• Send newsletters at consistent times - Users will come to expect them
• Monitor delivery rates - Check for bounces and spam complaints
• Test emails before sending - Use the preview function
• Respect user preferences - Only send newsletters to opted-in users
• Keep content valuable - Focus on useful market insights, not just promotions

Troubleshooting