Changeset 3423355

search-appearance-toolkit-seo-44/tags/4.3/README.md

-                      r3405454
+                      r3423355
 * **Tags:** seo, on-page seo, schema, structured data, xml sitemaps
 * **Requires at least:** 5.5
 * **Tested up to:** 6.8
 * **Stable tag:** 4.2.0
+* **Tested up to:** 6.9
+* **Stable tag:** 4.3.0
 * **Requires PHP:** 7.4
 * **License:** GPLv2 or later
 …
 * **Knowledge Graph Control:** A dedicated interface to manage your brand's digital identity. Define your Founder, Founding Date, Contact Info, and professional Credentials to improve E-E-A-T signals.
 * **Include Images and Videos:** A built-in tool automatically finds all images and embedded YouTube videos in your content and adds them to the schema, boosting their appearance in search results.
+* **FAQ and How-To Detection:** Enable a smart scanner to detect patterns in your content for FAQ and How-To sections on your website and incorporate this useful format into the schema.
+* **FAQ and How-To Detection:** Enable smart scanners to detect patterns in your content for FAQ and How-To sections on your website and incorporate this useful format into the schema.
+* **Jump Links HowTo Scanner:** The plugin can use a Jump Links Block as a "Map" to generate detailed HowTo schema steps, while simultaneously scanning your content for Prep Time, Yield, Supplies, and Tools.
+* **Table of Contents Schema:** Automatically generates `hasPart` structured data that mirrors your Jump Links Block, helping search engines understand your article's deep structure.
 * **Modern Output:** All structured data is generated in the modern JSON-LD format preferred by search engines, following the guidelines set by [Schema.org](https://schema.org/).
 * **Granular Control:**  Tailor the Schema settings to fit your site's needs through Enable/disable settings, including on Custom Post Types and Taxonomies.
 …
 SEO 44's integration with Google Tag Manager pushes valuable events to the `dataLayer` for use in Google Analytics. The plugin provides an import file and detailed instructions for setting up Google Tag Manager and Google Analytics to receive event tracking data.
 ## Site Verification Tags
+### Site Verification Tags
 Verify your site with search engines quickly and easily. Paste your verification codes for **Google Search Console** and **Bing Webmaster Tools** into the corresponding fields in the Integrations tab. The plugin handles the rest, adding site verification meta tags to your website's head. No coding required.
+### YouTube Data API
+To ensure that your site's video schema is as accurate as possible, you may add your YouTube Data API Key.  The plugin uses this key to fetch the upload date for any YouTube video embedded in your content, replacing less reliable page scraping options and fallbacks to the post publish date.
 ---
 …
 Search Appearance Toolkit (SEO 44) gives you control over the technical, on-page SEO factors that help search engines understand and rank your content. Key benefits include:
 * **Optimized Snippets:** Control how your titles and descriptions appear in search results.
 * **Rich Results:** The advanced Schema.org data helps you earn rich results like FAQs, How-Tos, and breadcrumbs in Google.
+* **Rich Results:** The advanced Schema.org data improves indexing and helps you earn rich results in Google.
 * **Crawlability:** A clean and comprehensive XML sitemap ensures search engines can find and index all of your important content and images.
 * **User Engagement:** The Jump Links Block improves user experience, which is a positive ranking signal, and can help you earn "Jump to" links in search results.
 …
 SEO 44 helps your content look great when shared on social media platforms. You can enable the automatic generation of **Open Graph** (og:) tags, which Facebook, LinkedIn, and Pinterest use, and **Twitter Card** meta tags for when your content appears on X (formerly Twitter). This ensures your posts have the correct title, description, and preview image when shared.
 Use the plugin's Google Tag Manager Integration to facilitate additional connections with soclal media platforms. Use the Organization Schema settings to associate all of your social media profiles with your website.
+Use the plugin's Google Tag Manager Integration to facilitate additional connections with social media platforms. Use the Organization Schema settings to associate all of your social media profiles with your website.
 ### How are social media images handled?
 …
 ### What are the benefits of using FAQPage and HowTo schema?
 The plugin intelligently scans your content for patterns that match question-and-answer formats or step-by-step instructions (when this option is enabled). The plugin locates this content and automatically generates FAQPage or HowTo schema that presents this content within the JSON-LD.
 The benefit of this is that Google can use this structured data to display your content in special, highly visible formats in the search results. An FAQ page might appear as a rich snippet with expandable questions, while a How-To article can be featured in a step-by-step guide. Rich snippets make your search results stand out, which can significantly improve your click-through rate (CTR).
+The plugin intelligently scans your content for patterns that match question-and-answer formats or step-by-step instructions (when this option is enabled). The plugin locates this content and automatically generates FAQPage or HowTo schema that presents this content as structured data.
+The benefit of this is that Google can use this structured data to display your content in special, highly visible formats in the search results. An FAQ page might appear as a rich snippet with expandable questions or feature within a People Also Ask (PAA) result, while a How-To article can be featured in a step-by-step guide in AI Overviews. Search results that stand out can improve your click-through rate (CTR).
 Read more about the [FAQPage and HowTo Schema](https://seo44plugin.com/search-appearance-toolkit-seo-44/schema-structured-data/#benefits-of-faqpage-and-howto-schema) created by SEO 44.
 …
     * **Google:** [Terms of Service](https://policies.google.com/terms), [Privacy Policy](https://policies.google.com/privacy)
     * **Bing (Microsoft):** [Microsoft Services Agreement](https://www.microsoft.com/en-us/servicesagreement/), [Microsoft Privacy Statement](https://privacy.microsoft.com/en-us/privacystatement)
+### YouTube Data API Integration & Video Metadata
+* **Service Description:** This plugin connects to YouTube to fetch the "Upload Date" for videos embedded in your content. This ensures your VideoObject schema is accurate.
+* **Data Sent and Conditions:**
+    * **Method 1 (API):** If you provide a YouTube API Key in settings, the plugin sends the Video ID to the Google Data API.
+    * **Method 2 (Public Fallback):** If no API Key is present, the plugin acts as a standard browser and fetches the public video page (via `wp_remote_get`) to locate the upload date in the page meta tags.
+    * **Conditions:** This occurs automatically when a post with a YouTube embed is updated, provided that Schema generation is enabled.
+* **Service Provider Links:**
+    * **YouTube:** [Terms of Service](https://www.youtube.com/t/terms), [Google Privacy Policy](https://policies.google.com/privacy)
 ---
 …
 ## Changelog
+### 4.3.0
+* **FEATURE:** **Table of Contents Schema:** Automatically generates `hasPart` schema synchronized with the Jump Links Block to support "Jump-to" links in search results.
+* **FEATURE:** **Advanced HowTo Schema:** A new "Block-Aware" scanner uses the Jump Links Block to strictly define steps while intelligently mining the introduction for tools, time, yield, and video data.
+* **TWEAK:** Added a "Generate HowTo Schema" checkbox to the SEO 44 metabox, giving users explicit control over when the advanced scanner runs.
+* **FEATURE:** **YouTube Integration:** Added support for the YouTube Data API v3 to fetch accurate video upload dates for VideoObject schema.
+* **TESTED:** Tested to WordPress Version 6.9
 ### 4.2.0
 …
 * **TWEAK:** Updated the image uploader JavaScript to support multiple distinct upload buttons on the settings page.
-### 4.1.0
-**Jump Links Block Updates:**
-* **FEATURE:** **Sticky Positioning:** Keep your table of contents visible while users scroll. Includes a "Top Offset" slider to clear sticky headers, a "Jump Offset" slider to ensure that the sticky header does not cover the heading text, and a "Disable on Mobile" toggle to preserve screen space on small devices.
-* **FEATURE:** **Auto-Hide Title:** Implemented a smart "sticky state" detection. When the block sticks, the title gently collapses and fades out to keep the interface clean (this occurs when a block title is used alongside sticky positioning).
-* **FEATURE:** **Smart Indentation:** Added a "Create Visual Hierarchy" toggle. When enabled, H3 and H4 sub-headings are visually indented to create a clear, nested outline structure.
-* **FEATURE:** **Block Background:** You can now set a background color for the entire block container, perfect for creating "card-style" floating navigation.
-* **FEATURE:** **ScrollSpy:** Automatically highlights the active link in the table of contents as the user scrolls through the corresponding section of the post.
-* **FEATURE:** Added support for Border and Spacing controls. You can now add borders, rounded corners, margins, and padding to the Jump Links block directly from the editor settings.
-* **FEATURE:** Added a "Title tag" control. You can now choose the specific HTML tag (H2, H3, H4, H5, Paragraph, or Div) for the "On This Page" heading to better match your document structure.
-* **REFACTOR:** Optimized the block's styling logic to use CSS variables on the parent container instead of inline styles for every link. This reduces the block's HTML size and improves rendering performance.
-* **FIX:** Resolved an accessibility and HTML validation issue where using multiple Jump Links blocks on a single page created duplicate element IDs. Each block now generates a unique instance ID.
-* **PERFORMANCE:** Refactored the front-end JavaScript to use event delegation for smooth scrolling. This reduces memory usage by attaching a single event listener to the block instead of individual listeners for every link.
-* **TWEAK:** Reorganized the sidebar settings for better clarity between Block Title settings and Content Inclusion settings.
-### 4.0.0
-* **FEATURE:** Added a new "Integrations" tab for third-party services like Google Tag Manager and Webmaster Tools.
-* **FEATURE:** Added Google Tag Manager (GTM) integration. The plugin can now automatically inject the GTM container script into the site's <head> and <body> based on your ID.
-* **FEATURE:** Added Webmaster Verification. You can now add your Google Search Console and Bing Webmaster Tools verification codes directly from the plugin settings.
-* **FEATURE:** Added automatic GTM event tracking. When enabled, the plugin can push the following events to the dataLayer:
-    * Rich SEO dataLayer: Pushes page type, category, author, and tags on page load for advanced GTM triggers.
-    * Scroll Depth Tracking: Pushes 'scroll_depth' events at 25%, 50%, 75%, and 100% of the page.
-    * External & Affiliate Clicks:* Pushes 'external_link_click' or 'affiliate_link_click' (for `rel="sponsored"` links).
-    * Jump Link Clicks: Pushes a 'jump_link_click' event when a user clicks a link in the Jump Links Block.
-* **FEATURE:** Added a Google Tag Manager recipe import file (`seo44-gtm-recipe-importer.json`) and new FAQ instructions to fully configure GTM and GA4 event tracking.
-* **ENHANCEMENT:** Centralized all GTM event tracking into a new, efficient `global-tracker.js` file that uses event delegation for better performance.
-* **TWEAK:** Improved the "Integrations" settings page UI for clarity, adding clarifying tooltips and a file downloader.
-For a complete list of changes, please see the [full changelog](https://github.com/SethSmigelski/search-appearance-toolkit-seo-44/blob/main/changelog.txt) or the `changelog.txt` file included with the plugin.
 ---

search-appearance-toolkit-seo-44/tags/4.3/build/index.asset.php

r3405454	r3423355
1		<?php return array('dependencies' => array('react', 'wp-block-editor', 'wp-blocks', 'wp-components', 'wp-data', 'wp-element', 'wp-i18n'), 'version' => '~~9e72772c3731a4c27337~~');
	1	<?php return array('dependencies' => array('react', 'wp-block-editor', 'wp-blocks', 'wp-components', 'wp-data', 'wp-element', 'wp-i18n'), 'version' => '2c1769c1ec087de88890');

search-appearance-toolkit-seo-44/tags/4.3/build/index.js

r3403604	r3423355
1		(()=>{"use strict";var e,t={313~~:()=>~~{const e=window.wp.blocks,t=window.React,a=window.wp.i18n,o=window.wp.blockEditor,l=window.wp.components,n=window.wp.data,r=window.wp.element;function s(e){return(new DOMParser).parseFromString(e,"text/html").body.textContent\|\|""}const i=(0,t.createElement)("svg",{viewBox:"0 0 24 24",xmlns:"http://www.w3.org/2000/svg","aria-hidden":"true",focusable:"false"},(0,t.createElement)("path",{d:"M3 21v-2h18v2zm8-4v-6.175L9.4 12.4L8 11l4-4l4 4l-1.4 1.4l-1.6-1.575V17zM3 5V3h18v2z"})),c=(0,t.createElement)("svg",{viewBox:"0 0 24 24",xmlns:"http://www.w3.org/2000/svg","aria-hidden":"true",focusable:"false"},(0,t.createElement)("path",{d:"M3 5V3h18v2zm9 12l-4-4l1.4-1.4l1.6 1.575V7h2v6.175l1.6-1.575L16 13zm-9 4v-2h18v2z"})),h=(0,t.createElement)("svg",{className:"arrow-down",width:"24",height:"24",viewBox:"0 0 24 24",xmlns:"http://www.w3.org/2000/svg","aria-hidden":"true",focusable:"false"},(0,t.createElement)("path",{d:"M12 16l-6-6 1.41-1.41L12 13.17l4.59-4.58L18 10l-6 6z"})),p=JSON.parse('{"UU":"seo44/jump-links"}');(0,e.registerBlockType)(p.UU,{edit:function({attributes:e,setAttributes:p}){const{headingLevels:k,headings:u,showHeading:d,headingText:m,headingTag:g,layout:_,listStyle:b,isEditing:v,isCollapsible:f,isSmartIndentation:x,fontSize:w,textColor:C,linkColor:E,blockBackgroundColor:y,linkBackgroundColor:B,linkBackgroundColorHover:S,linkBorderColor:z,linkBorderRadius:T,isSticky:N,stickyOffset:H,jumpOffset:M,stickyStrategy:P}=e,O={color:C,fontSize:w,"--jump-link-font-size":w\|\|"18px","--seo44-link-color":E,"--seo44-link-bg":"horizontal"===_?B:void 0,"--seo44-link-hover-bg":"horizontal"===_?S:void 0,"--seo44-link-border-color":"horizontal"===_?z:void 0,"--seo44-link-radius":"horizontal"===_&&T?`${T}px`:void 0,"--seo44-block-bg":y,"--seo44-sticky-offset":N?`${H}px`:void 0},I="ol"===b?"ol":"ul",{createInfoNotice:L}=(0,n.useDispatch)("core/notices"),j=e.blockInstanceId?`seo44-jump-links-list-${e.blockInstanceId}`:"seo44-jump-links-list",$=(0,o.useBlockProps)({style:O});$.className=`${$.className} ${"horizontal"===_?"is-layout-horizontal":""} ${f&&!v?"is-collapsible":""} ${"none"===b?"list-style-none":""}`.trim();const D=(0,n.useSelect)(e=>e("core/block-editor").getBlocks(),[]),{updateBlockAttributes:V}=(0,n.useDispatch)("core/block-editor");(0,r.useEffect)(()=>{const t={};e.blockInstanceId\|\|(t.blockInstanceId=Math.random().toString(36).substr(2,9)),Object.keys(t).length>0&&p(t);const o=D.filter(e=>"core/heading"===e.name&&k.includes(`h${e.attributes.level}`)),l=new Set;let n=!1;const r=new Map(u.map(e=>[e.anchor,e])),i=[];for(const e of o){const t=s(e.attributes.content);let a=e.attributes.anchor\|\|t.toLowerCase().replace(/[^a-z0-9\s-]/g,"").trim().replace(/\s+/g,"-"),o=a,c=2;for(;l.has(o);)o=`${a}-${c}`,c++,n=!0;l.add(o),e.attributes.anchor!==o&&V(e.clientId,{anchor:o});const h=r.get(e.attributes.anchor)\|\|r.get(o),p=h&&h.linkText!==h.text?h.linkText:t,k=!h\|\|h.isVisible;i.push({anchor:o,text:t,linkText:p,isVisible:k,level:e.attributes.level})}JSON.stringify(i)!==JSON.stringify(u)&&p({headings:i}),n&&L((0,a.__)("Jump Links Block: Duplicate headings were found. Unique IDs have been auto-generated, but this may be a sign of redundancy. Please review your headings for clarity.","search-appearance-toolkit-seo-44"),{type:"snackbar"})},[D,k,u,e.blockInstanceId,p,V,L]),(0,r.useEffect)(()=>{"horizontal"===_&&"none"!==b&&p({listStyle:"none"})},[_,b,p]);const R=(e,t)=>{const a=[...u],o=a.splice(e,1)[0];"up"===t?a.splice(e-1,0,o):a.splice(e+1,0,o),p({headings:a})},J=e=>{const t=k.includes(e)?k.filter(t=>t!==e):[...k,e];p({headingLevels:t.sort()})};return(0,t.createElement)(r.Fragment,null,(0,t.createElement)(o.InspectorControls,null,(0,t.createElement)(l.PanelBody,{title:(0,a.__)("Presentation","search-appearance-toolkit-seo-44")},(0,t.createElement)(l.ButtonGroup,null,(0,t.createElement)(l.Button,{isPrimary:!v,isPressed:!v,onClick:()=>p({isEditing:!1})},(0,a.__)("Viewing Mode","search-appearance-toolkit-seo-44")),(0,t.createElement)(l.Button,{isPrimary:v,isPressed:v,onClick:()=>p({isEditing:!0})},(0,a.__)("Editing Mode","search-appearance-toolkit-seo-44"))),(0,t.createElement)("p",{className:"description"},(0,a.__)("Switch to Editing Mode to customize link text, visibility, and order.","search-appearance-toolkit-seo-44"))),(0,t.createElement)(l.PanelBody,{title:(0,a.__)("Appearance","search-appearance-toolkit-seo-44")},(0,t.createElement)("p",null,(0,t.createElement)("strong",null,(0,a.__)("Layout","search-appearance-toolkit-seo-44"))),(0,t.createElement)(l.ButtonGroup,null,(0,t.createElement)(l.Button,{isPrimary:"vertical"===_,isPressed:"vertical"===_,onClick:()=>p({layout:"vertical"})},(0,a.__)("Vertical","search-appearance-toolkit-seo-44")),(0,t.createElement)(l.Button,{isPrimary:"horizontal"===_,isPressed:"horizontal"===_,onClick:()=>p({layout:"horizontal"})},(0,a.__)("Horizontal","search-appearance-toolkit-seo-44"))),(0,t.createElement)(l.ToggleControl,{label:(0,a.__)("Make Jump Links Area Expandable","search-appearance-toolkit-seo-44"),help:(0,a.__)('Conserve screen space by collapsing a long list of jump links, providing users with an elegant "show more" button to see the entire list.',"search-appearance-toolkit-seo-44"),checked:f,onChange:()=>p({isCollapsible:!f}),__nextHasNoMarginBottom:!0}),(0,t.createElement)(l.SelectControl,{label:(0,a.__)("List Style","search-appearance-toolkit-seo-44"),value:b,options:[{label:(0,a.__)("Bulleted","search-appearance-toolkit-seo-44"),value:"ul"},{label:(0,a.__)("Numbered","search-appearance-toolkit-seo-44"),value:"ol"},{label:(0,a.__)("None","search-appearance-toolkit-seo-44"),value:"none"}],onChange:e=>p({listStyle:e}),disabled:"horizontal"===_,__nextHasNoMarginBottom:!0,__next40pxDefaultSize:!0}),(0,t.createElement)(l.FontSizePicker,{fontSizes:[{name:(0,a.__)("S","search-appearance-toolkit-seo-44"),slug:"small",size:"14px"},{name:(0,a.__)("M","search-appearance-toolkit-seo-44"),slug:"normal",size:"17px"},{name:(0,a.__)("L","search-appearance-toolkit-seo-44"),slug:"large",size:"20px"},{name:(0,a.__)("XL","search-appearance-toolkit-seo-44"),slug:"extra-large",size:"23px"}],value:w,onChange:e=>p({fontSize:e}),withReset:!0,__next40pxDefaultSize:!0}),(0,t.createElement)(o.PanelColorSettings,{title:(0,a.__)("Colors","search-appearance-toolkit-seo-44"),colorSettings:[{value:y,onChange:e=>p({blockBackgroundColor:e}),label:(0,a.__)("Block Background","search-appearance-toolkit-seo-44")},{value:E,onChange:e=>p({linkColor:e}),label:(0,a.__)("Link Color","search-appearance-toolkit-seo-44")},{value:C,onChange:e=>p({textColor:e}),label:(0,a.__)("Other Text Color","search-appearance-toolkit-seo-44")}]}),"horizontal"===_&&(0,t.createElement)(r.Fragment,null,(0,t.createElement)("hr",null),(0,t.createElement)("p",null,(0,t.createElement)("strong",null,(0,a.__)("Horizontal Link Styles","search-appearance-toolkit-seo-44"))),(0,t.createElement)(o.PanelColorSettings,{title:(0,a.__)("Link Colors","search-appearance-toolkit-seo-44"),colorSettings:[{value:B,onChange:e=>p({linkBackgroundColor:e}),label:(0,a.__)("Background","search-appearance-toolkit-seo-44")},{value:S,onChange:e=>p({linkBackgroundColorHover:e}),label:(0,a.__)("Background Hover","search-appearance-toolkit-seo-44")},{value:z,onChange:e=>p({linkBorderColor:e}),label:(0,a.__)("Border","search-appearance-toolkit-seo-44")}]}),(0,t.createElement)(l.RangeControl,{label:(0,a.__)("Link Border Radius","search-appearance-toolkit-seo-44"),value:T,onChange:e=>p({linkBorderRadius:e}),min:0,max:50,__nextHasNoMarginBottom:!0,__next40pxDefaultSize:!0}))),(0,t.createElement)(l.PanelBody,{title:(0,a.__)("Content Settings","search-appearance-toolkit-seo-44")},(0,t.createElement)(l.ToggleControl,{label:(0,a.__)("Display Block Title","search-appearance-toolkit-seo-44"),checked:d,onChange:()=>p({showHeading:!d}),__nextHasNoMarginBottom:!0}),d&&(0,t.createElement)(r.Fragment,null,(0,t.createElement)(l.TextControl,{label:(0,a.__)("Title Text","search-appearance-toolkit-seo-44"),value:m,onChange:e=>p({headingText:e}),help:(0,a.__)("The text that appears above your list of links.","search-appearance-toolkit-seo-44")}),(0,t.createElement)(l.SelectControl,{label:(0,a.__)("Title Tag","search-appearance-toolkit-seo-44"),value:g,options:[{label:"H2",value:"h2"},{label:"H3",value:"h3"},{label:"H4",value:"h4"},{label:"H5",value:"h5"},{label:"Paragraph (Bold)",value:"p"},{label:"Div (No Semantic Value)",value:"div"}],onChange:e=>p({headingTag:e}),help:(0,a.__)("Choose a level that fits your page's structure.","search-appearance-toolkit-seo-44"),__nextHasNoMarginBottom:!0,__next40pxDefaultSize:!0})),(0,t.createElement)("hr",null),(0,t.createElement)("p",null,(0,t.createElement)("strong",null,(0,a.__)("Included Headings","search-appearance-toolkit-seo-44"))),(0,t.createElement)("p",{className:"description",style:{marginBottom:"10px"}},(0,a.__)("Select which heading levels from your post content should appear in the jump links list.","search-appearance-toolkit-seo-44")),(0,t.createElement)(l.CheckboxControl,{label:"H2",checked:k.includes("h2"),onChange:()=>J("h2")}),(0,t.createElement)(l.CheckboxControl,{label:"H3",checked:k.includes("h3"),onChange:()=>J("h3")}),(0,t.createElement)(l.CheckboxControl,{label:"H4",checked:k.includes("h4"),onChange:()=>J("h4")}),(0,t.createElement)(l.ToggleControl,{label:(0,a.__)("Create Visual Hierarchy","search-appearance-toolkit-seo-44"),help:(0,a.__)("Indents sub-headings (H3, H4) to create a nested outline structure.","search-appearance-toolkit-seo-44"),checked:x,onChange:()=>p({isSmartIndentation:!x}),__nextHasNoMarginBottom:!0})),(0,t.createElement)(l.PanelBody,{title:(0,a.__)("Position Settings","search-appearance-toolkit-seo-44")},(0,t.createElement)(l.ToggleControl,{label:(0,a.__)("Sticky Position","search-appearance-toolkit-seo-44"),help:(0,a.__)("Keep the table of contents visible while scrolling.","search-appearance-toolkit-seo-44"),checked:N,onChange:()=>p({isSticky:!N}),__nextHasNoMarginBottom:!0}),N&&(0,t.createElement)(r.Fragment,null,(0,t.createElement)("p",{className:"description",style:{marginBottom:"15px"}},(0,a.__)("Customize how the block behaves when it sticks to the top of the screen.","search-appearance-toolkit-seo-44")),(0,t.createElement)(l.RangeControl,{label:(0,a.__)("Top Offset (px)","search-appearance-toolkit-seo-44"),help:(0,a.__)("The distance between the top of the screen and the block when stuck (useful for clearing sticky headers).","search-appearance-toolkit-seo-44"),value:H,onChange:e=>p({stickyOffset:e}),min:0,max:200,__nextHasNoMarginBottom:!0,__next40pxDefaultSize:!0}),(0,t.createElement)(l.RangeControl,{label:(0,a.__)("Jump Offset (px)","search-appearance-toolkit-seo-44"),help:(0,a.__)("The buffer distance to stop before the heading. Increase this if your sticky header covers the text.","search-appearance-toolkit-seo-44"),value:M,onChange:e=>p({jumpOffset:e}),min:0,max:200,__nextHasNoMarginBottom:!0,__next40pxDefaultSize:!0}),(0,t.createElement)(l.ToggleControl,{label:(0,a.__)("Disable on Mobile","search-appearance-toolkit-seo-44"),help:(0,a.__)("Prevents the block from sticking on small screens to save reading space.","search-appearance-toolkit-seo-44"),checked:"desktop-only"===P,onChange:e=>p({stickyStrategy:e?"desktop-only":"always"}),__nextHasNoMarginBottom:!0})))),(0,t.createElement)("div",{...$},d&&(0,t.createElement)(o.RichText,{tagName:g,className:"wp-block-seo44-jump-links-heading",value:m,onChange:e=>p({headingText:e}),placeholder:(0,a.__)("On This Page","search-appearance-toolkit-seo-44")}),u.length>0?(0,t.createElement)("nav",{"aria-label":(0,a.__)("Table of contents","search-appearance-toolkit-seo-44")},(0,t.createElement)(I,{id:j},u.map((e,o)=>v?(0,t.createElement)("li",{key:e.anchor},(0,t.createElement)(l.TextControl,{value:e.linkText,onChange:e=>((e,t)=>{const a=[...u];a[e].linkText=t,p({headings:a})})(o,e)}),(0,t.createElement)("div",{className:"edit-controls-wrapper"},(0,t.createElement)("div",{className:"reorder-buttons"},(0,t.createElement)(l.Button,{icon:i,label:(0,a.__)("Move Up","search-appearance-toolkit-seo-44"),onClick:()=>R(o,"up"),disabled:0===o}),(0,t.createElement)(l.Button,{icon:c,label:(0,a.__)("Move Down","search-appearance-toolkit-seo-44"),onClick:()=>R(o,"down"),disabled:o===u.length-1})),(0,t.createElement)(l.ToggleControl,{label:!1!==e.isVisible?(0,a.__)("Included","search-appearance-toolkit-seo-44"):(0,a.__)("This Jump Link will not be shown","search-appearance-toolkit-seo-44"),checked:!1!==e.isVisible,onChange:()=>(e=>{const t=[...u];t[e].isVisible=!t[e].isVisible,p({headings:t})})(o),__nextHasNoMarginBottom:!0}))):!1!==e.isVisible&&(0,t.createElement)("li",{key:e.anchor,className:x?`seo44-jump-link-level-${e.level}`:""},(0,t.createElement)("a",{href:`#${e.anchor}`,onClick:e=>e.preventDefault()},e.linkText)))),!v&&f&&u.length>0&&(0,t.createElement)(l.Tooltip,{text:(0,a.__)("This button is functional on the front-end to expand the list.","search-appearance-toolkit-seo-44")},(0,t.createElement)("button",{type:"button",className:"seo-44-show-more","aria-label":(0,a.__)("Show More","search-appearance-toolkit-seo-44"),"aria-expanded":"false","aria-controls":j,onClick:()=>{L((0,a.__)('The "Show More" button is interactive on the published page.',"search-appearance-toolkit-seo-44"),{type:"snackbar"})}},h))):(0,t.createElement)("p",null,(0,a.__)("No headings found. Select a heading level in the block settings to generate links.","search-appearance-toolkit-seo-44"))))},save:function({attributes:e}){const{blockInstanceId:l,layout:n,isCollapsible:r,isSmartIndentation:s,headings:i,showHeading:c,headingText:h,headingTag:p,listStyle:k,fontSize:u,textColor:d,linkColor:m,blockBackgroundColor:g,linkBackgroundColor:_,linkBackgroundColorHover:b,linkBorderColor:v,linkBorderRadius:f,isSticky:x,stickyOffset:w,jumpOffset:C,stickyStrategy:E}=e,y={color:d,fontSize:u,"--jump-link-font-size":u\|\|"18px","--seo44-block-bg":g,"--seo44-link-color":m,"--seo44-link-bg":"horizontal"===n?_:void 0,"--seo44-link-hover-bg":"horizontal"===n?b:void 0,"--seo44-link-border-color":"horizontal"===n?v:void 0,"--seo44-link-radius":"horizontal"===n&&f?`${f}px`:void 0,"--seo44-sticky-offset":x?`${w}px`:void 0},B="ol"===k?"ol":"ul",S=`seo44-jump-links-list-${l}`,z=o.useBlockProps.save({className:`${"horizontal"===n?"is-layout-horizontal":""} ${r?"is-collapsible":""} ${"none"===k?"list-style-none":""} ${x?"is-sticky":""} ${"desktop-only"===E?"sticky-desktop-only":""}`.trim(),style:y,"data-seo44-jump-offset":x?C:30}),T=(0,t.createElement)("svg",{className:"arrow-down",width:"24",height:"24",viewBox:"0 0 24 24",xmlns:"http://www.w3.org/2000/svg","aria-hidden":"true",focusable:"false"},(0,t.createElement)("path",{d:"M12 16l-6-6 1.41-1.41L12 13.17l4.59-4.58L18 10l-6 6z"})),N=(0,t.createElement)("svg",{className:"arrow-up",width:"24",height:"24",viewBox:"0 0 24 24",xmlns:"http://www.w3.org/2000/svg","aria-hidden":"true",focusable:"false"},(0,t.createElement)("path",{d:"M12 8l-6 6 1.41 1.41L12 10.83l4.59 4.58L18 14l-6-6z"}));return(0,t.createElement)("div",{...z},(0,t.createElement)("div",{className:"seo44-sticky-sentinel","aria-hidden":"true"}),c&&(0,t.createElement)(o.RichText.Content,{tagName:p\|\|"h2",className:"wp-block-seo44-jump-links-heading",value:h}),i&&i.length>0&&(0,t.createElement)("nav",{"aria-label":(0,a.__)("Table of contents","search-appearance-toolkit-seo-44")},(0,t.createElement)(B,{id:S},i.filter(e=>!1!==e.isVisible).map(e=>(0,t.createElement)("li",{key:e.anchor,className:s?`seo44-jump-link-level-${e.level}`:""},(0,t.createElement)("a",{href:`#${e.anchor}`},e.linkText)))),r&&(0,t.createElement)("button",{type:"button",className:"seo-44-show-more","aria-label":(0,a.__)("Show More","search-appearance-toolkit-seo-44"),"aria-expanded":"false","aria-controls":S},T,N)))}})}},a={};function o(e){var l=a[e];if(void 0!==l)return l.exports;var n=a[e]={exports:{}};return t[e](n,n.exports,o),n.exports}o.m=t,e=[],o.O=(t,a,l,n)=>{if(!a){var r=1/0;for(h=0;h<e.length;h++){for(var[a,l,n]=e[h],s=!0,i=0;i<a.length;i++)(!1&n\|\|r>=n)&&Object.keys(o.O).every(e=>o.O[e](a[i]))?a.splice(i--,1):(s=!1,n<r&&(r=n));if(s){e.splice(h--,1);var c=l();void 0!==c&&(t=c)}}return t}n=n\|\|0;for(var h=e.length;h>0&&e[h-1][2]>n;h--)e[h]=e[h-1];e[h]=[a,l,n]},o.o=(e,t)=>Object.prototype.hasOwnProperty.call(e,t),(()=>{var e={57:0,350:0};o.O.j=t=>0===e[t];var t=(t,a)=>{var l,n,[r,s,i]=a,c=0;if(r.some(t=>0!==e[t])){for(l in s)o.o(s,l)&&(o.m[l]=s[l]);if(i)var h=i(o)}for(t&&t(a);c<r.length;c++)n=r[c],o.o(e,n)&&e[n]&&e[n][0](),e[n]=0;return o.O(h)},a=globalThis.webpackChunkseo_44_jump_links_block=globalThis.webpackChunkseo_44_jump_links_block\|\|[];a.forEach(t.bind(null,0)),a.push=t.bind(null,a.push.bind(a))})();var l=o.O(void 0,[350],()=>o(313));l=o.O(l)})();
	1	(()=>{"use strict";var e,t={313(){const e=window.wp.blocks,t=window.React,a=window.wp.i18n,o=window.wp.blockEditor,l=window.wp.components,n=window.wp.data,r=window.wp.element;function s(e){return(new DOMParser).parseFromString(e,"text/html").body.textContent\|\|""}const i=(0,t.createElement)("svg",{viewBox:"0 0 24 24",xmlns:"http://www.w3.org/2000/svg","aria-hidden":"true",focusable:"false"},(0,t.createElement)("path",{d:"M3 21v-2h18v2zm8-4v-6.175L9.4 12.4L8 11l4-4l4 4l-1.4 1.4l-1.6-1.575V17zM3 5V3h18v2z"})),c=(0,t.createElement)("svg",{viewBox:"0 0 24 24",xmlns:"http://www.w3.org/2000/svg","aria-hidden":"true",focusable:"false"},(0,t.createElement)("path",{d:"M3 5V3h18v2zm9 12l-4-4l1.4-1.4l1.6 1.575V7h2v6.175l1.6-1.575L16 13zm-9 4v-2h18v2z"})),h=(0,t.createElement)("svg",{className:"arrow-down",width:"24",height:"24",viewBox:"0 0 24 24",xmlns:"http://www.w3.org/2000/svg","aria-hidden":"true",focusable:"false"},(0,t.createElement)("path",{d:"M12 16l-6-6 1.41-1.41L12 13.17l4.59-4.58L18 10l-6 6z"})),p=JSON.parse('{"UU":"seo44/jump-links"}');(0,e.registerBlockType)(p.UU,{edit:function({attributes:e,setAttributes:p}){const{headingLevels:k,headings:u,showHeading:d,headingText:m,headingTag:g,layout:_,listStyle:b,isEditing:v,isCollapsible:f,isSmartIndentation:x,fontSize:w,textColor:C,linkColor:E,blockBackgroundColor:y,linkBackgroundColor:B,linkBackgroundColorHover:S,linkBorderColor:z,linkBorderRadius:T,isSticky:N,stickyOffset:H,jumpOffset:M,stickyStrategy:P}=e,O={color:C,fontSize:w,"--jump-link-font-size":w\|\|"18px","--seo44-link-color":E,"--seo44-link-bg":"horizontal"===_?B:void 0,"--seo44-link-hover-bg":"horizontal"===_?S:void 0,"--seo44-link-border-color":"horizontal"===_?z:void 0,"--seo44-link-radius":"horizontal"===_&&T?`${T}px`:void 0,"--seo44-block-bg":y,"--seo44-sticky-offset":N?`${H}px`:void 0},I="ol"===b?"ol":"ul",{createInfoNotice:L}=(0,n.useDispatch)("core/notices"),j=e.blockInstanceId?`seo44-jump-links-list-${e.blockInstanceId}`:"seo44-jump-links-list",$=(0,o.useBlockProps)({style:O});$.className=`${$.className} ${"horizontal"===_?"is-layout-horizontal":""} ${f&&!v?"is-collapsible":""} ${"none"===b?"list-style-none":""}`.trim();const D=(0,n.useSelect)(e=>e("core/block-editor").getBlocks(),[]),{updateBlockAttributes:V}=(0,n.useDispatch)("core/block-editor");(0,r.useEffect)(()=>{const t={};e.blockInstanceId\|\|(t.blockInstanceId=Math.random().toString(36).substr(2,9)),Object.keys(t).length>0&&p(t);const o=D.filter(e=>"core/heading"===e.name&&k.includes(`h${e.attributes.level}`)),l=new Set;let n=!1;const r=new Map(u.map(e=>[e.anchor,e])),i=[];for(const e of o){const t=s(e.attributes.content);let a=e.attributes.anchor\|\|t.toLowerCase().replace(/[^a-z0-9\s-]/g,"").trim().replace(/\s+/g,"-"),o=a,c=2;for(;l.has(o);)o=`${a}-${c}`,c++,n=!0;l.add(o),e.attributes.anchor!==o&&V(e.clientId,{anchor:o});const h=r.get(e.attributes.anchor)\|\|r.get(o),p=h&&h.linkText!==h.text?h.linkText:t,k=!h\|\|h.isVisible;i.push({anchor:o,text:t,linkText:p,isVisible:k,level:e.attributes.level})}JSON.stringify(i)!==JSON.stringify(u)&&p({headings:i}),n&&L((0,a.__)("Jump Links Block: Duplicate headings were found. Unique IDs have been auto-generated, but this may be a sign of redundancy. Please review your headings for clarity.","search-appearance-toolkit-seo-44"),{type:"snackbar"})},[D,k,u,e.blockInstanceId,p,V,L]),(0,r.useEffect)(()=>{"horizontal"===_&&"none"!==b&&p({listStyle:"none"})},[_,b,p]);const R=(e,t)=>{const a=[...u],o=a.splice(e,1)[0];"up"===t?a.splice(e-1,0,o):a.splice(e+1,0,o),p({headings:a})},J=e=>{const t=k.includes(e)?k.filter(t=>t!==e):[...k,e];p({headingLevels:t.sort()})};return(0,t.createElement)(r.Fragment,null,(0,t.createElement)(o.InspectorControls,null,(0,t.createElement)(l.PanelBody,{title:(0,a.__)("Presentation","search-appearance-toolkit-seo-44")},(0,t.createElement)(l.ButtonGroup,null,(0,t.createElement)(l.Button,{isPrimary:!v,isPressed:!v,onClick:()=>p({isEditing:!1})},(0,a.__)("Viewing Mode","search-appearance-toolkit-seo-44")),(0,t.createElement)(l.Button,{isPrimary:v,isPressed:v,onClick:()=>p({isEditing:!0})},(0,a.__)("Editing Mode","search-appearance-toolkit-seo-44"))),(0,t.createElement)("p",{className:"description"},(0,a.__)("Switch to Editing Mode to customize link text, visibility, and order.","search-appearance-toolkit-seo-44"))),(0,t.createElement)(l.PanelBody,{title:(0,a.__)("Appearance","search-appearance-toolkit-seo-44")},(0,t.createElement)("p",null,(0,t.createElement)("strong",null,(0,a.__)("Layout","search-appearance-toolkit-seo-44"))),(0,t.createElement)(l.ButtonGroup,null,(0,t.createElement)(l.Button,{isPrimary:"vertical"===_,isPressed:"vertical"===_,onClick:()=>p({layout:"vertical"})},(0,a.__)("Vertical","search-appearance-toolkit-seo-44")),(0,t.createElement)(l.Button,{isPrimary:"horizontal"===_,isPressed:"horizontal"===_,onClick:()=>p({layout:"horizontal"})},(0,a.__)("Horizontal","search-appearance-toolkit-seo-44"))),(0,t.createElement)(l.ToggleControl,{label:(0,a.__)("Make Jump Links Area Expandable","search-appearance-toolkit-seo-44"),help:(0,a.__)('Conserve screen space by collapsing a long list of jump links, providing users with an elegant "show more" button to see the entire list.',"search-appearance-toolkit-seo-44"),checked:f,onChange:()=>p({isCollapsible:!f}),__nextHasNoMarginBottom:!0}),(0,t.createElement)(l.SelectControl,{label:(0,a.__)("List Style","search-appearance-toolkit-seo-44"),value:b,options:[{label:(0,a.__)("Bulleted","search-appearance-toolkit-seo-44"),value:"ul"},{label:(0,a.__)("Numbered","search-appearance-toolkit-seo-44"),value:"ol"},{label:(0,a.__)("None","search-appearance-toolkit-seo-44"),value:"none"}],onChange:e=>p({listStyle:e}),disabled:"horizontal"===_,__nextHasNoMarginBottom:!0,__next40pxDefaultSize:!0}),(0,t.createElement)(l.FontSizePicker,{fontSizes:[{name:(0,a.__)("S","search-appearance-toolkit-seo-44"),slug:"small",size:"14px"},{name:(0,a.__)("M","search-appearance-toolkit-seo-44"),slug:"normal",size:"17px"},{name:(0,a.__)("L","search-appearance-toolkit-seo-44"),slug:"large",size:"20px"},{name:(0,a.__)("XL","search-appearance-toolkit-seo-44"),slug:"extra-large",size:"23px"}],value:w,onChange:e=>p({fontSize:e}),withReset:!0,__next40pxDefaultSize:!0}),(0,t.createElement)(o.PanelColorSettings,{title:(0,a.__)("Colors","search-appearance-toolkit-seo-44"),colorSettings:[{value:y,onChange:e=>p({blockBackgroundColor:e}),label:(0,a.__)("Block Background","search-appearance-toolkit-seo-44")},{value:E,onChange:e=>p({linkColor:e}),label:(0,a.__)("Link Color","search-appearance-toolkit-seo-44")},{value:C,onChange:e=>p({textColor:e}),label:(0,a.__)("Other Text Color","search-appearance-toolkit-seo-44")}]}),"horizontal"===_&&(0,t.createElement)(r.Fragment,null,(0,t.createElement)("hr",null),(0,t.createElement)("p",null,(0,t.createElement)("strong",null,(0,a.__)("Horizontal Link Styles","search-appearance-toolkit-seo-44"))),(0,t.createElement)(o.PanelColorSettings,{title:(0,a.__)("Link Colors","search-appearance-toolkit-seo-44"),colorSettings:[{value:B,onChange:e=>p({linkBackgroundColor:e}),label:(0,a.__)("Background","search-appearance-toolkit-seo-44")},{value:S,onChange:e=>p({linkBackgroundColorHover:e}),label:(0,a.__)("Background Hover","search-appearance-toolkit-seo-44")},{value:z,onChange:e=>p({linkBorderColor:e}),label:(0,a.__)("Border","search-appearance-toolkit-seo-44")}]}),(0,t.createElement)(l.RangeControl,{label:(0,a.__)("Link Border Radius","search-appearance-toolkit-seo-44"),value:T,onChange:e=>p({linkBorderRadius:e}),min:0,max:50,__nextHasNoMarginBottom:!0,__next40pxDefaultSize:!0}))),(0,t.createElement)(l.PanelBody,{title:(0,a.__)("Content Settings","search-appearance-toolkit-seo-44")},(0,t.createElement)(l.ToggleControl,{label:(0,a.__)("Display Block Title","search-appearance-toolkit-seo-44"),checked:d,onChange:()=>p({showHeading:!d}),__nextHasNoMarginBottom:!0}),d&&(0,t.createElement)(r.Fragment,null,(0,t.createElement)(l.TextControl,{label:(0,a.__)("Title Text","search-appearance-toolkit-seo-44"),value:m,onChange:e=>p({headingText:e}),help:(0,a.__)("The text that appears above your list of links.","search-appearance-toolkit-seo-44")}),(0,t.createElement)(l.SelectControl,{label:(0,a.__)("Title Tag","search-appearance-toolkit-seo-44"),value:g,options:[{label:"H2",value:"h2"},{label:"H3",value:"h3"},{label:"H4",value:"h4"},{label:"H5",value:"h5"},{label:"Paragraph (Bold)",value:"p"},{label:"Div (No Semantic Value)",value:"div"}],onChange:e=>p({headingTag:e}),help:(0,a.__)("Choose a level that fits your page's structure.","search-appearance-toolkit-seo-44"),__nextHasNoMarginBottom:!0,__next40pxDefaultSize:!0})),(0,t.createElement)("hr",null),(0,t.createElement)("p",null,(0,t.createElement)("strong",null,(0,a.__)("Included Headings","search-appearance-toolkit-seo-44"))),(0,t.createElement)("p",{className:"description",style:{marginBottom:"10px"}},(0,a.__)("Select which heading levels from your post content should appear in the jump links list.","search-appearance-toolkit-seo-44")),(0,t.createElement)(l.CheckboxControl,{label:"H2",checked:k.includes("h2"),onChange:()=>J("h2")}),(0,t.createElement)(l.CheckboxControl,{label:"H3",checked:k.includes("h3"),onChange:()=>J("h3")}),(0,t.createElement)(l.CheckboxControl,{label:"H4",checked:k.includes("h4"),onChange:()=>J("h4")}),(0,t.createElement)(l.ToggleControl,{label:(0,a.__)("Create Visual Hierarchy","search-appearance-toolkit-seo-44"),help:(0,a.__)("Indents sub-headings (H3, H4) to create a nested outline structure.","search-appearance-toolkit-seo-44"),checked:x,onChange:()=>p({isSmartIndentation:!x}),__nextHasNoMarginBottom:!0})),(0,t.createElement)(l.PanelBody,{title:(0,a.__)("Position Settings","search-appearance-toolkit-seo-44")},(0,t.createElement)(l.ToggleControl,{label:(0,a.__)("Sticky Position","search-appearance-toolkit-seo-44"),help:(0,a.__)("Keep the table of contents visible while scrolling.","search-appearance-toolkit-seo-44"),checked:N,onChange:()=>p({isSticky:!N}),__nextHasNoMarginBottom:!0}),N&&(0,t.createElement)(r.Fragment,null,(0,t.createElement)("p",{className:"description",style:{marginBottom:"15px"}},(0,a.__)("Customize how the block behaves when it sticks to the top of the screen.","search-appearance-toolkit-seo-44")),(0,t.createElement)(l.RangeControl,{label:(0,a.__)("Top Offset (px)","search-appearance-toolkit-seo-44"),help:(0,a.__)("The distance between the top of the screen and the block when stuck (useful for clearing sticky headers).","search-appearance-toolkit-seo-44"),value:H,onChange:e=>p({stickyOffset:e}),min:0,max:200,__nextHasNoMarginBottom:!0,__next40pxDefaultSize:!0}),(0,t.createElement)(l.RangeControl,{label:(0,a.__)("Jump Offset (px)","search-appearance-toolkit-seo-44"),help:(0,a.__)("The buffer distance to stop before the heading. Increase this if your sticky header covers the text.","search-appearance-toolkit-seo-44"),value:M,onChange:e=>p({jumpOffset:e}),min:0,max:200,__nextHasNoMarginBottom:!0,__next40pxDefaultSize:!0}),(0,t.createElement)(l.ToggleControl,{label:(0,a.__)("Disable on Mobile","search-appearance-toolkit-seo-44"),help:(0,a.__)("Prevents the block from sticking on small screens to save reading space.","search-appearance-toolkit-seo-44"),checked:"desktop-only"===P,onChange:e=>p({stickyStrategy:e?"desktop-only":"always"}),__nextHasNoMarginBottom:!0})))),(0,t.createElement)("div",{...$},d&&(0,t.createElement)(o.RichText,{tagName:g,className:"wp-block-seo44-jump-links-heading",value:m,onChange:e=>p({headingText:e}),placeholder:(0,a.__)("On This Page","search-appearance-toolkit-seo-44")}),u.length>0?(0,t.createElement)("nav",{"aria-label":(0,a.__)("Table of contents","search-appearance-toolkit-seo-44")},(0,t.createElement)(I,{id:j},u.map((e,o)=>v?(0,t.createElement)("li",{key:e.anchor},(0,t.createElement)(l.TextControl,{value:e.linkText,onChange:e=>((e,t)=>{const a=[...u];a[e].linkText=t,p({headings:a})})(o,e)}),(0,t.createElement)("div",{className:"edit-controls-wrapper"},(0,t.createElement)("div",{className:"reorder-buttons"},(0,t.createElement)(l.Button,{icon:i,label:(0,a.__)("Move Up","search-appearance-toolkit-seo-44"),onClick:()=>R(o,"up"),disabled:0===o}),(0,t.createElement)(l.Button,{icon:c,label:(0,a.__)("Move Down","search-appearance-toolkit-seo-44"),onClick:()=>R(o,"down"),disabled:o===u.length-1})),(0,t.createElement)(l.ToggleControl,{label:!1!==e.isVisible?(0,a.__)("Included","search-appearance-toolkit-seo-44"):(0,a.__)("This Jump Link will not be shown","search-appearance-toolkit-seo-44"),checked:!1!==e.isVisible,onChange:()=>(e=>{const t=[...u];t[e].isVisible=!t[e].isVisible,p({headings:t})})(o),__nextHasNoMarginBottom:!0}))):!1!==e.isVisible&&(0,t.createElement)("li",{key:e.anchor,className:x?`seo44-jump-link-level-${e.level}`:""},(0,t.createElement)("a",{href:`#${e.anchor}`,onClick:e=>e.preventDefault()},e.linkText)))),!v&&f&&u.length>0&&(0,t.createElement)(l.Tooltip,{text:(0,a.__)("This button is functional on the front-end to expand the list.","search-appearance-toolkit-seo-44")},(0,t.createElement)("button",{type:"button",className:"seo-44-show-more","aria-label":(0,a.__)("Show More","search-appearance-toolkit-seo-44"),"aria-expanded":"false","aria-controls":j,onClick:()=>{L((0,a.__)('The "Show More" button is interactive on the published page.',"search-appearance-toolkit-seo-44"),{type:"snackbar"})}},h))):(0,t.createElement)("p",null,(0,a.__)("No headings found. Select a heading level in the block settings to generate links.","search-appearance-toolkit-seo-44"))))},save:function({attributes:e}){const{blockInstanceId:l,layout:n,isCollapsible:r,isSmartIndentation:s,headings:i,showHeading:c,headingText:h,headingTag:p,listStyle:k,fontSize:u,textColor:d,linkColor:m,blockBackgroundColor:g,linkBackgroundColor:_,linkBackgroundColorHover:b,linkBorderColor:v,linkBorderRadius:f,isSticky:x,stickyOffset:w,jumpOffset:C,stickyStrategy:E}=e,y={color:d,fontSize:u,"--jump-link-font-size":u\|\|"18px","--seo44-block-bg":g,"--seo44-link-color":m,"--seo44-link-bg":"horizontal"===n?_:void 0,"--seo44-link-hover-bg":"horizontal"===n?b:void 0,"--seo44-link-border-color":"horizontal"===n?v:void 0,"--seo44-link-radius":"horizontal"===n&&f?`${f}px`:void 0,"--seo44-sticky-offset":x?`${w}px`:void 0},B="ol"===k?"ol":"ul",S=`seo44-jump-links-list-${l}`,z=o.useBlockProps.save({className:`${"horizontal"===n?"is-layout-horizontal":""} ${r?"is-collapsible":""} ${"none"===k?"list-style-none":""} ${x?"is-sticky":""} ${"desktop-only"===E?"sticky-desktop-only":""}`.trim(),style:y,"data-seo44-jump-offset":x?C:30}),T=(0,t.createElement)("svg",{className:"arrow-down",width:"24",height:"24",viewBox:"0 0 24 24",xmlns:"http://www.w3.org/2000/svg","aria-hidden":"true",focusable:"false"},(0,t.createElement)("path",{d:"M12 16l-6-6 1.41-1.41L12 13.17l4.59-4.58L18 10l-6 6z"})),N=(0,t.createElement)("svg",{className:"arrow-up",width:"24",height:"24",viewBox:"0 0 24 24",xmlns:"http://www.w3.org/2000/svg","aria-hidden":"true",focusable:"false"},(0,t.createElement)("path",{d:"M12 8l-6 6 1.41 1.41L12 10.83l4.59 4.58L18 14l-6-6z"}));return(0,t.createElement)("div",{...z},(0,t.createElement)("div",{className:"seo44-sticky-sentinel","aria-hidden":"true"}),c&&(0,t.createElement)(o.RichText.Content,{tagName:p\|\|"h2",className:"wp-block-seo44-jump-links-heading",value:h}),i&&i.length>0&&(0,t.createElement)("nav",{"aria-label":(0,a.__)("Table of contents","search-appearance-toolkit-seo-44")},(0,t.createElement)(B,{id:S},i.filter(e=>!1!==e.isVisible).map(e=>(0,t.createElement)("li",{key:e.anchor,className:s?`seo44-jump-link-level-${e.level}`:""},(0,t.createElement)("a",{href:`#${e.anchor}`},e.linkText)))),r&&(0,t.createElement)("button",{type:"button",className:"seo-44-show-more","aria-label":(0,a.__)("Show More","search-appearance-toolkit-seo-44"),"aria-expanded":"false","aria-controls":S},T,N)))}})}},a={};function o(e){var l=a[e];if(void 0!==l)return l.exports;var n=a[e]={exports:{}};return t[e](n,n.exports,o),n.exports}o.m=t,e=[],o.O=(t,a,l,n)=>{if(!a){var r=1/0;for(h=0;h<e.length;h++){for(var[a,l,n]=e[h],s=!0,i=0;i<a.length;i++)(!1&n\|\|r>=n)&&Object.keys(o.O).every(e=>o.O[e](a[i]))?a.splice(i--,1):(s=!1,n<r&&(r=n));if(s){e.splice(h--,1);var c=l();void 0!==c&&(t=c)}}return t}n=n\|\|0;for(var h=e.length;h>0&&e[h-1][2]>n;h--)e[h]=e[h-1];e[h]=[a,l,n]},o.o=(e,t)=>Object.prototype.hasOwnProperty.call(e,t),(()=>{var e={57:0,350:0};o.O.j=t=>0===e[t];var t=(t,a)=>{var l,n,[r,s,i]=a,c=0;if(r.some(t=>0!==e[t])){for(l in s)o.o(s,l)&&(o.m[l]=s[l]);if(i)var h=i(o)}for(t&&t(a);c<r.length;c++)n=r[c],o.o(e,n)&&e[n]&&e[n][0](),e[n]=0;return o.O(h)},a=globalThis.webpackChunkseo_44_jump_links_block=globalThis.webpackChunkseo_44_jump_links_block\|\|[];a.forEach(t.bind(null,0)),a.push=t.bind(null,a.push.bind(a))})();var l=o.O(void 0,[350],()=>o(313));l=o.O(l)})();

search-appearance-toolkit-seo-44/tags/4.3/changelog.txt

-                      r3405454
+                      r3423355
 == Changelog ==
+= 4.3.0 =
+* FEATURE: **Table of Contents Schema:** Automatically generates `hasPart` schema synchronized with the Jump Links Block to support "Jump-to" links in search results.
+* FEATURE: **Advanced HowTo Schema:** A new "Block-Aware" scanner uses the Jump Links Block to strictly define steps while intelligently mining the introduction for tools, time, yield, and video data.
+* TWEAK: Added a "Generate HowTo Schema" checkbox to the SEO 44 metabox, giving users explicit control over when the advanced scanner runs.
+* FEATURE: **YouTube Integration:** Added support for the YouTube Data API v3 to fetch accurate video upload dates for VideoObject schema.
+* TESTED: Tested to WordPress Version 6.9
 = 4.2.0 =

search-appearance-toolkit-seo-44/tags/4.3/includes/class-seo44-core.php

-                      r3403604
+                      r3423355
 <?php
+//4.3 - Added dependencies for block-editor-script.js to access Jump Links Block anchor ids for hasPart and HowTo schema.
 class SEO44_Core {
 …
     public function admin_enqueue_assets($hook) {
         if ('post.php' == $hook || 'post-new.php' == $hook) {
+            // CSS
             wp_enqueue_style('seo44-admin-styles', plugins_url('../css/admin-styles.css', __FILE__), [], SEO44_VERSION);
+            wp_enqueue_script('seo44-admin-script', plugins_url('../js/admin-script.js', __FILE__), ['jquery'], SEO44_VERSION, true);
+            // General Admin Script (Classic + Block)
+            wp_enqueue_script('seo44-admin-script', plugins_url('../js/admin-script.js', __FILE__),
+                ['jquery'],
+                SEO44_VERSION,
+                true);
+            // Localize the General Script (needed for Snippet Preview)
             wp_localize_script('seo44-admin-script', 'seo44_data', [
                 'post_title' => get_the_title(get_the_ID()),
 …
                 'permalink' => get_permalink(get_the_ID())
             ]);
+            // Block Editor Specific Script (Passthrough Logic For Jump Links)
+            // We enqueue this separately with the Block Editor dependencies.
+            // WordPress will simply NOT load this file if these handles don't exist (e.g. Classic Editor).
+            wp_enqueue_script('seo44-block-editor-script', plugins_url('../js/block-editor-script.js', __FILE__),
+                ['wp-data', 'wp-editor', 'wp-blocks'], // Dependencies are important for Jump Links Block data
+                SEO44_VERSION,
+                true
+            );
+        }
        if ('settings_page_search-appearance-toolkit-seo-44' == $hook) {

search-appearance-toolkit-seo-44/tags/4.3/includes/class-seo44-frontend.php

-                      r3405454
+                      r3423355
 <?php
+// Version 4.3
+// Create hasPart and HowTo schema from Jump Links Block using metafield passthrough
+// Added YouTube Data API support for more accurate video upload date
 class SEO44_Frontend {
     public function __construct() {
 …
         add_action('wp_head', [$this, 'output_header_tags']);
         add_action('wp_head', [$this, 'output_schema_json_ld'], 99);
+        add_action('init', [$this, 'register_schema_meta_fields']); // Retrieve Jump Links Block data for schema via a hidden metabox field
         $taxonomies = get_taxonomies(['public' => true]);
 …
+        }
+    }
+    // Get meta field from metabox for Jump Links Block + HowTo Schema
+    public function register_schema_meta_fields() {
+        register_post_meta('post', '_seo44_howto_step_ids', [
+            'single'       => true,
+            'type'         => 'array',
+            'show_in_rest' => [
+                'schema' => [
+                    'type'  => 'array',
+                    'items' => [
+                        'type' => 'string',
+                    ],
+                ],
+            ],
+            'auth_callback' => function() { return current_user_can('edit_posts'); }
+        ]);
+    }
+    //Title
     public function filter_document_title($title_parts) {
         if (!seo44_get_option('enable_tags')) return $title_parts;
+        if (!seo44_get_option('enable_tags')) return $title_parts;
         $custom_title = '';
         $fallback_title = '';
 …
             $custom_title = seo44_get_option('homepage_title');
         } elseif (is_singular()) {
             $custom_title = get_post_meta(get_the_ID(), seo44_get_option('title_key'), true);
+            $custom_title = get_post_meta(get_the_ID(), seo44_get_option('title_key'), true);
             $fallback_title = get_the_title(get_the_ID());
         } elseif (is_category() || is_tag() || is_tax()) {
+        } elseif (is_category() || is_tag() || is_tax()) {
             $term_id = get_queried_object_id();
             $custom_title = get_term_meta($term_id, 'seo44_title', true);
 …
             unset($title_parts['site'], $title_parts['tagline']);
+        }
+        return $title_parts;
+    }
+    public function add_term_meta_fields($term, $taxonomy) {
+        return $title_parts;
+    }
+    // Meta Tags
+    public function add_term_meta_fields($term, $taxonomy) {
         $title = get_term_meta($term->term_id, 'seo44_title', true);
         $description = get_term_meta($term->term_id, 'seo44_description', true);
 …
+    }
     public function output_header_tags() {
         if (!seo44_get_option('enable_tags')) { return; }
         $description = '';
         $social_title = '';
         $current_url = '';
         if (is_front_page()) {
             $description = seo44_get_option('homepage_description');
             $social_title = seo44_get_option('homepage_title') ?: get_bloginfo('name');
             $current_url = home_url('/');
         } elseif (is_singular()) {
             $post_id = get_the_ID();
             $description = get_post_meta($post_id, seo44_get_option('description_key'), true);
             $custom_title = get_post_meta($post_id, seo44_get_option('title_key'), true);
             $social_title = $custom_title ?: get_the_title($post_id);
             $current_url = get_permalink($post_id);
+    public function output_header_tags() {
+        if (!seo44_get_option('enable_tags')) { return; }
+        $description = '';
+        $social_title = '';
+        $current_url = '';
+        if (is_front_page()) {
+            $description = seo44_get_option('homepage_description');
+            $social_title = seo44_get_option('homepage_title') ?: get_bloginfo('name');
+            $current_url = home_url('/');
+        } elseif (is_singular()) {
+            $post_id = get_the_ID();
+            $description = get_post_meta($post_id, seo44_get_option('description_key'), true);
+            $custom_title = get_post_meta($post_id, seo44_get_option('title_key'), true);
+            $social_title = $custom_title ?: get_the_title($post_id);
+            $current_url = get_permalink($post_id);
             if (empty($description)) {
                 $post_content = get_the_content(null, false, get_the_ID());
+                $post_content = get_the_content(null, false, get_the_ID());
                 $description = wp_trim_words(strip_shortcodes(wp_strip_all_tags($post_content)), 25, '...');
+            }
         } elseif (is_category() || is_tag() || is_tax()) {
             $term = get_queried_object();
             $description = get_term_meta($term->term_id, 'seo44_description', true);
             $custom_title = get_term_meta($term->term_id, 'seo44_title', true);
             $social_title = $custom_title ?: single_term_title('', false) . ' - ' . get_bloginfo('name');
             $current_url = get_term_link($term);
+            }
+        } elseif (is_category() || is_tag() || is_tax()) {
+            $term = get_queried_object();
+            $description = get_term_meta($term->term_id, 'seo44_description', true);
+            $custom_title = get_term_meta($term->term_id, 'seo44_title', true);
+            $social_title = $custom_title ?: single_term_title('', false) . ' - ' . get_bloginfo('name');
+            $current_url = get_term_link($term);
             if (empty($description)) {
                 $term_description = trim(wp_strip_all_tags($term->description));
 …
+                }
+            }
+        }
+        if (!empty($description)) {
+            printf('<meta name="description" content="%s">' . "\n", esc_attr(wp_strip_all_tags(html_entity_decode($description, ENT_QUOTES, 'UTF-8'))));
+        }
+        if (is_singular()) {
+            $post_id = get_the_ID();
+            $keywords = get_post_meta($post_id, seo44_get_option('keywords_key'), true);
+            if (seo44_get_option('include_keywords') && !empty($keywords)) {
+                printf('<meta name="keywords" content="%s">' . "\n", esc_attr(wp_strip_all_tags(html_entity_decode($keywords, ENT_QUOTES, 'UTF-8'))));
+            }
+            if (is_singular() && seo44_get_option('include_author')) {
+                $author_id = get_post_field('post_author', $post_id);
+                if ($author_id) {
+                    printf('<meta name="author" content="%s">' . "\n", esc_attr($this->get_author_name($author_id)));
+                }
+            }
+        }
+        if (seo44_get_option('enable_og_tags') || seo44_get_option('enable_twitter_tags')) {
+            $clean_social_title = esc_attr(wp_strip_all_tags(html_entity_decode($social_title, ENT_QUOTES, 'UTF-8')));
+            $clean_description = !empty($description) ? esc_attr(wp_strip_all_tags(html_entity_decode($description, ENT_QUOTES, 'UTF-8'))) : '';
+            if (empty($clean_description) && is_singular()) {
+                 $clean_description = esc_attr(wp_strip_all_tags(get_the_excerpt(get_the_ID())));
+            }
+            $image_url = ''; $image_width = ''; $image_height = '';
+            $image_id = 0;
+            if (is_singular() && has_post_thumbnail()) {
+                $image_id = get_post_thumbnail_id();
+            }
+            if (!$image_id) {
+                $image_id = seo44_get_option('default_social_image_id', 0);
+            }
+            if ($image_id) {
+                $image_data = wp_get_attachment_image_src($image_id, 'full');
+                if ($image_data) {
+                    list($image_url, $image_width, $image_height) = $image_data;
+                }
+            }
+            if (seo44_get_option('enable_og_tags')) {
+                printf('<meta property="og:title" content="%s">' . "\n", esc_attr($clean_social_title));
+                printf('<meta property="og:url" content="%s">' . "\n", esc_url($current_url));
+                printf('<meta property="og:site_name" content="%s">' . "\n", esc_attr(get_bloginfo('name')));
+                if (!empty($clean_description)) { printf('<meta property="og:description" content="%s">' . "\n", esc_attr($clean_description)); }
+                if (is_singular('post')) {
+                     echo '<meta property="og:type" content="article">' . "\n";
+                } else {
+                     echo '<meta property="og:type" content="website">' . "\n";
+                }
+                if (!empty($image_url)) {
+                    printf('<meta property="og:image" content="%s">' . "\n", esc_url($image_url));
+                    if (!empty($image_width)) { printf('<meta property="og:image:width" content="%s">' . "\n", esc_attr($image_width)); }
+                    if (!empty($image_height)) { printf('<meta property="og:image:height" content="%s">' . "\n", esc_attr($image_height)); }
+                }
+                $fb_app_id = seo44_get_option('fb_app_id');
+                if (!empty($fb_app_id)) { printf('<meta property="fb:app_id" content="%s">' . "\n", esc_attr($fb_app_id)); }
+            }
+            if (seo44_get_option('enable_twitter_tags')) {
+                echo '<meta name="twitter:card" content="summary_large_image">' . "\n";
+                $twitter_handle = seo44_get_option('twitter_handle');
+                if ( !empty($twitter_handle) && is_string($twitter_handle) ) {
+                    $handle = esc_attr(str_replace('@', '', $twitter_handle));
+                    printf('<meta name="twitter:site" content="@%s">' . "\n", esc_attr($handle));
+                    printf('<meta name="twitter:creator" content="@%s">' . "\n", esc_attr($handle));
+                }
+                printf('<meta name="twitter:title" content="%s">' . "\n", esc_attr($clean_social_title));
+                if (!empty($clean_description)) { printf('<meta name="twitter:description" content="%s">' . "\n", esc_attr($clean_description)); }
+                if (!empty($image_url)) { printf('<meta name="twitter:image" content="%s">' . "\n", esc_url($image_url)); }
+            }
+        }
+    }
+        }
+        if (!empty($description)) {
+            printf('<meta name="description" content="%s">' . "\n", esc_attr(wp_strip_all_tags(html_entity_decode($description, ENT_QUOTES, 'UTF-8'))));
+        }
+        if (is_singular()) {
+            $post_id = get_the_ID();
+            $keywords = get_post_meta($post_id, seo44_get_option('keywords_key'), true);
+            if (seo44_get_option('include_keywords') && !empty($keywords)) {
+                printf('<meta name="keywords" content="%s">' . "\n", esc_attr(wp_strip_all_tags(html_entity_decode($keywords, ENT_QUOTES, 'UTF-8'))));
+            }
+            if (is_singular() && seo44_get_option('include_author')) {
+                $author_id = get_post_field('post_author', $post_id);
+                if ($author_id) {
+                    printf('<meta name="author" content="%s">' . "\n", esc_attr($this->get_author_name($author_id)));
+                }
+            }
+        }
+        if (seo44_get_option('enable_og_tags') || seo44_get_option('enable_twitter_tags')) {
+            $clean_social_title = esc_attr(wp_strip_all_tags(html_entity_decode($social_title, ENT_QUOTES, 'UTF-8')));
+            $clean_description = !empty($description) ? esc_attr(wp_strip_all_tags(html_entity_decode($description, ENT_QUOTES, 'UTF-8'))) : '';
+            if (empty($clean_description) && is_singular()) {
+                 $clean_description = esc_attr(wp_strip_all_tags(get_the_excerpt(get_the_ID())));
+            }
+            $image_url = ''; $image_width = ''; $image_height = '';
+            $image_id = 0;
+            if (is_singular() && has_post_thumbnail()) {
+                $image_id = get_post_thumbnail_id();
+            }
+            if (!$image_id) {
+                $image_id = seo44_get_option('default_social_image_id', 0);
+            }
+            if ($image_id) {
+                $image_data = wp_get_attachment_image_src($image_id, 'full');
+                if ($image_data) {
+                    list($image_url, $image_width, $image_height) = $image_data;
+                }
+            }
+            if (seo44_get_option('enable_og_tags')) {
+                printf('<meta property="og:title" content="%s">' . "\n", esc_attr($clean_social_title));
+                printf('<meta property="og:url" content="%s">' . "\n", esc_url($current_url));
+                printf('<meta property="og:site_name" content="%s">' . "\n", esc_attr(get_bloginfo('name')));
+                if (!empty($clean_description)) { printf('<meta property="og:description" content="%s">' . "\n", esc_attr($clean_description)); }
+                if (is_singular('post')) {
+                     echo '<meta property="og:type" content="article">' . "\n";
+                } else {
+                     echo '<meta property="og:type" content="website">' . "\n";
+                }
+                if (!empty($image_url)) {
+                    printf('<meta property="og:image" content="%s">' . "\n", esc_url($image_url));
+                    if (!empty($image_width)) { printf('<meta property="og:image:width" content="%s">' . "\n", esc_attr($image_width)); }
+                    if (!empty($image_height)) { printf('<meta property="og:image:height" content="%s">' . "\n", esc_attr($image_height)); }
+                }
+                $fb_app_id = seo44_get_option('fb_app_id');
+                if (!empty($fb_app_id)) { printf('<meta property="fb:app_id" content="%s">' . "\n", esc_attr($fb_app_id)); }
+            }
+            if (seo44_get_option('enable_twitter_tags')) {
+                echo '<meta name="twitter:card" content="summary_large_image">' . "\n";
+                $twitter_handle = seo44_get_option('twitter_handle');
+                if ( !empty($twitter_handle) && is_string($twitter_handle) ) {
+                    $handle = esc_attr(str_replace('@', '', $twitter_handle));
+                    printf('<meta name="twitter:site" content="@%s">' . "\n", esc_attr($handle));
+                    printf('<meta name="twitter:creator" content="@%s">' . "\n", esc_attr($handle));
+                }
+                printf('<meta name="twitter:title" content="%s">' . "\n", esc_attr($clean_social_title));
+                if (!empty($clean_description)) { printf('<meta name="twitter:description" content="%s">' . "\n", esc_attr($clean_description)); }
+                if (!empty($image_url)) { printf('<meta name="twitter:image" content="%s">' . "\n", esc_url($image_url)); }
+            }
+        }
+    }
+    // Now For The Schema Structured Data
     public function output_schema_json_ld() {
         // Note: The following line is intentionally not nonce-checked.
-        // This is a safe, read-only check used by the admin-side scanner to get a clean view of the page
-        // without our own schema being output. It does not process or save any data.
         $scan_param = isset($_GET['seo44_scan']) ? sanitize_key(wp_unslash($_GET['seo44_scan'])) : '';
         if ($scan_param === 'true') { return; }
 …
         $base_schema = [];
         $special_schemas = [];
         $breadcrumb_schema = []; // New variable for breadcrumbs
+        $breadcrumb_schema = []; // New variable for breadcrumbs
         $post_id = get_the_ID();
 …
             $base_schema = $this->get_schema_for_website();
             // NEW: Add Organization Schema to homepage
             if (seo44_get_option('enable_organization_schema')) {
                 $org_schema = $this->get_schema_for_organization();
                 if (!empty($org_schema)) {
                     $special_schemas[] = $org_schema;
+                }
+            }
+            // Add Organization Schema to homepage
+            if (seo44_get_option('enable_organization_schema')) {
+                $org_schema = $this->get_schema_for_organization();
+                if (!empty($org_schema)) {
+                    $special_schemas[] = $org_schema;
+                }
+            }
         } elseif ( (is_category() || is_tag() || is_tax()) && seo44_get_option('enable_schema_on_taxonomies') ) {
             $base_schema = $this->get_schema_for_taxonomy();
 …
+        }
+        // 3. Attempt to generate special schema
+        if (is_singular() && seo44_get_option('enable_advanced_schema')) {
+            $detected_schemas = $this->detect_and_generate_special_schema($post_id);
+            // Merge instead of overwrite - important for organization schema
+            if (!empty($detected_schemas)) {
+                $special_schemas = array_merge($special_schemas, $detected_schemas);
+            }
+        }
+        // 4.  Hook for Add-ons ---
+        // This filter allows other plugins to add their own custom schema parts to the graph.
+        $addon_schema_parts = apply_filters( 'seo44_add_schema_parts', [], $post_id );
+        // --- End Hook ---
+        // 5. Combine all schemas for output
+        $final_schema_parts = [];
+        // 3. Attempt to generate special schema (FAQ / HowTo)
+        if (is_singular() && seo44_get_option('enable_advanced_schema')) {
+            $detected_schemas = $this->detect_and_generate_special_schema($post_id);
+            // Merge instead of overwrite (Prevents erasing Organization schema on static pages)
+            if (!empty($detected_schemas)) {
+                $special_schemas = array_merge($special_schemas, $detected_schemas);
+            }
+        }
+        // 4.  Hook for Add-ons ---
+        // This filter allows other plugins to add their own custom schema parts to the graph.
+        $addon_schema_parts = apply_filters( 'seo44_add_schema_parts', [], $post_id );
+        // --- End Hook ---
+        // 5. Combine all schemas for output
+        $final_schema_parts = [];
         if (!empty($base_schema)) {
             $final_schema_parts[] = $base_schema;
 …
             $final_schema_parts = array_merge($final_schema_parts, $special_schemas);
+        }
         // include any add-on schemas that pass is_array sanity check
         if ( ! empty( $addon_schema_parts ) && is_array( $addon_schema_parts ) ) {
             $final_schema_parts = array_merge( $final_schema_parts, $addon_schema_parts );
+        }
+        // include any add-on schemas that pass is_array sanity check
+        if ( ! empty( $addon_schema_parts ) && is_array( $addon_schema_parts ) ) {
+            $final_schema_parts = array_merge( $final_schema_parts, $addon_schema_parts );
+        }
         $final_schema = [];
 …
+        }
+    }
     // --- Helper Functions ---
+    // --- Helper Functions ---
     // --- Generate BreadcrumbList Schema for Singular Content ---
 …
         ];
+    }
     // --- Helper Function For Types ---
     public static function get_schema_for_post($post_id) {
+        global $post;
+        $post = get_post($post_id);
+        setup_postdata($post);
+        // Get the author's ID and website URL to refer authorship
+        $author_id = $post->post_author;
+        $author_url = get_the_author_meta('user_url', $author_id);
+        // Build the author schema array
+        $author_schema = [
+            '@type' => 'Person',
+            'name'  => self::get_author_name_static( $author_id ), // Pass the author ID
+        ];
+        // If the author has a website, add the @id and url properties
+        if ( ! empty( $author_url ) ) {
+            // Ensure the URL has a trailing slash before adding the fragment.
+            $canonical_author_url = trailingslashit( $author_url );
+            $author_schema['@id'] = $canonical_author_url . '#person';
+            $author_schema['url'] = $canonical_author_url;
+        }
+        $schema = [
+            '@context'         => 'https://schema.org',
+            '@type'            => 'Article',
+            'mainEntityOfPage' => ['@type' => 'WebPage', '@id' => get_permalink($post_id)],
+            'headline'         => get_the_title($post_id),
+            'datePublished'    => get_the_date('c', $post_id),
+            'dateModified'     => get_the_modified_date('c', $post_id),
+            'author'           => $author_schema, // Use the author schema array
+            'publisher'        => ['@type' => 'Organization', 'name' => get_bloginfo('name')]
+        ];
+        if (get_site_icon_url()) { $schema['publisher']['logo'] = ['@type' => 'ImageObject', 'url' => get_site_icon_url()]; }
+        if (has_post_thumbnail($post_id)) {
+            $image_id = get_post_thumbnail_id($post_id);
+            $image_data = wp_get_attachment_image_src($image_id, 'full');
+            if ($image_data) {
+                $schema['image'] = [
+                    '@type' => 'ImageObject',
+                    'url' => $image_data[0],
+                    'width' => $image_data[1],
+                    'height' => $image_data[2]
+                ];
+            }
+        }
+        // NEW: Parse content for additional media if the setting is enabled
+        global $post;
+        $post = get_post($post_id);
+        setup_postdata($post);
+        // Get the author's ID and website URL to refer authorship
+        $author_id = $post->post_author;
+        $author_url = get_the_author_meta('user_url', $author_id);
+        // Build the author schema array
+        $author_schema = [
+            '@type' => 'Person',
+            'name'  => self::get_author_name_static( $author_id ), // Pass the author ID
+        ];
+        // If the author has a website, add the @id and url properties
+        if ( ! empty( $author_url ) ) {
+            // Ensure the URL has a trailing slash before adding the fragment.
+            $canonical_author_url = trailingslashit( $author_url );
+            $author_schema['@id'] = $canonical_author_url . '#person';
+            $author_schema['url'] = $canonical_author_url;
+        }
+        $schema = [
+            '@context'         => 'https://schema.org',
+            '@type'            => 'Article',
+            'mainEntityOfPage' => ['@type' => 'WebPage', '@id' => get_permalink($post_id)],
+            'headline'         => get_the_title($post_id),
+            'datePublished'    => get_the_date('c', $post_id),
+            'dateModified'     => get_the_modified_date('c', $post_id),
+            'author'           => $author_schema, // Use the author schema array
+            'publisher'        => ['@type' => 'Organization', 'name' => get_bloginfo('name')]
+        ];
+        if (get_site_icon_url()) { $schema['publisher']['logo'] = ['@type' => 'ImageObject', 'url' => get_site_icon_url()]; }
+        // FIX: Initialize image key safely here to prevent "Undefined array key" warning
+        $schema['image'] = []; // Default to empty array
+        if (has_post_thumbnail($post_id)) {
+            $image_id = get_post_thumbnail_id($post_id);
+            $image_data = wp_get_attachment_image_src($image_id, 'full');
+            if ($image_data) {
+                $schema['image'][] = [
+                    '@type' => 'ImageObject',
+                    'url' => $image_data[0],
+                    'width' => $image_data[1],
+                    'height' => $image_data[2]
+                ];
+            }
+        }
+        // NEW: Parse content for additional media if the setting is enabled
         if (seo44_get_option('scan_content_for_schema')) {
             $media_schema = self::parse_content_for_media_schema($post_id);
+            if (!empty($media_schema['images'])) {
+                // Check if a featured image (or other image) already exists
+                $existing_images = isset($schema['image']) ? (array)$schema['image'] : [];
+                // Merge existing images with content images
+                $schema['image'] = array_merge($existing_images, $media_schema['images']);
+            }
+            if (!empty($media_schema['images'])) {
+                // 1. Re-index to prevent "0": {...} keys
+                $schema['image'] = array_merge($schema['image'], $media_schema['images']);
+            }
             if (!empty($media_schema['videos'])) {
                 $schema['video'] = $media_schema['videos'];
+            }
+        }
+        $description = get_post_meta($post_id, seo44_get_option('description_key'), true);
+        if (!empty($description)) { $schema['description'] = esc_html(wp_strip_all_tags($description)); }
+        $excerpt = get_the_excerpt($post_id);
+        if (!empty($excerpt)) { $schema['abstract'] = esc_html(wp_strip_all_tags($excerpt)); }
+        $content = get_the_content(null, false, $post_id);
+        $schema['wordCount'] = str_word_count(wp_strip_all_tags($content));
+        $category = get_the_category($post_id);
+        if (!empty($category) && $category[0]->name !== 'Uncategorized') {
+            $schema['articleSection'] = esc_html($category[0]->name);
+        }
+        $tags = get_the_tags($post_id);
+        if ($tags) {
+            $keywords = [];
+            foreach ($tags as $tag) { $keywords[] = $tag->name; }
+            $schema['keywords'] = esc_html(implode(', ', $keywords));
+        }
+        wp_reset_postdata();
+        return $schema;
+        // 2. Ensure clean array (re-index)
+        if (!empty($schema['image'])) {
+            $schema['image'] = array_values($schema['image']);
+            // If only one image, Google prefers object over array, but array is valid.
+            // To match your request, we keep it as array_values to remove numeric keys.
+        } else {
+            unset($schema['image']);
+        }
+        $description = get_post_meta($post_id, seo44_get_option('description_key'), true);
+        if (!empty($description)) { $schema['description'] = esc_html(wp_strip_all_tags($description)); }
+        $excerpt = get_the_excerpt($post_id);
+        if (!empty($excerpt)) { $schema['abstract'] = esc_html(wp_strip_all_tags($excerpt)); }
+        $content = get_the_content(null, false, $post_id);
+        $schema['wordCount'] = str_word_count(wp_strip_all_tags($content));
+        $category = get_the_category($post_id);
+        if (!empty($category) && $category[0]->name !== 'Uncategorized') {
+            $schema['articleSection'] = esc_html($category[0]->name);
+        }
+        $tags = get_the_tags($post_id);
+        if ($tags) {
+            $keywords = [];
+            foreach ($tags as $tag) { $keywords[] = $tag->name; }
+            $schema['keywords'] = esc_html(implode(', ', $keywords));
+        }
+        // NEW: Dynamic Table of Contents (hasPart)
+        // Only run this if we are scanning content, to save performance
+        if (seo44_get_option('enable_jumplinks_schema')) {
+            $toc_parts = self::generate_has_part_schema($content, $post->ID);
+            if (!empty($toc_parts)) {
+                $schema['hasPart'] = $toc_parts;
+            }
+        }
+        wp_reset_postdata();
+        return $schema;
+    }
     public function get_schema_for_page($post_id) {
+        $schema = [
+            '@context' => 'https://schema.org',
+            '@type' => 'WebPage',
+            'url' => get_permalink($post_id),
+            'headline' => get_the_title($post_id),
+            'datePublished' => get_the_date('c', $post_id),
+            'dateModified' => get_the_modified_date('c', $post_id),
+        ];
+        // Add the meta description
+        $description = get_post_meta($post_id, seo44_get_option('description_key'), true);
+        if (!empty($description)) {
+            $schema['description'] = esc_html(wp_strip_all_tags($description));
+        }
+        // Add the featured image as a detailed ImageObject
+        if (has_post_thumbnail($post_id)) {
+            $image_id = get_post_thumbnail_id($post_id);
+            $image_data = wp_get_attachment_image_src($image_id, 'full');
+            if ($image_data) {
+                $schema['primaryImageOfPage'] = [
+                    '@type' => 'ImageObject',
+                    'url' => $image_data[0],
+                    'width' => $image_data[1],
+                    'height' => $image_data[2]
+                ];
+            }
+        }
+    // Parse content for additional media if the setting is enabled
+    // NEW CODE for get_schema_for_page
+    if (seo44_get_option('scan_content_for_schema')) {
+        $media_schema = self::parse_content_for_media_schema($post_id);
+        if (!empty($media_schema['images'])) {
+            // 1. Start with the content images found
+            $all_images = $media_schema['images'];
+            // 2. If a Featured Image (primaryImageOfPage) exists, add it to the start of the list
+            if (isset($schema['primaryImageOfPage'])) {
+                array_unshift($all_images, $schema['primaryImageOfPage']);
+            }
+            // 3. Set the 'image' property to the complete list
+            $schema['image'] = $all_images;
+            // Optional: You can choose to keep or unset primaryImageOfPage.
+            // Keeping it is usually better for SEO so Google knows which one is "Main".
+            // This would be the code to cleanup the unset:
+            // unset($schema['primaryImageOfPage']);
+        }
+        if (!empty($media_schema['videos'])) {
+            $schema['video'] = $media_schema['videos'];
+        }
+    }
+        return $schema;
+        $schema = [
+            '@context' => 'https://schema.org',
+            '@type' => 'WebPage',
+            'url' => get_permalink($post_id),
+            'headline' => get_the_title($post_id),
+            'datePublished' => get_the_date('c', $post_id),
+            'dateModified' => get_the_modified_date('c', $post_id),
+        ];
+        // Add the meta description
+        $description = get_post_meta($post_id, seo44_get_option('description_key'), true);
+        if (!empty($description)) {
+            $schema['description'] = esc_html(wp_strip_all_tags($description));
+        }
+        // Add the featured image as a detailed ImageObject
+        $schema['image'] = [];
+        if (has_post_thumbnail($post_id)) {
+            $image_id = get_post_thumbnail_id($post_id);
+            $image_data = wp_get_attachment_image_src($image_id, 'full');
+            if ($image_data) {
+                $schema['primaryImageOfPage'] = [
+                    '@type' => 'ImageObject',
+                    'url' => $image_data[0],
+                    'width' => $image_data[1],
+                    'height' => $image_data[2]
+                ];
+                // Initialize main image list with featured image
+                $schema['image'][] = $schema['primaryImageOfPage'];
+            }
+        }
+        // Parse content for additional media if the setting is enabled
+        // NEW CODE for get_schema_for_page
+        if (seo44_get_option('scan_content_for_schema')) {
+            $media_schema = self::parse_content_for_media_schema($post_id);
+            if (!empty($media_schema['images'])) {
+                // 1. Re-index to prevent "0": {...} keys
+                $schema['image'] = array_merge($schema['image'], $media_schema['images']);
+            }
+            if (!empty($media_schema['videos'])) {
+                $schema['video'] = $media_schema['videos'];
+            }
+        }
+        // 2. Ensure clean array (re-index)
+        if (!empty($schema['image'])) {
+            $schema['image'] = array_values($schema['image']);
+        } else {
+            unset($schema['image']);
+        }
+       // NEW: Dynamic Table of Contents (hasPart)
+        // Only run this if we are scanning content, to save performance
+        if (seo44_get_option('enable_jumplinks_schema')) {
+            // We need to fetch content first since get_schema_for_page doesn't always have it ready
+            $post_content = get_the_content(null, false, $post_id);
+            $toc_parts = self::generate_has_part_schema($post_content, $post_id);
+            if (!empty($toc_parts)) {
+                $schema['hasPart'] = $toc_parts;
+            }
+        }
+        return $schema;
+    }
     public function get_schema_for_website() {
         $schema = [
             '@context' => 'https://schema.org',
             '@type' => 'WebSite',
             'url' => home_url('/'),
             'name' => get_bloginfo('name'),
             'description' => get_bloginfo('description'),
             'potentialAction' => [
                 '@type' => 'SearchAction',
                 'target' => home_url('/?s={search_term_string}'),
                 'query-input' => 'required name=search_term_string',
             ],
         ];
         return $schema;
+    }
     // --- Assemble Organization Schema ---
     public function get_schema_for_organization() {
+        $schema = [
+            '@context' => 'https://schema.org',
+            '@type' => 'WebSite',
+            'url' => home_url('/'),
+            'name' => get_bloginfo('name'),
+            'description' => get_bloginfo('description'),
+            'potentialAction' => [
+                '@type' => 'SearchAction',
+                'target' => home_url('/?s={search_term_string}'),
+                'query-input' => 'required name=search_term_string',
+            ],
+        ];
+        return $schema;
+    }
+    // --- Assemble Organization Schema ---
+    public function get_schema_for_organization() {
         // 1. Name & URL
         $name = seo44_get_option('org_name') ?: get_bloginfo('name');
 …
         // For sameAs, a URL is desired. Add URLs from fields and construct Twitter / X and Facebook URL
         // Twitter/X: Handle logic
         $twitter_handle = seo44_get_option('twitter_handle');
         if ( !empty($twitter_handle) && is_string($twitter_handle) ) {
             // Clean handle just in case they added @
             $clean_handle = str_replace('@', '', $twitter_handle);
             $same_as[] = 'https://x.com/' . esc_attr($clean_handle);
+        }
+        // Twitter/X: Handle logic
+        $twitter_handle = seo44_get_option('twitter_handle');
+        if ( !empty($twitter_handle) && is_string($twitter_handle) ) {
+            // Clean handle just in case they added @
+            $clean_handle = str_replace('@', '', $twitter_handle);
+            $same_as[] = 'https://x.com/' . esc_attr($clean_handle);
+        }
         $extras = ['social_facebook', 'social_instagram', 'social_linkedin', 'social_youtube', 'social_tiktok'];
 …
             if ($val) $same_as[] = esc_url($val);
+        }
         // NEW: Process Additional URLs (One per line)
         $additional_urls = seo44_get_option('social_additional');
         if ( !empty($additional_urls) && is_string($additional_urls) ) {
             // Split by newline, trim whitespace, and filter empty lines
             $urls = array_filter(array_map('trim', explode("\n", $additional_urls)));
             foreach ($urls as $raw_url) {
                 // Validate it is a real URL before adding
                 $clean_url = esc_url_raw($raw_url);
                 if (!empty($clean_url)) {
                     $same_as[] = $clean_url;
+                }
+            }
+        }
+        // NEW: Process Additional URLs (One per line)
+        $additional_urls = seo44_get_option('social_additional');
+        if ( !empty($additional_urls) && is_string($additional_urls) ) {
+            // Split by newline, trim whitespace, and filter empty lines
+            $urls = array_filter(array_map('trim', explode("\n", $additional_urls)));
+            foreach ($urls as $raw_url) {
+                // Validate it is a real URL before adding
+                $clean_url = esc_url_raw($raw_url);
+                if (!empty($clean_url)) {
+                    $same_as[] = $clean_url;
+                }
+            }
+        }
         // 4. Build the Schema
 …
         ];
         // Add Alternate Name
         $alt_name = seo44_get_option('org_alternate_name');
         if ($alt_name) {
             $schema['alternateName'] = $alt_name;
+        }
+        // Add Alternate Name
+        $alt_name = seo44_get_option('org_alternate_name');
+        if ($alt_name) {
+            $schema['alternateName'] = $alt_name;
+        }
         // Add Tagline (Slogan)
 …
         // Contact Point (Updated to include Email)
         $phone = seo44_get_option('org_phone');
         $email = seo44_get_option('org_email');
         if ($phone || $email) {
             $contact_point = ['@type' => 'ContactPoint'];
             if ($phone) {
                 $contact_point['telephone'] = $phone;
                 $contact_point['contactType'] = 'customer service';
+            }
             if ($email) {
                 $contact_point['email'] = $email;
+            }
             $schema['contactPoint'] = $contact_point;
+        }
         // Email at the top level is also good practice
         if ($email) {
             $schema['email'] = $email;
+        }
         // 5. Address
         $street = seo44_get_option('org_address_street');
         $city   = seo44_get_option('org_address_city');
         if ($street && $city) {
             $schema['address'] = [
                 '@type'           => 'PostalAddress',
                 'streetAddress'   => $street,
                 'addressLocality' => $city,
                 'addressRegion'   => seo44_get_option('org_address_state'),
                 'postalCode'      => seo44_get_option('org_address_zip'),
                 'addressCountry'  => seo44_get_option('org_address_country')
             ];
+        }
         // Service Area (New)
         $area_served = seo44_get_option('org_area_served');
         if ($area_served) {
             $schema['areaServed'] = [
                 '@type' => 'Place',
                 'name'  => $area_served
             ];
+        }
         // 6. Founder
         $founder = seo44_get_option('org_founder');
         if ($founder) {
             $schema['founder'] = [
                 '@type' => 'Person',
                 'name'  => $founder
             ];
+        }
         // 7. Founding Date
         $founding_date = seo44_get_option('org_founding_date');
         if ( !empty($founding_date) && is_string($founding_date) ) {
             // Basic validation: ensure it looks somewhat like a year or date
             // You can leave it as raw string, Google parses ISO 8601 (YYYY-MM-DD) well.
             $schema['foundingDate'] = strip_tags($founding_date);
+        }
         // 8. Professional License (New)
         $license = seo44_get_option('org_license');
         if ($license) {
             // "hasCredential" is the modern schema property for this
             $schema['hasCredential'] = [
                 '@type' => 'EducationalOccupationalCredential',
                 'credentialCategory' => 'license',
                 'name' => $license, // e.g., "Contractor License #123456"
                 'recognizedBy' => [
                     '@type' => 'Organization',
                     'name' => 'State Licensing Board' // Generic fallback since we don't ask for the issuer
+                ]
             ];
             // Also add it as a simple identifier for wider compatibility
             $schema['identifier'] = $license;
+        }
         // FINAL STEP: Apply Filters for Extensibility using 'seo44_organization_schema'
+        $phone = seo44_get_option('org_phone');
+        $email = seo44_get_option('org_email');
+        if ($phone || $email) {
+            $contact_point = ['@type' => 'ContactPoint'];
+            if ($phone) {
+                $contact_point['telephone'] = $phone;
+                $contact_point['contactType'] = 'customer service';
+            }
+            if ($email) {
+                $contact_point['email'] = $email;
+            }
+            $schema['contactPoint'] = $contact_point;
+        }
+        // Email at the top level is also good practice
+        if ($email) {
+            $schema['email'] = $email;
+        }
+        // 5. Address
+        $street = seo44_get_option('org_address_street');
+        $city   = seo44_get_option('org_address_city');
+        if ($street && $city) {
+            $schema['address'] = [
+                '@type'           => 'PostalAddress',
+                'streetAddress'   => $street,
+                'addressLocality' => $city,
+                'addressRegion'   => seo44_get_option('org_address_state'),
+                'postalCode'      => seo44_get_option('org_address_zip'),
+                'addressCountry'  => seo44_get_option('org_address_country')
+            ];
+        }
+        // Service Area (New)
+        $area_served = seo44_get_option('org_area_served');
+        if ($area_served) {
+            $schema['areaServed'] = [
+                '@type' => 'Place',
+                'name'  => $area_served
+            ];
+        }
+        // 6. Founder
+        $founder = seo44_get_option('org_founder');
+        if ($founder) {
+            $schema['founder'] = [
+                '@type' => 'Person',
+                'name'  => $founder
+            ];
+        }
+        // 7. Founding Date
+        $founding_date = seo44_get_option('org_founding_date');
+        if ( !empty($founding_date) && is_string($founding_date) ) {
+            // Basic validation: ensure it looks somewhat like a year or date
+            // You can leave it as raw string, Google parses ISO 8601 (YYYY-MM-DD) well.
+            $schema['foundingDate'] = wp_strip_all_tags($founding_date);
+        }
+        // 8. Professional License (New)
+        $license = seo44_get_option('org_license');
+        if ($license) {
+            // "hasCredential" is the modern schema property for this
+            $schema['hasCredential'] = [
+                '@type' => 'EducationalOccupationalCredential',
+                'credentialCategory' => 'license',
+                'name' => $license, // e.g., "Contractor License #123456"
+                'recognizedBy' => [
+                    '@type' => 'Organization',
+                    'name' => 'State Licensing Board' // Generic fallback since we don't ask for the issuer
+                ]
+            ];
+            // Also add it as a simple identifier for wider compatibility
+            $schema['identifier'] = $license;
+        }
+        // FINAL STEP: Apply Filters for Extensibility using 'seo44_organization_schema'
         // Allows developers to add properties like 'duns', 'naics', 'awards', etc.
         return apply_filters('seo44_organization_schema', $schema);
+    }
     // --- Intelligent Schema Detection ---
+        return apply_filters('seo44_organization_schema', $schema);
+    }
+    // --- Intelligent Schema Detection ---
     /**
 …
         $post = get_post($post_id);
         if (!$post) return [];
+        // 1. Try Advanced HowTo (Jump Links Content Miner)
+        // This runs FIRST to see if we have a robust HowTo available
+        $advanced_howto = $this->generate_advanced_howto_schema($post);
+        $final_schemas = [];
+        if (!empty($advanced_howto)) {
+            $final_schemas[] = $advanced_howto;
+        }
+        // 2. Run standard detection for FAQ and HowTo (if not already found)
+        // We still run this for FAQPage, but we might skip HowTo if advanced found one
         if (has_blocks($post->post_content)) {
+            // Use the precise block-based parser for modern content
+            return $this->parse_blocks_for_special_schema($post_id, parse_blocks($post->post_content));
+            $standard_schemas = $this->parse_blocks_for_special_schema($post_id, parse_blocks($post->post_content), !empty($advanced_howto)); // Pass "skip_howto" flag
         } else {
             // Use the HTML fallback for classic editor or page builder content
             // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound
+            // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound
             $rendered_content = apply_filters('the_content', $post->post_content);
+            return $this->parse_html_for_special_schema($post_id, $rendered_content);
+        }
+    }
+            $standard_schemas = $this->parse_html_for_special_schema($post_id, $rendered_content, !empty($advanced_howto));
+        }
+        if (!empty($standard_schemas)) {
+             $final_schemas = array_merge($final_schemas, $standard_schemas);
+        }
+        return $final_schemas;
+    }
     /**
      * NEW: Parses HTML content for FAQ and How-To patterns (the fallback method).
+     * Advanced HowTo Scanner (The "Content Miner")
+     * Uses Jump Links block as a map to mine content between headings.
      */
+    private function parse_html_for_special_schema($post_id, $html) {
+    private function generate_advanced_howto_schema($post) {
+        // 0. Check Cache
+        $cache_key = 'seo44_howto_' . $post->ID . '_' . $post->post_modified;
+        $cached_schema = get_transient($cache_key);
+        if ($cached_schema !== false) {
+            return $cached_schema;
+        }
+        // 1. Strict Check: Is the HowTo Checkbox enabled?
+        $enable_howto_meta = get_post_meta($post->ID, '_seo44_enable_howto', true);
+        if ($enable_howto_meta !== 'yes') {
+            return null;
+        }
+        // 2. Parse Blocks and Find Jump Links Block
+        $blocks = parse_blocks($post->post_content);
+        $flat_blocks = $this->flatten_blocks($blocks);
+        $jump_links_block = $this->find_jump_links_block($flat_blocks);
+        if (!$jump_links_block) return null;
+        // 3. Setup Variables
+        $desc_key = seo44_get_option('description_key') ?: 'seo44_description';
+        $desc = get_post_meta($post->ID, $desc_key, true);
+        if (empty($desc)) {
+             $desc = get_post_meta($post->ID, '_yoast_wpseo_metadesc', true) ?: get_post_meta($post->ID, '_aioseop_description', true);
+             if (empty($desc)) {
+                 $desc = get_the_excerpt($post->ID);
+                 if (empty($desc)) {
+                     $desc = wp_trim_words(strip_shortcodes($post->post_content), 25);
+                 }
+             }
+        }
+        $steps = [];
+        $current_step = null;
+        $tools = [];
+        $supplies = [];
+        $total_time = '';
+        $prep_time = '';
+        $perform_time = '';
+        $found_first_step = false;
+        $potential_list_type = '';
+        $video_schema = [];
+        $yield = '';
+        // 4. Iterate Blocks
+        foreach ($flat_blocks as $block) {
+            // --- PHASE A: PRE-STEP SCANNING (Intro) ---
+            if (!$found_first_step) {
+                if ($block['blockName'] === 'core/paragraph') {
+                    // FIX: Decode entities to ensure non-breaking spaces don't break the regex
+                    $text = html_entity_decode(wp_strip_all_tags($block['innerHTML']));
+                    // FIX: Updated Total Time Regex to prevent matching "Prep Time" as "Time"
+                    // Logic: Match "Total Time" OR "Time" that is NOT preceded by Prep/Active/Cook
+                    if (empty($total_time)) {
+                        $total_time = $this->parse_duration_string($text, '(?:Total\s+|(?<!Prep\s|ation\s|Active\s|Cook\s))Time:\s*');
+                    }
+                    if (empty($prep_time)) $prep_time = $this->parse_duration_string($text, 'Prep(?:aration)?\s*Time:\s*');
+                    if (empty($perform_time)) $perform_time = $this->parse_duration_string($text, '(?:Perform|Active|Cook)\s*Time:\s*');
+                    if (empty($yield) && preg_match('/(?:Yields|Makes):\s*(.+)/i', $text, $matches)) {
+                        $yield = trim($matches[1]);
+                    }
+                    // FIX: Scan for Comma-Separated Tools/Supplies in Paragraphs
+                    // e.g. "Tools: Hammer, Nails, Wood"
+                    if (preg_match('/(?:Tools?|Equipment|Ingredients?|Supplies|Materials?):\s*(.+)/i', $text, $matches)) {
+                        $type = (stripos($matches[0], 'tool') !== false || stripos($matches[0], 'equipment') !== false) ? 'tool' : 'supply';
+                        $items = explode(',', $matches[1]);
+                        foreach ($items as $item) {
+                            $clean_item = trim($item);
+                            $clean_item = rtrim($clean_item, '.'); // Remove trailing period
+                            if (!empty($clean_item)) {
+                                if ($type === 'tool') {
+                                    $tools[] = ['@type' => 'HowToTool', 'name' => $clean_item];
+                                } else {
+                                    $supplies[] = ['@type' => 'HowToSupply', 'name' => $clean_item];
+                                }
+                            }
+                        }
+                    }
+                }
+                // (Bullet list logic remains the same)
+                if ($block['blockName'] === 'core/heading') {
+                    $text = strtolower(wp_strip_all_tags($block['innerHTML']));
+                    if (strpos($text, 'tool') !== false || strpos($text, 'equipment') !== false) {
+                        $potential_list_type = 'tool';
+                    } elseif (strpos($text, 'material') !== false || strpos($text, 'suppl') !== false || strpos($text, 'ingredient') !== false) {
+                        $potential_list_type = 'supply';
+                    } else {
+                        $potential_list_type = '';
+                    }
+                }
+                if ($block['blockName'] === 'core/list' && $potential_list_type) {
+                     if (preg_match_all('/<li[^>]*>(.*?)<\/li>/s', $block['innerHTML'], $list_matches)) {
+                         foreach ($list_matches[1] as $li_text) {
+                             $clean_li = trim(wp_strip_all_tags($li_text));
+                             if ($potential_list_type === 'tool') {
+                                 $tools[] = ['@type' => 'HowToTool', 'name' => $clean_li];
+                             } else {
+                                 $supplies[] = ['@type' => 'HowToSupply', 'name' => $clean_li];
+                             }
+                         }
+                     }
+                     $potential_list_type = '';
+                }
+                // (Video logic remains the same)
+                if ($block['blockName'] === 'core/embed' && isset($block['attrs']['providerNameSlug']) && $block['attrs']['providerNameSlug'] === 'youtube') {
+                    $video_url = $block['attrs']['url'];
+                    $video_id = self::extract_youtube_video_id($video_url);
+                    $upload_date = self::get_youtube_upload_date($video_id, $post->ID);
+                    $oembed_url = 'https://www.youtube.com/oembed?format=json&url=' . urlencode($video_url);
+                    $response = wp_remote_get($oembed_url);
+                    $vid_title = ''; $vid_thumb = ''; $vid_author = '';
+                    if (!is_wp_error($response)) {
+                        $data = json_decode(wp_remote_retrieve_body($response), true);
+                        if ($data) {
+                            $vid_title = $data['title'];
+                            $vid_thumb = $data['thumbnail_url'];
+                            $vid_author = $data['author_name'];
+                        }
+                    }
+                    if (empty($vid_title)) $vid_title = get_the_title($post->ID) . ' Video Tutorial';
+                    if (empty($vid_thumb)) $vid_thumb = 'https://i.ytimg.com/vi/' . $video_id . '/hqdefault.jpg';
+                    $video_schema = [
+                        '@type' => 'VideoObject',
+                        'name' => $vid_title,
+                        'description' => get_the_title($post->ID) . ' - Video Guide',
+                        'thumbnailUrl' => $vid_thumb,
+                        'uploadDate' => $upload_date,
+                        'embedUrl' => $video_url,
+                        'contentUrl' => $video_url
+                    ];
+                    if ($vid_author) {
+                        $video_schema['author'] = ['@type' => 'Person', 'name' => $vid_author];
+                    }
+                }
+            }
+            // --- PHASE B: STEP MINING ---
+            if ($block['blockName'] === 'core/heading') {
+                if (preg_match('/id="([^"]+)"/', $block['innerHTML'], $id_match)) {
+                    $anchor_id = $id_match[1];
+                    // --- EXCLUSION LOGIC START ---
+                    $whitelist_ids = get_post_meta($post->ID, '_seo44_howto_step_ids', true);
+                    $should_include = true;
+                    // STRATEGY A: Whitelist (New System)
+                    if ( ! empty($whitelist_ids) && is_array($whitelist_ids) ) {
+                        if ( ! in_array($anchor_id, $whitelist_ids) ) {
+                            $should_include = false;
+                        }
+                        // FIX: Global Guard for Intro/Description
+                        // Even if whitelisted, ignore Intro headings so they don't consume metadata
+                        // May not need this...
+                        if (stripos($anchor_id, 'intro') !== false || stripos($anchor_id, 'description') !== false) {
+                            $should_include = false;
+                        }
+                    }
+                    // STRATEGY B: Fallback
+                    else {
+                        if (stripos($anchor_id, 'intro') !== false) { $should_include = false; }
+                        if (substr($anchor_id, -7) === '-nostep') { $should_include = false; }
+                    }
+                    if ( ! $should_include ) {
+                        if ($current_step) { $steps[] = $current_step; $current_step = null; }
+                        continue;
+                    }
+                    // --- EXCLUSION LOGIC END ---
+                    $found_first_step = true;
+                    if ($current_step) { $steps[] = $current_step; }
+                    $current_step = [
+                        '@type' => 'HowToStep',
+                        'url'   => get_permalink($post->ID) . '#' . $anchor_id,
+                        'name'  => trim(wp_strip_all_tags($block['innerHTML'])),
+                        'text'  => '',
+                        'image' => []
+                    ];
+                    continue;
+                }
+            }
+            if ($current_step) {
+                if ($block['blockName'] === 'core/paragraph') {
+                    $text = trim(wp_strip_all_tags($block['innerHTML']));
+                    if (!empty($text)) { $current_step['text'] .= $text . ' '; }
+                }
+                if ($block['blockName'] === 'core/image') {
+                     if (preg_match('/src="([^"]+)"/', $block['innerHTML'], $match)) {
+                         if (!isset($current_step['image'])) { $current_step['image'] = []; }
+                         $current_step['image'][] = $match[1];
+                     }
+                }
+                if ($block['blockName'] === 'core/list') {
+                    $current_step['text'] .= trim(wp_strip_all_tags($block['innerHTML'])) . ' ';
+                }
+            }
+        }
+        if ($current_step) { $steps[] = $current_step; }
+        if (!empty($steps)) {
+            foreach ($steps as $k => $step) {
+                if (empty($step['image'])) {
+                    $steps[$k]['image'] = '';
+                } elseif (count($step['image']) === 1) {
+                    $steps[$k]['image'] = $step['image'][0];
+                }
+                $steps[$k]['text'] = trim($step['text']);
+            }
+            $howto = [
+                '@context' => 'https://schema.org',
+                '@type'    => 'HowTo',
+                'name'     => get_the_title($post->ID),
+                'description' => $desc,
+                'step'     => $steps
+            ];
+            if ($total_time) { $howto['totalTime'] = $total_time; }
+            if ($prep_time) { $howto['prepTime'] = $prep_time; }
+            if ($perform_time) { $howto['performTime'] = $perform_time; }
+            if (!empty($tools)) { $howto['tool'] = $tools; }
+            if (!empty($supplies)) { $howto['supply'] = $supplies; }
+            if (!empty($video_schema)) { $howto['video'] = $video_schema; }
+            if ($yield) { $howto['yield'] = $yield; }
+            $howto['disambiguatingDescription'] = $desc;
+            if (has_post_thumbnail($post->ID)) {
+                 $howto['image'] = get_the_post_thumbnail_url($post->ID, 'full');
+            }
+            $categories = get_the_category($post->ID);
+            if (!empty($categories)) {
+                 $howto['about'] = ['@type' => 'Thing', 'name' => $categories[0]->name];
+            }
+            $tags = get_the_tags($post->ID);
+            if (!empty($tags)) {
+                 $howto['teaches'] = ['@type' => 'DefinedTerm', 'name' => $tags[0]->name];
+            }
+            set_transient($cache_key, $howto, DAY_IN_SECONDS);
+            return $howto;
+        }
+        return null;
+    }
+    /**
+     * Helper: Parse Duration Strings
+     * FIX: Re-wrote to accept raw patterns without delimiters to prevent syntax errors.
+     */
+    private function parse_duration_string($text, $prefix_pattern) {
+        // We construct the full regex here to ensure delimiters wrap the WHOLE pattern.
+        // Matches: Label -> (1) Hours -> (2) Minutes
+        $regex = '/' . $prefix_pattern . '(?:(\d+)\s*(?:hour|hr)s?\s*)?(?:and\s*)?(?:(\d+)\s*(?:minute|min)s?)?/i';
+        if (preg_match($regex, $text, $matches)) {
+            $hours = !empty($matches[1]) ? intval($matches[1]) : 0;
+            $minutes = !empty($matches[2]) ? intval($matches[2]) : 0;
+            if ($hours > 0 || $minutes > 0) {
+                 $duration = 'PT';
+                 if ($hours > 0) $duration .= $hours . 'H';
+                 if ($minutes > 0) $duration .= $minutes . 'M';
+                 return $duration;
+            }
+        }
+        return '';
+    }
+//    private function get_youtube_id($url) {
+//        preg_match('/(?:youtube\.com\/(?:[^\/]+\/.+\/|(?:v|e(?:mbed)?)\/|.*[?&]v=)|youtu\.be\/)([^"&?\/\s]{11})/i', $url, $matches);
+//        return isset($matches[1]) ? $matches[1] : '';
+//    }
+    /**
+     * Helper: Flattens nested block structures into a single linear array.
+     */
+    private function flatten_blocks($blocks) {
+        $flat = [];
+        foreach ($blocks as $block) {
+            $flat[] = $block;
+            if (!empty($block['innerBlocks'])) {
+                $flat = array_merge($flat, $this->flatten_blocks($block['innerBlocks']));
+            }
+        }
+        return $flat;
+    }
+    /**
+     * Helper to find the Jump Links block recursively
+     * Updated to be broader and find any block with 'jump-links' in the name
+     * FIX: Added check to ensure blockName is a string before strpos
+     */
+    private function find_jump_links_block($blocks) {
+        foreach ($blocks as $block) {
+            // Broad check for any jump links block
+            if (isset($block['blockName']) && is_string($block['blockName']) && strpos($block['blockName'], 'jump-links') !== false) {
+                return $block;
+            }
+            // Recursive check for inner blocks (e.g. inside Groups/Columns)
+            if (!empty($block['innerBlocks'])) {
+                $found = $this->find_jump_links_block($block['innerBlocks']);
+                if ($found) return $found;
+            }
+        }
+        return null;
+    }
+    private function parse_html_for_special_schema($post_id, $html, $skip_howto = false) {
         $final_schemas = [];
 …
+        }
         // HowTo Detection in HTML
         if (preg_match('/<h[2-4][^>]*>(installation|directions|instructions)<\/h[2-4]>/i', $html, $howto_heading_match)) {
+        // HowTo Detection (Skipped if Advanced scanner found one)
+        if (!$skip_howto && preg_match('/<h[2-4][^>]*>(installation|directions|instructions)<\/h[2-4]>/i', $html, $howto_heading_match)) {
             preg_match('/' . preg_quote($howto_heading_match[0], '/') . '.*?<ol.*?>(.*?)<\/ol>/is', $html, $ol_match);
             if(isset($ol_match[1])) {
 …
      * The original block-based parser, now in its own function.
      */
     private function parse_blocks_for_special_schema($post_id, $blocks) {
+    private function parse_blocks_for_special_schema($post_id, $blocks, $skip_howto = false) {
         $faq_questions = [];
         $howto_steps = [];
 …
         $final_schemas = [];
         foreach ($blocks as $block) {
+        foreach ($blocks as $block) {
             $heading_text = strtolower(wp_strip_all_tags($block['innerHTML']));
 …
+                }
                 $is_faq_section = false;
                 $is_howto_section = false; // Stop looking for HowTo steps as well
+                $is_howto_section = false;
                 $current_answer_blocks = [];
                 continue;
 …
+            }
+           // --- HowTo Detection ---
+            if (!$is_faq_section && $block['blockName'] === 'core/heading' && preg_match('/(installation|directions|instructions)/i', $heading_text)) {
+                $is_howto_section = true;
+                // Use trim() to remove leading/trailing whitespace and newlines
+                $howto_heading_text = trim(wp_strip_all_tags($block['innerHTML']));
+                continue; // Find the heading, then look for the list in subsequent blocks
+            }
+            // If we are in a how-to section and find the first ordered list, process it.
+            if ($is_howto_section && $block['blockName'] === 'core/list' && isset($block['attrs']['ordered']) && $block['attrs']['ordered']) {
+                 if (!empty($block['innerBlocks'])) {
+                    foreach($block['innerBlocks'] as $list_item_block) {
+                        if ($list_item_block['blockName'] === 'core/list-item') {
+                            $howto_steps[] = ['@type' => 'HowToStep', 'text' => esc_html(wp_strip_all_tags($list_item_block['innerHTML']))];
+            // HowTo Logic (Skipped if Advanced scanner found one)
+            if (!$skip_howto) {
+                if (!$is_faq_section && $block['blockName'] === 'core/heading' && preg_match('/(installation|directions|instructions)/i', $heading_text)) {
+                    $is_howto_section = true;
+                    // Use trim() to remove leading/trailing whitespace and newlines
+                    $howto_heading_text = trim(wp_strip_all_tags($block['innerHTML']));
+                    continue;  // Find the heading, then look for the list in subsequent blocks
+                }
+                // If we are in a how-to section and find the first ordered list, process it.
+                if ($is_howto_section && $block['blockName'] === 'core/list' && isset($block['attrs']['ordered']) && $block['attrs']['ordered']) {
+                     if (!empty($block['innerBlocks'])) {
+                        foreach($block['innerBlocks'] as $list_item_block) {
+                            if ($list_item_block['blockName'] === 'core/list-item') {
+                                $howto_steps[] = ['@type' => 'HowToStep', 'text' => esc_html(wp_strip_all_tags($list_item_block['innerHTML']))];
+                            }
+                        }
+                    }
+                }
                  $is_howto_section = false; // Stop after finding the first ordered list
+                     $is_howto_section = false; // Stop after finding the first ordered list
+                }
+            }
+        }
 …
     /**
      *  HELPER: Cleans and formats block content for an answer.
+     * HELPER: Cleans and formats block content for an answer.
      */
     private function clean_and_format_answer($blocks) {
 …
         // Clean up remaining HTML, extra whitespace, and decode entities
         $clean_text = trim(wp_strip_all_tags(html_entity_decode($answer_html)));
         return preg_replace('/\n\s*\n/', "\n", $clean_text); // Collapse multiple newlines
+    }
+        return preg_replace('/\n\s*\n/', "\n", $clean_text);
+    }
     // --- MEDIA PARSING FUNCTION ---
 …
         $content = $post->post_content;
         $found_block_image_urls = [];
+        $found_video_urls = []; // Fixed: Added missing variable declaration
+        $found_video_urls = [];
+        $default_description = get_the_title($post_id) . ' Video';
         if (has_blocks($content)) {
             $blocks = parse_blocks($content);
             foreach ($blocks as $block) {
                 // Handle Image Blocks
                 if ($block['blockName'] === 'core/image' && !empty($block['attrs']['id'])) {
 …
+                        }
                         $images[] = $image_object;
                         $found_block_image_urls[] = $image_data[0]; // Keep track of URLs we've already added
+                        $found_block_image_urls[] = $image_data[0];
+                    }
+                }
                 // Handle YouTube Embed Blocks using the oEmbed API
+                // Handle YouTube Embed Blocks using the oEmbed API + API/Scraping
                 if ($block['blockName'] === 'core/embed' && isset($block['attrs']['providerNameSlug']) && $block['attrs']['providerNameSlug'] === 'youtube') {
+                    $oembed_url = 'https://www.youtube.com/oembed?format=json&url=' . urlencode($block['attrs']['url']);
+                    $video_url = $block['attrs']['url'];
+                    // 1. Get Accurate Date
+                    $video_id = self::extract_youtube_video_id($video_url);
+                    $upload_date = self::get_youtube_upload_date($video_id, $post_id);
+                    // 2. Get Metadata
+                    $oembed_url = 'https://www.youtube.com/oembed?format=json&url=' . urlencode($video_url);
                     $response = wp_remote_get($oembed_url);
                     if (!is_wp_error($response)) {
                         $data = json_decode(wp_remote_retrieve_body($response), true);
 …
                                 'name' => $data['title'],
                                 'thumbnailUrl' => $data['thumbnail_url'],
+                                'embedUrl' => $block['attrs']['url'],
+                                'author' => ['@type' => 'Person', 'name' => $data['author_name']]
+                                'embedUrl' => $video_url,
+                                'contentUrl' => $video_url,
+                                'author' => ['@type' => 'Person', 'name' => $data['author_name']],
+                                'uploadDate' => $upload_date, // Uses API/Scraped date
+                                'description' => $default_description
                             ];
                             $found_video_urls[] = $block['attrs']['url']; // Track processed videos
+                            $found_video_urls[] = $video_url;
+                        }
+                    }
 …
+        }
  // --- Universal Fallback for <img> and <iframe> tags in Classic Editor or HTML Blocks---
         // Find Images (logic is unchanged)
+        // --- Universal Fallback for <img> and <iframe> tags ---
+        // Find Images
         if (preg_match_all('/<img[^>]+>/i', $content, $img_matches)) {
             foreach ($img_matches[0] as $img_tag) {
 …
                 if (preg_match('/src\s*=\s*[\'"]([^\'"]+)[\'"]/i', $img_tag, $src_matches)) {
                     $url = $src_matches[1];
-                    // Add the image ONLY if we haven't already added it from a core/image block
                     if (!in_array($url, $found_block_image_urls)) {
                         $images[] = ['@type' => 'ImageObject', 'url' => $url];
+                    }
+                }
+            }
+        }
         // RESTORED: Find iframes
+            }
+        }
+        // Find iframes for YouTube
         if (preg_match_all('/<iframe[^>]+src="([^"]+)"[^>]*>/i', $content, $iframe_matches)) {
             foreach($iframe_matches[1] as $iframe_src) {
+                // Skip if we already processed this video from a block
+                if (in_array($iframe_src, $found_video_urls)) {
+                    continue;
+                }
+                if (strpos($iframe_src, 'youtube.com/embed') !== false) {
+                    preg_match('/embed\/([a-zA-Z0-9_-]+)/i', $iframe_src, $id_matches);
+                    $video_id = $id_matches[1] ?? null;
+                    if ($video_id) {
+                        $videos[] = [
+                            '@type' => 'VideoObject',
+                            'name' => 'Embedded YouTube Video', // Title isn't available from a raw iframe
+                            'thumbnailUrl' => 'https://i.ytimg.com/vi/' . $video_id . '/hqdefault.jpg',
+                            'embedUrl' => 'https://www.youtube.com/watch?v=' . $video_id,
+                        ];
+                    }
+                if (in_array($iframe_src, $found_video_urls)) { continue; }
+                // Use the static helper to check ID
+                $video_id = self::extract_youtube_video_id($iframe_src);
+                if ($video_id) {
+                    $upload_date = self::get_youtube_upload_date($video_id, $post_id);
+                    $videos[] = [
+                        '@type' => 'VideoObject',
+                        'name' => 'Embedded YouTube Video',
+                        'description' => $default_description,
+                        'uploadDate' => $upload_date,
+                        'thumbnailUrl' => 'https://i.ytimg.com/vi/' . $video_id . '/hqdefault.jpg',
+                        'embedUrl' => 'https://www.youtube.com/watch?v=' . $video_id,
+                        'contentUrl' => 'https://www.youtube.com/watch?v=' . $video_id
+                    ];
+                }
+            }
 …
         return ['images' => $images, 'videos' => $videos];
+    }
     //  Function to generate BreadcrumbList schema for Taxonomy pages (not posts & Pages)
+    //  Function to generate BreadcrumbList schema for Taxonomy pages (not posts & Pages)
     public function get_schema_for_taxonomy() {
         $term = get_queried_object();
 …
         return $schema;
+    }
+    // Function to create author name
+    public function get_author_name( $author_id ) {
+        $format = seo44_get_option('author_format', 'display_name');
+        switch ($format) {
+            case 'first_last': return get_the_author_meta('first_name', $author_id) . ' ' . get_the_author_meta('last_name', $author_id);
+            case 'last_first': return get_the_author_meta('last_name', $author_id) . ', ' . get_the_author_meta('first_name', $author_id);
+            default: return get_the_author_meta('display_name', $author_id);
+        }
+    }
+    public static function get_author_name_static( $author_id ) {
+        $frontend = new self();
+        return $frontend->get_author_name( $author_id );
+    }
+    // Function to create author name
+    // With more graceful logic for missing name fields
+    public function get_author_name( $author_id ) {
+        $format = seo44_get_option('author_format', 'display_name');
+        // 1. Get the raw values first
+        $first_name = get_the_author_meta( 'first_name', $author_id );
+        $last_name  = get_the_author_meta( 'last_name', $author_id );
+        $formatted_name = '';
+        switch ( $format ) {
+            case 'first_last':
+                // 2. Concatenate and trim.
+                // If both are empty, trim() ensures we get "", not " ".
+                // If one is missing, it removes the leading/trailing space.
+                $formatted_name = trim( $first_name . ' ' . $last_name );
+                break;
+            case 'last_first':
+                // 3. Smart comma handling.
+                // Only add the comma if BOTH fields have data.
+                if ( ! empty( $last_name ) && ! empty( $first_name ) ) {
+                    $formatted_name = $last_name . ', ' . $first_name;
+                } else {
+                    // If one is missing, fall back to simple concatenation/trim without the comma
+                    $formatted_name = trim( $last_name . ' ' . $first_name );
+                }
+                break;
+            // Default case is handled by the fallback check below
+        }
+        // 4. The Fallback Check
+        // If formatted_name is empty (because fields were empty) OR format was 'display_name'
+        if ( empty( $formatted_name ) ) {
+            return get_the_author_meta( 'display_name', $author_id );
+        }
+        return $formatted_name;
+    }
+    public static function get_author_name_static( $author_id ) {
+        $frontend = new self();
+        return $frontend->get_author_name( $author_id );
+    }
+    /**
+     * Parses content for headings with IDs to create a "Table of Contents" schema.
+     * @param string $content The post content.
+     * @return array Array of WebPageElement objects.
+     */
+    // This could be updated to use IDS passed through to field from jump links block to be more efficient than scan and remove need for checkbox.
+    // UPDATED: Now respects whitelist to match "included" jump links
+    private static function generate_has_part_schema($content, $post_id) {
+        $has_part = [];
+        // Retrieve the whitelist of IDs (generated by JS when saving the Jump Links block)
+        $whitelist_ids = get_post_meta($post_id, '_seo44_howto_step_ids', true);
+        // Regex to find H2-H4 tags that have an ID attribute
+        if (preg_match_all('/<h[2-4][^>]*id="([^"]+)"[^>]*>(.*?)<\/h[2-4]>/i', $content, $matches, PREG_SET_ORDER)) {
+            foreach ($matches as $match) {
+                $anchor_id = $match[1];
+                $heading_text = wp_strip_all_tags($match[2]);
+                // --- FILTER LOGIC ---
+                // Default to include everything if no whitelist exists (e.g. old post, no jump links block)
+                // But if a whitelist exists (array), enforce it strictly.
+                $should_include = true;
+                if ( ! empty($whitelist_ids) && is_array($whitelist_ids) ) {
+                    if ( ! in_array($anchor_id, $whitelist_ids) ) {
+                        $should_include = false;
+                    }
+                }
+                if ($should_include && !empty($anchor_id) && !empty($heading_text)) {
+                    $has_part[] = [
+                        '@type' => 'WebPageElement',
+                        'name'  => $heading_text,
+                        'url'   => get_permalink($post_id) . '#' . $anchor_id,
+                        'cssSelector' => '#' . $anchor_id
+                    ];
+                }
+            }
+        }
+        return $has_part;
+    }
+    /**
+     * Extracts YouTube video ID from various URL formats
+     */
+    private static function extract_youtube_video_id($url) {
+        $patterns = [
+            '/youtube\.com\/watch\?v=([a-zA-Z0-9_-]+)/',            // Standard
+            '/youtube\.com\/embed\/([a-zA-Z0-9_-]+)/',              // Embed
+            '/youtu\.be\/([a-zA-Z0-9_-]+)/',                        // Short URL
+            '/youtube\.com\/v\/([a-zA-Z0-9_-]+)/',                  // Old format
+        ];
+        foreach ($patterns as $pattern) {
+            if (preg_match($pattern, $url, $matches)) {
+                return $matches[1];
+            }
+        }
+        return null;
+    }
+    /**
+     * Gets YouTube video upload date with multiple fallback strategies
+     * @param string $video_id YouTube video ID
+     * @param int $post_id WordPress post ID for fallback
+     * @return string ISO 8601 formatted date
+     */
+    private static function get_youtube_upload_date($video_id, $post_id) {
+        if (empty($video_id)) {
+            return get_the_date('c', $post_id);
+        }
+        // Strategy 1: Check transient cache (24 hour cache to avoid API limits)
+        $cache_key = 'seo44_yt_date_' . $video_id;
+        $cached_date = get_transient($cache_key);
+        if ($cached_date !== false) {
+            return $cached_date;
+        }
+        // Strategy 2: Try YouTube Data API (if configured)
+        $api_key = seo44_get_option('youtube_api_key');
+        if (!empty($api_key)) {
+            $api_date = self::fetch_youtube_date_from_api($video_id, $api_key);
+            if ($api_date) {
+                // Cache for 24 hours
+                set_transient($cache_key, $api_date, DAY_IN_SECONDS);
+                return $api_date;
+            }
+        }
+        // Strategy 3: Try scraping YouTube page (no API key needed, but less reliable)
+        $scraped_date = self::scrape_youtube_upload_date($video_id);
+        if ($scraped_date) {
+            // Cache for 24 hours
+            set_transient($cache_key, $scraped_date, DAY_IN_SECONDS);
+            return $scraped_date;
+        }
+        // Strategy 4: Fallback to post publication date
+        return get_the_date('c', $post_id);
+    }
+    /**
+     * Fetches upload date from YouTube Data API v3
+     */
+    private static function fetch_youtube_date_from_api($video_id, $api_key) {
+        $api_url = sprintf(
+            'https://www.googleapis.com/youtube/v3/videos?id=%s&key=%s&part=snippet',
+            urlencode($video_id),
+            urlencode($api_key)
+        );
+        $response = wp_remote_get($api_url, [
+            'timeout' => 5,
+            'sslverify' => true
+        ]);
+        if (is_wp_error($response)) {
+            return null;
+        }
+        $body = wp_remote_retrieve_body($response);
+        $data = json_decode($body, true);
+        if (isset($data['items'][0]['snippet']['publishedAt'])) {
+            return $data['items'][0]['snippet']['publishedAt'];
+        }
+        return null;
+    }
+    /**
+     * Scrapes upload date from YouTube page HTML (fallback method, no API key needed)
+     * IMPPROVED: Scans Meta tags first, then JSON-LD, then internal player data.
+     */
+    private static function scrape_youtube_upload_date($video_id) {
+        $video_page_url = 'https://www.youtube.com/watch?v=' . $video_id;
+        $response = wp_remote_get($video_page_url, [
+            'timeout' => 10,
+            // Use a generic browser agent to avoid being served a "bare" bot page
+            'user-agent' => 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36',
+            'sslverify' => true
+        ]);
+        if (is_wp_error($response)) {
+            return null;
+        }
+        $html = wp_remote_retrieve_body($response);
+        // Strategy A: Look for Meta Tags (Most Reliable)
+        // YouTube usually includes: <meta itemprop="datePublished" content="YYYY-MM-DD">
+        if (preg_match('/<meta\s+itemprop="datePublished"\s+content="([^"]+)"/i', $html, $matches)) {
+            return $matches[1];
+        }
+        if (preg_match('/<meta\s+itemprop="uploadDate"\s+content="([^"]+)"/i', $html, $matches)) {
+            return $matches[1];
+        }
+        // Strategy B: JSON-LD Schema (Your original method)
+        if (preg_match('/"uploadDate":"([^"]+)"/', $html, $matches)) {
+            return $matches[1];
+        }
+        // Strategy C: Look for microformatDataRenderer (Internal YouTube Data)
+        // This is often found inside the large ytInitialPlayerResponse JSON object
+        if (preg_match('/"publishDate":"([^"]+)"/', $html, $matches)) {
+            $date_string = $matches[1]; // Usually YYYY-MM-DD
+            if (preg_match('/^\d{4}-\d{2}-\d{2}$/', $date_string)) {
+                return $date_string;
+            }
+            // Fallback for compact format YYYYMMDD
+            if (preg_match('/^(\d{4})(\d{2})(\d{2})$/', $date_string, $date_parts)) {
+                return sprintf('%s-%s-%s', $date_parts[1], $date_parts[2], $date_parts[3]);
+            }
+        }
+        return null;
+    }
+}

search-appearance-toolkit-seo-44/tags/4.3/includes/class-seo44-metabox.php

-                      r3389330
+                      r3423355
 <?php
+// Version 4.3 - Added a Generate HowTo Schema checkbox that appears via activation word
 class SEO44_Metabox {
 …
         $description = get_post_meta($post->ID, seo44_get_option('description_key'), true);
         $keywords = get_post_meta($post->ID, seo44_get_option('keywords_key'), true);
+        $jump_link_headings = get_post_meta($post->ID, '_seo44_jump_link_headings', true);
+        wp_nonce_field('seo44_jump_links_nonce', 'seo44_jump_links_nonce_field');
+        // NEW: Retrieve the HowTo toggle state
+        // We use 'yes' for checked, empty for unchecked
+        $enable_howto = get_post_meta($post->ID, '_seo44_enable_howto', true);
+        // Logic to determine initial visibility: Show if already checked
+        $howto_wrapper_style = ($enable_howto === 'yes') ? '' : 'display:none;';
     ?>
         <input type="hidden" id="seo44_jump_link_headings_field" name="seo44_jump_link_headings" value="<?php echo esc_attr($jump_link_headings); ?>">
         <p>
             <label for="seo44_title"><strong><?php esc_html_e('SEO Title', 'search-appearance-toolkit-seo-44'); ?></strong></label><br>
 …
         </p>
         <?php endif; ?>
+        <div id="seo44-howto-trigger-wrapper" style="<?php echo esc_attr($howto_wrapper_style); ?>">
+            <p>
+                <label for="seo44_enable_howto">
+                    <input type="checkbox" id="seo44_enable_howto" name="seo44_enable_howto" value="yes" <?php checked($enable_howto, 'yes'); ?>>
+                    <strong><?php esc_html_e('Generate HowTo Schema', 'search-appearance-toolkit-seo-44'); ?></strong>
+                </label>
+                <br>
+                <span class="description">
+                    <?php esc_html_e('It looks like you are publishing a "How-To" guide. When this box is checked, SEO 44 will generate HowTo structured data.', 'search-appearance-toolkit-seo-44'); ?>
+                </span>
+            </p>
+        </div>
         <hr>
         <div id="seo44-snippet-preview">
 …
     public function save_meta_box_data($post_id) {
         if (!isset($_POST['seo44_meta_box_nonce']) || !wp_verify_nonce(sanitize_text_field(wp_unslash($_POST['seo44_meta_box_nonce'])), 'seo44_save_meta_box_data')) return;
         if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE) return;
         $post_type = get_post_type($post_id);
         // Robust capability checking
         if (!current_user_can("edit_{$post_type}s")) {
+          if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE) return;
+          $post_type = get_post_type($post_id);
+          // Robust capability checking
+          if (!current_user_can("edit_{$post_type}s")) {
             return;
+        }
         if (isset($_POST['seo44_title'])) {
+          }
+          if (isset($_POST['seo44_title'])) {
             update_post_meta($post_id, seo44_get_option('title_key'), sanitize_text_field(wp_unslash($_POST['seo44_title'])));
+        }
 …
             update_post_meta($post_id, seo44_get_option('keywords_key'), sanitize_text_field(wp_unslash($_POST['seo44_keywords'])));
+        }
+            // Save Logic for Hidden Box for Jump Links Block data
+        if (isset($_POST['seo44_jump_links_nonce_field']) && wp_verify_nonce(sanitize_text_field(wp_unslash($_POST['seo44_jump_links_nonce_field'])), 'seo44_jump_links_nonce')) {
+            if (isset($_POST['seo44_jump_link_headings'])) {
+                update_post_meta($post_id, '_seo44_jump_link_headings', sanitize_text_field(wp_unslash($_POST['seo44_jump_link_headings'])));
+            }
+        // NEW: Save HowTo Checkbox
+        if (isset($_POST['seo44_enable_howto'])) {
+            update_post_meta($post_id, '_seo44_enable_howto', 'yes');
+        } else {
+            // Checkboxes don't send data if unchecked, so we must explicitly delete or update to 'no'
+            // Only do this if our nonce is verified (which implies the form was actually submitted)
+            update_post_meta($post_id, '_seo44_enable_howto', 'no');
+        }
+    }
+}

search-appearance-toolkit-seo-44/tags/4.3/includes/class-seo44-settings.php

-                      r3405454
+                      r3423355
 <?php
+// Version 4.3
+// Added hasPart Table of Contents Schema, advanced HowTo Schema
+// Added YouTube Data API to Integrations
 class SEO44_Settings {
 …
         add_settings_field('seo44_schema_tools', __('Schema Scanner', 'search-appearance-toolkit-seo-44'), [$this, 'render_schema_tools'], 'seo-44_schema', 'seo44_schema_settings_section');
         add_settings_field('seo44_enable_schema', __('Enable Schema', 'search-appearance-toolkit-seo-44'), [$this, 'render_checkbox_field'], 'seo-44_schema', 'seo44_schema_settings_section', ['id' => 'enable_schema', 'label' => __('Output JSON-LD to your webpages.', 'search-appearance-toolkit-seo-44')]);
-        // NEW: Add checkbox for scanning content
         add_settings_field('seo44_scan_content_for_schema', __('Scan Content for Media', 'search-appearance-toolkit-seo-44'), [$this, 'render_checkbox_field'], 'seo-44_schema', 'seo44_schema_settings_section', [
             'id' => 'scan_content_for_schema',
 …
             'tooltip' => 'This provides more detail to search engines but can be slightly more resource-intensive.'
         ]);
+        // NEW: Add checkbox for advanced schema detection
+        add_settings_field('seo44_enable_advanced_schema', __('Enable Advanced Schema Detection', 'search-appearance-toolkit-seo-44'), [$this, 'render_checkbox_field'], 'seo-44_schema', 'seo44_schema_settings_section', [
+            'id' => 'enable_advanced_schema',
+            'label' => __('Scan content for patterns to generate FAQ and How-To schema.', 'search-appearance-toolkit-seo-44'),
+            'tooltip' => 'If special formats are detected, they will be added to your page\'s schema structured data.'
+        ]);
+        // UPDATED: Using custom callback to include the Jump Links Block recommendation
+        add_settings_field('seo44_enable_advanced_schema', __('Enable Advanced Schema Detection', 'search-appearance-toolkit-seo-44'), [$this, 'render_advanced_schema_checkbox'], 'seo-44_schema', 'seo44_schema_settings_section');
+        // NEW: Jump Links Integration Field
+        add_settings_field('seo44_enable_jumplinks_schema',
+            __('Generate "Table of Contents" Schema', 'search-appearance-toolkit-seo-44'),
+            [$this, 'render_checkbox_field'],
+            'seo-44_schema',
+            'seo44_schema_settings_section',
+            [
+                'id' => 'enable_jumplinks_schema',
+                'label' => __('Automatically create "hasPart" schema for headings highlighted in Jump Links Blocks, aligning structured data with Jump Links to reinforce support for Jump-to links in search results.', 'search-appearance-toolkit-seo-44'),
+                'tooltip' => 'This helps Google understand the deep structure of your article by mapping your headings (H2-H4) as distinct sections, complementing the visual Jump Links Block on your page.'
+            ]
+        );
         add_settings_field('seo44_enable_schema_on_taxonomies', __('Enable Schema on Taxonomies', 'search-appearance-toolkit-seo-44'), [$this, 'render_checkbox_field'], 'seo-44_schema', 'seo44_schema_settings_section', [
             'id' => 'enable_schema_on_taxonomies',
 …
+            ]
         );
         // 3. Add Address Fields (Crucial for Local SEO & Disambiguation)
         add_settings_field(
 …
         );
         add_settings_field(
             'org_phone',
 …
+            ]
         );
+        // --- Site APIs Header ---
+        add_settings_field(
+            'seo44_site_apis_header',
+            '', // Empty label for full-width header
+            [$this, 'render_site_apis_header_field'],
+            'seo-44_integrations',
+            'seo44_integrations_section'
+        );
+        // --- YouTube API Key ---
+        add_settings_field(
+            'youtube_api_key',
+            __('YouTube API Key', 'search-appearance-toolkit-seo-44'),
+            [$this, 'render_youtube_api_key_field'],
+            'seo-44_integrations',
+            'seo44_integrations_section',
+            [
+                'label_for' => 'youtube_api_key',
+                'tooltip'   => __('This will be used to improve the Video Object schema created for embedded YouTube Videos.', 'search-appearance-toolkit-seo-44')
+            ]
+        );
         // --- end of settings_init ---
+    }
 …
             'enable_tags', 'include_keywords', 'include_author',
             'enable_og_tags', 'enable_twitter_tags',
             'enable_schema', 'scan_content_for_schema', 'enable_advanced_schema', 'enable_schema_on_cpts', 'enable_schema_on_taxonomies','enable_organization_schema',
+            'enable_schema', 'scan_content_for_schema', 'enable_jumplinks_schema', 'enable_advanced_schema', 'enable_schema_on_cpts', 'enable_schema_on_taxonomies','enable_organization_schema',
             'enable_sitemaps', 'enable_sitemap_ping',
             'sitemap_include_images', 'sitemap_include_content_images',
 …
             'org_address_street', 'org_address_city', 'org_address_state', 'org_address_zip', 'org_address_country',
             'org_phone', 'org_email', 'org_area_served',
+            'youtube_api_key',
         ];
         foreach ($text_fields as $tf) {
 …
     <?php
+}
+    // UPDATED: Custom renderer for the Advanced Schema Checkbox
+    public function render_advanced_schema_checkbox() {
+        $id = 'enable_advanced_schema';
+        $checked = seo44_get_option($id);
+        // Output the standard checkbox
+        printf(
+            '<label for="%s"><input type="checkbox" id="%s" name="seo44_settings[%s]" value="1" %s /> %s</label>',
+            esc_attr($id),
+            esc_attr($id),
+            esc_attr($id),
+            checked($checked, 1, false),
+            esc_html__('Scan content for patterns to generate FAQ and How-To schema.', 'search-appearance-toolkit-seo-44')
+        );
+        seo44_render_tooltip('If special formats are detected, they will be added to your page\'s schema structured data.');
+        // Add the new recommendation text with the link
+        echo '<p class="description">';
+        echo esc_html__('For the most robust HowTo Schema, use a Jump Links Blocks for your How To steps. ', 'search-appearance-toolkit-seo-44');
+        echo '<a href="https://seo44plugin.com/search-appearance-toolkit-seo-44/schema-structured-data/" target="_blank">' . esc_html__('(Learn more)', 'search-appearance-toolkit-seo-44') . '</a>';
+        echo '</p>';
+    }
     public function render_textarea_field($args) {
 …
         echo '<p class="description">' . esc_html__('These tags are used to prove you own your site to search engines. Paste in your verification codes here and they will be added to your site\'s <head>.', 'search-appearance-toolkit-seo-44') . '</p>';
+    }
+    public function render_site_apis_header_field() {
+        echo '<h3>' . esc_html__('Site APIs', 'search-appearance-toolkit-seo-44') . '</h3>';
+        echo '<p class="description">' . esc_html__('Adding a YouTube API key fetches accurate video upload dates for schema structured data. Without this, video upload dates may fall back to your post publication date.', 'search-appearance-toolkit-seo-44') . '</p>';
+    }
+    public function render_youtube_api_key_field($args) {
+        $value = seo44_get_option('youtube_api_key');
+        $tooltip = isset($args['tooltip']) ? $args['tooltip'] : '';
+        ?>
+        <input type="text"
+               id="youtube_api_key"
+               name="seo44_settings[youtube_api_key]"
+               value="<?php echo esc_attr($value); ?>"
+               class="regular-text code">
+        <?php if ($tooltip) { seo44_render_tooltip($tooltip); } ?>
+        <p class="description">
+            <?php esc_html_e('Enter your YouTube Data API v3 key.', 'search-appearance-toolkit-seo-44'); ?>
+            <a href="https://developers.google.com/youtube/v3/getting-started" target="_blank">
+                <?php esc_html_e('Get API Key', 'search-appearance-toolkit-seo-44'); ?>
+            </a>
+        </p>
+        <?php
+    }
     public function settings_page_html() {
 …
             return;
+        }
         // --- START: SECURE TAB SWITCHING LOGIC ---

search-appearance-toolkit-seo-44/tags/4.3/js/admin-script.js

-                      r3389330
+                      r3423355
 jQuery(document).ready(function($) {
     // --- NEW: Add custom class to metabox heading ---
+    // --- Add custom class to metabox heading ---
     // Find the metabox by its ID and then find the title element inside it.
     var metabox = $('#seo44_meta_box');
 …
         metabox.find('h2.hndle').addClass('seo44-metabox-heading');
+    }
+    // --- "Use Example" Title Button ---
+    $('#seo44-use-example-title').on('click', function() {
+        var exampleText = $('#seo44-title-example').text();
+        var titleInput = $('#seo44_title');
+        titleInput.val(exampleText);
+        // Trigger the keyup event to update the snippet preview and character counter
+        titleInput.trigger('keyup');
+    });
     // --- Character Counter Functionality (from v1.4) ---
 …
     createCounter('seo44_description', 'seo44_description_char_count', 160);
+    // --- NEW: "Use Example" Title Button ---
+    $('#seo44-use-example-title').on('click', function() {
+        var exampleText = $('#seo44-title-example').text();
+        var titleInput = $('#seo44_title');
+        titleInput.val(exampleText);
+    // --- HowTo Schema Trigger Logic ---
+    const howToWrapper = $('#seo44-howto-trigger-wrapper');
+    const howToCheckbox = $('#seo44_enable_howto');
+    const descriptionField = $('#seo44_description');
+    // List of triggers (lowercase)
+    const triggers = ['step guide', 'step-by-step', 'how to', 'how-to', 'guide', 'walkthrough', 'directions', 'instructions', 'tutorial'];
+    // Flag to track if user has manually overridden the automation
+    let userHasInteracted = false;
+    // Listen for manual clicks
+    howToCheckbox.on('change', function() {
+        userHasInteracted = true;
+    });
+    function checkHowToTriggers() {
+        // 1. If user manually touched the box, do nothing.
+        if (userHasInteracted) return;
+        // 2. Get description text
+        const text = descriptionField.val().toLowerCase();
+        // Trigger the keyup event to update the snippet preview and character counter
+        titleInput.trigger('keyup');
+    });
+        // 3. Check for triggers
+        const hasTrigger = triggers.some(trigger => text.includes(trigger));
+        if (hasTrigger) {
+            // Found a trigger!
+            howToWrapper.show(); // Make visible
+            // Only check it if it wasn't already checked (to avoid redundant events)
+            if (!howToCheckbox.is(':checked')) {
+                howToCheckbox.prop('checked', true);
+            }
+        } else {
+            // No trigger found.
+            // Behavior: If we are purely automated (user hasn't clicked),
+            // we hide it and uncheck it.
+            howToWrapper.hide();
+            howToCheckbox.prop('checked', false);
+        }
+    }
+    // Run on keyup in description
+    descriptionField.on('keyup change paste', checkHowToTriggers);
+    // Run once on load to handle pre-filled content (if user hasn't saved yet)
+    // We delay slightly to ensure values are populated
+    setTimeout(function() {
+        // Only run auto-check if the box is currently hidden/unchecked.
+        // If it's already visible/checked from DB, we respect that state.
+        if (!howToCheckbox.is(':checked')) {
+            checkHowToTriggers();
+        } else {
+            // If it IS checked from DB, mark as "interacted" so we don't auto-uncheck it
+            // just because the user edits the description and removes a keyword.
+            userHasInteracted = true;
+        }
+    }, 500);
     // --- Snippet Preview Functionality ---
     const titleInput = $('#seo44_title');
     const descriptionInput = $('#seo44_description');
     const previewHeaderUrl = $('.seo44-preview-breadcrumb-url');
     const previewTitle = $('.seo44-preview-title');
 …
     const siteName = seo44_data.site_name;
     const permalink = seo44_data.permalink;
     function updatePreview() {
         // Update Title
         let titleVal = titleInput.val();
+        previewTitle.text(titleVal ? titleVal : defaultTitle);
+       // if (titleVal) {
+       //     previewTitle.text(titleVal);
+       // } else {
+            // If the input is empty, show "Post Title - Site Name"
+        //    previewTitle.text(defaultTitle + ' - ' + siteName);
+        //}
+        previewTitle.text(titleVal ? titleVal : defaultTitle);
         // Update Description
 …
             previewDescription.text('Enter a meta description to see how it will appear in search results...');
+        }
         // Update Breadcrumb URL
+        // Update Breadcrumb URL
         let breadcrumb = permalink.replace(/^https?:\/\//, '').replace(/\/$/, '');
         breadcrumb = breadcrumb.replace(/\//g, ' &rsaquo; '); // &rsaquo; is the > symbol

search-appearance-toolkit-seo-44/tags/4.3/readme.txt

-                      r3405454
+                      r3423355
 Tags: seo, on-page seo, schema, structured data, xml sitemaps
 Requires at least: 5.5
 Tested up to: 6.8
 Stable tag: 4.2
+Tested up to: 6.9
+Stable tag: 4.3
 Requires PHP: 7.4
 License: GPLv2 or later
 …
 * **Knowledge Graph Control:** A dedicated interface to manage your brand's digital identity. Define your Founder, Founding Date, Contact Info, and professional Credentials to improve E-E-A-T signals.
 * **Include Images and Videos:** A built-in tool automatically finds all images and embedded YouTube videos in your content and adds them to the schema, boosting their appearance in search results.
+* **FAQ and How-To Detection:** Enable a smart scanner to detect patterns in your content for FAQ and How-To sections on your website and incorporate this useful format into the schema.
+* **FAQ and How-To Detection:** Enable smart scanners to detect patterns in your content for FAQ and How-To sections on your website and incorporate this useful format into the schema.
+* **Jump Links HowTo Scanner:** The plugin can use a Jump Links Block as a "Map" to generate detailed HowTo schema steps, while simultaneously scanning your content for Prep Time, Yield, Supplies, and Tools.
+* **Table of Contents Schema:** Automatically generates `hasPart` structured data that mirrors your Jump Links Block, helping search engines understand your article's deep structure.
 * **Modern Output:** All structured data is generated in the modern JSON-LD format preferred by search engines, following the guidelines set by [Schema.org](https://schema.org/).
 * **Granular Control:**  Tailor the Schema settings to fit your site's needs through Enable/disable settings, including on Custom Post Types and Taxonomies.
 …
 The Search Appearance Toolkit serves as a hub for connecting your site to essential third-party services, helping you to create valuable analytics data and site insights.
-= Site Verification =
-Verify your site with search engines quickly and easily. Paste your verification codes for **Google Search Console** and **Bing Webmaster Tools** into the corresponding fields in the Integrations tab. The plugin handles the rest, adding site verification meta tags to your website's head. No coding required.
 = Google Tag Manager (GTM) Integration =
 Easily integrate with Google Tag Manager by pasting your `GTM-XXXXXXX` ID into the settings field. The plugin will correctly and safely inject the GTM scripts into your site's `<head>` and `<body>` on every page. No coding required.
 …
 * **Jump Link Click Tracking:** Tracks engagement with your Jump Links Block by pushing a `jump_link_click` event, letting you see which sections your users are most interested in.
+SEO 44's integration with Google Tag Manager pushes valuable events to the `dataLayer` for use in Google Analytics. The plugin includes an import file and detailed [Instructions for setting up Google Tag Manager and Google Analytics to receive event-tracking data](https://seo44plugin.com/search-appearance-toolkit-seo-44/integrations-setup-guide/).
+SEO 44's integration with Google Tag Manager pushes valuable events to the `dataLayer` for use in Google Analytics. The plugin includes an import file and detailed [Instructions for setting up Google Tag Manager and Google Analytics to receive event-tracking data](https://seo44plugin.com/search-appearance-toolkit-seo-44/integrations-setup-guide/).
+= Site Verification =
+Verify your site with search engines quickly and easily. Paste your verification codes for **Google Search Console** and **Bing Webmaster Tools** into the corresponding fields in the Integrations tab. The plugin handles the rest, adding site verification meta tags to your website's head. No coding required.
+= YouTube Data API =
+To ensure that your site's video schema is as accurate as possible, you may add your YouTube Data API Key.  The plugin uses this key to fetch the upload date for any YouTube video embedded in your content, replacing less reliable page scraping options and fallbacks to the post publish date.
 == Frequently Asked Questions ==
 …
 Search Appearance Toolkit (SEO 44) gives you control over the technical, on-page SEO factors that help search engines understand and rank your content. Key benefits include:
 * **Optimized Snippets:** Control how your titles and descriptions appear in search results.
 * **Rich Results:** The advanced Schema.org data helps you earn rich results like FAQs, How-Tos, and breadcrumbs in Google.
+* **Rich Results:** The advanced Schema.org data improves indexing and helps you earn rich results in Google.
 * **Crawlability:** A clean and comprehensive XML sitemap ensures search engines can find and index all of your important content and images.
 * **User Engagement:** The Jump Links Block improves user experience, which is a positive ranking signal, and can help you earn "Jump to" links in search results.
 …
 SEO 44 helps your content look great when shared on social media platforms. You can enable the automatic generation of **Open Graph** (og:) tags, which Facebook, LinkedIn, and Pinterest use, and **Twitter Card** meta tags for when your content appears on X (formerly Twitter). This ensures your posts have the correct title, description, and preview image when shared.
 Use the plugin's Google Tag Manager Integration to facilitate additional connections with soclal media platforms. Use the Organization Schema settings to associate all of your social media profiles with your website.
+Use the plugin's Google Tag Manager Integration to facilitate additional connections with social media platforms. Use the Organization Schema settings to associate all of your social media profiles with your website.
 = How are social media images handled? =
 …
 = What are the benefits of using FAQPage and HowTo schema? =
 The plugin intelligently scans your content for patterns that match question-and-answer formats or step-by-step instructions (when this option is enabled). The plugin locates this content and automatically generates FAQPage or HowTo schema that presents this content within the JSON-LD.
 The benefit of this is that Google can use this structured data to display your content in special, highly visible formats in the search results. An FAQ page might appear as a rich snippet with expandable questions, while a How-To article can be featured in a step-by-step guide. Rich snippets make your search results stand out, which can significantly improve your click-through rate (CTR).
+The plugin intelligently scans your content for patterns that match question-and-answer formats or step-by-step instructions (when this option is enabled). The plugin locates this content and automatically generates FAQPage or HowTo schema that presents this content as structured data.
+The benefit of this is that Google can use this structured data to display your content in special, highly visible formats in the search results. An FAQ page might appear as a rich snippet with expandable questions or feature within a People Also Ask (PAA) result, while a How-To article can be featured in a step-by-step guide in AI Overviews. Search results that stand out can improve your click-through rate (CTR).
 Read more about the [FAQPage and HowTo Schema](https://seo44plugin.com/search-appearance-toolkit-seo-44/schema-structured-data/#benefits-of-faqpage-and-howto-schema) created by SEO 44.
 …
     * **Google:** [Terms of Service](https://policies.google.com/terms), [Privacy Policy](https://policies.google.com/privacy)
     * **Bing (Microsoft):** [Microsoft Services Agreement](https://www.microsoft.com/en-us/servicesagreement/), [Microsoft Privacy Statement](https://privacy.microsoft.com/en-us/privacystatement)
+= YouTube Data API Integration & Video Metadata =
+* **Service Description:** This plugin connects to YouTube to fetch the "Upload Date" for videos embedded in your content. This ensures your VideoObject schema is accurate.
+* **Data Sent and Conditions:**
+    * **Method 1 (API):** If you provide a YouTube API Key in settings, the plugin sends the Video ID to the Google Data API.
+    * **Method 2 (Public Fallback):** If no API Key is present, the plugin acts as a standard browser and fetches the public video page (via `wp_remote_get`) to locate the upload date in the page meta tags.
+    * **Conditions:** This occurs automatically when a post with a YouTube embed is updated, provided that Schema generation is enabled.
+* **Service Provider Links:**
+    * **YouTube:** [Terms of Service](https://www.youtube.com/t/terms), [Google Privacy Policy](https://policies.google.com/privacy)
 == Screenshots ==
 …
 == Changelog ==
+= 4.3.0 =
+* FEATURE: **Table of Contents Schema:** Automatically generates `hasPart` schema synchronized with the Jump Links Block to support "Jump-to" links in search results.
+* FEATURE: **Advanced HowTo Schema:** A new "Block-Aware" scanner uses the Jump Links Block to strictly define steps while intelligently mining the introduction for tools, time, yield, and video data.
+* TWEAK: Added a "Generate HowTo Schema" checkbox to the SEO 44 metabox, giving users explicit control over when the advanced scanner runs.
+* FEATURE: **YouTube Integration:** Added support for the YouTube Data API v3 to fetch accurate video upload dates for VideoObject schema.
+* TESTED: Tested to WordPress Version 6.9
 = 4.2.0 =
 * FEATURE: **Rich Organization Schema:** Added a comprehensive settings section to generate Organization structured data for the Knowledge Graph.
 …
 * TWEAK: Updated the image uploader JavaScript to support multiple distinct upload buttons on the settings page.
-= 4.1.0 =
-**Jump Links Block Updates:**
-* FEATURE: **Sticky Positioning:** Keep your table of contents visible while users scroll. Includes a "Top Offset" slider to clear sticky headers, a "Jump Offset" slider to ensure that the sticky header does not cover the heading text, and a "Disable on Mobile" toggle to preserve screen space on small devices.
-* FEATURE: **Auto-Hide Title:** Implemented a smart "sticky state" detection. When the block sticks, the title gently collapses and fades out to keep the interface clean (this occurs when a block title is used alongside sticky positioning).
-* FEATURE: **Smart Indentation:** Added a "Create Visual Hierarchy" toggle. When enabled, H3 and H4 sub-headings are visually indented to create a clear, nested outline structure.
-* FEATURE: **Block Background:** You can now set a background color for the entire block container, perfect for creating "card-style" floating navigation.
-* FEATURE: **ScrollSpy:** Automatically highlights the active link in the table of contents as the user scrolls through the corresponding section of the post.
-* FEATURE: Added support for Border and Spacing controls. You can now add borders, rounded corners, margins, and padding to the Jump Links block directly from the editor settings.
-* FEATURE: Added a "Title tag" control. You can now choose the specific HTML tag (H2, H3, H4, H5, Paragraph, or Div) for the "On This Page" heading to better match your document structure.
-* REFACTOR: Optimized the block's styling logic to use CSS variables on the parent container instead of inline styles for every link. This reduces the block's HTML size and improves rendering performance.
-* FIX: Resolved an accessibility and HTML validation issue where using multiple Jump Links blocks on a single page created duplicate element IDs. Each block now generates a unique instance ID.
-* PERFORMANCE: Refactored the front-end JavaScript to use event delegation for smooth scrolling. This reduces memory usage by attaching a single event listener to the block instead of individual listeners for every link.
-* TWEAK: Reorganized the sidebar settings for better clarity between Block Title settings and Content Inclusion settings.
-= 4.0.0 =
-* FEATURE: Added a new "Integrations" tab for third-party services like Google Tag Manager and Webmaster Tools.
-* FEATURE: Added Google Tag Manager (GTM) integration. The plugin can now automatically inject the GTM container script into the site's <head> and <body> based on your ID.
-* FEATURE: Added Webmaster Verification. You can now add your Google Search Console and Bing Webmaster Tools verification codes directly from the plugin settings.
-* FEATURE: Added automatic GTM event tracking. When enabled, the plugin can push the following events to the dataLayer:
-    * Rich SEO dataLayer: Pushes page type, category, author, and tags on page load for advanced GTM triggers.
-    * Scroll Depth Tracking: Pushes 'scroll_depth' events at 25%, 50%, 75%, and 100% of the page.
-    * External & Affiliate Clicks:* Pushes 'external_link_click' or 'affiliate_link_click' (for `rel="sponsored"` links).
-    * Jump Link Clicks: Pushes a 'jump_link_click' event when a user clicks a link in the Jump Links Block.
-* FEATURE: Added a Google Tag Manager recipe import file (`seo44-gtm-recipe-importer.json`) and new FAQ instructions to fully configure GTM and GA4 event tracking.
-* ENHANCEMENT: Centralized all GTM event tracking into a new, efficient `global-tracker.js` file that uses event delegation for better performance.
-* TWEAK: Improved the "Integrations" settings page UI for clarity, adding clarifying tooltips and a file downloader.
 For a complete list of changes, please see the [full changelog](https://seo44plugin.com/search-appearance-toolkit-seo-44/changelog/) or the `changelog.txt` file included with the plugin.

search-appearance-toolkit-seo-44/tags/4.3/seo-44.php

-                      r3405454
+                      r3423355
  * Plugin URI:        https://www.sethcreates.com/plugins-for-wordpress/search-appearance-toolkit-seo-44/
  * Description:       A lightweight, powerful SEO plugin for essential meta tags, advanced schema, XML sitemaps, jump links, and easy migration from other plugins.
  * Version:           4.2.0
+ * Version:           4.3
  * Author:            Seth Smigelski
  * Author URI:        https://www.sethcreates.com/plugins-for-wordpress/
 …
 if ( ! defined( 'ABSPATH' ) ) exit; // Exit if accessed directly
 define( 'SEO44_VERSION', '4.2.0' );
+define( 'SEO44_VERSION', '4.3' );
 define( 'SEO44_PLUGIN_URL', plugin_dir_url( __FILE__ ) );

search-appearance-toolkit-seo-44/trunk/README.md

-                      r3405454
+                      r3423355
 * **Tags:** seo, on-page seo, schema, structured data, xml sitemaps
 * **Requires at least:** 5.5
 * **Tested up to:** 6.8
 * **Stable tag:** 4.2.0
+* **Tested up to:** 6.9
+* **Stable tag:** 4.3.0
 * **Requires PHP:** 7.4
 * **License:** GPLv2 or later
 …
 * **Knowledge Graph Control:** A dedicated interface to manage your brand's digital identity. Define your Founder, Founding Date, Contact Info, and professional Credentials to improve E-E-A-T signals.
 * **Include Images and Videos:** A built-in tool automatically finds all images and embedded YouTube videos in your content and adds them to the schema, boosting their appearance in search results.
+* **FAQ and How-To Detection:** Enable a smart scanner to detect patterns in your content for FAQ and How-To sections on your website and incorporate this useful format into the schema.
+* **FAQ and How-To Detection:** Enable smart scanners to detect patterns in your content for FAQ and How-To sections on your website and incorporate this useful format into the schema.
+* **Jump Links HowTo Scanner:** The plugin can use a Jump Links Block as a "Map" to generate detailed HowTo schema steps, while simultaneously scanning your content for Prep Time, Yield, Supplies, and Tools.
+* **Table of Contents Schema:** Automatically generates `hasPart` structured data that mirrors your Jump Links Block, helping search engines understand your article's deep structure.
 * **Modern Output:** All structured data is generated in the modern JSON-LD format preferred by search engines, following the guidelines set by [Schema.org](https://schema.org/).
 * **Granular Control:**  Tailor the Schema settings to fit your site's needs through Enable/disable settings, including on Custom Post Types and Taxonomies.
 …
 SEO 44's integration with Google Tag Manager pushes valuable events to the `dataLayer` for use in Google Analytics. The plugin provides an import file and detailed instructions for setting up Google Tag Manager and Google Analytics to receive event tracking data.
 ## Site Verification Tags
+### Site Verification Tags
 Verify your site with search engines quickly and easily. Paste your verification codes for **Google Search Console** and **Bing Webmaster Tools** into the corresponding fields in the Integrations tab. The plugin handles the rest, adding site verification meta tags to your website's head. No coding required.
+### YouTube Data API
+To ensure that your site's video schema is as accurate as possible, you may add your YouTube Data API Key.  The plugin uses this key to fetch the upload date for any YouTube video embedded in your content, replacing less reliable page scraping options and fallbacks to the post publish date.
 ---
 …
 Search Appearance Toolkit (SEO 44) gives you control over the technical, on-page SEO factors that help search engines understand and rank your content. Key benefits include:
 * **Optimized Snippets:** Control how your titles and descriptions appear in search results.
 * **Rich Results:** The advanced Schema.org data helps you earn rich results like FAQs, How-Tos, and breadcrumbs in Google.
+* **Rich Results:** The advanced Schema.org data improves indexing and helps you earn rich results in Google.
 * **Crawlability:** A clean and comprehensive XML sitemap ensures search engines can find and index all of your important content and images.
 * **User Engagement:** The Jump Links Block improves user experience, which is a positive ranking signal, and can help you earn "Jump to" links in search results.
 …
 SEO 44 helps your content look great when shared on social media platforms. You can enable the automatic generation of **Open Graph** (og:) tags, which Facebook, LinkedIn, and Pinterest use, and **Twitter Card** meta tags for when your content appears on X (formerly Twitter). This ensures your posts have the correct title, description, and preview image when shared.
 Use the plugin's Google Tag Manager Integration to facilitate additional connections with soclal media platforms. Use the Organization Schema settings to associate all of your social media profiles with your website.
+Use the plugin's Google Tag Manager Integration to facilitate additional connections with social media platforms. Use the Organization Schema settings to associate all of your social media profiles with your website.
 ### How are social media images handled?
 …
 ### What are the benefits of using FAQPage and HowTo schema?
 The plugin intelligently scans your content for patterns that match question-and-answer formats or step-by-step instructions (when this option is enabled). The plugin locates this content and automatically generates FAQPage or HowTo schema that presents this content within the JSON-LD.
 The benefit of this is that Google can use this structured data to display your content in special, highly visible formats in the search results. An FAQ page might appear as a rich snippet with expandable questions, while a How-To article can be featured in a step-by-step guide. Rich snippets make your search results stand out, which can significantly improve your click-through rate (CTR).
+The plugin intelligently scans your content for patterns that match question-and-answer formats or step-by-step instructions (when this option is enabled). The plugin locates this content and automatically generates FAQPage or HowTo schema that presents this content as structured data.
+The benefit of this is that Google can use this structured data to display your content in special, highly visible formats in the search results. An FAQ page might appear as a rich snippet with expandable questions or feature within a People Also Ask (PAA) result, while a How-To article can be featured in a step-by-step guide in AI Overviews. Search results that stand out can improve your click-through rate (CTR).
 Read more about the [FAQPage and HowTo Schema](https://seo44plugin.com/search-appearance-toolkit-seo-44/schema-structured-data/#benefits-of-faqpage-and-howto-schema) created by SEO 44.
 …
     * **Google:** [Terms of Service](https://policies.google.com/terms), [Privacy Policy](https://policies.google.com/privacy)
     * **Bing (Microsoft):** [Microsoft Services Agreement](https://www.microsoft.com/en-us/servicesagreement/), [Microsoft Privacy Statement](https://privacy.microsoft.com/en-us/privacystatement)
+### YouTube Data API Integration & Video Metadata
+* **Service Description:** This plugin connects to YouTube to fetch the "Upload Date" for videos embedded in your content. This ensures your VideoObject schema is accurate.
+* **Data Sent and Conditions:**
+    * **Method 1 (API):** If you provide a YouTube API Key in settings, the plugin sends the Video ID to the Google Data API.
+    * **Method 2 (Public Fallback):** If no API Key is present, the plugin acts as a standard browser and fetches the public video page (via `wp_remote_get`) to locate the upload date in the page meta tags.
+    * **Conditions:** This occurs automatically when a post with a YouTube embed is updated, provided that Schema generation is enabled.
+* **Service Provider Links:**
+    * **YouTube:** [Terms of Service](https://www.youtube.com/t/terms), [Google Privacy Policy](https://policies.google.com/privacy)
 ---
 …
 ## Changelog
+### 4.3.0
+* **FEATURE:** **Table of Contents Schema:** Automatically generates `hasPart` schema synchronized with the Jump Links Block to support "Jump-to" links in search results.
+* **FEATURE:** **Advanced HowTo Schema:** A new "Block-Aware" scanner uses the Jump Links Block to strictly define steps while intelligently mining the introduction for tools, time, yield, and video data.
+* **TWEAK:** Added a "Generate HowTo Schema" checkbox to the SEO 44 metabox, giving users explicit control over when the advanced scanner runs.
+* **FEATURE:** **YouTube Integration:** Added support for the YouTube Data API v3 to fetch accurate video upload dates for VideoObject schema.
+* **TESTED:** Tested to WordPress Version 6.9
 ### 4.2.0
 …
 * **TWEAK:** Updated the image uploader JavaScript to support multiple distinct upload buttons on the settings page.
-### 4.1.0
-**Jump Links Block Updates:**
-* **FEATURE:** **Sticky Positioning:** Keep your table of contents visible while users scroll. Includes a "Top Offset" slider to clear sticky headers, a "Jump Offset" slider to ensure that the sticky header does not cover the heading text, and a "Disable on Mobile" toggle to preserve screen space on small devices.
-* **FEATURE:** **Auto-Hide Title:** Implemented a smart "sticky state" detection. When the block sticks, the title gently collapses and fades out to keep the interface clean (this occurs when a block title is used alongside sticky positioning).
-* **FEATURE:** **Smart Indentation:** Added a "Create Visual Hierarchy" toggle. When enabled, H3 and H4 sub-headings are visually indented to create a clear, nested outline structure.
-* **FEATURE:** **Block Background:** You can now set a background color for the entire block container, perfect for creating "card-style" floating navigation.
-* **FEATURE:** **ScrollSpy:** Automatically highlights the active link in the table of contents as the user scrolls through the corresponding section of the post.
-* **FEATURE:** Added support for Border and Spacing controls. You can now add borders, rounded corners, margins, and padding to the Jump Links block directly from the editor settings.
-* **FEATURE:** Added a "Title tag" control. You can now choose the specific HTML tag (H2, H3, H4, H5, Paragraph, or Div) for the "On This Page" heading to better match your document structure.
-* **REFACTOR:** Optimized the block's styling logic to use CSS variables on the parent container instead of inline styles for every link. This reduces the block's HTML size and improves rendering performance.
-* **FIX:** Resolved an accessibility and HTML validation issue where using multiple Jump Links blocks on a single page created duplicate element IDs. Each block now generates a unique instance ID.
-* **PERFORMANCE:** Refactored the front-end JavaScript to use event delegation for smooth scrolling. This reduces memory usage by attaching a single event listener to the block instead of individual listeners for every link.
-* **TWEAK:** Reorganized the sidebar settings for better clarity between Block Title settings and Content Inclusion settings.
-### 4.0.0
-* **FEATURE:** Added a new "Integrations" tab for third-party services like Google Tag Manager and Webmaster Tools.
-* **FEATURE:** Added Google Tag Manager (GTM) integration. The plugin can now automatically inject the GTM container script into the site's <head> and <body> based on your ID.
-* **FEATURE:** Added Webmaster Verification. You can now add your Google Search Console and Bing Webmaster Tools verification codes directly from the plugin settings.
-* **FEATURE:** Added automatic GTM event tracking. When enabled, the plugin can push the following events to the dataLayer:
-    * Rich SEO dataLayer: Pushes page type, category, author, and tags on page load for advanced GTM triggers.
-    * Scroll Depth Tracking: Pushes 'scroll_depth' events at 25%, 50%, 75%, and 100% of the page.
-    * External & Affiliate Clicks:* Pushes 'external_link_click' or 'affiliate_link_click' (for `rel="sponsored"` links).
-    * Jump Link Clicks: Pushes a 'jump_link_click' event when a user clicks a link in the Jump Links Block.
-* **FEATURE:** Added a Google Tag Manager recipe import file (`seo44-gtm-recipe-importer.json`) and new FAQ instructions to fully configure GTM and GA4 event tracking.
-* **ENHANCEMENT:** Centralized all GTM event tracking into a new, efficient `global-tracker.js` file that uses event delegation for better performance.
-* **TWEAK:** Improved the "Integrations" settings page UI for clarity, adding clarifying tooltips and a file downloader.
-For a complete list of changes, please see the [full changelog](https://github.com/SethSmigelski/search-appearance-toolkit-seo-44/blob/main/changelog.txt) or the `changelog.txt` file included with the plugin.
 ---

search-appearance-toolkit-seo-44/trunk/build/index.asset.php

r3405454	r3423355
1		<?php return array('dependencies' => array('react', 'wp-block-editor', 'wp-blocks', 'wp-components', 'wp-data', 'wp-element', 'wp-i18n'), 'version' => '~~9e72772c3731a4c27337~~');
	1	<?php return array('dependencies' => array('react', 'wp-block-editor', 'wp-blocks', 'wp-components', 'wp-data', 'wp-element', 'wp-i18n'), 'version' => '2c1769c1ec087de88890');

search-appearance-toolkit-seo-44/trunk/build/index.js

r3403604	r3423355
1		(()=>{"use strict";var e,t={313~~:()=>~~{const e=window.wp.blocks,t=window.React,a=window.wp.i18n,o=window.wp.blockEditor,l=window.wp.components,n=window.wp.data,r=window.wp.element;function s(e){return(new DOMParser).parseFromString(e,"text/html").body.textContent\|\|""}const i=(0,t.createElement)("svg",{viewBox:"0 0 24 24",xmlns:"http://www.w3.org/2000/svg","aria-hidden":"true",focusable:"false"},(0,t.createElement)("path",{d:"M3 21v-2h18v2zm8-4v-6.175L9.4 12.4L8 11l4-4l4 4l-1.4 1.4l-1.6-1.575V17zM3 5V3h18v2z"})),c=(0,t.createElement)("svg",{viewBox:"0 0 24 24",xmlns:"http://www.w3.org/2000/svg","aria-hidden":"true",focusable:"false"},(0,t.createElement)("path",{d:"M3 5V3h18v2zm9 12l-4-4l1.4-1.4l1.6 1.575V7h2v6.175l1.6-1.575L16 13zm-9 4v-2h18v2z"})),h=(0,t.createElement)("svg",{className:"arrow-down",width:"24",height:"24",viewBox:"0 0 24 24",xmlns:"http://www.w3.org/2000/svg","aria-hidden":"true",focusable:"false"},(0,t.createElement)("path",{d:"M12 16l-6-6 1.41-1.41L12 13.17l4.59-4.58L18 10l-6 6z"})),p=JSON.parse('{"UU":"seo44/jump-links"}');(0,e.registerBlockType)(p.UU,{edit:function({attributes:e,setAttributes:p}){const{headingLevels:k,headings:u,showHeading:d,headingText:m,headingTag:g,layout:_,listStyle:b,isEditing:v,isCollapsible:f,isSmartIndentation:x,fontSize:w,textColor:C,linkColor:E,blockBackgroundColor:y,linkBackgroundColor:B,linkBackgroundColorHover:S,linkBorderColor:z,linkBorderRadius:T,isSticky:N,stickyOffset:H,jumpOffset:M,stickyStrategy:P}=e,O={color:C,fontSize:w,"--jump-link-font-size":w\|\|"18px","--seo44-link-color":E,"--seo44-link-bg":"horizontal"===_?B:void 0,"--seo44-link-hover-bg":"horizontal"===_?S:void 0,"--seo44-link-border-color":"horizontal"===_?z:void 0,"--seo44-link-radius":"horizontal"===_&&T?`${T}px`:void 0,"--seo44-block-bg":y,"--seo44-sticky-offset":N?`${H}px`:void 0},I="ol"===b?"ol":"ul",{createInfoNotice:L}=(0,n.useDispatch)("core/notices"),j=e.blockInstanceId?`seo44-jump-links-list-${e.blockInstanceId}`:"seo44-jump-links-list",$=(0,o.useBlockProps)({style:O});$.className=`${$.className} ${"horizontal"===_?"is-layout-horizontal":""} ${f&&!v?"is-collapsible":""} ${"none"===b?"list-style-none":""}`.trim();const D=(0,n.useSelect)(e=>e("core/block-editor").getBlocks(),[]),{updateBlockAttributes:V}=(0,n.useDispatch)("core/block-editor");(0,r.useEffect)(()=>{const t={};e.blockInstanceId\|\|(t.blockInstanceId=Math.random().toString(36).substr(2,9)),Object.keys(t).length>0&&p(t);const o=D.filter(e=>"core/heading"===e.name&&k.includes(`h${e.attributes.level}`)),l=new Set;let n=!1;const r=new Map(u.map(e=>[e.anchor,e])),i=[];for(const e of o){const t=s(e.attributes.content);let a=e.attributes.anchor\|\|t.toLowerCase().replace(/[^a-z0-9\s-]/g,"").trim().replace(/\s+/g,"-"),o=a,c=2;for(;l.has(o);)o=`${a}-${c}`,c++,n=!0;l.add(o),e.attributes.anchor!==o&&V(e.clientId,{anchor:o});const h=r.get(e.attributes.anchor)\|\|r.get(o),p=h&&h.linkText!==h.text?h.linkText:t,k=!h\|\|h.isVisible;i.push({anchor:o,text:t,linkText:p,isVisible:k,level:e.attributes.level})}JSON.stringify(i)!==JSON.stringify(u)&&p({headings:i}),n&&L((0,a.__)("Jump Links Block: Duplicate headings were found. Unique IDs have been auto-generated, but this may be a sign of redundancy. Please review your headings for clarity.","search-appearance-toolkit-seo-44"),{type:"snackbar"})},[D,k,u,e.blockInstanceId,p,V,L]),(0,r.useEffect)(()=>{"horizontal"===_&&"none"!==b&&p({listStyle:"none"})},[_,b,p]);const R=(e,t)=>{const a=[...u],o=a.splice(e,1)[0];"up"===t?a.splice(e-1,0,o):a.splice(e+1,0,o),p({headings:a})},J=e=>{const t=k.includes(e)?k.filter(t=>t!==e):[...k,e];p({headingLevels:t.sort()})};return(0,t.createElement)(r.Fragment,null,(0,t.createElement)(o.InspectorControls,null,(0,t.createElement)(l.PanelBody,{title:(0,a.__)("Presentation","search-appearance-toolkit-seo-44")},(0,t.createElement)(l.ButtonGroup,null,(0,t.createElement)(l.Button,{isPrimary:!v,isPressed:!v,onClick:()=>p({isEditing:!1})},(0,a.__)("Viewing Mode","search-appearance-toolkit-seo-44")),(0,t.createElement)(l.Button,{isPrimary:v,isPressed:v,onClick:()=>p({isEditing:!0})},(0,a.__)("Editing Mode","search-appearance-toolkit-seo-44"))),(0,t.createElement)("p",{className:"description"},(0,a.__)("Switch to Editing Mode to customize link text, visibility, and order.","search-appearance-toolkit-seo-44"))),(0,t.createElement)(l.PanelBody,{title:(0,a.__)("Appearance","search-appearance-toolkit-seo-44")},(0,t.createElement)("p",null,(0,t.createElement)("strong",null,(0,a.__)("Layout","search-appearance-toolkit-seo-44"))),(0,t.createElement)(l.ButtonGroup,null,(0,t.createElement)(l.Button,{isPrimary:"vertical"===_,isPressed:"vertical"===_,onClick:()=>p({layout:"vertical"})},(0,a.__)("Vertical","search-appearance-toolkit-seo-44")),(0,t.createElement)(l.Button,{isPrimary:"horizontal"===_,isPressed:"horizontal"===_,onClick:()=>p({layout:"horizontal"})},(0,a.__)("Horizontal","search-appearance-toolkit-seo-44"))),(0,t.createElement)(l.ToggleControl,{label:(0,a.__)("Make Jump Links Area Expandable","search-appearance-toolkit-seo-44"),help:(0,a.__)('Conserve screen space by collapsing a long list of jump links, providing users with an elegant "show more" button to see the entire list.',"search-appearance-toolkit-seo-44"),checked:f,onChange:()=>p({isCollapsible:!f}),__nextHasNoMarginBottom:!0}),(0,t.createElement)(l.SelectControl,{label:(0,a.__)("List Style","search-appearance-toolkit-seo-44"),value:b,options:[{label:(0,a.__)("Bulleted","search-appearance-toolkit-seo-44"),value:"ul"},{label:(0,a.__)("Numbered","search-appearance-toolkit-seo-44"),value:"ol"},{label:(0,a.__)("None","search-appearance-toolkit-seo-44"),value:"none"}],onChange:e=>p({listStyle:e}),disabled:"horizontal"===_,__nextHasNoMarginBottom:!0,__next40pxDefaultSize:!0}),(0,t.createElement)(l.FontSizePicker,{fontSizes:[{name:(0,a.__)("S","search-appearance-toolkit-seo-44"),slug:"small",size:"14px"},{name:(0,a.__)("M","search-appearance-toolkit-seo-44"),slug:"normal",size:"17px"},{name:(0,a.__)("L","search-appearance-toolkit-seo-44"),slug:"large",size:"20px"},{name:(0,a.__)("XL","search-appearance-toolkit-seo-44"),slug:"extra-large",size:"23px"}],value:w,onChange:e=>p({fontSize:e}),withReset:!0,__next40pxDefaultSize:!0}),(0,t.createElement)(o.PanelColorSettings,{title:(0,a.__)("Colors","search-appearance-toolkit-seo-44"),colorSettings:[{value:y,onChange:e=>p({blockBackgroundColor:e}),label:(0,a.__)("Block Background","search-appearance-toolkit-seo-44")},{value:E,onChange:e=>p({linkColor:e}),label:(0,a.__)("Link Color","search-appearance-toolkit-seo-44")},{value:C,onChange:e=>p({textColor:e}),label:(0,a.__)("Other Text Color","search-appearance-toolkit-seo-44")}]}),"horizontal"===_&&(0,t.createElement)(r.Fragment,null,(0,t.createElement)("hr",null),(0,t.createElement)("p",null,(0,t.createElement)("strong",null,(0,a.__)("Horizontal Link Styles","search-appearance-toolkit-seo-44"))),(0,t.createElement)(o.PanelColorSettings,{title:(0,a.__)("Link Colors","search-appearance-toolkit-seo-44"),colorSettings:[{value:B,onChange:e=>p({linkBackgroundColor:e}),label:(0,a.__)("Background","search-appearance-toolkit-seo-44")},{value:S,onChange:e=>p({linkBackgroundColorHover:e}),label:(0,a.__)("Background Hover","search-appearance-toolkit-seo-44")},{value:z,onChange:e=>p({linkBorderColor:e}),label:(0,a.__)("Border","search-appearance-toolkit-seo-44")}]}),(0,t.createElement)(l.RangeControl,{label:(0,a.__)("Link Border Radius","search-appearance-toolkit-seo-44"),value:T,onChange:e=>p({linkBorderRadius:e}),min:0,max:50,__nextHasNoMarginBottom:!0,__next40pxDefaultSize:!0}))),(0,t.createElement)(l.PanelBody,{title:(0,a.__)("Content Settings","search-appearance-toolkit-seo-44")},(0,t.createElement)(l.ToggleControl,{label:(0,a.__)("Display Block Title","search-appearance-toolkit-seo-44"),checked:d,onChange:()=>p({showHeading:!d}),__nextHasNoMarginBottom:!0}),d&&(0,t.createElement)(r.Fragment,null,(0,t.createElement)(l.TextControl,{label:(0,a.__)("Title Text","search-appearance-toolkit-seo-44"),value:m,onChange:e=>p({headingText:e}),help:(0,a.__)("The text that appears above your list of links.","search-appearance-toolkit-seo-44")}),(0,t.createElement)(l.SelectControl,{label:(0,a.__)("Title Tag","search-appearance-toolkit-seo-44"),value:g,options:[{label:"H2",value:"h2"},{label:"H3",value:"h3"},{label:"H4",value:"h4"},{label:"H5",value:"h5"},{label:"Paragraph (Bold)",value:"p"},{label:"Div (No Semantic Value)",value:"div"}],onChange:e=>p({headingTag:e}),help:(0,a.__)("Choose a level that fits your page's structure.","search-appearance-toolkit-seo-44"),__nextHasNoMarginBottom:!0,__next40pxDefaultSize:!0})),(0,t.createElement)("hr",null),(0,t.createElement)("p",null,(0,t.createElement)("strong",null,(0,a.__)("Included Headings","search-appearance-toolkit-seo-44"))),(0,t.createElement)("p",{className:"description",style:{marginBottom:"10px"}},(0,a.__)("Select which heading levels from your post content should appear in the jump links list.","search-appearance-toolkit-seo-44")),(0,t.createElement)(l.CheckboxControl,{label:"H2",checked:k.includes("h2"),onChange:()=>J("h2")}),(0,t.createElement)(l.CheckboxControl,{label:"H3",checked:k.includes("h3"),onChange:()=>J("h3")}),(0,t.createElement)(l.CheckboxControl,{label:"H4",checked:k.includes("h4"),onChange:()=>J("h4")}),(0,t.createElement)(l.ToggleControl,{label:(0,a.__)("Create Visual Hierarchy","search-appearance-toolkit-seo-44"),help:(0,a.__)("Indents sub-headings (H3, H4) to create a nested outline structure.","search-appearance-toolkit-seo-44"),checked:x,onChange:()=>p({isSmartIndentation:!x}),__nextHasNoMarginBottom:!0})),(0,t.createElement)(l.PanelBody,{title:(0,a.__)("Position Settings","search-appearance-toolkit-seo-44")},(0,t.createElement)(l.ToggleControl,{label:(0,a.__)("Sticky Position","search-appearance-toolkit-seo-44"),help:(0,a.__)("Keep the table of contents visible while scrolling.","search-appearance-toolkit-seo-44"),checked:N,onChange:()=>p({isSticky:!N}),__nextHasNoMarginBottom:!0}),N&&(0,t.createElement)(r.Fragment,null,(0,t.createElement)("p",{className:"description",style:{marginBottom:"15px"}},(0,a.__)("Customize how the block behaves when it sticks to the top of the screen.","search-appearance-toolkit-seo-44")),(0,t.createElement)(l.RangeControl,{label:(0,a.__)("Top Offset (px)","search-appearance-toolkit-seo-44"),help:(0,a.__)("The distance between the top of the screen and the block when stuck (useful for clearing sticky headers).","search-appearance-toolkit-seo-44"),value:H,onChange:e=>p({stickyOffset:e}),min:0,max:200,__nextHasNoMarginBottom:!0,__next40pxDefaultSize:!0}),(0,t.createElement)(l.RangeControl,{label:(0,a.__)("Jump Offset (px)","search-appearance-toolkit-seo-44"),help:(0,a.__)("The buffer distance to stop before the heading. Increase this if your sticky header covers the text.","search-appearance-toolkit-seo-44"),value:M,onChange:e=>p({jumpOffset:e}),min:0,max:200,__nextHasNoMarginBottom:!0,__next40pxDefaultSize:!0}),(0,t.createElement)(l.ToggleControl,{label:(0,a.__)("Disable on Mobile","search-appearance-toolkit-seo-44"),help:(0,a.__)("Prevents the block from sticking on small screens to save reading space.","search-appearance-toolkit-seo-44"),checked:"desktop-only"===P,onChange:e=>p({stickyStrategy:e?"desktop-only":"always"}),__nextHasNoMarginBottom:!0})))),(0,t.createElement)("div",{...$},d&&(0,t.createElement)(o.RichText,{tagName:g,className:"wp-block-seo44-jump-links-heading",value:m,onChange:e=>p({headingText:e}),placeholder:(0,a.__)("On This Page","search-appearance-toolkit-seo-44")}),u.length>0?(0,t.createElement)("nav",{"aria-label":(0,a.__)("Table of contents","search-appearance-toolkit-seo-44")},(0,t.createElement)(I,{id:j},u.map((e,o)=>v?(0,t.createElement)("li",{key:e.anchor},(0,t.createElement)(l.TextControl,{value:e.linkText,onChange:e=>((e,t)=>{const a=[...u];a[e].linkText=t,p({headings:a})})(o,e)}),(0,t.createElement)("div",{className:"edit-controls-wrapper"},(0,t.createElement)("div",{className:"reorder-buttons"},(0,t.createElement)(l.Button,{icon:i,label:(0,a.__)("Move Up","search-appearance-toolkit-seo-44"),onClick:()=>R(o,"up"),disabled:0===o}),(0,t.createElement)(l.Button,{icon:c,label:(0,a.__)("Move Down","search-appearance-toolkit-seo-44"),onClick:()=>R(o,"down"),disabled:o===u.length-1})),(0,t.createElement)(l.ToggleControl,{label:!1!==e.isVisible?(0,a.__)("Included","search-appearance-toolkit-seo-44"):(0,a.__)("This Jump Link will not be shown","search-appearance-toolkit-seo-44"),checked:!1!==e.isVisible,onChange:()=>(e=>{const t=[...u];t[e].isVisible=!t[e].isVisible,p({headings:t})})(o),__nextHasNoMarginBottom:!0}))):!1!==e.isVisible&&(0,t.createElement)("li",{key:e.anchor,className:x?`seo44-jump-link-level-${e.level}`:""},(0,t.createElement)("a",{href:`#${e.anchor}`,onClick:e=>e.preventDefault()},e.linkText)))),!v&&f&&u.length>0&&(0,t.createElement)(l.Tooltip,{text:(0,a.__)("This button is functional on the front-end to expand the list.","search-appearance-toolkit-seo-44")},(0,t.createElement)("button",{type:"button",className:"seo-44-show-more","aria-label":(0,a.__)("Show More","search-appearance-toolkit-seo-44"),"aria-expanded":"false","aria-controls":j,onClick:()=>{L((0,a.__)('The "Show More" button is interactive on the published page.',"search-appearance-toolkit-seo-44"),{type:"snackbar"})}},h))):(0,t.createElement)("p",null,(0,a.__)("No headings found. Select a heading level in the block settings to generate links.","search-appearance-toolkit-seo-44"))))},save:function({attributes:e}){const{blockInstanceId:l,layout:n,isCollapsible:r,isSmartIndentation:s,headings:i,showHeading:c,headingText:h,headingTag:p,listStyle:k,fontSize:u,textColor:d,linkColor:m,blockBackgroundColor:g,linkBackgroundColor:_,linkBackgroundColorHover:b,linkBorderColor:v,linkBorderRadius:f,isSticky:x,stickyOffset:w,jumpOffset:C,stickyStrategy:E}=e,y={color:d,fontSize:u,"--jump-link-font-size":u\|\|"18px","--seo44-block-bg":g,"--seo44-link-color":m,"--seo44-link-bg":"horizontal"===n?_:void 0,"--seo44-link-hover-bg":"horizontal"===n?b:void 0,"--seo44-link-border-color":"horizontal"===n?v:void 0,"--seo44-link-radius":"horizontal"===n&&f?`${f}px`:void 0,"--seo44-sticky-offset":x?`${w}px`:void 0},B="ol"===k?"ol":"ul",S=`seo44-jump-links-list-${l}`,z=o.useBlockProps.save({className:`${"horizontal"===n?"is-layout-horizontal":""} ${r?"is-collapsible":""} ${"none"===k?"list-style-none":""} ${x?"is-sticky":""} ${"desktop-only"===E?"sticky-desktop-only":""}`.trim(),style:y,"data-seo44-jump-offset":x?C:30}),T=(0,t.createElement)("svg",{className:"arrow-down",width:"24",height:"24",viewBox:"0 0 24 24",xmlns:"http://www.w3.org/2000/svg","aria-hidden":"true",focusable:"false"},(0,t.createElement)("path",{d:"M12 16l-6-6 1.41-1.41L12 13.17l4.59-4.58L18 10l-6 6z"})),N=(0,t.createElement)("svg",{className:"arrow-up",width:"24",height:"24",viewBox:"0 0 24 24",xmlns:"http://www.w3.org/2000/svg","aria-hidden":"true",focusable:"false"},(0,t.createElement)("path",{d:"M12 8l-6 6 1.41 1.41L12 10.83l4.59 4.58L18 14l-6-6z"}));return(0,t.createElement)("div",{...z},(0,t.createElement)("div",{className:"seo44-sticky-sentinel","aria-hidden":"true"}),c&&(0,t.createElement)(o.RichText.Content,{tagName:p\|\|"h2",className:"wp-block-seo44-jump-links-heading",value:h}),i&&i.length>0&&(0,t.createElement)("nav",{"aria-label":(0,a.__)("Table of contents","search-appearance-toolkit-seo-44")},(0,t.createElement)(B,{id:S},i.filter(e=>!1!==e.isVisible).map(e=>(0,t.createElement)("li",{key:e.anchor,className:s?`seo44-jump-link-level-${e.level}`:""},(0,t.createElement)("a",{href:`#${e.anchor}`},e.linkText)))),r&&(0,t.createElement)("button",{type:"button",className:"seo-44-show-more","aria-label":(0,a.__)("Show More","search-appearance-toolkit-seo-44"),"aria-expanded":"false","aria-controls":S},T,N)))}})}},a={};function o(e){var l=a[e];if(void 0!==l)return l.exports;var n=a[e]={exports:{}};return t[e](n,n.exports,o),n.exports}o.m=t,e=[],o.O=(t,a,l,n)=>{if(!a){var r=1/0;for(h=0;h<e.length;h++){for(var[a,l,n]=e[h],s=!0,i=0;i<a.length;i++)(!1&n\|\|r>=n)&&Object.keys(o.O).every(e=>o.O[e](a[i]))?a.splice(i--,1):(s=!1,n<r&&(r=n));if(s){e.splice(h--,1);var c=l();void 0!==c&&(t=c)}}return t}n=n\|\|0;for(var h=e.length;h>0&&e[h-1][2]>n;h--)e[h]=e[h-1];e[h]=[a,l,n]},o.o=(e,t)=>Object.prototype.hasOwnProperty.call(e,t),(()=>{var e={57:0,350:0};o.O.j=t=>0===e[t];var t=(t,a)=>{var l,n,[r,s,i]=a,c=0;if(r.some(t=>0!==e[t])){for(l in s)o.o(s,l)&&(o.m[l]=s[l]);if(i)var h=i(o)}for(t&&t(a);c<r.length;c++)n=r[c],o.o(e,n)&&e[n]&&e[n][0](),e[n]=0;return o.O(h)},a=globalThis.webpackChunkseo_44_jump_links_block=globalThis.webpackChunkseo_44_jump_links_block\|\|[];a.forEach(t.bind(null,0)),a.push=t.bind(null,a.push.bind(a))})();var l=o.O(void 0,[350],()=>o(313));l=o.O(l)})();
	1	(()=>{"use strict";var e,t={313(){const e=window.wp.blocks,t=window.React,a=window.wp.i18n,o=window.wp.blockEditor,l=window.wp.components,n=window.wp.data,r=window.wp.element;function s(e){return(new DOMParser).parseFromString(e,"text/html").body.textContent\|\|""}const i=(0,t.createElement)("svg",{viewBox:"0 0 24 24",xmlns:"http://www.w3.org/2000/svg","aria-hidden":"true",focusable:"false"},(0,t.createElement)("path",{d:"M3 21v-2h18v2zm8-4v-6.175L9.4 12.4L8 11l4-4l4 4l-1.4 1.4l-1.6-1.575V17zM3 5V3h18v2z"})),c=(0,t.createElement)("svg",{viewBox:"0 0 24 24",xmlns:"http://www.w3.org/2000/svg","aria-hidden":"true",focusable:"false"},(0,t.createElement)("path",{d:"M3 5V3h18v2zm9 12l-4-4l1.4-1.4l1.6 1.575V7h2v6.175l1.6-1.575L16 13zm-9 4v-2h18v2z"})),h=(0,t.createElement)("svg",{className:"arrow-down",width:"24",height:"24",viewBox:"0 0 24 24",xmlns:"http://www.w3.org/2000/svg","aria-hidden":"true",focusable:"false"},(0,t.createElement)("path",{d:"M12 16l-6-6 1.41-1.41L12 13.17l4.59-4.58L18 10l-6 6z"})),p=JSON.parse('{"UU":"seo44/jump-links"}');(0,e.registerBlockType)(p.UU,{edit:function({attributes:e,setAttributes:p}){const{headingLevels:k,headings:u,showHeading:d,headingText:m,headingTag:g,layout:_,listStyle:b,isEditing:v,isCollapsible:f,isSmartIndentation:x,fontSize:w,textColor:C,linkColor:E,blockBackgroundColor:y,linkBackgroundColor:B,linkBackgroundColorHover:S,linkBorderColor:z,linkBorderRadius:T,isSticky:N,stickyOffset:H,jumpOffset:M,stickyStrategy:P}=e,O={color:C,fontSize:w,"--jump-link-font-size":w\|\|"18px","--seo44-link-color":E,"--seo44-link-bg":"horizontal"===_?B:void 0,"--seo44-link-hover-bg":"horizontal"===_?S:void 0,"--seo44-link-border-color":"horizontal"===_?z:void 0,"--seo44-link-radius":"horizontal"===_&&T?`${T}px`:void 0,"--seo44-block-bg":y,"--seo44-sticky-offset":N?`${H}px`:void 0},I="ol"===b?"ol":"ul",{createInfoNotice:L}=(0,n.useDispatch)("core/notices"),j=e.blockInstanceId?`seo44-jump-links-list-${e.blockInstanceId}`:"seo44-jump-links-list",$=(0,o.useBlockProps)({style:O});$.className=`${$.className} ${"horizontal"===_?"is-layout-horizontal":""} ${f&&!v?"is-collapsible":""} ${"none"===b?"list-style-none":""}`.trim();const D=(0,n.useSelect)(e=>e("core/block-editor").getBlocks(),[]),{updateBlockAttributes:V}=(0,n.useDispatch)("core/block-editor");(0,r.useEffect)(()=>{const t={};e.blockInstanceId\|\|(t.blockInstanceId=Math.random().toString(36).substr(2,9)),Object.keys(t).length>0&&p(t);const o=D.filter(e=>"core/heading"===e.name&&k.includes(`h${e.attributes.level}`)),l=new Set;let n=!1;const r=new Map(u.map(e=>[e.anchor,e])),i=[];for(const e of o){const t=s(e.attributes.content);let a=e.attributes.anchor\|\|t.toLowerCase().replace(/[^a-z0-9\s-]/g,"").trim().replace(/\s+/g,"-"),o=a,c=2;for(;l.has(o);)o=`${a}-${c}`,c++,n=!0;l.add(o),e.attributes.anchor!==o&&V(e.clientId,{anchor:o});const h=r.get(e.attributes.anchor)\|\|r.get(o),p=h&&h.linkText!==h.text?h.linkText:t,k=!h\|\|h.isVisible;i.push({anchor:o,text:t,linkText:p,isVisible:k,level:e.attributes.level})}JSON.stringify(i)!==JSON.stringify(u)&&p({headings:i}),n&&L((0,a.__)("Jump Links Block: Duplicate headings were found. Unique IDs have been auto-generated, but this may be a sign of redundancy. Please review your headings for clarity.","search-appearance-toolkit-seo-44"),{type:"snackbar"})},[D,k,u,e.blockInstanceId,p,V,L]),(0,r.useEffect)(()=>{"horizontal"===_&&"none"!==b&&p({listStyle:"none"})},[_,b,p]);const R=(e,t)=>{const a=[...u],o=a.splice(e,1)[0];"up"===t?a.splice(e-1,0,o):a.splice(e+1,0,o),p({headings:a})},J=e=>{const t=k.includes(e)?k.filter(t=>t!==e):[...k,e];p({headingLevels:t.sort()})};return(0,t.createElement)(r.Fragment,null,(0,t.createElement)(o.InspectorControls,null,(0,t.createElement)(l.PanelBody,{title:(0,a.__)("Presentation","search-appearance-toolkit-seo-44")},(0,t.createElement)(l.ButtonGroup,null,(0,t.createElement)(l.Button,{isPrimary:!v,isPressed:!v,onClick:()=>p({isEditing:!1})},(0,a.__)("Viewing Mode","search-appearance-toolkit-seo-44")),(0,t.createElement)(l.Button,{isPrimary:v,isPressed:v,onClick:()=>p({isEditing:!0})},(0,a.__)("Editing Mode","search-appearance-toolkit-seo-44"))),(0,t.createElement)("p",{className:"description"},(0,a.__)("Switch to Editing Mode to customize link text, visibility, and order.","search-appearance-toolkit-seo-44"))),(0,t.createElement)(l.PanelBody,{title:(0,a.__)("Appearance","search-appearance-toolkit-seo-44")},(0,t.createElement)("p",null,(0,t.createElement)("strong",null,(0,a.__)("Layout","search-appearance-toolkit-seo-44"))),(0,t.createElement)(l.ButtonGroup,null,(0,t.createElement)(l.Button,{isPrimary:"vertical"===_,isPressed:"vertical"===_,onClick:()=>p({layout:"vertical"})},(0,a.__)("Vertical","search-appearance-toolkit-seo-44")),(0,t.createElement)(l.Button,{isPrimary:"horizontal"===_,isPressed:"horizontal"===_,onClick:()=>p({layout:"horizontal"})},(0,a.__)("Horizontal","search-appearance-toolkit-seo-44"))),(0,t.createElement)(l.ToggleControl,{label:(0,a.__)("Make Jump Links Area Expandable","search-appearance-toolkit-seo-44"),help:(0,a.__)('Conserve screen space by collapsing a long list of jump links, providing users with an elegant "show more" button to see the entire list.',"search-appearance-toolkit-seo-44"),checked:f,onChange:()=>p({isCollapsible:!f}),__nextHasNoMarginBottom:!0}),(0,t.createElement)(l.SelectControl,{label:(0,a.__)("List Style","search-appearance-toolkit-seo-44"),value:b,options:[{label:(0,a.__)("Bulleted","search-appearance-toolkit-seo-44"),value:"ul"},{label:(0,a.__)("Numbered","search-appearance-toolkit-seo-44"),value:"ol"},{label:(0,a.__)("None","search-appearance-toolkit-seo-44"),value:"none"}],onChange:e=>p({listStyle:e}),disabled:"horizontal"===_,__nextHasNoMarginBottom:!0,__next40pxDefaultSize:!0}),(0,t.createElement)(l.FontSizePicker,{fontSizes:[{name:(0,a.__)("S","search-appearance-toolkit-seo-44"),slug:"small",size:"14px"},{name:(0,a.__)("M","search-appearance-toolkit-seo-44"),slug:"normal",size:"17px"},{name:(0,a.__)("L","search-appearance-toolkit-seo-44"),slug:"large",size:"20px"},{name:(0,a.__)("XL","search-appearance-toolkit-seo-44"),slug:"extra-large",size:"23px"}],value:w,onChange:e=>p({fontSize:e}),withReset:!0,__next40pxDefaultSize:!0}),(0,t.createElement)(o.PanelColorSettings,{title:(0,a.__)("Colors","search-appearance-toolkit-seo-44"),colorSettings:[{value:y,onChange:e=>p({blockBackgroundColor:e}),label:(0,a.__)("Block Background","search-appearance-toolkit-seo-44")},{value:E,onChange:e=>p({linkColor:e}),label:(0,a.__)("Link Color","search-appearance-toolkit-seo-44")},{value:C,onChange:e=>p({textColor:e}),label:(0,a.__)("Other Text Color","search-appearance-toolkit-seo-44")}]}),"horizontal"===_&&(0,t.createElement)(r.Fragment,null,(0,t.createElement)("hr",null),(0,t.createElement)("p",null,(0,t.createElement)("strong",null,(0,a.__)("Horizontal Link Styles","search-appearance-toolkit-seo-44"))),(0,t.createElement)(o.PanelColorSettings,{title:(0,a.__)("Link Colors","search-appearance-toolkit-seo-44"),colorSettings:[{value:B,onChange:e=>p({linkBackgroundColor:e}),label:(0,a.__)("Background","search-appearance-toolkit-seo-44")},{value:S,onChange:e=>p({linkBackgroundColorHover:e}),label:(0,a.__)("Background Hover","search-appearance-toolkit-seo-44")},{value:z,onChange:e=>p({linkBorderColor:e}),label:(0,a.__)("Border","search-appearance-toolkit-seo-44")}]}),(0,t.createElement)(l.RangeControl,{label:(0,a.__)("Link Border Radius","search-appearance-toolkit-seo-44"),value:T,onChange:e=>p({linkBorderRadius:e}),min:0,max:50,__nextHasNoMarginBottom:!0,__next40pxDefaultSize:!0}))),(0,t.createElement)(l.PanelBody,{title:(0,a.__)("Content Settings","search-appearance-toolkit-seo-44")},(0,t.createElement)(l.ToggleControl,{label:(0,a.__)("Display Block Title","search-appearance-toolkit-seo-44"),checked:d,onChange:()=>p({showHeading:!d}),__nextHasNoMarginBottom:!0}),d&&(0,t.createElement)(r.Fragment,null,(0,t.createElement)(l.TextControl,{label:(0,a.__)("Title Text","search-appearance-toolkit-seo-44"),value:m,onChange:e=>p({headingText:e}),help:(0,a.__)("The text that appears above your list of links.","search-appearance-toolkit-seo-44")}),(0,t.createElement)(l.SelectControl,{label:(0,a.__)("Title Tag","search-appearance-toolkit-seo-44"),value:g,options:[{label:"H2",value:"h2"},{label:"H3",value:"h3"},{label:"H4",value:"h4"},{label:"H5",value:"h5"},{label:"Paragraph (Bold)",value:"p"},{label:"Div (No Semantic Value)",value:"div"}],onChange:e=>p({headingTag:e}),help:(0,a.__)("Choose a level that fits your page's structure.","search-appearance-toolkit-seo-44"),__nextHasNoMarginBottom:!0,__next40pxDefaultSize:!0})),(0,t.createElement)("hr",null),(0,t.createElement)("p",null,(0,t.createElement)("strong",null,(0,a.__)("Included Headings","search-appearance-toolkit-seo-44"))),(0,t.createElement)("p",{className:"description",style:{marginBottom:"10px"}},(0,a.__)("Select which heading levels from your post content should appear in the jump links list.","search-appearance-toolkit-seo-44")),(0,t.createElement)(l.CheckboxControl,{label:"H2",checked:k.includes("h2"),onChange:()=>J("h2")}),(0,t.createElement)(l.CheckboxControl,{label:"H3",checked:k.includes("h3"),onChange:()=>J("h3")}),(0,t.createElement)(l.CheckboxControl,{label:"H4",checked:k.includes("h4"),onChange:()=>J("h4")}),(0,t.createElement)(l.ToggleControl,{label:(0,a.__)("Create Visual Hierarchy","search-appearance-toolkit-seo-44"),help:(0,a.__)("Indents sub-headings (H3, H4) to create a nested outline structure.","search-appearance-toolkit-seo-44"),checked:x,onChange:()=>p({isSmartIndentation:!x}),__nextHasNoMarginBottom:!0})),(0,t.createElement)(l.PanelBody,{title:(0,a.__)("Position Settings","search-appearance-toolkit-seo-44")},(0,t.createElement)(l.ToggleControl,{label:(0,a.__)("Sticky Position","search-appearance-toolkit-seo-44"),help:(0,a.__)("Keep the table of contents visible while scrolling.","search-appearance-toolkit-seo-44"),checked:N,onChange:()=>p({isSticky:!N}),__nextHasNoMarginBottom:!0}),N&&(0,t.createElement)(r.Fragment,null,(0,t.createElement)("p",{className:"description",style:{marginBottom:"15px"}},(0,a.__)("Customize how the block behaves when it sticks to the top of the screen.","search-appearance-toolkit-seo-44")),(0,t.createElement)(l.RangeControl,{label:(0,a.__)("Top Offset (px)","search-appearance-toolkit-seo-44"),help:(0,a.__)("The distance between the top of the screen and the block when stuck (useful for clearing sticky headers).","search-appearance-toolkit-seo-44"),value:H,onChange:e=>p({stickyOffset:e}),min:0,max:200,__nextHasNoMarginBottom:!0,__next40pxDefaultSize:!0}),(0,t.createElement)(l.RangeControl,{label:(0,a.__)("Jump Offset (px)","search-appearance-toolkit-seo-44"),help:(0,a.__)("The buffer distance to stop before the heading. Increase this if your sticky header covers the text.","search-appearance-toolkit-seo-44"),value:M,onChange:e=>p({jumpOffset:e}),min:0,max:200,__nextHasNoMarginBottom:!0,__next40pxDefaultSize:!0}),(0,t.createElement)(l.ToggleControl,{label:(0,a.__)("Disable on Mobile","search-appearance-toolkit-seo-44"),help:(0,a.__)("Prevents the block from sticking on small screens to save reading space.","search-appearance-toolkit-seo-44"),checked:"desktop-only"===P,onChange:e=>p({stickyStrategy:e?"desktop-only":"always"}),__nextHasNoMarginBottom:!0})))),(0,t.createElement)("div",{...$},d&&(0,t.createElement)(o.RichText,{tagName:g,className:"wp-block-seo44-jump-links-heading",value:m,onChange:e=>p({headingText:e}),placeholder:(0,a.__)("On This Page","search-appearance-toolkit-seo-44")}),u.length>0?(0,t.createElement)("nav",{"aria-label":(0,a.__)("Table of contents","search-appearance-toolkit-seo-44")},(0,t.createElement)(I,{id:j},u.map((e,o)=>v?(0,t.createElement)("li",{key:e.anchor},(0,t.createElement)(l.TextControl,{value:e.linkText,onChange:e=>((e,t)=>{const a=[...u];a[e].linkText=t,p({headings:a})})(o,e)}),(0,t.createElement)("div",{className:"edit-controls-wrapper"},(0,t.createElement)("div",{className:"reorder-buttons"},(0,t.createElement)(l.Button,{icon:i,label:(0,a.__)("Move Up","search-appearance-toolkit-seo-44"),onClick:()=>R(o,"up"),disabled:0===o}),(0,t.createElement)(l.Button,{icon:c,label:(0,a.__)("Move Down","search-appearance-toolkit-seo-44"),onClick:()=>R(o,"down"),disabled:o===u.length-1})),(0,t.createElement)(l.ToggleControl,{label:!1!==e.isVisible?(0,a.__)("Included","search-appearance-toolkit-seo-44"):(0,a.__)("This Jump Link will not be shown","search-appearance-toolkit-seo-44"),checked:!1!==e.isVisible,onChange:()=>(e=>{const t=[...u];t[e].isVisible=!t[e].isVisible,p({headings:t})})(o),__nextHasNoMarginBottom:!0}))):!1!==e.isVisible&&(0,t.createElement)("li",{key:e.anchor,className:x?`seo44-jump-link-level-${e.level}`:""},(0,t.createElement)("a",{href:`#${e.anchor}`,onClick:e=>e.preventDefault()},e.linkText)))),!v&&f&&u.length>0&&(0,t.createElement)(l.Tooltip,{text:(0,a.__)("This button is functional on the front-end to expand the list.","search-appearance-toolkit-seo-44")},(0,t.createElement)("button",{type:"button",className:"seo-44-show-more","aria-label":(0,a.__)("Show More","search-appearance-toolkit-seo-44"),"aria-expanded":"false","aria-controls":j,onClick:()=>{L((0,a.__)('The "Show More" button is interactive on the published page.',"search-appearance-toolkit-seo-44"),{type:"snackbar"})}},h))):(0,t.createElement)("p",null,(0,a.__)("No headings found. Select a heading level in the block settings to generate links.","search-appearance-toolkit-seo-44"))))},save:function({attributes:e}){const{blockInstanceId:l,layout:n,isCollapsible:r,isSmartIndentation:s,headings:i,showHeading:c,headingText:h,headingTag:p,listStyle:k,fontSize:u,textColor:d,linkColor:m,blockBackgroundColor:g,linkBackgroundColor:_,linkBackgroundColorHover:b,linkBorderColor:v,linkBorderRadius:f,isSticky:x,stickyOffset:w,jumpOffset:C,stickyStrategy:E}=e,y={color:d,fontSize:u,"--jump-link-font-size":u\|\|"18px","--seo44-block-bg":g,"--seo44-link-color":m,"--seo44-link-bg":"horizontal"===n?_:void 0,"--seo44-link-hover-bg":"horizontal"===n?b:void 0,"--seo44-link-border-color":"horizontal"===n?v:void 0,"--seo44-link-radius":"horizontal"===n&&f?`${f}px`:void 0,"--seo44-sticky-offset":x?`${w}px`:void 0},B="ol"===k?"ol":"ul",S=`seo44-jump-links-list-${l}`,z=o.useBlockProps.save({className:`${"horizontal"===n?"is-layout-horizontal":""} ${r?"is-collapsible":""} ${"none"===k?"list-style-none":""} ${x?"is-sticky":""} ${"desktop-only"===E?"sticky-desktop-only":""}`.trim(),style:y,"data-seo44-jump-offset":x?C:30}),T=(0,t.createElement)("svg",{className:"arrow-down",width:"24",height:"24",viewBox:"0 0 24 24",xmlns:"http://www.w3.org/2000/svg","aria-hidden":"true",focusable:"false"},(0,t.createElement)("path",{d:"M12 16l-6-6 1.41-1.41L12 13.17l4.59-4.58L18 10l-6 6z"})),N=(0,t.createElement)("svg",{className:"arrow-up",width:"24",height:"24",viewBox:"0 0 24 24",xmlns:"http://www.w3.org/2000/svg","aria-hidden":"true",focusable:"false"},(0,t.createElement)("path",{d:"M12 8l-6 6 1.41 1.41L12 10.83l4.59 4.58L18 14l-6-6z"}));return(0,t.createElement)("div",{...z},(0,t.createElement)("div",{className:"seo44-sticky-sentinel","aria-hidden":"true"}),c&&(0,t.createElement)(o.RichText.Content,{tagName:p\|\|"h2",className:"wp-block-seo44-jump-links-heading",value:h}),i&&i.length>0&&(0,t.createElement)("nav",{"aria-label":(0,a.__)("Table of contents","search-appearance-toolkit-seo-44")},(0,t.createElement)(B,{id:S},i.filter(e=>!1!==e.isVisible).map(e=>(0,t.createElement)("li",{key:e.anchor,className:s?`seo44-jump-link-level-${e.level}`:""},(0,t.createElement)("a",{href:`#${e.anchor}`},e.linkText)))),r&&(0,t.createElement)("button",{type:"button",className:"seo-44-show-more","aria-label":(0,a.__)("Show More","search-appearance-toolkit-seo-44"),"aria-expanded":"false","aria-controls":S},T,N)))}})}},a={};function o(e){var l=a[e];if(void 0!==l)return l.exports;var n=a[e]={exports:{}};return t[e](n,n.exports,o),n.exports}o.m=t,e=[],o.O=(t,a,l,n)=>{if(!a){var r=1/0;for(h=0;h<e.length;h++){for(var[a,l,n]=e[h],s=!0,i=0;i<a.length;i++)(!1&n\|\|r>=n)&&Object.keys(o.O).every(e=>o.O[e](a[i]))?a.splice(i--,1):(s=!1,n<r&&(r=n));if(s){e.splice(h--,1);var c=l();void 0!==c&&(t=c)}}return t}n=n\|\|0;for(var h=e.length;h>0&&e[h-1][2]>n;h--)e[h]=e[h-1];e[h]=[a,l,n]},o.o=(e,t)=>Object.prototype.hasOwnProperty.call(e,t),(()=>{var e={57:0,350:0};o.O.j=t=>0===e[t];var t=(t,a)=>{var l,n,[r,s,i]=a,c=0;if(r.some(t=>0!==e[t])){for(l in s)o.o(s,l)&&(o.m[l]=s[l]);if(i)var h=i(o)}for(t&&t(a);c<r.length;c++)n=r[c],o.o(e,n)&&e[n]&&e[n][0](),e[n]=0;return o.O(h)},a=globalThis.webpackChunkseo_44_jump_links_block=globalThis.webpackChunkseo_44_jump_links_block\|\|[];a.forEach(t.bind(null,0)),a.push=t.bind(null,a.push.bind(a))})();var l=o.O(void 0,[350],()=>o(313));l=o.O(l)})();

search-appearance-toolkit-seo-44/trunk/changelog.txt

-                      r3405454
+                      r3423355
 == Changelog ==
+= 4.3.0 =
+* FEATURE: **Table of Contents Schema:** Automatically generates `hasPart` schema synchronized with the Jump Links Block to support "Jump-to" links in search results.
+* FEATURE: **Advanced HowTo Schema:** A new "Block-Aware" scanner uses the Jump Links Block to strictly define steps while intelligently mining the introduction for tools, time, yield, and video data.
+* TWEAK: Added a "Generate HowTo Schema" checkbox to the SEO 44 metabox, giving users explicit control over when the advanced scanner runs.
+* FEATURE: **YouTube Integration:** Added support for the YouTube Data API v3 to fetch accurate video upload dates for VideoObject schema.
+* TESTED: Tested to WordPress Version 6.9
 = 4.2.0 =

search-appearance-toolkit-seo-44/trunk/includes/class-seo44-core.php

-                      r3403604
+                      r3423355
 <?php
+//4.3 - Added dependencies for block-editor-script.js to access Jump Links Block anchor ids for hasPart and HowTo schema.
 class SEO44_Core {
 …
     public function admin_enqueue_assets($hook) {
         if ('post.php' == $hook || 'post-new.php' == $hook) {
+            // CSS
             wp_enqueue_style('seo44-admin-styles', plugins_url('../css/admin-styles.css', __FILE__), [], SEO44_VERSION);
+            wp_enqueue_script('seo44-admin-script', plugins_url('../js/admin-script.js', __FILE__), ['jquery'], SEO44_VERSION, true);
+            // General Admin Script (Classic + Block)
+            wp_enqueue_script('seo44-admin-script', plugins_url('../js/admin-script.js', __FILE__),
+                ['jquery'],
+                SEO44_VERSION,
+                true);
+            // Localize the General Script (needed for Snippet Preview)
             wp_localize_script('seo44-admin-script', 'seo44_data', [
                 'post_title' => get_the_title(get_the_ID()),
 …
                 'permalink' => get_permalink(get_the_ID())
             ]);
+            // Block Editor Specific Script (Passthrough Logic For Jump Links)
+            // We enqueue this separately with the Block Editor dependencies.
+            // WordPress will simply NOT load this file if these handles don't exist (e.g. Classic Editor).
+            wp_enqueue_script('seo44-block-editor-script', plugins_url('../js/block-editor-script.js', __FILE__),
+                ['wp-data', 'wp-editor', 'wp-blocks'], // Dependencies are important for Jump Links Block data
+                SEO44_VERSION,
+                true
+            );
+        }
        if ('settings_page_search-appearance-toolkit-seo-44' == $hook) {

search-appearance-toolkit-seo-44/trunk/includes/class-seo44-frontend.php

-                      r3405454
+                      r3423355
 <?php
+// Version 4.3
+// Create hasPart and HowTo schema from Jump Links Block using metafield passthrough
+// Added YouTube Data API support for more accurate video upload date
 class SEO44_Frontend {
     public function __construct() {
 …
         add_action('wp_head', [$this, 'output_header_tags']);
         add_action('wp_head', [$this, 'output_schema_json_ld'], 99);
+        add_action('init', [$this, 'register_schema_meta_fields']); // Retrieve Jump Links Block data for schema via a hidden metabox field
         $taxonomies = get_taxonomies(['public' => true]);
 …
+        }
+    }
+    // Get meta field from metabox for Jump Links Block + HowTo Schema
+    public function register_schema_meta_fields() {
+        register_post_meta('post', '_seo44_howto_step_ids', [
+            'single'       => true,
+            'type'         => 'array',
+            'show_in_rest' => [
+                'schema' => [
+                    'type'  => 'array',
+                    'items' => [
+                        'type' => 'string',
+                    ],
+                ],
+            ],
+            'auth_callback' => function() { return current_user_can('edit_posts'); }
+        ]);
+    }
+    //Title
     public function filter_document_title($title_parts) {
         if (!seo44_get_option('enable_tags')) return $title_parts;
+        if (!seo44_get_option('enable_tags')) return $title_parts;
         $custom_title = '';
         $fallback_title = '';
 …
             $custom_title = seo44_get_option('homepage_title');
         } elseif (is_singular()) {
             $custom_title = get_post_meta(get_the_ID(), seo44_get_option('title_key'), true);
+            $custom_title = get_post_meta(get_the_ID(), seo44_get_option('title_key'), true);
             $fallback_title = get_the_title(get_the_ID());
         } elseif (is_category() || is_tag() || is_tax()) {
+        } elseif (is_category() || is_tag() || is_tax()) {
             $term_id = get_queried_object_id();
             $custom_title = get_term_meta($term_id, 'seo44_title', true);
 …
             unset($title_parts['site'], $title_parts['tagline']);
+        }
+        return $title_parts;
+    }
+    public function add_term_meta_fields($term, $taxonomy) {
+        return $title_parts;
+    }
+    // Meta Tags
+    public function add_term_meta_fields($term, $taxonomy) {
         $title = get_term_meta($term->term_id, 'seo44_title', true);
         $description = get_term_meta($term->term_id, 'seo44_description', true);
 …
+    }
     public function output_header_tags() {
         if (!seo44_get_option('enable_tags')) { return; }
         $description = '';
         $social_title = '';
         $current_url = '';
         if (is_front_page()) {
             $description = seo44_get_option('homepage_description');
             $social_title = seo44_get_option('homepage_title') ?: get_bloginfo('name');
             $current_url = home_url('/');
         } elseif (is_singular()) {
             $post_id = get_the_ID();
             $description = get_post_meta($post_id, seo44_get_option('description_key'), true);
             $custom_title = get_post_meta($post_id, seo44_get_option('title_key'), true);
             $social_title = $custom_title ?: get_the_title($post_id);
             $current_url = get_permalink($post_id);
+    public function output_header_tags() {
+        if (!seo44_get_option('enable_tags')) { return; }
+        $description = '';
+        $social_title = '';
+        $current_url = '';
+        if (is_front_page()) {
+            $description = seo44_get_option('homepage_description');
+            $social_title = seo44_get_option('homepage_title') ?: get_bloginfo('name');
+            $current_url = home_url('/');
+        } elseif (is_singular()) {
+            $post_id = get_the_ID();
+            $description = get_post_meta($post_id, seo44_get_option('description_key'), true);
+            $custom_title = get_post_meta($post_id, seo44_get_option('title_key'), true);
+            $social_title = $custom_title ?: get_the_title($post_id);
+            $current_url = get_permalink($post_id);
             if (empty($description)) {
                 $post_content = get_the_content(null, false, get_the_ID());
+                $post_content = get_the_content(null, false, get_the_ID());
                 $description = wp_trim_words(strip_shortcodes(wp_strip_all_tags($post_content)), 25, '...');
+            }
         } elseif (is_category() || is_tag() || is_tax()) {
             $term = get_queried_object();
             $description = get_term_meta($term->term_id, 'seo44_description', true);
             $custom_title = get_term_meta($term->term_id, 'seo44_title', true);
             $social_title = $custom_title ?: single_term_title('', false) . ' - ' . get_bloginfo('name');
             $current_url = get_term_link($term);
+            }
+        } elseif (is_category() || is_tag() || is_tax()) {
+            $term = get_queried_object();
+            $description = get_term_meta($term->term_id, 'seo44_description', true);
+            $custom_title = get_term_meta($term->term_id, 'seo44_title', true);
+            $social_title = $custom_title ?: single_term_title('', false) . ' - ' . get_bloginfo('name');
+            $current_url = get_term_link($term);
             if (empty($description)) {
                 $term_description = trim(wp_strip_all_tags($term->description));
 …
+                }
+            }
+        }
+        if (!empty($description)) {
+            printf('<meta name="description" content="%s">' . "\n", esc_attr(wp_strip_all_tags(html_entity_decode($description, ENT_QUOTES, 'UTF-8'))));
+        }
+        if (is_singular()) {
+            $post_id = get_the_ID();
+            $keywords = get_post_meta($post_id, seo44_get_option('keywords_key'), true);
+            if (seo44_get_option('include_keywords') && !empty($keywords)) {
+                printf('<meta name="keywords" content="%s">' . "\n", esc_attr(wp_strip_all_tags(html_entity_decode($keywords, ENT_QUOTES, 'UTF-8'))));
+            }
+            if (is_singular() && seo44_get_option('include_author')) {
+                $author_id = get_post_field('post_author', $post_id);
+                if ($author_id) {
+                    printf('<meta name="author" content="%s">' . "\n", esc_attr($this->get_author_name($author_id)));
+                }
+            }
+        }
+        if (seo44_get_option('enable_og_tags') || seo44_get_option('enable_twitter_tags')) {
+            $clean_social_title = esc_attr(wp_strip_all_tags(html_entity_decode($social_title, ENT_QUOTES, 'UTF-8')));
+            $clean_description = !empty($description) ? esc_attr(wp_strip_all_tags(html_entity_decode($description, ENT_QUOTES, 'UTF-8'))) : '';
+            if (empty($clean_description) && is_singular()) {
+                 $clean_description = esc_attr(wp_strip_all_tags(get_the_excerpt(get_the_ID())));
+            }
+            $image_url = ''; $image_width = ''; $image_height = '';
+            $image_id = 0;
+            if (is_singular() && has_post_thumbnail()) {
+                $image_id = get_post_thumbnail_id();
+            }
+            if (!$image_id) {
+                $image_id = seo44_get_option('default_social_image_id', 0);
+            }
+            if ($image_id) {
+                $image_data = wp_get_attachment_image_src($image_id, 'full');
+                if ($image_data) {
+                    list($image_url, $image_width, $image_height) = $image_data;
+                }
+            }
+            if (seo44_get_option('enable_og_tags')) {
+                printf('<meta property="og:title" content="%s">' . "\n", esc_attr($clean_social_title));
+                printf('<meta property="og:url" content="%s">' . "\n", esc_url($current_url));
+                printf('<meta property="og:site_name" content="%s">' . "\n", esc_attr(get_bloginfo('name')));
+                if (!empty($clean_description)) { printf('<meta property="og:description" content="%s">' . "\n", esc_attr($clean_description)); }
+                if (is_singular('post')) {
+                     echo '<meta property="og:type" content="article">' . "\n";
+                } else {
+                     echo '<meta property="og:type" content="website">' . "\n";
+                }
+                if (!empty($image_url)) {
+                    printf('<meta property="og:image" content="%s">' . "\n", esc_url($image_url));
+                    if (!empty($image_width)) { printf('<meta property="og:image:width" content="%s">' . "\n", esc_attr($image_width)); }
+                    if (!empty($image_height)) { printf('<meta property="og:image:height" content="%s">' . "\n", esc_attr($image_height)); }
+                }
+                $fb_app_id = seo44_get_option('fb_app_id');
+                if (!empty($fb_app_id)) { printf('<meta property="fb:app_id" content="%s">' . "\n", esc_attr($fb_app_id)); }
+            }
+            if (seo44_get_option('enable_twitter_tags')) {
+                echo '<meta name="twitter:card" content="summary_large_image">' . "\n";
+                $twitter_handle = seo44_get_option('twitter_handle');
+                if ( !empty($twitter_handle) && is_string($twitter_handle) ) {
+                    $handle = esc_attr(str_replace('@', '', $twitter_handle));
+                    printf('<meta name="twitter:site" content="@%s">' . "\n", esc_attr($handle));
+                    printf('<meta name="twitter:creator" content="@%s">' . "\n", esc_attr($handle));
+                }
+                printf('<meta name="twitter:title" content="%s">' . "\n", esc_attr($clean_social_title));
+                if (!empty($clean_description)) { printf('<meta name="twitter:description" content="%s">' . "\n", esc_attr($clean_description)); }
+                if (!empty($image_url)) { printf('<meta name="twitter:image" content="%s">' . "\n", esc_url($image_url)); }
+            }
+        }
+    }
+        }
+        if (!empty($description)) {
+            printf('<meta name="description" content="%s">' . "\n", esc_attr(wp_strip_all_tags(html_entity_decode($description, ENT_QUOTES, 'UTF-8'))));
+        }
+        if (is_singular()) {
+            $post_id = get_the_ID();
+            $keywords = get_post_meta($post_id, seo44_get_option('keywords_key'), true);
+            if (seo44_get_option('include_keywords') && !empty($keywords)) {
+                printf('<meta name="keywords" content="%s">' . "\n", esc_attr(wp_strip_all_tags(html_entity_decode($keywords, ENT_QUOTES, 'UTF-8'))));
+            }
+            if (is_singular() && seo44_get_option('include_author')) {
+                $author_id = get_post_field('post_author', $post_id);
+                if ($author_id) {
+                    printf('<meta name="author" content="%s">' . "\n", esc_attr($this->get_author_name($author_id)));
+                }
+            }
+        }
+        if (seo44_get_option('enable_og_tags') || seo44_get_option('enable_twitter_tags')) {
+            $clean_social_title = esc_attr(wp_strip_all_tags(html_entity_decode($social_title, ENT_QUOTES, 'UTF-8')));
+            $clean_description = !empty($description) ? esc_attr(wp_strip_all_tags(html_entity_decode($description, ENT_QUOTES, 'UTF-8'))) : '';
+            if (empty($clean_description) && is_singular()) {
+                 $clean_description = esc_attr(wp_strip_all_tags(get_the_excerpt(get_the_ID())));
+            }
+            $image_url = ''; $image_width = ''; $image_height = '';
+            $image_id = 0;
+            if (is_singular() && has_post_thumbnail()) {
+                $image_id = get_post_thumbnail_id();
+            }
+            if (!$image_id) {
+                $image_id = seo44_get_option('default_social_image_id', 0);
+            }
+            if ($image_id) {
+                $image_data = wp_get_attachment_image_src($image_id, 'full');
+                if ($image_data) {
+                    list($image_url, $image_width, $image_height) = $image_data;
+                }
+            }
+            if (seo44_get_option('enable_og_tags')) {
+                printf('<meta property="og:title" content="%s">' . "\n", esc_attr($clean_social_title));
+                printf('<meta property="og:url" content="%s">' . "\n", esc_url($current_url));
+                printf('<meta property="og:site_name" content="%s">' . "\n", esc_attr(get_bloginfo('name')));
+                if (!empty($clean_description)) { printf('<meta property="og:description" content="%s">' . "\n", esc_attr($clean_description)); }
+                if (is_singular('post')) {
+                     echo '<meta property="og:type" content="article">' . "\n";
+                } else {
+                     echo '<meta property="og:type" content="website">' . "\n";
+                }
+                if (!empty($image_url)) {
+                    printf('<meta property="og:image" content="%s">' . "\n", esc_url($image_url));
+                    if (!empty($image_width)) { printf('<meta property="og:image:width" content="%s">' . "\n", esc_attr($image_width)); }
+                    if (!empty($image_height)) { printf('<meta property="og:image:height" content="%s">' . "\n", esc_attr($image_height)); }
+                }
+                $fb_app_id = seo44_get_option('fb_app_id');
+                if (!empty($fb_app_id)) { printf('<meta property="fb:app_id" content="%s">' . "\n", esc_attr($fb_app_id)); }
+            }
+            if (seo44_get_option('enable_twitter_tags')) {
+                echo '<meta name="twitter:card" content="summary_large_image">' . "\n";
+                $twitter_handle = seo44_get_option('twitter_handle');
+                if ( !empty($twitter_handle) && is_string($twitter_handle) ) {
+                    $handle = esc_attr(str_replace('@', '', $twitter_handle));
+                    printf('<meta name="twitter:site" content="@%s">' . "\n", esc_attr($handle));
+                    printf('<meta name="twitter:creator" content="@%s">' . "\n", esc_attr($handle));
+                }
+                printf('<meta name="twitter:title" content="%s">' . "\n", esc_attr($clean_social_title));
+                if (!empty($clean_description)) { printf('<meta name="twitter:description" content="%s">' . "\n", esc_attr($clean_description)); }
+                if (!empty($image_url)) { printf('<meta name="twitter:image" content="%s">' . "\n", esc_url($image_url)); }
+            }
+        }
+    }
+    // Now For The Schema Structured Data
     public function output_schema_json_ld() {
         // Note: The following line is intentionally not nonce-checked.
-        // This is a safe, read-only check used by the admin-side scanner to get a clean view of the page
-        // without our own schema being output. It does not process or save any data.
         $scan_param = isset($_GET['seo44_scan']) ? sanitize_key(wp_unslash($_GET['seo44_scan'])) : '';
         if ($scan_param === 'true') { return; }
 …
         $base_schema = [];
         $special_schemas = [];
         $breadcrumb_schema = []; // New variable for breadcrumbs
+        $breadcrumb_schema = []; // New variable for breadcrumbs
         $post_id = get_the_ID();
 …
             $base_schema = $this->get_schema_for_website();
             // NEW: Add Organization Schema to homepage
             if (seo44_get_option('enable_organization_schema')) {
                 $org_schema = $this->get_schema_for_organization();
                 if (!empty($org_schema)) {
                     $special_schemas[] = $org_schema;
+                }
+            }
+            // Add Organization Schema to homepage
+            if (seo44_get_option('enable_organization_schema')) {
+                $org_schema = $this->get_schema_for_organization();
+                if (!empty($org_schema)) {
+                    $special_schemas[] = $org_schema;
+                }
+            }
         } elseif ( (is_category() || is_tag() || is_tax()) && seo44_get_option('enable_schema_on_taxonomies') ) {
             $base_schema = $this->get_schema_for_taxonomy();
 …
+        }
+        // 3. Attempt to generate special schema
+        if (is_singular() && seo44_get_option('enable_advanced_schema')) {
+            $detected_schemas = $this->detect_and_generate_special_schema($post_id);
+            // Merge instead of overwrite - important for organization schema
+            if (!empty($detected_schemas)) {
+                $special_schemas = array_merge($special_schemas, $detected_schemas);
+            }
+        }
+        // 4.  Hook for Add-ons ---
+        // This filter allows other plugins to add their own custom schema parts to the graph.
+        $addon_schema_parts = apply_filters( 'seo44_add_schema_parts', [], $post_id );
+        // --- End Hook ---
+        // 5. Combine all schemas for output
+        $final_schema_parts = [];
+        // 3. Attempt to generate special schema (FAQ / HowTo)
+        if (is_singular() && seo44_get_option('enable_advanced_schema')) {
+            $detected_schemas = $this->detect_and_generate_special_schema($post_id);
+            // Merge instead of overwrite (Prevents erasing Organization schema on static pages)
+            if (!empty($detected_schemas)) {
+                $special_schemas = array_merge($special_schemas, $detected_schemas);
+            }
+        }
+        // 4.  Hook for Add-ons ---
+        // This filter allows other plugins to add their own custom schema parts to the graph.
+        $addon_schema_parts = apply_filters( 'seo44_add_schema_parts', [], $post_id );
+        // --- End Hook ---
+        // 5. Combine all schemas for output
+        $final_schema_parts = [];
         if (!empty($base_schema)) {
             $final_schema_parts[] = $base_schema;
 …
             $final_schema_parts = array_merge($final_schema_parts, $special_schemas);
+        }
         // include any add-on schemas that pass is_array sanity check
         if ( ! empty( $addon_schema_parts ) && is_array( $addon_schema_parts ) ) {
             $final_schema_parts = array_merge( $final_schema_parts, $addon_schema_parts );
+        }
+        // include any add-on schemas that pass is_array sanity check
+        if ( ! empty( $addon_schema_parts ) && is_array( $addon_schema_parts ) ) {
+            $final_schema_parts = array_merge( $final_schema_parts, $addon_schema_parts );
+        }
         $final_schema = [];
 …
+        }
+    }
     // --- Helper Functions ---
+    // --- Helper Functions ---
     // --- Generate BreadcrumbList Schema for Singular Content ---
 …
         ];
+    }
     // --- Helper Function For Types ---
     public static function get_schema_for_post($post_id) {
+        global $post;
+        $post = get_post($post_id);
+        setup_postdata($post);
+        // Get the author's ID and website URL to refer authorship
+        $author_id = $post->post_author;
+        $author_url = get_the_author_meta('user_url', $author_id);
+        // Build the author schema array
+        $author_schema = [
+            '@type' => 'Person',
+            'name'  => self::get_author_name_static( $author_id ), // Pass the author ID
+        ];
+        // If the author has a website, add the @id and url properties
+        if ( ! empty( $author_url ) ) {
+            // Ensure the URL has a trailing slash before adding the fragment.
+            $canonical_author_url = trailingslashit( $author_url );
+            $author_schema['@id'] = $canonical_author_url . '#person';
+            $author_schema['url'] = $canonical_author_url;
+        }
+        $schema = [
+            '@context'         => 'https://schema.org',
+            '@type'            => 'Article',
+            'mainEntityOfPage' => ['@type' => 'WebPage', '@id' => get_permalink($post_id)],
+            'headline'         => get_the_title($post_id),
+            'datePublished'    => get_the_date('c', $post_id),
+            'dateModified'     => get_the_modified_date('c', $post_id),
+            'author'           => $author_schema, // Use the author schema array
+            'publisher'        => ['@type' => 'Organization', 'name' => get_bloginfo('name')]
+        ];
+        if (get_site_icon_url()) { $schema['publisher']['logo'] = ['@type' => 'ImageObject', 'url' => get_site_icon_url()]; }
+        if (has_post_thumbnail($post_id)) {
+            $image_id = get_post_thumbnail_id($post_id);
+            $image_data = wp_get_attachment_image_src($image_id, 'full');
+            if ($image_data) {
+                $schema['image'] = [
+                    '@type' => 'ImageObject',
+                    'url' => $image_data[0],
+                    'width' => $image_data[1],
+                    'height' => $image_data[2]
+                ];
+            }
+        }
+        // NEW: Parse content for additional media if the setting is enabled
+        global $post;
+        $post = get_post($post_id);
+        setup_postdata($post);
+        // Get the author's ID and website URL to refer authorship
+        $author_id = $post->post_author;
+        $author_url = get_the_author_meta('user_url', $author_id);
+        // Build the author schema array
+        $author_schema = [
+            '@type' => 'Person',
+            'name'  => self::get_author_name_static( $author_id ), // Pass the author ID
+        ];
+        // If the author has a website, add the @id and url properties
+        if ( ! empty( $author_url ) ) {
+            // Ensure the URL has a trailing slash before adding the fragment.
+            $canonical_author_url = trailingslashit( $author_url );
+            $author_schema['@id'] = $canonical_author_url . '#person';
+            $author_schema['url'] = $canonical_author_url;
+        }
+        $schema = [
+            '@context'         => 'https://schema.org',
+            '@type'            => 'Article',
+            'mainEntityOfPage' => ['@type' => 'WebPage', '@id' => get_permalink($post_id)],
+            'headline'         => get_the_title($post_id),
+            'datePublished'    => get_the_date('c', $post_id),
+            'dateModified'     => get_the_modified_date('c', $post_id),
+            'author'           => $author_schema, // Use the author schema array
+            'publisher'        => ['@type' => 'Organization', 'name' => get_bloginfo('name')]
+        ];
+        if (get_site_icon_url()) { $schema['publisher']['logo'] = ['@type' => 'ImageObject', 'url' => get_site_icon_url()]; }
+        // FIX: Initialize image key safely here to prevent "Undefined array key" warning
+        $schema['image'] = []; // Default to empty array
+        if (has_post_thumbnail($post_id)) {
+            $image_id = get_post_thumbnail_id($post_id);
+            $image_data = wp_get_attachment_image_src($image_id, 'full');
+            if ($image_data) {
+                $schema['image'][] = [
+                    '@type' => 'ImageObject',
+                    'url' => $image_data[0],
+                    'width' => $image_data[1],
+                    'height' => $image_data[2]
+                ];
+            }
+        }
+        // NEW: Parse content for additional media if the setting is enabled
         if (seo44_get_option('scan_content_for_schema')) {
             $media_schema = self::parse_content_for_media_schema($post_id);
+            if (!empty($media_schema['images'])) {
+                // Check if a featured image (or other image) already exists
+                $existing_images = isset($schema['image']) ? (array)$schema['image'] : [];
+                // Merge existing images with content images
+                $schema['image'] = array_merge($existing_images, $media_schema['images']);
+            }
+            if (!empty($media_schema['images'])) {
+                // 1. Re-index to prevent "0": {...} keys
+                $schema['image'] = array_merge($schema['image'], $media_schema['images']);
+            }
             if (!empty($media_schema['videos'])) {
                 $schema['video'] = $media_schema['videos'];
+            }
+        }
+        $description = get_post_meta($post_id, seo44_get_option('description_key'), true);
+        if (!empty($description)) { $schema['description'] = esc_html(wp_strip_all_tags($description)); }
+        $excerpt = get_the_excerpt($post_id);
+        if (!empty($excerpt)) { $schema['abstract'] = esc_html(wp_strip_all_tags($excerpt)); }
+        $content = get_the_content(null, false, $post_id);
+        $schema['wordCount'] = str_word_count(wp_strip_all_tags($content));
+        $category = get_the_category($post_id);
+        if (!empty($category) && $category[0]->name !== 'Uncategorized') {
+            $schema['articleSection'] = esc_html($category[0]->name);
+        }
+        $tags = get_the_tags($post_id);
+        if ($tags) {
+            $keywords = [];
+            foreach ($tags as $tag) { $keywords[] = $tag->name; }
+            $schema['keywords'] = esc_html(implode(', ', $keywords));
+        }
+        wp_reset_postdata();
+        return $schema;
+        // 2. Ensure clean array (re-index)
+        if (!empty($schema['image'])) {
+            $schema['image'] = array_values($schema['image']);
+            // If only one image, Google prefers object over array, but array is valid.
+            // To match your request, we keep it as array_values to remove numeric keys.
+        } else {
+            unset($schema['image']);
+        }
+        $description = get_post_meta($post_id, seo44_get_option('description_key'), true);
+        if (!empty($description)) { $schema['description'] = esc_html(wp_strip_all_tags($description)); }
+        $excerpt = get_the_excerpt($post_id);
+        if (!empty($excerpt)) { $schema['abstract'] = esc_html(wp_strip_all_tags($excerpt)); }
+        $content = get_the_content(null, false, $post_id);
+        $schema['wordCount'] = str_word_count(wp_strip_all_tags($content));
+        $category = get_the_category($post_id);
+        if (!empty($category) && $category[0]->name !== 'Uncategorized') {
+            $schema['articleSection'] = esc_html($category[0]->name);
+        }
+        $tags = get_the_tags($post_id);
+        if ($tags) {
+            $keywords = [];
+            foreach ($tags as $tag) { $keywords[] = $tag->name; }
+            $schema['keywords'] = esc_html(implode(', ', $keywords));
+        }
+        // NEW: Dynamic Table of Contents (hasPart)
+        // Only run this if we are scanning content, to save performance
+        if (seo44_get_option('enable_jumplinks_schema')) {
+            $toc_parts = self::generate_has_part_schema($content, $post->ID);
+            if (!empty($toc_parts)) {
+                $schema['hasPart'] = $toc_parts;
+            }
+        }
+        wp_reset_postdata();
+        return $schema;
+    }
     public function get_schema_for_page($post_id) {
+        $schema = [
+            '@context' => 'https://schema.org',
+            '@type' => 'WebPage',
+            'url' => get_permalink($post_id),
+            'headline' => get_the_title($post_id),
+            'datePublished' => get_the_date('c', $post_id),
+            'dateModified' => get_the_modified_date('c', $post_id),
+        ];
+        // Add the meta description
+        $description = get_post_meta($post_id, seo44_get_option('description_key'), true);
+        if (!empty($description)) {
+            $schema['description'] = esc_html(wp_strip_all_tags($description));
+        }
+        // Add the featured image as a detailed ImageObject
+        if (has_post_thumbnail($post_id)) {
+            $image_id = get_post_thumbnail_id($post_id);
+            $image_data = wp_get_attachment_image_src($image_id, 'full');
+            if ($image_data) {
+                $schema['primaryImageOfPage'] = [
+                    '@type' => 'ImageObject',
+                    'url' => $image_data[0],
+                    'width' => $image_data[1],
+                    'height' => $image_data[2]
+                ];
+            }
+        }
+    // Parse content for additional media if the setting is enabled
+    // NEW CODE for get_schema_for_page
+    if (seo44_get_option('scan_content_for_schema')) {
+        $media_schema = self::parse_content_for_media_schema($post_id);
+        if (!empty($media_schema['images'])) {
+            // 1. Start with the content images found
+            $all_images = $media_schema['images'];
+            // 2. If a Featured Image (primaryImageOfPage) exists, add it to the start of the list
+            if (isset($schema['primaryImageOfPage'])) {
+                array_unshift($all_images, $schema['primaryImageOfPage']);
+            }
+            // 3. Set the 'image' property to the complete list
+            $schema['image'] = $all_images;
+            // Optional: You can choose to keep or unset primaryImageOfPage.
+            // Keeping it is usually better for SEO so Google knows which one is "Main".
+            // This would be the code to cleanup the unset:
+            // unset($schema['primaryImageOfPage']);
+        }
+        if (!empty($media_schema['videos'])) {
+            $schema['video'] = $media_schema['videos'];
+        }
+    }
+        return $schema;
+        $schema = [
+            '@context' => 'https://schema.org',
+            '@type' => 'WebPage',
+            'url' => get_permalink($post_id),
+            'headline' => get_the_title($post_id),
+            'datePublished' => get_the_date('c', $post_id),
+            'dateModified' => get_the_modified_date('c', $post_id),
+        ];
+        // Add the meta description
+        $description = get_post_meta($post_id, seo44_get_option('description_key'), true);
+        if (!empty($description)) {
+            $schema['description'] = esc_html(wp_strip_all_tags($description));
+        }
+        // Add the featured image as a detailed ImageObject
+        $schema['image'] = [];
+        if (has_post_thumbnail($post_id)) {
+            $image_id = get_post_thumbnail_id($post_id);
+            $image_data = wp_get_attachment_image_src($image_id, 'full');
+            if ($image_data) {
+                $schema['primaryImageOfPage'] = [
+                    '@type' => 'ImageObject',
+                    'url' => $image_data[0],
+                    'width' => $image_data[1],
+                    'height' => $image_data[2]
+                ];
+                // Initialize main image list with featured image
+                $schema['image'][] = $schema['primaryImageOfPage'];
+            }
+        }
+        // Parse content for additional media if the setting is enabled
+        // NEW CODE for get_schema_for_page
+        if (seo44_get_option('scan_content_for_schema')) {
+            $media_schema = self::parse_content_for_media_schema($post_id);
+            if (!empty($media_schema['images'])) {
+                // 1. Re-index to prevent "0": {...} keys
+                $schema['image'] = array_merge($schema['image'], $media_schema['images']);
+            }
+            if (!empty($media_schema['videos'])) {
+                $schema['video'] = $media_schema['videos'];
+            }
+        }
+        // 2. Ensure clean array (re-index)
+        if (!empty($schema['image'])) {
+            $schema['image'] = array_values($schema['image']);
+        } else {
+            unset($schema['image']);
+        }
+       // NEW: Dynamic Table of Contents (hasPart)
+        // Only run this if we are scanning content, to save performance
+        if (seo44_get_option('enable_jumplinks_schema')) {
+            // We need to fetch content first since get_schema_for_page doesn't always have it ready
+            $post_content = get_the_content(null, false, $post_id);
+            $toc_parts = self::generate_has_part_schema($post_content, $post_id);
+            if (!empty($toc_parts)) {
+                $schema['hasPart'] = $toc_parts;
+            }
+        }
+        return $schema;
+    }
     public function get_schema_for_website() {
         $schema = [
             '@context' => 'https://schema.org',
             '@type' => 'WebSite',
             'url' => home_url('/'),
             'name' => get_bloginfo('name'),
             'description' => get_bloginfo('description'),
             'potentialAction' => [
                 '@type' => 'SearchAction',
                 'target' => home_url('/?s={search_term_string}'),
                 'query-input' => 'required name=search_term_string',
             ],
         ];
         return $schema;
+    }
     // --- Assemble Organization Schema ---
     public function get_schema_for_organization() {
+        $schema = [
+            '@context' => 'https://schema.org',
+            '@type' => 'WebSite',
+            'url' => home_url('/'),
+            'name' => get_bloginfo('name'),
+            'description' => get_bloginfo('description'),
+            'potentialAction' => [
+                '@type' => 'SearchAction',
+                'target' => home_url('/?s={search_term_string}'),
+                'query-input' => 'required name=search_term_string',
+            ],
+        ];
+        return $schema;
+    }
+    // --- Assemble Organization Schema ---
+    public function get_schema_for_organization() {
         // 1. Name & URL
         $name = seo44_get_option('org_name') ?: get_bloginfo('name');
 …
         // For sameAs, a URL is desired. Add URLs from fields and construct Twitter / X and Facebook URL
         // Twitter/X: Handle logic
         $twitter_handle = seo44_get_option('twitter_handle');
         if ( !empty($twitter_handle) && is_string($twitter_handle) ) {
             // Clean handle just in case they added @
             $clean_handle = str_replace('@', '', $twitter_handle);
             $same_as[] = 'https://x.com/' . esc_attr($clean_handle);
+        }
+        // Twitter/X: Handle logic
+        $twitter_handle = seo44_get_option('twitter_handle');
+        if ( !empty($twitter_handle) && is_string($twitter_handle) ) {
+            // Clean handle just in case they added @
+            $clean_handle = str_replace('@', '', $twitter_handle);
+            $same_as[] = 'https://x.com/' . esc_attr($clean_handle);
+        }
         $extras = ['social_facebook', 'social_instagram', 'social_linkedin', 'social_youtube', 'social_tiktok'];
 …
             if ($val) $same_as[] = esc_url($val);
+        }
         // NEW: Process Additional URLs (One per line)
         $additional_urls = seo44_get_option('social_additional');
         if ( !empty($additional_urls) && is_string($additional_urls) ) {
             // Split by newline, trim whitespace, and filter empty lines
             $urls = array_filter(array_map('trim', explode("\n", $additional_urls)));
             foreach ($urls as $raw_url) {
                 // Validate it is a real URL before adding
                 $clean_url = esc_url_raw($raw_url);
                 if (!empty($clean_url)) {
                     $same_as[] = $clean_url;
+                }
+            }
+        }
+        // NEW: Process Additional URLs (One per line)
+        $additional_urls = seo44_get_option('social_additional');
+        if ( !empty($additional_urls) && is_string($additional_urls) ) {
+            // Split by newline, trim whitespace, and filter empty lines
+            $urls = array_filter(array_map('trim', explode("\n", $additional_urls)));
+            foreach ($urls as $raw_url) {
+                // Validate it is a real URL before adding
+                $clean_url = esc_url_raw($raw_url);
+                if (!empty($clean_url)) {
+                    $same_as[] = $clean_url;
+                }
+            }
+        }
         // 4. Build the Schema
 …
         ];
         // Add Alternate Name
         $alt_name = seo44_get_option('org_alternate_name');
         if ($alt_name) {
             $schema['alternateName'] = $alt_name;
+        }
+        // Add Alternate Name
+        $alt_name = seo44_get_option('org_alternate_name');
+        if ($alt_name) {
+            $schema['alternateName'] = $alt_name;
+        }
         // Add Tagline (Slogan)
 …
         // Contact Point (Updated to include Email)
         $phone = seo44_get_option('org_phone');
         $email = seo44_get_option('org_email');
         if ($phone || $email) {
             $contact_point = ['@type' => 'ContactPoint'];
             if ($phone) {
                 $contact_point['telephone'] = $phone;
                 $contact_point['contactType'] = 'customer service';
+            }
             if ($email) {
                 $contact_point['email'] = $email;
+            }
             $schema['contactPoint'] = $contact_point;
+        }
         // Email at the top level is also good practice
         if ($email) {
             $schema['email'] = $email;
+        }
         // 5. Address
         $street = seo44_get_option('org_address_street');
         $city   = seo44_get_option('org_address_city');
         if ($street && $city) {
             $schema['address'] = [
                 '@type'           => 'PostalAddress',
                 'streetAddress'   => $street,
                 'addressLocality' => $city,
                 'addressRegion'   => seo44_get_option('org_address_state'),
                 'postalCode'      => seo44_get_option('org_address_zip'),
                 'addressCountry'  => seo44_get_option('org_address_country')
             ];
+        }
         // Service Area (New)
         $area_served = seo44_get_option('org_area_served');
         if ($area_served) {
             $schema['areaServed'] = [
                 '@type' => 'Place',
                 'name'  => $area_served
             ];
+        }
         // 6. Founder
         $founder = seo44_get_option('org_founder');
         if ($founder) {
             $schema['founder'] = [
                 '@type' => 'Person',
                 'name'  => $founder
             ];
+        }
         // 7. Founding Date
         $founding_date = seo44_get_option('org_founding_date');
         if ( !empty($founding_date) && is_string($founding_date) ) {
             // Basic validation: ensure it looks somewhat like a year or date
             // You can leave it as raw string, Google parses ISO 8601 (YYYY-MM-DD) well.
             $schema['foundingDate'] = strip_tags($founding_date);
+        }
         // 8. Professional License (New)
         $license = seo44_get_option('org_license');
         if ($license) {
             // "hasCredential" is the modern schema property for this
             $schema['hasCredential'] = [
                 '@type' => 'EducationalOccupationalCredential',
                 'credentialCategory' => 'license',
                 'name' => $license, // e.g., "Contractor License #123456"
                 'recognizedBy' => [
                     '@type' => 'Organization',
                     'name' => 'State Licensing Board' // Generic fallback since we don't ask for the issuer
+                ]
             ];
             // Also add it as a simple identifier for wider compatibility
             $schema['identifier'] = $license;
+        }
         // FINAL STEP: Apply Filters for Extensibility using 'seo44_organization_schema'
+        $phone = seo44_get_option('org_phone');
+        $email = seo44_get_option('org_email');
+        if ($phone || $email) {
+            $contact_point = ['@type' => 'ContactPoint'];
+            if ($phone) {
+                $contact_point['telephone'] = $phone;
+                $contact_point['contactType'] = 'customer service';
+            }
+            if ($email) {
+                $contact_point['email'] = $email;
+            }
+            $schema['contactPoint'] = $contact_point;
+        }
+        // Email at the top level is also good practice
+        if ($email) {
+            $schema['email'] = $email;
+        }
+        // 5. Address
+        $street = seo44_get_option('org_address_street');
+        $city   = seo44_get_option('org_address_city');
+        if ($street && $city) {
+            $schema['address'] = [
+                '@type'           => 'PostalAddress',
+                'streetAddress'   => $street,
+                'addressLocality' => $city,
+                'addressRegion'   => seo44_get_option('org_address_state'),
+                'postalCode'      => seo44_get_option('org_address_zip'),
+                'addressCountry'  => seo44_get_option('org_address_country')
+            ];
+        }
+        // Service Area (New)
+        $area_served = seo44_get_option('org_area_served');
+        if ($area_served) {
+            $schema['areaServed'] = [
+                '@type' => 'Place',
+                'name'  => $area_served
+            ];
+        }
+        // 6. Founder
+        $founder = seo44_get_option('org_founder');
+        if ($founder) {
+            $schema['founder'] = [
+                '@type' => 'Person',
+                'name'  => $founder
+            ];
+        }
+        // 7. Founding Date
+        $founding_date = seo44_get_option('org_founding_date');
+        if ( !empty($founding_date) && is_string($founding_date) ) {
+            // Basic validation: ensure it looks somewhat like a year or date
+            // You can leave it as raw string, Google parses ISO 8601 (YYYY-MM-DD) well.
+            $schema['foundingDate'] = wp_strip_all_tags($founding_date);
+        }
+        // 8. Professional License (New)
+        $license = seo44_get_option('org_license');
+        if ($license) {
+            // "hasCredential" is the modern schema property for this
+            $schema['hasCredential'] = [
+                '@type' => 'EducationalOccupationalCredential',
+                'credentialCategory' => 'license',
+                'name' => $license, // e.g., "Contractor License #123456"
+                'recognizedBy' => [
+                    '@type' => 'Organization',
+                    'name' => 'State Licensing Board' // Generic fallback since we don't ask for the issuer
+                ]
+            ];
+            // Also add it as a simple identifier for wider compatibility
+            $schema['identifier'] = $license;
+        }
+        // FINAL STEP: Apply Filters for Extensibility using 'seo44_organization_schema'
         // Allows developers to add properties like 'duns', 'naics', 'awards', etc.
         return apply_filters('seo44_organization_schema', $schema);
+    }
     // --- Intelligent Schema Detection ---
+        return apply_filters('seo44_organization_schema', $schema);
+    }
+    // --- Intelligent Schema Detection ---
     /**
 …
         $post = get_post($post_id);
         if (!$post) return [];
+        // 1. Try Advanced HowTo (Jump Links Content Miner)
+        // This runs FIRST to see if we have a robust HowTo available
+        $advanced_howto = $this->generate_advanced_howto_schema($post);
+        $final_schemas = [];
+        if (!empty($advanced_howto)) {
+            $final_schemas[] = $advanced_howto;
+        }
+        // 2. Run standard detection for FAQ and HowTo (if not already found)
+        // We still run this for FAQPage, but we might skip HowTo if advanced found one
         if (has_blocks($post->post_content)) {
+            // Use the precise block-based parser for modern content
+            return $this->parse_blocks_for_special_schema($post_id, parse_blocks($post->post_content));
+            $standard_schemas = $this->parse_blocks_for_special_schema($post_id, parse_blocks($post->post_content), !empty($advanced_howto)); // Pass "skip_howto" flag
         } else {
             // Use the HTML fallback for classic editor or page builder content
             // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound
+            // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound
             $rendered_content = apply_filters('the_content', $post->post_content);
+            return $this->parse_html_for_special_schema($post_id, $rendered_content);
+        }
+    }
+            $standard_schemas = $this->parse_html_for_special_schema($post_id, $rendered_content, !empty($advanced_howto));
+        }
+        if (!empty($standard_schemas)) {
+             $final_schemas = array_merge($final_schemas, $standard_schemas);
+        }
+        return $final_schemas;
+    }
     /**
      * NEW: Parses HTML content for FAQ and How-To patterns (the fallback method).
+     * Advanced HowTo Scanner (The "Content Miner")
+     * Uses Jump Links block as a map to mine content between headings.
      */
+    private function parse_html_for_special_schema($post_id, $html) {
+    private function generate_advanced_howto_schema($post) {
+        // 0. Check Cache
+        $cache_key = 'seo44_howto_' . $post->ID . '_' . $post->post_modified;
+        $cached_schema = get_transient($cache_key);
+        if ($cached_schema !== false) {
+            return $cached_schema;
+        }
+        // 1. Strict Check: Is the HowTo Checkbox enabled?
+        $enable_howto_meta = get_post_meta($post->ID, '_seo44_enable_howto', true);
+        if ($enable_howto_meta !== 'yes') {
+            return null;
+        }
+        // 2. Parse Blocks and Find Jump Links Block
+        $blocks = parse_blocks($post->post_content);
+        $flat_blocks = $this->flatten_blocks($blocks);
+        $jump_links_block = $this->find_jump_links_block($flat_blocks);
+        if (!$jump_links_block) return null;
+        // 3. Setup Variables
+        $desc_key = seo44_get_option('description_key') ?: 'seo44_description';
+        $desc = get_post_meta($post->ID, $desc_key, true);
+        if (empty($desc)) {
+             $desc = get_post_meta($post->ID, '_yoast_wpseo_metadesc', true) ?: get_post_meta($post->ID, '_aioseop_description', true);
+             if (empty($desc)) {
+                 $desc = get_the_excerpt($post->ID);
+                 if (empty($desc)) {
+                     $desc = wp_trim_words(strip_shortcodes($post->post_content), 25);
+                 }
+             }
+        }
+        $steps = [];
+        $current_step = null;
+        $tools = [];
+        $supplies = [];
+        $total_time = '';
+        $prep_time = '';
+        $perform_time = '';
+        $found_first_step = false;
+        $potential_list_type = '';
+        $video_schema = [];
+        $yield = '';
+        // 4. Iterate Blocks
+        foreach ($flat_blocks as $block) {
+            // --- PHASE A: PRE-STEP SCANNING (Intro) ---
+            if (!$found_first_step) {
+                if ($block['blockName'] === 'core/paragraph') {
+                    // FIX: Decode entities to ensure non-breaking spaces don't break the regex
+                    $text = html_entity_decode(wp_strip_all_tags($block['innerHTML']));
+                    // FIX: Updated Total Time Regex to prevent matching "Prep Time" as "Time"
+                    // Logic: Match "Total Time" OR "Time" that is NOT preceded by Prep/Active/Cook
+                    if (empty($total_time)) {
+                        $total_time = $this->parse_duration_string($text, '(?:Total\s+|(?<!Prep\s|ation\s|Active\s|Cook\s))Time:\s*');
+                    }
+                    if (empty($prep_time)) $prep_time = $this->parse_duration_string($text, 'Prep(?:aration)?\s*Time:\s*');
+                    if (empty($perform_time)) $perform_time = $this->parse_duration_string($text, '(?:Perform|Active|Cook)\s*Time:\s*');
+                    if (empty($yield) && preg_match('/(?:Yields|Makes):\s*(.+)/i', $text, $matches)) {
+                        $yield = trim($matches[1]);
+                    }
+                    // FIX: Scan for Comma-Separated Tools/Supplies in Paragraphs
+                    // e.g. "Tools: Hammer, Nails, Wood"
+                    if (preg_match('/(?:Tools?|Equipment|Ingredients?|Supplies|Materials?):\s*(.+)/i', $text, $matches)) {
+                        $type = (stripos($matches[0], 'tool') !== false || stripos($matches[0], 'equipment') !== false) ? 'tool' : 'supply';
+                        $items = explode(',', $matches[1]);
+                        foreach ($items as $item) {
+                            $clean_item = trim($item);
+                            $clean_item = rtrim($clean_item, '.'); // Remove trailing period
+                            if (!empty($clean_item)) {
+                                if ($type === 'tool') {
+                                    $tools[] = ['@type' => 'HowToTool', 'name' => $clean_item];
+                                } else {
+                                    $supplies[] = ['@type' => 'HowToSupply', 'name' => $clean_item];
+                                }
+                            }
+                        }
+                    }
+                }
+                // (Bullet list logic remains the same)
+                if ($block['blockName'] === 'core/heading') {
+                    $text = strtolower(wp_strip_all_tags($block['innerHTML']));
+                    if (strpos($text, 'tool') !== false || strpos($text, 'equipment') !== false) {
+                        $potential_list_type = 'tool';
+                    } elseif (strpos($text, 'material') !== false || strpos($text, 'suppl') !== false || strpos($text, 'ingredient') !== false) {
+                        $potential_list_type = 'supply';
+                    } else {
+                        $potential_list_type = '';
+                    }
+                }
+                if ($block['blockName'] === 'core/list' && $potential_list_type) {
+                     if (preg_match_all('/<li[^>]*>(.*?)<\/li>/s', $block['innerHTML'], $list_matches)) {
+                         foreach ($list_matches[1] as $li_text) {
+                             $clean_li = trim(wp_strip_all_tags($li_text));
+                             if ($potential_list_type === 'tool') {
+                                 $tools[] = ['@type' => 'HowToTool', 'name' => $clean_li];
+                             } else {
+                                 $supplies[] = ['@type' => 'HowToSupply', 'name' => $clean_li];
+                             }
+                         }
+                     }
+                     $potential_list_type = '';
+                }
+                // (Video logic remains the same)
+                if ($block['blockName'] === 'core/embed' && isset($block['attrs']['providerNameSlug']) && $block['attrs']['providerNameSlug'] === 'youtube') {
+                    $video_url = $block['attrs']['url'];
+                    $video_id = self::extract_youtube_video_id($video_url);
+                    $upload_date = self::get_youtube_upload_date($video_id, $post->ID);
+                    $oembed_url = 'https://www.youtube.com/oembed?format=json&url=' . urlencode($video_url);
+                    $response = wp_remote_get($oembed_url);
+                    $vid_title = ''; $vid_thumb = ''; $vid_author = '';
+                    if (!is_wp_error($response)) {
+                        $data = json_decode(wp_remote_retrieve_body($response), true);
+                        if ($data) {
+                            $vid_title = $data['title'];
+                            $vid_thumb = $data['thumbnail_url'];
+                            $vid_author = $data['author_name'];
+                        }
+                    }
+                    if (empty($vid_title)) $vid_title = get_the_title($post->ID) . ' Video Tutorial';
+                    if (empty($vid_thumb)) $vid_thumb = 'https://i.ytimg.com/vi/' . $video_id . '/hqdefault.jpg';
+                    $video_schema = [
+                        '@type' => 'VideoObject',
+                        'name' => $vid_title,
+                        'description' => get_the_title($post->ID) . ' - Video Guide',
+                        'thumbnailUrl' => $vid_thumb,
+                        'uploadDate' => $upload_date,
+                        'embedUrl' => $video_url,
+                        'contentUrl' => $video_url
+                    ];
+                    if ($vid_author) {
+                        $video_schema['author'] = ['@type' => 'Person', 'name' => $vid_author];
+                    }
+                }
+            }
+            // --- PHASE B: STEP MINING ---
+            if ($block['blockName'] === 'core/heading') {
+                if (preg_match('/id="([^"]+)"/', $block['innerHTML'], $id_match)) {
+                    $anchor_id = $id_match[1];
+                    // --- EXCLUSION LOGIC START ---
+                    $whitelist_ids = get_post_meta($post->ID, '_seo44_howto_step_ids', true);
+                    $should_include = true;
+                    // STRATEGY A: Whitelist (New System)
+                    if ( ! empty($whitelist_ids) && is_array($whitelist_ids) ) {
+                        if ( ! in_array($anchor_id, $whitelist_ids) ) {
+                            $should_include = false;
+                        }
+                        // FIX: Global Guard for Intro/Description
+                        // Even if whitelisted, ignore Intro headings so they don't consume metadata
+                        // May not need this...
+                        if (stripos($anchor_id, 'intro') !== false || stripos($anchor_id, 'description') !== false) {
+                            $should_include = false;
+                        }
+                    }
+                    // STRATEGY B: Fallback
+                    else {
+                        if (stripos($anchor_id, 'intro') !== false) { $should_include = false; }
+                        if (substr($anchor_id, -7) === '-nostep') { $should_include = false; }
+                    }
+                    if ( ! $should_include ) {
+                        if ($current_step) { $steps[] = $current_step; $current_step = null; }
+                        continue;
+                    }
+                    // --- EXCLUSION LOGIC END ---
+                    $found_first_step = true;
+                    if ($current_step) { $steps[] = $current_step; }
+                    $current_step = [
+                        '@type' => 'HowToStep',
+                        'url'   => get_permalink($post->ID) . '#' . $anchor_id,
+                        'name'  => trim(wp_strip_all_tags($block['innerHTML'])),
+                        'text'  => '',
+                        'image' => []
+                    ];
+                    continue;
+                }
+            }
+            if ($current_step) {
+                if ($block['blockName'] === 'core/paragraph') {
+                    $text = trim(wp_strip_all_tags($block['innerHTML']));
+                    if (!empty($text)) { $current_step['text'] .= $text . ' '; }
+                }
+                if ($block['blockName'] === 'core/image') {
+                     if (preg_match('/src="([^"]+)"/', $block['innerHTML'], $match)) {
+                         if (!isset($current_step['image'])) { $current_step['image'] = []; }
+                         $current_step['image'][] = $match[1];
+                     }
+                }
+                if ($block['blockName'] === 'core/list') {
+                    $current_step['text'] .= trim(wp_strip_all_tags($block['innerHTML'])) . ' ';
+                }
+            }
+        }
+        if ($current_step) { $steps[] = $current_step; }
+        if (!empty($steps)) {
+            foreach ($steps as $k => $step) {
+                if (empty($step['image'])) {
+                    $steps[$k]['image'] = '';
+                } elseif (count($step['image']) === 1) {
+                    $steps[$k]['image'] = $step['image'][0];
+                }
+                $steps[$k]['text'] = trim($step['text']);
+            }
+            $howto = [
+                '@context' => 'https://schema.org',
+                '@type'    => 'HowTo',
+                'name'     => get_the_title($post->ID),
+                'description' => $desc,
+                'step'     => $steps
+            ];
+            if ($total_time) { $howto['totalTime'] = $total_time; }
+            if ($prep_time) { $howto['prepTime'] = $prep_time; }
+            if ($perform_time) { $howto['performTime'] = $perform_time; }
+            if (!empty($tools)) { $howto['tool'] = $tools; }
+            if (!empty($supplies)) { $howto['supply'] = $supplies; }
+            if (!empty($video_schema)) { $howto['video'] = $video_schema; }
+            if ($yield) { $howto['yield'] = $yield; }
+            $howto['disambiguatingDescription'] = $desc;
+            if (has_post_thumbnail($post->ID)) {
+                 $howto['image'] = get_the_post_thumbnail_url($post->ID, 'full');
+            }
+            $categories = get_the_category($post->ID);
+            if (!empty($categories)) {
+                 $howto['about'] = ['@type' => 'Thing', 'name' => $categories[0]->name];
+            }
+            $tags = get_the_tags($post->ID);
+            if (!empty($tags)) {
+                 $howto['teaches'] = ['@type' => 'DefinedTerm', 'name' => $tags[0]->name];
+            }
+            set_transient($cache_key, $howto, DAY_IN_SECONDS);
+            return $howto;
+        }
+        return null;
+    }
+    /**
+     * Helper: Parse Duration Strings
+     * FIX: Re-wrote to accept raw patterns without delimiters to prevent syntax errors.
+     */
+    private function parse_duration_string($text, $prefix_pattern) {
+        // We construct the full regex here to ensure delimiters wrap the WHOLE pattern.
+        // Matches: Label -> (1) Hours -> (2) Minutes
+        $regex = '/' . $prefix_pattern . '(?:(\d+)\s*(?:hour|hr)s?\s*)?(?:and\s*)?(?:(\d+)\s*(?:minute|min)s?)?/i';
+        if (preg_match($regex, $text, $matches)) {
+            $hours = !empty($matches[1]) ? intval($matches[1]) : 0;
+            $minutes = !empty($matches[2]) ? intval($matches[2]) : 0;
+            if ($hours > 0 || $minutes > 0) {
+                 $duration = 'PT';
+                 if ($hours > 0) $duration .= $hours . 'H';
+                 if ($minutes > 0) $duration .= $minutes . 'M';
+                 return $duration;
+            }
+        }
+        return '';
+    }
+//    private function get_youtube_id($url) {
+//        preg_match('/(?:youtube\.com\/(?:[^\/]+\/.+\/|(?:v|e(?:mbed)?)\/|.*[?&]v=)|youtu\.be\/)([^"&?\/\s]{11})/i', $url, $matches);
+//        return isset($matches[1]) ? $matches[1] : '';
+//    }
+    /**
+     * Helper: Flattens nested block structures into a single linear array.
+     */
+    private function flatten_blocks($blocks) {
+        $flat = [];
+        foreach ($blocks as $block) {
+            $flat[] = $block;
+            if (!empty($block['innerBlocks'])) {
+                $flat = array_merge($flat, $this->flatten_blocks($block['innerBlocks']));
+            }
+        }
+        return $flat;
+    }
+    /**
+     * Helper to find the Jump Links block recursively
+     * Updated to be broader and find any block with 'jump-links' in the name
+     * FIX: Added check to ensure blockName is a string before strpos
+     */
+    private function find_jump_links_block($blocks) {
+        foreach ($blocks as $block) {
+            // Broad check for any jump links block
+            if (isset($block['blockName']) && is_string($block['blockName']) && strpos($block['blockName'], 'jump-links') !== false) {
+                return $block;
+            }
+            // Recursive check for inner blocks (e.g. inside Groups/Columns)
+            if (!empty($block['innerBlocks'])) {
+                $found = $this->find_jump_links_block($block['innerBlocks']);
+                if ($found) return $found;
+            }
+        }
+        return null;
+    }
+    private function parse_html_for_special_schema($post_id, $html, $skip_howto = false) {
         $final_schemas = [];
 …
+        }
         // HowTo Detection in HTML
         if (preg_match('/<h[2-4][^>]*>(installation|directions|instructions)<\/h[2-4]>/i', $html, $howto_heading_match)) {
+        // HowTo Detection (Skipped if Advanced scanner found one)
+        if (!$skip_howto && preg_match('/<h[2-4][^>]*>(installation|directions|instructions)<\/h[2-4]>/i', $html, $howto_heading_match)) {
             preg_match('/' . preg_quote($howto_heading_match[0], '/') . '.*?<ol.*?>(.*?)<\/ol>/is', $html, $ol_match);
             if(isset($ol_match[1])) {
 …
      * The original block-based parser, now in its own function.
      */
     private function parse_blocks_for_special_schema($post_id, $blocks) {
+    private function parse_blocks_for_special_schema($post_id, $blocks, $skip_howto = false) {
         $faq_questions = [];
         $howto_steps = [];
 …
         $final_schemas = [];
         foreach ($blocks as $block) {
+        foreach ($blocks as $block) {
             $heading_text = strtolower(wp_strip_all_tags($block['innerHTML']));
 …
+                }
                 $is_faq_section = false;
                 $is_howto_section = false; // Stop looking for HowTo steps as well
+                $is_howto_section = false;
                 $current_answer_blocks = [];
                 continue;
 …
+            }
+           // --- HowTo Detection ---
+            if (!$is_faq_section && $block['blockName'] === 'core/heading' && preg_match('/(installation|directions|instructions)/i', $heading_text)) {
+                $is_howto_section = true;
+                // Use trim() to remove leading/trailing whitespace and newlines
+                $howto_heading_text = trim(wp_strip_all_tags($block['innerHTML']));
+                continue; // Find the heading, then look for the list in subsequent blocks
+            }
+            // If we are in a how-to section and find the first ordered list, process it.
+            if ($is_howto_section && $block['blockName'] === 'core/list' && isset($block['attrs']['ordered']) && $block['attrs']['ordered']) {
+                 if (!empty($block['innerBlocks'])) {
+                    foreach($block['innerBlocks'] as $list_item_block) {
+                        if ($list_item_block['blockName'] === 'core/list-item') {
+                            $howto_steps[] = ['@type' => 'HowToStep', 'text' => esc_html(wp_strip_all_tags($list_item_block['innerHTML']))];
+            // HowTo Logic (Skipped if Advanced scanner found one)
+            if (!$skip_howto) {
+                if (!$is_faq_section && $block['blockName'] === 'core/heading' && preg_match('/(installation|directions|instructions)/i', $heading_text)) {
+                    $is_howto_section = true;
+                    // Use trim() to remove leading/trailing whitespace and newlines
+                    $howto_heading_text = trim(wp_strip_all_tags($block['innerHTML']));
+                    continue;  // Find the heading, then look for the list in subsequent blocks
+                }
+                // If we are in a how-to section and find the first ordered list, process it.
+                if ($is_howto_section && $block['blockName'] === 'core/list' && isset($block['attrs']['ordered']) && $block['attrs']['ordered']) {
+                     if (!empty($block['innerBlocks'])) {
+                        foreach($block['innerBlocks'] as $list_item_block) {
+                            if ($list_item_block['blockName'] === 'core/list-item') {
+                                $howto_steps[] = ['@type' => 'HowToStep', 'text' => esc_html(wp_strip_all_tags($list_item_block['innerHTML']))];
+                            }
+                        }
+                    }
+                }
                  $is_howto_section = false; // Stop after finding the first ordered list
+                     $is_howto_section = false; // Stop after finding the first ordered list
+                }
+            }
+        }
 …
     /**
      *  HELPER: Cleans and formats block content for an answer.
+     * HELPER: Cleans and formats block content for an answer.
      */
     private function clean_and_format_answer($blocks) {
 …
         // Clean up remaining HTML, extra whitespace, and decode entities
         $clean_text = trim(wp_strip_all_tags(html_entity_decode($answer_html)));
         return preg_replace('/\n\s*\n/', "\n", $clean_text); // Collapse multiple newlines
+    }
+        return preg_replace('/\n\s*\n/', "\n", $clean_text);
+    }
     // --- MEDIA PARSING FUNCTION ---
 …
         $content = $post->post_content;
         $found_block_image_urls = [];
+        $found_video_urls = []; // Fixed: Added missing variable declaration
+        $found_video_urls = [];
+        $default_description = get_the_title($post_id) . ' Video';
         if (has_blocks($content)) {
             $blocks = parse_blocks($content);
             foreach ($blocks as $block) {
                 // Handle Image Blocks
                 if ($block['blockName'] === 'core/image' && !empty($block['attrs']['id'])) {
 …
+                        }
                         $images[] = $image_object;
                         $found_block_image_urls[] = $image_data[0]; // Keep track of URLs we've already added
+                        $found_block_image_urls[] = $image_data[0];
+                    }
+                }
                 // Handle YouTube Embed Blocks using the oEmbed API
+                // Handle YouTube Embed Blocks using the oEmbed API + API/Scraping
                 if ($block['blockName'] === 'core/embed' && isset($block['attrs']['providerNameSlug']) && $block['attrs']['providerNameSlug'] === 'youtube') {
+                    $oembed_url = 'https://www.youtube.com/oembed?format=json&url=' . urlencode($block['attrs']['url']);
+                    $video_url = $block['attrs']['url'];
+                    // 1. Get Accurate Date
+                    $video_id = self::extract_youtube_video_id($video_url);
+                    $upload_date = self::get_youtube_upload_date($video_id, $post_id);
+                    // 2. Get Metadata
+                    $oembed_url = 'https://www.youtube.com/oembed?format=json&url=' . urlencode($video_url);
                     $response = wp_remote_get($oembed_url);
                     if (!is_wp_error($response)) {
                         $data = json_decode(wp_remote_retrieve_body($response), true);
 …
                                 'name' => $data['title'],
                                 'thumbnailUrl' => $data['thumbnail_url'],
+                                'embedUrl' => $block['attrs']['url'],
+                                'author' => ['@type' => 'Person', 'name' => $data['author_name']]
+                                'embedUrl' => $video_url,
+                                'contentUrl' => $video_url,
+                                'author' => ['@type' => 'Person', 'name' => $data['author_name']],
+                                'uploadDate' => $upload_date, // Uses API/Scraped date
+                                'description' => $default_description
                             ];
                             $found_video_urls[] = $block['attrs']['url']; // Track processed videos
+                            $found_video_urls[] = $video_url;
+                        }
+                    }
 …
+        }
  // --- Universal Fallback for <img> and <iframe> tags in Classic Editor or HTML Blocks---
         // Find Images (logic is unchanged)
+        // --- Universal Fallback for <img> and <iframe> tags ---
+        // Find Images
         if (preg_match_all('/<img[^>]+>/i', $content, $img_matches)) {
             foreach ($img_matches[0] as $img_tag) {
 …
                 if (preg_match('/src\s*=\s*[\'"]([^\'"]+)[\'"]/i', $img_tag, $src_matches)) {
                     $url = $src_matches[1];
-                    // Add the image ONLY if we haven't already added it from a core/image block
                     if (!in_array($url, $found_block_image_urls)) {
                         $images[] = ['@type' => 'ImageObject', 'url' => $url];
+                    }
+                }
+            }
+        }
         // RESTORED: Find iframes
+            }
+        }
+        // Find iframes for YouTube
         if (preg_match_all('/<iframe[^>]+src="([^"]+)"[^>]*>/i', $content, $iframe_matches)) {
             foreach($iframe_matches[1] as $iframe_src) {
+                // Skip if we already processed this video from a block
+                if (in_array($iframe_src, $found_video_urls)) {
+                    continue;
+                }
+                if (strpos($iframe_src, 'youtube.com/embed') !== false) {
+                    preg_match('/embed\/([a-zA-Z0-9_-]+)/i', $iframe_src, $id_matches);
+                    $video_id = $id_matches[1] ?? null;
+                    if ($video_id) {
+                        $videos[] = [
+                            '@type' => 'VideoObject',
+                            'name' => 'Embedded YouTube Video', // Title isn't available from a raw iframe
+                            'thumbnailUrl' => 'https://i.ytimg.com/vi/' . $video_id . '/hqdefault.jpg',
+                            'embedUrl' => 'https://www.youtube.com/watch?v=' . $video_id,
+                        ];
+                    }
+                if (in_array($iframe_src, $found_video_urls)) { continue; }
+                // Use the static helper to check ID
+                $video_id = self::extract_youtube_video_id($iframe_src);
+                if ($video_id) {
+                    $upload_date = self::get_youtube_upload_date($video_id, $post_id);
+                    $videos[] = [
+                        '@type' => 'VideoObject',
+                        'name' => 'Embedded YouTube Video',
+                        'description' => $default_description,
+                        'uploadDate' => $upload_date,
+                        'thumbnailUrl' => 'https://i.ytimg.com/vi/' . $video_id . '/hqdefault.jpg',
+                        'embedUrl' => 'https://www.youtube.com/watch?v=' . $video_id,
+                        'contentUrl' => 'https://www.youtube.com/watch?v=' . $video_id
+                    ];
+                }
+            }
 …
         return ['images' => $images, 'videos' => $videos];
+    }
     //  Function to generate BreadcrumbList schema for Taxonomy pages (not posts & Pages)
+    //  Function to generate BreadcrumbList schema for Taxonomy pages (not posts & Pages)
     public function get_schema_for_taxonomy() {
         $term = get_queried_object();
 …
         return $schema;
+    }
+    // Function to create author name
+    public function get_author_name( $author_id ) {
+        $format = seo44_get_option('author_format', 'display_name');
+        switch ($format) {
+            case 'first_last': return get_the_author_meta('first_name', $author_id) . ' ' . get_the_author_meta('last_name', $author_id);
+            case 'last_first': return get_the_author_meta('last_name', $author_id) . ', ' . get_the_author_meta('first_name', $author_id);
+            default: return get_the_author_meta('display_name', $author_id);
+        }
+    }
+    public static function get_author_name_static( $author_id ) {
+        $frontend = new self();
+        return $frontend->get_author_name( $author_id );
+    }
+    // Function to create author name
+    // With more graceful logic for missing name fields
+    public function get_author_name( $author_id ) {
+        $format = seo44_get_option('author_format', 'display_name');
+        // 1. Get the raw values first
+        $first_name = get_the_author_meta( 'first_name', $author_id );
+        $last_name  = get_the_author_meta( 'last_name', $author_id );
+        $formatted_name = '';
+        switch ( $format ) {
+            case 'first_last':
+                // 2. Concatenate and trim.
+                // If both are empty, trim() ensures we get "", not " ".
+                // If one is missing, it removes the leading/trailing space.
+                $formatted_name = trim( $first_name . ' ' . $last_name );
+                break;
+            case 'last_first':
+                // 3. Smart comma handling.
+                // Only add the comma if BOTH fields have data.
+                if ( ! empty( $last_name ) && ! empty( $first_name ) ) {
+                    $formatted_name = $last_name . ', ' . $first_name;
+                } else {
+                    // If one is missing, fall back to simple concatenation/trim without the comma
+                    $formatted_name = trim( $last_name . ' ' . $first_name );
+                }
+                break;
+            // Default case is handled by the fallback check below
+        }
+        // 4. The Fallback Check
+        // If formatted_name is empty (because fields were empty) OR format was 'display_name'
+        if ( empty( $formatted_name ) ) {
+            return get_the_author_meta( 'display_name', $author_id );
+        }
+        return $formatted_name;
+    }
+    public static function get_author_name_static( $author_id ) {
+        $frontend = new self();
+        return $frontend->get_author_name( $author_id );
+    }
+    /**
+     * Parses content for headings with IDs to create a "Table of Contents" schema.
+     * @param string $content The post content.
+     * @return array Array of WebPageElement objects.
+     */
+    // This could be updated to use IDS passed through to field from jump links block to be more efficient than scan and remove need for checkbox.
+    // UPDATED: Now respects whitelist to match "included" jump links
+    private static function generate_has_part_schema($content, $post_id) {
+        $has_part = [];
+        // Retrieve the whitelist of IDs (generated by JS when saving the Jump Links block)
+        $whitelist_ids = get_post_meta($post_id, '_seo44_howto_step_ids', true);
+        // Regex to find H2-H4 tags that have an ID attribute
+        if (preg_match_all('/<h[2-4][^>]*id="([^"]+)"[^>]*>(.*?)<\/h[2-4]>/i', $content, $matches, PREG_SET_ORDER)) {
+            foreach ($matches as $match) {
+                $anchor_id = $match[1];
+                $heading_text = wp_strip_all_tags($match[2]);
+                // --- FILTER LOGIC ---
+                // Default to include everything if no whitelist exists (e.g. old post, no jump links block)
+                // But if a whitelist exists (array), enforce it strictly.
+                $should_include = true;
+                if ( ! empty($whitelist_ids) && is_array($whitelist_ids) ) {
+                    if ( ! in_array($anchor_id, $whitelist_ids) ) {
+                        $should_include = false;
+                    }
+                }
+                if ($should_include && !empty($anchor_id) && !empty($heading_text)) {
+                    $has_part[] = [
+                        '@type' => 'WebPageElement',
+                        'name'  => $heading_text,
+                        'url'   => get_permalink($post_id) . '#' . $anchor_id,
+                        'cssSelector' => '#' . $anchor_id
+                    ];
+                }
+            }
+        }
+        return $has_part;
+    }
+    /**
+     * Extracts YouTube video ID from various URL formats
+     */
+    private static function extract_youtube_video_id($url) {
+        $patterns = [
+            '/youtube\.com\/watch\?v=([a-zA-Z0-9_-]+)/',            // Standard
+            '/youtube\.com\/embed\/([a-zA-Z0-9_-]+)/',              // Embed
+            '/youtu\.be\/([a-zA-Z0-9_-]+)/',                        // Short URL
+            '/youtube\.com\/v\/([a-zA-Z0-9_-]+)/',                  // Old format
+        ];
+        foreach ($patterns as $pattern) {
+            if (preg_match($pattern, $url, $matches)) {
+                return $matches[1];
+            }
+        }
+        return null;
+    }
+    /**
+     * Gets YouTube video upload date with multiple fallback strategies
+     * @param string $video_id YouTube video ID
+     * @param int $post_id WordPress post ID for fallback
+     * @return string ISO 8601 formatted date
+     */
+    private static function get_youtube_upload_date($video_id, $post_id) {
+        if (empty($video_id)) {
+            return get_the_date('c', $post_id);
+        }
+        // Strategy 1: Check transient cache (24 hour cache to avoid API limits)
+        $cache_key = 'seo44_yt_date_' . $video_id;
+        $cached_date = get_transient($cache_key);
+        if ($cached_date !== false) {
+            return $cached_date;
+        }
+        // Strategy 2: Try YouTube Data API (if configured)
+        $api_key = seo44_get_option('youtube_api_key');
+        if (!empty($api_key)) {
+            $api_date = self::fetch_youtube_date_from_api($video_id, $api_key);
+            if ($api_date) {
+                // Cache for 24 hours
+                set_transient($cache_key, $api_date, DAY_IN_SECONDS);
+                return $api_date;
+            }
+        }
+        // Strategy 3: Try scraping YouTube page (no API key needed, but less reliable)
+        $scraped_date = self::scrape_youtube_upload_date($video_id);
+        if ($scraped_date) {
+            // Cache for 24 hours
+            set_transient($cache_key, $scraped_date, DAY_IN_SECONDS);
+            return $scraped_date;
+        }
+        // Strategy 4: Fallback to post publication date
+        return get_the_date('c', $post_id);
+    }
+    /**
+     * Fetches upload date from YouTube Data API v3
+     */
+    private static function fetch_youtube_date_from_api($video_id, $api_key) {
+        $api_url = sprintf(
+            'https://www.googleapis.com/youtube/v3/videos?id=%s&key=%s&part=snippet',
+            urlencode($video_id),
+            urlencode($api_key)
+        );
+        $response = wp_remote_get($api_url, [
+            'timeout' => 5,
+            'sslverify' => true
+        ]);
+        if (is_wp_error($response)) {
+            return null;
+        }
+        $body = wp_remote_retrieve_body($response);
+        $data = json_decode($body, true);
+        if (isset($data['items'][0]['snippet']['publishedAt'])) {
+            return $data['items'][0]['snippet']['publishedAt'];
+        }
+        return null;
+    }
+    /**
+     * Scrapes upload date from YouTube page HTML (fallback method, no API key needed)
+     * IMPPROVED: Scans Meta tags first, then JSON-LD, then internal player data.
+     */
+    private static function scrape_youtube_upload_date($video_id) {
+        $video_page_url = 'https://www.youtube.com/watch?v=' . $video_id;
+        $response = wp_remote_get($video_page_url, [
+            'timeout' => 10,
+            // Use a generic browser agent to avoid being served a "bare" bot page
+            'user-agent' => 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36',
+            'sslverify' => true
+        ]);
+        if (is_wp_error($response)) {
+            return null;
+        }
+        $html = wp_remote_retrieve_body($response);
+        // Strategy A: Look for Meta Tags (Most Reliable)
+        // YouTube usually includes: <meta itemprop="datePublished" content="YYYY-MM-DD">
+        if (preg_match('/<meta\s+itemprop="datePublished"\s+content="([^"]+)"/i', $html, $matches)) {
+            return $matches[1];
+        }
+        if (preg_match('/<meta\s+itemprop="uploadDate"\s+content="([^"]+)"/i', $html, $matches)) {
+            return $matches[1];
+        }
+        // Strategy B: JSON-LD Schema (Your original method)
+        if (preg_match('/"uploadDate":"([^"]+)"/', $html, $matches)) {
+            return $matches[1];
+        }
+        // Strategy C: Look for microformatDataRenderer (Internal YouTube Data)
+        // This is often found inside the large ytInitialPlayerResponse JSON object
+        if (preg_match('/"publishDate":"([^"]+)"/', $html, $matches)) {
+            $date_string = $matches[1]; // Usually YYYY-MM-DD
+            if (preg_match('/^\d{4}-\d{2}-\d{2}$/', $date_string)) {
+                return $date_string;
+            }
+            // Fallback for compact format YYYYMMDD
+            if (preg_match('/^(\d{4})(\d{2})(\d{2})$/', $date_string, $date_parts)) {
+                return sprintf('%s-%s-%s', $date_parts[1], $date_parts[2], $date_parts[3]);
+            }
+        }
+        return null;
+    }
+}

search-appearance-toolkit-seo-44/trunk/includes/class-seo44-metabox.php

-                      r3389330
+                      r3423355
 <?php
+// Version 4.3 - Added a Generate HowTo Schema checkbox that appears via activation word
 class SEO44_Metabox {
 …
         $description = get_post_meta($post->ID, seo44_get_option('description_key'), true);
         $keywords = get_post_meta($post->ID, seo44_get_option('keywords_key'), true);
+        $jump_link_headings = get_post_meta($post->ID, '_seo44_jump_link_headings', true);
+        wp_nonce_field('seo44_jump_links_nonce', 'seo44_jump_links_nonce_field');
+        // NEW: Retrieve the HowTo toggle state
+        // We use 'yes' for checked, empty for unchecked
+        $enable_howto = get_post_meta($post->ID, '_seo44_enable_howto', true);
+        // Logic to determine initial visibility: Show if already checked
+        $howto_wrapper_style = ($enable_howto === 'yes') ? '' : 'display:none;';
     ?>
         <input type="hidden" id="seo44_jump_link_headings_field" name="seo44_jump_link_headings" value="<?php echo esc_attr($jump_link_headings); ?>">
         <p>
             <label for="seo44_title"><strong><?php esc_html_e('SEO Title', 'search-appearance-toolkit-seo-44'); ?></strong></label><br>
 …
         </p>
         <?php endif; ?>
+        <div id="seo44-howto-trigger-wrapper" style="<?php echo esc_attr($howto_wrapper_style); ?>">
+            <p>
+                <label for="seo44_enable_howto">
+                    <input type="checkbox" id="seo44_enable_howto" name="seo44_enable_howto" value="yes" <?php checked($enable_howto, 'yes'); ?>>
+                    <strong><?php esc_html_e('Generate HowTo Schema', 'search-appearance-toolkit-seo-44'); ?></strong>
+                </label>
+                <br>
+                <span class="description">
+                    <?php esc_html_e('It looks like you are publishing a "How-To" guide. When this box is checked, SEO 44 will generate HowTo structured data.', 'search-appearance-toolkit-seo-44'); ?>
+                </span>
+            </p>
+        </div>
         <hr>
         <div id="seo44-snippet-preview">
 …
     public function save_meta_box_data($post_id) {
         if (!isset($_POST['seo44_meta_box_nonce']) || !wp_verify_nonce(sanitize_text_field(wp_unslash($_POST['seo44_meta_box_nonce'])), 'seo44_save_meta_box_data')) return;
         if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE) return;
         $post_type = get_post_type($post_id);
         // Robust capability checking
         if (!current_user_can("edit_{$post_type}s")) {
+          if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE) return;
+          $post_type = get_post_type($post_id);
+          // Robust capability checking
+          if (!current_user_can("edit_{$post_type}s")) {
             return;
+        }
         if (isset($_POST['seo44_title'])) {
+          }
+          if (isset($_POST['seo44_title'])) {
             update_post_meta($post_id, seo44_get_option('title_key'), sanitize_text_field(wp_unslash($_POST['seo44_title'])));
+        }
 …
             update_post_meta($post_id, seo44_get_option('keywords_key'), sanitize_text_field(wp_unslash($_POST['seo44_keywords'])));
+        }
+            // Save Logic for Hidden Box for Jump Links Block data
+        if (isset($_POST['seo44_jump_links_nonce_field']) && wp_verify_nonce(sanitize_text_field(wp_unslash($_POST['seo44_jump_links_nonce_field'])), 'seo44_jump_links_nonce')) {
+            if (isset($_POST['seo44_jump_link_headings'])) {
+                update_post_meta($post_id, '_seo44_jump_link_headings', sanitize_text_field(wp_unslash($_POST['seo44_jump_link_headings'])));
+            }
+        // NEW: Save HowTo Checkbox
+        if (isset($_POST['seo44_enable_howto'])) {
+            update_post_meta($post_id, '_seo44_enable_howto', 'yes');
+        } else {
+            // Checkboxes don't send data if unchecked, so we must explicitly delete or update to 'no'
+            // Only do this if our nonce is verified (which implies the form was actually submitted)
+            update_post_meta($post_id, '_seo44_enable_howto', 'no');
+        }
+    }
+}

search-appearance-toolkit-seo-44/trunk/includes/class-seo44-settings.php

-                      r3405454
+                      r3423355
 <?php
+// Version 4.3
+// Added hasPart Table of Contents Schema, advanced HowTo Schema
+// Added YouTube Data API to Integrations
 class SEO44_Settings {
 …
         add_settings_field('seo44_schema_tools', __('Schema Scanner', 'search-appearance-toolkit-seo-44'), [$this, 'render_schema_tools'], 'seo-44_schema', 'seo44_schema_settings_section');
         add_settings_field('seo44_enable_schema', __('Enable Schema', 'search-appearance-toolkit-seo-44'), [$this, 'render_checkbox_field'], 'seo-44_schema', 'seo44_schema_settings_section', ['id' => 'enable_schema', 'label' => __('Output JSON-LD to your webpages.', 'search-appearance-toolkit-seo-44')]);
-        // NEW: Add checkbox for scanning content
         add_settings_field('seo44_scan_content_for_schema', __('Scan Content for Media', 'search-appearance-toolkit-seo-44'), [$this, 'render_checkbox_field'], 'seo-44_schema', 'seo44_schema_settings_section', [
             'id' => 'scan_content_for_schema',
 …
             'tooltip' => 'This provides more detail to search engines but can be slightly more resource-intensive.'
         ]);
+        // NEW: Add checkbox for advanced schema detection
+        add_settings_field('seo44_enable_advanced_schema', __('Enable Advanced Schema Detection', 'search-appearance-toolkit-seo-44'), [$this, 'render_checkbox_field'], 'seo-44_schema', 'seo44_schema_settings_section', [
+            'id' => 'enable_advanced_schema',
+            'label' => __('Scan content for patterns to generate FAQ and How-To schema.', 'search-appearance-toolkit-seo-44'),
+            'tooltip' => 'If special formats are detected, they will be added to your page\'s schema structured data.'
+        ]);
+        // UPDATED: Using custom callback to include the Jump Links Block recommendation
+        add_settings_field('seo44_enable_advanced_schema', __('Enable Advanced Schema Detection', 'search-appearance-toolkit-seo-44'), [$this, 'render_advanced_schema_checkbox'], 'seo-44_schema', 'seo44_schema_settings_section');
+        // NEW: Jump Links Integration Field
+        add_settings_field('seo44_enable_jumplinks_schema',
+            __('Generate "Table of Contents" Schema', 'search-appearance-toolkit-seo-44'),
+            [$this, 'render_checkbox_field'],
+            'seo-44_schema',
+            'seo44_schema_settings_section',
+            [
+                'id' => 'enable_jumplinks_schema',
+                'label' => __('Automatically create "hasPart" schema for headings highlighted in Jump Links Blocks, aligning structured data with Jump Links to reinforce support for Jump-to links in search results.', 'search-appearance-toolkit-seo-44'),
+                'tooltip' => 'This helps Google understand the deep structure of your article by mapping your headings (H2-H4) as distinct sections, complementing the visual Jump Links Block on your page.'
+            ]
+        );
         add_settings_field('seo44_enable_schema_on_taxonomies', __('Enable Schema on Taxonomies', 'search-appearance-toolkit-seo-44'), [$this, 'render_checkbox_field'], 'seo-44_schema', 'seo44_schema_settings_section', [
             'id' => 'enable_schema_on_taxonomies',
 …
+            ]
         );
         // 3. Add Address Fields (Crucial for Local SEO & Disambiguation)
         add_settings_field(
 …
         );
         add_settings_field(
             'org_phone',
 …
+            ]
         );
+        // --- Site APIs Header ---
+        add_settings_field(
+            'seo44_site_apis_header',
+            '', // Empty label for full-width header
+            [$this, 'render_site_apis_header_field'],
+            'seo-44_integrations',
+            'seo44_integrations_section'
+        );
+        // --- YouTube API Key ---
+        add_settings_field(
+            'youtube_api_key',
+            __('YouTube API Key', 'search-appearance-toolkit-seo-44'),
+            [$this, 'render_youtube_api_key_field'],
+            'seo-44_integrations',
+            'seo44_integrations_section',
+            [
+                'label_for' => 'youtube_api_key',
+                'tooltip'   => __('This will be used to improve the Video Object schema created for embedded YouTube Videos.', 'search-appearance-toolkit-seo-44')
+            ]
+        );
         // --- end of settings_init ---
+    }
 …
             'enable_tags', 'include_keywords', 'include_author',
             'enable_og_tags', 'enable_twitter_tags',
             'enable_schema', 'scan_content_for_schema', 'enable_advanced_schema', 'enable_schema_on_cpts', 'enable_schema_on_taxonomies','enable_organization_schema',
+            'enable_schema', 'scan_content_for_schema', 'enable_jumplinks_schema', 'enable_advanced_schema', 'enable_schema_on_cpts', 'enable_schema_on_taxonomies','enable_organization_schema',
             'enable_sitemaps', 'enable_sitemap_ping',
             'sitemap_include_images', 'sitemap_include_content_images',
 …
             'org_address_street', 'org_address_city', 'org_address_state', 'org_address_zip', 'org_address_country',
             'org_phone', 'org_email', 'org_area_served',
+            'youtube_api_key',
         ];
         foreach ($text_fields as $tf) {
 …
     <?php
+}
+    // UPDATED: Custom renderer for the Advanced Schema Checkbox
+    public function render_advanced_schema_checkbox() {
+        $id = 'enable_advanced_schema';
+        $checked = seo44_get_option($id);
+        // Output the standard checkbox
+        printf(
+            '<label for="%s"><input type="checkbox" id="%s" name="seo44_settings[%s]" value="1" %s /> %s</label>',
+            esc_attr($id),
+            esc_attr($id),
+            esc_attr($id),
+            checked($checked, 1, false),
+            esc_html__('Scan content for patterns to generate FAQ and How-To schema.', 'search-appearance-toolkit-seo-44')
+        );
+        seo44_render_tooltip('If special formats are detected, they will be added to your page\'s schema structured data.');
+        // Add the new recommendation text with the link
+        echo '<p class="description">';
+        echo esc_html__('For the most robust HowTo Schema, use a Jump Links Blocks for your How To steps. ', 'search-appearance-toolkit-seo-44');
+        echo '<a href="https://seo44plugin.com/search-appearance-toolkit-seo-44/schema-structured-data/" target="_blank">' . esc_html__('(Learn more)', 'search-appearance-toolkit-seo-44') . '</a>';
+        echo '</p>';
+    }
     public function render_textarea_field($args) {
 …
         echo '<p class="description">' . esc_html__('These tags are used to prove you own your site to search engines. Paste in your verification codes here and they will be added to your site\'s <head>.', 'search-appearance-toolkit-seo-44') . '</p>';
+    }
+    public function render_site_apis_header_field() {
+        echo '<h3>' . esc_html__('Site APIs', 'search-appearance-toolkit-seo-44') . '</h3>';
+        echo '<p class="description">' . esc_html__('Adding a YouTube API key fetches accurate video upload dates for schema structured data. Without this, video upload dates may fall back to your post publication date.', 'search-appearance-toolkit-seo-44') . '</p>';
+    }
+    public function render_youtube_api_key_field($args) {
+        $value = seo44_get_option('youtube_api_key');
+        $tooltip = isset($args['tooltip']) ? $args['tooltip'] : '';
+        ?>
+        <input type="text"
+               id="youtube_api_key"
+               name="seo44_settings[youtube_api_key]"
+               value="<?php echo esc_attr($value); ?>"
+               class="regular-text code">
+        <?php if ($tooltip) { seo44_render_tooltip($tooltip); } ?>
+        <p class="description">
+            <?php esc_html_e('Enter your YouTube Data API v3 key.', 'search-appearance-toolkit-seo-44'); ?>
+            <a href="https://developers.google.com/youtube/v3/getting-started" target="_blank">
+                <?php esc_html_e('Get API Key', 'search-appearance-toolkit-seo-44'); ?>
+            </a>
+        </p>
+        <?php
+    }
     public function settings_page_html() {
 …
             return;
+        }
         // --- START: SECURE TAB SWITCHING LOGIC ---

search-appearance-toolkit-seo-44/trunk/js/admin-script.js

-                      r3389330
+                      r3423355
 jQuery(document).ready(function($) {
     // --- NEW: Add custom class to metabox heading ---
+    // --- Add custom class to metabox heading ---
     // Find the metabox by its ID and then find the title element inside it.
     var metabox = $('#seo44_meta_box');
 …
         metabox.find('h2.hndle').addClass('seo44-metabox-heading');
+    }
+    // --- "Use Example" Title Button ---
+    $('#seo44-use-example-title').on('click', function() {
+        var exampleText = $('#seo44-title-example').text();
+        var titleInput = $('#seo44_title');
+        titleInput.val(exampleText);
+        // Trigger the keyup event to update the snippet preview and character counter
+        titleInput.trigger('keyup');
+    });
     // --- Character Counter Functionality (from v1.4) ---
 …
     createCounter('seo44_description', 'seo44_description_char_count', 160);
+    // --- NEW: "Use Example" Title Button ---
+    $('#seo44-use-example-title').on('click', function() {
+        var exampleText = $('#seo44-title-example').text();
+        var titleInput = $('#seo44_title');
+        titleInput.val(exampleText);
+    // --- HowTo Schema Trigger Logic ---
+    const howToWrapper = $('#seo44-howto-trigger-wrapper');
+    const howToCheckbox = $('#seo44_enable_howto');
+    const descriptionField = $('#seo44_description');
+    // List of triggers (lowercase)
+    const triggers = ['step guide', 'step-by-step', 'how to', 'how-to', 'guide', 'walkthrough', 'directions', 'instructions', 'tutorial'];
+    // Flag to track if user has manually overridden the automation
+    let userHasInteracted = false;
+    // Listen for manual clicks
+    howToCheckbox.on('change', function() {
+        userHasInteracted = true;
+    });
+    function checkHowToTriggers() {
+        // 1. If user manually touched the box, do nothing.
+        if (userHasInteracted) return;
+        // 2. Get description text
+        const text = descriptionField.val().toLowerCase();
+        // Trigger the keyup event to update the snippet preview and character counter
+        titleInput.trigger('keyup');
+    });
+        // 3. Check for triggers
+        const hasTrigger = triggers.some(trigger => text.includes(trigger));
+        if (hasTrigger) {
+            // Found a trigger!
+            howToWrapper.show(); // Make visible
+            // Only check it if it wasn't already checked (to avoid redundant events)
+            if (!howToCheckbox.is(':checked')) {
+                howToCheckbox.prop('checked', true);
+            }
+        } else {
+            // No trigger found.
+            // Behavior: If we are purely automated (user hasn't clicked),
+            // we hide it and uncheck it.
+            howToWrapper.hide();
+            howToCheckbox.prop('checked', false);
+        }
+    }
+    // Run on keyup in description
+    descriptionField.on('keyup change paste', checkHowToTriggers);
+    // Run once on load to handle pre-filled content (if user hasn't saved yet)
+    // We delay slightly to ensure values are populated
+    setTimeout(function() {
+        // Only run auto-check if the box is currently hidden/unchecked.
+        // If it's already visible/checked from DB, we respect that state.
+        if (!howToCheckbox.is(':checked')) {
+            checkHowToTriggers();
+        } else {
+            // If it IS checked from DB, mark as "interacted" so we don't auto-uncheck it
+            // just because the user edits the description and removes a keyword.
+            userHasInteracted = true;
+        }
+    }, 500);
     // --- Snippet Preview Functionality ---
     const titleInput = $('#seo44_title');
     const descriptionInput = $('#seo44_description');
     const previewHeaderUrl = $('.seo44-preview-breadcrumb-url');
     const previewTitle = $('.seo44-preview-title');
 …
     const siteName = seo44_data.site_name;
     const permalink = seo44_data.permalink;
     function updatePreview() {
         // Update Title
         let titleVal = titleInput.val();
+        previewTitle.text(titleVal ? titleVal : defaultTitle);
+       // if (titleVal) {
+       //     previewTitle.text(titleVal);
+       // } else {
+            // If the input is empty, show "Post Title - Site Name"
+        //    previewTitle.text(defaultTitle + ' - ' + siteName);
+        //}
+        previewTitle.text(titleVal ? titleVal : defaultTitle);
         // Update Description
 …
             previewDescription.text('Enter a meta description to see how it will appear in search results...');
+        }
         // Update Breadcrumb URL
+        // Update Breadcrumb URL
         let breadcrumb = permalink.replace(/^https?:\/\//, '').replace(/\/$/, '');
         breadcrumb = breadcrumb.replace(/\//g, ' &rsaquo; '); // &rsaquo; is the > symbol

search-appearance-toolkit-seo-44/trunk/readme.txt

-                      r3405454
+                      r3423355
 Tags: seo, on-page seo, schema, structured data, xml sitemaps
 Requires at least: 5.5
 Tested up to: 6.8
 Stable tag: 4.2
+Tested up to: 6.9
+Stable tag: 4.3
 Requires PHP: 7.4
 License: GPLv2 or later
 …
 * **Knowledge Graph Control:** A dedicated interface to manage your brand's digital identity. Define your Founder, Founding Date, Contact Info, and professional Credentials to improve E-E-A-T signals.
 * **Include Images and Videos:** A built-in tool automatically finds all images and embedded YouTube videos in your content and adds them to the schema, boosting their appearance in search results.
+* **FAQ and How-To Detection:** Enable a smart scanner to detect patterns in your content for FAQ and How-To sections on your website and incorporate this useful format into the schema.
+* **FAQ and How-To Detection:** Enable smart scanners to detect patterns in your content for FAQ and How-To sections on your website and incorporate this useful format into the schema.
+* **Jump Links HowTo Scanner:** The plugin can use a Jump Links Block as a "Map" to generate detailed HowTo schema steps, while simultaneously scanning your content for Prep Time, Yield, Supplies, and Tools.
+* **Table of Contents Schema:** Automatically generates `hasPart` structured data that mirrors your Jump Links Block, helping search engines understand your article's deep structure.
 * **Modern Output:** All structured data is generated in the modern JSON-LD format preferred by search engines, following the guidelines set by [Schema.org](https://schema.org/).
 * **Granular Control:**  Tailor the Schema settings to fit your site's needs through Enable/disable settings, including on Custom Post Types and Taxonomies.
 …
 The Search Appearance Toolkit serves as a hub for connecting your site to essential third-party services, helping you to create valuable analytics data and site insights.
-= Site Verification =
-Verify your site with search engines quickly and easily. Paste your verification codes for **Google Search Console** and **Bing Webmaster Tools** into the corresponding fields in the Integrations tab. The plugin handles the rest, adding site verification meta tags to your website's head. No coding required.
 = Google Tag Manager (GTM) Integration =
 Easily integrate with Google Tag Manager by pasting your `GTM-XXXXXXX` ID into the settings field. The plugin will correctly and safely inject the GTM scripts into your site's `<head>` and `<body>` on every page. No coding required.
 …
 * **Jump Link Click Tracking:** Tracks engagement with your Jump Links Block by pushing a `jump_link_click` event, letting you see which sections your users are most interested in.
+SEO 44's integration with Google Tag Manager pushes valuable events to the `dataLayer` for use in Google Analytics. The plugin includes an import file and detailed [Instructions for setting up Google Tag Manager and Google Analytics to receive event-tracking data](https://seo44plugin.com/search-appearance-toolkit-seo-44/integrations-setup-guide/).
+SEO 44's integration with Google Tag Manager pushes valuable events to the `dataLayer` for use in Google Analytics. The plugin includes an import file and detailed [Instructions for setting up Google Tag Manager and Google Analytics to receive event-tracking data](https://seo44plugin.com/search-appearance-toolkit-seo-44/integrations-setup-guide/).
+= Site Verification =
+Verify your site with search engines quickly and easily. Paste your verification codes for **Google Search Console** and **Bing Webmaster Tools** into the corresponding fields in the Integrations tab. The plugin handles the rest, adding site verification meta tags to your website's head. No coding required.
+= YouTube Data API =
+To ensure that your site's video schema is as accurate as possible, you may add your YouTube Data API Key.  The plugin uses this key to fetch the upload date for any YouTube video embedded in your content, replacing less reliable page scraping options and fallbacks to the post publish date.
 == Frequently Asked Questions ==
 …
 Search Appearance Toolkit (SEO 44) gives you control over the technical, on-page SEO factors that help search engines understand and rank your content. Key benefits include:
 * **Optimized Snippets:** Control how your titles and descriptions appear in search results.
 * **Rich Results:** The advanced Schema.org data helps you earn rich results like FAQs, How-Tos, and breadcrumbs in Google.
+* **Rich Results:** The advanced Schema.org data improves indexing and helps you earn rich results in Google.
 * **Crawlability:** A clean and comprehensive XML sitemap ensures search engines can find and index all of your important content and images.
 * **User Engagement:** The Jump Links Block improves user experience, which is a positive ranking signal, and can help you earn "Jump to" links in search results.
 …
 SEO 44 helps your content look great when shared on social media platforms. You can enable the automatic generation of **Open Graph** (og:) tags, which Facebook, LinkedIn, and Pinterest use, and **Twitter Card** meta tags for when your content appears on X (formerly Twitter). This ensures your posts have the correct title, description, and preview image when shared.
 Use the plugin's Google Tag Manager Integration to facilitate additional connections with soclal media platforms. Use the Organization Schema settings to associate all of your social media profiles with your website.
+Use the plugin's Google Tag Manager Integration to facilitate additional connections with social media platforms. Use the Organization Schema settings to associate all of your social media profiles with your website.
 = How are social media images handled? =
 …
 = What are the benefits of using FAQPage and HowTo schema? =
 The plugin intelligently scans your content for patterns that match question-and-answer formats or step-by-step instructions (when this option is enabled). The plugin locates this content and automatically generates FAQPage or HowTo schema that presents this content within the JSON-LD.
 The benefit of this is that Google can use this structured data to display your content in special, highly visible formats in the search results. An FAQ page might appear as a rich snippet with expandable questions, while a How-To article can be featured in a step-by-step guide. Rich snippets make your search results stand out, which can significantly improve your click-through rate (CTR).
+The plugin intelligently scans your content for patterns that match question-and-answer formats or step-by-step instructions (when this option is enabled). The plugin locates this content and automatically generates FAQPage or HowTo schema that presents this content as structured data.
+The benefit of this is that Google can use this structured data to display your content in special, highly visible formats in the search results. An FAQ page might appear as a rich snippet with expandable questions or feature within a People Also Ask (PAA) result, while a How-To article can be featured in a step-by-step guide in AI Overviews. Search results that stand out can improve your click-through rate (CTR).
 Read more about the [FAQPage and HowTo Schema](https://seo44plugin.com/search-appearance-toolkit-seo-44/schema-structured-data/#benefits-of-faqpage-and-howto-schema) created by SEO 44.
 …
     * **Google:** [Terms of Service](https://policies.google.com/terms), [Privacy Policy](https://policies.google.com/privacy)
     * **Bing (Microsoft):** [Microsoft Services Agreement](https://www.microsoft.com/en-us/servicesagreement/), [Microsoft Privacy Statement](https://privacy.microsoft.com/en-us/privacystatement)
+= YouTube Data API Integration & Video Metadata =
+* **Service Description:** This plugin connects to YouTube to fetch the "Upload Date" for videos embedded in your content. This ensures your VideoObject schema is accurate.
+* **Data Sent and Conditions:**
+    * **Method 1 (API):** If you provide a YouTube API Key in settings, the plugin sends the Video ID to the Google Data API.
+    * **Method 2 (Public Fallback):** If no API Key is present, the plugin acts as a standard browser and fetches the public video page (via `wp_remote_get`) to locate the upload date in the page meta tags.
+    * **Conditions:** This occurs automatically when a post with a YouTube embed is updated, provided that Schema generation is enabled.
+* **Service Provider Links:**
+    * **YouTube:** [Terms of Service](https://www.youtube.com/t/terms), [Google Privacy Policy](https://policies.google.com/privacy)
 == Screenshots ==
 …
 == Changelog ==
+= 4.3.0 =
+* FEATURE: **Table of Contents Schema:** Automatically generates `hasPart` schema synchronized with the Jump Links Block to support "Jump-to" links in search results.
+* FEATURE: **Advanced HowTo Schema:** A new "Block-Aware" scanner uses the Jump Links Block to strictly define steps while intelligently mining the introduction for tools, time, yield, and video data.
+* TWEAK: Added a "Generate HowTo Schema" checkbox to the SEO 44 metabox, giving users explicit control over when the advanced scanner runs.
+* FEATURE: **YouTube Integration:** Added support for the YouTube Data API v3 to fetch accurate video upload dates for VideoObject schema.
+* TESTED: Tested to WordPress Version 6.9
 = 4.2.0 =
 * FEATURE: **Rich Organization Schema:** Added a comprehensive settings section to generate Organization structured data for the Knowledge Graph.
 …
 * TWEAK: Updated the image uploader JavaScript to support multiple distinct upload buttons on the settings page.
-= 4.1.0 =
-**Jump Links Block Updates:**
-* FEATURE: **Sticky Positioning:** Keep your table of contents visible while users scroll. Includes a "Top Offset" slider to clear sticky headers, a "Jump Offset" slider to ensure that the sticky header does not cover the heading text, and a "Disable on Mobile" toggle to preserve screen space on small devices.
-* FEATURE: **Auto-Hide Title:** Implemented a smart "sticky state" detection. When the block sticks, the title gently collapses and fades out to keep the interface clean (this occurs when a block title is used alongside sticky positioning).
-* FEATURE: **Smart Indentation:** Added a "Create Visual Hierarchy" toggle. When enabled, H3 and H4 sub-headings are visually indented to create a clear, nested outline structure.
-* FEATURE: **Block Background:** You can now set a background color for the entire block container, perfect for creating "card-style" floating navigation.
-* FEATURE: **ScrollSpy:** Automatically highlights the active link in the table of contents as the user scrolls through the corresponding section of the post.
-* FEATURE: Added support for Border and Spacing controls. You can now add borders, rounded corners, margins, and padding to the Jump Links block directly from the editor settings.
-* FEATURE: Added a "Title tag" control. You can now choose the specific HTML tag (H2, H3, H4, H5, Paragraph, or Div) for the "On This Page" heading to better match your document structure.
-* REFACTOR: Optimized the block's styling logic to use CSS variables on the parent container instead of inline styles for every link. This reduces the block's HTML size and improves rendering performance.
-* FIX: Resolved an accessibility and HTML validation issue where using multiple Jump Links blocks on a single page created duplicate element IDs. Each block now generates a unique instance ID.
-* PERFORMANCE: Refactored the front-end JavaScript to use event delegation for smooth scrolling. This reduces memory usage by attaching a single event listener to the block instead of individual listeners for every link.
-* TWEAK: Reorganized the sidebar settings for better clarity between Block Title settings and Content Inclusion settings.
-= 4.0.0 =
-* FEATURE: Added a new "Integrations" tab for third-party services like Google Tag Manager and Webmaster Tools.
-* FEATURE: Added Google Tag Manager (GTM) integration. The plugin can now automatically inject the GTM container script into the site's <head> and <body> based on your ID.
-* FEATURE: Added Webmaster Verification. You can now add your Google Search Console and Bing Webmaster Tools verification codes directly from the plugin settings.
-* FEATURE: Added automatic GTM event tracking. When enabled, the plugin can push the following events to the dataLayer:
-    * Rich SEO dataLayer: Pushes page type, category, author, and tags on page load for advanced GTM triggers.
-    * Scroll Depth Tracking: Pushes 'scroll_depth' events at 25%, 50%, 75%, and 100% of the page.
-    * External & Affiliate Clicks:* Pushes 'external_link_click' or 'affiliate_link_click' (for `rel="sponsored"` links).
-    * Jump Link Clicks: Pushes a 'jump_link_click' event when a user clicks a link in the Jump Links Block.
-* FEATURE: Added a Google Tag Manager recipe import file (`seo44-gtm-recipe-importer.json`) and new FAQ instructions to fully configure GTM and GA4 event tracking.
-* ENHANCEMENT: Centralized all GTM event tracking into a new, efficient `global-tracker.js` file that uses event delegation for better performance.
-* TWEAK: Improved the "Integrations" settings page UI for clarity, adding clarifying tooltips and a file downloader.
 For a complete list of changes, please see the [full changelog](https://seo44plugin.com/search-appearance-toolkit-seo-44/changelog/) or the `changelog.txt` file included with the plugin.

search-appearance-toolkit-seo-44/trunk/seo-44.php

-                      r3405454
+                      r3423355
  * Plugin URI:        https://www.sethcreates.com/plugins-for-wordpress/search-appearance-toolkit-seo-44/
  * Description:       A lightweight, powerful SEO plugin for essential meta tags, advanced schema, XML sitemaps, jump links, and easy migration from other plugins.
  * Version:           4.2.0
+ * Version:           4.3
  * Author:            Seth Smigelski
  * Author URI:        https://www.sethcreates.com/plugins-for-wordpress/
 …
 if ( ! defined( 'ABSPATH' ) ) exit; // Exit if accessed directly
 define( 'SEO44_VERSION', '4.2.0' );
+define( 'SEO44_VERSION', '4.3' );
 define( 'SEO44_PLUGIN_URL', plugin_dir_url( __FILE__ ) );

Plugin Directory

Context Navigation

Legend:

search-appearance-toolkit-seo-44/tags/4.3/README.md

search-appearance-toolkit-seo-44/tags/4.3/build/index.asset.php

search-appearance-toolkit-seo-44/tags/4.3/build/index.js

search-appearance-toolkit-seo-44/tags/4.3/changelog.txt

search-appearance-toolkit-seo-44/tags/4.3/includes/class-seo44-core.php

search-appearance-toolkit-seo-44/tags/4.3/includes/class-seo44-frontend.php

search-appearance-toolkit-seo-44/tags/4.3/includes/class-seo44-metabox.php

search-appearance-toolkit-seo-44/tags/4.3/includes/class-seo44-settings.php

search-appearance-toolkit-seo-44/tags/4.3/js/admin-script.js

search-appearance-toolkit-seo-44/tags/4.3/readme.txt

search-appearance-toolkit-seo-44/tags/4.3/seo-44.php

search-appearance-toolkit-seo-44/trunk/README.md

search-appearance-toolkit-seo-44/trunk/build/index.asset.php

search-appearance-toolkit-seo-44/trunk/build/index.js

search-appearance-toolkit-seo-44/trunk/changelog.txt

search-appearance-toolkit-seo-44/trunk/includes/class-seo44-core.php

search-appearance-toolkit-seo-44/trunk/includes/class-seo44-frontend.php

search-appearance-toolkit-seo-44/trunk/includes/class-seo44-metabox.php

search-appearance-toolkit-seo-44/trunk/includes/class-seo44-settings.php

search-appearance-toolkit-seo-44/trunk/js/admin-script.js

search-appearance-toolkit-seo-44/trunk/readme.txt

search-appearance-toolkit-seo-44/trunk/seo-44.php

Download in other formats: