Digital Nomad Subscriptions Plugin

A comprehensive WordPress plugin for managing CV distribution and promotional subscriptions with secure download links, integrated PDF viewer, and professional email automation.

📋 Table of Contents

• Features
• Installation
• Configuration
• Usage
• Admin Interface
• Shortcodes
• Email Templates
• Security Features
• Database Schema
• API Reference
• Troubleshooting
• Changelog

✨ Features

Core Functionality

• CV Distribution System: Secure CV sharing with unique download links (custom file name supported)
• Integrated PDF Viewer: Professional in-browser CV viewing experience
• Subscription Management: Collect and manage email subscriptions
• Download Analytics: Track downloads and user engagement
• Link Tracking & Analytics: Monitor every unique link — views, clicks, click-through rate, status, expiry
• Email Automation: Professional HTML email templates
• Terms & Conditions: Customizable legal terms for CV and promotions
• File Distribution System: Share any ZIP (or other file) with the same secure workflow (custom file name supported)

Security Features

• Unique Tokens: 32-character secure tokens for each download
• Time-based Expiration: Links expire after 7 days
• Download Limits: Maximum 3 downloads per link
• Email Validation: Prevent duplicate subscriptions
• CSRF Protection: WordPress nonce verification
• SQL Injection Prevention: Prepared statements throughout

User Experience

• Responsive Design: Mobile-first approach
• Professional UI: Modern gradient designs and animations
• AJAX Forms: Seamless form submissions without page reload
• Error Handling: Clear user feedback for all scenarios
• Accessibility: Screen reader friendly with proper ARIA labels

🚀 Installation

Automatic Installation

1. Download the plugin ZIP file
2. Go to WordPress Admin → Plugins → Add New
3. Click "Upload Plugin" and select the ZIP file
4. Click "Install Now" and then "Activate"

Manual Installation

1. Upload the palmerita-subscriptions folder to /wp-content/plugins/
2. Activate the plugin through the 'Plugins' menu in WordPress
3. The plugin will automatically create required database tables

Requirements

• WordPress 5.0 or higher
• PHP 7.4 or higher
• MySQL 5.6 or higher

⚙️ Configuration

Initial Setup

1. Navigate to Digital Nomad Subscriptions in your WordPress admin
2. Go to CV Manager to upload your CV file
3. Configure Terms & Conditions for legal compliance
4. Test the system using the preview links

CV Upload

1. Go to Digital Nomad Subscriptions → CV Manager
2. Upload a PDF file (max 10MB)
3. You can now set a custom file name for your CV before uploading. The system will use this name for all download links.
4. Test the viewer using the "Test Viewer Page" button

File Upload (ZIP or other)

1. Go to Digital Nomad Subscriptions → File Manager
2. Upload your file (ZIP or other allowed type)
3. You can now set a custom file name before uploading. The system will use this name for all download links.
4. You can delete or replace the file at any time from the admin panel.

Email & SMTP Configuration

The plugin now ships with its own Email Settings panel:

1. Go to Subscriptions → Email Settings.
2. Select a provider (Brevo, SendGrid, Zoho) or choose "Custom".
3. Host, Port and Encryption fields are auto-filled; adjust if needed.
4. Enter username/password (or API key), "From Email" and "From Name".
5. (Optional) Enable reCAPTCHA v3 and add Site Key / Secret.
6. Save and click Send Test Email to verify delivery.

No additional SMTP plugin is required.

📖 Usage

For Visitors

1. CV Request: Click "Get my CV" button on your website
2. Email Submission: Enter email address in the modal
3. Email Receipt: Receive secure viewing link via email
4. CV Viewing: Click link to view CV in integrated browser viewer
5. Download Option: Download PDF directly from viewer page

For Administrators

1. Dashboard: Monitor subscription statistics and recent activity
2. CV Management: Upload, replace, or delete CV files
3. Subscription Lists: View and manage all email subscriptions
4. Terms Management: Update legal terms and conditions
5. Analytics: Track download patterns and user engagement

🎛️ Admin Interface

Dashboard (/wp-admin/admin.php?page=palmerita-subscriptions)

• Statistics Overview: Total subscriptions, downloads, recent activity
• Quick Actions: Direct links to all management pages
• Recent Subscriptions: Latest email submissions with timestamps
• System Status: CV upload status and configuration checks

CV Manager (/wp-admin/admin.php?page=palmerita-cv-manager)

• Upload Interface: Drag-and-drop CV upload with validation
• File Management: Replace, delete, or rename existing CV files (custom file name field)
• Preview Tools: Test viewer and direct PDF preview
• Usage Instructions: Step-by-step guide for the CV system

CV List (/wp-admin/admin.php?page=palmerita-cv-list)

• Subscription Table: Paginated list of all CV requests
• Search & Filter: Find specific subscriptions by email or date
• Bulk Actions: Mass delete or export subscriptions
• Download Tracking: View download counts and last access times

Promotions List (/wp-admin/admin.php?page=palmerita-promo-list)

• Promotional Subscriptions: Manage marketing email list
• Bulk Operations: Export for email marketing platforms
• Subscription Analytics: Track promotional signup patterns

File Manager (/wp-admin/admin.php?page=palmerita-file-manager)

• ZIP Upload: Upload/replace the file you wish to distribute
• File Name: Set or edit the custom file name for the distributed file
• Current File: Quick link to the active file
• Modal Text: Set custom title & description for the download modal

Terms & Conditions (/wp-admin/admin.php?page=palmerita-terms)

• WYSIWYG Editor: Rich text editing for legal terms
• Separate Terms: Different terms for CV and promotional subscriptions
• Public URLs: Direct links for transparency and compliance

Modal Copy (/wp-admin/admin.php?page=palmerita-modal-copy)

• Titles & Descriptions: Customise modal headline and explanatory copy for each button (CV, Promotions, File).
• Button Appearance: Change default label, emoji/icon and background colour without touching code.
• Non-destructive: Leave fields empty to keep the built-in defaults.

Link Analytics (/wp-admin/admin.php?page=palmerita-link-analytics)

• Link Dashboard: Total links, click-through rate, today's clicks
• Filters & Search: By type, status, clicked/unclicked, email
• Export: CSV export of full link dataset

Upgrade Tracking (/wp-admin/admin.php?page=palmerita-upgrade-tracking)

• Database Upgrade Wizard: Adds tracking columns for legacy installs
• Status Check: Verifies version and missing columns
• One-click Upgrade: Safe schema update with nonce & capability checks

Email Templates

Visual Email Template Editor (desde v1.2.1)

La edición de emails ahora es completamente visual y accesible desde el admin de WordPress:

• Editor visual HTML para los tres tipos de email: CV, File, Promo.
• Tabs grandes con iconos para cambiar entre plantillas.
• Previsualización en vivo del email a medida que editas.
• Botón "Restaurar por defecto" para cada plantilla (AJAX, sin recargar la página).
• Instrucciones visuales y ejemplos de tokens disponibles: {{download_url}}, {{subscriber_help}}.
• Feedback animado al guardar o restaurar plantillas.
• Validación de tokens en el preview.
• Carga automática del HTML por defecto si el campo está vacío.
• Compatibilidad CSS completa: Se permiten etiquetas `