If the free JCI-Plugin reaches its limits, the PRO JCI-Plugin might be the next step for you
- support and ongoing development
- handle almost all JSON-feeds / APIs, XML, CSV… data
- mighty twig-template engine
- template-manager: store templates independent of pages
- build applications: select JSON-feed on the fly
- third-party shortcodes work inside the jsoncontentimporter-shortcode
- and a lot more…
In detail: See the matrix below to compare free and PRO-version of the JSON Content Importer.
If you have special requests or neeed a customized version of the plugin: just drop me an email and we’ll figure it out..
Feature / Version |
Free Version free option for many JSON-Feeds and display-challanges |
PRO Version more features, better JSON-handling |
General | ||
Development | further development motivated by donations or bugs | ongoing development |
Template-engines | JCI-Template-engine | Twig-Template-engine |
Debugging | Debug-Mode: use “debugmode=10” in the shortcode | Debug-Mode: use “debugmode=10” in the shortcode |
Programming WordPress | Use many WordPress- and PHP-functions with twig in the JCI-Template – with or without an API-request. Examples:
|
|
Shortcode-Features | ||
Widget | Display JSON-data as widget in the sidebar. | |
Shortcode | jsoncontentimporter | jsoncontentimporterpro (parallel install of free- and PRO-Version is no problem) |
Pass WordPress-Customfields to the JSON-Feed-URL by Shortcode-Parameter”customfieldparam” | “customfieldparam”: see for details here | |
Passing GET-Parameter to JSON-Feed by special Shortcode-Parameter “urlparam”, “pathparam”, “fileext” | “urlparam”: see also here The URL of the JSON-Feed is defined either by the Shortcode-Parameter “url” or by together with the Template at the Plugin-settings. By default the “url” is static and always the same.But sometimes it should be dynamic: When calling the page GET-parameter should be passed into the plugin setting the URL. E.g. a WordPress-page like “http://…displayDomain/example.php?test=5&exa=7” should use a JSON-Feed like “http://…JSONdomain/data.json?test=5&exa=7”. Without “urlparam” you can define the Shortcode like this: [jsoncontentimporterpro url=”http://…JSONdomain/data.json”], there is no way to pass the value of “test” to the JSON-Templateengine. By “urlparam” you can do this. [jsoncontentimporterpro url=”http://…JSONdomain/data.json” urlparam=”test#exa”] will put together the URL of the JSON-Feed out of “url” and the “#” separated parameter.“pathparam”, “fileext” With “pathparam” and “fileext” you can dynamically build the JSON-Feed url. So not only the parameter are flexible with “urlparam” but also the whole url. Where “fileext” ist fixed by the Shortcut-Parameter “pathparam” takes the “#” separated GET-Parameter.You must switch on these Shortcut-paramater in the plugin-options! They’re switched off by default! |
|
Show only some data | oneOfTheseWordsMustBeIn, oneOfTheseWordsMustBeInDepth, oneOfTheseWordsMustNotBeIn, oneOfTheseWordsMustNotBeInDepth |
The “if-else-endif” syntax of twig gives you all options to select JSON-data |
Template-Storage | Template is parameter of the shortcode Template must be placed between [jsoncontentimporter url=..] and [/jsoncontentimporter]. Hence on the the page where it’s parsed. more Free-Shortcode-Parameter |
Shortcode-Parameter nameoftemplate: Besides placing the Template inside jsoncontentimporter you can store Templates in a list. Out of this list you can call the template by it’s id like [jsoncontentimporter nameoftemplate="NAME_OF_TEMPLATE"] which gives the template and optional basenode and a JSON-URL more PRO-Shortcode-Parameter |
Error-Messages | Unchangeable and technical Errormessages |
Custom Errormessage (set via Options) |
Method retrieving JSON-Feed | GET | GET, POST, PUT: CURL-GET and CURL-POST (and sometimes CURL-PUT) are very ofter the best choice. Alternative: You can set the WordPress-GET/POST-functions. These add some data (like User-Agent) to the request. Some APIs need a pure, 100% configurable request. This can be done by rawget or rawpost. |
XML-, CSV-, Text-Feed | If the APIs gives you XML-/CSV- or Text-data and not JSON_ add “inputtype=xml” or “”inputtype=csv” as Shortcode-Parameter. Then the plugin tries to convert XML / CSV into JSON. Switch on full debugging in the plugin options: This will show you what JSON was created out of XML. Use www.jsoneditoronline.org to check the resulting JSON-structure. |
|
Cache of JSON-Feed | ||
Template-Features | ||
Display range of items | The subloop-code is {subloop:KEY:m}: This will display the 1-st to m-th Element. If set to -1 all items will be displayed. same with {subloop-array…} |
The twig-syntax {% for i in team |slice(start,noofitems) %}…{% endfor %} will display “noofitems” Elements, starting from “start”. |
Value: attributes | A JSON-Key/Value is represented by {KEY:ATTRIBUTE} in the template. ONE of the following values are valid for ATTRIBUTE: htmlAndLinefeed2htmlLinefeed, html, urlencode, ifNotEmptyAdd, ifNotEmptyAddRight, ifNotEmptyAddLeft |
The pro-version uses the twig-syntax: {% set a = “test1” %}{% set b = “whatever” ~a %} concats strings “if-else-endif” selects data Formatting of date: see here for dateformat |
Shortcodes inside Template | Other Shortcodes are NOT evaluated. |
Other Shortcodes are executed. So you can use other plugin-Shortcodes together with JSON Content Importer |
{{…}}: Insert values from Shortcode | Insert KEY-name of the JSON-KEY-VALUE pair. Plus: Value of the shortcode-parameter param1 (“{{param1}}”) and param2 (“{{param2}}”) |
|
Parsing JSON | Most of the JSON-feed can be processed. But only modified and filtered in a few ways. |
Some JSON-feeds the free-version can’t handle. The pro-version can handle almost all JSON-feeds. If you buy the pro-version and the JSON you need can’t be handled you’ll get full refund! |
Feature / Version |
Free Version free option for many JSON-Feeds and display-challenges |
PRO Version full control on JSON and wordpress |