angular-instafeed
Advanced tools
Comparing version 1.8.0 to 1.8.1
{ | ||
"name": "angular-instafeed", | ||
"version": "1.8.0", | ||
"version": "1.8.1", | ||
"description": "Grid that displays your most recent Instagram photos.", | ||
@@ -5,0 +5,0 @@ "main": "public/js/instafeed.js", |
# Angular Instafeed | ||
## Personal Instagram Angular.js Feed | ||
Made by Joe Carlson - 2016 | ||
Made by Joe Karlsson - 2018 | ||
See more at www.callmejoe.net | ||
See more at www.joekarlsson.com | ||
Basic example usage of factory method to make a request to the instagram api to get a certian amount of images with an Angular.js switchable grid. | ||
Basic example usage of factory method to make a request to the Instagram api to get a certain amount of images with an Angular.js switchable grid. | ||
[Check out a live demo of this plugin here](https://www.callmejoe.net/portfolio/instafeed-angular-js-instagram-feed/) | ||
**Note:** This is a front-end NPM package, so you will need to use build tools in order to get this up and running on your application. Lucky for you, I setup a demo GitHub repository that will get you up and running with Angular Instafeed quickly. | ||
### Update | ||
You can check out my Angular Instafeed build demo here: | ||
This project has been converted into an NPM package [Check it out here.](https://www.npmjs.com/package/angular-instafeed) | ||
[Anngular Instafeed Demo](https://github.com/JoeKarlsson/Angular-Instafeed/tree/npm_example) | ||
[Check out a live demo of this plugin here](https://www.joekarlsson.com/portfolio/instafeed-angular-js-instagram-feed/) | ||
### Reviews | ||
"Oh yes. Absolutely spot on ... works like a charm... The cleanest plugin i've ever worked with - clean, straightforward and works out of box." - tenzopro | ||
@@ -25,14 +26,14 @@ | ||
* In your project directory | ||
* Download and unpack [Angular Instafeed](https://github.com/JoeKarlsson/Angular-Instafeed). Or alternatively checkout from source: | ||
```bash | ||
$ npm i angular-instafeed --save | ||
$ git clone https://github.com/JoeKarlsson/Angular-Instafeed | ||
``` | ||
* In the HTML file you want to add Instafeed, you will need to add a div with the ID "instafeed". | ||
```bash | ||
$ cd angular-instafeed | ||
``` | ||
<div id="instafeed"></div> | ||
``` | ||
* Next, inside the project, you need to [register as a Instagram Developer](https://instagram.com/developer/clients/manage/) to get your Client ID | ||
* You will be creating a Instagram feed using the Instagram API and Angular 1.5. The feed will feature a switchable grid to change the layout of the photos on the page [see Style Guide below for details]. | ||
@@ -42,40 +43,47 @@ | ||
1. First go [register as an Instagram Developer](https://instagram.com/developer/clients/manage/) to get your Client ID. | ||
1. First go [register as an Instagram Developer](https://instagram.com/developer/clients/manage/) to get your Client ID. | ||
1. You will also need to get your user ID go run this program. To get your User ID, go to [this site](http://jelled.com/instagram/lookup-user-id) and enter your Instagram user name to get your user ID. | ||
1. You will also need to get your user ID go run this program. To get your User ID, go to [this site](http://jelled.com/instagram/lookup-user-id) and enter your Instagram user name to get your user ID. | ||
* Note: Your User ID is different than your User Name. Your User ID is a string that looks like `12345678` | ||
* Note: If you do not have an Instagram account, find an account that you enjoy and use their photos for your feed. | ||
* Note: Your User ID is different than your User Name. Your User ID is a string that looks like `12345678` | ||
* Note: If you do not have an Instagram account, find an account that you enjoy and use their photos for your feed. | ||
1. Create an `index.html` with an HTML5 template in a new directory, and fire up `http-server` we will need this in order to get our auth token. | ||
* Start your server, and copy the URL. | ||
* Go to your Manage Clients on the Instagram API settings, click `Manage` on your project, then click on the `Security Tab` and enter your server URL into the Valid Redirect URIs. | ||
1. Create an `index.html` with an HTML5 template in a new directory, and fire up `http-server` we will need this in order to get our auth token. | ||
1. This is the weird step - since we are making a client side web application, we need to get a [pre-approved access-token from Instagram](https://www.instagram.com/developer/authentication/). Here's how you do it: | ||
* Start your server, and copy the URL. | ||
* Go to your Manage Clients on the Instagram API settings, click `Manage` on your project, then click on the `Security Tab` and enter your server URL into the Valid Redirect URIs. | ||
* **Step One:** Direct your user to our authorization URL (Be sure to replace `CLIENT_ID` with your client ID and `REDIRECT_URI` with the url you pasted in the step above) | ||
1. This is the weird step - since we are making a client side web application, we need to get a [pre-approved access-token from Instagram](https://www.instagram.com/developer/authentication/). Here's how you do it: | ||
https://api.instagram.com/oauth/authorize/?client_id=CLIENT_ID&redirect_uri=REDIRECT_URI&response_type=token | ||
* __Step One:__ Direct your user to our authorization URL (Be sure to replace `CLIENT_ID` with your client ID and `REDIRECT_URI` with the url you pasted in the step above) | ||
At this point, we present the user with a login screen and then a confirmation screen where they grant your app’s access to their Instagram data. Note that unlike the explicit flow the response type here is “token”. | ||
```bash | ||
https://api.instagram.com/oauth/authorize/?client_id=CLIENT_ID&redirect_uri=REDIRECT_URI&response_type=token | ||
``` | ||
* **Step Two:** Receive the access_token via the URL fragment | ||
At this point, we present the user with a login screen and then a confirmation screen where they grant your app’s access to their Instagram data. Note that unlike the explicit flow the response type here is “token”. | ||
Once the user has authenticated and then authorized your application, Instagram redirects them to your redirect_uri with the access_token in the url fragment. It will look like this: | ||
* __Step Two:__ Receive the access_token via the URL fragment | ||
http://your-redirect-uri#access_token=ACCESS-TOKEN | ||
Once the user has authenticated and then authorized your application, Instagram redirects them to your redirect_uri with the access_token in the url fragment. It will look like this: | ||
Simply grab the access_token off the URL fragment and you’re good to go. If the user chooses not to authorize your application, you’ll receive the same error response as in the explicit flow | ||
```bash | ||
http://your-redirect-uri#access_token=ACCESS-TOKEN | ||
``` | ||
1. Once you get your **user id** and your **access_token**, try hitting this route to get your most recent Instagram photos (Be sure to replace your `USER_ID` with your user ID and `ACCESS_TOKEN` with the access token you got in the step above). | ||
Simply grab the access_token off the URL fragment and you’re good to go. If the user chooses not to authorize your application, you’ll receive the same error response as in the explicit flow | ||
https://api.instagram.com/v1/users/USER_ID/media/recent/?count=99&&callback=JSON_CALLBACK&access_token=ACCESS_TOKEN | ||
1. Once you get your **user id** and your **access_token**, try hitting this route to get your most recent Instagram photos (Be sure to replace your `USER_ID` with your user ID and `ACCESS_TOKEN` with the access token you got in the step above). | ||
1. Now, you're ready to starting building your Instagram Feed in Angular 2.0 :sparkles: | ||
```bash | ||
https://api.instagram.com/v1/users/USER_ID/media/recent/?count=99&&callback=JSON_CALLBACK&access_token=ACCESS_TOKEN | ||
``` | ||
## Tech | ||
Instafeed uses a number of open source projects: | ||
* [AngularJS] - HTML enhanced for web apps! | ||
1. Now, you're ready to starting building your Instagram Feed in Angular :sparkles: | ||
##Contributing | ||
**Note:** If you are interested in installing this via NPM, I got cha covered. [Check it out here.](https://www.npmjs.com/package/angular-instafeed) | ||
## Contributing | ||
1. Fork it! | ||
@@ -87,2 +95,2 @@ 2. Create your feature branch: ```git checkout -b my-new-feature``` | ||
See more at www.callmejoe.net | ||
See more at [www.joekarlsson.com](https://www.joekarlsson.com) |
94
59519
6