=== Cortext ===
Contributors: priethor, mcsf
Tags: knowledge-base, collections, custom-post-types, block-editor, publishing
Requires at least: 7.0
Tested up to: 7.0
Requires PHP: 8.1
Stable tag: 0.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Build a WordPress-native knowledge base with pages, typed collections, views, and public publishing.

== Description ==

Cortext is a beta knowledge base workspace for WordPress. It gives you documents, typed collections, multiple views, relation fields, rollups, and public pages without moving your data out of WordPress.

**Important:** Cortext is still in beta. We recommend trying it somewhere low-stakes first. Some workflows may change during the beta.

= What you can try =

* Write nested documents in the WordPress block editor.
* Create typed collections and switch between table, grid, and list views.
* Connect entries with relation fields and rollups.
* Embed collection views in documents.
* Publish Cortext pages with your active WordPress theme.

Behind the scenes, Cortext stores documents, collection definitions, fields, and collection rows as WordPress posts and post meta. You can still inspect the raw data with normal WordPress tools.

== Installation ==

Install Cortext from the WordPress plugin directory:

1. In wp-admin, go to Plugins, then Add New.
2. Search for "Cortext".
3. Install and activate Cortext, then open "Cortext" from the admin menu.
4. Try the workspace with sample content first.

It is beta software, so install it somewhere you can experiment first.

Developers who want sample data can run `wp cortext seed` with WP-CLI.

== Frequently Asked Questions ==

= Is Cortext production ready? =

Not yet. Cortext is ready to try, but still early. Use it somewhere low-stakes before relying on it for important content.

= Does Cortext connect to external services? =

Only when you ask it to. Everyday use stays inside WordPress with no external calls. The one exception is the optional Notion import; the External services section below covers what it sends and when.

= Where is the source for the built JavaScript and CSS? =

Source code and build tooling live at https://github.com/Automattic/cortext. The JavaScript and CSS shipped in the plugin package are built from that repository.

= What happens to my content if I deactivate Cortext? =

Your content stays in WordPress as posts and post meta. Deactivating Cortext, or deleting the plugin, does not remove it, and you can still see and export it with the normal WordPress tools.

= How do I report a bug or send feedback? =

Cortext is in beta and feedback helps. Open an issue at https://github.com/Automattic/cortext/issues. For a security problem, follow the security policy in that repository instead.

== External services ==

Cortext runs inside your WordPress install. The only external service it can reach is the optional Notion import.

The import reads content from a Notion workspace into Cortext. It runs only when you start an import and supply a Notion integration token; nothing leaves your site otherwise. When you run it, Cortext sends that token and the IDs of the collections you picked to the Notion API at api.notion.com, which returns the content to store in WordPress.

Notion's Terms of Service (https://www.notion.so/28ffdd083dc3473e9c2da6ec011b58ac) and Privacy Policy (https://www.notion.com/trust/privacy-policy) cover that traffic.

== Screenshots ==

1. The Cortext workspace showing a seeded Library page with a catalog table and detail panel.

== Changelog ==

= 0.1.1 =
Patch release for the 0.1 beta line. In this release:

* Added richer demo content entry points for empty workspaces.
* Fixed row reordering so the first drag works in scrolled collections.
* Fixed canvas flicker when opening or leaving row documents.
* Moved the Cortext admin menu below the core WordPress items.
* Improved release packaging and automation for distributed builds.

= 0.1.0 =
First public beta. In this release you can:

* Write nested documents in the WordPress block editor.
* Create typed collections and switch between table, grid, and list views.
* Edit rows inline, and connect entries with relation fields and rollups.
* Embed collection views inside documents.
* Publish Cortext pages with your active WordPress theme.
