Claudio Sanches

<p>This plugin adds Github Gists in your posts via shortcode.</p>
<p><strong>Examples</strong></p>
<p>Add a full gist:</p>
<pre><code>[gist id="3837669"]
</code></pre>
<p>Add a specific file in a gist:</p>
<pre><code>[gist id="3837669" file="index.php"]
</code></pre>
<h3>License</h3>
<p>Gist GitHub Shortcode is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published<br />
by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.</p>
<p>Gist GitHub Shortcode is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of<br />
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.</p>
<p>You should have received a copy of the GNU General Public License along with Gist GitHub Shortcode. If not, see <a href="http://www.gnu.org/licenses/" rel="nofollow ugc">http://www.gnu.org/licenses/</a>.</p>


Gist GitHub Shortcode

Adds Github Gists in your posts via shortcode

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.

Gist GitHub Shortcode vs Hosted Content Importer (HCI)