ultimate-jekyll-manager 0.0.182 → 0.0.183

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CLAUDE.md CHANGED
@@ -814,6 +814,26 @@ fm.on('submit', async ({ data, $submitButton }) => {
814
814
 
815
815
  Ultimate Jekyll uses three tracking platforms: Google Analytics (gtag), Facebook Pixel (fbq), and TikTok Pixel (ttq).
816
816
 
817
+ ### ITM (Internal Tracking Medium)
818
+
819
+ Internal tracking system modeled after UTM for cross-property user journey tracking.
820
+
821
+ | Parameter | Purpose | Examples |
822
+ |-----------|---------|----------|
823
+ | `itm_source` | Platform/origin | `website`, `browser-extension`, `app`, `email` |
824
+ | `itm_medium` | Delivery mechanism | `modal`, `prompt`, `banner`, `tooltip` |
825
+ | `itm_campaign` | Specific campaign/feature | `exit-popup`, `premium-unlock`, `newsletter-signup` |
826
+ | `itm_content` | Specific context | Page path, feature ID, variant |
827
+
828
+ **Examples:**
829
+ ```
830
+ # Website exit popup
831
+ ?itm_source=website&itm_medium=modal&itm_campaign=exit-popup&itm_content=/pricing
832
+
833
+ # Extension premium unlock
834
+ ?itm_source=browser-extension&itm_medium=prompt&itm_campaign=premium-unlock&itm_content=bulk-export
835
+ ```
836
+
817
837
  ### Tracking Guidelines
818
838
 
819
839
  **IMPORTANT Rules:**
@@ -892,7 +912,7 @@ The `<html>` element has data attributes for JavaScript/CSS targeting:
892
912
  | `data-platform` | `windows`, `mac`, `linux`, `ios`, `android`, `chromeos`, `unknown` |
893
913
  | `data-browser` | `chrome`, `firefox`, `safari`, `edge`, `opera`, `brave` |
894
914
  | `data-device` | `mobile` (<768px), `tablet` (768-1199px), `desktop` (>=1200px) |
895
- | `data-runtime` | `web`, `extension`, `electron`, `node` |
915
+ | `data-runtime` | `web`, `browser-extension`, `electron`, `node` |
896
916
  | `aria-busy` | `true` (loading), `false` (ready) |
897
917
 
898
918
  **Detection source:** `web-manager/src/modules/utilities.js`
package/README.md CHANGED
@@ -607,6 +607,26 @@ formManager.ready(); // Now form is interactive
607
607
 
608
608
  **Test Page:** Navigate to `/test/libraries/form-manager` to see FormManager in action with various configurations.
609
609
 
610
+ ### ITM (Internal Tracking Medium)
611
+
612
+ Internal tracking system modeled after UTM for cross-property user journey tracking.
613
+
614
+ | Parameter | Purpose | Examples |
615
+ |-----------|---------|----------|
616
+ | `itm_source` | Platform/origin | `website`, `browser-extension`, `app`, `email` |
617
+ | `itm_medium` | Delivery mechanism | `modal`, `prompt`, `banner`, `tooltip` |
618
+ | `itm_campaign` | Specific campaign/feature | `exit-popup`, `premium-unlock`, `newsletter-signup` |
619
+ | `itm_content` | Specific context | Page path, feature ID, variant |
620
+
621
+ **Examples:**
622
+ ```
623
+ # Website exit popup
624
+ ?itm_source=website&itm_medium=modal&itm_campaign=exit-popup&itm_content=/pricing
625
+
626
+ # Extension premium unlock
627
+ ?itm_source=browser-extension&itm_medium=prompt&itm_campaign=premium-unlock&itm_content=bulk-export
628
+ ```
629
+
610
630
  ### Icons
611
631
  * Fontawesome
612
632
  * https://fontawesome.com/search
@@ -65,11 +65,12 @@ export default function (Manager, options) {
65
65
  $buttonText.textContent = effectiveConfig.okButton.text;
66
66
  }
67
67
  if (effectiveConfig.okButton.link) {
68
- // Add UTM parameters to track exit popup conversions
68
+ // Add ITM parameters to track exit popup conversions
69
69
  const url = new URL(effectiveConfig.okButton.link, window.location.origin);
70
- url.searchParams.set('itm_source', 'exit-popup');
71
- url.searchParams.set('itm_medium', 'popup');
72
- url.searchParams.set('itm_campaign', window.location.pathname);
70
+ url.searchParams.set('itm_source', 'website');
71
+ url.searchParams.set('itm_medium', 'modal');
72
+ url.searchParams.set('itm_campaign', 'exit-popup');
73
+ url.searchParams.set('itm_content', window.location.pathname);
73
74
  $button.href = url.toString();
74
75
  }
75
76
  }
@@ -174,7 +174,7 @@ async function updateManager() {
174
174
  // Check if we need to update
175
175
  if (!isUpToDate) {
176
176
  // Quit if major version difference
177
- if (levelDifference === 'major') {
177
+ if (levelDifference === 'major' && installedVersion !== 'latest') {
178
178
  return logger.error(`Major version difference detected. Please update to ${latestVersion} manually.`);
179
179
  }
180
180
 
@@ -7,6 +7,12 @@ theme:
7
7
  css:
8
8
  bundle: "classy"
9
9
 
10
+ ### REGULAR PAGES ###
11
+ sitemap:
12
+ include: false
13
+ meta:
14
+ index: false
15
+
10
16
  ### WEB MANAGER CONFIG ###
11
17
  web_manager:
12
18
  auth:
@@ -7,6 +7,12 @@ theme:
7
7
  body:
8
8
  class: "m-0 p-0 overflow-y-auto"
9
9
 
10
+ ### REGULAR PAGES ###
11
+ sitemap:
12
+ include: false
13
+ meta:
14
+ index: false
15
+
10
16
  ### WEB MANAGER CONFIG ###
11
17
  web_manager:
12
18
  auth:
@@ -7,6 +7,13 @@ theme:
7
7
  css:
8
8
  bundle: "classy"
9
9
 
10
+ ### REGULAR PAGES ###
11
+ sitemap:
12
+ include: false
13
+ meta:
14
+ index: false
15
+
16
+ ### WEB MANAGER CONFIG ###
10
17
  web_manager:
11
18
  auth:
12
19
  config:
@@ -34,6 +34,12 @@ theme:
34
34
  icon: download
35
35
  href: /reports/export
36
36
 
37
+ ### REGULAR PAGES ###
38
+ sitemap:
39
+ include: false
40
+ meta:
41
+ index: false
42
+
37
43
  ### PAGE CONFIG ###
38
44
  stats_cards:
39
45
  - id: "total_revenue"
@@ -4,8 +4,6 @@ layout: themes/[ site.theme.id ]/frontend/core/minimal
4
4
  permalink: /test/account/dashboard
5
5
 
6
6
  ### REGULAR PAGES ###
7
- sitemap:
8
- include: true
9
7
  meta:
10
8
  title: "Dashboard Account Test Page"
11
9
  description: "Test"
@@ -5,7 +5,7 @@ permalink: /test
5
5
 
6
6
  ### REGULAR PAGES ###
7
7
  sitemap:
8
- include: true
8
+ include: false
9
9
  meta:
10
10
  title: "Test Page"
11
11
  description: "This is a test page for the Ultimate Jekyll Manager."
@@ -5,7 +5,7 @@ permalink: /test/libraries/ads
5
5
 
6
6
  ### REGULAR PAGES ###
7
7
  sitemap:
8
- include: true
8
+ include: false
9
9
  meta:
10
10
  title: "AdSense Test Page"
11
11
  description: "Test page for demonstrating AdSense ad units"
@@ -5,7 +5,7 @@ permalink: /test/libraries/bootstrap
5
5
 
6
6
  ### REGULAR PAGES ###
7
7
  sitemap:
8
- include: true
8
+ include: false
9
9
  meta:
10
10
  title: "Bootstrap Components Test Page"
11
11
  description: "Test page for demonstrating Bootstrap components"
@@ -1,9 +1,16 @@
1
1
  ---
2
- ### COVER LAYOUT ###
2
+ ### ALL PAGES ###
3
3
  layout: themes/[ site.theme.id ]/frontend/core/cover
4
4
  permalink: /test/libraries/cover
5
- title: Cover Page Example
6
- description: Example of a centered cover page layout
5
+
6
+ ### REGULAR PAGES ###
7
+ sitemap:
8
+ include: false
9
+ meta:
10
+ title: "Cover Page Example"
11
+ description: "Example of a centered cover page layout"
12
+ breadcrumb: "Cover Page"
13
+ index: false
7
14
  ---
8
15
 
9
16
  <!-- Login Section - max-width keeps form dainty on larger screens -->
@@ -5,7 +5,7 @@ permalink: /test/libraries/error
5
5
 
6
6
  ### REGULAR PAGES ###
7
7
  sitemap:
8
- include: true
8
+ include: false
9
9
  meta:
10
10
  title: "Error Test Page"
11
11
  description: "Test page for demonstrating error handling"
@@ -1,8 +1,16 @@
1
1
  ---
2
+ ### ALL PAGES ###
2
3
  layout: themes/[ site.theme.id ]/frontend/core/base
3
- title: FormManager Test
4
4
  permalink: /test/libraries/form-manager
5
- sitemap: false
5
+
6
+ ### REGULAR PAGES ###
7
+ sitemap:
8
+ include: false
9
+ meta:
10
+ title: "FormManager Test Page"
11
+ description: "Testing different configurations of the FormManager library."
12
+ breadcrumb: "FormManager Test"
13
+ index: false
6
14
  ---
7
15
 
8
16
  <div class="container py-5">
@@ -5,7 +5,7 @@ permalink: /test/libraries/lazy-loading
5
5
 
6
6
  ### REGULAR PAGES ###
7
7
  sitemap:
8
- include: true
8
+ include: false
9
9
  meta:
10
10
  title: "Lazy Loading Test Page"
11
11
  description: "Test page for demonstrating lazy loading functionality"
@@ -5,13 +5,14 @@ permalink: /test/redirect/external
5
5
 
6
6
  ### REGULAR PAGES ###
7
7
  sitemap:
8
- include: true
8
+ include: false
9
9
  meta:
10
10
  title: "External Redirect Test Page"
11
11
  description: "This is a test External Redirect page for the Ultimate Jekyll Manager."
12
12
  breadcrumb: "External Redirect Test Page"
13
13
  index: false
14
14
 
15
+ ### REDIRECT PAGES ###
15
16
  redirect:
16
17
  url: "https://google.com"
17
18
  ---
@@ -5,13 +5,14 @@ permalink: /test/redirect/internal
5
5
 
6
6
  ### REGULAR PAGES ###
7
7
  sitemap:
8
- include: true
8
+ include: false
9
9
  meta:
10
10
  title: "Internal Redirect Test Page"
11
11
  description: "This is a test Internal Redirect page for the Ultimate Jekyll Manager."
12
12
  breadcrumb: "Internal Redirect Test Page"
13
13
  index: false
14
14
 
15
+ ### REDIRECT PAGES ###
15
16
  redirect:
16
17
  url: "/test"
17
18
  ---
@@ -5,7 +5,7 @@ permalink: /test/translation
5
5
 
6
6
  ### REGULAR PAGES ###
7
7
  sitemap:
8
- include: true
8
+ include: false
9
9
  meta:
10
10
  title: "Test Translation Page"
11
11
  description: "This is a test Translation page for the Ultimate Jekyll Manager."
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ultimate-jekyll-manager",
3
- "version": "0.0.182",
3
+ "version": "0.0.183",
4
4
  "description": "Ultimate Jekyll dependency manager",
5
5
  "main": "dist/index.js",
6
6
  "exports": {