Alpine PhotoTile for Flickr

Please Note: This plugin is no longer being developed or maintained. If you are a WordPress developer, I encourage you to take this plugin and make it your own. The Alpine PhotoTile for Flickr is capable of retrieving photos from a particular user, a group, a set, or the Flickr community. The photos can be linked to the your Flickr page, a specific URL, or to a Fancybox slideshow. Also, the Shortcode Generator makes it easy to insert the widget into posts without learning any of the code. This lightweight but powerful widget takes advantage of WordPress's built in JQuery scripts to create a sleek presentation that I hope you will like. A full description and demonstration is available at the Alpine Press. Features:

• Display images in a sidebar, post, or page
• Multiple styles to allow for customization
• Lighbox feature for interactive slideshow (Fancybox, prettyBox, or ColorBox)
• Simple instructions
• Widget & shortcode options
• Feed caching/storage for improved page loading

Quick Start Guide:

1. After installing the Alpine PhotoTile for Flickr plugin on your WordPress site, make sure it is activated by logging into your admin area and going to Plugins in the left menu.
2. To add the plugin to a sidebar, go to Appearance->Widgets in the left menu.
3. Find the rectangle labeled Alpine PhotoTile for Flickr. Click and drag the rectangle to one of the sidebar containers on the right.
4. Once you drop the rectangle in a sidebar area, it should open to reveal a menu of options. The only required information for the plugin to work is Flickr User ID. See "How do I find my Flickr user ID or group ID?" in the FAQ section for further guidance about finding your ID. Enter this ID and click save in the right bottom corner of the menu.
5. If you want to add the Flickr plugin to a post or page, you will need to use a Shortcode. A Shortcode is a line of text that tells WordPress to load a plugin inside a post along with what settings to use. The Alpine PhotoTile comes with an interactive Shortcode Generator to make this as easy as possible. To find the Shortcode Generator, click on Settings in the left menu of your admin area. Under Settings, click on AlpineTile. Lastly, click on the tab labeled Shortcode Generator and follow the instructions there.
6. It is recommended that you read through the additional options on the plugin's settings page. To find the settings page, click on Settings in the left menu of your admin area. Under Settings, click on AlpineTile. Lastly, click on the tab labeled Plugin Settings. It is very challenging to create a plugin that does not interfere with other plugins or themes. Many common issues can be resolved by changing the Lightbox option, preventing the plugin from loading Lightbox files, or loading Styles and Scripts in the Header.
7. (Optional: To enable all the plugin's features, add an API Key). To find the API Key page, click on Settings in the left menu of your admin area. Under Settings, click on AlpineTile. Lastly, click on the tab labeled Add API Key. The page will explain what an API Key is and how to get one.
8. Play around with the various styles and options to find what works best for your site.

Flickr Plugin Installation

1. Go to the Plugins->Add New section of the Admin Panel.
2. Either search for "Alpine PhotoTile for Flickr" or upload the alpine-photo-tile-for-flickr folder using the upload tool.
3. Go to the Plugins->Installed Plugins and activate the "Alpine PhotoTile for Flickr" plugin.

Add a Flickr API Key

1. Make sure you are logged into Flickr.com and then visit http://www.flickr.com/services/apps/create/.
2. Under "Get your API Key", click the "Request an API Key" link.
3. Next, click the button that says "APPLY FOR A NON-COMMERCIAL KEY". Even if your website is commercial, the Alpine Flickr plugin is non-commercial.
4. A form will appear. Fill in the form with your information. Check the two boxes and finish by clicking "Submit".
5. Copy and paste the Key into the form on the plugin's "Add API Key" page. Click "Save API Key" and you are all done.

Using the Flickr Widget

1. Use the widget like any other widget. Go to Appearance->Widgets in the left menu. Find the rectangle labeled "Alpine PhotoTile for Flickr". Click and drag the rectangle to one of the sidebar containers on the right.
2. Customize Alpine PhotoTile for Flickr plugin based on your preference.

Using the Flickr Shortcode

1. A shortcode is a line of texted used for loading plugins within WordPress pages or posts. Rather than explaining how to setup the shortcode, I have added a tool to the Alpine PhotoTile for plugin that generates the shortcode for you. Visit the "Shortcode Generator" on the Flickr plugin's settings page (Settings->AlpineTile: Flickr->Shortcode Generator).

1.0.0

• First Release

1.0.1

• Added caching functions

1.0.2

• Fixed AJAX menu plugin loading problem

1.0.3

• Rebuilt photo retrieval method using API
• Changed "per row" and "image number" options
• Added int high and low to sanitization function
• Repaired photo linking issue with rift and bookshelf styles
• Added height option to gallery style
• Renamed functions where needed
• Custom display link (and removed display link option from Community source option)
• Added "wall" style

1.0.3.1

• Added function and class check before call

1.1.1

• Cache filter for .info and .cache (V2)
• Load styles and scripts to widget.php only
• Added options page and shortcode generator
• Added highlight, highlight color option, cache option, and cache time
• Made option callbacks plugin specific (not global names)
• Edited style layouts
• Fixed url generation for set links
• Enqueue JS and CSS on pages containing widget or shortcode only

1.2.0

• Rebuilt plugin structure into OBJECT
• Combined all Alpine Photo Tiles scripts and styles into identical files
• Improved IE 7 compatibility
• Added custom image link options
• Added Fancybox jQuery option
• Fixed galleryHeight bug
• Implemented Flickr fetch with wp_remote_get()

1.2.1

• Rebuilt admin div structure
• Fixed admin css issues

1.2.2

• Added 800px photo size
• Added aspect ratio options for gallery style
• Added key generator function
• Added get_image_url() functions
• Object oriented id, options, results, and output storage
• Object oriented display generation

1.2.3

• Added FancyboxForAlpine (Fancybox Safemode)
• Added choice between Fancybox, prettyBox, and ColorBox
• Added hidden options, including custom rel for lightbox

1.2.3.1

• Fixed cache retrieval

1.2.4

• Added "Add API Key" page and API Key option
• Restructured plugin objects and reassinged functions
• Object oriented message, hidden, etc.
• Added option to disable right-clicking on images
• Added updateGlobalOptions and removed individual option calls
• Added donate button
• Fixed lightbox param option

1.2.5

• Added fallback to dynamic style and script loading using jQuery
• Various small fixes
• Moved cache location
• Updated ColorBox plugin
• Set Object params to private and implemeted set, check, and get function
• Implemeted do_alpine_method call
• Created active options and results functions
• Improved dynamic script loading

1.2.6

• Fixed jQuery bug (Removed all <> tags from inline scripts)
• Add stripslashes text sanitization
• Changed lightbox parameters option from CSS to stripslashes sanitization

1.2.6.1

• Check compatibility with WP 3.8
• Small CSS changes (Padding and hover white background)

1.2.6.2

• Replaced deprecated jQuery APIs ( .load() and .browser )
• Updated prettyPhoto and colorbox

1.2.6.4

• jQuery backwards compatibility ( .bind() function for jQuery v1.6.3 and less )

1.2.6.6

• Change http: to https:

1.2.6.7

• Load files before APTFFbyTAP_widget_register()

1.2.6.8

• Pretty Photo Update

1.2.7.9

• Fixed Admin Tabs

1.2.7.10

• End of development notice

TODO

• Change to FancyBox 2
• Add caption to display
• Rebuild jQuery display
• "Anded" Tag option
• Check with Contact Form 7
• Look into showing private photos