Description
This plugin enables theme developers to ship patterns that behave as synced patterns (reusable blocks) while maintaining the benefits of theme-bundled patterns. When a theme pattern is marked as synced, it automatically becomes available as a reusable block that updates across all instances when modified.
- Theme-Provided Synced Patterns: Convert any theme pattern into a synced pattern by adding a simple metadata flag
- Automatic Synchronization: Updates to synced patterns propagate across all instances site-wide
- Block Bindings Support: Full compatibility with WordPress block bindings
- Template Integration: Use synced patterns in templates and template parts
- Seamless User Experience: Synced patterns appear naturally in the pattern inserter
Usage
For Theme Developers
To make a theme pattern synced, add Synced: true to the pattern file’s metadata header:
<?php
/**
* Title: My Synced Pattern
* Slug: mytheme/my-pattern
* Categories: featured
* Synced: true
*/
?>
<!-- Your pattern blocks here -->
Using Synced Patterns in Templates
Reference synced patterns in templates or other patterns using the pattern block:
<!-- wp:pattern {"slug":"mytheme/my-pattern"} /--><h3>Development</h3>
The plugin source is available on GitHub.
Node & NPM are needed to install and run the development tools:
npm run start— Start the development environmentnpm run stop— Stop the development environmentnpm run test— Run unit tests (requires running environment)npm run build— Build production assets
See the source for more details.
Installation
- Download the plugin from the WordPress Plugin Directory or GitHub
- Upload to your
/wp-content/plugins/directory - Activate the plugin through the ‘Plugins’ menu in WordPress
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Synced Patterns for Themes” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Synced Patterns for Themes” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial release
1.2.0
- Enhanced pattern synchronization using logic from Pattern Builder
1.2.1
- Improved Documentation