EliteDevs Invoice Generator

A professional WordPress plugin for creating, managing, and tracking invoices with a beautiful frontend form and comprehensive admin panel.

🌟 Features

Frontend Invoice Creation

• Beautiful Invoice Form - Modern, responsive design with gradient styling
• Real-time Calculations - Automatic subtotal, tax, and total calculations
• International Phone Input - Built-in country code selector
• Dynamic Item Management - Add/remove invoice items on the fly
• Live Preview - See invoice before saving
• PDF Generation - Download invoices as PDF
• Access Control - Admin-only access with user-friendly error messages

Admin Panel

• Invoice Management Dashboard - View all invoices with statistics
• Quick Status Changes - Update invoice status without opening edit page
• Bulk Actions - Update multiple invoices at once
• Advanced Filtering - Filter by status, search by client/invoice number
• Detailed Invoice View - Professional invoice display
• Edit Invoices - Full editing capabilities
• Revenue Tracking - Automatic revenue calculation from paid invoices

Invoice Statuses

• Pending (Orange) - Newly created invoices
• Sent (Blue) - Invoices sent to clients
• Paid (Green) - Confirmed payments
• Cancelled (Red) - Cancelled invoices

Customization Options

• Company Details - Logo, name, address, contact info
• Invoice Styling - Custom colors (background, primary, accent)
• Tax Settings - Enable/disable tax, custom tax rate and label
• Currency Settings - Custom symbol and position
• Invoice Numbering - Custom prefix and starting number
• Footer Text - Custom footer message
• Signature - Upload company signature

📋 Requirements

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

🚀 Installation

Method 1: Upload via WordPress Admin

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

Method 2: Manual Installation

1. Download the plugin ZIP file
2. Extract the ZIP file
3. Upload the elitedevs-invoice-generator folder to /wp-content/plugins/
4. Go to WordPress Admin → Plugins
5. Find "EliteDevs Invoice Generator" and click Activate

Method 3: Clone from GitHub

cd wp-content/plugins/
git clone https://github.com/YOUR-USERNAME/elitedevs-invoice-generator.git

📖 Usage

Initial Setup

1. Configure Company Details

   • Go to Invoices → Settings
   • Fill in your company information
   • Upload logo and signature (optional)
   • Set currency and tax preferences

2. Create Frontend Page

   • Create a new page in WordPress
   • Add the shortcode: [elitedevs_invoice_form]
   • Publish the page
   • Only administrators can access this page

Creating Invoices

Via Frontend Form

1. Navigate to your invoice creation page
2. Fill in client details
3. Add invoice items (description, quantity, price)
4. Add notes (optional)
5. Click Generate Invoice to preview
6. Click Save Invoice to save to database
7. Click Download PDF to get PDF version

Via Admin Panel

1. Go to Invoices → All Invoices
2. Click Create New Invoice (if implemented)
3. Fill in all details
4. Click Save

Managing Invoices

Quick Status Changes

• Hover over any invoice number
• Click status action (e.g., "Mark Sent", "Mark Paid")
• Status updates immediately

Bulk Actions

1. Select multiple invoices (checkboxes)
2. Choose action from dropdown
3. Click Apply

Filtering

• Use status dropdown to filter by status
• Use search box to find by client name, email, or invoice number

Statistics Dashboard

The dashboard shows:

• Total Invoices - All invoices in system
• Pending - Awaiting action
• Sent - Sent to clients
• Paid - Confirmed payments
• Total Revenue - Sum of paid invoices only

🎨 Customization

Shortcode

[elitedevs_invoice_form]

Styling

The plugin uses CSS custom properties for easy customization:

:root {
    --primary-color: #1e73be;
    --secondary-color: #195d99;
    --success-color: #10b981;
    --danger-color: #ef4444;
}

You can override these in your theme's CSS.

Hooks & Filters

(Coming soon - will document available hooks for developers)

📊 Database Structure

The plugin creates one table: wp_elitedevs_invoices

Columns:

• id - Primary key
• invoice_number - Unique invoice number
• client_name - Client name
• client_email - Client email
• client_phone - Client phone
• client_address - Client address
• invoice_date - Invoice date
• due_date - Payment due date
• items - JSON encoded items array
• subtotal - Subtotal amount
• tax_amount - Tax amount
• total_amount - Total amount
• notes - Invoice notes
• status - Invoice status (pending/sent/paid/cancelled)
• created_at - Creation timestamp
• updated_at - Last update timestamp

🔒 Security Features

• ✅ Nonce verification on all forms
• ✅ Capability checks (manage_options)
• ✅ Data sanitization and validation
• ✅ Prepared SQL statements
• ✅ CSRF protection
• ✅ XSS prevention
• ✅ Access control on frontend form

🛠️ Development

File Structure

elitedevs-invoice-generator/
├── admin/
│   └── views/           # Admin view templates
├── assets/
│   ├── admin/
│   │   ├── css/        # Admin styles
│   │   └── js/         # Admin scripts
│   └── frontend/
│       ├── css/        # Frontend styles
│       └── js/         # Frontend scripts
├── frontend/
│   └── views/          # Frontend view templates
├── includes/
│   ├── Admin/          # Admin classes
│   ├── Frontend/       # Frontend classes
│   ├── Activator.php   # Plugin activation
│   ├── Deactivator.php # Plugin deactivation
│   ├── Invoice_Manager.php # CRUD operations
│   └── Plugin.php      # Main plugin class
└── elitedevs-invoice-generator.php # Plugin entry point

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📝 Changelog

Version 1.0.0 (2026-01-19)

• Initial release
• Frontend invoice creation form
• Admin invoice management
• Quick status changes
• Bulk actions
• PDF generation
• Revenue tracking
• Access control

📄 License

This plugin is licensed under the GPL v2 or later.

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

👨‍💻 Author

EliteDevs

🙏 Acknowledgments

• WordPress community
• Contributors and testers
• Open source libraries used

📞 Support

For support, please open an issue on GitHub or contact through WordPress.org plugin page.

🔗 Links

• GitHub Repository
• WordPress.org Plugin Page (Coming soon)
• Documentation (Coming soon)

---

Made with ❤️ by EliteDevs