Mailing Manager – PN

Açıklama

Transform your WordPress site into a powerful email management hub with our intuitive plugin. Whether you’re running newsletters, promotional campaigns, or customer outreach, this tool empowers you to Schedule Emails (plan campaigns in advance with an easy-to-use scheduler), Personalize Content (Create tailored messages with dynamic content fields), Track Performance (Monitor open rates, click-through rates, and engagement metrics in real time), Seamless Integration (Connect with popular email services or use your SMTP server), Automation Features (Set up automated responses and drip campaigns to save time and boost engagement), Email Design System (Customize typography, colors, buttons, and headers/footers with a live preview panel), Deliverability Analysis (SPF, DKIM, DMARC, and MX record verification with a 0-100 score), Queue Monitoring (Floating status button, global queue popup with estimated completion times, and consecutive errors auto-pause), WooCommerce Email Wrapping (Apply your branded template to all WooCommerce transactional emails), and Error Diagnostics (Detailed error logging, per-email retry, and admin notifications). Perfect for bloggers, small businesses, and marketers, this plugin combines simplicity with robust functionality to ensure your emails get delivered and make an impact. Start growing your audience today!

Core Features

• Email Template Management: Create and manage unlimited email templates using WordPress’s familiar post editor. Each template supports rich HTML content, custom styling, and dynamic shortcodes for personalized messaging.

• SMTP Configuration: Full SMTP support with authentication, allowing you to connect to any SMTP server (Gmail, Outlook, custom servers). Configure SMTP host, port, security (TLS/SSL), authentication credentials, and custom sender information. Includes Gmail-specific optimizations for better deliverability.

• Email Queue System: Intelligent email queue management that processes emails in controlled batches. Configure sending rates (emails per 10 minutes and daily limits) to prevent server overload and ensure optimal deliverability. Automatic queue pausing when daily limits are reached, with automatic reset after 24 hours.

• Scheduled Email Delivery: Schedule emails to be sent at specific times in the future. Perfect for welcome emails, follow-ups, and time-sensitive campaigns. Includes delayed welcome email functionality with configurable delays.

• Email Tracking & Analytics: Comprehensive tracking system including:

  • Open Tracking: Optional tracking of email opens using invisible tracking pixels. Monitor when recipients open your emails with timestamps. Can be disabled to prioritize deliverability over tracking.
  • Click Tracking: Track all link clicks in emails. See which links are clicked most, track unique clicks per user, and analyze click patterns.
  • Detailed Statistics: View click statistics by URL, total clicks, unique users who clicked, and detailed click history with timestamps and IP addresses.

• Email Deliverability Enhancements: Advanced features to ensure your emails reach the inbox:

  • Optional Open Tracking: Disable JavaScript-based open tracking to improve spam scores and deliverability ratings
  • List-Unsubscribe Headers: RFC 2369/8058 compliant List-Unsubscribe headers for all emails (URL + mailto dual format)
  • One-Click Unsubscribe: Support for List-Unsubscribe-Post headers for Gmail/Yahoo compliance
  • Deliverability Checker: Comprehensive 9-point check system including:
  • SPF, DKIM, DMARC, and MX record verification
  • JavaScript detection in emails (affects spam score)
  • List-Unsubscribe header validation
  • Text/plain version recommendations
  • SMTP configuration validation
  • FROM address verification
  • Mail-Tester Optimization: Built to achieve 10/10 Mail-Tester scores when properly configured

• Email Types & Automation:

  • Welcome Emails: Automated welcome emails for new users with configurable delays
  • One-Time Emails: Send emails that are only sent once per recipient
  • Published Content Emails: Automatically send emails when new content is published. Configure to send notifications about new posts, pages, or custom post types
  • Coded Emails: Special emails with unique codes (e.g., verification codes)
  • Password Reset Emails: Customizable password reset emails with branded templates
  • New User Notifications: Automated emails sent when new users register

• WooCommerce Integration: Seamless integration with WooCommerce for e-commerce email automation:

  • Purchase Emails: Automatically send emails after purchase completion with configurable delays
  • Abandoned Cart Emails: Detect and send emails to users who abandon their shopping carts. Configurable delay periods (minutes, hours, or days)
  • Cart Tracking: Monitor cart activity and send targeted recovery emails
  • WooCommerce Email Wrapping: Optionally wrap WooCommerce transactional emails with the MailPN template (header, footer, design settings, legal info)

• Email Distribution Options: Flexible recipient targeting:

  • Send to all users
  • Send to specific user roles
  • Send to individual selected users
  • Support for custom user queries

