# Artwork Referral Links Feature

## 🎯 Overview

This feature adds **"Get Referral Link"** buttons to each artwork/product in the vendor dashboard, allowing artists to quickly generate and copy product-specific referral links.

When artists share these links and customers make purchases through them, the artist earns **1.5x commission** (50% bonus) on those sales.

---

## ✨ What's New

### For Artists

On the **Artworks/Products** page (`https://fineart.gallery/dashboard/artworks/`), each product now has a **"🔗 Get Referral Link"** button.

**Clicking the button:**
1. Opens a beautiful modal popup
2. Displays the product-specific referral link
3. Provides a one-click copy button
4. Shows the product title for reference

**Example referral link:**
```
https://fineart.gallery/product/beautiful-sunset/?ref=artistname
```

---

## 📋 How to Use (Artist Instructions)

### Step 1: Access Your Products
1. Log in to your vendor dashboard
2. Navigate to **Products** or **Artworks**
3. You'll see all your listed artworks

### Step 2: Get Referral Link
1. Find the artwork you want to promote
2. Click the **"🔗 Get Referral Link"** button
3. A popup will appear with your unique referral link

### Step 3: Copy and Share
1. Click the **"📋 Copy"** button to copy the link
2. Share the link on:
   - Social media (Instagram, Facebook, Twitter)
   - Email newsletters
   - Your personal website
   - Blog posts
   - Direct messages to collectors

### Step 4: Earn More!
When someone purchases through your link:
- ✅ Sale is tracked to you
- ✅ You earn 1.5x commission (50% bonus)
- ✅ Order notes show it was artist-driven

---

## 💰 Commission Examples

| Print Size | Normal Commission | With Referral | Your Bonus |
|-----------|------------------|---------------|------------|
| SMALL     | €30              | €45           | **+€15**   |
| MEDIUM    | €60              | €90           | **+€30**   |
| LARGE     | €120             | €180          | **+€60**   |
| LUXE      | €240             | €360          | **+€120**  |

---

## 🔧 Technical Details

### Files Added

1. **PHP Class:**
   - `includes/vendor-dashboard/class-fineart-artwork-referral-links.php`
   - Handles button injection and AJAX requests

2. **JavaScript:**
   - `js/artwork-referral-links.js`
   - Adds buttons to product listings
   - Handles modal display and copying

3. **Styles:**
   - `css/artwork-referral-links.css`
   - Beautiful gradient buttons and modal design

4. **Loader Integration:**
   - Updated `includes/class-fineart-loader.php`
   - Automatically loads the new feature

### How It Works

1. **Button Injection:**
   - JavaScript detects product rows in the dashboard
   - Adds "Get Referral Link" button to each row
   - Works with MultivendorX, WC Vendors, and standard WooCommerce

2. **Link Generation:**
   - AJAX request to server with product ID
   - Server validates ownership
   - Returns product URL + `?ref=artist-slug`

3. **Security:**
   - Nonce verification for AJAX requests
   - Product ownership validation
   - User capability checks

4. **Tracking:**
   - Uses existing referral system
   - 90-day cookie tracking
   - Automatic commission bonus application

---

## 🎨 Features

✅ **One-Click Copy** - Copy referral links instantly
✅ **Beautiful Modal** - Modern, professional design
✅ **Mobile Responsive** - Works perfectly on all devices
✅ **Auto-Detection** - Finds products automatically
✅ **Secure** - Validates user permissions
✅ **Product-Specific** - Each artwork gets its own link
✅ **Easy Sharing** - Perfect for social media

---

## 📱 Compatible With

- ✅ MultivendorX (MVX)
- ✅ WC Vendors
- ✅ WooCommerce default product tables
- ✅ All modern browsers
- ✅ Mobile and tablet devices

---

## 🚀 Promotion Ideas for Artists

### Social Media Posts

**Instagram/Facebook:**
```
🎨 New artwork available!

[Post image of artwork]

Get yours here: [referral link]

#art #artistname #collection
```

**Twitter:**
```
✨ Just listed: [Artwork Title]

Check it out 👉 [referral link]

#fineart #artwork
```

### Email Newsletter

```
Subject: 🎨 New Artwork: [Title]

Hi [Name],

I'm excited to share my latest piece with you!

[Image]

View and purchase: [referral link]

Best regards,
[Artist Name]
```

### Blog Post

Add referral links in:
- Blog posts about your creative process
- Behind-the-scenes content
- "New releases" announcements
- Collection showcases

---

## 🔍 Tracking Your Success

Visit **Dashboard > Referral Program** to see:
- Total sales driven by you
- Extra earnings from referral bonus
- Breakdown by source (link vs embed)
- Overall impact of your promotion efforts

---

## 💡 Pro Tips

1. **Use Product Links for Specific Artworks**
   - Share individual artwork links when promoting specific pieces
   - Use your general referral link for your full collection

2. **Track Performance**
   - Use different links for different platforms
   - See which promotion channels work best

3. **Combine with Embed Gallery**
   - Use referral links on social media
   - Use embed gallery on your website
   - Both earn you the 1.5x commission bonus

4. **Create Urgency**
   - "Limited edition - only 3 left!"
   - "New release - available now"
   - Encourage faster purchasing decisions

---

## ❓ FAQ

**Q: Can I share multiple product links?**
A: Yes! Each product has its own referral link. Share as many as you want.

**Q: How long does the tracking last?**
A: 90 days. If someone clicks your link and purchases within 90 days, you get the bonus.

**Q: Can I buy my own work with the referral link?**
A: Yes! Self-purchases through your referral link also earn the 1.5x commission.

**Q: What if I have both a referral link AND embed gallery?**
A: Both work! The system tracks whichever way the customer arrives and applies the bonus.

**Q: Can I customize the link?**
A: The `?ref=artistname` parameter is automatic. The link format ensures proper tracking.

**Q: Does this work on mobile?**
A: Yes! The modal and buttons are fully responsive and work great on mobile devices.

---

## 🎊 Launch Announcement Template

Use this to announce the feature to your artists:

```
📣 New Feature: Artwork Referral Links!

We've just made it even easier to earn more commission!

✨ What's New:
Every product in your dashboard now has a "Get Referral Link"
button. Click it to instantly get a shareable link for that
specific artwork.

💰 Why Use It:
When someone purchases through your referral link, you earn
1.5x commission (50% bonus)!

🚀 How to Start:
1. Go to your Products page
2. Click "Get Referral Link" on any artwork
3. Copy and share the link
4. Watch your earnings grow!

Example: Instead of €120 for a LARGE print, you'll earn €180!

Get started now: [Dashboard Link]

Questions? Check out our Referral Program guide in your dashboard.

Happy selling! 🎨
```

---

## 📞 Support

If you encounter any issues:

1. **Clear browser cache** and reload the page
2. **Check permissions** - Must be logged in as vendor
3. **Verify product ownership** - You can only get links for your own products
4. **Test in different browser** - Rule out browser-specific issues

---

## 🎯 Summary

This feature makes it **super easy** for artists to:
- ✅ Get product-specific referral links
- ✅ Copy them with one click
- ✅ Share them anywhere
- ✅ Earn 50% more commission

**The easier we make it for artists to promote, the more they'll promote, and the more everyone earns!**

---

Made with ❤️ for FINEART artists
Version 1.0 | February 2026