Title: Roam Research Block
Author: Artur Piszek
Published: <strong>5 يناير، 2021</strong>
Last modified: 27 يناير، 2021

---

البحث عن الإضافات

هذه الإضافة **لم يتم تحديثها وتجربتها لأكثر من 3 إصدارات ووردبريس رئيسية**. قد لا
تكون خاضعة للصيانة أو تقدم الدعم والمساعدة بالوقت الحالي وقد تكون بها مشاكل في التوافق
عند إستخدامها مع إصدارات حديثة من ووردبريس.

![](https://ps.w.org/roam-block/assets/icon-256x256.png?rev=2450567)

# Roam Research Block

 بواسطة [Artur Piszek](https://profiles.wordpress.org/artpi/)

[تنزيل](https://downloads.wordpress.org/plugin/roam-block.0.1.3.zip)

 * [تفاصيل](https://ar.wordpress.org/plugins/roam-block/#description)
 * [المراجعات](https://ar.wordpress.org/plugins/roam-block/#reviews)
 *  [التنصيب](https://ar.wordpress.org/plugins/roam-block/#installation)
 * [التطوير](https://ar.wordpress.org/plugins/roam-block/#developers)

 [الدعم](https://wordpress.org/support/plugin/roam-block/)

## الوصف

This block let’s you search and embed [Roam Research](https://roamresearch.com/)
blocks inside WordPress block editor.
 WordPress Block editor and Roam are a match
made in heaven! [Detailed description and a video on this blog.](https://deliber.at/wp-roam-block/)

#### 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.](https://github.com/artpi/wp-roam-block)

## لقطات الشاشة

 * [[
 * 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”

## المكوّنات

تقدّم هذه الإضافة مكوّن واحد (1).

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

## التنصيب

 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.
 5.  * 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
 6. Now you can search your Roam graph directly from the “Roam Block” block or paste
    embed URLs.

## الأسئلة المتكررّة

### 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.](https://deliber.at/roam/wp-roam-block/)

### 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

## المراجعات

لا توجد مراجعات لهذه الإضافة.

## المساهمون والمطوّرون

“Roam Research Block” هو برنامج مفتوح المصدر. وقد ساهم هؤلاء الأشخاص بالأسفل في 
هذه الإضافة.

المساهمون

 *   [ Artur Piszek ](https://profiles.wordpress.org/artpi/)

[ترجمة ”Roam Research Block“ إلى لغتك.](https://translate.wordpress.org/projects/wp-plugins/roam-block)

### مُهتم بالتطوير؟

[تصفّح الشفرة](https://plugins.trac.wordpress.org/browser/roam-block/)، تحقق من 
[مستودع SVN](https://plugins.svn.wordpress.org/roam-block/)، أو الاشتراك في [سجل التطوير](https://plugins.trac.wordpress.org/log/roam-block/)
بواسطة [RSS](https://plugins.trac.wordpress.org/log/roam-block/?limit=100&mode=stop_on_copy&format=rss).

## سجل التغييرات

#### 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/

## ميتا Meta

 *  Version **0.1.3**
 *  Last updated **قبل 5 سنوات**
 *  Active installations **أقل من 10**
 *  WordPress version ** 5.3.1 أو أعلى **
 *  Tested up to **5.3.21**
 *  PHP version ** 7.0.0 أو أعلى **
 *  Language
 * [English (US)](https://wordpress.org/plugins/roam-block/)
 * Tag
 * [block](https://ar.wordpress.org/plugins/tags/block/)
 *  [عرض متقدم](https://ar.wordpress.org/plugins/roam-block/advanced/)

## التقييم

لم يتم تقديم أي مراجعات بعد.

[Your review](https://wordpress.org/support/plugin/roam-block/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/roam-block/reviews/)

## المساهمون

 *   [ Artur Piszek ](https://profiles.wordpress.org/artpi/)

## الدعم

لديك شيء لتقوله؟ بحاجة الى مساعدة؟

 [عرض منتدى الدعم](https://wordpress.org/support/plugin/roam-block/)