`; starContainer += ` `; for (let i = 0; i < starCount; i++) { const isFilled = i + 1 <= ratingIntegerPart; const isHalfFilled = ratingDecimalPart > 0 && i + ratingDecimalPart === rating; starRatingClass = isFilled ? "star-filled" : "star-empty"; starContainer += ` `; } starContainer += `

`; return starContainer; }, getContentShareLink: (sharingProvider, content) => { let sharingLink = ""; if (content) { let url = encodeURIComponent(document.URL); let name = encodeURIComponent(content.name); let imageUrl = encodeURIComponent(content.thumbnails.default); switch (sharingProvider) { case "facebook": sharingLink = "https://www.facebook.com/sharer.php?u=" + url; break; case "twitter": sharingLink = "https://twitter.com/intent/tweet?text=" + name + "&url=" + url; break; case "pinterest": sharingLink = "https://www.pinterest.com/pin/create/button/?url=" + url + "&media=" + imageUrl + "&description=" + name; break; case "blogger": sharingLink = "https://www.blogger.com/blog-this.g?u=" + url + "&n=" + name + "&t=" + imageUrl; break; case "mail": sharingLink = "mailto:?subject=I saw this and thought of you...%0A%0A" + url + "&body=" + imageUrl; break; case "reddit": sharingLink = "https://reddit.com/submit?url=" + url + "&title=" + name + "&thumbnail=" + imageUrl; break; case "flipboard": sharingLink = "https://share.flipboard.com/bookmarklet/popout?v=2&title=" + name + "&url=" + url + "&media=" + imageUrl; break; } } return sharingLink; }, getAuthorSoicalLinks(authorTaxonomy) { if (!authorTaxonomy?.properties) return ''; const p = authorTaxonomy.properties; const linkTo = (type, url) => `` const socials = []; if (p.facebook) { socials.push(linkTo('facebook', `https://www.facebook.com/${p.facebook}`)); } if (p.twitter) { socials.push(linkTo('twitter', `https://twitter.com/${p.twitter}`)); } if (p.instagram) { socials.push(linkTo('instagram', `https://www.instagram.com/${p.instagram}`)); } return `` }, renderHowToYouWillNeedContent(content) { const prefix = 'you_will_need.im-requirements-list.list.'; const listLen = content?.properties?.[prefix + '_element_count']; const entryTexts = []; if (listLen) { for (let i = 0; i < listLen; i++) { const title = content.properties?.[`${prefix}${i}.title`]; const materials = content.properties?.[`${prefix}${i}.item.materials.name`]; const note = content.properties?.[`${prefix}${i}.item.note`]; const quantity_unit = content.properties?.[`${prefix}${i}.item.quantity_unit`]; let str = ''; if (title) str += `${title}: `; if (materials) str += materials; if (note) str += ` (${note})`; if (quantity_unit) str += ` (${quantity_unit})`; if (str.trim() !== '') { entryTexts.push(str); } } } return `

${e}

`; }, renderHowToMethodsContent(content) { const entryTexts = []; let currentGroup = 0; let stepCounter = 0; for (let i = 0; ; i++) { const groupTitle = content.properties[`how_to_method.0.list.${i}.item_group_title`]; if (groupTitle) { currentGroup++; stepCounter = 0; entryTexts.push(`

${groupTitle}

`); } else { const note = content.properties[`how_to_method.0.list.${i}.note`]; if (!note) { break; } stepCounter++; entryTexts.push(`

Step ${stepCounter}

${note}

`); } } return `

${entryTexts.join('')}

`; }, renderRecipeIngredientsContent(content) { const prefix = 'sxs-ingredients-group.sxs-ingredients-flex.'; const prefixDisplay = '.sxs-ingredients-flex-ingredient-display.'; const prefixData = '.sxs-ingredients-flex-ingredient-data.'; const listLen = content?.properties[prefix + '_element_count']; const entryTexts = []; for (let i = 0; i < listLen; i++) { let quantity = content?.properties[`${prefix + i + prefixDisplay}sxs-ingredients-flex-ingredient-display-quantity`]; let name = content?.properties[`${prefix + i + prefixDisplay}sxs-ingredients-flex-ingredient-display-ingredient`]; let note = content?.properties[`${prefix + i + prefixDisplay}sxs-ingredients-flex-ingredient-display-note`]; let quantityString = quantity ? `${quantity} ` : ""; let nameString = name || ""; let noteString = note ? ` ${note}` : ""; let row = quantityString + nameString + noteString; entryTexts.push(row); } if (entryTexts.length > 0) { return `

