=== Smart Woo Service Invoicing ===
Contributors: callismartltd
Tags: subscription billing, automated invoicing, recurring payments, service billing, woocommerce invoicing
Requires at least: 6.4
Tested up to: 7.0
Requires WooCommerce: 8.0
WooCommerce tested up to: 10.8.0
Requires PHP: 7.4
Stable Tag: 2.5.5
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl-3.0.en.html

Automated Service Billing and Subscription Management for WooCommerce.

== Description ==
Smart Woo Service Invoicing is a **subscription-ready invoicing solution** built for service-based businesses. Whether you offer one-off services, recurring retainers, or subscription plans, Smart Woo automates your billing cycle with **auto-generated invoices, payment reminders, and a professional client portal**.

Perfect for **freelancers, agencies, and service providers**, Smart Woo seamlessly integrates with WooCommerce, helping you manage recurring services and invoicing without manual hassle.

With powerful automation, customizable billing rules, and a client-friendly dashboard, Smart Woo lets you focus on delivering services while it handles the **repetitive payment and invoicing tasks**.

== Features ==  

* Intuitive Admin Dashboards  
Manage service subscriptions, invoices, emails, refunds, and more from a clean, organized backend dashboard.

* Professional Client Portal  
Offer your clients a modern, easy-to-use frontend where they can manage subscriptions, view invoices, order services, and pay outstanding balances effortlessly.

* Automatic Invoice Generation  
Automatically create and send invoices at the end of each subscription billing cycle — no more manual chasing or bookkeeping headaches.

* Flexible Payment Options  
Supports all payment gateways you’ve enabled in WooCommerce, ensuring your clients can pay their invoices with ease.

* Customizable Billing Cycles  
Charge clients monthly, quarterly, semi-annually, or annually, depending on your service model.

* User-Friendly Onboarding  
Let customers define service names, select billing cycles, and provide essential details during sign-up.

* Robust Subscription Asset Support  
Handle subscriptions for digital, downloadable, remotely protected, or even physical assets, with full control.

* Guest Invoicing  
Create invoices for non-registered users and send them directly via email.

* Smart Payment Links  
Generate direct payment or auto-login URLs so clients can pay invoices without needing to log into the client portal.

== Smart Woo Pro Features ==  

* Advanced Usage Stats  
Access detailed insights and visual analytics on subscription usage trends.

* Service Interaction Logs  
Track client activity and interactions with their subscriptions for better transparency.

* Detailed Invoice Logs  
Monitor all invoice events, including payment successes, failures, and adjustments.

* Custom Invoice Items  
Add custom charges or items directly to an invoice.

* Prorated Subscriptions  
Enable prorated billing for subscription upgrades or downgrades, automatically reflected in invoices.

* Automated Refunds  
Automatically process prorated refunds when a subscription is canceled mid-cycle.

* Seamless Service Migration  
Easily manage subscription migrations, including prorated adjustments, with detailed change logs.

* Customizable Email Templates  
Tailor notification emails to match your brand and communication style.

* REST API Access  
Access subscription and invoice data programmatically using a robust (currently read-only) REST API — with write support coming soon.

* PDF Invoice Attachments  
Automatically attach professionally formatted PDF invoices to outgoing email notifications.

* Dedicated Support & Updates  
Get premium support and automatic updates to keep your system secure and feature-rich.

