Michael Cannon

saurabhd

Subharanjan

<p>Flickr Shortcode Importer imports [flickr], [flickrset], [flickr-gallery] shortcode and Flickr-sourced A/IMG tagged media into the Media Library. Furthermore, it transforms the post content [flickr] shortcodes into links containing the Media Library based image of the proper size and alignment.</p>
<p>Import can be run directly from edit page and post screens.</p>
<p>The first [flickr] image found in post content is set as the post’s Featured Image and removed from the post content. The remaining [flickr] shortcodes are then transformed as image links to their attachment page.</p>
<p>[flickrset] and [flickr-gallery] shortcodes are converted to [ gallery] after the Flickr set images have been added to the Media Library. If ‘Set Featured Image’ is checked in Options, then the first image of the [flickrset] is used as such.</p>
<p>Flickr-sourced A/IMG tagged media is converted into [flickr] and then imported as normal. Great for finally bringing into your control all of those media items you’ve been using, but now Flickr is giving you ‘Image is unavailable’ for. A/IMG tag is processed before IMG to prevent unexpected results.</p>
<p>Image attribution links can be added if enabled via Settings.</p>
<p>This plugin is handy for transitioning from plugin <code>wordpress-flickr-manager</code> and <code>flickr-gallery</code> to your own Media Library because you have CDN services or want to move off of third party software.</p>
<p>There is no restore functionality. Backup beforehand or be prepared to revert every transformed post by hand via the post revision tool.</p>
<h4>Primary Features</h4>
<ul>
<li>API</li>
<li>Automatically adds media ids to newly inserted gallery shortcodes</li>
<li>Flickr-sourced A/IMG tagged media imported into WordPress</li>
<li>Media of [flick] shortcodes are imported and converted to locally hosted A/IMG</li>
<li>Media of [flickrset] and [flickr-gallery] shortcodes are imported and converted to [ gallery]</li>
<li>Settings export/import</li>
<li>Settings screen</li>
</ul>
<h4>Handled shortcode & media samples</h4>
<ul>
<li>[flickr size=”small” float=”left”]http://www.flickr.com/photos/dancoulter/2619594365/[/flickr] (image)</li>
<li>[flickr height=”300″ width=”400″]http://www.flickr.com/photos/dancoulter/2422361554/[/flickr] (video)</li>
<li>[flickr id=”5348222727″ thumbnail=”small” overlay=”false” size=”large” group=”” align=”none”]</li>
<li>[flickrset id=”72157631107721746″ thumbnail=”small” photos=”” overlay=”true” size=”large”]</li>
<li>[flickr-gallery mode=”photoset” photoset=”72157626302265777″]</li>
<li>[flickr-gallery mode=”tag” tags=”foo,bar” tag_mode=”all”]</li>
<li>[flickr-gallery mode=”interesting”]</li>
<li>[flickr-gallery mode=”recent”]</li>
<li>[flickr-gallery mode=”search” tags=”barcamp” group_id=”431412@N25″]</li>
<li><code><a class="tt-flickr tt-flickr-Medium" title="Khan Sao Road, Bangkok, Thailand" href="http://www.flickr.com/photos/comprock/4334303694/" target="_blank"><img class="alignnone" src="http://farm3.static.flickr.com/2768/4334303694_37785d0f0d.jpg" alt="Khan Sao Road, Bangkok, Thailand" width="500" height="375" /></a></code></li>
<li><code><img class="alignnone" src="http://farm3.static.flickr.com/2768/4334303694_37785d0f0d.jpg" alt="Khan Sao Road, Bangkok, Thailand" width="500" height="375" /></code></li>
</ul>
<h4>Settings Options</h4>
<p><strong>Import Settings</strong></p>
<ul>
<li>Skip Importing Videos – Importing videos from Flickr often fails. Shortcode is still converted to object/embed linking to Flickr.</li>
<li>Import Flickr-sourced A/IMG tags – Converts Flickr-sourced A/IMG tags to [flickr] and then proceeds with import.</li>
<li>Set Featured Image – Set the first [flickr] or [flickrset] image found as the Featured Image. Will not replace the current Featured Image of a post.</li>
<li>Force Set Featured Image – Set the Featured Image even if one already exists for a post.</li>
<li>Remove First Flickr Shortcode – Removes the first [flickr] from post content. If you use Featured Images as header or lead images, then this might prevent duplicate images in your post.</li>
<li>Make Nice Image Title? – Try to make a nice title if none is set. For Flickr set images, Flickr set title plus a numeric suffix is applied.</li>
<li>Replace Filename with Image Title? – Mainly for SEO purposes. This setting replaces the imported media filename with the media’s title. For non-images, this is always done.</li>
<li>Image Import Size – Size of image to import into media library from Flickr. If requested size doesn’t exist, then original is imported because it’s the closest to the requested import size.</li>
<li>Default Image Alignment – Default alignment of image displayed in post when no alignment is found.</li>
<li>Default Image Size – Default size of image displayed in post when no size is found.</li>
<li>Default A Tag Class – Inserts a class into links around imported images. Useful for lightbox’ing.</li>
<li>Link Image to Attachment Page? – If set, post single view images are linked to attachment pages. Otherwise the image links to its source file.</li>
<li>Image Wrap Class – If set, a span tag is wrapped around the image with the given class. Also wraps attribution if enabled. e.g. Providing <code>flickr-image</code> results in <code>&lt;span class="flickr-image"&gt;|&lt;/span&gt;</code></li>
<li>Set Captions – Uses media title as the caption.</li>
<li>Set Descriptions – Include Flickr descriptions in media information.</li>
<li>Include Flickr Author Attribution? – Appends Flickr username, linked back to Flickr image to the imported Flickr image.</li>
<li>Flickr Author Attribution Text</li>
<li>Flickr Author Attribution Wrap Class – If set, a span tag is wrapped around the attribution with the given class. e.g. Providing <code>flickr-attribution</code> results in <code>&lt;span class="flickr-attribution"&gt;|&lt;/span&gt;</code></li>
<li>Add Flickr Link in Description? – Like <code>Include Flickr Author Attribution</code> but appends the image description.</li>
<li>Flickr Link Text</li>
<li>Add Image License to Description? – Append image license and link to image description.</li>
<li>Flickr Image License Text</li>
</ul>
<p><strong>Posts Selection</strong></p>
<ul>
<li>Posts to Import – A CSV list of post ids to import, like ‘1,2,3’.</li>
<li>Skip Importing Posts – A CSV list of post ids not to import, like ‘1,2,3’.</li>
</ul>
<p><strong>Testing Options</strong></p>
<ul>
<li>Import Limit – Useful for testing import on a limited amount of posts. 0 or blank means unlimited.</li>
<li>Debug Mode – Bypass Ajax controller to handle posts_to_import directly for testing purposes.</li>
</ul>
<p><strong>Post Options</strong></p>
<ul>
<li>Post [flickr] Import Widget? – Minimum role to enable for [flickr] Import wi<br />
dget on posts and page edit screens.</li>
<li>Enable for Pages</li>
<li>Enable for Posts</li>
<li>Enable for Media</li>
<li>Enable for custom post types – if any</li>
</ul>
<p><strong>Flickr API</strong></p>
<ul>
<li>Flickr API Key – <a href="http://www.flickr.com/services/api/" rel="nofollow ugc">Flickr API Documentation</a></li>
<li>Flickr API Secret</li>
<li>Flickr User ID – For Flickr Gallery plugin. Example: 90901451@N00</li>
<li>Images Per Page – For Flickr Gallery plugin.</li>
</ul>
<p><strong>Reset</strong></p>
<ul>
<li>Reimport Flickr Source Images – Needed when changing the Flickr image import size from prior imports.</li>
<li>Export Settings – These are your current settings in a serialized format. Copy the contents to make a backup of your settings.</li>
<li>Import Settings – Paste new serialized settings here to overwrite your current configuration.</li>
<li>Remove Plugin Data on Deletion? – Delete all Flickr Shortcode Importer data and options from database on plugin deletion</li>
<li>Reset to Defaults? – Check this box to reset options to their defaults</li>
</ul>
<h3>Notes</h3>
<ul>
<li>Backup your database before importing. You can use revision to revert individual posts, but doing so in mass is a major PITA.</li>
<li>During my own imports, a post with one [flickr] entry could take a minute. Then posts with many [flickr] entries, several Flickr-source’d A/IMG tags and [flickset] with 30 or so photos took over 10-minutes to import.</li>
<li>During import, it might look like nothing is happening. The progress bar only moves after each import succeeds or fails.</li>
<li>I recommend setting the limit in options to 1 and then testing your installation. That sure makes for easier recovery in case something goes wrong. If something doesn’t work, report it, https://wordpress.org/extend/plugins/flickr-shortcode-importer/.</li>
<li>It’s strongly recommended to deactivate plugins like WordSocial, WP Smush.it and similar to prevent extended import times. You can always enable them and run them enmasse later.</li>
<li>Make sure you have enough disk space. Figure on about 1 GB per 1,000 photos given your using Scissors-continued and have a maximum image size of 1280 x 1024. If your images can be larger, then you’ll probably need 1 GB per 250 photos imported.</li>
<li>Using your own Flickr API Key might be necessary. Test a single import and see the results before setting your own.</li>
</ul>
<h3>API</h3>
<ul>
<li>Read the <a href="https://github.com/michael-cannon/flickr-shortcode-importer/blob/master/API.md" rel="nofollow ugc">Flickr Shortcode Importer API</a>.</li>
</ul>
<h3>Localization</h3>
<p>You can translate this plugin into your own language if it’s not done so already. The localization file <code>flickr-shortcode-importer.pot</code> can be found in the <code>languages</code> folder of this plugin. After translation, please <a href="https://axelerant.com/contact-axelerant/" rel="nofollow ugc">send the localized file</a> for plugin inclusion.</p>
<p><strong><a href="https://nodedesk.zendesk.com/hc/en-us/articles/202294892" rel="nofollow ugc">How do I localize?</a></strong></p>
<h3>Thank You</h3>
<ul>
<li>Thank you for tobylewis for his file_get_contents_curl and custom post types contributions.</li>
<li>A big thank you to Željko Aščić of http://www.touristplayground.com/ for feedback and ideas.</li>
<li>Initial code is modeled after Viper007Bond’s class based Regenerate Thumbnails plugin. The AJAX status and single auto-submission operations were a big help.</li>
<li>[flickr] shortcode handling code copied from Trent Gardner’s very fine Flickr Manager plugin.</li>
<li>Hat’s off to Alison Barret for her Settings API tutorials and class My_Theme_Options.</li>
</ul>
<p>Current development by <a href="https://axelerant.com/about-axelerant/" rel="nofollow ugc">Axelerant</a>.</p>


Flickr Shortcode Importer

Flickr Shortcode Importer imports [flickr], [flickrset], [flickr-gallery] shortcodes and Flickr-sourced media into the Media Library.

Flickr Shortcode Importer vs WP Supersized