${e}`).join('')}

`; } else { return "No ingredients available."; } }, renderRecipeMethodsContent(content) { const prefix = 'sxs-method-recipe-group.sxs-method-recipe-flex.'; const listLen = content?.properties[prefix + '_element_count']; const entryTexts = []; for (let i = 0; i < listLen; i++) { const row = content.properties[`${prefix}${i}.sxs-method-recipe-step`]; if (row !== undefined) { entryTexts.push(row); } } return `

${i === 0 ? 'Step 1' : `Step ${i + 1}`}
${e}

`; }, buildJsonLD(content, document) { const url = document?.location?.href || ''; const domain = (url !== '') ? url.substring(0, url.indexOf('/', 10)) : ''; const logo = purple.experience?.global?.experienceConfig?.logo; if (logo) logo["@type"] = "ImageObject"; const JSON_LS_HELPER = { fillImages: (content, jsonLD) => { jsonLD.image = []; if (content.thumbnails?.default) { jsonLD.image.push(content.thumbnails?.default); } }, fillAuthors: (content, jsonLD, onlyFirst) => { jsonLD.author = content.authors.map(a => { return { "@type": "Person", "name": a.name, "jobTitle": a.properties.job_title, "description": a.properties.description, "image": { "@type": "ImageObject", "url": a.thumbnails.default, "width": 768, "height": 574 }, "url": a.properties.user_url }; }); if (onlyFirst) { jsonLD.author = jsonLD.author.length ? jsonLD.author[0] : {}; } }, fillDates: (content, jsonLD) => { jsonLD.datePublished = new Date(content.publicationDate).toISOString(); if (content.lastModified) jsonLD.dateModified = new Date(content.lastModified).toISOString();; }, fillProsCons: (content, jsonLD) => { jsonLD.positiveNotes = []; jsonLD.negativeNotes = []; const positiveRating = content.properties["rating.positive"].split(';').map(item => item.trim()); const negativeRating = content.properties["rating.negative"].split(';').map(item => item.trim()); const positiveListItems = positiveRating.map((element, index) => ({ "@type": "ListItem", "position": index + 1, "name": element })); const negativeListItems = negativeRating.map((element, index) => ({ "@type": "ListItem", "position": index + 1, "name": element })); jsonLD.positiveNotes = { "@type": "ItemList", "itemListElement": positiveListItems }; jsonLD.negativeNotes = { "@type": "ItemList", "itemListElement": negativeListItems }; return jsonLD; }, fillPriceCurrency: (content, jsonLD) => { if (content.properties["_IM_Product_Price.GBP"]) { jsonLD.itemReviewed.offers.priceCurrency = "GBP"; } else if (content.properties["product_price._IM_Product_Price_GBP"]) { jsonLD.itemReviewed.offers.priceCurrency = "GBP"; } else if (content.properties["_IM_Product_Price.USD"]) { jsonLD.itemReviewed.offers.priceCurrency = "USD"; } else if (content.properties["product_price._IM_Product_Price_USD"]) { jsonLD.itemReviewed.offers.priceCurrency = "USD"; } else if (content.properties["_IM_Product_Price.EUR"]) { jsonLD.itemReviewed.offers.priceCurrency = "EUR"; } else if (content.properties["product_price._IM_Product_Price_EUR"]) { jsonLD.itemReviewed.offers.priceCurrency = "EUR"; } else { jsonLD.itemReviewed.offers.priceCurrency = ""; } } }; if (!content) return ''; let jsonLD = null; switch (content.postType) { case "competition": break; case "reviews": jsonLD = { "@context": "https://schema.org", "@type": "Review", "mainEntityOfPage": { "@type": "WebPage", "@id": url }, "name": content.name, "headline": content.name, "image": { "@type": "ImageObject", "url": content.thumbnails.default + "?quality=45&resize=768,574", "width": 768, "height": 574 }, "speakable": { "@type": "SpeakableSpecification", "xpath": ["/html/head/title", "/html/head/meta[@name='description']/@content"] }, "itemReviewed": { "@type": "Product", "name": content.properties.monetizer_product_name || content.properties["display.headline"] || content.name, "description": content.description, "brand": content.taxonomies.filter(t => t.type == 'brand')[0]?.name || '', "category": content.properties["taxonomy.category.primary"], "sku": content.properties["product_sku"], "reviewBody": content.properties["rating.review"], "image": { "@type": "ImageObject", "url": content.thumbnails.default + "?quality=45&resize=768,574", "width": 768, "height": 574 }, "weight": content.properties["product_weight"], "height": content.properties["product_height"], "width": content.properties["product_width"], "depth": content.properties["product_depth"], "offers": { "@type": "Offer", "price": content.properties["_IM_Product_Price.GBP"] || content.properties["product_price._IM_Product_Price_GBP"] || content.properties["_IM_Product_Price.USD"] || content.properties["product_price._IM_Product_Price_USD"] || content.properties["_IM_Product_Price.EUR"] || content.properties["product_price._IM_Product_Price_EUR"] || '', "itemCondition": "https://schema.org/NewCondition" } }, "publisher": { "@type": "Organization", "name": typeof purple === 'undefined' ? '' : purple.experience?.global?.experienceConfig?.title || '', "url": domain, "logo": logo }, "reviewRating": { "@type": "Rating", "bestRating": 5, "ratingValue": content.properties["rating.number"], "worstRating": 0 }, }; JSON_LS_HELPER.fillDates(content, jsonLD); JSON_LS_HELPER.fillAuthors(content, jsonLD, true); JSON_LS_HELPER.fillProsCons(content, jsonLD); JSON_LS_HELPER.fillPriceCurrency(content, jsonLD); break; case "sxs-recipe": jsonLD = { "@context": "https://schema.org", "@type": "Recipe", name: content.name, description: content.description, prepTime: content.properties["sxs-key-data-recipe-timing.sxs-key-data-recipe-timing-prep-time.max_time"], cookTime: content.properties["sxs-key-data-recipe-timing.sxs-key-data-recipe-timing-cook-time.max_time"], totalTime: content.properties["sxs-key-data-recipe-timing.sxs-key-data-recipe-timing-total-time.max_time"], recipeYield: content.properties["sxs-key-data-recipe-servings.sxs-key-data-recipe-servings-min"], recipeIngredient: [], recipeInstructions: [] }; const iMax = Number(content.properties["sxs-ingredients-group.sxs-ingredients-flex._element_count"]); for (var m = 0; m < iMax; m++) { jsonLD.recipeIngredient.push( content.properties["sxs-ingredients-group.sxs-ingredients-flex." + m + ".sxs-ingredients-flex-ingredient-data.sxs-ingredients-flex-ingredient-data-quantity.sxs-ingredients-flex-ingredient-data-quantity-metric-number"] + " " + content.properties["sxs-ingredients-group.sxs-ingredients-flex." + m + ".sxs-ingredients-flex-ingredient-data.sxs-ingredients-flex-ingredient-data-quantity.sxs-ingredients-flex-ingredient-data-quantity-metric-unit"] + " " + content.properties["sxs-ingredients-group.sxs-ingredients-flex." + m + ".sxs-ingredients-flex-ingredient-data.sxs-ingredients-flex-ingredient-data-ingredient-ingredient.sxs-ingredients-flex-ingredient-data-ingredient-ingredient-term.name"] ); } const nMax = Number(content.properties["sxs-method-recipe-group.sxs-method-recipe-flex._element_count"]); for (var m = 0; m < nMax; m++) { jsonLD.recipeInstructions.push({ "@type": "HowToStep", "name": "Step " + (m + 1), "text": content.properties["sxs-method-recipe-group.sxs-method-recipe-flex." + m + ".sxs-method-recipe-step"] }); } JSON_LS_HELPER.fillDates(content, jsonLD); JSON_LS_HELPER.fillImages(content, jsonLD); JSON_LS_HELPER.fillAuthors(content, jsonLD, true); break; case "how_to": jsonLD = { "@context": "https://schema.org", "@type": "HowTo", name: content.name, image: { "@type": "ImageObject", url: content.properties.hero_image, "height": "406", "width": "305" }, supply: [], step: [] }; const sMax = Number(content.properties["you_will_need.im-requirements-list.list"]); for (var m = 0; m < sMax; m++) { const supplyText = content.properties["you_will_need.im-requirements-list.list." + m + ".item.materials.name"] + " (" + content.properties["you_will_need.im-requirements-list.list." + m + ".item.quantity_unit"] + ")"; jsonLD.supply.push({ "@type": "HowToSupply", name: supplyText }); } const mMax = Number(content.properties.how_to_method); for (var m = 0; m < mMax; m++) { const idxMax = Number(content.properties["how_to_method." + m + ".list"]); for (var idx = 0; idx < idxMax; idx++) { const note = content.properties["how_to_method." + m + ".list." + idx + ".note"]; const noteEl = document.createElement('p'); noteEl.innerHTML = note; const stepText = noteEl.innerText; jsonLD.step.push({ "@type": "HowToStep", name: "Step " + (idx + 1), "text": stepText }); } } break; case "list": break; case "glossary": break; case "offer": jsonLD = { "@context": "https://schema.org", "@type": "Product", name: content.name, description: content.description, offers: { "@type": "Offer", url: content.properties.link_link_to } }; JSON_LS_HELPER.fillImages(content, jsonLD); break; default: jsonLD = { "@context": "https://schema.org", "@type": "Article", headline: content.name, }; JSON_LS_HELPER.fillDates(content, jsonLD); JSON_LS_HELPER.fillImages(content, jsonLD); JSON_LS_HELPER.fillAuthors(content, jsonLD); } return jsonLD ? JSON.stringify(jsonLD) : "{}"; }, getPath() { return document.location.pathname; }, getPostTags(content) { if (!content || !content.taxonomies) return ''; return content.taxonomies.filter(t => t.type === 'tag').map(t => t.id).join(','); }, getTaxonomyValue: (content, taxonomyType) => { if (!content || !content.taxonomies) return ''; return content.taxonomies.filter(t => t.type === taxonomyType).map(t => t.id).join(','); }, isNative(content) { if (!content || !content.properties) return false; return content && content.properties && (content.properties["sponsor_type"] === "native-advertorial"); }, getNoImageClass(isNoImage) { return isNoImage === true ? 'no-image' : ''; }, getBannerSrc(settings, bannerId) { return settings[bannerId]?.image; }, getBannerUrl(settings, bannerId) { return settings[bannerId]?.url; }, setTaxonomyTitle: (taxName, taxSeoTitle, globalTitle) => { if (taxSeoTitle) { const parsedtaxSeoTitle = JSON.parse(taxSeoTitle).title; return parsedtaxSeoTitle; } return taxName ? `${taxName} | ${globalTitle}` : ''; }, setTaxonomyDescription: (desName, taxSeoDes) => { const parsedtaxSeoDes = JSON.parse(taxSeoDes).description; return parsedtaxSeoDes ?? desName ?? ''; }, setArticleDescription: (seoDes, contextDes) => { const parsedSeoDes = JSON.parse(seoDes).description; if (parsedSeoDes) { return; } else { return contextDes; } }, isNotAnEmptyList(list) { return !!list?.length; } }

