This file contains the readme information for the block. It is used to provide information about the block, its usage, and any other relevant details. ` section of your page via `wp_head`, making it invisible to visitors but perfectly readable by search engines. = What if I want to add custom schema types? = Start with the "Blank" template and paste in your custom JSON-LD schema. The block will validate it and process any placeholders you include. == Screenshots == 1. Clean editor placeholder showing "JSON-LD Configured" status 2. Block Sidebar with template selector and JSON-LD editor 3. Real-time validation feedback 4. Example LocalBusiness template with placeholders == Changelog == = 0.1.0 = * Initial release * Template library with LocalBusiness, Organization, and FAQ schemas * Dynamic placeholder replacement for WordPress core and ACF fields * Real-time JSON validation * Clean wp_head injection without extra markup == Technical Details == The block uses a dynamic rendering approach with `render_callback` to process placeholders server-side. This ensures that: * Placeholders are replaced with current data on every page load * ACF fields are safely accessed and formatted * Invalid JSON never reaches the frontend * Search engines receive clean, valid JSON-LD markup The frontend output is optimized with no extra paragraph or break tags, outputting only the pure JSON-LD script tag. ]]> This file contains the block registration code in the form of a single block plugin. Any other plugin related functionality should be added to this file. All block rendering functionality should go to the `render.php` file. ID, 'full' ); $replacements = array( '{{title}}' => get_the_title( $post->ID ), '{{excerpt}}' => get_the_excerpt( $post->ID ), '{{date}}' => get_the_date( 'c', $post->ID ), '{{url}}' => get_permalink( $post->ID ), '{{featured_image_url}}' => $featured_image ? $featured_image : '', ); $content = str_replace( array_keys( $replacements ), array_values( $replacements ), $content ); $content = preg_replace_callback( '/\{\{acf:([a-zA-Z0-9_-]+)\}\}/', function ( $matches ) use ( $post ) { $field_name = $matches[1]; if ( ! function_exists( 'get_field' ) ) { return ''; } $field_value = get_field( $field_name, $post->ID ); if ( is_array( $field_value ) ) { return wp_json_encode( $field_value ); } elseif ( is_string( $field_value ) || is_numeric( $field_value ) ) { return esc_js( $field_value ); } return ''; }, $content ); return $content; } } /** * Output JSON-LD schema in the head section. */ if ( ! function_exists( 'agilepress_schema_output_jsonld' ) ) { function agilepress_schema_output_jsonld() { global $post; if ( ! is_singular() || ! $post ) { return; } if ( ! has_blocks( $post->post_content ) ) { return; } $blocks = parse_blocks( $post->post_content ); foreach ( $blocks as $block ) { if ( 'agilepress/block-agilepress-schema-json-ld-block' === $block['blockName'] ) { if ( ! empty( $block['attrs']['jsonldContent'] ) ) { $jsonld_content = $block['attrs']['jsonldContent']; $processed_content = agilepress_schema_process_placeholders( $jsonld_content ); $decoded = json_decode( $processed_content, true ); if ( json_last_error() === JSON_ERROR_NONE && is_array( $decoded ) ) { $safe_json = wp_json_encode( $decoded ); if ( $safe_json ) { wp_print_inline_script_tag( $safe_json, array( 'type' => 'application/ld+json' ) ); } } } } } } } add_action( 'wp_head', 'agilepress_schema_output_jsonld', 1 );]]> This file contains metadata about the block including its name, title, category, icon, and other properties. The icon is a WordPress Dashicon name (e.g., "admin-post", "format-aside", "admin-page"). Do not use any icon that's not in the list under any circustamce. These are the only slugs available: menu menu-alt menu-alt2 menu-alt3 admin-site admin-site-alt admin-site-alt2 admin-site-alt3 dashboard admin-post admin-media admin-links admin-page admin-comments admin-appearance admin-plugins plugins-checked admin-users admin-tools admin-settings admin-network admin-home admin-generic admin-collapse filter admin-customizer admin-multisite welcome-write-blog welcome-add-page welcome-view-site welcome-widgets-menus welcome-comments welcome-learn-more format-aside format-image format-gallery format-video format-status format-quote format-chat format-audio camera camera-alt images-alt images-alt2 video-alt video-alt2 video-alt3 media-archive media-audio media-code media-default media-document media-interactive media-spreadsheet media-text media-video playlist-audio playlist-video controls-play controls-pause controls-forward controls-skipforward controls-back controls-skipback controls-repeat controls-volumeon controls-volumeoff image-crop image-rotate image-rotate-left image-rotate-right image-flip-vertical image-flip-horizontal image-filter undo redo database-add database database-export database-import database-remove database-view align-full-width align-pull-left align-pull-right align-wide block-default button cloud-saved cloud-upload columns cover-image ellipsis embed-audio embed-generic embed-photo embed-post embed-video exit heading html info-outline insert insert-after insert-before remove saved shortcode table-col-after table-col-before table-col-delete table-row-after table-row-before table-row-delete editor-bold editor-italic editor-ul editor-ol editor-ol-rtl editor-quote editor-alignleft editor-aligncenter editor-alignright editor-insertmore editor-spellcheck editor-expand editor-contract editor-kitchensink editor-underline editor-justify editor-textcolor editor-paste-word editor-paste-text editor-removeformatting editor-video editor-customchar editor-outdent editor-indent editor-help editor-strikethrough editor-unlink editor-rtl editor-ltr editor-break editor-code editor-paragraph editor-table align-left align-right align-center align-none lock unlock calendar calendar-alt visibility hidden post-status edit trash sticky external arrow-up arrow-down arrow-right arrow-left arrow-up-alt arrow-down-alt arrow-right-alt arrow-left-alt arrow-up-alt2 arrow-down-alt2 arrow-right-alt2 arrow-left-alt2 sort leftright randomize list-view excerpt-view grid-view move share share-alt share-alt2 rss email email-alt email-alt2 networking amazon facebook facebook-alt google instagram linkedin pinterest podio reddit spotify twitch twitter twitter-alt whatsapp xing youtube hammer art migrate performance universal-access universal-access-alt tickets nametag clipboard heart megaphone schedule tide rest-api code-standards buddicons-activity buddicons-bbpress-logo buddicons-buddypress-logo buddicons-community buddicons-forums buddicons-friends buddicons-groups buddicons-pm buddicons-replies buddicons-topics buddicons-tracking wordpress wordpress-alt pressthis update update-alt screenoptions info cart feedback cloud translation tag category archive tagcloud text bell yes yes-alt no no-alt plus plus-alt plus-alt2 minus dismiss marker star-filled star-half star-empty flag warning location location-alt vault shield shield-alt sos search slides text-page analytics chart-pie chart-bar chart-line chart-area groups businessman businesswoman businessperson id id-alt products awards forms testimonial portfolio book book-alt download upload backup clock lightbulb microphone desktop laptop tablet smartphone phone index-card carrot building store album palmtree tickets-alt money money-alt smiley thumbs-up thumbs-down layout paperclip color-picker edit-large edit-page airplane bank beer calculator car coffee drumstick food fullscreen-alt fullscreen-exit-alt games hourglass open-folder pdf pets printer privacy superhero superhero-alt This file registers the block, specifies the edit and save functions, and loads the block's metadata This file contains the edit function for the block which is responsible for rendering the block in the editor. { if ( ! jsonldContent || jsonldContent.trim() === '' ) { setIsValid( true ); setValidationMessage( '' ); return; } try { JSON.parse( jsonldContent ); setIsValid( true ); setValidationMessage( __( 'Valid JSON', 'agilepress-schema-json-ld-block' ) ); } catch ( error ) { setIsValid( false ); setValidationMessage( __( 'Invalid JSON: ', 'agilepress-schema-json-ld-block' ) + error.message ); } }, [ jsonldContent ] ); // Handle template selection const handleTemplateChange = ( newTemplate ) => { setAttributes( { template: newTemplate, jsonldContent: SCHEMA_TEMPLATES[ newTemplate ], } ); }; // Handle JSON-LD content change const handleContentChange = ( newContent ) => { setAttributes( { jsonldContent: newContent, } ); }; const blockProps = useBlockProps( { className: 'agilepress-schema-json-ld-block-placeholder', } ); return ( <> { validationMessage && ( { validationMessage } ) }

{ __( 'Available Placeholders:', 'agilepress-schema-json-ld-block' ) }

{ '{{title}}' } - { __( 'Post/page title', 'agilepress-schema-json-ld-block' ) }
{ '{{excerpt}}' } - { __( 'Post excerpt', 'agilepress-schema-json-ld-block' ) }
{ '{{date}}' } - { __( 'Publication date', 'agilepress-schema-json-ld-block' ) }
{ '{{url}}' } - { __( 'Current post URL', 'agilepress-schema-json-ld-block' ) }
{ '{{featured_image_url}}' } - { __( 'Featured image URL', 'agilepress-schema-json-ld-block' ) }
{ '{{acf:field_name}}' } - { __( 'Any ACF field', 'agilepress-schema-json-ld-block' ) }

{ __( 'JSON-LD Configured', 'agilepress-schema-json-ld-block' ) }

{ jsonldContent ? __( 'Schema markup active', 'agilepress-schema-json-ld-block' ) : __( 'Configure in sidebar', 'agilepress-schema-json-ld-block' ) }

); }]]> This file contains the save function for the block which is responsible for creating the static result of rendering the block on the client to display the saved result on the front end. This file contains styles for the block in the front end. This file contains styles for the block in the editor. This file contains the view function for the block which is responsible for rendering interactive behaviors of the block on the front end. Ideally using the WordPress interactivity API. This file contains the render callback function for the block, which is responsible for rendering the block content on the front end. A render function should exist only if the block is dynamic.