@extends('layouts.app')

@section('content')

{{-- Hero --}}
<section class="bg-white">
    <div class="max-w-7xl mx-auto px-6 pt-14 pb-16">
        <div class="grid lg:grid-cols-2 gap-12 items-start">
            <div>
                <span class="inline-block mb-4 text-sm font-semibold text-indigo-600 uppercase tracking-wide">Free Plugin</span>
                <h1 class="text-4xl md:text-5xl font-semibold tracking-tight leading-tight text-gray-900">
                    Free Agency Invoice Plugin
                </h1>
                <p class="mt-6 text-lg text-gray-600 leading-relaxed">
                    Everything a professional agency needs to create invoices, accept payments, and manage clients — fully functional, completely free.
                </p>
                <div class="mt-8 flex flex-wrap gap-4">
                    <a href="/download" class="px-6 py-3 bg-indigo-600 text-white rounded-lg font-medium hover:bg-indigo-700 transition">
                        Download Free Plugin
                    </a>
                    <a href="/products" class="px-6 py-3 bg-gray-100 text-gray-800 rounded-lg font-medium hover:bg-gray-200 transition">
                        ← All Products
                    </a>
                </div>
            </div>
            <div class="flex items-center justify-center">
                <img src="{{ asset('images/boxes/invoice-plugins-showcase-486x265.png') }}"
                     alt="Agency Pulse Free Invoice Plugin"
                     class="w-full rounded-xl shadow-sm">
            </div>
        </div>
    </div>
</section>

