Mailing Manager – PN
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’); Available Shortcodes Content Shortcodes *[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 Utility Shortcodes *[mailpn-mail]- Render complete email *[mailpn-call-to-action]- Call-to-action button *[mailpn-notifications]- Notification system *[mailpn-notifications-counter]- Notification counter Configuration Options Access plugin settings using WordPressget_option(): SMTP Configuration *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 Sending Limits *mailpn_sent_every_ten_minutes- Emails per 10 minutes (default: 5) *mailpn_sent_every_day- Daily email limit (default: 500) Sender Information *mailpn_from_name- Sender name *mailpn_from_email- Sender email address Email Exceptions *mailpn_exception_emails- Enable exception system ('on'/'off') *mailpn_exception_emails_domains- Exclude email domains *mailpn_exception_emails_addresses- Exclude specific email addresses Tracking & Deliverability *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. Error Handling *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) Email Design *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 WooCommerce *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); Open Tracking Open tracking is automatic via tracking pixel. Data is stored inmailpn_reccustom post type. Statistics Access statistics via AJAX action:wp_ajax_mailpn_get_statistics(requires proper permissions) Hooks and Filters Actions *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 Filters *wp_mail_from- Customize sender email *wp_mail_from_name- Customize sender name *retrieve_password_message` …
