https://github.com/statamic/plugin-dribbble

Statamic Dribbble plugin to fetch and display content from Dribbble's API, including players, shots, and lists.
https://github.com/statamic/plugin-dribbble

Last synced: 3 months ago
JSON representation

Statamic Dribbble plugin to fetch and display content from Dribbble's API, including players, shots, and lists.

• Host: GitHub
• URL: https://github.com/statamic/plugin-dribbble
• Owner: statamic
• Created: 2012-04-23T02:53:12.000Z (about 13 years ago)
• Default Branch: master
• Last Pushed: 2016-04-27T13:55:57.000Z (about 9 years ago)
• Last Synced: 2025-03-22T04:41:26.350Z (3 months ago)
• Language: PHP
• Homepage: http://statamic.com
• Size: 3.91 KB
• Stars: 8
• Watchers: 9
• Forks: 4
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
Statamic Dribbble Plugin ![Statamic v1](https://img.shields.io/badge/statamic-v1-lightgrey.svg?style=flat-square)

================================

The Dribbble plugin is used for fetching and displaying information from Dribbble's API, including players, shots, and lists.

## Installing

1. Download the zip file (or clone via git) and unzip it or clone the repo into `/_add-ons/`.

2. Ensure the folder name is `dribbble` (Github timestamps the download folder).

3. Enjoy.

## Tag Pair: *Player*

**Example Tag:**

    {{ dribbble:players player="jackmcdade" }}

      
{{ name }}

      


      


        
Shots taken: {{ shots_count }}

        
Followers: {{ followers_count }}

        
Following: {{ following_count }}

        
Comments Received: {{ comments_received_count }}

      

      
Member since {{ created_at format="Y-m-d" }}

    {{ /dribbble:players }}

    

### Parameters


#### Player `player`

Username of the player you wish to request.

    player="jackmcdade"

### Variables

The following single variables are available inside the `{{ dribbble:players }}` tag pair. This plugin will always return the full API request assigned as Statamic variables, so the [Dribbble API docs](http://dribbble.com/api#get_player) will always be the most up to date source of information.

- `{{ id }}`

- `{{ name }}`

- `{{ username }}`

- `{{ url }}`

- `{{ avatar_url }}`

- `{{ location }}`

- `{{ twitter_screen_name }}`

- `{{ drafted_by_player_id }}`

- `{{ shots_count }}`

- `{{ draftees_count }}`

- `{{ followers_count }}`

- `{{ following_count }}`

- `{{ comments_count }}`

- `{{ comments_received_count }}`

- `{{ likes_count }}`

- `{{ likes_received_count }}`

- `{{ rebounds_count }}`

- `{{ rebounds_received_count }}`

- `{{ created_at }}`

## Tag Pair: *:Shots*

**Example Tag**

    {{ dribbble:shots player="jackmcdade" }}

    
Shots by {{ player }}{{ name }}{{ /player }}

      {{ shots }}

        


          
{{ title }}

          

          


            
Views: {{ views_count }}

            
Likes: {{ likes_count }}

            
Comments: {{ comments_count }}

            
Dribbbbbbbbbled on {{ created_at format="Y-m-d" }}

          

        

      {{ /shots }}

    {{ /dribbble:shots }}


### Parameters

#### Player `player`

Username of the player you wish to request.

    player="jackmcdade"

#### Limit `limit`

**Default:** 5

Limit the number of shots returned.

### Variables & Variable Pairs

This tag returns a lot of goodness. This plugin will always return the full API request assigned as Statamic variables, so the [Dribbble API docs](http://dribbble.com/api#get_player_shots) will always be the most up to date source of information.

*Note that this is an implementation of the `GET /players:id/shots` endpoint, and not `GET /shots/:id`, as you might assume by looking at the API docs*

#### Variable Pair: *:Player*

{{ player }} {{ /player }}

Same as the [`{{ dribbble:player }}`](#tag-pair-player) tag pair, but inside this particular request.

#### Variable Pair: *:Shots*

    {{ shots }} {{ /shots }}

- {{ id }}

- {{ title }}

- {{ url }}

- {{ short_url }}

- {{ image_url }}

- {{ image_teaser_url }}

- {{ width }}

- {{ height }}

- {{ views_count }}

- {{ likes_count }}

- {{ comments_count }}

- {{ rebounds_count }}

- {{ rebound_source_id }}

- {{ created_at }}

## Tag Pair *List*

This tag is exactly like [`{{ dribbble:shots }}`](#tag-pair-shots), except it lets you fetch from a list (such as *debuts* or *everyone*) instead of a player.

    {{ dribbble:list list="popular" }} {{ /dribbble:list }}

### Parameters

#### List `list`

*Default:* everyone

*Available Options:*

- everyone

- debut

- popular

The Dribbble list you wish you request shots from. 

    player="jackmcdade"

#### Limit `limit`

**Default:** 5

Limit the number of shots returned.

## Tag Pair: *API*

This is a complete freestyle tag pair. Format and request your own endpoint, receive all the data as Statamic variables. You'll want to use the [Dribbble API](http://dribbble.com/api) for this. Just one parameter: `request`.

    {{ dribbble:api request="your/request/here" }} {{ /dribbble:api }}