{{-- Feature Groups --}}
<section class="bg-gray-50 border-t border-gray-200">
    <div class="max-w-7xl mx-auto px-6 py-16 space-y-8">

        <div class="bg-white border border-gray-200 rounded-xl p-8 hover:shadow-md transition">
            <h2 class="text-xl font-semibold text-gray-900 mb-5 flex items-center gap-2">
                <span>📄</span> Invoice Builder &amp; Management
            </h2>
            <ul class="space-y-3 text-gray-700 text-sm leading-relaxed list-disc list-inside">
                <li class="developer"><strong>Custom Post Type Architecture</strong>: A dedicated <code class="bg-gray-100 px-1 rounded text-xs">agency_pulse_invoice</code> Custom Post Type powers the entire invoicing system, deeply integrated within the WordPress dashboard.</li>
                <li><strong>Rich Line-Item Editor</strong>: A fully dynamic, in-admin invoice builder for composing line items with descriptions, quantities, unit prices, and per-line totals &mdash; all calculated in real time.</li>
                <li><strong>Invoice Status Lifecycle</strong>: A complete status system covering Draft, Pro Forma, Unpaid, Partial, and Paid &mdash; each with distinct workflow rules, display logic, and protection against accidental changes.</li>
                <li><strong>Invoice Locking &amp; Guardrails</strong>: Issued invoices (Unpaid, Partial, Paid) are automatically locked for editing in the admin, with a clear notice bar, per-metabox overlays, and a dedicated &ldquo;Reopen Invoice&rdquo; action.</li>
                <li><strong>Auto-Number Generation</strong>: Automatically generates a unique, sequential invoice number when an invoice is first issued, ensuring a clean billing audit trail.</li>
                <li><strong>Invoice Duplication</strong>: A one-click duplicate action in the admin list view for rapidly creating new invoices based on an existing document structure.</li>
                <li><strong>Trash Protection</strong>: Prevents accidental deletion of active Unpaid or Paid invoices, enforcing data integrity for all financial records.</li>
                <li class="developer"><strong>Auto-Draft Prevention</strong>: Blocks WordPress from generating unwanted auto-draft records for the invoice post type, keeping the admin list clean and accurate.</li>
            </ul>
        </div>

        <div class="bg-white border border-gray-200 rounded-xl p-8 hover:shadow-md transition">
            <h2 class="text-xl font-semibold text-gray-900 mb-5 flex items-center gap-2">
                <span>🧮</span> Totals, Tax &amp; Multi-Currency
            </h2>
            <ul class="space-y-3 text-gray-700 text-sm leading-relaxed list-disc list-inside">
                <li><strong>Real-Time Dynamic Totals</strong>: A dedicated JavaScript engine recalculates subtotals, tax amounts, and the invoice grand total instantly as the admin modifies line items, with no page reload required.</li>
                <li><strong>Flexible Tax Rate System</strong>: Supports configuring and applying multiple named tax rates directly within the invoice builder, with per-invoice tax rate selection.</li>
                <li><strong>Multi-Currency Support</strong>: Assign a specific currency to each invoice, independent of a base store currency, with full display formatting throughout the admin and public views.</li>
                <li><strong>Exchange Rate Locking</strong>: When an invoice is issued in a non-base currency, the live exchange rate is fetched and permanently locked to the invoice record, ensuring consistent billing regardless of future market fluctuations.</li>
                <li><strong>Partial Payment Tracking</strong>: Full ledger support for recording multiple partial payments against a single invoice, with automatic balance recalculation and status promotion to &ldquo;Partial&rdquo; or &ldquo;Paid.&rdquo;</li>
                <li><strong>Payments Ledger</strong>: A dedicated metabox within the invoice editor for recording and reviewing all manual and gateway-processed payment entries against an invoice.</li>
            </ul>
        </div>

        <div class="bg-white border border-gray-200 rounded-xl p-8 hover:shadow-md transition">
            <h2 class="text-xl font-semibold text-gray-900 mb-5 flex items-center gap-2">
                <span>🔒</span> Access Control &amp; Token-Based Sharing
            </h2>
            <ul class="space-y-3 text-gray-700 text-sm leading-relaxed list-disc list-inside">
                <li><strong>User Assignment</strong>: Each invoice can be assigned to a specific WordPress user via a typeahead search, creating a secure, personalized billing relationship.</li>
                <li><strong>Frontend Query Scoping</strong>: Logged-in users on the frontend are automatically restricted to viewing only invoices assigned to their account, preventing unauthorized access to other clients&rsquo; data.</li>
                <li><strong>Secure Token Access</strong>: Generates unique, shareable access tokens for each invoice, enabling clients to view their invoice via a private URL without requiring a WordPress login.</li>
                <li class="developer"><strong>Custom Rewrite Rules</strong>: Registers clean, human-readable URL patterns specifically for token-based invoice access, ensuring compatibility across all WordPress permalink configurations.</li>
                <li class="developer"><strong>Permission-Based Role System</strong>: A dedicated <code class="bg-gray-100 px-1 rounded text-xs">invoice-admin</code> role with granular capability controls separates billing administrators from general site users.</li>
            </ul>
        </div>

        <div class="bg-white border border-gray-200 rounded-xl p-8 hover:shadow-md transition">
            <h2 class="text-xl font-semibold text-gray-900 mb-5 flex items-center gap-2">
                <span>🎨</span> Invoice Templates &amp; Design
            </h2>
            <ul class="space-y-3 text-gray-700 text-sm leading-relaxed list-disc list-inside">
                <li class="developer"><strong>Template Custom Post Type</strong>: A dedicated <code class="bg-gray-100 px-1 rounded text-xs">agency_pulse_inv_tpl</code> post type for creating, managing, and versioning multiple branded invoice layouts.</li>
                <li><strong>Default Template Provisioning</strong>: Automatically creates a professional default invoice template on plugin activation, ensuring the system is ready to use out of the box.</li>
                <li><strong>Template Engine &amp; Renderer</strong>: A dedicated rendering service dynamically binds live invoice data (client info, line items, totals, company branding) into the selected layout at render time.</li>
                <li><strong>Default Template Protection</strong>: The system default template is protected from accidental deletion or trashing, with all dangerous actions removed from its row in the admin list.</li>
                <li><strong>Template Duplication</strong>: Administrators can duplicate any existing template as a starting point for a new custom design.</li>
                <li><strong>Template Reset</strong>: A one-click action to restore the default template to its original, factory state.</li>
            </ul>
        </div>

        <div class="bg-white border border-gray-200 rounded-xl p-8 hover:shadow-md transition">
            <h2 class="text-xl font-semibold text-gray-900 mb-5 flex items-center gap-2">
                <span>🌐</span> Frontend Views &amp; Shortcodes
            </h2>
            <ul class="space-y-3 text-gray-700 text-sm leading-relaxed list-disc list-inside">
                <li><strong>Public Invoice View</strong>: A polished, client-facing invoice page rendered from the active template, including all line items, totals, branding, and an embedded payment form.</li>
                <li><strong>Client Invoice List</strong>: A frontend page displaying all invoices assigned to the currently logged-in user, with status indicators and direct links to each document.</li>
                <li><strong>Invoice Checkout Page</strong>: A dedicated secure checkout flow for clients to review and pay their outstanding invoice balance online.</li>
                <li><strong>Payment Response Page</strong>: A post-payment confirmation page that displays the outcome of a transaction (success or failure) to the client after gateway processing.</li>
                <li><strong>Print-Optimized Styles</strong>: Dedicated print stylesheets ensure invoices render cleanly and professionally when clients print or save the document as a PDF.</li>
                <li><strong>Shortcode Suite</strong>: All frontend views are available as shortcodes (<code class="bg-gray-100 px-1 rounded text-xs">[apwp_invoices_list]</code>, <code class="bg-gray-100 px-1 rounded text-xs">[apwp_invoice_detail]</code>, <code class="bg-gray-100 px-1 rounded text-xs">[apwp_payment_form]</code>, <code class="bg-gray-100 px-1 rounded text-xs">[apwp_invoice_checkout]</code>, <code class="bg-gray-100 px-1 rounded text-xs">[apwp_payment_response]</code>) for flexible page placement.</li>
                <li><strong>Gutenberg Block Suite</strong>: Every frontend view is also available as a native Gutenberg block (Invoices List, Invoice Detail, Invoice Checkout, Payment Form, Payment Response) for use in the block editor.</li>
            </ul>
        </div>

        <div class="bg-white border border-gray-200 rounded-xl p-8 hover:shadow-md transition">
            <h2 class="text-xl font-semibold text-gray-900 mb-5 flex items-center gap-2">
                <span>💳</span> Payment Gateway Architecture
            </h2>
            <ul class="space-y-3 text-gray-700 text-sm leading-relaxed list-disc list-inside">
                <li class="developer"><strong>Centralized Gateway Manager</strong>: A core <code class="bg-gray-100 px-1 rounded text-xs">GatewayManager</code> service orchestrates all registered payment gateways, providing a unified API for initialization, asset loading, and gateway discovery.</li>
                <li class="developer"><strong>Gateway Registry</strong>: A <code class="bg-gray-100 px-1 rounded text-xs">GatewayRegistry</code> component maintains the master list of all available gateways, enabling dynamic registration by companion plugins.</li>
                <li class="developer"><strong>Abstract Gateway Contract</strong>: A formal <code class="bg-gray-100 px-1 rounded text-xs">GatewayInterface</code> and <code class="bg-gray-100 px-1 rounded text-xs">AbstractGateway</code> base class define the required contract for all gateway implementations, ensuring consistent behavior across integrations.</li>
                <li><strong>Webhook Infrastructure</strong>: A dedicated webhook handling layer processes asynchronous payment notifications from external providers, enabling reliable payment confirmation without relying on browser redirects.</li>
                <li class="developer"><strong>REST API Endpoints</strong>: Built-in REST API routes for gateway-related actions, enabling secure, standardized communication between the frontend payment forms and the WordPress backend.</li>
                <li class="developer"><strong>AJAX Payment Handlers</strong>: Dedicated AJAX layer (<code class="bg-gray-100 px-1 rounded text-xs">Agency_Pulse_Invoice_Gateway_AJAX</code>) manages real-time payment initiation and response processing requests from the client-side checkout UX.</li>
                <li class="developer"><strong>Payment Capture Automation</strong>: A <code class="bg-gray-100 px-1 rounded text-xs">Payment_Captured_Handler</code> listens for the gateway payment capture hook and automatically marks the corresponding invoice as paid, triggering all downstream status updates.</li>
                <li><strong>Refund Support</strong>: An admin-accessible refund action allows processing of payment refunds directly from the invoice editor.</li>
                <li><strong>PayPal Integration</strong>: A bundled PayPal gateway implementation with a dedicated admin settings page for API credential management.</li>
                <li><strong>Stripe Integration</strong>: A bundled Stripe gateway implementation with a dedicated admin settings page for API credential management and webhook configuration.</li>
            </ul>
        </div>

        <div class="bg-white border border-gray-200 rounded-xl p-8 hover:shadow-md transition">
            <h2 class="text-xl font-semibold text-gray-900 mb-5 flex items-center gap-2">
                <span>📧</span> Email Notifications
            </h2>
            <ul class="space-y-3 text-gray-700 text-sm leading-relaxed list-disc list-inside">
                <li><strong>Invoice Available Email</strong>: A configurable email notification dispatched to clients when a new invoice is issued, with customizable subject and body templates.</li>
                <li><strong>Payment Received Email</strong>: An automated confirmation email sent to the client immediately after any successful gateway payment, providing a clear record of the transaction.</li>
                <li><strong>Dynamic Placeholder Engine</strong>: Both email templates support dynamic data substitution placeholders (customer name, amount, invoice link, transaction ID, etc.) for fully personalized communications.</li>
                <li><strong>Company &ldquo;From&rdquo; Address</strong>: Payment confirmation emails are dispatched using the business&rsquo;s configured company email address as the sender, maintaining professional branding.</li>
                <li class="developer"><strong>Extensible Email Settings Manager</strong>: A tabbed email settings interface that companion plugins can extend with additional email template configurations.</li>
            </ul>
        </div>

        <div class="bg-white border border-gray-200 rounded-xl p-8 hover:shadow-md transition">
            <h2 class="text-xl font-semibold text-gray-900 mb-5 flex items-center gap-2">
                <span>🏢</span> Company &amp; Client Information
            </h2>
            <ul class="space-y-3 text-gray-700 text-sm leading-relaxed list-disc list-inside">
                <li><strong>Per-Invoice Company Selection</strong>: Each invoice can be associated with a specific company entity (name, logo, address), enabling multi-brand billing from a single WordPress installation.</li>
                <li><strong>Client Information Fields</strong>: Dedicated fields on each invoice for storing client name, email, billing address, city, state, country, and postal code.</li>
                <li><strong>Country &amp; Subdivision Lookups</strong>: Bundled country and subdivision (state/province) data with AJAX-powered dropdown population in the invoice builder and checkout form.</li>
                <li><strong>Invoice Notes</strong>: A dedicated notes field on each invoice for attaching payment terms, project descriptions, or custom messages visible on the issued document.</li>
            </ul>
        </div>

        <div class="bg-white border border-gray-200 rounded-xl p-8 hover:shadow-md transition">
            <h2 class="text-xl font-semibold text-gray-900 mb-5 flex items-center gap-2">
                <span>📁</span> File Attachments
            </h2>
            <ul class="space-y-3 text-gray-700 text-sm leading-relaxed list-disc list-inside">
                <li><strong>Invoice File Attachments</strong>: Attach one or more files from the WordPress Media Library directly to any invoice for delivery alongside the billing document.</li>
                <li><strong>Media Library Integration</strong>: A REST API-backed file handler resolves and displays file metadata (title, filename, type) for all attachments within the invoice editor.</li>
                <li><strong>Template File Support</strong>: Invoice template records also support file attachment fields, providing a consistent file management experience across both post types.</li>
            </ul>
        </div>

        <div class="bg-white border border-gray-200 rounded-xl p-8 hover:shadow-md transition">
            <h2 class="text-xl font-semibold text-gray-900 mb-5 flex items-center gap-2">
                <span>📊</span> Dashboard &amp; Reporting
            </h2>
            <ul class="space-y-3 text-gray-700 text-sm leading-relaxed list-disc list-inside">
                <li class="developer"><strong>Extensible Dashboard System</strong>: A hook-based <code class="bg-gray-100 px-1 rounded text-xs">Dashboard_Widgets</code> system with registered sections and a sidebar context, designed so companion plugins can inject their own reporting widgets.</li>
                <li><strong>Invoice Admin Dashboard</strong>: A dedicated dashboard page within the Invoices menu providing a centralized overview of invoice activity and quick-access navigation.</li>
                <li class="developer"><strong>Dashboard Autocomplete</strong>: An AJAX-powered autocomplete handler within the dashboard for fast invoice and client lookups.</li>
                <li><strong>Enhanced Admin Columns</strong>: The invoice list view features custom columns for invoice number, client name, amount, due date, and status badge for rapid at-a-glance management.</li>
            </ul>
        </div>

        <div class="bg-white border border-gray-200 rounded-xl p-8 hover:shadow-md transition">
            <h2 class="text-xl font-semibold text-gray-900 mb-5 flex items-center gap-2">
                <span>⚙️</span> Settings &amp; Configuration
            </h2>
            <ul class="space-y-3 text-gray-700 text-sm leading-relaxed list-disc list-inside">
                <li class="developer"><strong>Extensible Settings Hub</strong>: A tabbed settings interface with a General tab for core configuration, architected to allow any companion plugin to inject its own settings tab seamlessly.</li>
                <li><strong>Invoice General Settings</strong>: Configurable options for default invoice behavior, currency, and branding, managed from a dedicated admin settings page.</li>
                <li><strong>Email Settings Page</strong>: A separate, dedicated settings section for managing all transactional email templates with live preview guidance.</li>
                <li><strong>Gateway Settings Pages</strong>: Individual dedicated settings pages for each active payment gateway (Stripe, PayPal) for credential and webhook management.</li>
                <li><strong>Organized Admin Menu</strong>: The WordPress sidebar menu is programmatically reordered to present Dashboard, Add Invoice, All Invoices, Templates, and Settings in a logical, prioritized sequence.</li>
                <li><strong>Help Page</strong>: A built-in help and documentation page within the plugin&rsquo;s admin menu.</li>
            </ul>
        </div>

        <div class="developer bg-white border border-gray-200 rounded-xl p-8 hover:shadow-md transition">
            <h2 class="text-xl font-semibold text-gray-900 mb-5 flex items-center gap-2">
                <span>🔧</span> Developer Infrastructure &amp; Extensibility
            </h2>
            <ul class="space-y-3 text-gray-700 text-sm leading-relaxed list-disc list-inside">
                <li><strong>Singleton Plugin Architecture</strong>: The core <code class="bg-gray-100 px-1 rounded text-xs">Agency_Pulse_Invoice</code> class follows the Singleton pattern, ensuring a single, stable instance is accessible throughout the WordPress lifecycle.</li>
                <li><strong>Public Invoice API</strong>: A dedicated <code class="bg-gray-100 px-1 rounded text-xs">Agency_Pulse_Invoice_Invoice_API</code> class exposes a stable, documented API surface for external code and companion plugins to interact with invoice data.</li>
                <li><strong>Global Helper Functions</strong>: A library of global helper functions (e.g., <code class="bg-gray-100 px-1 rounded text-xs">api_invoice_mark_paid()</code>, <code class="bg-gray-100 px-1 rounded text-xs">agency_pulse_invoice()</code>) providing clean, reliable shortcuts for common operations.</li>
                <li><strong>Comprehensive Hook System</strong>: Extensive use of WordPress actions and filters throughout the codebase (e.g., <code class="bg-gray-100 px-1 rounded text-xs">agency_pulse_invoice_activated</code>, <code class="bg-gray-100 px-1 rounded text-xs">agency_pulse_invoice_payment_received</code>, <code class="bg-gray-100 px-1 rounded text-xs">api_invoice_marked_paid</code>) enabling deep customization without core modifications.</li>
                <li><strong>Data Migration Handler</strong>: An automated migration service that performs safe, throttled backfill operations (e.g., partial payment balance recalculation) on plugin updates without impacting site performance.</li>
                <li><strong>Auto-Update Checker</strong>: A built-in update checker that connects to the Agency Pulse update server to deliver plugin updates directly through the standard WordPress updates interface.</li>
                <li><strong>Internationalisation (i18n)</strong>: Full translation-readiness with a registered text domain and a <code class="bg-gray-100 px-1 rounded text-xs">/languages</code> directory, making the plugin compatible with any language or locale.</li>
                <li><strong>Composer Autoloading</strong>: PSR-4 autoloading via Composer for all PHP class dependencies, ensuring clean, conflict-free class resolution.</li>
            </ul>
        </div>

    </div>
</section>

@endsection