=== Instapress === Contributors: tkrammer, liechtenecker Donate link: Tags: widgets, photos, instagram, shortcode, images, instapress, sidebar, gallery Requires at least: 3.0 Tested up to: 3.2 Stable tag: 1.3 !NEW! Use Instapress as image gallery with paging functionality. 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 * to enable paging * whether you want to show your Instagram feed as an image gallery = 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) - Note: It is highly recommended to enable caching for more than 20 pictures * **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 * **title**: If this value is set to 1 and an **effect** was set, Instapress will show the Instagram's title - Since 1.0.1 * **paging**: If this value is set to 1, your pictures will be displayed as an image gallery. The value for **piccount** defines the number of pictures per page. #### 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? - Note: It is highly recommended to enable caching for more than 20 pictures * **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 and 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 * French (Thanks to: Olivier MONTBAZET http://www.lantredekag.fr) 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. Enter username and password in the Instapress settings. 1. Add the widget to your sidebar from Appearance->Widgets and configure the widget options, use TinyMCE or insert the shortcode into your articles/pages 1. Tell your friends about Instapress on Facebook == Frequently Asked Questions == = Do I need an account on Instagram? = You only need an Instagram account to embed feeds but not to embed a single Instagram. = Is there a way to style Instapress? = Yes, there are several ways to style Instapress: ##### Widget ##### **Professionals only:** Each Instagram in the widget is surrounded by a container you can define yourself, by default the container looks like that:
%image%
You can customize the container by using %image% as placeholder for the HTML image and %index% as placeholder for the position of the image starting with 1. If you do not want to change the container you can simply use the following CSS selectors: * **.instagram-image**: Class of the div container around the image ==> Use **.instagram-image img** to style the image * **#instagram-image-INDEX**: ID of the div containing the image with the given index (e.g. #instagram-image-3 to style the third image's container) ##### Shortcode/Rich editor ##### * Instagram feeds embedded via shortcode are placed in a div having the class **instapress-shortcode** * To define different styles for odd/even images use the classes **odd** and **even** (e.g. .instapress-shortcode-image.odd) = Does Instapress require other plugins? = No, Instapress doesn't require other plugins, all effects provided by Instapress are included in the plugin. = Does Instapress run on PHP 4? = No, Instapress requires at least PHP 5 to work properly. = Fancybox does not work properly since I installed Instapress, what now? = Try disabling all effects for Instapress in the admin section (yourblog/wp-admin/options-general.php?page=instagram.php) If you've got any issues with this plugin please post it to the worpdress development forum, we'll answer your question as soon as possible! == Changelog == = 1.3 = * Added paging funcionality * Performance improvements * Added option to add a Facebook-Like-Button to single Instagrams * Checks for the correct PHP version and cURL extension = 1.2 = * Fixed bug with PHP short codes (caused problems since PHP 5.3) * Fixed bug causing simplexml_load_file Error * Option to disable automatic integration of javascript effect plugins * Option for random order in widget = 1.1.1 = * Improved german language support * Added PayPal button in backend = 1.1 = * No upper limit for piccount anymore - It is now possible to display as many Instagrams as you want! = 1.0.3 = * Language Support French (Thanks to: Olivier MONTBAZET http://www.lantredekag.fr) = 1.0.2 = * Performance improvements when title-option is enabled = 1.0.1 = * Added possibility to show titles in shortcode version = 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 = 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