[logo]: http://aping.io/logo/320/aping-plugin.png "apiNG Plugin"
![apiNG][logo]


_apiNG-plugin-tumblr_ is a Tumblr API plugin for apiNG.

Information

* Supported apiNG models: social, image, video
* This plugin supports the get-native-data parameter
* This plugin needs an api key :warning:
* Used promise library: angular-tumblr-api-factory _(included in distribution files)_

Documentation

1. INSTALLATION
1. Get file
2. Include file
3. Add dependency
4. Add plugin
2. API KEY
1. Generate your api_key
2. Insert your api_key into aping-config.js
3. USAGE
1. Models
2. Requests

1. INSTALLATION

$3

You can choose your preferred method of installation:

Install via either bower, npm, CDN (jsDelivr) or downloaded files:

* bower install apiNG-plugin-tumblr --save
* npm install aping-plugin-tumblr --save
* use CDN file
* download apiNG-plugin-tumblr.zip

$3

Include aping-plugin-tumblr.min.js in your apiNG application

``html











`

$3


Add the module jtt_aping_tumblr as a dependency to your app module:
`js
angular.module('app', ['jtt_aping', 'jtt_aping_tumblr']);
`

$3

Add the plugin's directive aping-tumblr="[]" to your apiNG directive and configure your requests
`html
template-url="templates/social.html"
model="social"
items="20"
aping-tumblr="[{'page':'camaradakalderra'}]">

`

2. API KEY

$3

_coming soon ..._

$3

Create and open js/apiNG/aping-config.js in your application folder. It should be look like this snippet:
`js
angular.module('jtt_aping').config(['$provide', function ($provide) {
$provide.value("apingDefaultSettings", {
apingApiKeys : {
'tumblr': [
{'api_key':''},
]
//...
}
});
}]);
`

:warning: Replace with your api_key

3. USAGE

$3

Supported apiNG models

| model | content | support | max items
per request | (native) default items
per request |
|----------|---------|---------|--------|---------|
| social | text, links, images, videos, audio | full | 20 | 20 |
| video | videos | full | 20 | 20 |
| image | images | full | 20 | 20 |

support:
* full: _the source platform provides a full list with usable results_
* partly: _the source platfrom provides just partly usable results_




$3

Every apiNG plugin expects an array of requests as html attribute.

#### Requests by Page
| parameter | sample | default | description | optional |
|----------|---------|---------|---------|---------|
| page | camaradakalderra | | The standard or custom blog hostname | no |
| items | 15 | 20 | Items per request (0-20) | yes |
| tag | soccer | | Limits the response to posts with the specified tag | yes |

Sample requests:
* [{'page':'namikamusik'}]
* [{'page':'camaradakalderra', 'tag':'soccer', 'items':14}]`

Licence

MIT