Posts to GitHub

Posts to GitHub exports your published posts as Markdown files, with YAML front matter, to an existing GitHub repository (public or private). The goal is to build, over time, a text corpus of your writing that's useful for training or guiding a consistent writing style in tools like Claude. Features:

• Export a single post from its edit screen, with live status and trace log
• Bulk export from a dedicated Posts screen: filters, pagination, multi-page selection, stoppable progress
• Single commit and push for the whole bulk export batch by default (opt out for one commit per post), with automatic retry on GitHub rate limits either way
• Optional automatic export of newly published posts and automatic re-export of updated posts, both in the background via WP-Cron
• Read-only view of posts that were exported but are no longer published (draft, private, scheduled or trashed)
• Connection test and automatic branch detection against the configured GitHub repository
• WP-CLI commands for scripted single or bulk exports
• English by default, with an included Italian translation
• Git Updater compatible for seamless updates from GitHub The plugin never creates the repository, never uploads binary images (they stay as absolute links to the source site), and only works on published post content.

1.5.15

• Taxonomy backup section: fixed intro paragraph layout and added direct links to wp-categories.json/wp-tags.json on GitHub.
• Added a "back to top" floating button to the Export posts screen.

1.5.14

• Added a taxonomy backup section on the Export posts screen: pushes wp-categories.json and wp-tags.json to the repository root on demand, keeping a versioned snapshot of your categories and tags alongside your exported posts. WordPress stays the source of truth; nothing is ever read back from GitHub.

1.5.13

• First release published to the WordPress.org SVN repository.
• Fixed the bundled POTOGH_VERSION constant, which was out of sync with the plugin header.
• Release packaging now strips vendor/*/bin directories, addressing a WordPress.org review note about non-plugin files in the distributed zip.

1.5.12

• Aligned the text domain with the plugin slug (posts-to-github-md) across all files and the plugin header.
• Sanitized the branch and base_folder settings with sanitize_text_field() instead of trimming only.
• Removed bundled translation files (.po/.mo/.pot); translations are now handled via translate.wordpress.org.

1.5.11

• The export status text ("Exported on ...") in the bulk export table is now a direct link to the file on GitHub, opening in a new tab.
• Added the Release Asset: true plugin header so Git Updater installs the clean production zip instead of the raw main branch zip.

1.5.10

• Silenced the remaining informational meta_query slow-query warnings from the WordPress Plugin Check tool with justified phpcs:ignore annotations: the plugin's export-status filters query its own _potogh_exported_at/_potogh_path post meta and have no WP_Query alternative.

1.5.9

• Fixed remaining WordPress Plugin Check findings from a second review pass: nonce-verification and input-sanitization ignore annotations that only covered part of a multi-line statement now cover the whole block.

1.5.8

• Addressed WordPress Plugin Check findings ahead of directory submission: missing translators comments, unordered placeholders, unescaped pagination output, missing ABSPATH guard, deprecated load_plugin_textdomain() call, and outdated "Tested up to" header.

1.5.7

• Failed exports now record an error message on the post, shown as a warning in the post edit metabox, the bulk export table, and the "Exported, no longer published" view, instead of failing silently in the background.
• "Exported, no longer published" view: added "Delete from GitHub" and "Ignore" actions per post.
• Fixed "Invalid request. sha wasn't supplied" error when re-exporting a post whose GitHub file sha wasn't recorded locally: the plugin now looks up the file's current sha on GitHub before writing, instead of only relying on cached post meta.

1.5.6

• The bulk export screen's "posts per page" is now set via the native WordPress Screen Options panel instead of a custom dropdown.
• Faster pagination on the bulk export screen: most filter combinations now paginate at the database level instead of loading every matching post into memory.

1.5.5

• Plugin renamed from "WordPress Posts to GitHub" to "Posts to GitHub" to comply with the WordPress trademark policy.

1.5.4

• "Test connection" moved next to the Repository field.
• The Repository field is now locked (read-only) once a repository is configured; click "Change repository" to unlock and edit it.

1.5.3

• "Save Changes" on the Settings page no longer requires re-running "Test connection" on every visit; only the first setup or changes to token/repository/branch require it.

1.5.2

• Added a "Settings" quick link on the Plugins list screen.
• The author's name in the Settings page footer now links to gioxx.org.
• Settings page title changed to "Export posts to GitHub: Settings" for clarity.

1.5.1

• Category and tag filters on the bulk export screen now show a live post count per term, computed against the currently active filters.
• Bulk export now uses the single-commit batch method only when 2 or more posts are selected; exporting a single post always uses the per-post commit flow, regardless of the "Bulk export method" setting.
• Bulk export no longer force-reloads the page when done; status icons and stat tiles already update live, and successfully exported posts are automatically deselected.
• Fixed a fatal error on the export screen caused by the wrong taxonomy name being used for tag counts.

1.5.0

• Bulk export now writes the whole selected batch to GitHub in a single commit and push (via the Git Data API) instead of one commit per post, cutting API calls from ~2N to about 5 and largely avoiding rate limits. Opt-out setting included to keep one commit per post.

1.4.0

• Add optional automatic re-export of updated posts, a read-only view of exported-but-unpublished posts, automatic retry on GitHub rate limits, uninstall data cleanup (with an opt-out setting), and WP-CLI commands.

1.3.0

• Add optional automatic export of newly published posts, scheduled via WP-Cron so the Publish button is never delayed.

1.2.0

• Unify bulk export into its own Posts screen, with filters (status, search, category, tag, month), WP-native pagination, multi-page selection, a stoppable live progress/log panel, and export status stat tiles.
• Add GitHub connection test and automatic branch detection in Settings.
• Numerous UX refinements and bug fixes across the settings and export screens (spinners, icon/status sync, layout, accessibility).

1.1.0

• Add plugin metadata, repository URL parsing, status icons, and full English/Italian localization.

1.0.0

• Initial release: single-post and bulk export to a GitHub repository via the Contents API.