${groupTitle}

Step ${stepCounter}

${i === 0 ? 'Step 1' : `Step ${i + 1}`}

Jamie Carter

Science writer

In pictures: South America wowed by annular solar eclipse over Easter Island, Chile, Argentina

Ever seen a ring of fire in the sky? This is what causes an annular solar eclipse and why it's different from a total

Eclipses 2024 | This year's solar and lunar eclipses

14 best astronomy and stargazing apps for smartphones

Stargazing at Yorkshire Dales and North York Moors Dark Sky Reserves

Astrophotography With A Smartphone: Timelapses

6 of the best places for stargazing in Spain

Japan is sending a spacecraft to Mars's moons and returning a sample for study back on Earth

Vaonis Hestia telescope review

The biggest camera in world is part of a new observatory set to study the mysterious dark universe

Boasting dark skies over rolling landscapes, Scotland offers some of the best places to stargaze in the UK

Buzz Aldrin has a striking vision for the long-term human exploration of Mars

Dark-sky USA! Avoid light pollution and explore the cosmos in these US National Parks perfect for stargazing

10 of the best stargazing and astronomy holidays

12 ancient stones, tombs and temples across the world that align with the Sun at the solstice

Why stargazing at Grand Canyon Dark Sky Park is one of best night-sky experiences in the USA

See the Sun kiss the Big Apple! Manhattanhenge has arrived, and this is how you can see it

Buyer's guide | Smartphone astrophoto gadgets

Eclipse España: Six solar eclipses, including two total eclipses, will be seen from Spain in just six years

Capture the colours, swirls and wisps of the Northern Lights with our guide on how to photograph the aurora

Tomorrow's solar eclipse marks the second of two major solar eclipses visible across the US

Our complete guide to the April 8 total solar eclipse, including times, locations and weather predictions

In the UK and missing the April solar eclipse? Fear not, we're about to get seven solar eclipses in seven years

10 events in the US to see the total solar eclipse on April 8, 2024