Brasth Document Sync for Google Docs

Brasth Document Sync for Google Docs helps editorial teams use Google Docs as the source of truth while publishing clean WordPress content. Site owners provide their own Google OAuth web client, each WordPress user connects their own Google account, and authorized users can browse accessible Google Docs, link a document to a post or page, and sync content into WordPress. The plugin exports Google Docs as HTML ZIP packages, imports embedded images into the WordPress Media Library, rewrites image URLs, sanitizes the resulting HTML, and converts common document structures to Gutenberg block markup. If Google blocks a large HTML ZIP export, Brasth Document Sync retries through the Google Docs API fallback before changing post content. Features include:

• Self-managed Google OAuth setup wizard with next-action guidance.
• Server-side Google Drive document browser for My Drive and shared drives.
• Advanced Google Docs URL and raw file ID linking.
• Background sync through WP-Cron with source status and diagnostic logs.
• Searchable Sync Activity logs with troubleshooting views, advanced filters, recovery hints, and safe output-path details.
• Safe log clearing for one source or all visible sources without deleting synced content or source links.
• One-way Google Docs to WordPress sync for posts, pages, and enabled public custom post types.
• Media import for images exported from Google Docs.
• Default synced layout presets for Gutenberg imports: Clean Article, Documentation, and legacy Plain Blocks.
• Elementor layout presets for Elementor sync: Elementor Hero Page and Elementor Feature Block.
• Gutenberg block markup for common headings, paragraphs, lists, tables, code, callouts, and images.
• Documentation preset heuristics for semantic code, fenced code, Google Docs styled code-like paragraphs, and explicit Note/Tip/Warning/Important/Caution callouts.
• Uninstall cleanup for settings, encrypted user tokens, and scheduled events.

External Services Brasth Document Sync connects to Google services only after a site administrator saves a self-managed Google OAuth client ID and client secret and a WordPress user connects their Google account. This plugin sends requests to these Google services:

• Google OAuth 2.0 endpoints, to authorize a user's Google account and refresh access tokens.
• Google Drive API, to list visible Google Docs, shared drives, folders, document metadata, and HTML ZIP exports.
• Google Docs API, to read document structure when the large-document fallback is needed.

Data sent to Google can include OAuth client details supplied by the site owner, OAuth authorization codes, refresh-token requests, connected-user access tokens, Drive file IDs, folder IDs, shared-drive IDs, search text entered in the Drive browser, pagination tokens, and document export/read requests. Data received from Google can include the connected Google account email address, OAuth tokens, Google Docs titles, metadata, modified time, version identifiers, document export content, and image content URLs needed to import media into WordPress. Google's terms and privacy documents apply to these services:

• Google Privacy Policy: https://policies.google.com/privacy
• Google API Services User Data Policy: https://developers.google.com/terms/api-services-user-data-policy
• Google APIs Terms of Service: https://developers.google.com/terms

Brasth Document Sync also includes optional anonymous active-install telemetry. This setting is off by default and runs only when a site administrator enables usage diagnostics from the Setup consent prompt or the "Share anonymous usage diagnostics with Brasth" checkbox in Setup > Sync defaults. When enabled, the plugin sends one weekly POST request to https://telemetry.brasth.com/v1/check-in. This Brasth telemetry service is used to count active opted-in installs and understand version compatibility. The request contains only an anonymous site hash generated from a random install ID, the plugin slug, plugin version, WordPress version, PHP version, and telemetry consent version. It does not contain Google data, site URL, user email, post data, document IDs, document metadata, document content, or imported media. The telemetry service stores the fields listed above in Cloudflare D1, does not store IP addresses, user agents, request URLs, or request headers, and deletes rows that have not checked in for more than 90 days. Privacy Policy: https://docsyncwp.com/privacy-policy

1.1.3

• Added explicit WordPress Blocks versus Elementor Layout selection when linking Google Docs on Elementor-enabled sites.
• Added legacy Elementor upgrade actions for existing sources that predate explicit Elementor presets.
• Added safe Sync Activity details showing whether a sync used a Gutenberg preset, Elementor preset, or the legacy Elementor converter.
• Fixed large-doc fallback partial writes so selected Elementor presets are used consistently.
• Added Composer fixture coverage for large-doc fallback Elementor preset consistency.

1.1.2

• Added Elementor Hero Page and Elementor Feature Block presets for Elementor sync.
• Added a separate Elementor preset selector so Gutenberg and Elementor layout choices do not conflict.
• Added Elementor preset fingerprints so changing an Elementor preset forces safe re-conversion even when Google metadata is unchanged.
• Preserved existing Elementor sources without an explicit Elementor preset on the legacy Elementor conversion path.
• Added deterministic Elementor golden fixtures and Composer verification.

1.1.1