• Exception Management: Advanced email filtering system:

  • Exclude specific email domains from receiving emails
  • Exclude individual email addresses
  • Perfect for testing environments or excluding internal accounts

• Email Records & History: Complete audit trail of all sent emails:

  • Track every email sent with full details (recipient, subject, content, attachments, timestamps)
  • View email status (sent, queued, failed)
  • Detailed error logging for failed sends
  • Email content stored in both HTML and plain text formats
  • Server information and IP tracking

• Dashboard & Statistics: Comprehensive dashboard providing:

  • Recent sent emails count (last 7 days)
  • Pending scheduled emails count
  • Detailed email history with filtering options
  • Visual statistics and progress tracking
  • Email queue status monitoring

• Email Templates & Branding: Professional email template system:

  • Customizable header images
  • Customizable footer images
  • Configurable maximum email width
  • Legal information footer (company name, address)
  • Custom footer messages
  • Social media links support
  • Responsive design for mobile devices

• Email Design System: Comprehensive design customization with live preview:

  • Typography Settings:
  • Font family selector with visual preview of each font option
  • Separate font sizes for desktop and mobile devices
  • Customizable heading sizes (H1, H2, H3)
  • Adjustable line height for better readability
  • Color Customization:
  • Background color control
  • Text color customization
  • Button background and text colors
  • Header and footer background colors
  • Footer text color settings
  • Button Styling:
  • Configurable border radius
  • Custom colors for background and text
  • Live Preview System:
  • Real-time preview of design changes
  • Desktop and mobile view toggle
  • Sample content with all formatting elements (headings, paragraphs, lists, buttons)
  • Instant visual feedback while adjusting settings
  • Design Consistency:
  • All design settings automatically applied to ALL email types
  • Native WordPress emails (password reset, new user notifications)
  • WooCommerce emails
  • Custom templates and mass mailings
  • Test emails with comprehensive formatting examples

• Dynamic Content & Shortcodes: Powerful shortcode system for personalization:

  • [user-name] – Display recipient’s name
  • [post-name] – Display post titles with links
  • [new-contents] – Display recently published content
  • Support for user data (first name, last name, email, nickname, ID)
  • Post-specific shortcodes
  • Custom content filters

• Test Email Functionality: Send test emails to verify templates before sending to all recipients. Test emails bypass queue system and restrictions for immediate delivery.

• Error Handling & Logging: Robust error management:

  • Detailed error messages for failed sends
  • SMTP error reporting
  • Option to email admin on send failures with full diagnostics (SMTP config, server info, context)
  • Error retry functionality for individual emails and bulk resend
  • Comprehensive error logs with timestamps and details saved to wp-content/mailpn-email-errors.log
  • Global error log viewer with full log access, statistics, and clearing functionality
  • Error popup integration for quick troubleshooting
  • Improved message contrast for better readability of error and success notifications
  • Exact error count display with singular/plural formatting
  • Detailed error view per record: error message, recipient, subject, headers, server IP, user info
  • Distinction between validation skips and actual send failures for accurate error counting

• Role-Based Permissions: Fine-grained access control:

  • Custom capabilities for email management
  • Role-specific permissions for creating, editing, and sending emails
  • Taxonomy capabilities for email categories
  • Secure permission system following WordPress standards

• Email Queue Management: Advanced queue control:

  • View and manage pending emails
  • Pause/resume queue functionality
  • Progress tracking for bulk sends
  • Automatic cleanup of processed items
  • Queue status indicators
  • Floating queue status button for administrators showing pending count and send/pause state
  • Global queue status popup with templates breakdown, next batch preview, estimated send times, and daily limit progress
  • Consecutive errors auto-pause: configurable limit that automatically pauses the queue after repeated failures and notifies the admin
  • Estimated completion time calculation for ongoing sends
  • Remove individual users from specific template queues

• Welcome Email Management: Dedicated interface for managing welcome emails:

  • View pending welcome email registrations
  • Manage scheduled welcome emails
  • Cleanup tools for old or stuck registrations
  • Unified management interface

• Notifications System: Built-in notification management:

  • User notification preferences
  • Subscription management links in emails
  • Unsubscribe functionality
  • Integration with USERSPN plugin for enhanced user management

• Multilingual Support: Fully translation-ready:

  • Translation files included for Spanish (ES), Catalan (CA), Basque (EU), Galician (GL), Italian (IT), and Portuguese (PT)
  • Uses WordPress i18n standards
  • Easy to translate with Loco Translate or similar tools

• Security Features:

  • Nonce verification for all AJAX requests
  • Input sanitization and validation
  • KSES filtering for HTML content
  • Secure SMTP password storage
  • Permission checks throughout

