# BizzSwatch ডেভেলপার গাইড

## সূচিপত্র

1. [কোড স্ট্রাকচার](#কোড-স্ট্রাকচার)
2. [ক্লাস ওভারভিউ](#ক্লাস-ওভারভিউ)
3. [হুকস এবং ফিল্টার](#হুকস-এবং-ফিল্টার)
4. [থিম ইন্টিগ্রেশন](#থিম-ইন্টিগ্রেশন)
5. [কাস্টমাইজেশন](#কাস্টমাইজেশন)
6. [প্রিমিয়াম এক্সটেনশন](#প্রিমিয়াম-এক্সটেনশন)

---

## কোড স্ট্রাকচার

```
bizzswatches/
├── bizzswatches.php           # মেইন প্লাগিন ফাইল
├── includes/                   # কোর ক্লাস
│   ├── class-bizzswatches.php
│   ├── class-bizzswatches-autoloader.php
│   └── class-bizzswatches-helper.php
├── admin/                      # অ্যাডমিন ক্লাস
│   ├── class-bizzswatches-admin.php
│   ├── class-bizzswatches-settings.php
│   ├── class-bizzswatches-getting-started.php
│   ├── class-bizzswatches-product-panel.php
│   └── class-bizzswatches-attribute-meta.php
├── public/                     # ফ্রন্টএন্ড ক্লাস
│   ├── class-bizzswatches-frontend.php
│   └── class-bizzswatches-swatches-display.php
├── assets/                     # CSS, JS, Images
│   ├── css/
│   ├── js/
│   └── images/
├── premium/                    # প্রিমিয়াম ফিচার (ফ্রি ভার্শনে এক্সক্লুড)
├── languages/                  # ট্রান্সলেশন ফাইল
└── docs/                       # ডকুমেন্টেশন
```

---

## ক্লাস ওভারভিউ

### Core Classes

#### `Bizzswatches\Core\Bizzswatches`
মূল প্লাগিন ক্লাস। সিঙ্গলটন প্যাটার্ন ব্যবহার করে।

```php
// ইনস্ট্যান্স পেতে
$instance = bizzswatches();

// মেথডগুলো
$instance->version();           // প্লাগিন ভার্শন
$instance->get_option($key);    // সেটিংস ভ্যালু পাওয়া
$instance->get_options();       // সব সেটিংস পাওয়া
$instance->get_admin();         // অ্যাডমিন ইনস্ট্যান্স
$instance->get_frontend();      // ফ্রন্টএন্ড ইনস্ট্যান্স
$instance->assets_url($file);   // অ্যাসেট URL
$instance->is_pro();            // প্রো ভার্শন চেক
```

#### `Bizzswatches\Core\Helper`
হেল্পার ফাংশন ক্লাস। স্ট্যাটিক মেথড ব্যবহার করে।

```php
Helper::get_attribute_types();      // অ্যাট্রিবিউট টাইপ
Helper::get_swatch_types();         // সোয়াচ টাইপ
Helper::get_shape_styles();         // শেইপ স্টাইল
Helper::get_attribute_behaviors();  // বিহেভিয়ার অপশন
Helper::rgb_to_hex($rgb);           // RGB to HEX
Helper::is_swatch_type($type);      // সোয়াচ টাইপ চেক
```

### Admin Classes

#### `Bizzswatches\Admin\Admin`
অ্যাডমিন মেইন ক্লাস।

```php
$admin = bizzswatches()->get_admin();

// সাব-কম্পোনেন্ট অ্যাক্সেস
$admin->settings;
$admin->getting_started;
$admin->product_panel;
$admin->attribute_meta;
```

#### `Bizzswatches\Admin\Settings`
সেটিংস পেজ হ্যান্ডলার।

```php
Settings::instance()->get_settings_fields();  // সব ফিল্ড
Settings::instance()->render_settings_page(); // পেজ রেন্ডার
```

### Frontend Classes

#### `Bizzswatches\Public_View\Frontend`
ফ্রন্টএন্ড মেইন ক্লাস।

```php
$frontend = bizzswatches()->get_frontend();

// মেথডগুলো
$frontend->get_attribute_taxonomy_by_name($name);
$frontend->is_color_attribute($attribute);
$frontend->is_image_attribute($attribute);
$frontend->get_product_attribute_color($term);
$frontend->get_product_attribute_image($term);
```

#### `Bizzswatches\Public_View\Swatches_Display`
সোয়াচ রেন্ডারিং ক্লাস।

---

## হুকস এবং ফিল্টার

### অ্যাকশন হুকস

```php
// প্লাগিন লোড হওয়ার পর
do_action('bizzswatches_loaded', $instance);

// অ্যাডমিন লোড হওয়ার পর
do_action('bizzswatches_admin_loaded', $admin);

// ফ্রন্টএন্ড লোড হওয়ার পর
do_action('bizzswatches_frontend_loaded', $frontend);
```

### ফিল্টার হুকস

```php
// প্রো ভার্শন চেক
add_filter('bizzswatches_is_pro', '__return_true');

// অ্যাট্রিবিউট ট্যাক্সোনমি ফিল্টার
add_filter('bizzswatches_get_attribute_taxonomy', function($taxonomy, $name) {
    return $taxonomy;
}, 10, 2);

// গ্রেডিয়েন্ট অ্যাঙ্গেল
add_filter('bizzswatches_dual_color_gradient_angle', function() {
    return '-45deg';
});

// প্রোডাক্ট ডাটা ট্যাব দেখানো
add_filter('bizzswatches_show_product_data_tab', '__return_false');
```

---

## থিম ইন্টিগ্রেশন

### CSS ওভাররাইড

আপনার থিমে সোয়াচ স্টাইল কাস্টমাইজ করতে:

```css
/* সোয়াচ আইটেম */
.bizzswatches-item {
    border-radius: 50% !important;
    width: 40px !important;
    height: 40px !important;
}

/* সিলেক্টেড স্টেট */
.bizzswatches-item.selected {
    border-color: #ff0000 !important;
    box-shadow: 0 0 5px rgba(0,0,0,0.3);
}

/* হোভার স্টেট */
.bizzswatches-item:hover {
    transform: scale(1.1);
}
```

### JavaScript এক্সটেনশন

```javascript
jQuery(document).ready(function($) {
    // সোয়াচ ক্লিক ইভেন্ট
    $(document).on('click', '.bizzswatches-item', function() {
        // কাস্টম লজিক
        console.log('Swatch clicked:', $(this).data('value'));
    });
    
    // ভ্যারিয়েশন আপডেট ইভেন্ট
    $(document).on('woocommerce_update_variation_values', function(e) {
        // কাস্টম লজিক
    });
});
```

### PHP এক্সটেনশন

```php
// কাস্টম সোয়াচ রেন্ডার
add_filter('woocommerce_dropdown_variation_attribute_options_html', function($html, $args) {
    // কাস্টম রেন্ডারিং
    return $html . '<div class="my-custom-swatches">...</div>';
}, 200, 2);
```

---

## কাস্টমাইজেশন

### নতুন সোয়াচ টাইপ যোগ করা

```php
// অ্যাট্রিবিউট টাইপে যোগ
add_filter('product_attributes_type_selector', function($types) {
    $types['custom'] = __('Custom Swatch', 'bizzswatches');
    return $types;
});

// সোয়াচ রেন্ডার করা
add_filter('woocommerce_dropdown_variation_attribute_options_html', function($html, $args) {
    $attribute = $args['attribute'];
    $frontend = bizzswatches()->get_frontend();
    $taxonomy = $frontend->get_attribute_taxonomy_by_name($attribute);
    
    if ($taxonomy && 'custom' === $taxonomy->attribute_type) {
        // কাস্টম সোয়াচ HTML রিটার্ন
        return $html . '<div class="custom-swatches">...</div>';
    }
    
    return $html;
}, 100, 2);
```

### টার্ম মেটা যোগ করা

```php
// নতুন মেটা ফিল্ড
add_action('pa_color_add_form_fields', function() {
    ?>
    <div class="form-field">
        <label for="custom_meta">Custom Meta</label>
        <input type="text" name="custom_meta" id="custom_meta" />
    </div>
    <?php
});

// মেটা সেভ করা
add_action('created_pa_color', function($term_id) {
    if (isset($_POST['custom_meta'])) {
        update_term_meta($term_id, 'custom_meta', sanitize_text_field($_POST['custom_meta']));
    }
});
```

---

## প্রিমিয়াম এক্সটেনশন

### প্রিমিয়াম ফিচার যোগ করার পদ্ধতি

```php
// premium/class-my-premium-feature.php

namespace Bizzswatches\Premium;

class My_Premium_Feature {
    public function __construct() {
        add_action('bizzswatches_loaded', array($this, 'init'));
    }
    
    public function init($main_instance) {
        // প্রিমিয়াম ফিচার ইনিশিয়ালাইজ
    }
}

// Premium Loader এ যোগ করুন
add_action('bizzswatches_loaded', function() {
    if (bizzswatches()->is_pro()) {
        new \Bizzswatches\Premium\My_Premium_Feature();
    }
});
```

### প্রো ভার্শন অ্যাক্টিভেট করা

```php
// প্রো প্লাগিন থেকে
add_filter('bizzswatches_is_pro', '__return_true');
```

---

## কোড স্ট্যান্ডার্ড

### নেমিং কনভেনশন

- ক্লাস: `Pascal_Case` (যেমন: `Swatches_Display`)
- মেথড: `snake_case` (যেমন: `render_swatches`)
- কনস্ট্যান্ট: `UPPERCASE` (যেমন: `BIZZSWATCHES_VERSION`)
- হুক: `bizzswatches_` প্রিফিক্স (যেমন: `bizzswatches_loaded`)

### ফাইল নেমিং

- ক্লাস ফাইল: `class-{class-name}.php`
- নেমস্পেস: ফোল্ডার স্ট্রাকচার ফলো করবে

### PHPDoc

```php
/**
 * Render the swatches.
 *
 * @param string $html Existing HTML.
 * @param array  $args Arguments array.
 * @return string Modified HTML.
 */
public function render_swatches($html, $args) {
    // ...
}
```

---

## টেস্টিং

### ম্যানুয়াল টেস্টিং

1. Variable প্রোডাক্ট তৈরি করে সোয়াচ চেক করুন
2. বিভিন্ন থিমে টেস্ট করুন
3. মোবাইল রেসপন্সিভনেস চেক করুন
4. অন্যান্য প্লাগিনের সাথে কম্প্যাটিবিলিটি চেক করুন

### ডিবাগিং

```php
// WP_DEBUG মোডে এরর দেখুন
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);

// কাস্টম লগ
if (function_exists('bizzswatches')) {
    error_log('Bizzswatches loaded: ' . bizzswatches()->version());
}
```
