Atte Liimatainen

<p>WordPress plugin that helps to serve content through REST routes and gives<br />
customizability to developers through filters.</p>
<h3>Available Routes</h3>
<ul>
<li><code>/wp-json/arha/v1/post</code></li>
<li><code>/wp-json/arha/v1/page</code></li>
<li><code>/wp-json/arha/v1/options</code></li>
<li><code>/wp-json/arha/v1/archive</code></li>
</ul>
<h3>Example queries</h3>
<ul>
<li><code>/wp-json/arha/v1/post?post_type=POST_TYPE&slug=SLUG</code></li>
<li><code>/wp-json/arha/v1/page?path=PATH</code></li>
<li><code>/wp-json/arha/v1/options</code></li>
<li><code>/wp-json/arha/v1/archive?post_type=POST_TYPE&posts_per_page=POSTS_PER_PAGE&paged=PAGED&orderby=ORDERBY&order=ORDER</code></li>
</ul>
<h3>tax_query and meta_query in archive-route</h3>
<ul>
<li><code>tax_query</code> and <code>meta_query</code> are supported and they work how the query is built for it in <code>new WP_Query()</code></li>
<li>both needs their values to bes passed in as stringified json</li>
</ul>
<h3>Multiple post_types in archive-route</h3>
<ul>
<li>To pass multiple post_types in archive-route, use syntax that lets PHP read GET-param as an array. https://stackoverflow.com/a/9547490</li>
</ul>
<h3>Filters</h3>
<ul>
<li>
<p>To exclude querying specific post types from <code>post</code>– and <code>archive</code>-routes, you<br />
can use following filters:</p>
<p>`<br />
add_filter(‘arha_routes/archive_excluded_post_types’, ‘exclude_post_types’);<br />
add_filter(‘arha_routes/post_excluded_post_types’, ‘exclude_post_types’);</p>
</li>
</ul>
<p>function exclude_post_types($excluded_post_types) {<br />
  $excluded_post_types = [‘post’];<br />
  return $excluded_post_types;<br />
}<br />
    `</p>
<ul>
<li>To format <code>post</code>-route’s post before it’s served to client, use <code>arha_routes/format_post</code>-filter<br />
`<br />
add_filter(‘arha_routes/format_post’, ‘format_post’);</li>
</ul>
<p>function format_post($post) {<br />
  return $post;<br />
}<br />
    `</p>
<ul>
<li>To format <code>page</code>-route’s post before it’s served to client, use <code>arha_routes/format_page</code>-filter<br />
`<br />
add_filter(‘arha_routes/format_page’, ‘format_page’);</li>
</ul>
<p>function format_page($page) {<br />
  return $page;<br />
}<br />
    `</p>
<ul>
<li>
<p>To format <code>archive</code>-route’s posts before they are served to client, use <code>arha_routes/format_archive_post</code>-filter</p>
<p><code>add_filter('arha_routes/format_archive_post', 'format_archive_post');<br />
function format_archive_post($post) {<br />
return $post;<br />
}</code></p>
</li>
<li>
<p><code>options</code>-route returns empty result by default. To add content to it, use <code>arha_routes/format_options</code>-filter<br />
`<br />
add_filter(‘arha_routes/format_options’, ‘format_options’);</p>
</li>
</ul>
<p>function format_options($options) {<br />
  return $options;<br />
}<br />
    `</p>
