Post Formats for Block Themes

By Courtney Robertson

0+ active installationsVersion 1.1.12

Bring post formats to block themes with auto-detection, format-specific patterns, and Chat Log block for displaying conversation transcripts.

Description

Post Formats for Block Themes brings the beloved post format functionality from classic WordPress themes to modern block themes, with intelligent pattern insertion, automatic format detection, and a streamlined editing experience. It requires a block theme — on a classic theme the plugin deactivates itself with an explanatory notice.

Why Post Formats Matter for Block Themes

WordPress post formats have been a powerful feature since WordPress 3.1, allowing content creators to style different types of posts distinctively—quotes appear with enhanced typography, galleries showcase images prominently, status updates feel like social media, and chat transcripts display conversations beautifully. However, with the shift to block themes and Full Site Editing, this functionality was left behind.

Post Formats for Block Themes solves this problem. This plugin brings post formats into the block editor era with format-specific block patterns, automatic content detection, and accessibility-first design. Whether you’re building a personal blog, portfolio, news site, or creative magazine, post formats help your content stand out.

Who This Plugin Is For

  • Bloggers who want variety in their post presentations without creating custom templates
  • Content creators who publish different types of content (articles, quotes, galleries, status updates)
  • News sites migrating from classic themes and want to preserve post format functionality
  • Designers and developers building block themes who need format support built-in
  • Accessibility-minded editors — the format modal and Chat Log block use WordPress’s accessible components and announce changes to screen readers
  • Anyone moving from classic themes who misses the post format features they relied on

Key Features

10 Format-Specific Block Patterns

Each WordPress post format gets a block pattern for its content type. Choosing a format inserts its pattern into the post, and you can edit every block in it:

  • Standard – Traditional blog post with full title, featured image, and content blocks
  • Aside – Short note or update displayed in a styled bubble container without title requirement
  • Status – Short status update with a 280-character soft limit and a live counter
  • Link – Link sharing with automatic Bookmark Card integration when available, with graceful fallback to standard linked paragraphs
  • Gallery – Photo gallery starting with a Gallery block for image collections
  • Image – Single image post with prominent image display and caption support
  • Quote – Quotation or citation using the Quote block
  • Video – Video content using native video blocks or popular embed services. Adds layout styles for Able Player when it’s active.
  • Audio – Audio file or podcast embed with native player styling. Adds layout styles for the Podlove Podcasting Plugin player and Able Player when either is active.
  • Chat – Conversation transcript using the integrated Chat Log block

Integrated Chat Log Block

No separate plugin needed! Post Formats for Block Themes includes a full-featured Chat Log block for displaying conversation transcripts. Perfect for interviews, customer support examples, team discussions, or any dialogue format.

Supported platforms: Slack, Discord, Microsoft Teams, WhatsApp, Telegram, Signal, and generic chat transcripts. Additional text format support: SRT subtitles, VTT captions, and plain text exports from any chat application.

Chat Log features: automatic platform detection, avatars (Gravatar with an initials fallback), timestamp formatting (relative, absolute, time-only), multiple display styles (bubbles, IRC, transcript, timeline), thread collapsing, participant lists, device frames, full accessibility, and RTL support.

Automatic Format Detection

Save time with intelligent format detection. The plugin analyzes your post’s first block and automatically assigns the appropriate format. Gallery, Image, Video, Audio, Quote, Chat Log, and Bookmark Card blocks map to their formats; an Aside or Status paragraph maps when it carries the pattern’s class. A Pullquote doesn’t count as a Quote. Detection runs once, on a post’s first save, and never changes a format you set.

Format Selection Modal

When creating a new post, a visual format selection modal appears with all 10 formats displayed as cards showing an icon, name, and description. It’s built on the WordPress Modal component and announces your choice to screen readers.

Change Format Mid-Edit

Use the Format row in the post sidebar (WordPress core’s control). Picking a new format inserts that format’s pattern at the top of the post and keeps your existing blocks. If the post is empty, the pattern replaces the empty block.

Status Format Validation

The Status format shows a live “N characters remaining” counter with a 280-character soft limit, warning and over-limit styling, and screen reader announcements. It never blocks publishing.

