{"id":7781,"date":"2010-01-09T14:01:44","date_gmt":"2010-01-09T14:01:44","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/twitter-image-host\/"},"modified":"2011-08-07T19:11:32","modified_gmt":"2011-08-07T19:11:32","slug":"twitter-image-host","status":"publish","type":"plugin","link":"https:\/\/tah.wordpress.org\/plugins\/twitter-image-host\/","author":1144815,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"0.6.1","stable_tag":"0.6.1","tested":"3.2.1","requires":"3.0","requires_php":"","requires_plugins":"","header_name":"Twitter Image Host","header_author":"Michael Tyson","header_description":"","assets_banners_color":"","last_updated":"2011-08-07 19:11:32","external_support_url":"","external_repository_url":"","donate_link":"http:\/\/atastypixel.com\/blog\/wordpress\/plugins\/twitter-image-host","header_plugin_uri":"http:\/\/atastypixel.com\/blog\/wordpress\/plugins\/twitter-image-host","header_author_uri":"http:\/\/atastypixel.com\/blog","rating":0,"author_block_rating":0,"active_installs":10,"downloads":5855,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":{"0.6.1":"

Introduces Twitter account to author mapping. Re-login to Twitter to take effect.<\/p>","0.6":"

At last, a fix for authentication. Tweeting from the web interface works again. If you're using the plugin with\nTwitter for iOS, you'll need to reconfigure your Twitter client with the new API endpoint displayed on the plugin's\nsettings page.<\/p>","0.5.7":"

Twitter for iPhone 3.0.1 has a bug that prevents it from sending username and password. This update supports a workaround; see "Posting Images" in the readme for details.<\/p>","0.5.6":"

This release fixes a bug that causes a 'not found' error when appending any parameters to the URL, or a trailing slash<\/p>","0.5.4":"

This release fixes a bug that prevented filtering based on author from working<\/p>","0.5.3":"

This release prevents duplicate uploads - if a duplicate is detected, just returns the URL to the original image<\/p>","0.5":"

This is a major release that introduces a widget and shortcode to display entries<\/p>","0.4.4":"

This update fixes the HTML image submission form for WP installations within a sub-directory<\/p>","0.4.3":"

If you are getting 'missing argument' warnings, install this update.<\/p>","0.4.2":"

This update fixes a bug that stopped Tweetie 2 for iPhone working with this plugin.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":0},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.1","0.2","0.3","0.4","0.4.1","0.4.2","0.4.3","0.4.4","0.5","0.5.1","0.5.2","0.5.3","0.5.4","0.5.5","0.5.6","0.5.7","0.6","0.6.1","0.6.2"],"block_files":[],"assets_screenshots":[],"screenshots":[],"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[1456,163,159],"plugin_category":[50,56],"plugin_contributors":[],"plugin_business_model":[],"class_list":["post-7781","plugin","type-plugin","status-publish","hentry","plugin_tags-hosting","plugin_tags-images","plugin_tags-twitter","plugin_category-media","plugin_category-social-and-sharing","plugin_committers-michaeltyson"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/twitter-image-host.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"\n

Keep your traffic in the family! Host Twitter images on your own site, with support for comments and trackbacks, image\nresizing and thumbnailing with Lightbox.<\/p>\n\n

Twitter doesn\u2019t yet come with its own inline image support, so we tend to be limited to using image hosting services, \nand linking to them with short URLs. So, services like Twitpic host the image, and we direct traffic to them in return.<\/p>\n\n

Better to take advantage of that traffic, and host images on your own site. This way, viewers come to your site, instead\nof someone else's!<\/p>\n\n

Posted images are displayed in your normal WordPress template, with support for comments and trackbacks, without any \nsetup required. Most themes should work with this, but if not, or if a different layout is required, a custom theme template \ncan also be provided (see 'Creating a Template').<\/p>\n\n

Provides an HTML form for posting image content, as well as an API modelled on that of img.ly<\/a>,\ncompatible with Tweetie (for iPhone) and any other Twitter clients that speak this protocol and offer configuration of\ncustom image hosting services.<\/p>\n\n

Uses Twitter's authentication and a list of authorised accounts, so you can let others use your image host too. You can even \npost status updates to Twitter while submitting images.<\/p>\n\n

Provides a widget and shortcode to display uploaded images. This supports filtering by Twitter account, styling with CSS,\nand Lightbox\/Thickbox.<\/p>\n\n

Widget<\/h3>\n\n

To use the widget, simply visit the Widgets page and drag the \"Twitter Images\" widget into a sidebar and configure it.<\/p>\n\n

Shortcode<\/h3>\n\n