<ul>
<li>
<p>By default Arha Routes returns only published content with post-, page- and archive-route, this can be modified by adding following filters.<br />
`<br />
// for archive route<br />
add_filter(‘arha_routes/allowed_post_statuses_archive’, ‘allowed_post_statuses’);<br />
// for post route<br />
add_filter(‘arha_routes/allowed_post_statuses_post’, ‘allowed_post_statuses’);<br />
// for page route<br />
add_filter(‘arha_routes/allowed_post_statuses_page’, ‘allowed_post_statuses’);<br />
function allowed_post_statuses($post_statuses) {<br />
// … change post_statuses array</p>
<p>return $post_statuses;<br />
}<br />
`<br />
After adding setting up these filters, request can include “post_status” parameter and it will be compared to $post_statuses array.</p>
</li>
</ul>
<h3>SearchWP</h3>
<p>Arha Routes supports SearchWP-plugin, which lets WP users to make keyword search engine for their content.</p>
<p>Activating SearchWP-plugin adds optional keyword-search functionality to <code>archive</code>-route. This is done by adding <code>s=KEYWORD</code> to the route<br />
– Example: <code>/wp-json/arha/v1/archive?post_type=products&posts_per_page=10&paged=1&orderby=date&order=ASC&s=monitor</code></p>
<h3>Polylang</h3>
<p>Arha Routes supports Polylang-plugin, which allows users to create content in multiple languages.</p>
<p>Activating Polylang changes how endpoints work:</p>
<ul>
<li>All routes require additional <code>lang</code>-param
<ul>
<li>Example: <code>/wp-json/arha/v1/archive?post_type=products&posts_per_page=10&paged=1&orderby=date&order=ASC&lang=en</code></li>
</ul>
</li>
<li><code>page</code>-route doesn’t support language prefix in path
<ul>
<li>Example: Permalink <code>/zh/info</code>, use like this <code>/wp-json/arha/v1/page?path=/info&lang=zh</code></li>
<li>Example: Permalink <code>/en/info/test</code>, use like this <code>/wp-json/arha/v1/page?path=/info/test&lang=zh</code></li>
</ul>
</li>
<li><code>options</code>-route passes <code>lang</code>-param forward to <code>arha_routes/format_options</code>-filter<br />
<code>add_filter('arha_routes/format_options', 'format_options', 10, 2);<br />
function format_options($options, $lang) {<br />
return $options;<br />
}</code></li>
</ul>
<h3>Polylang + SearchWP</h3>
<p>In order to make these two plugins work together, you need to add extra plugin to WP installation.</p>
<p>https://searchwp.com/extensions/polylang-integration/</p>


Arha Routes

Wordpress plugin that helps to serve content through REST routes and gives customizability to developers through filters.

berkux

