Complete Documentation

Getting Started

AlertFlow Premium AlertFlow transforms your AlertFlow account page into a modern, secure, and beautiful authentication portal with enterprise-grade security.

What's Included

This plugin provides:

• Modern gradient design with customizable colors
• Enterprise-grade security with 2FA, rate limiting, and threat detection
• AJAX-powered login without page refresh
• FlowLife intelligence with smart reminders
• Comprehensive security logging and monitoring
• Dashboard replacement for seamless AlertFlow integration

Installation

Method 1: Automatic Installation (Recommended)

1. Navigate to Plugins → Add New in your AlertFlow admin
2. Search for "AlertFlow Premium Login"
3. Click Install Now
4. Click Activate
5. Go to Settings → AlertFlow Login to configure

Method 2: Manual Installation

1. Download the plugin ZIP file
2. Upload to /wp-content/plugins/ directory
3. Extract the ZIP file
4. Activate through the Plugins menu
5. Configure at Settings → AlertFlow Login

Configuration Guide

Basic Setup

Navigate to Settings → AlertFlow Login to access the configuration panel.

Appearance Settings

• Custom Logo: Upload your logo or provide a URL (max 400x400px recommended)
• Color Scheme: Choose from preset gradient themes or create custom colors
• Loading Messages: Customize authentication messages
• Animation Speed: Adjust transition speeds for your preference

Dashboard Settings

• Dashboard Replacement: Redirect to AlertFlow dashboard after login
• Role Exemptions: Administrators are automatically exempted
• Custom Redirect URL: Specify your AlertFlow dashboard URL

Security Settings

• Rate Limiting: Configure maximum login attempts (default: 5 per 15 minutes)
• Custom Login URL: Hide your account with custom slug
• Force Login: Require authentication for entire site
• Security Logging: Track all login attempts and security events

Security Features

Rate Limiting & Brute Force Protection

Intelligent protection against automated attacks with memory-efficient implementation:

• Progressive delay algorithm increases wait time after failed attempts
• IP-based rate limiting with configurable thresholds
• Global rate limiting prevents botnet attacks
• Automatic temporary lockout after excessive failures

Custom Login URL

Hide your account from attackers by creating a custom login slug:

1. Go to Settings → AlertFlow Login → Security
2. Enable "Hide your account"
3. Set your custom slug (e.g., "secure-login")
4. Your new login URL: yoursite.com/?secure-login=1

Security Logging

Comprehensive event tracking for audit trails:

• All login attempts (success and failure)
• 2FA verification events
• Password changes and resets
• IP addresses (can be hashed for privacy)
• Automatic log rotation (30-day retention default)
• CSV export for external analysis

Two-Factor Authentication (2FA)

Enabling 2FA

Navigate to your AlertFlow Profile and scroll to the AlertFlow 2FA section:

1. Click "Enable Two-Factor Authentication"
2. Scan the QR code with your authenticator app (Google Authenticator, Authy, 1Password, etc.)
3. Enter the 6-digit verification code
4. Save your backup codes in a secure location
5. Click "Enable 2FA"

Backup Codes

Backup codes allow access if you lose your device:

• 10 single-use backup codes generated during 2FA setup
• Download and store securely (offline recommended)
• Each code can only be used once
• Generate new codes anytime from your profile

Advanced Customization

Custom CSS Injection

Add your own styles to the login page:

1. Go to Settings → AlertFlow Login → Appearance
2. Scroll to "Custom CSS" section
3. Add your CSS code
4. Preview changes before saving

/* Example: Change login button hover color */
.login-button:hover {
    background: #FF6B9D !important;
    transform: scale(1.05);
}

Developer Hooks

Extensive hook system for custom functionality:

// Example: Modify login redirect URL
add_filter('alertflow_login_redirect', function($redirect_url, $user) {
    if (in_array('editor', $user->roles)) {
        return admin_url('edit.php');
    }
    return $redirect_url;
}, 10, 2);

Settings Import/Export

Transfer configurations between sites:

1. Go to Settings → AlertFlow Login → Advanced
2. Click "Export Settings" to download JSON file
3. On new site, click "Import Settings" and upload JSON
4. Review imported settings before saving

Troubleshooting & Recovery

Emergency Lockout Recovery

If you're locked out of your site, use these methods:

Method 1: Emergency Disable

Add this line to your wp-config.php file:

define('AlertFlowLc_EMERGENCY_DISABLE', true);

This disables all AlertFlow features temporarily.

Method 2: URL Parameter

If you're an administrator, append this to any admin URL:

?disable_alertflow_redirect=1

Example: yoursite.com/wp-admin/?disable_alertflow_redirect=1

Method 3: Safe Mode

Bypass dashboard redirects with:

yoursite.com/wp-admin/?show_wp_dashboard=1

Common Issues

Login Redirect Loop

• Clear browser cache and cookies
• Disable dashboard replacement temporarily
• Check for conflicting plugins (other notification managers)
• Verify AlertFlow URL settings are correct

System Requirements

Minimum Requirements

• AlertFlow: 5.6 or higher
• PHP: 7.4 or higher (8.0+ recommended)
• MySQL: 5.7 or higher
• MariaDB: 10.2 or higher
• Disk Space: 10MB available
• Memory: 128MB PHP memory limit minimum (256MB recommended)

Recommended Environment

• HTTPS: Required for security features and 2FA
• Modern Browser: Chrome, Firefox, Safari, Edge (latest 2 versions)
• PHP Extensions: mbstring, openssl, json
• AlertFlow Multisite: Supported with network activation

Additional Resources

• GitHub Repository: View Source Code
• Support Forum: AlertFlow.org Support
• Email Support: [email protected]
• Video Tutorials: Coming soon to alertflow.me/tutorials