← Back to Documentation

👨‍💼 Admin Panel

Manage subscribers, export data, and handle GDPR requests with the powerful admin dashboard

Accessing the Admin Panel

Admin Panel URL:
https://yourdomain.com/admin.php

First-Time Login

Use the admin password you configured in config.php:

// Default password (CHANGE IMMEDIATELY!) define('ADMIN_PASSWORD', 'admin123'); // Your secure password define('ADMIN_PASSWORD', 'your_secure_password_here');
⚠️ Security Warning: Change the default password immediately! Never use 'admin123' in production.

Admin Dashboard Features

📊 Statistics Dashboard
View subscriber count, today's date, and GDPR compliance status
📧 Email Management
View all collected emails with timestamps and subscriber numbers
📤 Data Export
Export emails as CSV or complete GDPR JSON export
🗑️ Individual Deletion
GDPR-compliant email removal with confirmation
🎨 Themed Background
Matches your selected theme with glassmorphism design
🔐 GDPR Tools
Complete data subject rights management

Dashboard Sections

📊 Statistics Cards

The top section displays key metrics in glassmorphism cards:

  • Total Subscribers: Current email count
  • Today's Date: Current date for reference
  • GDPR Compliant: Compliance status indicator
[Screenshot: Statistics cards with translucent design]

🔐 GDPR Data Subject Rights

Dedicated section for privacy compliance:

  • Export All Data (JSON): Complete GDPR export with metadata
  • Export Emails (CSV): Simple spreadsheet format
  • Compliance Notice: Information about data processing
JSON Export Includes:
  • Export date and timestamp
  • Data controller information
  • Purpose and lawful basis
  • Retention policy details
  • All subscriber data with timestamps

📧 Email List Management

Comprehensive email management interface:

Email Display Format:

  • Email Address: Subscriber's email
  • Timestamp: When they subscribed (if enabled)
  • Subscriber Number: Sequential numbering (#1, #2, etc.)
  • Delete Button: GDPR-compliant removal option
[Screenshot: Email list with glassmorphism styling and hover effects]

Data Export Options

1

CSV Export

Simple spreadsheet format perfect for:

  • Email marketing tools
  • Newsletter services
  • Analytics and reporting
  • Data backup
2

JSON Export (GDPR)

Complete data export including:

  • Legal compliance metadata
  • Data processing purpose
  • Retention policy details
  • Export timestamp

Email Management Workflow

📥 Viewing Subscriber Data

  1. Login to admin panel with your password
  2. View statistics in the top cards
  3. Scroll down to see the complete email list
  4. Each email shows address, timestamp, and subscriber number

📤 Exporting Data

  1. Choose your export format (CSV or JSON)
  2. Click the appropriate export button
  3. File downloads automatically with timestamp in filename
  4. Open in spreadsheet app or text editor

🗑️ Deleting Emails (GDPR Right to Erasure)

  1. Locate the email address to delete
  2. Click the "Delete (GDPR)" button next to it
  3. Confirm deletion in the popup dialog
  4. Email is permanently removed and page updates
Deletion Warning: Email deletions are permanent and cannot be undone. This complies with GDPR "right to erasure" requirements.

Security Features

🔒 Authentication & Sessions

  • Password Protection: Configurable admin password
  • Session Management: Automatic timeout for security
  • Secure Logout: Proper session destruction
  • Login Validation: Prevents unauthorized access

🛡️ Data Protection

  • File Protection: .htaccess prevents direct email file access
  • CSRF Protection: Validates all form submissions
  • Input Sanitization: Prevents malicious data injection
  • Secure Headers: XSS and clickjacking protection

Troubleshooting Admin Issues

❌ Can't Access Admin Panel

// Check these common issues: 1. Verify admin.php was uploaded correctly 2. Check file permissions (644 for admin.php) 3. Ensure PHP sessions are enabled 4. Clear browser cache and cookies 5. Try incognito/private browsing mode

❌ Login Not Working

// Verify password in config.php: define('ADMIN_PASSWORD', 'your_password_here'); // Common issues: - Extra spaces in password - Case sensitivity - Special characters not escaped properly - Browser auto-fill using wrong password

❌ Session Expires Too Quickly

// Increase session timeout in config.php: define('SESSION_TIMEOUT', 120); // 2 hours instead of 1 // Or disable timeout: define('SESSION_TIMEOUT', 0); // No automatic logout

❌ Export Not Working

// Check these items: 1. Browser popup blockers 2. Download folder permissions 3. PHP output buffering settings 4. Server memory limits 5. Large email list size

Admin Panel Customization

🎨 Theme Integration

The admin panel automatically matches your site's theme:

⚙️ Configuration Options

// Customize admin behavior in config.php: // Session timeout define('SESSION_TIMEOUT', 60); // Debug mode (show errors) define('DEBUG_MODE', false); // Email file location define('EMAIL_FILE', 'emails.txt'); // GDPR compliance features define('GDPR_ENABLED', true);

Best Practices

✅ Security Best Practices

  • Strong Password: Use complex, unique admin password
  • Regular Exports: Backup email data regularly
  • Monitor Access: Check admin panel access logs
  • Update Regularly: Keep script updated to latest version
  • HTTPS: Use SSL certificate for admin access

📊 Data Management Tips

  • Regular Exports: Download data before major launches
  • GDPR Compliance: Honor deletion requests promptly
  • Data Quality: Review emails for validity before export
  • Privacy: Only access admin panel when necessary
  • Documentation: Keep records of data processing activities

Advanced Features

🔄 Automated Workflows

Consider these enhancements for production use:

[Screenshot: Admin panel showing glassmorphism design with theme integration]
← Theme System GDPR Compliance →