<p>The simplest method to link WordPress with external APIs</p>
<p>JCI simplifies the task of retrieving data from a third-party REST API. The returned JSON-, XML, CSV, TXT-data can be neatly arranged and showcased on your WordPress site via a shortcode, a JCI Block or PHP. The plugin can generate a template for the data display.</p>
<p>20 seconds: Load API and display data</p>
<p><span class="embed-youtube" style="text-align:center; display: block;"><iframe loading="lazy" class="youtube-player" width="750" height="422" src="https://www.youtube.com/embed/RBlrAUVywAk?version=3&rel=1&showsearch=0&showinfo=1&iv_load_policy=1&fs=1&hl=en-US&autohide=2&wmode=transparent" allowfullscreen="true" style="border:0;" sandbox="allow-scripts allow-same-origin allow-popups allow-presentation allow-popups-to-escape-sandbox"></iframe></span></p>
<p>7 minutes: Basic intro to JCI free</p>
<p><span class="embed-youtube" style="text-align:center; display: block;"><iframe loading="lazy" class="youtube-player" width="750" height="422" src="https://www.youtube.com/embed/SDUj1teNG2s?version=3&rel=1&showsearch=0&showinfo=1&iv_load_policy=1&fs=1&hl=en-US&autohide=2&wmode=transparent" allowfullscreen="true" style="border:0;" sandbox="allow-scripts allow-same-origin allow-popups allow-presentation allow-popups-to-escape-sandbox"></iframe></span></p>
<h3>Examples, Preview</h3>
<p>Check out the live demonstration to explore how we’re interfacing with various APIs<br />
<a href="https://api.json-content-importer.com/free-jci-plugin-example/wetter/" rel="nofollow ugc">LIVE PREVIEW – WordPress and a external API</a></p>
<p><a href="https://www.youtube.com/watch?v=GJGBPvaKZsk" rel="nofollow ugc">Video: How to use the Wikipedia API</a></p>
<h3>Main Plugin Features</h3>
<ul>
<li>Low code usage: Save time and avoid coding using an API</li>
<li>Insert an API-URL into Step 1: Data is loaded, and and displayed. Save it as API-Access-Set.</li>
<li>Use the API-Access-Set in Step 2 to create a Shortcode</li>
<li>Optional for maximum flexibility: Use the API-Access-Set n PHP code</li>
<li>Insert an API-URL into the JCI Block: Data is loaded, and a template can be generated to display the data.</li>
<li>Easy to start: Check Installation – Is your WordPress ready for JCI? Most probably!</li>
<li>Basic Settings: Check SSL, Cacher, Gutenberg and Authentication</li>
<li>ContactForm7 Integration: Populate CF7 forms with JSON data and forward CF7-submitted data to an API.</li>
<li>Use the JCI cacher to avoid many API requests</li>
<li>JCI-Block :  Use the simple JCI Block interface to get data! Query the API and check the response. Then utilize the simple template generator inside the JCI Block to use the data!</li>
<li>Contact Form 7 Integration: Fill form and submit to API</li>
</ul>
<h3>Important Note Starting with Version 2.0.11</h3>
<p>Starting with version 2.0.11, any HTML code present in the shortcode or block is filtered to prevent dangerous code (e.g. JavaScript) from being output.<br />
However, if you want to allow certain tags or attributes as a deliberate choice:<br />
In the plugin’s “Basic Settings” there is a field called “Allow additional HTML tags (advanced)”.<br />
There you can enter comma-separated tags that should not be filtered out. For example, “iframe,script” would preserve these two tags in the HTML output.<br />
“tr#onclick” would preserve the “onclick” attribute in ”, which would otherwise be removed.</p>
<h3>Documentation</h3>
<p>There’s a wealth of resources and support at your fingertips. Explore the articles listed below to begin your journey:</p>
<ul>
<li><a href="https://doc.json-content-importer.com/" rel="nofollow ugc">JCI Manual</a></li>
<li><a href="https://doc.json-content-importer.com/json-content-importer/step-1-data-access/" rel="nofollow ugc">Step 1: Access the Data</a></li>
<li><a href="https://doc.json-content-importer.com/json-content-importer/step-2-data-usage/" rel="nofollow ugc">Step 2: Using the Data</a></li>
<li><a href="https://doc.json-content-importer.com/json-content-importer/shortcode-basic-structure/" rel="nofollow ugc">Shortcode – Basic structure</a></li>
<li><a href="https://doc.json-content-importer.com/json-content-importer/pro-contactform7/" rel="nofollow ugc">Contact Form 7 Integration</a></li>
<li><a href="https://doc.json-content-importer.com/json-content-importer/free-overview-videos/" rel="nofollow ugc">Free JCI Plugin: Overview Videos</a></li>
<li><a href="https://doc.json-content-importer.com/json-content-importer/basic-start/" rel="nofollow ugc">Free JCI Plugin: Getting Started</a></li>
</ul>
<h3>You need more?</h3>
<h4>JSON Content Importer PRO</h4>
<p>Both the free and PRO JCI Plugins serve the same purpose: retrieving data, transforming it, and publishing the results.<br />
However, while the free Plugin can only handle basic challenges, the PRO JCI Plugin offers nearly full control over WordPress, the database, and applications.<br />
<a href="https://json-content-importer.com/compare/" rel="nofollow ugc">Compare: Free vs. JCI PRO Plugin</a></p>
<p>PRO features:<br />
* application building by creating a searchform and connect it to a JSON-API in the background: pass GET-Variables to use a dynamic JSON-Feed-URL (“talk to API / webservice”)<br />
* much better and more flexible templateengine: twig<br />
* create and use Custom Post Types<br />
* store Templates independent of pages<br />
* more Shortcode-Parameters<br />
* executing Shortcodes inside a template<br />
* more features…</p>


Get Use APIs – JSON Content Importer


All I wanted to do is display the latest version number of my own plugin on my site.  I could have spent hours coding it myself, instead I spent 5 minutes installing and working out this plugin.  Great work Bernhard


Easy Peasy


learning curve is very steep with the plugin but it simply works and i fell in love with it! i use it for everything: fetching flight prices, weather data, syncing wordpress blocks / content across different sites / domain through wp rest api to name a few!


such a clever plugin

Connects an API to WordPress: Get API-data (JSON, XML, CSV...), show it with a Shortcode, a JCI Block or PHP. Generate a template with the JCI Block

Arha Routes vs Get Use APIs – JSON Content Importer