# BizzSwatch প্রিমিয়াম ফিচার গাইড

এই ডকুমেন্টে BizzSwatch প্রিমিয়াম ভার্শনের জন্য প্ল্যান করা ফিচারগুলোর বিস্তারিত বর্ণনা দেওয়া হলো। এটি ডেভেলপমেন্টের সময় রেফারেন্স হিসেবে ব্যবহার করা যাবে।

---

## আর্কাইভ/শপ পেজ সোয়াচ

### বর্ণনা
শপ পেজ, ক্যাটেগরি পেজ, ট্যাগ পেজ ইত্যাদিতে প্রোডাক্ট কার্ডে সোয়াচ দেখানো।

### ফিচার ডিটেইলস

**1. সোয়াচ ডিসপ্লে অপশন**
- সব সোয়াচ দেখানো
- নির্দিষ্ট সংখ্যক সোয়াচ দেখানো (Display Limit)
- একটি অ্যাট্রিবিউটের সোয়াচ দেখানো (Catalog Mode)

**2. পজিশনিং**
- Add to Cart বাটনের আগে
- Add to Cart বাটনের পরে
- ইমেজের উপরে
- প্রাইসের নিচে

**3. অ্যালাইনমেন্ট**
- Left
- Center
- Right

**4. ইন্টার‌্যাকশন**
- সোয়াচ ক্লিক করলে প্রোডাক্ট ইমেজ চেঞ্জ
- সোয়াচ ক্লিক করলে প্রাইস আপডেট
- প্রোডাক্ট পেজে সিলেক্টেড ভ্যারিয়েশন রাখা

### ইমপ্লিমেন্টেশন নোট
```php
// শপ পেজে সোয়াচ দেখানোর হুক
add_action('woocommerce_after_shop_loop_item', 'render_archive_swatches');
add_action('woocommerce_before_shop_loop_item_title', 'render_archive_swatches');
```

---

## মাল্টি-কালার সোয়াচ

### বর্ণনা
একটি সোয়াচে দুই বা তার বেশি কালার দেখানো (Dual Color/Multi Color)।

### ফিচার ডিটেইলস

**1. ডুয়াল কালার**
- দুইটি কালার একসাথে দেখানো
- গ্রেডিয়েন্ট স্টাইলে (Diagonal, Horizontal, Vertical)

**2. মেটা ফিল্ড**
- Primary Color
- Secondary Color
- Gradient Angle

### ইমপ্লিমেন্টেশন নোট
```php
// টার্ম মেটা
update_term_meta($term_id, 'bizzswatches_secondary_color', '#FF0000');

// CSS স্টাইল
background: linear-gradient(-45deg, $color1 50%, $color2 50%);
```

---

## প্রোডাক্ট লেভেল কাস্টমাইজেশন

### বর্ণনা
প্রতিটি প্রোডাক্টে আলাদাভাবে অ্যাট্রিবিউট সোয়াচ কাস্টমাইজ করা।

### ফিচার ডিটেইলস

**1. অ্যাট্রিবিউট টাইপ ওভাররাইড**
- গ্লোবাল Color টাইপ প্রোডাক্টে Image এ পরিবর্তন
- গ্লোবাল Select টাইপ প্রোডাক্টে Button এ পরিবর্তন

**2. কাস্টম কালার/ইমেজ**
- গ্লোবাল কালার রিপ্লেস করা
- গ্লোবাল ইমেজ রিপ্লেস করা

**3. মিক্সড সোয়াচ**
- একই অ্যাট্রিবিউটে বিভিন্ন টাইপ (কোনোটা Color, কোনোটা Image)

### ইমপ্লিমেন্টেশন নোট
```php
// প্রোডাক্ট মেটা
$product_swatches = get_post_meta($product_id, '_bizzswatches_attributes', true);

// স্ট্রাকচার
[
    'pa_color' => [
        'type' => 'image',
        'terms' => [
            'red' => ['image_id' => 123],
            'blue' => ['image_id' => 456]
        ]
    ]
]
```

---

## অ্যাডভান্সড টুলটিপ

### বর্ণনা
কাস্টম টুলটিপ কনটেন্ট এবং স্টাইলিং।

### ফিচার ডিটেইলস

**1. কাস্টম টেক্সট**
- টার্মের নাম ছাড়া কাস্টম টেক্সট
- ডেসক্রিপশন দেখানো

**2. ইমেজ টুলটিপ**
- সোয়াচে হোভার করলে বড় ইমেজ দেখানো
- কাস্টম টুলটিপ ইমেজ

**3. স্টাইলিং**
- Background Color
- Text Color
- Border Style
- Position (Top, Bottom, Left, Right)

### ইমপ্লিমেন্টেশন নোট
```php
// টার্ম মেটা
update_term_meta($term_id, 'bizzswatches_tooltip_text', 'Custom Text');
update_term_meta($term_id, 'bizzswatches_tooltip_image', 789);

// সেটিংস
'tooltip_background' => '#333333',
'tooltip_text_color' => '#FFFFFF'
```

---

## বর্ডার স্টাইলিং

### বর্ণনা
সোয়াচের বর্ডার কাস্টমাইজেশন।

### ফিচার ডিটেইলস

