Block Pattern Inserter

Description

A powerful WordPress plugin for bulk inserting reusable block patterns into posts with flexible placement options, presets, and safety features.

## Features

### 🚀 **Bulk Pattern Insertion**
– Insert any reusable block into multiple posts at once
– Process hundreds of posts efficiently with batch processing
– Real-time progress tracking with visual indicators

### 📍 **Flexible Placement Options**
– After first image (with automatic fallbacks)
– Before first H2 heading
– After first paragraph
– After second block
– Custom position (specify block number)

### 🎯 **Smart Post Selection**
– All published posts
– Posts in specific categories
– Posts within date range
– Advanced filtering options

### 🛡️ **Safety Features**
– Dry run mode (preview changes before applying)
– Skip posts with existing patterns
– Create backups for easy reversal
– Batch processing to avoid timeouts
– One-click reversal of changes

### ⚡ **Advanced Features**
– Pattern preview before insertion
– Save and load presets for common workflows
– Import/export settings
– Real-time progress tracking
– Detailed operation logs
– Download log files
– Responsive admin interface

## Installation

1. Upload the plugin files to `/wp-content/plugins/block-pattern-inserter/`
2. Activate the plugin through the ‘Plugins’ menu in WordPress
3. Navigate to Tools → Block Pattern Inserter to configure the plugin
4. The plugin will automatically create necessary assets on activation

## Uninstall

The plugin includes a **Data Management** setting that allows you to control what happens when you uninstall:

– **Enabled (Default: Disabled)**: Complete cleanup – removes all database options, post meta backups, generated files, and cached data
– **Disabled**: Preserves all plugin data for future reinstallation

You can change this setting in the plugin’s admin interface under **Tools → Block Pattern Inserter → Data Management**.

## Usage

1. Go to Tools → Block Pattern Inserter in your WordPress admin
2. Select a reusable block pattern from the dropdown
3. Choose your placement strategy
4. Select which posts to update
5. Run a dry run first to preview changes
6. Review results and run live if satisfied

## Perfect For

– Adding table of contents to existing posts
– Inserting call-to-action blocks
– Adding newsletter signup forms
– Inserting advertisements or promotional content
– Adding author bio sections
– Bulk content updates and improvements

## Requirements

– WordPress 5.0 or higher
– PHP 7.0 or higher
– Block Editor (Gutenberg) support

## File Structure

“`
block-pattern-inserter/
├── block-pattern-inserter.php # Main plugin file
├── includes/
│ ├── class-block-pattern-inserter.php # Main plugin class
│ ├── class-admin.php # Admin interface
│ ├── class-processor.php # Post processing logic
│ └── class-presets.php # Preset management
├── assets/ # Auto-generated on activation
│ ├── js/
│ │ └── admin.js # Admin JavaScript
│ └── css/
│ └── admin.css # Admin styles
├── readme.txt # WordPress plugin readme
└── README.md # This file
“`

## Development

The plugin follows WordPress coding standards and uses:
– Namespaced classes to prevent conflicts
– Proper nonce verification for security
– Comprehensive error handling
– Translation-ready strings
– Responsive admin interface
– Efficient batch processing

## License

This plugin is licensed under the GPLv2 or later. You are free to modify and distribute it according to the terms of the license.

## Support

For support, feature requests, or bug reports, please visit [FrogStoneMedia](https://www.frogstonemedia.com) or contact us through the WordPress support forums.

## Changelog

### Version 1.1.0
– **New Features:**
– Added pattern preview functionality
– Implemented preset management system
– Added import/export settings
– Added reversal functionality for easy undo
– Enhanced progress tracking with visual indicators

– **Improvements:**
– Improved error handling and logging
– Added support for more caching plugins
– Enhanced user interface with better responsiveness
– Optimized batch processing for better performance

– **Bug Fixes:**
– Fixed placement detection for complex block structures
– Improved pattern matching for various block types
– Enhanced backup and restore functionality

### Version 1.0.0
– Initial release
– Basic pattern insertion functionality
– Dry run mode for safe testing
– Progress tracking and logging
– Multiple placement strategies
– Post filtering options

Installation

1. Upload the plugin folder to wp-content/plugins.
2. Activate via the WordPress Plugins screen.
3. Navigate to Tools → Block Pattern Inserter.
4. Select a pattern, define placement, choose your post set, and execute a dry run.

Licensing and Support

The plugin is offered for $125 on Frog Stone Media, which includes a year of updates and downloads. Your own usage of the plugin is unlimited, on as many sites as you want. There is no license key or tracking within the Block Pattern Inserter plugin.

Support is offered at Frog Stone Media’s development rates, which can either be hourly or per project. This policy is due to the complexity of the plugin and large WordPress sites. Email support@frogstonemedia.com for help.