This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

Roam Research Block

Maelezo

This block let’s you search and embed Roam Research blocks inside WordPress block editor.
WordPress Block editor and Roam are a match made in heaven!
Detailed description and a video on this blog.

The blocks are embedded

Once you insert a block into your post, it stays connected to the source Roam block.
If you upload a new Roam export, all the blocks will update on your site. For example – if you have a few “evergreen” pages in Roam, you can embed them in WordPress as your “mind garden” and they will stay updated whenever you upload a new copy of your Roam graph.

If you delete a block in Roam and update Roam export in WordPress, the blocks you inserted will use a cached copy created at the time of writing the post for the first time.
So you don’t have to worry about empty pages.

WordPress embed functionality

You can also paste links like https://roamresearch.com/#/app/graph/page/ratars73 into a WordPress post and they will resolve into an embed of the block

Development

All Development and issues in this github repository.

Screenshots

  • Comparison of a block in Roam and the same block embedded in WordPress
  • You upload new version of your Roam graph from block sidebar
  • The block has a search window
  • You can display your content "as a document" or "as a list"

Bloku

Kijalizi hiki kinawezesha bloku 1.

  • Roam Research Block Embed Roam Blocks or pages in WordPress, just as you would in Roam

Installation

  1. Upload the plugin files to the /wp-content/plugins/roam-block directory, or install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress
  3. Now you can use “Roam Block” in your posts in the block editor
  4. The first time you use the block, you will have to upload your Roam Graph to WordPress.
    • Click ( … ) in the right-top corner of Roam
    • Click Export All
    • Choose JSON
    • Unzip the file
    • Insert “Roam Block” into Gutenberg in WordPress
    • Click “Upload” in sidebar
    • Choose the unzipped json
    • Observe magic
  5. Now you can search your Roam graph directly from the “Roam Block” block or paste embed URLs.

FAQ

What is Roam Research?

Roam Research is a tool for networked thought – a note-taking tool that is block-based.
Since blocks are a conceptual unit of both Gutenberg and Roam – I created this plugin.

Do I have to manually upload the roam graph?

Roam does not have an API that could run through WordPress. I have built a project that can keep your Roam graph in WP automatically updated, but it has to run on another machine.
Details how to set it up are here.

How do I upload the graph?

  • Click ( … ) in the right-top corner of Roam
  • Click Export All
  • Choose JSON
  • Unzip the file
  • Insert “Roam Block” into Gutenberg in WordPress
  • Click “Upload” in sidebar
  • Choose the unzipped json
  • Observe magic

Reviews

Hakuna hakiki za programu-jalizi hii.

Wachangiaji & Wasanidi

“Roam Research Block” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Roam Research Block” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

0.1.0

  • Release

0.1.2

  • Fix WordPress version tag

0.1.3

  • Expose update URL to automatically update Roam Graph via https://deliber.at/roam/roam-api/