Editorio

Automates news creation in WordPress by importing RSS feeds and transforming them into structured draft posts.

---

🎯 Purpose

Editorio is a WordPress plugin designed to automate the process of news aggregation and draft generation.

It allows users to register RSS sources, collect content, and transform it into editable drafts inside WordPress.

---

🧠 Core Concept

Editorio acts as a content pipeline:

Sources → Collection → Processing → Draft → Review → Editor

---

🏗️ Architecture Overview

The plugin is structured into modular layers:

• Sources Module → manages RSS feeds
• Collector Module → fetches feed data
• Processor Module → transforms raw data into content
• Draft Module → builds structured drafts
• Review Module → UI for approval/discard
• Publisher Module → sends content to WP editor

---

📦 Features

✅ Implemented (MVP Goal)

• RSS source registration
• Feed fetching
• Draft generation (basic)
• Draft review screen
• Send draft to WordPress editor

🧪 Planned

• Content filtering rules
• Duplicate detection
• Multi-source merging (same topic)
• AI-assisted rewriting
• Scheduling (cron)
• Tag/category auto-detection

---

🔄 Workflow

1. Register Sources

User adds RSS feed URLs.

2. Fetch Content

System retrieves items from feeds.

3. Process Content (WIP)

• Normalize data
• Remove duplicates
• Prepare structure

4. Generate Draft

Create a structured draft article.

5. Review

User can:

• Approve
• Discard
• Send to editor

6. Publish

Draft becomes a WordPress post.

---

🧱 Data Model (Conceptual)

Source

• id
• name
• url
• active

FeedItem

• id
• source_id
• title
• content
• link
• published_at

Draft

• id
• title
• content
• status (pending, approved, discarded)
• created_at

---

⏱️ Execution Modes

• Manual trigger
• Scheduled (cron) (planned)

---

🛠️ Tech Stack

• PHP (WordPress plugin)
• JavaScript (React for admin UI)
• WordPress REST API
• WP Cron (planned)

---

📌 Roadmap

• [ ] Sources UI
• [ ] Feed ingestion service
• [ ] Draft builder
• [ ] Review interface
• [ ] Editor integration
• [ ] Deduplication engine
• [ ] AI integration
• [ ] Scheduling system

---

🤝 Contributing

This project is being developed with AI-assisted workflows. See AGENTS.md for development guidelines.

---

Front-end Build (Webpack)

The plugin uses @wordpress/scripts (webpack under the hood) to compile assets from src/ into bundle/.

Structure

• src/js/index.js -> outputs into bundle/js/index.js
• src/css/index.scss -> outputs into bundle/css/index.css
• src/js/modules/sources/index.js -> outputs into bundle/modules/sources/index.js
• src/js/modules/draft/index.js -> outputs into bundle/modules/draft/index.js
• src/js/modules/review/index.js -> outputs into bundle/modules/review/index.js
• webpack.config.js -> custom entry/output settings

Commands

cd public/wp-content/plugins/editorio
npm install
npm run start
npm run build
npm run release

Release Output

npm run release creates an installable zip at:

• dist/editorio.zip

The release process excludes development files (src, node_modules, webpack config, package files, etc.) and keeps runtime files only.

---

Sources CRUD (Admin)

After activating the plugin, you can manage RSS sources in the WordPress admin menu:

• Editorio

The page includes list/create/update/delete operations backed by the REST API:

• GET /wp-json/editorio/v1/sources
• GET /wp-json/editorio/v1/sources/{id}
• POST /wp-json/editorio/v1/sources
• PUT /wp-json/editorio/v1/sources/{id}
• DELETE /wp-json/editorio/v1/sources/{id}

Required payload fields for create/update:

• name (string)
• feed_url (valid URL)
• is_active (boolean)