Fourthwall moved the product title from <h2> to <h1>, which silently emptied
[fourthwall_single] and [fourthwall_random]: both gated rendering on a title
match that could no longer succeed. Verified against a live store.
Parsing
- Read schema.org JSON-LD first, falling back to scraped markup field by field,
then to og: meta tags. Each field degrades independently, so a future markup
change can only affect what it actually touched.
- Match CSS classes with a padded contains() predicate instead of @class="...",
and select on data-testid where available. Exact class matching is what broke.
- Surface sku, availability and currency, which were previously discarded.
Product discovery
- Enumerate products from sitemap.xml rather than scraping the store page, which
only sees the collection it features. [fourthwall_random count="10"] could not
return more than the 3 items a featured homepage renders.
- New source="auto|sitemap|page" attribute. Off-host <loc> entries are rejected
so a hostile sitemap cannot redirect fetches.
Caching
- Stale-while-revalidate: stale entries are served immediately and refreshed by
WP-Cron, so cache expiry never costs a visitor a network round trip.
- Refresh scheduling dedupes via wp_next_scheduled and takes a lock, collapsing
a stampede to a single job.
- Fetch uncached product pages concurrently with curl_multi instead of serially.
- Cache lifetime is now configurable (default 60 minutes).
- Entries written by earlier versions are read as stale and upgraded in place,
so caches turn over without blanking a store.
Fixes
- Build absolute product links properly. "/collections/all" + "/products/x"
produced 404s; a trailing slash produced "//products/x".
- Escape the price on output; it was interpolated raw.
- strpos() misuse meant an error string at offset 0 was treated as success.
- Guard a null description node that would fatal when show_description="true".
- Report non-200 responses instead of caching an empty body silently.
- Drop the shared /tmp/cookies.txt jar. It was cross-site mutable state and made
concurrent fetching unsafe; all endpoints return 200 without it.
- Remove the ssl_verify setting. It was a development affordance and its
checkbox never worked - unchecked meant "key absent", which read as true.
Certificate verification is now pinned on.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Fourthwall changed product title tags from h1 to h2 on individual
product pages, breaking the fourthwall_random and fourthwall_single
shortcodes. Updated XPath query to match new h2 tag structure.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Add three usage examples for the new [fourthwall_random] shortcode
- Include examples for basic random products, specific URLs, and different stores
- Place examples alongside existing shortcode documentation in admin panel
- Improve user experience by providing clear usage guidance
- Add [fourthwall_random] shortcode for displaying random products
- Support for specifying count of products to display
- Option to use all store products or specific product URLs
- Add fwembed_extract_product_urls() function to extract product URLs
- Add fwembed_get_random_products() function for randomization logic
- Update README.md with comprehensive documentation and examples
- Maintain backward compatibility with existing shortcodes
- Eliminated code duplication by creating common HTTP request function
- Added configurable SSL verification setting for development/production
- Implemented smart caching system with 1-hour cache duration
- Enhanced admin interface with cache management and better styling
- Improved error handling and user experience
- Added comprehensive documentation and troubleshooting guide
- Updated README with new features and configuration options
shadowdaoandClaude Opus 5