{"id":18226,"date":"2012-05-20T05:37:16","date_gmt":"2012-05-20T05:37:16","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/flickr-eyecandy\/"},"modified":"2016-01-29T19:35:11","modified_gmt":"2016-01-29T19:35:11","slug":"flickr-eyecandy","status":"publish","type":"plugin","link":"https:\/\/pcd.wordpress.org\/plugins\/flickr-eyecandy\/","author":9459026,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"2016.01.29","stable_tag":"2016.01.30","tested":"4.4.34","requires":"3.2","requires_php":"","requires_plugins":"","header_name":"flickr_eyecandy","header_author":"Dino Chiesa","header_description":"","assets_banners_color":"9388d2","last_updated":"2016-01-29 19:35:11","external_support_url":"","external_repository_url":"","donate_link":"http:\/\/dinochiesa.github.io\/FlickrWidgetDonate.html","header_plugin_uri":"http:\/\/wordpress.org\/plugins\/flickr-eyecandy\/","header_author_uri":"https:\/\/www.dinochiesa.net","rating":5,"author_block_rating":0,"active_installs":10,"downloads":6249,"num_ratings":1,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":"1"},"assets_icons":[],"assets_banners":{"banner-772x250.png":{"filename":"banner-772x250.png","revision":"561456","resolution":"772x250","location":"assets"}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["2012.05.19","2012.06.03","2012.06.04","2012.07.19","2014.07.03","2014.07.04","2014.10.09","2014.10.10","2016.01.29","2016.01.30"],"block_files":[],"assets_screenshots":{"screenshot-2.png":{"filename":"screenshot-2.png","revision":"1567239","resolution":"2","location":"plugin"},"screenshot-3.png":{"filename":"screenshot-3.png","revision":"1567239","resolution":"3","location":"plugin"},"screenshot-1.png":{"filename":"screenshot-1.png","revision":"1567239","resolution":"1","location":"plugin"}},"screenshots":{"1":"This shows the rendering of the Widget in the sidebar of a WP blog.","2":"This shows how to Activate the plugin in the Plugins menu in the WP Admin backend","3":"Configuring the settings for the flickr_eyecandy widget in the WP Admin backend."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[1096,215,162,2664],"plugin_category":[43,50],"plugin_contributors":[88946],"plugin_business_model":[],"class_list":["post-18226","plugin","type-plugin","status-publish","hentry","plugin_tags-flickr","plugin_tags-photo","plugin_tags-widget","plugin_tags-yahoo","plugin_category-customization","plugin_category-media","plugin_contributors-dpchiesa","plugin_committers-dpchiesa"],"banners":{"banner":"https:\/\/ps.w.org\/flickr-eyecandy\/assets\/banner-772x250.png?rev=561456","banner_2x":false,"banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/flickr-eyecandy_9388d2.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/flickr-eyecandy\/trunk\/screenshot-1.png?rev=1567239","caption":"This shows the rendering of the Widget in the sidebar of a WP blog."},{"src":"https:\/\/ps.w.org\/flickr-eyecandy\/trunk\/screenshot-2.png?rev=1567239","caption":"This shows how to Activate the plugin in the Plugins menu in the WP Admin backend"},{"src":"https:\/\/ps.w.org\/flickr-eyecandy\/trunk\/screenshot-3.png?rev=1567239","caption":"Configuring the settings for the flickr_eyecandy widget in the WP Admin backend."}],"raw_content":"<!--section=description-->\n<p>flickr_eyecandy is a very simple Wordpress Plugin.<\/p>\n\n<p>It provides a Wordpress Widget that selects and displays one random photo from Flickr\nin the sidebar, each time the page loads. The plugin uses the Flickr API, and authenticates via\nan API key that YOU (the installer) acquire via the Yahoo API Console.<\/p>\n\n<p>It does not present a gallery.  It's just one photo. The photo changes when you reload the page, but it does not change while the page is being displayed.<\/p>\n\n<p>You specify a tag or set of tags to filter the photos.\nFor example, if you specify \"usa,flag\", you will get only photos tagged\nwith \"usa\" and \"flag\".<\/p>\n\n<h3>Dependencies<\/h3>\n\n<ul>\n<li>This plugin depends on and uses the published Flickr REST API.<\/li>\n<li>It also relies on and uses the Curl library within PHP.<\/li>\n<li>It makes outbound http connections from the Wordpress\/PHP server. Most hosters allow this, so it won't be a problem.<\/li>\n<\/ul>\n\n<h3>Thanks<\/h3>\n\n<p>Thanks for your interest!<\/p>\n\n<p>You can make a donation at http:\/\/dinochiesa.github.io\/FlickrWidgetDonate.html<\/p>\n\n<p>Check out all my plugins:\nhttp:\/\/wordpress.org\/extend\/plugins\/search.php?q=dpchiesa<\/p>\n\n<p>-Dino Chiesa<\/p>\n\n<!--section=installation-->\n<ol>\n<li><p>Download flickr-eyecandy-wp-plugin.zip and unzip into the\n  \/wp-content\/plugins\/ directory<\/p><\/li>\n<li><p>From the Wordpress admin backend, Activate the plugin through the\n'Plugins' menu<\/p><\/li>\n<li><p>From the Wordpress admin backend, in the Widgets menu, drag-and-drop\nthe widget to your sidebar.  You can place it in any position you\nlike.<\/p><\/li>\n<li><p>Specify the settings for the widget:\nTitle, API Key, and the tag(s).  For the tags, you can specify :<\/p>\n\n<ul>\n<li><p>a single word, like \"fish\".  This will retrieve a random\nimage tagged with the word \"fish\".<\/p><\/li>\n<li><p>a comma-separated list. This retrieves a photo tagged\nwith all of the terms in the list.<\/p><\/li>\n<li><p>a pipe-separated list of the above. For example, if you specify\n\"fish|leaf|blue,water\", then you will get a photo that is tagged\nwith either \"fish\" or \"leaf\" or \"blue and water\". The plugin randomly\nselects which term to use for a Flickr search, and then randomly\nselects one of the returned photos for display.<\/p><\/li>\n<\/ul><\/li>\n<\/ol>\n\n<p>That's it !<\/p>\n\n<!--section=faq-->\n<dl>\n<dt>Will this plugin cycle through photos, like a slideshow?<\/dt>\n<dd><p>No.  It grabs a list of photos from Flickr, based on search terms you provide, and then selects one of those photos on the rendered page. It does not cycle through photos.<\/p>\n\n<p>If you refresh the page, it will randomly select a photo again. It will probably be a different photo, but not always.<\/p><\/dd>\n<dt>Where do I get an API Key?<\/dt>\n<dd><p>To get an API Key, you need to visit\nhttp:\/\/www.flickr.com\/services\/apps\/create\/apply\/<\/p>\n\n<p>Walk through the steps.\nCopy and paste the API Key to the appropriate place in the Widget\nconfiguration menu.  You don't need the secret.<\/p><\/dd>\n<dt>Why do I need an API Key?<\/dt>\n<dd><p>You need an API key from Yahoo so that the requests that  your wordpress\npage sends to Yahoo, will be tracked and allowed. Every time the\npage loads, it sends out a request to Yahoo, and gets a list of\nphotos.  Yahoo wants to know who's asking for this information, and\nthe API key lets them track that.<\/p><\/dd>\n<dt>Will I be charged by Yahoo for the requests?<\/dt>\n<dd><p>No.  The API key is free to get; I don't speak for Yahoo, but it seems\nto me they use the key only for tracking purposes.<\/p>\n\n<p>Yahoo may throttle the level of requests if you use this plugin on a\nheavily loaded site. In that case you may need to use OAuth2.0, which I\nhave not yet built into the plugin.  But I could be convinced, for the\nright price. ;)<\/p><\/dd>\n<dt>Can I set the visual style of the widget from the admin backend?<\/dt>\n<dd><p>No, I haven't built that capability into this simple plugin, just yet.\nLet me know if you have strong requirements in this area.<\/p><\/dd>\n<dt>Does the plugin use caching?<\/dt>\n<dd><p>Yes, the plugin will cache results for each search term. The responses from Flickr can be 15-20k. The response won't change from one page view to the next, so caching makes sense.<\/p>\n\n<p>The search response cache is keyed on the search term. If your picture term is \"pizza|beer\", there will be two distinct cache files maintained.<\/p>\n\n<p>You can configure the lifetime of items in the cache, via the configuration panels in the wordpress backend.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>2016.01.30<\/h4>\n\n<ul>\n<li>displayed the image from flickr with https if is_ssl() returns true.<\/li>\n<li>updated \"tested up to\" to 4.4.1<\/li>\n<\/ul>\n\n<h4>2014.07.04<\/h4>\n\n<ul>\n<li>no code changes from 2014.07.03<\/li>\n<li>updated \"tested with\" to 3.9.1<\/li>\n<li>updated brief description. <\/li>\n<\/ul>\n\n<h4>2014.07.03<\/h4>\n\n<ul>\n<li>update to use https with flickr's API - this is apparently now required. <\/li>\n<li>tested and works with Wordpress v3.9.1<\/li>\n<\/ul>\n\n<h4>2012.07.18<\/h4>\n\n<ul>\n<li>catch exceptions on unexpected missing attributes on a photo.<\/li>\n<\/ul>\n\n<h4>2012.06.04<\/h4>\n\n<ul>\n<li>clean up some small things in the admin form<\/li>\n<\/ul>\n\n<h4>2012.06.03<\/h4>\n\n<ul>\n<li>implement caching of the search results<\/li>\n<li>a fix for the readme.<\/li>\n<\/ul>\n\n<h4>2012.5.18<\/h4>\n\n<ul>\n<li>initial release<\/li>\n<\/ul>","raw_excerpt":"flickr_eyecandy is a very simple Wordpress Plugin.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/18226","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=18226"}],"author":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/dpchiesa"}],"wp:attachment":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=18226"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=18226"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=18226"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=18226"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=18226"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=18226"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}