Andy Fragen

Colin Stewart

<p>Use an Embed block and enter the URL for the Gist or the URL for a specific file within the Gist. If using the Classic Editor, place the URL on a line by itself. Not as a link.</p>
<p>Support for <code>wp_oembed_get()</code>.</p>
<p>No shortcodes.</p>


oEmbed Gists and Files

Bimal Poudel

<p>It imports third party hosted contents within WordPress blog. You can define from which url/resource to fetch the content. The original source may be editable by anyone else whom you trust. Thus, it logically empowers you to allow other users to externally edit a particular section of your blogs. And, you do not have to give them any access credentials of your website.</p>
<p>After installation, use shortcode tag <code>[third]</code> with few parameters as:</p>
<pre><code>[third source="markdown" id="https://goo.gl/UpclKH" section=""]
</code></pre>
<ul>
<li><code>source</code> is a content processor type.</li>
<li><code>id</code> is a URL or ID given by the third parties.</li>
<li><code>section</code> is an optional parameter to access deeper content.</li>
<li><code>cache</code> is a boolean directive whether to reuse the cached content.</li>
</ul>
<p>It will then embed remote markdown content inside your blog.<br />
Additionally, it will convert the text into HTML using <a href="https://github.com/erusev/parsedown" rel="nofollow ugc">Parsedown</a>.</p>
<h4>Parameters</h4>
<p><strong>source</strong>: Where to seek the data (eg. Content Hosting Server). Examples:</p>
<ul>
<li><strong>analytics</strong>: ✔ implemented (Google Analytics)</li>
<li><strong>file</strong>: ✔ implemented (Read from local file)</li>
<li><strong>gist</strong>: ✔ implemented (Embed Gist Snippets)</li>
<li><strong>jotform</strong>: ✔ implemented (Embed Web Forms)</li>
<li><strong>markdown</strong>: ✔ implemented (Parse remote markdown files)</li>
<li><strong>qr</strong>: ✔ implemented
<ol>
<li>For Custom Data,</li>
<li>For current page’s URL</li>
</ol>
</li>
<li><strong>youtube</strong>: ✔ implemented (Embeds a YouTube Video)</li>
<li><strong>database</strong>: Partially implemented, and left for developers</li>
<li><strong>url</strong>, <strong>api</strong>: Work in progress</li>
<li><strong>wikipedia</strong>: Work in progress, Strategy: Content JSON to Data Section</li>
</ul>
<p>The list is not limited, you expand it. <a href="https://goo.gl/89KgSC" rel="nofollow ugc">Join/Fork Development</a></p>
<p><strong>id</strong>: Content ID (unique identifier) of the data you want. Often:</p>
<ul>
<li>Full URLs</li>
<li>Database IDs</li>
<li>Resource IDs provided by Service Providers eg. YouTube Video ID, JotForm Form ID, …</li>
<li>Full Path of a Local File</li>
</ul>
<p><strong>section</strong>: Additional parameter to identify the specific section of the content.</p>
<h4>Example: Parsing a remote .md file</h4>
<pre><code>[third source="markdown" id="https://goo.gl/UpclKH" section=""]
</code></pre>
<p>Learn to write your <a href="http://parsedown.org/demo" rel="nofollow ugc">.md file</a>.</p>
<h4>Example: Embedding a gist code from GitHub</h4>
<pre><code>[third source="gist" id="000000000000" section="filename.php"]
</code></pre>
<p>Create <a href="https://gist.github.com/" rel="nofollow ugc">your gists at GitHub</a>.</p>
<h4>Example: Embedding a JotForm</h4>
<pre><code>[third source="jotform" id="000000000000" section=""]
</code></pre>
<p>Create your own web form at <a href="https://jotform.com/" rel="nofollow ugc">JotForm website</a>.</p>
<h4>Example: Reading a server’s local file</h4>
<pre><code>[third source="file" id="/tmp/readme.txt" section=""]
</code></pre>
<p>It has to be a static file for security reasons. For example, if you read the .php file, it will NOT process it, rather read its contents only. Your can contain valid HTML data, css and javascripts.</p>
<h4>Example: Accessing database – Expand it yourself</h4>
<pre><code>[third source="database" id="0" section="recent"]
</code></pre>
<p>Detailed implementations are left for the developers because of the nature. It is a <strong>proof of concept</strong> work. Please feel free to modify/expand it.</p>
<h4>Example: Custom QR Code</h4>
<pre><code>[third source="qr" id="YOUR DATA" section=""]
</code></pre>
<h4>Example: QR Code for Current Page (Full URL)</h4>
<pre><code>[third source="qr" id="url" section="internal"]
</code></pre>
<p>The above example is a full code. If you embed it anywhere, it lets your users copy that page’s URL into their mobile.</p>
<h4>Example: Embedding a YouTube Video</h4>
<pre><code>[third source="youtube" id="v00000000000" section=""]
</code></pre>
<p>Choose your video from <a href="https://www.youtube.com/" rel="nofollow ugc">YouTube</a>.</p>
<h4>Personalized Content Processors</h4>
<p>You may often consider writing your own Content Processor.<br />
Refer to Custom Content Processor section in <code>[Other Notes]</code> tab.</p>
<h3>Custom Content Processors</h3>
<p>If you want to develop your own Content Processor, it is much easier now.<br />
Just create a tiny class file inside <strong>classes/processors</strong> as like one of the existing one. Simple examples are YouTube, JotForm and Gist processors.</p>
<h4>Minimum requirements</h4>
<ol>
<li>File name: <code>class.processor_YOURNAME.inc.php</code></li>
<li>Method: <code>public function fetch($form_id = null, $section = null)</code>.
<ul>
<li>Process your content.</li>
<li>Return HTML string.</li>
<li>For references, see <code>class.processor_none.inc.php</code></li>
</ul>
</li>
<li>Use as: <code>[third source="YOURNAME" section=""]</code></li>
</ol>
<p>Click for <a href="https://github.com/anytizer/hosted-content-importer/tree/master/hosted-content-importer/classes/processors" rel="nofollow ugc">real examples</a>.</p>
<p>Just that much easy drop-in replacement.</p>
<h3>Banner Image</h3>
<p>Used from <a href="https://unsplash.com" rel="nofollow ugc">unsplash.com</a></p>
<ul>
<li><a href="https://unsplash.com/photos/ea9Zg7HkFXQ" rel="nofollow ugc">Cable Cars and Rope</a>: Represents contents coming from various sources.</li>
</ul>


Hosted Content Importer (HCI)

Embeds a remotely hosted content. Contributors can edit a tiny piece of your blog text externally, without having ANY access to your website.

oEmbed Gists and Files vs Hosted Content Importer (HCI)