=== SirSync ===
Contributors: Kodeala
Tags: content sync, staging, deployment, page sync, content migration
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Push or pull individual WordPress pages, posts, and media between development and production sites without syncing the entire website.

== Description ==

Build on staging. Deploy to production. Only move what changed.

SirSync gives you page-level control over WordPress content deployment. Build, edit, and experiment safely on a development or staging site, then push an individual page or post to production when it's ready.

SirSync is bidirectional, so content can move in either direction. Push finished work to production or pull the latest production content back to development without migrating the entire website or replacing the destination database.

= Deploy With a Click =

When your page is ready, push it directly from WordPress to the connected site. SirSync handles the deployment without requiring you to repeat your changes manually on production.

Need to work with the latest production version instead? Pull it back to your development or staging site.

= Bring the Media With It =

A page is more than its text.

SirSync synchronizes supported images and media used by your content and remaps those references for the destination site. Featured images, content images, and supported page builder media can move with the content they belong to instead of being uploaded and reconnected manually.

= Work With the Editors You Already Use =

SirSync Free supports popular WordPress editing experiences, including:

* Gutenberg
* Classic Editor
* Elementor
* SiteOrigin

Build your content using the tools you're already comfortable with, then deploy it through SirSync.

= Keep Your SEO Metadata =

Supported Yoast SEO and All in One SEO metadata can be synchronized with your pages and posts, so important page-level SEO settings can travel with the content you're deploying.

= Move What You Choose =

SirSync doesn't require a full-site deployment just because one page changed. Push or pull the individual content you're working on while leaving the rest of the destination site alone.

This makes SirSync useful for:

* Building new pages safely on staging
* Updating existing production pages
* Testing design changes before deployment
* Moving approved content to production
* Bringing current production content back to development
* Managing content across connected WordPress environments

= See What Was Deployed =

Operation logging gives you a record of SirSync synchronization activity so you can see what was pushed or pulled between your connected websites.

= SirSync Free Includes =

* Bidirectional Push and Pull
* Individual page and post deployment
* Media synchronization and remapping
* Gutenberg support
* Classic Editor support
* Elementor support
* SiteOrigin support
* Supported Yoast SEO metadata
* Supported All in One SEO metadata
* Manual deployments
* Operation logging
* Secure site pairing

= Need More? =

SirSync Pro extends SirSync for more advanced WordPress deployment workflows with support for:

* Custom post types and their associated metadata
* Advanced Custom Fields (ACF) field data
* ACF Field Groups, Post Types, Taxonomies, and Options Pages
* Custom fields and post metadata
* WooCommerce products, variations, product data, and media
* WordPress menus
* Scheduled Push and Pull deployments
* Deployment email notifications
* Custom mapping rules for supported content and media references
* Additional supported Pro integrations

Schedule content to move between connected sites at a specific date and time, synchronize custom post types and their metadata, or push ACF-powered content without manually recreating field data on the destination site.

== Installation ==

= Install SirSync =

* Install and activate SirSync on each WordPress website you want to connect.
* In the WordPress dashboard, go to Tools > SirSync.
* Open the Pairing section on the website you want to connect.
* Generate a connection code.
* Copy the connection code and enter it on the other website.
* Complete the connection and verify that the remote website is shown as connected.
* Repeat the pairing process in the opposite direction if you want both websites to be able to initiate push and pull operations.

= Configure synchronization =

* Go to Tools > SirSync and review your synchronization settings.
* Choose which supported content settings should be included during deployments.
* Save your settings.

= Push or pull content =

After the websites are connected, open a supported page or post in WordPress.

SirSync controls are available from supported WordPress editing interfaces. Choose Push to send the content to the connected website or Pull to retrieve the corresponding content from it.

SirSync will create or update the corresponding content on the connected website and remap supported media and content references as needed.

For best results, install the same themes, page builders, and plugins required by the synchronized content on both websites.

== Frequently Asked Questions ==

= Does SirSync copy the entire WordPress database? =

No. SirSync selectively synchronizes supported WordPress content between connected websites. It does not replace the destination website's entire database.

= Do I need SirSync installed on both websites? =

Yes. SirSync must be installed and activated on both websites before they can be paired and content can be synchronized.

= Can I push and pull content? =

Yes. SirSync supports both push and pull workflows between connected websites.

= Does SirSync support page builders? =

Yes. The Free edition supports Gutenberg, Classic Editor, Elementor, and SiteOrigin (More in the future).

Both websites should have the appropriate page builder and related plugins installed when synchronizing builder content.

= Does SirSync synchronize media? =

Yes. SirSync supports media synchronization and remapping for supported images, attachments, and media references.

= Does SirSync synchronize custom fields? =

Custom field and post metadata synchronization is available with SirSync Pro. SirSync Pro also includes Scan Keys for discovering and configuring metadata associated with supported content.
= Does SirSync support SEO metadata? =

Yes. Supported page and post SEO metadata can be included during synchronization.

= What is SirSync Pro? =

SirSync Pro is a separate add-on that extends SirSync with additional synchronization features and integrations.

== Changelog ==

= 1.0.0 =

Initial public release of SirSync.

* Added secure pairing between WordPress websites.
* Added selective push and pull synchronization for pages and posts.
* Added media synchronization with support for featured images and supported media references.
* Added support for Gutenberg.
* Added support for the Classic Editor.
* Added support for Elementor.
* Added support for SiteOrigin.
* Added synchronization of supported page and post SEO metadata.
* Added content and media reference remapping between connected websites.
* Added manual deployment controls from supported WordPress editing interfaces.
* Added deployment and operation logging.
* Added integration support for the separate SirSync Pro add-on.