• Cron Job Management: Automated background processing:

  • Daily cleanup tasks (removed users, old logs)
  • Every 10 minutes email queue processing
  • Weekly maintenance tasks
  • Scheduled email processing
  • WooCommerce automated email processing

• Onboarding Tutorial: Interactive 5-step tutorial overlay for first-time users covering Email Contents, Email Design, SMTP Configuration, and key features. Includes progress bar, skip/back/next navigation, and section highlighting.

• Deliverability Analysis Tools: Built-in diagnostic suite:

  • SPF, DKIM (5 common selectors), DMARC, and MX record verification with a 0-100 score
  • Email header analysis for pasted headers (SPF/DKIM/DMARC results, spam flags)
  • External service test email sender for use with mail-tester.com
  • User notification management: search users, toggle notification status, view per-user sending statistics (sent, opened, clicked, detailed history)

• Form Builder Integration: Advanced form building capabilities:

  • Multiple input types (text, email, select, textarea, file uploads, images, videos, audio)
  • Native file upload input support with accept attribute
  • Conditional fields
  • Multi-field groups
  • Password strength checker
  • Range inputs with visual feedback
  • Star rating inputs
  • Section labels with customizable colors
  • Colored collapsible sections with CSS variable theming

• Public-Facing Features:

  • Email subscription management popups
  • Unsubscribe functionality
  • Click tracking redirects
  • Open tracking endpoints
  • Public shortcodes for notifications

• Developer-Friendly:

  • Well-structured codebase following WordPress coding standards
  • Extensible with filters and hooks
  • Custom post types for emails and records
  • Custom taxonomies for organization
  • REST API endpoints for tracking

Perfect for bloggers, small businesses, e-commerce stores, and marketers who need a comprehensive email management solution without the complexity of external services. The plugin integrates seamlessly with WordPress and provides all the tools you need to create, send, track, and manage your email campaigns effectively.

Credits

This plugin stands on the shoulders of giants

Owl Carousel v2.3.4
Licensed under: SEE LICENSE IN https://github.com/OwlCarousel2/OwlCarousel2/blob/master/LICENSE
Copyright 2013-2018 David Deutsch
https://owlcarousel2.github.io/OwlCarousel2/
https://github.com/OwlCarousel2/OwlCarousel2/blob/develop/dist/owl.carousel.js

Trumbowyg v2.27.3 – A lightweight WYSIWYG editor
alex-d.github.io/Trumbowyg/
License MIT – Author : Alexandre Demode (Alex-D)
https://github.com/Alex-D/Trumbowyg/blob/develop/src/ui/sass/trumbowyg.scss
https://github.com/Alex-D/Trumbowyg/blob/develop/src/ui/sass/trumbowyg.scss
https://github.com/Alex-D/Trumbowyg/blob/develop/src/trumbowyg.js

Developers

This section provides comprehensive documentation for developers who want to integrate or extend the MAILPN plugin functionality.

Plugin Structure

• Main File: mailpn.php
• Version: 1.0.85
• Constants: MAILPN_VERSION, MAILPN_DIR, MAILPN_URL, MAILPN_CPTS
• Custom Post Types: mailpn_mail (emails), mailpn_rec (records)

Sending Emails Programmatically

Using Shortcode (Recommended)

The primary method to send emails is through the [mailpn-sender] shortcode:

`

do_shortcode(‘[mailpn-sender
mailpn_type=”email_welcome”
mailpn_user_to=”1″
mailpn_subject=”Email Subject”
mailpn_id=”123″
mailpn_once=”1″
]Email content here[/mailpn-sender]’);
`

Parameters:
* mailpn_user_to (required): User ID or email address
* mailpn_id (optional): Post ID of type mailpn_mail
* mailpn_type (optional): Email type (email_welcome, email_published_content, email_coded, etc.)
* mailpn_subject (optional): Email subject line
* mailpn_once (optional): Set to 1 to send only once per user
* post_id (optional): Related post ID
* post_parent_id (optional): Parent post ID
* mailpn_attachments_paths (optional): File paths to attach. Accepts array, serialized string, or comma-separated paths. Each path is validated with file_exists() before attaching.

Using PHP Class Directly

