Skip to content

CHANGELOG.md

Latest commit

 

History

History
168 lines (121 loc) · 7.02 KB

CHANGELOG.md

File metadata and controls

168 lines (121 loc) · 7.02 KB

Blockparty Iframe

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

1.2.0 - 2026-04-22

Changed

  • Dynamic block rendering: The iframe is rendered on the server via BlockRenderer and a render_callback (same pattern as blockparty-post-sharing). Post content stores block attributes only; frontend markup is built at display time.
  • Plugin bootstrap: Register the block with register_block_type() and render_callback instead of metadata-collection-only registration.

Added

  • includes/BlockRenderer.php: PHP render for the wrapper (get_block_wrapper_attributes()), loading, and custom iframe attributes (parity with the former save.js logic).
  • Block deprecation: The previous static save.js output is kept as a deprecated block definition so existing posts with serialized HTML remain valid in the editor.

Developer

  • Composer autoload: PSR-4 Blockparty\Iframe\ → includes/.
  • PHPCS: Enforce short array syntax ([]) via Generic.Arrays.DisallowLongArraySyntax; fix exclusion of Universal.Arrays.DisallowShortArraySyntax from WordPress-Core.
  • Composer: composer.lock ignored in git; dev dependency pins refreshed (dealerdirect/phpcodesniffer-composer-installer, wp-coding-standards/wpcs).

1.1.2 - 2026-04-21

Fixed

  • WordPress.org Playground blueprint: Generate the demo mu-plugin via a nowdoc so the wp_kses_allowed_html iframe allowlist is written as syntactically valid PHP (the previous line-by-string approach could produce a broken file and fatal the Playground). The blueprint pluginData.ref now targets tag 1.1.2.

Removed

  • Psalm static analysis: Removed vimeo/psalm, humanmade/psalm-plugin-wordpress, and psalm.xml.dist; dropped the psalm Composer script and the Grumphp Psalm task so the dev toolchain relies on PHPCS, PHP parallel lint, and related tooling only (leaner composer.lock / install).

1.1.1 - 2026-04-20

Fixed

  • Dependency alignment: Bump @wordpress/icons to ^12.2.0 so the block editor resolves a single icons package version alongside @wordpress/block-editor, @wordpress/components, and related packages (avoids duplicate bundles and inconsistent icons).

1.1.0 - 2026-01-12

🚀 Added

Iframe Code Parsing

  • HTML iframe code support: You can now paste complete iframe HTML code instead of just URLs
  • Automatic URL extraction: The src attribute is automatically extracted from iframe code
  • Auto-fill title: The title attribute is automatically extracted and fills the title field
  • Custom attributes preservation: All custom iframe attributes are extracted and preserved in the final output
  • Smart content filtering: HTML content inside iframe tags is automatically removed during parsing

Attribute Management

  • Custom attributes storage: New iframeAttributes block attribute (array of key-value objects)
  • Boolean attributes support: Proper handling of HTML boolean attributes like allowfullscreen
  • React prop mapping: Automatic conversion of HTML attributes to React prop names
    • allowfullscreen → allowFullScreen
    • allowpaymentrequest → allowPaymentRequest
    • referrerpolicy → referrerPolicy
  • Deprecated attributes filtering: Automatic exclusion of deprecated HTML attributes
    • frameborder, marginwidth, marginheight, scrolling, align, longdesc
  • Problematic attributes filtering: Exclusion of attributes that cause issues in React
    • style (requires object format in React)
    • name (can cause conflicts)
    • width, height (managed by block dimension supports)

Code Quality

  • Utility functions: New utils.js module for shared functionality
  • Code refactoring: Eliminated duplication between edit.js and save.js
  • Better error handling: Improved parsing with insertAdjacentHTML for safer DOM manipulation

🔧 Changed

  • Source field enhancement: The URL field now accepts both URLs and iframe HTML code
  • Placeholder text: Updated to reflect dual input capability
  • Help text: Added contextual help explaining the new paste functionality

📚 Technical Details

  • New file: src/blockparty-iframe/utils.js with exported utility functions:
    • parseIframeCode(): Parse iframe HTML and extract attributes
    • convertAttributesToProps(): Convert attributes array to React props
    • mapHtmlAttributeToReact(): Map HTML attribute names to React prop names
    • isBooleanAttribute(): Identify boolean HTML attributes
    • isExcludedIframeAttribute(): Filter out problematic attributes

1.0.2 - 2026-01-10

🔧 Changed

  • Release workflow: Updated GitHub Actions release workflow configuration

1.0.1 - 2026-01-09

🐛 Fixed

  • Build artifacts: Updated .distignore and .gitattributes for proper release packaging

1.0.0 - 2026-01-09

🎉 Initial Release

Added

  • Gutenberg Iframe Block: New custom block to embed iframes in WordPress editor
  • Configurable Attributes:
    • url: URL of the page to embed
    • title: Iframe title for accessibility
    • lazyload: Option to enable lazy loading
  • Dimension Support:
    • Customizable width
    • Customizable height
    • Configurable aspect ratio
  • Alignments: Support for wide and full-width alignments
  • Internationalization:
    • Full i18n/l10n support
    • French translations included
    • POT files for translators
  • Performance:
    • Uses blocks-manifest.php API (WordPress 6.7+)
    • Compatible with wp_register_block_types_from_metadata_collection (WordPress 6.8+)
    • Optional lazy loading for iframes
  • Code Quality:
    • WordPress Coding Standards (WPCS) compliance
    • Static analysis with Psalm
    • PHPCompatibility verification
    • ESLint for JavaScript
    • GrumPHP for pre-commit hooks
  • Documentation:
    • Complete README with usage guide
    • PHPDoc for all functions
    • Detailed inline comments
  • Development Environment:
    • @wordpress/env support for local environment
    • npm scripts for development and production
    • Composer configuration for development tools

Technical

  • Minimum Versions:
    • WordPress 6.7+
    • PHP 8.1+
    • Requires ext-json
  • Block Editor API: Uses API version 3
  • Build System: @wordpress/scripts with --blocks-manifest flag
  • Structure: Modular architecture with edit/save separation
  • Styles: SCSS with automatic RTL support