{"id":134355,"date":"2021-01-05T12:44:04","date_gmt":"2021-01-05T12:44:04","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/roam-block\/"},"modified":"2021-01-27T13:25:35","modified_gmt":"2021-01-27T13:25:35","slug":"roam-block","status":"publish","type":"plugin","link":"https:\/\/et.wordpress.org\/plugins\/roam-block\/","author":9273612,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"0.1.3","stable_tag":"0.1.3","tested":"5.3.21","requires":"5.3.1","requires_php":"7.0.0","requires_plugins":"","header_name":"Roam Block","header_author":"Artur Piszek (artpi)","header_description":"Embed Roam Blocks or pages in WordPress, just as you would in Roam","assets_banners_color":"","last_updated":"2021-01-27 13:25:35","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/deliber.at\/wp-roam-block\/","header_author_uri":"https:\/\/piszek.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":1078,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"0.1.1":{"tag":"0.1.1","author":"artpi","date":"2021-01-05 12:43:35"},"0.1.2":{"tag":"0.1.2","author":"artpi","date":"2021-01-05 13:59:16"},"0.1.3":{"tag":"0.1.3","author":"artpi","date":"2021-01-27 13:25:35"}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":2450567,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":2450567,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":[],"assets_blueprints":{},"all_blocks":{"artpi\/roam-block":{"apiVersion":2,"name":"artpi\/roam-block","title":"Roam Research Block","category":"embed","icon":"sos","description":"Embed Roam Blocks or pages in WordPress, just as you would in Roam","textdomain":"roam-block","supports":{"html":true},"editorScript":"file:.\/build\/index.js","editorStyle":"file:.\/build\/index.css","style":"file:.\/build\/style-index.css"}},"tagged_versions":["0.1.1","0.1.2","0.1.3"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":2450567,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":2450567,"resolution":"2","location":"assets","locale":""},"screenshot-3.png":{"filename":"screenshot-3.png","revision":2450567,"resolution":"3","location":"assets","locale":""},"screenshot-4.png":{"filename":"screenshot-4.png","revision":2450567,"resolution":"4","location":"assets","locale":""}},"screenshots":{"1":"Comparison of a block in Roam and the same block embedded in WordPress","2":"You upload new version of your Roam graph from block sidebar","3":"The block has a search window","4":"You can display your content \"as a document\" or \"as a list\""},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[1220],"plugin_category":[],"plugin_contributors":[194535],"plugin_business_model":[],"class_list":["post-134355","plugin","type-plugin","status-publish","hentry","plugin_tags-block","plugin_contributors-artpi","plugin_committers-artpi"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/roam-block\/assets\/icon-128x128.png?rev=2450567","icon_2x":"https:\/\/ps.w.org\/roam-block\/assets\/icon-256x256.png?rev=2450567","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/roam-block\/assets\/screenshot-1.png?rev=2450567","caption":"Comparison of a block in Roam and the same block embedded in WordPress"},{"src":"https:\/\/ps.w.org\/roam-block\/assets\/screenshot-2.png?rev=2450567","caption":"You upload new version of your Roam graph from block sidebar"},{"src":"https:\/\/ps.w.org\/roam-block\/assets\/screenshot-3.png?rev=2450567","caption":"The block has a search window"},{"src":"https:\/\/ps.w.org\/roam-block\/assets\/screenshot-4.png?rev=2450567","caption":"You can display your content \"as a document\" or \"as a list\""}],"raw_content":"<!--section=description-->\n<p>This block let's you search and embed <a href=\"https:\/\/roamresearch.com\/\">Roam Research<\/a> blocks inside WordPress block editor.\nWordPress Block editor and Roam are a match made in heaven!\n<a href=\"https:\/\/deliber.at\/wp-roam-block\/\">Detailed description and a video on this blog.<\/a><\/p>\n\n<h4>The blocks are embedded<\/h4>\n\n<p>Once you insert a block into your post, it stays connected to the source <strong>Roam block<\/strong>.\nIf 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.<\/p>\n\n<p>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.\nSo you don't have to worry about empty pages.<\/p>\n\n<h4>WordPress embed functionality<\/h4>\n\n<p>You can also paste links like <code>https:\/\/roamresearch.com\/#\/app\/graph\/page\/ratars73<\/code> into a WordPress post and they will resolve into an embed of the block<\/p>\n\n<h3>Development<\/h3>\n\n<p><a href=\"https:\/\/github.com\/artpi\/wp-roam-block\">All Development and issues in this github repository.<\/a><\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin files to the <code>\/wp-content\/plugins\/roam-block<\/code> directory, or install the plugin through the WordPress plugins screen directly.<\/li>\n<li>Activate the plugin through the 'Plugins' screen in WordPress<\/li>\n<li>Now you can use \"Roam Block\" in your posts in the block editor<\/li>\n<li>The first time you use the block, you will have to upload your Roam Graph to WordPress.\n\n<ul>\n<li>Click ( ... ) in the right-top corner of Roam<\/li>\n<li>Click Export All<\/li>\n<li>Choose <code>JSON<\/code><\/li>\n<li>Unzip the file<\/li>\n<li>Insert \"Roam Block\" into Gutenberg in WordPress<\/li>\n<li>Click \"Upload\" in sidebar<\/li>\n<li>Choose the unzipped json<\/li>\n<li>Observe magic<\/li>\n<\/ul><\/li>\n<li>Now you can search your Roam graph directly from the \"Roam Block\" block or paste embed URLs.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id='what%20is%20roam%20research%3F'><h3>What is Roam Research?<\/h3><\/dt>\n<dd><p>Roam Research is a tool for networked thought - a note-taking tool that is block-based.\nSince blocks are a conceptual unit of both Gutenberg and Roam - I created this plugin.<\/p><\/dd>\n<dt id='do%20i%20have%20to%20manually%20upload%20the%20roam%20graph%3F'><h3>Do I have to manually upload the roam graph?<\/h3><\/dt>\n<dd><p>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.\n<a href=\"https:\/\/deliber.at\/roam\/wp-roam-block\/\">Details how to set it up are here.<\/a><\/p><\/dd>\n<dt id='how%20do%20i%20upload%20the%20graph%3F'><h3>How do I upload the graph?<\/h3><\/dt>\n<dd><ul>\n<li>Click ( ... ) in the right-top corner of Roam<\/li>\n<li>Click Export All<\/li>\n<li>Choose <code>JSON<\/code><\/li>\n<li>Unzip the file<\/li>\n<li>Insert \"Roam Block\" into Gutenberg in WordPress<\/li>\n<li>Click \"Upload\" in sidebar<\/li>\n<li>Choose the unzipped json<\/li>\n<li>Observe magic<\/li>\n<\/ul><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>0.1.0<\/h4>\n\n<ul>\n<li>Release<\/li>\n<\/ul>\n\n<h4>0.1.2<\/h4>\n\n<ul>\n<li>Fix WordPress version tag<\/li>\n<\/ul>\n\n<h4>0.1.3<\/h4>\n\n<ul>\n<li>Expose update URL to automatically update Roam Graph via https:\/\/deliber.at\/roam\/roam-api\/<\/li>\n<\/ul>","raw_excerpt":"Embed Roam Blocks in WordPress, just as you would in Roam Research.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/et.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/134355","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/et.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/et.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/et.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=134355"}],"author":[{"embeddable":true,"href":"https:\/\/et.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/artpi"}],"wp:attachment":[{"href":"https:\/\/et.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=134355"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/et.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=134355"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/et.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=134355"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/et.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=134355"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/et.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=134355"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/et.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=134355"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}