=== YPSupport Handmade Manager ===
Contributors: YPSupport
Tags: handmade, inventory, cost management, materials, orders
Requires at least: 6.4
Tested up to: 7.0
Requires PHP: 8.1
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

YPSupport Handmade Manager helps craft artists manage materials inventory, recipes, and real-time cost and profit calculation.

== Description ==

YPSupport Handmade Manager is a WordPress plugin designed for handmade craft artists who want to manage their business more efficiently.

Stop paying high commissions to craft marketplaces. YPSupport Handmade Manager gives you the tools to manage your handmade business directly on your own WordPress site.

**Key Features:**

* **Materials Inventory** — Track materials with quantity, unit price, stock levels and low-stock thresholds
* **Parts Inventory** — Manage handmade & purchased parts with stock and cost, and mix them into product recipes
* **Recipe Management** — Define which materials (and parts) are used in each product
* **Real-time Cost & Profit Calculation** — Costs always reflect the latest material prices
* **Product Options** — Register color/size variations with a per-option price difference and an optional per-option recipe
* **Material Purchase Log & Shopping List** — Record purchases (weighted-average unit price) and build a shopping list with a shopping mode
* **Sales Records** — Log sales by channel with cost and profit, plus channel and monthly summaries
* **Currency Switching** — Store amounts in a base currency and display them in another, with daily exchange rates
* **Artisan Profile, Gallery & Slideshow** — Front-end shortcodes with 6 design themes
* **OGP Optimization** — Automatic Open Graph meta tags for better social sharing
* **WooCommerce-aware** — When WooCommerce is active, its monthly sales are added to the dashboard total

**Pro Features:**

* Stock alert email notifications (daily low-stock check)
* Sales dashboard with year-over-year and monthly analytics, plus sales CSV export
* Order & production schedule management (calendar, Gantt chart, working-hours capacity)
* Order CSV import (minne / Creema, with per-service column mapping)
* WooCommerce integration: link products, auto-register orders, and deduct part stock on completion
* Manual exchange-rate override (set your own rates instead of the daily auto-fetch)

[//]: # fs_premium_only_begin
= Pro Plan =

Upgrade to Pro to unlock stock alert emails, a full sales dashboard with CSV export, order & production scheduling, order CSV import (minne / Creema), WooCommerce order integration, and manual exchange-rate override.

[//]: # fs_premium_only_end

[//]: # fs_free_only_begin
= Free Plan =

The free plan is fully functional with no usage limits: register unlimited materials, parts, products (each with its own recipe) and sales records, with real-time cost & profit calculation, multi-currency display, and the artisan profile, gallery and slideshow shortcodes.

[//]: # fs_free_only_end

= Who Is This For? =

This plugin is built for independent handmade artists who:

* Sell on minne, Creema, Etsy, BASE, or their own WordPress site
* Want to know the true cost and profit of each product they make
* Struggle to track material stock across multiple projects
* Need a simple order and production workflow without a full e-commerce setup

== Installation ==

1. Upload the `ypsupport-handmade-manager` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the **Plugins** menu in WordPress
3. Go to **Handmade** in the admin menu to get started

== Frequently Asked Questions ==

= How is the production cost calculated? =

The cost is calculated in real-time: sum of (quantity × unit price) for all materials in the recipe. It always reflects the latest material prices — no stale cached values.

= What's the difference between the free and Pro versions? =

The free version is fully functional with no usage limits. Pro adds separate features: stock alert emails, a sales dashboard with CSV export, order & production scheduling, order CSV import (minne / Creema), WooCommerce order integration, and manual exchange-rate override.

= Do I need WooCommerce to use this plugin? =

No. The plugin works fully standalone. If WooCommerce is active it is detected automatically: the dashboard adds WooCommerce monthly sales to the total, and in Pro a linked product's WooCommerce orders can be auto-registered with part-stock deduction on completion. WooCommerce is never required.

= Is the plugin compatible with multisite? =

Multisite compatibility is not officially tested in v1. Single-site use is recommended.

= Where can I find the shortcode list? =

After activation, go to **Handmade > Theme Settings** to see all available shortcodes with auto-generated attribute examples.

== External services ==

This plugin connects to an external exchange-rate API to convert the amounts shown in the WordPress admin into the selected display currency. This only happens in the admin area for the currency feature; no data about your site visitors is ever sent.

**open.er-api.com (default, no API key required)**
When you click "Update now" on the Currency Settings screen, switch the display currency, or when the once-daily background update (WP-Cron) runs, the plugin sends a request containing only your base currency code (for example "JPY" or "USD") to retrieve the latest exchange rates. No personal data is transmitted.
Terms of use: https://www.exchangerate-api.com/terms
Privacy policy: https://www.exchangerate-api.com/privacy

**v6.exchangerate-api.com (optional, only used if you enter an API key)**
If you enter an exchangerate-api.com API key on the Currency Settings screen, rate requests are sent to this endpoint instead, including your API key and base currency code. Same purpose and same provider as above.
Terms of use: https://www.exchangerate-api.com/terms
Privacy policy: https://www.exchangerate-api.com/privacy

If you do not use the currency switching feature, no external requests are made.

== Screenshots ==

1. Materials inventory management with stock bar display
2. Recipe editing with real-time cost and profit calculation
3. Artisan profile page (Natural theme)
4. Sales records with monthly summary, per-channel breakdown and profit (fee-aware)
5. Parts inventory management with per-part cost and stock tracking

== Changelog ==

= 1.0.0 =
* Initial public release: materials inventory, products & recipes with real-time cost/profit calculation, manual sales records with per-channel fees, parts inventory, shopping list, multi-currency display, and an artisan profile / product slideshow. Pro adds stock-alert emails, a sales dashboard with CSV export, order & production scheduling, order CSV import, and WooCommerce integration.

== Upgrade Notice ==

= 1.0.0 =
Initial public release.
