=== Plugin Name ===
Contributors: Karthikeyan
Donate link: http://www.karthikeyankarunanidhi.com/plugins/
Tags: auto,automatic,image,images,post,recipe,recipes,cook,cooking,chef,kitchen,photo,blog,photos
Requires at least: 2.6.2
Tested on: 2.6.2, 2.7, 2.7.1, 2.8.4
Tested up to: 2.8.4
Stable tag: 2.2
Automatically adds images to posts without having to edit the post.
== Description ==
Automatically adds images to posts without having to edit the post.
To insert images into posts you no longer have to insert them one by one using the editor. All you have to do is name them appropriately and upload them to a folder & the plugin will automatically insert them into the corresponding post.
Want to add more images to the post? All you have to do is put more images into the folder and they will show up on the post without having to edit the post.
Need to remove a image from a post? Then just delete the image and it will no longer appear in the post.
No more hassle of editing the post.
Images tagged with the POSTID are displayed on that post. If the thumbnail option is enabled the plugin will use thumbnails in the post to link to the full size images. The plugin will automatically create thumbnails when needed.
Usage: Upload images by naming them as `'Image_POSTID'` where 'POSTID' is ID of post where the image should be displayed. If you wish to use a different filename format then you can edit the regular expression pattern in the settings page.
Multiple images can be attached to a post simply by ensuring that all of them have the same prefix. For posts that do not have images a default "Image coming soon" image is displayed; this can be disabled from the settings screen.
Example Image Name: `'Image_66.jpg', 'Image_66_a.jpeg', 'Image_66_two.gif', 'Image_66something'`, etc. Note: When posting multiple images to the same post by naming them with the same 'Image_NNN' prefix the image name after the prefix cannot have numbers. For example: `'Image_66abc2xyx.gif'` is not allowed because the filename after the prefix has a number, in this case the number "2". Again, if you wish to use a different filename format then you can edit the regular expression pattern in the settings page.
Demo: [Dash of Salt & A Pinch of Love](http://sethulakshmi.karunanidhi.com/)
Author Home: [Karthikeyan](http://www.karthikeyankarunanidhi.com)
Plugin Home: [Auto Post Images (API)](http://www.karthikeyankarunanidhi.com/plugins/)
== Installation ==
1. Download the plugin zip file
1. Upload the plugin contents into your WordPress installation's plugin directory
1. The plugin's .php files and readme.txt should be installed in the 'wp-content/plugins/auto-post-images-api/' directory
1. From the Plugin Management page, activate the "Auto Post Images (API)" plugin
1. Edit the plugin image/thumbnail directory path and url in the Plugin Admin Panel to a directory outside the plugin inatallation directory. **Note: If you use the default image directory inside the plugin installation directory you images might get deleted when upgrading**
1. Copy the "imagecomingsoon.jpg" default image from the plugin directory ('wp-content/plugins/auto-post-images-api/images/')into your image directory. If you don't copy it then you will get 404 error for the image.
1. Upload images to the image directory and they will appear in the corresponding posts
== Screenshots ==
1. Image thumbnail automatically added to post
2. Settings Page
3. Full size image displayed when clicked on thumbnail
== Frequently Asked Questions ==
= I want a feature. Can you add it for me? =
Sure. Drop me an email :)
= How do I not show the default image when there is no image for a post? =
1. Go to Dashboard
1. Click Settings
1. Click Auto Post Images (API) Settings
1. Select "**No**" under "**Display default image if not image is found?**"
1. Click "Update Settings"
1. Now the default "Image Coming Soon" image is not displayed for posts that do not have images.
1. Posts that have images will continue displaying the images as usual
= I don't want to use thumbnails. I want full size images in my posts =
1. Go to Dashboard
1. Click Settings
1. Click Auto Post Images (API) Settings
1. Select "**No**" under "**Use thumbnails to link to full size images?**"
1. Click "Update Settings"
1. Now the full size images are added to posts instead of thumbnails
= Where is the Plugin Admin Panel? Do you expect me to edit the code myself? =
1. Go to Dashboard
1. Go to Settings
1. Click Auto Post Images (API) Settings
= I want to name the images something other than Image_POSTID ? =
Sure. All you have to do is change the regular expression "**Image search Regular Expression?**". Just make sure it has __POSTID__ somewhere in the expression so that the plugin knows which images are attached to which post.
= Do I name the images differently when SEO is enabled ? =
No. You still upload the images using the same filename format specified in "**Image search Regular Expression?**". The plugin will use this to search for images associated with the post and then rename them using the posts title.
= What image types are supported? =
Anything that the browser supports.
= How do I change the image position and style =
The CSS is in **/auto-post-images/css/kkimageinpost.css**
= How do I change the width of the thumbnail =
The width of the thumbnail image can be changed by changing the value of **$iThumbnailWidth** in the **/auto-post-images-api/trunk/php/ThumbCreator.class.php** file. I will soon add this to the Plugin Admin Panel.
= I have a question that is not answered here =
Email me. I'll be happy to answer it.
= I want to donate =
If you are really thinking about donating... Thanks, I really appreciate it. Instead of donating money just write a few lines about the plugin and link to the plugin (http://wordpress.org/extend/plugins/auto-post-images-api/) and my site (http://www.KarthikeyanKarunanidhi.com) or use the following code: `'Auto-Post-Images (API) plugin by Karthikeyan'`
== Changelog ==
= 2.2 =
* On
* Added SEO support for images. When enabled the images will renamed using the post title
= 2.1.2 =
* On 11:16:26 PM, Tuesday, March 10, 2009
* Fixed issue with regex that was used to fetch images
= 2.1.1 =
* On 11:37:11 PM, Monday, March 09, 2009
* Fixed bug in regular expression.
= 2.1 =
* On 3:32:28 PM, Thursday, January 29, 2009
* Added 5 new settings: Image Dir, Thumbnail Dir, Cache Dir, Image Url, and Thumbnail Url so that they can be changed. This will allow users to put their image and thumbnail folders outside the plugin directory and not have to lose image when updating the plugin
= 2.0.3 =
* On 7:17:30 PM, Wednesday, January 28, 2009
* Removing background image from ibox popup that was generating a 404
= 2.0.2 =
* On 6:52:48 PM, Wednesday, January 28, 2009
* Path fix: folder name was being incorrectly set to auto-post-images instead of auto-post-images-api
= 2.0.1 =
* On 6:31:20 PM, Wednesday, January 28, 2009
* Removed title from ibox popup
= 2.0 =
* On 12:01:10 AM, Wednesday, January 28, 2009
* Added thumbnail support: PHP code to create thumbnails and ibox javascript for displaying full size image on overlay
= 1.1.1 =
* On 8:12:33 AM, Thursday, November 06, 2008
* Looks like I have to update the stable tag
* Added documentation
* Found out that the version number needs to be updated in both the readme.txt and the plugin php file :)
= 1.1 =
* On 1:05:24 AM, Thursday, November 06, 2008
* Fixed formatting issues in the readme file - escaped underscores
* Updated image filename regexp and readme text
* Added demo site link to readme and added more faq’s
* Added admin screen to update settings related to the plugin
* Added new setting to control weather the default image is displayed when images are not found for a post
* Added screenshots to the readme file
= 1.0 =
* On 2:31:26 PM, Tuesday, November 04, 2008
* First release.