Shortcodes are snippets of text that can be inserted into pages and posts. These snippets are replaced by various generated content.\nTwitter Image Host provides a 'twitter-images' shortcode to display images you have uploaded within a page\/post.<\/p>\n\n

Available parameters:<\/p>\n\n

  count                    Number of items to display\n  id                       Single ID (eg 'abcde') of one image to display, or multiple IDs separated by commas (abcde,fghij)\n  view                     Image thumbnail view: squares, proportional, large or custom\n  custom_thumbnail_width   Custom width for thumbnails, when 'view' is 'custom'\n  custom_thumbnail_height  Custom width for thumbnails, when 'view' is 'custom'\n  custom_thumbnail_crop    Whether to crop custom thumbnails\n  author                   Comma-separated list of Twitter account names to limit results to\n  columns                  Number of columns of images to display \n  lightbox                 'true' to use Lightbox\/Thickbox\n<\/code><\/pre>\n\n
Example:<\/p>\n\n
  [twitter-images columns=4 lightbox=\"true\"]<h3>PHP function<\/h3>\n<\/code><\/pre>\n\n
As well as the shortcode, you can also use call twitter_image_host_images()<\/code> from within a template to\nproduce the same output.  Pass the same arguments as the shortcode as associative array values:<\/p>\n\n
  <h3>Recently submitted images<\/h3>\n  <?php twitter_image_host_images(array('author' => 'ATastyPixel', 'columns' => 6, 'lightbox' => true)); ?>\n<\/code><\/pre>\n\n
Tip: Use this in the twitter-image-host.php<\/code> template (see 'Creating a Single Template', below) to display\nother posted images when viewing an image.  Use the_twitter_image_author()<\/code> to filter the list, to show\nonly other submissions by the same Twitter account as the one of the currently displayed image.<\/p>\n\n
Template Tags<\/h3>\n\n
This plugin provides several template tags, for use both in displaying single posts (see 'Creating a Single Template'), and for custom pages which display\nmany posts in a loop (see 'Using Template Tags in a Loop').<\/p>\n\n
The available template tags are:<\/p>\n\n
Single Entry Tags<\/h4>\n\n
the_twitter_image_permalink<\/code><\/em><\/p>\n\n
Returns the URL to the view page<\/p>\n\n
the_twitter_image_url<\/code><\/em><\/p>\n\n
Returns the full URL to the image, or the image thumbnail if the original image was large<\/p>\n\n
the_twitter_full_image_url<\/code><\/em><\/p>\n\n
Returns the URL to the full-sized image, if one exists, or false otherwise<\/p>\n\n
the_twitter_image_title<\/code><\/em><\/p>\n\n
The title of the image<\/p>\n\n
the_twitter_image_date<\/code><\/em><\/p>\n\n
The date (timestamp) of the image - use date() to configure the display<\/p>\n\n
the_twitter_image_author<\/code><\/em><\/p>\n\n
The associated Twitter account<\/p>\n\n
the_twitter_image<\/code><\/em><\/p>\n\n
Returns HTML to display the image and a link to the full-sized image if it exists, with Lightbox rel tags.<\/p>\n\n
Loop Tags<\/h4>\n\n
query_twitter_images<\/code><\/em><\/p>\n\n
Search for Twitter images<\/p>\n\n
Available parameters (passed as associative array):<\/p>\n\n
 count                    Number of items to display\n id                       Single ID (eg 'abcde') of one image to display, or multiple IDs separated by commas (abcde,fghij)\n author                   Comma-separated list of Twitter account names to limit results to\n<\/code><\/pre>\n\n
has_twitter_images<\/code><\/em><\/p>\n\n
Use with loop: Determine if there are more images<\/p>\n\n
next_twitter_image<\/code><\/em><\/p>\n\n
Use with loop: Get the next image<\/p>\n\n
Creating a Single Template<\/h4>\n\n
By default, this plugin will use the standard post template ('single.php').  However, if you wish, you can create a \ncustom template to display hosted images.  The template should be called 'twitter-image-host.php', located within your\ncurrent theme directory.<\/p>\n\n
Creating a template to use this information is fairly straightforward if you have just a little knowledge of HTML or PHP:<\/p>\n\n
    \n
  1. On your server (via an FTP program, etc.), navigate to your current theme.  This will live within wp-content\/themes<\/code>.<\/li>\n
  2. Copy an existing template - single.php<\/code> is usually a good candidate - and call it twitter-image-host.php<\/code>.<\/li>\n
  3. Open up twitter-image-host.php<\/code>, and delete everything that looks post-related: This usually includes everything between\nthe have_posts<\/code> call and the matching endif<\/code>, and may include some other surrounding content like an 'Edit this post' link.<\/li>\n
  4. Replace that which you have just deleted with something that uses the 'single entry' template tags above, like the following:<\/p>\n\n
    <?php echo the_twitter_image() ?>\n<h1 class=\"center\"><?php echo the_twitter_image_title() ?><\/h1>\n<p class=\"center\">\n    From <a href=\"http:\/\/twitter.com\/<?php echo the_twitter_image_author() ?>\"><?php echo the_twitter_image_author() ?><\/a>\n     on <?php echo date('F jS, Y', the_twitter_image_date()) ?>\n<\/p>\n<\/code><\/pre><\/li>\n
  5. Save the file, add some content (see the 'Posting Images' section), and see how it looks.<\/p><\/li>\n<\/ol>\n\n
    Using Template Tags in a Loop<\/h4>\n\n
    Just like the WordPress Loop template tags, the template tags provided by this plugin can be used to display multiple posted entries.\nThis can be used to create a custom page template that lists all submitted entries, with more flexibility than that offered by the shortcode.<\/p>\n\n
    Use begins with a call to query_twitter_images()<\/code>, possibly with an argument to configure the search.  If the result is true, then the loop begins,\nconditional upon has_twitter_images()<\/code>, and starting with next_twitter_image()<\/code> to load the next entry.  The single template tags can then be used\nto customise the display of each entry.<\/p>\n\n
    Here is an example of use:<\/p>\n\n
      <?php if ( query_twitter_images() ) : ?>\n      <?php while ( has_twitter_images() ) : next_twitter_image(); ?>\n          <div class=\"item entry\">\n            <div class=\"itemhead\">\n              <h1><a href=\"<?php echo the_twitter_image_permalink() ?>\" rel=\"bookmark\"><?php echo the_twitter_image_title(); ?><\/a><\/h1>\n              <div class=\"date\"><?php echo date('F jS, Y', the_twitter_image_date()) ?><\/div>\n            <\/div>\n\n            <?php echo the_twitter_image() ?>\n            <p class=\"center\">From <a href=\"http:\/\/twitter.com\/<?php echo the_twitter_image_author() ?>\"><?php echo the_twitter_image_author() ?><\/a><\/p>\n            <\/div>\n      <?php endwhile; ?>\n  <?php else : ?>\n      <p>There are no Twitter images.<\/p>\n  <?php endif; ?><h3>Posting Images<\/h3>\n<\/code><\/pre>\n\n
    To start posting from your WordPress blog, select the \"Twitter Image Host\" menu item from the \"Posts\" administration section.\nEnter a title for your image, select your image file, hit Submit, and you will be given the URL for the image.  If you wish\nto tweet straight from this facility, you will need to follow the instructions from that page to set up the plugin.<\/p>\n\n
    To access this facility from an application, use the access point displayed on the Twitter Image Host options page under \"Settings\".<\/p>\n\n
    The API is more-or-less the same as that of TweetPic<\/a>, img.ly<\/a>, etc.<\/p>\n\n
    To post from Twitter (Tweetie 2) for iPhone, visit Twitter\/Tweetie's settings, and within Services, Image Service<\/em>, select 'Custom', then\nenter the API URL as listed on the options page.<\/p>\n\n
    Making the URL even shorter<\/h3>\n\n
    If you run WordPress from a sub-directory (for example, http:\/\/your-site.com\/blog), then the short URLs generated by this plugin will\nlook like http:\/\/your-site\/blog\/xxxxx<\/code>.  You can remove that 'blog' component via a little .htaccess<\/code> trickery.<\/p>\n\n
    Here's how:<\/p>\n\n
      \n
    1. Create and open a new file in your site's webroot called \".htaccess\". If there's one already there, just open that up and prepare to edit at the bottom.<\/li>\n
    2. Add the following, replacing 'blog' with the real subdirectory under which WordPress is installed:<\/p>\n\n
      <IfModule mod_rewrite.c>\nRewriteEngine On\nRewriteBase \/\nRewriteCond %{REQUEST_URI} ^\/([^\/]+)\/?$\nRewriteCond %{DOCUMENT_ROOT}\/blog\/wp-content\/twitter-image-host-content\/%1.jpg -f [OR]\nRewriteCond %{DOCUMENT_ROOT}\/blog\/wp-content\/twitter-image-host-content\/%1.png -f [OR]\nRewriteCond %{DOCUMENT_ROOT}\/blog\/wp-content\/twitter-image-host-content\/%1.jpeg -f\nRewriteRule (.*) \/blog\/$1 [L]\n<\/IfModule>\n<\/code><\/pre>\n\n
      This will take any requests that:<\/p>\n\n