[Get Smart Woo Pro](https://callismart.com.ng/smart-woo-service-invoicing/#go-pro)


== License ==
This project is licensed under the [GPL v3.0 or later](https://www.gnu.org/licenses/gpl-3.0.en.html).

== Prerequisites ==

- **WordPress**: Ensure your WordPress installation is version 6.4 or higher.
- **WooCommerce**: This plugin requires WooCommerce to be installed and activated. Tested and optimized for WooCommerce 8.0+.
- **PHP**: A PHP version of 7.4 or later is required. Ensure your hosting environment meets this requirement.
- **Database**: Ensure your database is running MySQL version 5.6+ or MariaDB version 10.0+ for compatibility. Most modern WordPress hosting providers already meet these requirements.

== Installation ==

= Install from WordPress Dashboard (Recommended) =
1. In your WordPress admin, go to **Plugins → Add New**.
2. Search for **Smart Woo Service Invoicing**.
3. Click **Install Now**, then **Activate**.
4. After activation, you’ll have the option to **launch the Setup Wizard** from the plugin settings page by clicking the **“Run Setup Wizard”** button.

= Install from Downloaded ZIP =
1. Download the plugin zip from WordPress.org or our website.
2. In your WordPress admin, go to **Plugins → Add New → Upload Plugin**.
3. Select the zip file, click **Install Now**, then **Activate**.
4. After activation, you can launch the **Setup Wizard** from the plugin settings page (via the **“Run Setup Wizard”** button).

= WP-CLI (Advanced / Developers) =
If you have WP-CLI access, you can install and activate Smart Woo with:

    wp plugin install smart-woo-service-invoicing --activate

After activation, launch the Setup Wizard from the plugin settings page by clicking the "Run Setup Wizard" button.

**Next Steps:**  
Follow our detailed setup article: [Smart Woo Usage Guide](https://callismart.com.ng/smart-woo-usage-guide/).

For more information and updates, visit the [Smart Woo Service Invoicing Plugin page](https://callismart.com.ng/smart-woo-service-invoicing).


== Usage ==

Getting started with Smart Woo is easy — follow these simple steps to create services, manage subscriptions, and start automated invoicing:

1. **Create a Service Product**  
   Go to the plugin's **Service Product** page and create a product for the service you offer.  

2. **Configure Billing Options**  
   Set billing cycles (monthly, yearly, etc.), sign-up fees, and other service-specific options.  

3. **Customer Sign-Up**  
   Customers can configure their service details during checkout or sign-up.  

4. **Manage Service Orders**  
   Process and manage all service orders through the **Service Order** page. Once processed, the service subscription is automatically activated.  

5. **Automated Renewals & Invoicing**  
   Smart Woo will automatically generate invoices and send them via email at the end of each billing cycle.  

6. **Easy Payments**  
   Customers can pay invoices directly via the email payment link or by logging into the client portal.  

You can also read our detailed setup article: [Smart Woo Usage Guide](https://callismart.com.ng/smart-woo-usage-guide/).

== Feedback and Contributions ==

Your feedback helps shape the future of Smart Woo!  
- Have a suggestion or feature request? Let us know.  
- Found a bug or issue? Report it so we can fix it quickly.  

For release notes, upcoming features, and future updates, visit the [official release page](http://callismart.com.ng/smart-woo-service-invoicing-release-notes/).


== Changelog ==
= 2.5.4 [2026-02-13] =
**Fixed**
- Broken client portal when listing new order.

= 2.5.3 [2026-01-29] =
**Fixed** 
* Email template width on mobile devices.
* Service Assets database table upgraded to allow much bigger asset sizes.
* Minor bug fixes and performance optimizations.

= 2.5.2 [2025-12-2] =
**Fixed**
* Auto-generated invoices now uses default site currency.
* Broken audio and video player for subscription assets.
* Recommended settings for guest checkout on a subscription system.
* Secure asset editor content sanitization and escape functions.

**Improved**
* Guest invoice handling.
* Guest checkout handling.
* Subscription asset rendering.
* Smart Woo security audit workflow.

= 2.5.1 2025-10-27 =
**Introduced**
* A new support section in the admin area to provide easy access to Smart Woo plugin support services.
* New support inbox feature, to simplify access to support products and services right from the admin area.

**Improved**
* Object caching for service subscriptions
* Object caching for invoices.
* Performance optimizations at automation models.
* Aggressive subscription activity logging(pro).

= 2.5 2025-10-06 =
**Fixed**
* Invoice date display issue.
* New UI header preventing admin notices.
* Searching service subscriptions not working.
* Edge cases where multiple unpaid invoices were generated.

**Introduced**
* New admin dashboard featuring powerful tools for easier subscription management.

**Improved**
* Plugin security: performed a comprehensive security audit across the entire codebase.
* Performance optimization including request pagination, caching, and response limits.
* Activity logs enhanced to provide detailed insights into subscription and invoice activities.

For detailed updates and changes, see the [Changelog](https://github.com/CallismartLtd/smart-woo-service-invoicing/blob/main/changelog.md).

== Frequently Asked Questions ==

= 1. What is Smart Woo Service Invoicing? =
Smart Woo is a powerful WooCommerce extension that allows you to charge both recurring and one-time payments on your WordPress website. Think of it as a subscription plugin with the added flexibility to generate professional invoices for your clients — automatically at the end of their billing cycle.

**Who is Smart Woo for?**  
Smart Woo is perfect for businesses that collect payments through invoices. Whether you’re a freelancer, property manager, IT service provider, consultant, or run a physical or virtual service-based business, Smart Woo gives you the tools to streamline invoicing and payment collection effortlessly.

= 2. Do I need WooCommerce Subscriptions to use Smart Woo? =
No. Smart Woo is a standalone alternative to WooCommerce Subscriptions, featuring a robust service subscription and invoicing model — and much more.

= 3. Can I offer one-off services instead of recurring subscriptions? =
Absolutely! You can set a subscription status to **“Active (NR)”**, which means “not renewable” after the initial billing cycle expires.

= 4. Does Smart Woo work with my existing WooCommerce payment gateways? =
Yes. Smart Woo works seamlessly with any payment gateway that integrates with WooCommerce.

= 5. Can customers pay invoices without logging in? =
Yes. Payment reminder emails and new invoice emails include **auto-login payment links**, allowing customers to pay with a single click.

= 6. Does Smart Woo send automated payment reminders? =
Yes. Smart Woo automatically sends invoice payment reminders, reducing late payments and improving cash flow.

= 7. Can I create invoices for customers who are not registered on my site? =
Yes. Smart Woo supports **guest invoicing**, enabling you to bill non-registered users via email.

= 8. Do I need coding skills to set up or use Smart Woo? =
No coding skills are required! Smart Woo is designed to be user-friendly and includes a **Setup Wizard** to walk you through the initial configuration.

= 9. Does Smart Woo work with physical products, or just services? =
Yes. As long as the product or service has a start, due, and end date, Smart Woo can model it as a subscription. It includes an **asset feature**, making it easy to handle physical items (houses, apartments, water billing) as well as virtual or downloadable assets.

= 10. What’s the difference between the free and Pro version? =
The free version includes all the core features needed to manage subscriptions, automate invoicing, and collect payments.  
**Smart Woo Pro** adds advanced features like prorated billing, detailed analytics, automated refunds, custom invoice items, professional PDF attachments, and premium support.  
[View the Pro features here.](https://callismart.com.ng/smart-woo-service-invoicing/#go-pro)

== Screenshots ==

1. Client Portal dashboard view.
2. Subscription usage analytics.
3. Admin view of all client services and invoices.
4. Subscription and accounting logs.
5. Additional client information screen.
6. Invoice logs and history.


== Source Code ==

You can access the source code for the Smart Woo Service Invoicing plugin on our official [GitHub Public Repository](https://github.com/CallismartLtd/smart-woo-service-invoicing).

== Technical Support ==

We are committed to delivering a high-quality user experience and ensuring that our product is safe and bug-free. However, if you encounter any issues, we are dedicated to resolving them swiftly.

For dedicated support, please visit our [support portal](https://support.callismart.com.ng/). For general inquiries, use the [WordPress Support Forum](https://wordpress.org/support/plugin/smart-woo-service-invoicing).