Changeset 3786796

Timestamp:

11/05/2026 09:52:12 PM (23 hours ago)

Author:

giftlight

Message:

Giftlight 1.0.1: sections share out the shop's products; wholesale-only products stay out; FAQ: try it on a demo shop, page speed

Location:

giftlight

Files:

• tags/1.0.1 (copied) (copied from giftlight/trunk )
• tags/1.0.1/admin.php (copied) (copied from giftlight/trunk/admin.php )
• tags/1.0.1/assets (copied) (copied from giftlight/trunk/assets )
• tags/1.0.1/assets/giftlight.js (modified) (3 diffs)
• tags/1.0.1/blocks (copied) (copied from giftlight/trunk/blocks )
• tags/1.0.1/blocks/gift-guide/block.json (modified) (1 diff)
• tags/1.0.1/giftlight.php (copied) (copied from giftlight/trunk/giftlight.php ) (2 diffs)
• tags/1.0.1/readme.txt (copied) (copied from giftlight/trunk/readme.txt ) (3 diffs)
• tags/1.0.1/uninstall.php (copied) (copied from giftlight/trunk/uninstall.php )
• trunk/assets/giftlight.js (modified) (3 diffs)
• trunk/blocks/gift-guide/block.json (modified) (1 diff)
• trunk/giftlight.php (modified) (2 diffs)
• trunk/readme.txt (modified) (3 diffs)

giftlight/tags/1.0.1/assets/giftlight.js

@@ -95 +95 @@
 // Build a gift finder from the catalog. It only asks what the catalog can answer: a question goes in only when at least
 // two of its options each lead to `min` products and none of them matches everything. Returns { questions, products }.
+// A product filed only under wholesale collections (a bulk case, a trade pack) isn't a gift. Nov 5: the WooCommerce walk's
+// $300 "Bulk Mug Case", in "WholeSale7" alone, reached "Gifts $60 and up" once sections stopped repeating gifts.
+// A product that is also in a shopper-facing collection stays.
+const wholesaleOnly = (p, names) => {
+  const in_ = (p.cols || []).map(id => names.get(id)).filter(Boolean);
+  return in_.length > 0 && in_.every(n => /wholesale/i.test(n));
+};
+
 function buildGiftFinder({ products = [], collections = [], money } = {}, { min = 2, maxOptions = 6 } = {}) {
+  const colNames = new Map(collections.map(c => [c.id, clean(c.title)]));
   const live = products
-    .filter(p => p.available !== false && p.image && p.price > 0)
+    .filter(p => p.available !== false && p.image && p.price > 0 && !wholesaleOnly(p, colNames))
     .map(p => ({ ...p, aud: audienceOf(p, collections) }));
   const narrows = n => n >= min && n < live.length;
@@ -200 +209 @@
   const live = (quiz.products || []).filter(p => p.available !== false).sort(byRank);
   const sections = [];
+  // Nov 4, 2026: a gift already shown higher up gives way to one that hasn't been, so a store's first few products
+  // don't fill every section (16 of 50 merchant critics named the repeats). A section still shows as many gifts as
+  // before, in store order; a gift repeats only when its section has nothing new left.
+  const shown = new Map();
+  const seen = p => shown.get(p.id) || 0;
   for (const id of ['who', 'budget', 'into']) {
     const q = (quiz.questions || []).find(x => x.id === id);
@@ -208 +222 @@
       if (fit.length < min) continue;
       if (o.rule.kind === 'price') fit = fit.map(p => { const v = inBand(p, o.rule); return v && v[0] !== p.variant ? { ...p, variant: v[0], price: v[1] } : p; });
-      sections.push({ id: `${id}-${o.id}`, title: GUIDE_TITLE[id](o), products: fit.slice(0, per), total: fit.length });
+      const pick = [...fit].sort((a, b) => seen(a) - seen(b) || byRank(a, b)).slice(0, per).sort(byRank);
+      for (const p of pick) shown.set(p.id, seen(p) + 1);
+      sections.push({ id: `${id}-${o.id}`, title: GUIDE_TITLE[id](o), products: pick, total: fit.length });
     }
   }

giftlight/tags/1.0.1/blocks/gift-guide/block.json

@@ -3 +3 @@
         "apiVersion": 3,
         "name": "giftlight/gift-guide",
-        "version": "1.0.0",
+        "version": "1.0.1",
         "title": "Gift guide",
         "category": "woocommerce",

giftlight/tags/1.0.1/giftlight.php

@@ -4 +4 @@
  * Plugin URI:        https://giftlight.app/
  * Description:       A gift guide and a gift finder quiz built from your own WooCommerce products: by who it's for, what to spend and what they're into.
- * Version:           1.0.0
+ * Version:           1.0.1
  * Requires at least: 6.3
  * Requires PHP:      7.4
@@ -21 +21 @@
 }
 
-define( 'GIFTLIGHT_VERSION', '1.0.0' );
+define( 'GIFTLIGHT_VERSION', '1.0.1' );
 define( 'GIFTLIGHT_FILE', __FILE__ );
 define( 'GIFTLIGHT_MAX_PRODUCTS', 300 );

giftlight/tags/1.0.1/readme.txt

@@ -6 +6 @@
 Requires PHP: 7.4
 Requires Plugins: woocommerce
-Stable tag: 1.0.0
+Stable tag: 1.0.1
 License: GPLv2 or later
 License URI: https://www.gnu.org/licenses/gpl-2.0.html
@@ -41 +41 @@
 == Frequently Asked Questions ==
 