Post Format Repair Tool

The repair tool (Tools → Post Format Repair) scans your posts when you open it and lists posts whose format doesn’t match their first block. Use “Apply All Suggestions” or the per-row “Apply”. Dry run is on by default, and each change saves a revision first. Useful when migrating from classic themes.

Theme-Agnostic Styling

Format styles use --pfbt-* CSS custom properties that resolve through your theme.json, so they follow your theme’s colors, typography, and spacing and work with Global Styles.

Also Included

  • Settings → Post Formats picks the icon set for the Format Icon block.
  • Tools → Post Format Templates turns on single-post templates per format.
  • The Format Badge and Format Icon blocks show a post’s format. Block Hooks can place the badge before the post title.
  • Opt-in block style variations for Image, Gallery, and Quote blocks. Both feature flags (image_gallery_styles, quote_styles) are off by default.
  • Query Loop variations “Format archive: Quote”, “Link” and “Status” list one format’s posts on any page or template.
  • Abilities API support, including read abilities for MCP clients on WordPress 6.9+ (see the 1.1.10 changelog).

How to Use Post Formats in Block Themes

Creating Your First Formatted Post:
1. Navigate to Posts → Add New
2. Format selection modal appears automatically
3. Click your desired format (e.g., “Quote”)
4. The format’s pattern is inserted
5. Add content within the pattern
6. Publish your formatted post

Mid-Edit Format Switching:
1. Open the Post tab in the right sidebar
2. Select the Format row
3. Choose a new format
4. The new pattern is inserted at the top; your existing blocks stay

Using Auto-Detection:
1. Start a new post without selecting a format
2. Add content (e.g., insert a gallery block)
3. Save as draft or publish
4. Plugin automatically detects Gallery format
5. Format is assigned without manual action

How to Create a Quote Post

Showcase quotations and citations beautifully:

  1. Select Quote format from the modal
  2. The Quote pattern loads with a Quote block
  3. Type or paste your quote
  4. Add the source or attribution below the quote
  5. Optional: Add commentary below the quote
  6. Customize styling via Global Styles
  7. Publish your quote post

How to Display Chat Conversations

Turn conversation transcripts into readable, attractive content:

  1. Select Chat format when creating new post
  2. Chat Log block inserts automatically
  3. Copy conversation text from Slack, Discord, Teams, WhatsApp, etc.
  4. Paste into Chat Log block—platform detection is automatic
  5. Configure display options: style, avatars, timestamps, threads, device frame
  6. Preview the formatted conversation
  7. Publish your beautiful chat transcript

Threaded replies are grouped and can be collapsed. Reaction counts and reply indicators in pasted text are skipped.

How to Automatically Detect Post Formats

Let the plugin handle format assignment:

  1. Create new post without selecting format
  2. Add content normally (gallery, video, quote, etc.)
  3. Save draft or publish—detection runs on save
  4. Check the Format row in the sidebar for the detected format
  5. Change it there if you want a different one

Detection rules: the first block decides. Gallery block = Gallery format, Video = Video, Quote block = Quote (a Pullquote doesn’t count). Detection runs once per post.

How to Repair Mismatched Formats

Fix format assignments across your entire site:

  1. Navigate to Tools → Post Format Repair
  2. The page scans your posts on load
  3. Review the Detected Mismatches table
  4. Leave “Dry run” checked to preview, or uncheck it to apply
  5. Click “Apply All Suggestions”, or “Apply” on one row
  6. Verify the changes

Common scenarios: migrating from classic themes, imported content, incorrect manual assignments, exploring your format distribution. The repair tool saves a revision before each change and edits the post’s format, not its content. (The separate Template Assignments section on that screen also updates page templates.)

Migrating from Classic Theme Post Formats

Preserve post format styling when switching to block themes:

Before Migration:
1. Install plugin on classic theme site
2. Leave classic theme active
3. Open the repair tool (dry run stays on, so nothing is applied)
4. Review the mismatches

During Migration:
1. Switch to block theme
2. Activate Post Formats for Block Themes
3. Visit Tools → Post Format Repair
4. The page scans your posts on load
5. Review the mismatches
6. Uncheck Dry run, then click Apply All Suggestions

