A WordPress plugin that adds an AI-powered gift finder to tinyjoygifts.com. Customers answer 4 quick questions — recipient, occasion, vibe, and budget — and get personalized product recommendations with an AI-written message.
- 4-step wizard — recipient → occasion → vibe → budget
- Floating widget — persistent 🎁 button on every page, configurable label
- Shortcode — embed the full finder on any page with
[tinyjoy_gift_finder] - Progressive matching — if no exact match, relaxes filters automatically so customers always see results
- AI message — personalized 2-sentence recommendation powered by your choice of AI provider (see below)
- Admin settings — AI tier/provider, API key, widget toggle, button label, max results
- WordPress 6.0+
- PHP 8.0+
- WooCommerce (active)
- Download the latest release zip from the Releases page
- WordPress Admin → Plugins → Add New → Upload Plugin → choose the zip
- Activate
Auto-updates: Install GitHub Updater on your WordPress site. It will detect new releases from this repo and surface them through the standard WordPress update screen.
Go to Settings → Gift Assistant.
Choose Free or Paid:
| Tier | Providers available |
|---|---|
| Free | Groq (Llama 3.1) |
| Paid | Anthropic (Claude Haiku), Gemini (Flash), OpenAI (GPT-4o mini) |
| Setting | Default | Description |
|---|---|---|
| AI Tier | Free | Free = Groq; Paid = Anthropic / Gemini / OpenAI |
| AI Provider | Groq | The specific model provider to use |
| API Key | (blank) | Key for the selected provider (see instructions on the Settings page) |
| Floating Widget | On | Toggle the 🎁 button sitewide |
| Widget Button Label | Find a Gift |
Text shown on the floating button |
| Max Products Shown | 3 |
Products returned per search (1–6) |
| Provider | Where to get your key |
|---|---|
| Groq (Free) | console.groq.com → API Keys |
| Anthropic | console.anthropic.com |
| Gemini | aistudio.google.com → Get API key |
| OpenAI | platform.openai.com → API keys |
Embed the full wizard on a dedicated page (e.g. /gift-finder):
[tinyjoy_gift_finder]
The floating widget and shortcode are independent — both can be active at the same time.
The Gift Assistant matches customer filters to WooCommerce products using a custom occasion taxonomy and standard product tags.
Add this to functions.php or a custom plugin (only needed once):
add_action( 'init', function() {
register_taxonomy( 'occasion', 'product', [
'label' => 'Occasions',
'hierarchical' => false,
'show_ui' => true,
'show_in_menu' => true,
'rewrite' => [ 'slug' => 'occasion' ],
]);
});Edit each WooCommerce product and assign the appropriate slugs:
Occasion (custom taxonomy)
| Slug | Label |
|---|---|
birthday |
Birthday |
anniversary |
Anniversary |
christmas |
Christmas / Holiday |
thank-you |
Thank You |
graduation |
Graduation |
housewarming |
Housewarming |
valentines-day |
Valentine's Day |
mothers-day |
Mother's Day |
fathers-day |
Father's Day |
baby-shower |
Baby Shower |
just-because |
Just Because |
wedding |
Wedding |
Recipient (standard product tag)
for-mom · for-dad · for-partner · for-friend · for-coworker · for-teacher · for-teen · for-kids
Vibe (standard product tag)
sentimental · funny · cute · practical · creative · personalized
| Product | Recipient Tags | Vibe Tags | Occasions |
|---|---|---|---|
| Acrylic Photo Keychain ($17.99) | for-mom, for-dad, for-partner, for-friend, for-teen | sentimental, personalized | birthday, anniversary, mothers-day, fathers-day, graduation, just-because, christmas |
| Mini Canvas Print ($27.99) | for-mom, for-dad, for-partner, for-friend | sentimental, personalized, creative | birthday, anniversary, christmas, mothers-day, fathers-day, housewarming |
| Greeting Card ($9.99) | for-mom, for-dad, for-partner, for-friend, for-coworker, for-teacher | cute, sentimental | birthday, thank-you, just-because, christmas, valentines-day, mothers-day, fathers-day |
| Mini Photo Book ($39.99) | for-mom, for-dad, for-partner, for-friend | sentimental, personalized, creative | anniversary, christmas, mothers-day, fathers-day, graduation, birthday |
| Magnet Set ($21.99) | for-mom, for-dad, for-partner, for-friend | cute, sentimental, personalized | birthday, christmas, housewarming, just-because, mothers-day, fathers-day |
| Enamel Pin ($16.99) | for-friend, for-teen, for-coworker | funny, cute | birthday, just-because, christmas |
| Custom Notepad ($18.99) | for-mom, for-coworker, for-teacher | practical, personalized | birthday, thank-you, christmas, graduation, just-because |
| Luggage / Bag Tag ($16.99) | for-partner, for-friend, for-dad | practical, personalized | birthday, christmas, graduation, just-because |
| Laminated Bookmark ($8.99) | for-mom, for-friend, for-teacher, for-coworker | sentimental, cute | birthday, thank-you, christmas, graduation, just-because |
| Mini Puzzle ($26.99) | for-mom, for-dad, for-partner, for-friend, for-kids, for-teen | funny, creative, sentimental | birthday, christmas, anniversary, just-because |
- Customer answers 4 questions in the wizard
- Plugin queries WooCommerce for products matching all selected tags + budget
- If no match, progressively relaxes: drops vibe → drops occasion → drops recipient → budget only
- Selected AI provider writes a 2-sentence personalized message (if API key is set)
- Product cards shown with image, name, price, and link to the product page
- Make your changes
- Bump
Version:intinyjoy-gift-assistant.phpandTGA_VERSION - Commit and push to
main - Create a GitHub Release — WordPress sites with GitHub Updater will be notified automatically
Proprietary — © TinyJoy. All rights reserved.