<p>GitHub Gist WordPress Plugin allows you to embed <a href="http://gist.github.com" rel="nofollow ugc">GitHub Gist</a> snippets with a [gist] tag, instead of copying and pasting HTML. For example, to embed the <a href="http://gist.github.com/447298.js?file=github_gist_wordpress_plugin_test.txt" rel="nofollow ugc">github_gist_wordpress_plugin_test.txt</a> file from <a href="http://gist.github.com/447298.js" rel="nofollow ugc">gist: 447298</a>, fill in the id and file attributes in the [gist] tag:</p>
<p>[gist id=447298 file=github_gist_wordpress_plugin_test.txt]</p>
<p>or</p>
<p>copy the embedding JavaScript code from GitHub and directly paste it in the body of the [gist] tag:</p>
<p>[gist]<code><script src="http://gist.github.com/447298.js?file=github_gist_wordpress_plugin_test.txt"></script></code>[/gist].</p>
<p>The [gist] tag also expands the content of the embedded Gist and wraps it with “<code><noscript><code><pre></code>” so that search engine spiders, users with javascript disabled and users reading your blog through RSS will still see your code in a blog entry.</p>


GitHub Gist WordPress Plugin

GitHub Gist Wordpress Plugin allows you to embed GitHub Gist snippets with a [gist] tag, instead of copying and pasting HTML.

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.

GitHub Gist WordPress Plugin vs Hosted Content Importer (HCI)