=== Hadiya – Gift Wrap, Gift Message & Gift Box Builder for WooCommerce ===
Contributors: adil-elsaeed
Tags: gift wrap, gift message, gift box, box builder, product bundles
Requires at least: 6.7
Tested up to: 7.1
Requires PHP: 7.4
Requires Plugins: woocommerce
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Gift wrapping, gift messages, recipient delivery dates and a build-your-own gift box builder for WooCommerce.

== Description ==

Hadiya turns any WooCommerce store into a gift shop. Customers tap **Make it a gift** on a product page, pick a wrap, write a gift message, choose who the gift is for and when it should arrive. Everything follows the item through the cart, checkout, order screen and emails.

It works with any theme, block or classic. The gift options appear on the product page automatically, so there is nothing to place by hand, and every feature is also available as a block and a shortcode.

= Gift Wrap =

* Sell gift wraps as their own products, with a price, stock and an image.
* Wraps are added to the cart as separate lines, so stock and reporting stay accurate.
* Set how many items each wrap fits.

= Gift Message Cards =

* A greeting card with From, To and a personal message, with a character limit you choose.
* Links are blocked in the message to stop spam.
* The gift note shows on the order screen and in the order emails.

= Recipient and delivery date =

* “For me” or “For someone else”, with the recipient's name, phone number and address.
* Each recipient gets their own shipping package at checkout.
* Hide the price from the recipient, and ask the courier not to call them.
* A delivery date picker that respects your working days and lead time.

= Gift Box Builder (mix and match) =

* Let customers build their own gift box from the products you choose.
* A fill bar shows how many items are left.
* The box price is the box itself plus the items inside it, and stock is deducted from each item.

= Occasions and recipients =

* “Occasion” and “Recipient” taxonomies for your products, with their own archive pages.
* Blocks to show them as a grid on any page.

= Works with your theme =

* Inherits your theme's colors, spacing and fonts from theme.json, or set your own accent color and corner radius.
* Automatic placement on the product page through WooCommerce hooks and the Block Hooks API.
* Page builders: a widget for each block in Elementor, and a Hadiya element in Bricks and Divi.
* Shortcodes for other page builders and classic content: `[hadiya_make_gift]`, `[hadiya_box_builder id="12"]`, `[hadiya_occasions]`, `[hadiya_recipients]`, `[hadiya_wraps]`, or `[hadiya block="make-gift"]`.
* Compatible with WooCommerce HPOS and the Cart and Checkout blocks.
* Translation ready, with right-to-left support and an Arabic translation included.

= Hadiya Pro =

[Hadiya Pro](https://wooarab.com/en/hadiya-gift-builder-plugin/) adds:

* Ready-made gift bundles with their own stock, discount pricing and an included wrap.
* A quick order form for cash-on-delivery stores.
* A gift finder that suggests products by recipient, occasion and budget.
* Greeting card designs, delivery time slots, holidays and same-day cut-off, and engraving.
* Printable gift cards, packing slips and shipping labels.
* Perfume notes and size guide product tabs.
* One-click demo import.

== Installation ==

1. Install and activate WooCommerce.
2. Install Hadiya from **Plugins → Add New**, or upload the zip file, then activate it.
3. Open **Hadiya** in the admin menu and follow the setup checklist: add your first gift wrap, then check the gift options.
4. Open any product page. The **Make it a gift** button is already there.

To build a gift box, add a product of type **Build your gift box**, set its sizes and the categories customers can pick from, and publish it.

== Frequently Asked Questions ==

= Does it work with my theme? =

Yes. Hadiya adds its options through WooCommerce's own product page hooks and the WordPress Block Hooks API, so it works with block themes and classic themes. It has been tested with Twenty Twenty-Five, Storefront, Astra, Kadence, Blocksy, GeneratePress, OceanWP and Hello Elementor, with Elementor 4.3, with the Cart and Checkout blocks and the classic cart, and with HPOS on and off.

= Does it work with Elementor, Bricks or Divi? =

Yes. In Elementor, find the blocks under the Hadiya category in the widgets panel. In Bricks and Divi, add the Hadiya element and choose a block. The editor shows a preview, and the block becomes interactive on the published page. In Beaver Builder, Breakdance, Oxygen or WPBakery, use the shortcodes, such as `[hadiya_make_gift]` or `[hadiya_box_builder id="12"]`.

= Can I place the gift options myself? =

Yes. Set **Product page placement** to **Manual** in the Hadiya settings, then add the blocks or shortcodes where you want them.

= Is this a gift card (store credit) plugin? =

No. Hadiya adds gift wrapping, gift messages and gift boxes to the products you already sell. It does not sell vouchers or store credit.

= Does the recipient see the price? =

Not if the customer ticks **Hide price from recipient**. The choice is saved with the order and shown in the gift details, so you know to leave the invoice out of the package.

= Is it compatible with HPOS? =

Yes. Hadiya declares compatibility with High-Performance Order Storage and the Cart and Checkout blocks.

== External services ==

Hadiya uses the [Freemius](https://freemius.com/) SDK for opt-in usage data, and in Hadiya Pro for licensing and updates. Nothing is sent unless you opt in, or activate a Pro license. When you do, it sends your site URL, WordPress, WooCommerce and plugin versions, your admin name and email to Freemius on activation, deactivation and updates. See the Freemius [terms](https://freemius.com/terms/) and [privacy policy](https://freemius.com/privacy/).

Hadiya makes no other external requests.

== Screenshots ==

1. Make it a gift on the product page: pick a wrap, then write the gift message or use a suggestion for the occasion (shown on an Arabic, right-to-left store).
2. The gift box builder: choose a size, then fill the box while the bar counts the items left.
3. The cart: the gift details stay with the product, and the wrap is its own line.
4. Gift options: placement on the product page, and colors and corners that follow your theme.
5. A gift box product: sizes, pricing, and in Pro quantity discounts, content steps and free gifts.
6. The gift details on the order screen, with the print buttons from Pro.

== Changelog ==

= 1.0.1 =
* The occasion and recipient archive templates are translatable, and their gift finder card shows only with Pro.
* Lists in the cart, orders and emails use the separator of the site language instead of an Arabic comma.
* Translator comments are in English.

= 1.0.0 =
The first release of the plugin.
* Gift wrapping, greeting cards and delivery to the recipient on the date the customer picks.
* Build-your-own gift box with a fill bar and fixed or per-item pricing.
* Occasions and recipients, with their own archive pages and blocks.
* Automatic placement on the product page in block and classic themes, shortcodes, and Elementor widgets.
* Box steps, tiered discounts, shareable boxes and rewards, ready-made gift bundles, the gift finder, the quick order form, printing and demo import. (Pro)
