=== 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.2 !NEW! Use Instapress as image gallery with paging functionality. Highly customizable plugin to display Instagram photos in a sidebar widget, a post or on a page. Display a users media, your own media or the popular media feed. == Description == Display your Instagram photos in a sidebar widget, post or pages or inlcude a single Instagram photo via the Instagram URL in one of your posts. Furthermore create your own Instagram gallery with Instapress' paging functionality. It makes use of jQuery's fancybox plugin to display a nice slideshow for your images. = Features = 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. = After installing I get "Parse error: syntax error, unexpected T_OBJECT_OPERATOR in...", why? = This is mostly because you are running on PHP 4 and Instapress requires PHP 5. Please install/activate PHP 5 or contact your provider. = Everytime I try to connect with my Instagram account I get "Fatal error: Uncaught exception 'Zend_Http_Client_Adapter_Exception' with message 'Unable to Connect to ssl://api.instagram.com:443.", why? = This is because you need to activate OpenSSL on your server to interact with the Instagram API. Please activate OpenSSL or contact your provider. = 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.2 = * Updated language support for french = 1.3.1 = * Fixed bug that caused geocoding issue on plugin activation * Added check for geocoding functionality * Changed check for php version = 1.3 = * Added paging funcionality (Demo here) * 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