=== Instapress ===
Contributors: tkrammer, liechtenecker
Donate link: 
Tags: widgets, photos, instagram, shortcode, images, instapress, sidebar, liechtenecker
Requires at least: 3.0
Tested up to: 3.1
Stable tag: 1.0

Highly customizable plugin that displays a feed of pictures uploaded via Instagram. Display a users media, your own media or the popular media feed.

== Description ==
= Features =
This highly customizable plugin offers the possibility to embed feeds from Instagram into your WordPress Blog.

It makes use of jQuery's fancybox plugin to display a nice slideshow for your images.

You can choose:

* how many Instagram images you want to display
* the size of the Instagram images
* whether you want to show the Instagram picture's title or not
* whether to use fancybox or not
* whether you want to display your own Instagram feed, a friend's Instagram feed, the popular media feed or a single image from Instagram

= Demo =
You can find a demonstration of the plugin <a href="http://work-liechtenecker.at/fb/instagram/wp/" target="_blank">here</a>

= Usage =
#### Shortcode ####
You can implement an instagram feed in posts or pages via shortcode in the following format: [instapress userid="" piccount="" size=""]

* **userid**: ID or username of instagram user (leave blank for popular media, use "self" for your own media or "myfeed" to display your feed)
* **piccount**: Number of instagrams to display (Default: 9) - Currenty limited to 20 images (will be more in a future release)
* **size**: Size of instagrams in pixels (Default: 85) 
* **effect**: Name of the effect to use for the slideshow (Currently only 'fancybox' possible) - Since 0.4.3
* **url**: If this value is set, Instapress ignores the value for **userid and piccount** and displays a single Instagram (no authorization required!) - Since 1.0

#### Template ####
To use Instapress in one of your templates, simply work with do_shortcode() using the instapress shortcode.
e.g. <?php echo do_shortcode('[instapress piccount="12"]'); ?>

#### Widget #### 
Add Widget called "Instagram" to your sidebar (wp-admin > Design > Widgets) and configure it:

* **Title**: Widget-Title (use CSS to hide it)
* **Picture size**: Size of pictures in pixels
* **Username**: Username of user whose media to display
* **Address/Coordinates**: Address of e.g. your bar, shop,... or coordinates in the format latitude,longitude (If this value is set, the user's feed will be ignored)
* **Pics**: How many pics will be displayed? - Currenty limited to 20 images (will be more in a future release)
* **Effect**: Fancybox uses jQuery Fancybox to display image gallery, otherwise the pictures link to their instagr.am page
* **Show title**: Shows the title of the image in Fancybox slideshow
* **Image container**: Individual HTML-Container for the Instagram image takes 2 Parameter at the moment (*%index%* = Index of image starting with 1, *%image%* = the instagram image)

#### Editor ####
Click on the Instapress icon in TinyMCE an use the form that pops up to insert images or feeds (see <a href="screenshots">screenshots section</a>).


= Language support =
This plugin is currently available in the following languages:
* German
* English

If you've created your own language pack please let me know at <a href="mailto:t.krammer@liechtenecker.at">t.krammer [at] liechtenecker.at</a><br />
Download the latest POT-File <a href="http://plugins.svn.wordpress.org/instapress/trunk/languages/instapress.pot">here</a>

For a german description of the plugin visit our blog at <a href="http://liechtenecker.at/instapress-das-instagram-plugin-fur-wordpress/" target="_blank">http://liechtenecker.at/instapress-das-instagram-plugin-fur-wordpress/</a>

Instapress is based on <a href="http://www.mauriciocuenca.com/blog/2011/02/instagram-api-implementation-in-php/" target="_blank">Mauricio Cuenca's PHP SDK</a>

== Screenshots ==
1. Authorization via username and password, no application needed (simply enter your login data) - Since 1.0
2. Instapress Widget Settings
3. Instapress Widget Demo
4. Instapress Fancybox
5. Instapress Shortcode Usage
6. Dialog for adding an Instagram to a post (does not need authorization!)
7. An Instagram added via rich editor (just like any other image)
8. Add an Instagram feed via rich editor (generates shortcode)

== Installation ==

1. Download the plugin and unzip it to your /wp-content/plugins/ folder.
1. Activate the plugin through the 'Plugins' menu in WordPress.
1. Follow the steps in Settings->Instapress to authorize your widget for the API.
1. Add the widget to your sidebar from Appearance->Widgets and configure the widget options.

== Frequently Asked Questions ==
= Do I need an account on Instagram? =
Yes, you need an account on Instagram to register an application.
 
= Why do I have to register an Instagram application? =
You have to register an application to work with the official Instagram API.

= Why do I have to authorize the application? =
Instapress works with the official Instagram API which requires authorization via oAuth.

== Changelog ==

= 1.0 =
##### New features #####
* Added **cache functionality** for image titles
* High **performance** improvements
* Embed single images **via Instagram URI** without authorization
* Authentication via **xAuth**, hence no need for a developer account and an application anymore. Just authenticate using **username and password**!!
* Images from widget and shortcode are no longer combined in one fancybox gallery
* Embed single Instagrams via rich-editor (TinyMCE)
* Embed Instagram feed via rich-editor (TinyMCE)
* Improved styling options (added css classes) for shortcode version
##### Bug fixes #####
* Image titles in widget showed widget title
* Widget content was drawn outside widget container
* Clearfix by default for widget
##### Note #####
* !Instapress currently has a limited of 20 images to display, that limit will be increased in our next release!

= 0.6.3 =
* Improved language support (German)

= 0.6.2 =
* Performance improvements

= 0.6.1 =
* Added cache functionality to prevent exceeds of request limit

= 0.5.1 =
* Fixed problem with geocoder

= 0.5 =
* It is now possible to show a location based feed

= 0.4.4 =
* Improved layout for images bigger than 150px
* Added default stylesheet for widget and shortcode

= 0.4.3 =
* Fancybox-Effect in shortcode is now possible

= 0.4.2 =
* Fixed bug for own media via "self" in shortcode

= 0.4.1 =
* Added language support for german

= 0.4 =
* First official release
* Provides user's feed, friend's feed and popular media feed


== Upgrade Notice ==

= 1.0 =
* Authentication via **xAuth**, hence **no need** for a developer account and an application anymore. Just authenticate using **username and password**!!

= 0.6.1 =
* Important Update: Fixes problems with API request limit and adds cache

= 0.4.2 =
* Fixed bug for own media via "self" in shortcode

= 0.4.1 =
* Added language support for german

= 0.4 =
* Initial upload to WordPress plugin directory