Nelio Software

David Aguilera

<p>Get a list of Related Posts by querying your Swiftype account. If Swiftype is<br />
not available, it uses WordPress’ regular search system. By default, the<br />
related post search is performed using one of the available tags, but you can<br />
override it using your own search query string.</p>
<blockquote>
<p><strong>Custom Templates</strong><br />
  Version 2.1.0 let’s you define your own templates for displaying each related<br />
  post. Just create a directory named <code>neliosrp</code> in your theme’s directory and<br />
  create the template you want to use such as, for instance,<br />
  <code>template-name.php</code>. When inserting the widget, specify that the template is<br />
  <code>template-name</code> and you’re ready to go!</p>
<p><strong>Warning</strong> Remember to save your templates somewhere save before updating<br />
  your theme!</p>
<p>(In the directory <code>template-examples</code> you’ll find some examples).</p>
</blockquote>
<p><strong>Note</strong> If you want to use this plugin with your Swiftype account, please keep<br />
in mind you must have the official <a href="https://wordpress.org/plugins/swiftype-search/" rel="ugc">Swiftype<br />
Search</a> plugin installed.</p>
<h4>Features</h4>
<ul>
<li><strong>Swiftype-powered Search</strong> The list of related posts is built using your<br />
Swiftype account.</li>
<li><strong>Regular WordPress Search</strong> You can also use the plugin without a Swiftype<br />
account. Just install the plugin and the regular WordPress search will be used.</li>
<li><strong>Advanced search</strong> Related posts are based on tags. However, you can use<br />
your own search query.</li>
<li><strong>Customization</strong> You can tweak a few details of the related post list, such<br />
as the section title, the number of words in the excerpt, or the number of days<br />
for the cache will be valid.</li>
</ul>
<h4>Featured On</h4>
<ul>
<li><a href="https://www.facebook.com/swiftype/posts/518418398270015" rel="nofollow ugc">Swiftype’s Facebook<br />
Page</a> (Facebook)</li>
<li><a href="http://neliosoftware.com/nelio-related-posts/" rel="nofollow ugc">Our New Plugin–Nelio Related<br />
Posts</a> (Nelio’s blog)</li>
</ul>
<h4>Related Plugins by Nelio</h4>
<ul>
<li><a href="http://nelioabtesting.com/?fp=wordpress.org" rel="nofollow ugc">Nelio A/B Testing</a> |<br />
<a href="https://wordpress.org/plugins/nelio-ab-testing/" rel="ugc">Download</a></li>
<li>Nelio External Featured Image |<br />
<a href="https://wordpress.org/plugins/external-featured-image/" rel="ugc">Download</a></li>
<li>Nelio Featured Posts |<br />
<a href="https://wordpress.org/plugins/nelio-featured-posts/" rel="ugc">Download</a></li>
</ul>
<p><em>Featured image by <a href="https://www.flickr.com/photos/tomtolkien/4821397096" rel="nofollow ugc">Thomas<br />
Tolkien</a></em></p>


Nelio Related Posts

Get a list of Related Posts by querying your Swiftype account, or using WordPress' regular search functions.

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.

Nelio Related Posts vs Hosted Content Importer (HCI)