Title: Niki API Client Author: fundamentallmedia Published: Mas 18, 2019 Last modified: Mas 18, 2019 --- Search plugins This plugin **hasn’t been tested with the latest 3 major releases of WordPress**. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress. ![](https://s.w.org/plugins/geopattern-icon/lnp-api-client.svg) # Niki API Client By [fundamentallmedia](https://profiles.wordpress.org/fundamentallmedia/) [Download](https://downloads.wordpress.org/plugin/lnp-api-client.0.3.1.zip) * [Details](https://hat.wordpress.org/plugins/lnp-api-client/#description) * [Reviews](https://hat.wordpress.org/plugins/lnp-api-client/#reviews) * [Installation](https://hat.wordpress.org/plugins/lnp-api-client/#installation) * [Development](https://hat.wordpress.org/plugins/lnp-api-client/#developers) [Support](https://wordpress.org/support/plugin/lnp-api-client/) ## Description The Niki API Client is a WordPress implementation of the Niki.nl REST API. It yields the following functionality: * authorisation: using username and password, acquire an oauth (version 1.0) token to access the Niki API * project selection: in a list of all projects in your account, select the relevant project(s) to use in the website * resource implementations: Implementation of all resources of the [Niki REST API](https://api.niki.nl/apidocs) except for the ‘search’ resources. #### Example implementation In the plugin directory, a folder named ‘examples’ is included. This folder contains 3 items: # /classes: example view classes for housetypes, housetype-listings, and interest forms # /theme: contains an example wordpress-theme, this theme can be installed (copied) in your theme folder # niki-functions.php: file providing methods for displaying various Niki data Of course, these are example implementations, not ment for direct production use. They will point you in the right direction while implementing your own Niki-data filled website. ## Installation #### From your WordPress dashboard 1. Visit ‘Plugins > Add New’ 2. Search for ‘Niki API client’ 3. Activate the plugin through the ‘Plugins’ menu in WordPress 4. Under `Niki server`, enter `Niki OAuth URL` : `https://auth.niki.nl` 5. Under `Niki server`, enter `Niki API URL` : `https://api.niki.nl` 6. Press `Wijzigingen opslaan` 7. Click `Vraag Niki API Token aan` and follow instructions. 8. When the token is retrieved, under `Niki projecten` check the relevant projects and click `Wijzigingen opslaan` 9. You are now ready to use the Niki data in your WordPress site. #### From WordPress.org 1. Download Niki API client 2. Upload the plugin folder to the `/wp-content/plugins/` directory using your favorite method (ftp, sftp, scp, etc…) 3. Activate the plugin through the ‘Plugins’ menu in WordPress 4. Under `Niki server`, enter `Niki OAuth URL` : `https://auth.niki.nl` 5. Under `Niki server`, enter `Niki API URL` : `https://api.niki.nl` 6. Press `Wijzigingen opslaan` 7. Click `Vraag Niki API Token aan` and follow instructions. 8. When the token is retrieved, under `Niki projecten` check the relevant projects and click `Wijzigingen opslaan` 9. You are now ready to use the Niki data in your WordPress site. #### Installing the example theme 1. Using FTP, copy the folder /examples/theme/niki-template to your themes folder 2. Go to your admin dashboard http://www.yoursite.nl/wp-admin 3. Go to settings->permalinks, activate the “Post name” option and then save the changes 4. Under display->theme’s, click ‘activate’ on item ‘Niki Template’ 5. Now go visit your site http://www.yoursite.nl/niki/aanbod and http://www.yoursite. nl/niki/interesse ## FAQ How do I show information of a specific housetype in my site? Include the `niki-functions.php` in your page template and call the specific housetype information by specifying project id and housetype id like so: ``` get_plugin_path() . "examples/niki-functions.php"; niki_show_woningtype('TBIGEN_79DBBC06-518B-4591-882E-EE63359CCBA8','TBIGEN_4D14999B-87DB-4874-ACB9-B3CBD87B2936'); ?> ``` In this example, the first parameter is the Niki project id, and the second parameter is the Niki housetype id. How do I list the housetypes in my selected projects? Include the `niki-functions.php` in your page template and call the listing example function like so: ``` get_plugin_path() . "examples/niki-functions.php"; niki_show_aanbod(); ?> ``` This will generate a listing of all housetypes in the projects selected in the admin configuration. How do i render a default interest form? Include the `niki-functions.php` in your page template (if you dit not do already so), and show the form: ``` get_plugin_path() . "examples/niki-functions.php"; niki_show_interesse(); ?> ``` How do I make a generic Niki API request Given any Niki API resource, you can access the Niki API by the following code: ``` get_niki_resource($resource, array()); // empty parameter array, not needed here // display the contents of $myProject var_dump($myProject); ?> ``` ## Reviews There are no reviews for this plugin. ## Contributors & Developers “Niki API Client” is open source software. The following people have contributed to this plugin. Contributors * [ fundamentallmedia ](https://profiles.wordpress.org/fundamentallmedia/) [Translate “Niki API Client” into your language.](https://translate.wordpress.org/projects/wp-plugins/lnp-api-client) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/lnp-api-client/), check out the [SVN repository](https://plugins.svn.wordpress.org/lnp-api-client/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/lnp-api-client/) by [RSS](https://plugins.trac.wordpress.org/log/lnp-api-client/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 0.3.1 Bugfix to make example template work with the rewrite rules #### 0.3 Name change of API to Het Nieuwbouw Platform API client #### 0.2.4 Fixed a missing error message after changes were made in the Oauth module of auth. niki.nl #### 0.2.3 Added Jurgen to contributors #### 0.2.2 Added extra div to detailpage for additional styling options. #### 0.2.1 Always initialize niki object in contructor for global accessing of plugin. #### 0.1 Initial Release ## Meta * Version **0.3.1** * Last updated **7 years ago** * Active installations **Fewer than 10** * WordPress version ** 3.0.1 or higher ** * Tested up to **4.9.29** * Language * [English (US)](https://wordpress.org/plugins/lnp-api-client/) * Tags * [api](https://hat.wordpress.org/plugins/tags/api/)[Client](https://hat.wordpress.org/plugins/tags/client/) [niki rest api](https://hat.wordpress.org/plugins/tags/niki-rest-api/) * [Advanced View](https://hat.wordpress.org/plugins/lnp-api-client/advanced/) ## Ratings No reviews have been submitted yet. [Add my review](https://wordpress.org/support/plugin/lnp-api-client/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/lnp-api-client/reviews/) ## Contributors * [ fundamentallmedia ](https://profiles.wordpress.org/fundamentallmedia/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/lnp-api-client/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](http://fundament.nl/)