• Recommended for all users after the 1.1.0 layout preset release.
• Improved layout preset descriptions and setup guidance so site defaults and per-source layout choices are easier to understand.
• Added tracked layout fixture coverage for Clean Article, Documentation code blocks, Documentation callouts, Plain Blocks upgrade compatibility, and per-source preset overrides.
• Added layout fixture verification to CI so future preset changes are checked before release.

1.1.0

• Added a Default synced layout setting in Setup sync defaults for block editor imports.
• Added Clean Article, Documentation, and Plain Blocks Gutenberg layout presets.
• Expanded Documentation output for semantic code, fenced code, Google Docs styled code-like paragraphs, and explicit callout labels.
• Kept existing installs on Plain Blocks by default while new installs start with Clean Article.
• Added layout fingerprints so preset changes re-convert content even when Google metadata is unchanged.
• Kept Elementor sync on the existing Elementor conversion path.
• Added golden fixture coverage for article, image, documentation, table/callout/list, and legacy plain-block output.

1.0.9

• Hardened REST access so logged-in users must also be administrators or have edit/create capability on at least one enabled target post type.
• Required X-WP-Nonce for mutating DocSync REST requests while keeping _wpnonce only as a read-only GET fallback.
• Tightened source, Drive browser, document inspection, sync log, and settings request validation before service calls.
• Limited post/list-table DocSync assets, notices, and source metadata output to users with applicable target capabilities.
• Confirmed public settings, OAuth account status, admin inline config, and sync diagnostics do not expose client secrets or Google tokens.
• Added a branded Brasth admin shell with compact mastheads, contained notices, consistent button sizing, and runtime branding assets.
• Reworked Setup into a task-first workspace with one primary next action for saving credentials, connecting Google, reconnecting scope, or creating the first synced draft.
• Moved Google Cloud help into the credential task and kept sync defaults as secondary configuration.
• Compact source row actions keep Sync and Logs controls easier to scan.
• Added searchable Sync Activity logs with troubleshooting views, advanced filters, useful summaries, recovery hints, and composed empty states.
• Replaced destructive browser prompts with Radix confirmation dialogs for log clearing and account disconnect.
• Added safe clear-log actions for one source or all stored source logs without deleting source links, sync status, credentials, progress, or synced content.

1.0.8

• Reworked the setup flow into a first-sync checklist with clearer Google API, OAuth redirect URI, credential, account connection, and first draft guidance.
• Added a connected-state Create synced draft path that links to the existing Posts list Add Sync Doc flow.
• Improved empty states for Sources, Logs, and the Drive browser with next actions and decorative illustrations.
• Polished admin UI alignment for setup loading, setup step badges, source log actions, and the Google Drive source modal.
• Added POT generation, JS translation JSON generation plumbing, and script translation loading for admin bundles.
• Translated OAuth JSON import parser errors and refreshed placeholder guidance for translators.

1.0.7

• Updated npm dev dependencies to latest patch and minor compatible versions.
• Fixed known development-only vulnerabilities in Vite and js-yaml via dependency updates.
• Expanded CI PHP lint matrix to PHP 8.2 and 8.3 with PHPCompatibilityWP 8.3 checks.
• Added Composer and pnpm security audits to the CI pipeline.
• Verified PHP 8.2/8.3 compatibility through PHPCompatibilityWP static analysis.
• Verified REST permissions, media sideloading, OAuth token storage, and admin output escaping.

1.0.6

• Combined the roadmap hardening and performance patch scope after 1.0.5 shipped.
• Split Setup, Sources, and Logs into separate admin bundles with screen-specific CSS.
• Lazy-loaded the Google Drive browser assets from the post sync modal.
• Removed an unused WordPress data script dependency from post sync admin screens.
• Improved loading semantics for admin and Drive browser states.

1.0.5

• Added Elementor sync support (opt-in via settings).
• Added per-post Elementor/block sync toggle in the post sync meta box.
• Synced Elementor posts use native Elementor widget layouts with container or section/column wrapping.
• Scoped Elementor CSS cache invalidation to the synced post, with global cache clear as fallback.

1.0.4

• Improved admin UI/UX for Sources, Logs, and Drive Browser.
• Fixed Sources table row tag rendering and layout.
• Fixed color and high-contrast accessibility issues.
• Fixed admin asset enqueuing on Sources and Logs pages.
• Added WordPress.org screenshot assets and readme sync lint.
• Hardened the build pipeline and installable ZIP artifact layout.

1.0.3

• Hardened release metadata, WordPress.org readme compliance, CI checks, and admin i18n coverage.

1.0.2

• Updated WordPress.org listing artwork and directory tags.

1.0.1

• Aligned plugin version metadata for the 1.0.1 GitHub release package.

1.0.0

• Initial WordPress.org-ready release.
• Added self-managed Google OAuth setup.
• Added Google Drive document browser and advanced URL/file ID linking.
• Added one-way Google Docs to WordPress sync for posts, pages, and enabled public custom post types.
• Added HTML ZIP import, image sideloading, Gutenberg block conversion, background sync, and diagnostic logs.