Skip to content

JohnnyTheTank/apiNG-plugin-vimeo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

39 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

apiNG

Join the chat at https://gitter.im/JohnnyTheTank/apiNG npm version Bower version

apiNG-plugin-vimeo

Vimeo API Plugin for apiNG

Information

Documentation

  1. INSTALLATION
    1. Get file
    2. Include file
    3. Add dependency
    4. Add plugin
  2. ACCESS TOKEN
    1. Generate your access_token
    2. Insert your access_token into aping-config.js
  3. USAGE
    1. Models
    2. Requests
    3. Rate limit

1. INSTALLATION

I. Get file

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

II. Include file

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

<!-- when using bower -->
<script src="bower_components/apiNG-plugin-vimeo/dist/aping-plugin-vimeo.min.js"></script>

<!-- when using npm -->
<script src="node_modules/aping-plugin-vimeo/dist/aping-plugin-vimeo.min.js"></script>

<!-- when using cdn file -->
<script src="//cdn.jsdelivr.net/npm/aping-plugin-vimeo@latest/dist/aping-plugin-vimeo.min.js"></script>

<!-- when using downloaded files -->
<script src="aping-plugin-vimeo.min.js"></script>

III. Add dependency

Add the module jtt_aping_vimeo as a dependency to your app module:

angular.module('app', ['jtt_aping', 'jtt_aping_vimeo']);

IV. Add the plugin

Add the plugin's directive aping-vimeo="[]" to your apiNG directive and configure your requests

<aping
    template-url="templates/social.html"
    model="social"
    items="20"
    aping-vimeo="[{'tag':'fcbayern'}, {'category':'sports', 'search':'soccer', items':50}]">
</aping>

2. ACCESS TOKEN

I. Generate your access_token

  1. Login on developer.vimeo.com/apps
  2. Create an new app
  3. Press Authentication
  4. Scroll to Generate a new Access Token
  5. Choose Scopes: only [x] Public and [x] Private
  6. Press Generate Token
  7. Copy generated access_token

II. Insert your access_token into aping-config.js

Create and open js/apiNG/aping-config.js in your application folder. It should be look like this snippet:

angular.module('jtt_aping').config(['$provide', function ($provide) {
    $provide.value("apingDefaultSettings", {
        apingApiKeys : {
            vimeo: [
                {'access_token':'<YOUR_VIMEO_ACCESS_TOKEN>'},
            ],
            //...
        }
    });
}]);

⚠️ Replace <YOUR_VIMEO_ACCESS_TOKEN> with your vimeo access_token

3. USAGE

I. Models

Supported apiNG models

model support max items
per request
(native) default items
per request
social full 50 25
video full 50 25

support:

  • full: the source platform provides a full list with usable results
  • partly: the source platfrom provides just partly usable results

II. Requests

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

Requests by User

parameter sample description optional
user guiltyofficial user name no
search eminem search query yes
items 0-50 items per request yes

Samples:

  • [{'user':'guiltyofficial'}, {'user':'thisisus'}, {'user':'user37039550'}]
  • [{'user':'krismerc', 'search':'slomins', items':10}]

Requests by Tag

parameter sample description optional
tag fcbayern tag name no
search neuer search query yes
items 0-50 items per request yes

Samples:

  • [{'tag':'munich'}, {'tag':'letsplay'}, {'tag':'comedy'}]
  • [{'tag':'comedy', 'search':'prank', items':50}]

Requests by Channel

parameter sample description optional
channel animade channel name no
search CalArts search query yes
items 0-50 items per request yes

Visit the list of vimeo channels

Samples:

  • [{'channel':'musicbed'}, {'channel':'nowness'}, {'channel':'worldhd'}]
  • [{'channel':'worldhd', 'search':'thailand', items':50}]

Requests by Category

parameter sample description optional
category fashion category name no
search highheels search query yes
items 0-50 items per request yes

Visit the list of vimeo categories

Samples:

  • [{'category':'animation'}, {'category':'fashion'}, {'category':'travel'}]
  • [{'category':'sports', 'search':'soccer', items':50}]

III. Rate limit

Visit the official API rate limit documentation

Licence

MIT