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.

Documentation:

• Site: https://docsyncwp.com/

• Setup walkthrough: https://docsyncwp.com/how-it-works/

• User guide: https://docsyncwp.com/user-guide/

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.

• Optional admin feedback form that creates a public GitHub issue without storing a GitHub token in the plugin.

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.

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. com/privacy-policy

Authorized users can optionally submit feedback from the admin area. com/Brasth/DocSync-WP. The plugin also sends plugin, WordPress, and PHP versions for troubleshooting.

It does not send the site URL, user identity, Google data, document content, or credentials. Reports are rate-limited to 5 per user and 20 per IP per hour using short-lived WordPress transients. Do not include secrets, private URLs, or customer data in feedback.

The GitHub token is stored only as a Cloudflare Worker secret.

Privacy

Brasth Document Sync stores site-level Google OAuth client settings, encrypted per-user Google tokens, connected Google account email addresses, linked Google document metadata, source sync status, diagnostic sync events, and imported attachment metadata in the WordPress database.

During document browsing and sync, Brasth Document Sync communicates with Google OAuth, Google Drive API, and Google Docs API as described in the External Services section. Imported Google Docs images are stored in the WordPress Media Library. Synced WordPress posts and imported media remain on the site until a user with sufficient permission changes or deletes them.

Optional anonymous Brasth telemetry is off by default. When enabled by a site administrator, the plugin sends one weekly active-install check-in containing only an anonymous site hash and plugin/WordPress/PHP versions. No Google data, site URL, user email, document IDs, content, or imported media are sent to Brasth telemetry.

Feedback reports are optional and become public GitHub issues. Do not include secrets, private URLs, customer data, Google document data, or other sensitive information. The plugin does not send the WordPress site URL or user identity with feedback.

Uninstall removes plugin settings, encrypted user Google tokens, and scheduled cron events. Linked post metadata is retained by default; define DOCSYNC_WP_FULL_UNINSTALL or return true from the docsync_wp_full_uninstall filter to remove Brasth Document Sync post metadata. Synced posts and imported media are not deleted automatically.

Source And Build Instructions

Human-readable frontend source is included in resources/. Built assets are included in build/.

To rebuild the admin assets from source:

• Install PHP dependencies with composer install.

• Install frontend dependencies with pnpm install --frozen-lockfile.

• Build assets with pnpm build.

The build uses Vite and writes screen-specific manifests for Setup, Sources, Logs, Post Sync, and the lazy Drive browser, plus hashed CSS/JS assets. Runtime React is provided by WordPress through wp-element.