After Migration:
1. Check frontend display
2. Customize styling in theme.json
3. Create new posts with format patterns
4. Optional: update old posts to use patterns

What transfers: format assignments, post content, featured images, post meta. What changes: theme template styling becomes pattern styling, classic PHP templates become block templates. Tips: test on staging first, take database backup, check one post per format, customize theme.json colors, use patterns for new content.

Block Theme Compatibility Guide

What Makes a “Block Theme”:
Block themes use block templates (.html files) and theme.json instead of PHP templates. Key characteristics: templates/ folder with .html files, theme.json file, Full Site Editing support, activated via Appearance → Themes. Learn more in the WordPress Block Theme documentation.

Why Classic Themes Aren’t Supported:
Classic themes use PHP template files which conflict with block-based patterns. This plugin requires block pattern support, block templates, theme.json styling, and block editor integration. If you prefer using a classic theme with post format support, consider using the Twenty Thirteen theme which includes excellent built-in post format styling.

Recommended Compatible Block Themes:
Twenty Twenty-Five, Twenty Twenty-Four, Twenty Twenty-Three, Block themes from Automattic (Blank Canvas, Pendant), most modern block themes on WordPress.org.

Theme.json Integration:
The plugin reads color palette, typography, spacing, and border styles from your theme.json. Format styles automatically adapt. To customize, edit your theme.json color and typography settings.

Documentation

Full user documentation — installation, settings, common tasks, troubleshooting, privacy, and a Playground preview guide — lives at courtneyr-dev.github.io/post-formats-for-block-themes. Developers extending formats, detection, or styling should start with the hooks reference.

Additional Information

Performance

Post Formats for Block Themes is built for performance: JavaScript loads only in block editor (never on frontend), CSS uses minimal native custom properties, auto-detection runs only on save, no frontend database queries, properly enqueued versioned assets for browser caching, no external dependencies or CDN requests.

Privacy

This plugin respects user privacy: does not collect or store user data, does not make external API calls, does not set cookies, does not track users, does not share data with third parties. Format selections and post meta stored only in your WordPress database using standard functions.

Browser Compatibility

Tested and fully functional in: Chrome 90+, Firefox 88+, Safari 14+, iOS Safari 14+, Chrome for Android 90+. Uses modern JavaScript (ES6+) with polyfills for wider compatibility.

Support

For support: check FAQ section, read format descriptions, visit WordPress.org support forums, search existing threads, create new topic with details (WordPress version, PHP version, theme name, active plugins, issue description, reproduction steps, screenshots).

For bug reports and feature requests: visit GitHub repository.

Contributing

Contributions welcome! Report bugs on GitHub, submit pull requests, translate via WordPress.org, write tutorials, answer support questions, share with others. Development: follows WordPress Coding Standards, includes comprehensive test suite (PHPUnit + Playwright), CI/CD pipeline with automated testing, accessibility tested with axe-core.

Credits

Inspired by WordPress Twenty Thirteen theme’s post format treatments. Built with WordPress Gutenberg components. Icons by Dashicons. Developed by Courtney Robertson. License: GPL v2 or later.

External Services

This plugin does not connect to or rely on any external services. All functionality runs entirely on your WordPress installation using core WordPress APIs. The Chat Log block specifically: does NOT send conversation data to external services, does NOT make API calls, processes all transcript text locally using JavaScript, stores formatted conversations in post content only. Your conversations never leave your server.

Installation

Minimum Requirements

  • WordPress 6.9 or higher
  • PHP 7.4 or higher
  • A block theme (Classic themes not supported)
  • JavaScript enabled in browser

Automatic Installation

  1. Log in to WordPress admin
  2. Navigate to Plugins → Add New
  3. Search for “Post Formats for Block Themes”
  4. Click “Install Now” then “Activate”
  5. Create a new post—format selection modal will appear

Manual Installation

  1. Download plugin ZIP from WordPress.org
  2. Go to Plugins → Add New → Upload Plugin
  3. Choose ZIP file and click “Install Now”
  4. Click “Activate Plugin”
  5. Create a new post to start using formats

After Activation

  1. Create test post (Posts → Add New)
  2. See format modal with all 10 formats
  3. Choose a format to insert its pattern
  4. Add content within pattern structure
  5. Publish your formatted post
  6. Optional: Run repair tool (Tools → Post Format Repair)

FAQ

Does this work with classic themes?

No, this plugin requires block themes with Full Site Editing. Classic themes use PHP templates incompatible with block patterns. This plugin requires block theme with theme.json, block templates in templates/ folder, and WordPress 6.9+. Consider migrating to a modern block theme like Twenty Twenty-Five.

Will this work with my existing posts?

Yes! Use Post Format Repair Tool (Tools → Post Format Repair) to scan existing posts and automatically detect appropriate formats based on content. Tool analyzes first block and suggests matching format. Review before applying repairs. Tool saves a revision and changes the format assignment, not the post content.

What happens if I deactivate the plugin?

Content remains safe: format assignments stay in database, pattern blocks remain as standard blocks, Chat Log blocks show as “unsupported block” (content preserved), no data lost. If you reactivate, all functionality returns immediately.

Can I customize the format patterns?

Yes, multiple ways:
– Use filters in functions.php to modify pattern HTML
– Register custom patterns to override defaults
– Edit the blocks after insertion
– Use Global Styles to change colors, typography, spacing

Does the Status format prevent publishing over 280 characters?

No, 280-character limit is a soft suggestion, not a hard block. Shows real-time counter, visual warning when approaching limit, accessibility announcements, but you CAN publish longer status updates if needed.

What is the Bookmark Card integration?

Link format checks if the Bookmark Card plugin is installed. If active, uses bookmark-card blocks with rich previews, images, descriptions, automatic metadata fetching. If not installed, uses standard linked paragraphs. Both work perfectly—integration just enhances experience.

Does this work with podcasting plugins?

Partly. If the Podlove Podcasting Plugin for WordPress is active, the plugin adds styles so its web player fits the Audio format layout. It doesn’t read Podlove’s podcast metadata. The patterns themselves use WordPress core audio blocks.

What about accessible media players?

When Able Player is active, the plugin adds styles so its player fits the Video and Audio format layouts. The patterns themselves use WordPress core media blocks.

How do I use the Chat format?

You don’t need a separate plugin! Post Formats for Block Themes includes integrated Chat Log block (chatlog/conversation). Chat format works out of the box, no additional plugins required. Just select Chat format and paste conversation transcripts from Slack, Discord, Teams, WhatsApp, Signal, or Telegram.

Does the Chat format work with the RSS Chat plugin?

Yes, and it is worth knowing what that means before running both. RSS Chat publishes posts to the rss.chat network, and it decides what to send by looking for the core chat post format. Once RSS Chat is connected, a post you format as Chat here is also syndicated there.

Two things follow from that. Do not set the Chat format on a post just to get it syndicated, because this plugin will badge and style it as a conversation transcript, which is what the format is for. And if you leave format auto-detection on, a post that opens with a Chat Log block is given the Chat format for you, so it would be syndicated without anyone choosing that — set the format by hand on those posts, or turn detection off, if that matters to you.

Whether RSS Chat could route on something other than the post format is open upstream: issue #6. RSS Chat is distributed on GitHub, not WordPress.org.

Can I change formats after creating a post?

Yes. Open the post, select the Format row in the Post tab of the sidebar, and pick a format. The new format’s pattern is inserted at the top of the post and your existing blocks stay.

How does auto-detection know when NOT to change my format?

Detection applies once, on a post’s first save, and only when you haven’t chosen a format. After that it never reclassifies the post, so a format you change later stays. It also runs on posts created programmatically, such as through Micropub or WP-CLI.

Screenshots

Changelog

1.1.12

  • Fixed: Chat Log “Thread replies” buttons expand and collapse threads again. The block’s script now loads as a script module, and the thread state renders on the server. The old fallback script (view.js) is removed; WordPress 6.9 is the minimum.
  • Fixed: collapsed Chat Log threads stay readable in feeds and without JavaScript, then collapse once the page loads.
  • Fixed: the Chat format card and the Chat Log block no longer claim DOC, HTML or RTF support. Paste the text instead (#51). The WebVTT, SubRip and plain-text source choices are kept when you save. Chat Log editor strings are now translatable under the plugin’s text domain.
  • Fixed: Discord frame timestamps use the higher-contrast color from 1.1.8, which the compiled stylesheet had missed. The thread button meets the 24px target size.
  • Added: three Query Loop variations, “Format archive: Quote”, “Format archive: Link” and “Format archive: Status”, for listing one format’s posts on any page or template. Each post shows its own date.
  • Developers: a CI job loads Post Kinds for IndieWeb with this plugin and checks that the post-formats/format-data block bindings source has one owner.

1.1.11

  • Changed: readme and screenshots refreshed to match the plugin. Removed claims about a custom Format Switcher panel, locked first blocks, a “Scan All Posts” button, and a Pullquote-based Quote pattern, none of which exist; corrected the descriptions of auto-detection, the repair tool, and Podlove and Able Player support; added the settings page, format templates, Format Badge and Icon blocks, and style variations. New screenshots 1 to 5.

1.1.10

  • Changed: fourteen read abilities (list-formats, get-post-format, suggest-format, mf2-markup and others) are now available to MCP clients through the MCP Adapter’s default server.
  • Security: the switch-format and repair-formats abilities are no longer exposed over MCP. They still work through the REST API and PHP with the same permission checks.
  • Changed: detect-format and get-format-stats are annotated as read-only.

1.1.9

  • Fixed: the Lightbox Slideshow gallery variation’s dialog now fills the screen. Since 1.1.8 it opened as a small box in the top-left corner, because a native dialog keeps the browser’s fit-content width; the page behind it is dimmed again.
  • Fixed: a closed Lightbox Slideshow dialog no longer stays painted on the page after the first open and close.

1.1.8

  • Changed: Lightbox Slideshow gallery variation (opt-in through the image_gallery_styles flag) now injects a real <button class="pfbt-lightbox-trigger"> per image (instead of a tabindex-focusable figure) and opens a native <dialog> via .showModal(), so Escape-to-close and Tab focus cycling come from the browser and focus returns to the button that opened it.
  • Changed: removed the hardcoded large font size from the Status format pattern’s paragraph; size now comes from a theme-paintable --pfbt-format-status-font-size CSS custom property.
  • Changed: removed leftover empty placeholder paragraphs from the Aside, Audio, Chat, Gallery, Image, Link, Quote, Standard, and Video format patterns, and added a front-end-only filter that strips any future empty paragraph so it never reaches visitors or screen readers as a blank line.
  • Changed: the Link format’s fallback markup no longer includes an empty, non-functional anchor element.
  • Changed: Aside, Quote, and Status (title-less formats) now include a visually-hidden heading so every post has a real h1/h2 for screen readers and document outline.
  • Changed: Chat Log block’s Discord device-frame timestamp color now meets WCAG AA contrast (was 2.54:1, now roughly 6:1), and its container’s ARIA role changed from log to region.
  • Changed: the Status archive/single author avatar is now marked decorative for screen readers, since the adjacent author name link already conveys the same information.
  • Changed: the Filter Tags gallery variation’s chip bar role changed from toolbar to group, matching its actual (non-roving) keyboard behavior.
  • Fixed: pressing Escape now dismisses an open Lookbook Hotspots popover.
  • Fixed: pairing images in the Before/After Pairs gallery variation no longer drops a caption’s text from the DOM.

1.1.7

  • Security: post-formats/mf2-markup, post-formats/mf2-validate, post-formats/posse-prepare, and post-formats/get-post-format checked only a sitewide capability (read or edit_posts), not whether the caller could act on the specific post ID they supplied — a Subscriber could read a private post’s content through mf2-markup, or a Contributor could run posse-prepare against another user’s draft. All four now run their post_id through a shared guard that checks read_post/edit_post on that post before returning anything; a missing or invalid post now returns error code pfbt_not_found (was invalid_post), and a failed capability check returns pfbt_forbidden.
  • Security: that same guard also closes a second gap — read_post maps to the primitive read capability for any published post regardless of a post password, so any logged-in user could read a password-protected post’s content through mf2-markup. The guard now denies that unless the caller can also edit the post.
  • Security: post-formats/get-format-signals had its permission callback set to always allow; it now requires the read capability like the plugin’s other abilities.
  • Fixed: removed an unused editor nonce that was generated on every editor load, localized to JavaScript, and never verified or consumed anywhere.
  • Fixed: deactivating and reactivating the plugin now restores a synced pattern you hand-deleted, the same as it did in 1.1.6 — deactivation clears the stored plugin version, so the next visit to wp-admin after reactivation re-registers any pattern that’s missing.
  • Changed: the ten format patterns previously ran on the init hook, on every admin, admin-ajax, or REST request, gated by a one-week transient rather than by the plugin version — so roughly every week they’d re-run and overwrite any pattern you’d hand-edited back to the plugin’s built-in default. They’re now (re)created only on the first wp-admin visit after the plugin version changes, once per version rather than once a week, so updating to 1.1.7 overwrites a hand-edited pattern once and leaves it alone afterward. Activation no longer creates patterns or records the plugin version directly, since its hook can fire before the plugin’s own classes are guaranteed loaded; that recording now happens only once the patterns it corresponds to actually exist. pfbt_register_patterns() remains as a deprecated wrapper, guarded against a missing PFBT_Pattern_Manager class, so third-party code still calling it by name does not fatal.

1.1.6

  • Fixed: format icon sprites now ship in packaged builds — every released install rendered format icons as empty boxes. Props @derintolu.
  • Fixed: the ActivityPub integration no longer emits PHP warnings when its filters receive a post ID instead of a post object. Props @derintolu.
  • Fixed: the packaged zip no longer fatals on activation due to files missing from the build.
  • Fixed: creating a post no longer triggers an “Undefined array key” warning, and the Site Editor no longer loads an empty Default template — the Default option stays where it belongs, in the editor’s template list. Props @tjcafferkey.
  • Fixed: the Format Badge block registers in the editor without JavaScript on WordPress 7.0+, ending the “your site doesn’t include support for this block” placeholder. Props @tjcafferkey.
  • Fixed: the get-format-stats ability declares its MCP resource URI correctly.
  • Changed: tested up to WordPress 7.1, verified against a real 7.1 install.
  • Dev: new regression tests guard the template query contract and the Format Badge supports; the abilities registry fixes from the previous cycle are covered by tests.

1.1.5

Everything since 1.1.4, consolidated. The 1.2.x and 2.x lines were GitHub-only releases that never reached WordPress.org; the plugin’s public numbering continues from 1.1.4. Full per-release history lives in CHANGELOG.md on GitHub.

  • New: format styling system built on a --pfbt-* design token contract — the plugin owns layout, your theme owns paint. If you customized the old --wp--preset--color--format-* tokens, rename them to --pfbt-format-*; uncustomized sites see no visible change.
  • New: Format Badge and Format Icon blocks, a Block Bindings source (post-formats/format-data), SVG icon sets with a settings-page picker, and Chat Log front-end interactivity with thread grouping.
  • New: 52 opt-in block style variations — 16 image, 20 gallery, 16 quote/pullquote — behind the image_gallery_styles and quote_styles feature flags (default off). All variation colors resolve through the token contract, so palette-mapped styles follow the active theme automatically.
  • New: 20 display patterns and 18 opt-in block templates covering all nine non-standard formats, plus the Tools → Post Format Repair screen.
  • New: WordPress Abilities API integration with core, IndieWeb (microformats2, POSSE, webmention), and AI format-suggestion abilities, all behind feature flags.
  • Changed: automatic format detection is back with apply-once semantics — it applies once on first save from content and never overrides a manual choice.
  • Changed: requires WordPress 6.9 or newer; tested up to 7.0.
  • Fixed: template registration no longer leaks single-post markup onto the homepage, pages, or archives on heavily-themed sites.
  • Fixed: theme.json merging is additive — the active theme’s palette, gradients, and templates are preserved.
  • Fixed: Post Kinds for IndieWeb integration registers after the kind taxonomy exists and maps all 24 default kinds.
  • Fixed: style variation CSS loads on block-theme front ends; Quote and Video patterns no longer trigger the editor recovery prompt; debug logging is gated behind WP_DEBUG.

1.1.4 – 2025-12-19

Bug Fixes

  • Fixed: Critical issue where plugin’s theme.json was overriding theme layout settings (contentSize, wideSize), causing blank templates
  • Fixed: Plugin no longer overrides theme spacing settings (spacingSizes)
  • Fixed: Removed appearanceTools setting that could conflict with theme settings

Changes

  • Changed: Simplified theme.json to only include format-specific color palette additions
  • Changed: Plugin now respects all theme layout and spacing settings

1.1.3 – 2025-12-18

Performance

  • Fixed: Critical performance issue with revision queries on sites with many synced patterns
  • Added: Transient-based caching for pattern registration to avoid unnecessary database operations
  • Added: Pattern registration now skipped entirely on front-end for better performance
  • Added: Pattern updates only occur when content has actually changed
  • Added: Revision limiter for wp_block post type (limits to 3 revisions to prevent database bloat)

New Features

  • Added: “Settings” link on Plugins page that links to Post Format Repair tool for easy access

Bug Fixes

  • Fixed: Duplicate pattern insertion when selecting format from modal (patterns were being inserted twice)
  • Fixed: Status format character counter appearing twice in editor
  • Fixed: Aside format icon not displaying in Posts admin list (changed from dashicons-aside to dashicons-format-aside)
  • Fixed: JavaScript error “Cannot read properties of undefined (reading ‘postCategories’)” in block editor
  • Fixed: Pattern transient now cleared on plugin deactivation to ensure fresh patterns on reactivation

Improvements

  • Changed: Simplified all format patterns by removing unnecessary wrapper Group blocks
  • Changed: Status pattern now uses single paragraph with status-paragraph class
  • Changed: Aside pattern now uses single paragraph (no wrapper)
  • Changed: All other format patterns now use primary block + paragraph structure for cleaner editing

Security

  • Added: domReady wrapper for Post Format Block to prevent race conditions
  • Added: Null check with fallback icon for safer script initialization
  • Added: Asset file for Post Format Block script dependencies

1.1.2 – 2025-12-11

New Features

  • Added: “Default” template option in template chooser that explicitly clears template assignment and uses default template hierarchy
  • Added: Comprehensive logging system for tracking template assignment and REST API behavior for easier debugging

Improvements

  • Improved: Simplified editor UI by removing duplicate “Post Format” dropdown from sidebar – now uses WordPress’s built-in format selector in Status & visibility panel
  • Improved: Status format character counter moved from sidebar panel to editor notice for cleaner UI
  • Improved: Format selection modal now clearly shows “Standard (Single Template)” option with descriptive text
  • Improved: “Single” template from theme now properly appears in template chooser for posts
  • Improved: REST API now correctly returns ‘default’ template value when no template is assigned, fixing display issues

Bug Fixes

  • Fixed: Standard format posts no longer incorrectly show format templates (like “Aside Format”) when no template should be assigned
  • Fixed: Template chooser modal now correctly displays all available templates including theme’s default “Single” template
  • Fixed: Editor now properly reflects actual database state for template assignments instead of showing cached/stale values

Technical Changes

  • Changed: Removed FormatSwitcherPanel component to eliminate duplicate UI controls
  • Changed: Removed PluginDocumentSettingPanel wrapper for cleaner sidebar
  • Changed: “Default” template now added to all template queries for consistent availability
  • Changed: Added rest_prepare_post filter to ensure correct template values in editor
  • Changed: Template assignment logic now properly handles “default” template selection

1.1.1 – 2025-12-09

Bug Fixes

  • Fixed: Critical issue where format templates (Chat Format, Gallery Format, etc.) were appearing in the Template dropdown and hiding/replacing theme templates. Format templates now apply automatically via template hierarchy but don’t show as selectable options in the editor.

1.1.0 – 2025-12-08

New Features

  • Added: Post Format Block – Display block for showing post formats on the frontend (forked from Post Format Block by Aaron Jorbin)
  • Added: Post format column in Posts admin list with clickable filtering (similar to categories/tags display)
  • Added: Screen Options toggle for post format column visibility in admin
  • Added: Post format taxonomy display in all 9 format templates (categories, tags, and format shown together)
  • Added: Sortable post format column in admin list for easy organization
  • Added: Dashicons for each post format in admin column for visual identification

Improvements

  • Improved: Template assignment system now uses slug-only format (not full theme ID) for better compatibility
  • Improved: All 9 format templates now display categories, tags, and post format in a horizontal flex group
  • Improved: Consistent spacing added before taxonomy display across all templates
  • Improved: Post format taxonomy now available in REST API for block editor integration
  • Improved: Template dropdown now correctly displays format-specific template names
  • Improved: Post format support now properly merges with theme’s existing format support (no override)

Bug Fixes

  • Fixed: Template assignment dropdown showing “Aside Format” for all post types
  • Fixed: Post format support conflicting with theme-defined formats (now merges safely)
  • Fixed: Duplicate post format registration from Chat Log block
  • Fixed: Template storage format causing UI mismatch in editor sidebar
  • Fixed: Plugin check errors for WordPress.org submission compliance

Code Quality

  • Removed: All debug error_log() statements from production code
  • Removed: Development files, test scripts, and backup files
  • Improved: Variable naming to follow WordPress coding standards (all prefixed with pfbt_)
  • Improved: Output escaping in admin columns for security compliance
  • Improved: File naming (removed spaces from image filenames)

Developer

  • Added: Comprehensive test suite with 15 validation categories
  • Added: PHPCS, PHPStan, and PHPUnit configuration files
  • Added: Security scanning (SAST) and vulnerability checking
  • Added: PHP compatibility checks (7.4 – 8.4)
  • Added: Accessibility testing infrastructure
  • Added: Complete testing documentation (TESTING.md, TEST-REPORT.md)

1.0.0 – 2025-01-XX

Initial Release

  • Added: Format selection modal on new post creation with visual cards for all 10 post formats
  • Added: 10 format-specific block patterns optimized for each post type (Standard, Aside, Status, Link, Gallery, Image, Quote, Video, Audio, Chat)
  • Added: Locked first blocks in patterns to maintain format consistency while allowing full content freedom
  • Added: Automatic post format detection on save analyzing first block content structure
  • Added: Format Switcher sidebar panel for mid-edit format changes with content preservation options
  • Added: Status format 280-character validation with real-time counter and visual feedback
  • Added: Post format repair tool (Tools → Post Format Repair) for scanning and fixing format mismatches
  • Added: Integrated Chat Log block (chatlog/conversation) for conversation transcripts—no separate plugin needed
  • Added: Chat Log platform support: Slack, Discord, Teams, Telegram, WhatsApp, Signal with automatic detection
  • Added: Chat Log display styles: bubbles, IRC, transcript, timeline with full customization options
  • Added: Bookmark Card plugin integration for Link format with graceful fallback to standard linked paragraphs
  • Added: Theme-agnostic styling using CSS custom properties from theme.json for seamless integration
  • Added: Complete keyboard navigation for all interactive elements (modals, switcher, patterns)
  • Added: Screen reader support with ARIA labels, live regions, and semantic HTML structure
  • Added: RTL language support for international WordPress sites
  • Added: Complete internationalization with translation-ready strings and JavaScript translation support
  • Added: Developer filters: pfbt_registered_formats, pfbt_detected_format, pfbt_pattern_content
  • Added: Developer actions: pfbt_format_detected, pfbt_format_repaired, pfbt_format_changed
  • Added: Comprehensive format detection rules for gallery, image, video, audio, quote, link, chat blocks
  • Added: Block theme requirement validation on activation with helpful error messages
  • Security: All user input escaped and sanitized following WordPress security standards
  • Performance: JavaScript only loads in block editor, not on frontend for optimal site speed
  • Performance: CSS uses native custom properties, no JavaScript-generated styles for better performance
  • Performance: Auto-detection runs only on post save, not on every page load to prevent overhead
  • Privacy: No data collection, external API calls, cookies, or user tracking