`

$mailing = new MAILPN_Mailing();
$result = $mailing->mailpn_sender([
‘mailpn_user_to’ => 1,
‘mailpn_id’ => 123,
‘mailpn_type’ => ’email_welcome’,
‘mailpn_subject’ => ‘Welcome’,
‘mailpn_once’ => 1
], ‘Email content’);
<h3>Available Shortcodes</h3><h3>Content Shortcodes</h3>*[mailpn-text query=”addressee_name” user_id=”1″]- Display user data (name, email, ID, nickname)
*[user-name]- Display recipient's name
*[post-name]- Display post title with link
*[new-contents]- Display recently published content
*[mailpn-contents post_id=”123″]- Display content based on email type<h3>Utility Shortcodes</h3>*[mailpn-mail]- Render complete email
*[mailpn-call-to-action]- Call-to-action button
*[mailpn-notifications]- Notification system
*[mailpn-notifications-counter]- Notification counter<h3>Configuration Options</h3>
Access plugin settings using WordPressget_option():<h3>SMTP Configuration</h3>*mailpn_smtp_enabled- Enable/disable SMTP ('on'/'off')
*mailpn_smtp_wp_native_emails- Use SMTP for native WordPress emails ('on'/'off'). When on, password recovery, new user notification, comment notifications, admin notifications and any other wp_mail() call use SMTP.
*mailpn_smtp_host- SMTP host address
*mailpn_smtp_port- SMTP port number
*mailpn_smtp_secure- Security type ('tls', 'ssl', or 'none')
*mailpn_smtp_username- SMTP username
*mailpn_smtp_password- SMTP password<h3>Sending Limits</h3>*mailpn_sent_every_ten_minutes- Emails per 10 minutes (default: 5)
*mailpn_sent_every_day- Daily email limit (default: 500)<h3>Sender Information</h3>*mailpn_from_name- Sender name
*mailpn_from_email- Sender email address<h3>Email Exceptions</h3>*mailpn_exception_emails- Enable exception system ('on'/'off')
*mailpn_exception_emails_domains- Exclude email domains
*mailpn_exception_emails_addresses- Exclude specific email addresses<h3>Tracking & Deliverability</h3>*mailpn_click_tracking- Enable click tracking ('on'/'off')
*mailpn_open_tracking- Enable open tracking ('on'/'off'). Warning: May affect spam score. Disable for better deliverability.<h3>Error Handling</h3>*mailpn_errors_to_admin- Send error notifications to admin ('on'/'off')
*mailpn_consecutive_errors_limit- Max consecutive send failures before auto-pausing the queue (default: 10)<h3>Email Design</h3>*mailpn_font_family- Email font family
*mailpn_font_size_desktop- Desktop font size (px)
*mailpn_font_size_mobile- Mobile font size (px)
*mailpn_heading_size_h1/h2/h3- Heading sizes (px)
*mailpn_line_height- Line height
*mailpn_background_color- Email background color
*mailpn_text_color- Email text color
*mailpn_button_bg_color- Button background color
*mailpn_button_text_color- Button text color
*mailpn_button_border_radius- Button border radius (px)
*mailpn_header_bg_color- Header background color
*mailpn_footer_bg_color- Footer background color
*mailpn_footer_text_color- Footer text color<h3>WooCommerce</h3>*mailpn_wc_emails_wrapper` – Wrap WooCommerce emails with MailPN template (‘on’/’off’)

Email Queue Management

Queue System

// Get current queue
$queue = get_option('mailpn_queue'); // Array: [mail_id => [user_ids]]

// Process queue manually
$mailing = new MAILPN_Mailing();
$mailing->mailpn_queue_process();

// Check queue status
$paused = get_option('mailpn_queue_paused'); // 'on' if paused
    `

Adding Emails to Queue

$mail_id = 123;
$users = get_users([‘fields’ => ‘ids’]);
$queue = get_option(‘mailpn_queue’, []);

foreach ($users as $user_id) {
$queue[$mail_id][] = $user_id;
}

update_option(‘mailpn_queue’, $queue);
// Queue is processed automatically via cron every 10 minutes
`

Tracking and Analytics

Click Tracking

“`
// Automatically replace links with tracking (built-in)
// Or manually:
$content = MAILPN_Click_Tracking::replace_links($content, $mail_id, $user_id);

// Track click manually
MAILPN_Click_Tracking::track_click($mail_id, $user_id, $url);
<h3>Open Tracking</h3>Open tracking is automatic via tracking pixel. Data is stored inmailpn_reccustom post type.<h3>Statistics</h3>Access statistics via AJAX action:wp_ajax_mailpn_get_statistics(requires proper permissions)<h3>Hooks and Filters</h3><h3>Actions</h3>*mailpn_form_save- Fired when forms are saved (params: $entity_id, $form_data, $form_type, $form_subtype, $post_type)
*mailpn_cron_daily- Daily cron task
*mailpn_cron_ten_minutes- Every 10 minutes cron task
*mailpn_cron_weekly- Weekly cron task<h3>Filters</h3>*wp_mail_from- Customize sender email
*wp_mail_from_name- Customize sender name
*retrieve_password_message` …