Sefaria Text Insert

A WordPress plugin for inserting text from the Sefaria database into the post editor.

Note: This plugin is a work-in-progress. Though we don't think it does anything that could mess-up your site, please know that you're installing it at your own risk.

##Installation

1. Download the repository as a ZIP file, or clone it to your desktop using git.
2. Web Install: From your site's WordPress dashboard, select "Add New" under the Plugins menu item. Click the "Upload Plugin" button, and upload the plugin's ZIP file.
   FTP Install: Extract the ZIP file and upload it via FTP to your site's Plugins directory (/wp-content/plugins/).
3. Once installed, click "Activate" to activate the plugin.

##Usage

1. To use the plugin, select any post, page, or custom post type to edit. (Or create a new one.) On the edit screen, you'll have a button labeled "Add Text", right next to the add media button.
   
   

2. Click the button to open the dialogue box. In the field, type/paste a text reference (see below), and then click "Add Source."
   
   
   

###About References In order to designate which text you'd like the plugin to "fetch", you'll need to provide a text reference, which in most cases the book, chapter, and verse. For example, the text reference Genesis 22:7 will yield:

וַיֹּ֨אמֶר יִצְחָ֜ק אֶל־אַבְרָהָ֤ם אָבִיו֙ וַיֹּ֣אמֶר אָבִ֔י וַיֹּ֖אמֶר הִנֶּ֣נִּֽי בְנִ֑י וַיֹּ֗אמֶר הִנֵּ֤ה הָאֵשׁ֙ וְהָ֣עֵצִ֔ים וְאַיֵּ֥ה הַשֶּׂ֖ה לְעֹלָֽה׃ Then Isaac said to his father Abraham, “Father!” And he answered, “Yes, my son.” And he said, “Here are the firestone and the wood; but where is the sheep for the burnt offering?”Genesis 22:7

Alternatively, the reference Genesis 22 will return the entire 22nd chapter of Genesis, and Genesis will return the book of Genesis in its entirety.

In general, a single verse is the smallest unit of information you can reference. However, since the text fetched by the plugin is simply inserted into your editor (rather than being embedded), you can shorten it to meet your own needs.

Sefaria's text referencing system is one of its most robust features. Though they're the primary means of communication with Sefaria's repository database, text references are intended to be "human readable," and should flexibly accommodate human variation, such as alternate spellings. For example, the following are all valid references:

• Genesis 22:7
• Gen 22:7
• Bereishit 22.7

Documentation on text references in Sefaria can be found on Sefaria's GitHub wiki.