metatroncubeswdev 1262e0f5ab
Some checks failed
CI / Lint, Unit & Integration Tests (push) Has been cancelled
feat: cross-theme cart placement for the storefront widget
Many themes only expose "Add section" for the cart's checkout area, not
"Add block" next to the actual Checkout button — Shopify gives apps no
supported way to inject a block into an arbitrary spot in a theme's own
section markup, so a manually-placed app block can only ever land as a
disconnected standalone section on those themes.

Add a JS-based fallback via the app embed (already loaded site-wide,
independent of block placement): app-embed.liquid now carries the same
config settings as the block plus an "auto-place on cart page" toggle
(default on), emitted as an inert <template> with the widget's config as
data-* attributes. datetime-widget.ts's maybeAutoPlaceOnCart() finds the
theme's own Checkout button by CSS selector (a few common patterns, most
specific first) and inserts a live widget immediately before it — skipped
entirely if a block-placed widget already exists on the page, or no
Checkout button can be found by any known selector.

Also fix shopify.app.toml: automatically_update_urls_on_dev was left on
after the app got a real, permanent production domain
(metatron-delivery.thedomainnest.com) — leaving it on meant a future local
`shopify app dev` session would silently overwrite the live app's
application_url with a temporary Cloudflare tunnel, breaking the deployed
app until someone noticed and redeployed with the real URL.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-03 18:19:59 -04:00

100 lines
4.1 KiB
Plaintext

{{ 'datetime-widget.css' | asset_url | stylesheet_tag }}
<script src="{{ 'datetime-widget.js' | asset_url }}" defer="defer"></script>
{% comment %}
Cross-theme cart placement (PRODUCT_STRATEGY.md competitive parity item):
a manually-placed app BLOCK only ever lands wherever the active theme's
own section schema declares an `@app` slot — many themes don't expose one
next to the cart's Checkout button at all, only "Add section" at the top
level, which is what was showing up as a disconnected block. Shopify
gives apps no supported way to inject a block into an arbitrary spot in a
theme's own section markup, so this app embed (always loaded site-wide,
independent of any block placement) instead emits an inert <template>
carrying the widget's config as data-* attributes; datetime-widget.js
finds the theme's own Checkout button by CSS selector at runtime and
inserts a live widget immediately before it. Best-effort — it depends on
the theme's Checkout button being findable by one of a few common
selectors (see datetime-widget.ts's CHECKOUT_BUTTON_SELECTOR) — but it's
the only way to get placement that isn't at the mercy of whether a given
theme's cart section happens to support app blocks.
{% endcomment %}
{% if block.settings.auto_place_cart %}
<template
id="dd-widget-cart-template"
data-heading="{{ block.settings.heading | escape }}"
data-show-shipping="{{ block.settings.show_shipping }}"
data-show-local-delivery="{{ block.settings.show_local_delivery }}"
data-show-pickup="{{ block.settings.show_pickup }}"
data-label-shipping="{{ 'widget.method_shipping' | t | escape }}"
data-label-local-delivery="{{ 'widget.method_local_delivery' | t | escape }}"
data-label-pickup="{{ 'widget.method_pickup' | t | escape }}"
data-attr-label-shipping="{{ 'widget.date_label_shipping' | t | escape }}"
data-attr-label-local-delivery="{{ 'widget.date_label_local_delivery' | t | escape }}"
data-attr-label-pickup="{{ 'widget.date_label_pickup' | t | escape }}"
data-label-choose-date="{{ 'widget.choose_date' | t | escape }}"
data-label-choose-time="{{ 'widget.choose_time' | t | escape }}"
data-label-no-dates="{{ 'widget.no_dates' | t | escape }}"
data-label-confirmed="{{ 'widget.confirmed' | t | escape }}"
data-label-change="{{ 'widget.change' | t | escape }}"
data-label-loading="{{ 'widget.loading' | t | escape }}"
data-label-error="{{ 'widget.error' | t | escape }}"
data-label-postal-code="{{ 'widget.postal_code' | t | escape }}"
data-label-postal-code-submit="{{ 'widget.postal_code_submit' | t | escape }}"
data-label-out-of-area="{{ 'widget.out_of_area' | t | escape }}"
{% if block.settings.location_id != blank %}data-location-id="{{ block.settings.location_id | escape }}"{% endif %}
{% if block.settings.google_maps_api_key != blank %}data-google-maps-api-key="{{ block.settings.google_maps_api_key | escape }}"{% endif %}
></template>
{% endif %}
{% schema %}
{
"name": "t:app_embed.name",
"target": "body",
"settings": [
{
"type": "checkbox",
"id": "auto_place_cart",
"label": "t:app_embed.auto_place_cart_label",
"info": "t:app_embed.auto_place_cart_info",
"default": true
},
{
"type": "text",
"id": "heading",
"label": "t:app_embed.heading_label",
"default": "Choose your delivery date"
},
{
"type": "checkbox",
"id": "show_shipping",
"label": "t:app_embed.show_shipping_label",
"default": true
},
{
"type": "checkbox",
"id": "show_local_delivery",
"label": "t:app_embed.show_local_delivery_label",
"default": true
},
{
"type": "checkbox",
"id": "show_pickup",
"label": "t:app_embed.show_pickup_label",
"default": true
},
{
"type": "text",
"id": "location_id",
"label": "t:app_embed.location_id_label",
"info": "t:app_embed.location_id_info"
},
{
"type": "text",
"id": "google_maps_api_key",
"label": "t:app_embed.google_maps_api_key_label",
"info": "t:app_embed.google_maps_api_key_info"
}
]
}
{% endschema %}