外掛標籤
開發者團隊
② 後台搜尋「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, and recovery hints.
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
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.
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.