+= Can I try it before I install it? =
+
+Yes. [Open the demo shop](https://playground.wordpress.net/?blueprint-url=https://giftlight.app/demo/woo-preview.json): a temporary WordPress in your browser with WooCommerce, 90 sample products and the Gift Guide page Giftlight made from them. Nothing is installed on your site, and it's gone when you close the tab. It takes a minute or two to load.
+
+= Will it slow my shop down? =
+
+It adds one deferred script (about 30 KB) and one small stylesheet, and only on pages that show the guide or the quiz. The product list it reads is cached for 12 hours and refreshed when you change a product or category.
+
 = Do I have to write the questions? =
 
@@ -73 +81 @@
 == Changelog ==
 
+= 1.0.1 =
+* Sections share out your products: a gift already shown in a section above gives way to one that hasn't been, so shoppers see more of your shop.
+
 = 1.0.0 =
 * First release: the gift guide block and shortcode, the gift quiz, and the one-click Gift Guide page.

giftlight/trunk/assets/giftlight.js

@@ -95 +95 @@
 // Build a gift finder from the catalog. It only asks what the catalog can answer: a question goes in only when at least
 // two of its options each lead to `min` products and none of them matches everything. Returns { questions, products }.
+// A product filed only under wholesale collections (a bulk case, a trade pack) isn't a gift. Nov 5: the WooCommerce walk's
+// $300 "Bulk Mug Case", in "WholeSale7" alone, reached "Gifts $60 and up" once sections stopped repeating gifts.
+// A product that is also in a shopper-facing collection stays.
+const wholesaleOnly = (p, names) => {
+  const in_ = (p.cols || []).map(id => names.get(id)).filter(Boolean);
+  return in_.length > 0 && in_.every(n => /wholesale/i.test(n));
+};
+
 function buildGiftFinder({ products = [], collections = [], money } = {}, { min = 2, maxOptions = 6 } = {}) {
+  const colNames = new Map(collections.map(c => [c.id, clean(c.title)]));
   const live = products
-    .filter(p => p.available !== false && p.image && p.price > 0)
+    .filter(p => p.available !== false && p.image && p.price > 0 && !wholesaleOnly(p, colNames))
     .map(p => ({ ...p, aud: audienceOf(p, collections) }));
   const narrows = n => n >= min && n < live.length;
@@ -200 +209 @@
   const live = (quiz.products || []).filter(p => p.available !== false).sort(byRank);
   const sections = [];
+  // Nov 4, 2026: a gift already shown higher up gives way to one that hasn't been, so a store's first few products
+  // don't fill every section (16 of 50 merchant critics named the repeats). A section still shows as many gifts as
+  // before, in store order; a gift repeats only when its section has nothing new left.
+  const shown = new Map();
+  const seen = p => shown.get(p.id) || 0;
   for (const id of ['who', 'budget', 'into']) {
     const q = (quiz.questions || []).find(x => x.id === id);
@@ -208 +222 @@
       if (fit.length < min) continue;
       if (o.rule.kind === 'price') fit = fit.map(p => { const v = inBand(p, o.rule); return v && v[0] !== p.variant ? { ...p, variant: v[0], price: v[1] } : p; });
-      sections.push({ id: `${id}-${o.id}`, title: GUIDE_TITLE[id](o), products: fit.slice(0, per), total: fit.length });
+      const pick = [...fit].sort((a, b) => seen(a) - seen(b) || byRank(a, b)).slice(0, per).sort(byRank);
+      for (const p of pick) shown.set(p.id, seen(p) + 1);
+      sections.push({ id: `${id}-${o.id}`, title: GUIDE_TITLE[id](o), products: pick, total: fit.length });
     }
   }

giftlight/trunk/blocks/gift-guide/block.json

@@ -3 +3 @@
         "apiVersion": 3,
         "name": "giftlight/gift-guide",
-        "version": "1.0.0",
+        "version": "1.0.1",
         "title": "Gift guide",
         "category": "woocommerce",

giftlight/trunk/giftlight.php

@@ -4 +4 @@
  * Plugin URI:        https://giftlight.app/
  * Description:       A gift guide and a gift finder quiz built from your own WooCommerce products: by who it's for, what to spend and what they're into.
- * Version:           1.0.0
+ * Version:           1.0.1
  * Requires at least: 6.3
  * Requires PHP:      7.4
@@ -21 +21 @@
 }
 
-define( 'GIFTLIGHT_VERSION', '1.0.0' );
+define( 'GIFTLIGHT_VERSION', '1.0.1' );
 define( 'GIFTLIGHT_FILE', __FILE__ );
 define( 'GIFTLIGHT_MAX_PRODUCTS', 300 );

giftlight/trunk/readme.txt

@@ -6 +6 @@
 Requires PHP: 7.4
 Requires Plugins: woocommerce
-Stable tag: 1.0.0
+Stable tag: 1.0.1
 License: GPLv2 or later
 License URI: https://www.gnu.org/licenses/gpl-2.0.html
@@ -41 +41 @@
 == Frequently Asked Questions ==
 
+= Can I try it before I install it? =
+
+Yes. [Open the demo shop](https://playground.wordpress.net/?blueprint-url=https://giftlight.app/demo/woo-preview.json): a temporary WordPress in your browser with WooCommerce, 90 sample products and the Gift Guide page Giftlight made from them. Nothing is installed on your site, and it's gone when you close the tab. It takes a minute or two to load.
+
+= Will it slow my shop down? =
+
+It adds one deferred script (about 30 KB) and one small stylesheet, and only on pages that show the guide or the quiz. The product list it reads is cached for 12 hours and refreshed when you change a product or category.
+
 = Do I have to write the questions? =
 
@@ -73 +81 @@
 == Changelog ==
 
+= 1.0.1 =
+* Sections share out your products: a gift already shown in a section above gives way to one that hasn't been, so shoppers see more of your shop.
+
 = 1.0.0 =
 * First release: the gift guide block and shortcode, the gift quiz, and the one-click Gift Guide page.