**1. নরমাল স্টেট**
- Border Color
- Border Width
- Border Style (Solid, Dashed, Dotted)

**2. হোভার স্টেট**
- Hover Border Color
- Hover Border Width
- Hover Scale Effect

**3. অ্যাক্টিভ/সিলেক্টেড স্টেট**
- Active Border Color
- Active Border Width
- Active Background Color

### ইমপ্লিমেন্টেশন নোট
```php
// সেটিংস
'border_color' => '#E0E0E0',
'border_width' => 2,
'border_color_hover' => '#999999',
'border_color_active' => '#333333'
```

---

## আনলিমিটেড ভ্যারিয়েশন সাপোর্ট

### বর্ণনা
৩০+ ভ্যারিয়েশনের জন্য আউট অফ স্টক হ্যান্ডলিং।

### ফিচার ডিটেইলস

WooCommerce ডিফল্টে ৩০টি ভ্যারিয়েশনের জন্য Ajax লোড করে। এর বেশি হলে সব ভ্যারিয়েশন ডাটা পেজে এমবেড করা হয়। প্রিমিয়াম ভার্শনে এই লিমিটেশন বাইপাস করে সঠিকভাবে স্টক স্ট্যাটাস দেখানো হবে।

### ইমপ্লিমেন্টেশন নোট
```php
// Ajax endpoint
add_action('wp_ajax_bizzswatches_get_variation_stock', 'get_variation_stock');
add_action('wp_ajax_nopriv_bizzswatches_get_variation_stock', 'get_variation_stock');
```

---

## সোয়াচ ডিসপ্লে লিমিট

### বর্ণনা
নির্দিষ্ট সংখ্যক সোয়াচ দেখিয়ে বাকিগুলো "আরো দেখুন" বাটনে।

### ফিচার ডিটেইলস

**1. লিমিট সেটিং**
- প্রতি অ্যাট্রিবিউটে কতগুলো সোয়াচ দেখাবে

**2. মোর বাটন**
- "+5 more" স্টাইলে দেখানো
- ক্লিক করলে সব সোয়াচ দেখানো

### ইমপ্লিমেন্টেশন নোট
```php
// সেটিংস
'display_limit' => 5,
'more_button_text' => '+{count} more'
```

---

## ক্যাটেগরি/গ্রুপ সোয়াচ

### বর্ণনা
সোয়াচগুলোকে গ্রুপ করে দেখানো।

### ফিচার ডিটেইলস

**1. গ্রুপিং**
- সোয়াচগুলোকে ক্যাটেগরিতে ভাগ করা
- গ্রুপ হেডার দেখানো

**2. উদাহরণ**
```
Summer Colors
  [Red] [Orange] [Yellow]

Winter Colors
  [Blue] [White] [Gray]
```

---

## উইজেট ফিল্টার সোয়াচ

### বর্ণনা
WooCommerce ফিল্টার উইজেটে সোয়াচ দেখানো।

### ফিচার ডিটেইলস

- "Filter by Attribute" উইজেটে সোয়াচ স্টাইল
- ক্লিক করলে প্রোডাক্ট ফিল্টার
- মাল্টিপল সিলেকশন সাপোর্ট

---

## Ajax ভ্যারিয়েশন লোডিং

### বর্ণনা
দ্রুত ভ্যারিয়েশন লোড এবং ইমেজ সুইচ।

### ফিচার ডিটেইলস

- সিঙ্গেল অ্যাট্রিবিউট সিলেক্ট করলে গ্যালারি চেঞ্জ (Amazon স্টাইল)
- পেজ রিলোড ছাড়া প্রাইস আপডেট
- স্মুথ ট্রানজিশন

---

## ভ্যারিয়েশন লিঙ্ক জেনারেশন

### বর্ণনা
নির্দিষ্ট ভ্যারিয়েশনের ডাইরেক্ট লিঙ্ক তৈরি।

### ফিচার ডিটেইলস

- ভ্যারিয়েশন সিলেক্ট করলে URL আপডেট
- শেয়ারযোগ্য লিঙ্ক
- URL থেকে ভ্যারিয়েশন প্রি-সিলেক্ট

### উদাহরণ
```
https://site.com/product/tshirt/?attribute_pa_color=red&attribute_pa_size=large
```

---

## ডেভেলপমেন্ট নোট

### ফাইল স্ট্রাকচার
```
premium/
├── class-bizzswatches-premium-loader.php
├── archive/
│   └── class-archive-swatches.php
├── styling/
│   └── class-advanced-styling.php
├── tooltip/
│   └── class-advanced-tooltip.php
└── ...
```

### হুকস
```php
// প্রিমিয়াম ইনিশিয়ালাইজ
add_action('bizzswatches_loaded', 'init_premium_features');

// প্রো চেক
add_filter('bizzswatches_is_pro', '__return_true');
```

### লাইসেন্সিং
- লাইসেন্স কী ভেরিফিকেশন
- আপডেট সার্ভার
- সাইট অ্যাক্টিভেশন

---

*এই ডকুমেন্ট প্রিমিয়াম ভার্শন ডেভেলপমেন্টের রেফারেন্স হিসেবে ব্যবহার করা হবে।*