=== 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 here = 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. #### 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 screenshots section). = 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 t.krammer [at] liechtenecker.at
Download the latest POT-File here For a german description of the plugin visit our blog at http://liechtenecker.at/instapress-das-instagram-plugin-fur-wordpress/ Instapress is based on Mauricio Cuenca's PHP SDK == 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