From b01cf6c307d8dc8fda01db9ce46eee296d1e21d6 Mon Sep 17 00:00:00 2001 From: Oscar Garita Date: Thu, 2 Apr 2026 21:55:36 -0600 Subject: [PATCH 1/2] Rename readme --- plugins/emdash-exporter/{readme.txt => readme.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename plugins/emdash-exporter/{readme.txt => readme.md} (100%) diff --git a/plugins/emdash-exporter/readme.txt b/plugins/emdash-exporter/readme.md similarity index 100% rename from plugins/emdash-exporter/readme.txt rename to plugins/emdash-exporter/readme.md From d62d5b721ac13b52a127a781759e7dcf17b4df63 Mon Sep 17 00:00:00 2001 From: Oscar Garita Date: Thu, 2 Apr 2026 22:07:50 -0600 Subject: [PATCH 2/2] Format readme --- plugins/emdash-exporter/readme.md | 103 +++++++++++++++--------------- 1 file changed, 53 insertions(+), 50 deletions(-) diff --git a/plugins/emdash-exporter/readme.md b/plugins/emdash-exporter/readme.md index d1c4a6c..e95456c 100644 --- a/plugins/emdash-exporter/readme.md +++ b/plugins/emdash-exporter/readme.md @@ -1,89 +1,92 @@ -=== EmDash Exporter === -Contributors: ascorbic -Tags: export, migration, cms, emdash, astro -Requires at least: 5.6 -Tested up to: 6.4 -Requires PHP: 7.4 -Stable tag: 1.0.0 -License: GPL3 -License URI: https://opensource.org/license/gpl-3.0 +# EmDash Exporter + + Contributors: ascorbic + Tags: export, migration, cms, emdash, astro + Requires at least: 5.6 + Tested up to: 6.4 + Requires PHP: 7.4 + Stable tag: 1.0.0 + License: GPL3 + License URI: https://opensource.org/license/gpl-3.0 Export your WordPress content to EmDash CMS via REST API. Full support for posts, pages, custom post types, ACF fields, media, and SEO data. -== Description == +## Description EmDash Exporter adds REST API endpoints to your WordPress site that allow EmDash CMS to import your content directly—no file downloads required. **Features:** -* **One-click import** – Connect EmDash to your site and import everything -* **Full content** – Posts, pages, and custom post types including drafts -* **Media with metadata** – Images, videos, and files with alt text, captions, and dimensions -* **Custom fields** – Full ACF support plus any custom meta fields -* **SEO data** – Yoast SEO and Rank Math meta automatically included -* **Taxonomies** – Categories, tags, and custom taxonomies with hierarchy -* **Authors** – User data for proper attribution +- **One-click import** – Connect EmDash to your site and import everything +- **Full content** – Posts, pages, and custom post types including drafts +- **Media with metadata** – Images, videos, and files with alt text, captions, and dimensions +- **Custom fields** – Full ACF support plus any custom meta fields +- **SEO data** – Yoast SEO and Rank Math meta automatically included +- **Taxonomies** – Categories, tags, and custom taxonomies with hierarchy +- **Authors** – User data for proper attribution -**Authentication:** +## Authentication Uses WordPress Application Passwords (built into WordPress 5.6+). Create an application password in your user profile, then use it with your WordPress username to authenticate API requests. -== Installation == +## Installation 1. Upload the `emdash-exporter` folder to `/wp-content/plugins/` 2. Activate the plugin through the 'Plugins' menu in WordPress 3. Create an Application Password: Users → Your Profile → Application Passwords 4. In EmDash, enter your site URL and credentials to begin import -== API Endpoints == +## API Endpoints All endpoints are under `/wp-json/emdash/v1/` -**Public (no auth required):** +### Public (no auth required): + +- `GET /probe` – Site info and capabilities + +### Authenticated: -* `GET /probe` – Site info and capabilities +- `GET /analyze` – Full site analysis for import planning +- `GET /content?post_type=post` – Get posts (paginated) +- `GET /media` – Get media items (paginated) +- `GET /media/{id}?include_data=true` – Get single media item with base64 data +- `GET /taxonomies` – Get all taxonomies and terms +- `GET /options` – Get site options -**Authenticated:** +## Frequently Asked Questions -* `GET /analyze` – Full site analysis for import planning -* `GET /content?post_type=post` – Get posts (paginated) -* `GET /media` – Get media items (paginated) -* `GET /media/{id}?include_data=true` – Get single media item with base64 data -* `GET /taxonomies` – Get all taxonomies and terms -* `GET /options` – Get site options +### Do I need to install anything on my EmDash site? = -== Frequently Asked Questions == +> No. This plugin runs on your WordPress site and exposes an API that EmDash connects to. -= Do I need to install anything on my EmDash site? = +### Is my content secure? -No. This plugin runs on your WordPress site and exposes an API that EmDash connects to. +> Yes. All export endpoints (except /probe) require authentication. Use Application Passwords and HTTPS. -= Is my content secure? = +### What about my media files? -Yes. All export endpoints (except /probe) require authentication. Use Application Passwords and HTTPS. +> Media URLs are included in the export. EmDash downloads them directly from your WordPress site during import. Optionally, small files can be transferred inline as base64. -= What about my media files? = +### Does this work with custom post types? -Media URLs are included in the export. EmDash downloads them directly from your WordPress site during import. Optionally, small files can be transferred inline as base64. +> Yes! All public post types are automatically included, along with their custom fields. -= Does this work with custom post types? = +### What about ACF fields? -Yes! All public post types are automatically included, along with their custom fields. +> Full ACF support. Field groups are analyzed, and field values are exported with proper type information. -= What about ACF fields? = +## Changelog -Full ACF support. Field groups are analyzed, and field values are exported with proper type information. +### 1.0.0 -== Changelog == +- Initial release +- REST API endpoints for content, media, taxonomies, options +- ACF field support +- Yoast SEO and Rank Math integration +- Application Passwords authentication -= 1.0.0 = -* Initial release -* REST API endpoints for content, media, taxonomies, options -* ACF field support -* Yoast SEO and Rank Math integration -* Application Passwords authentication +## Upgrade Notice -== Upgrade Notice == +### 1.0.0 -= 1.0.0 = -Initial release +> Initial release