-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathreadme.txt
236 lines (183 loc) · 14.1 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
=== Auto Image Attributes From Filename With Bulk Updater ===
Contributors: arunbasillal
Donate link: https://imageattributespro.com/?utm_source=wordpress.org&utm_medium=donate-link
Tags: image title, image caption, image description, alt text, bulk edit images, bulk rename images, auto image attributes, auto image alt text, remove underscores, image seo
Requires at least: 3.5.0
Tested up to: 5.2.1
Stable tag: trunk
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Automatically Add Image Title, Caption, Description And Alt Text From Filename. Includes a bulk updater to update existing images in the Media Library
== Description ==
Automatically add Image attributes such as Image Title, Image Caption, Description And Alt Text from Image Filename.
The plugin can update image attributes for both new images and existing images in the media library.
> **Life-Saver**
> It allowed me to save tons of time. Further, the support is nice and ready to help.
> - [thnk4](https://wordpress.org/support/topic/life-saver-188/)
Image alt text and title is critical for your image SEO and will help users discover your images (and there by your website) in Google / Yahoo / Bing image search.
Proper alt text also helps people who are blind or who have low vision understand your images there by improving the accessibility of your website. This will open up your website to a new segment of visitors and increase your traffic.
> **Wow!**
> If I could give this 1 more star I would!
> - [jdev](https://wordpress.org/support/topic/wow-550/)
With this plugin you can:
* Set the image filename as the image Title.
* Set the image filename as the image Caption.
* Set the image filename as the image Description.
* Set the image filename as the image Alt Text. This was a default feature in WordPress before 4.7. The plugin restores this essential feature which is great for SEO.
* Insert Image Title into post HTML. WordPress stopped adding Image Titles to images since WordPress 3.5. The plugin restores it.
* Remove hyphens from the image filename.
* Remove underscores from the image filename.
* Remove full stops from filename.
* Remove commas from filename.
* Remove all numbers from filename.
* Choose to turn off any of the above mentioned features.
With the bulk updater you can:
* Set the image filename as image Title, Caption, Description and Alt Text after removing hyphens and underscores from the filename.
* Update any number of images in your Media Library in one click.
If your image filename is *My_image-name.jpg*, your Image Title, Caption, Description And Alt Text will be *My image name*.
The plugin settings and bulk updater are in WordPress Admin > Settings > Image Attributes. Here you can choose which attributes to update for NEW uploads.
Please remember to take a database backup before running the bulk updater. The bulk updater updates ALL attributes for existing images in the Media Library and ignores the settings set for NEW uploads.
**Image Attributes Pro**
A pro add-on is now available for the plugin. Check out [Image Attributes Pro](https://imageattributespro.com/?utm_source=wordpress.org&utm_medium=readme).
The pro add-on can update the image attributes from not just the image filename, but also from the post / page / product / custom post type title. You can fine tune the bulk updater settings and even clean up the actual image filename.
> Thank you so much for all your help in trying to fix this, its very much appreciated indeed. You've gone above and beyond what I was expecting in support!
> Rest assured I will give great feedback on your plugin anywhere I can!!
> - **James Barber**, for [Image Attributes Pro](https://imageattributespro.com/?utm_source=wordpress.org&utm_medium=readme) via email.
What the pro add-on you get these additional features:
* Use post title as title text. If image is not attached to a post, image filename will be used instead.
* Use post title as alt text. If image is not attached to a post, image filename will be used instead.
* Use post title as caption. If image is not attached to a post, image filename will be used instead.
* Use post title as description. If image is not attached to a post, image filename will be used instead.
* Remove apostrophe ( ' ) from filename
* Remove tilde ( ~ ) from filename
* Remove plus ( + ) from filename
* Remove pound ( # ) from filename
* Remove ampersand ( & ) from filename
* Remove round brackets ( ( ) ) from filename
* Remove square brackets ( [ ] ) from filename
* Remove curly brackets ( { } ) from filename
* Filter words or characters from filename
* Filter filename with regex
* convert image attributes to lowercase
* CONVERT IMAGE ATTRIBUTES TO UPPERCASE
* Use title casing for image attributes. First Letter Of Each Word Will Be Capitalized.
* Use sentence casing for image attributes. First letter of a sentence will be capitalized.
* Clean the actual image filename after upload.
* Choose to turn off any of the above mentioned features.
With the pro bulk updater you can:
* Update image title and alt text **for images inserted into posts and custom post types**. Not just the media library.
* Fine tune all settings. Choose what to update.
* Update image titles / alt text in media library only. Image titles / alt text in existing posts will be left unchanged.
* Update image titles / alt text in media library and existing posts.
* Update image titles / alt text in existing posts only if no title / alt text is set. All image titles/ alt text in media library will be updated.
* Choose to turn off any of the above mentioned features.
* Modify auto generated image attributes using the [iaffpro_image_attributes filter](https://imageattributespro.com/codex/iaffpro_image_attributes/?utm_source=wordpress.org&utm_medium=readme).
* Choose specific post types to bulk update using the [iaffpro_included_post_types filter](https://imageattributespro.com/codex/iaffpro_included_post_types/?utm_source=wordpress.org&utm_medium=readme).
* Disable updating of attributes in media library completely using the [iaffpro_update_media_library filter](https://imageattributespro.com/codex/iaffpro_update_media_library/?utm_source=wordpress.org&utm_medium=readme).
For screenshots, FAQ and full list of features, please see the [product website](https://imageattributespro.com/?utm_source=wordpress.org&utm_medium=readme).
> **No Competitors**
> This is the only one that enables you to add missing tags to your images in one go, simple! ... This one is very well coded and the author pays great attentions to users feedback / requests / support.
> - [arsenalemusica](https://wordpress.org/support/topic/no-competitors/)
== Installation ==
To install this plugin:
1. Install the plugin through the WordPress admin interface, or upload the plugin folder to /wp-content/plugins/ using ftp.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Go to WordPress Admin > Settings > Image Attributes.
== Frequently Asked Questions ==
= Will this plugin update existing images in the media library? =
Yes, the plugin will update image Title, Caption, Description And Alt Text from the image filename for both existing images in the media library and new uploads.
= I need more features. Can I hire you? =
Please checkout the [Image Attributes Pro add-on](https://imageattributespro.com/?utm_source=wordpress.org&utm_medium=readme) to see if it suits your requirement. If not, please [send in a feature request](https://imageattributespro.com/contact/?utm_source=wordpress.org&utm_medium=faq-feature-request) with a brief description of your requirement and I will be in touch shortly.
= This plugin saved me a lot of time, how can I show my appreciation? =
I am glad to hear that! You can either [upgrade to pro](https://imageattributespro.com/?utm_source=wordpress.org&utm_medium=readme-faq) or leave a [rating](https://wordpress.org/support/plugin/auto-image-attributes-from-filename-with-bulk-updater/reviews/?rate=5#new-post) to motivate me to keep working on the plugin.
== Screenshots ==
1. The settings page in WordPress Admin > Settings > Image Attributes with default settings.
2. Preview of the Advanced settings screen. Seen only when the preview is enabled.
2. Preview of the Bulk Updater settings screen. Seen only when the preview is enabled.
4. Bulk Updater
== Changelog ==
= 1.6 =
* Date: 06.January.2019
* Tested with WordPress 5.0.2.
* Enhancement: Improved bulk updater warning and inline documentation.
* Bug Fix: Fixed a bug that ignored the setting for inserting image title into the post HTML. Thanks [@jamesryancooper](https://wordpress.org/support/topic/image-title-being-inserted-even-with-checkbox-unselected/)
= 1.5 =
* Date: 06.May.2018
* Enhancement: Changed text domain from abl_iaff_td to auto-image-attributes-from-filename-with-bulk-updater to make the plugin translation ready in translate.wordpress.org.
* Enhancement: Code improvements.
* Enhancement: Added an activation notice with link to the settings page for better on-boarding experience.
= 1.4 =
* Date: 22.November.2017
* NEW: Global switch to enable or disable the plugin.
* NEW: Test button.
* NEW: Stop Bulk Updater button.
* NEW: Support tab.
* Improvement: Changed source of filename from guid to wp_get_attachment_url() to prevent conflicts with other plugins. GUID was being replaced by other plugins. Thanks to @niresh12495 for [bringing this up] (https://wordpress.org/support/topic/image-title-description-and-alt-tag-replaced-with-attachment-idnumber/).
* Impreovement: Added checks to check if attachment is image before processing.
* FIX: Added [boolval() function for backwards compatibility](https://millionclues.com/wordpress-tips/solved-fatal-error-call-to-undefined-function-boolval/) with servers with PHP older than PHP 5.5.
* Added preview of premium options that ship with [Image Attributes Pro](https://imageattributespro.com/docs?utm_source=wordpress.org&utm_medium=changelog)
* UI Improvements.
* Code improvements.
= 1.3 =
* Date: 17.August.2017
* Improved the architecture of the plugin laying foundation for future updates. Utilizing my [starter plugin framework](http://millionclues.com/lab/wordpress-starter-plugin-a-framework-for-quick-plugin-development/)
* Bug fix: For images that had EXIF data, EXIF data was used instead of filename. Props to @mathieupellegrin for reporting this.
* NEW: Added option to Insert Image Title into HTML. WordPress stopped including image titles since 3.5. Code from [Restore Image Title](https://wordpress.org/plugins/restore-image-title/) plugin was used.
* NEW: Remove full stops ( . ) from filename.
* NEW: Remove commas ( , ) from filename.
* NEW: Remove all numbers ( 0-9 ) from filename.
* NEW: Added a warning and user confirmation before while clicking "Run Bulk Updater" button to prevent accidental clicks.
* UI Improvement: Cleaned up the interface and moved the Bulk Updater to its own tab.
* UI Improvement: Bulk updater log is now displayed in a neat box instead of just printing the results on the page.
* Parts of the code was updated for more efficiency and faster processing.
* Tested on WordPress 4.8.1. Result = pass.
= 1.2 =
* Date: 15.July.2017
* Added: Character filter options. Plugin now removes hyphens and underscores.
* Bug Fix: Minor bug fix.
= 1.1 =
* Date: 4.July.2017
* Added: Options to choose individual image attributes for NEW uploads.
= 1.0 =
* Date: 4.July.2017
* First release of the plugin.
== Upgrade Notice ==
= 1.6 =
* Tested with WordPress 5.0.2.
* Enhancement: Improved bulk updater warning and inline documentation.
* Bug Fix: Fixed a bug that ignored the setting for inserting image title into the post HTML.
= 1.5 =
* Enhancement: Changed text domain from abl_iaff_td to auto-image-attributes-from-filename-with-bulk-updater to make the plugin translation ready in translate.wordpress.org.
* Enhancement: Code improvements.
* Enhancement: Added an activation notice with link to the settings page for better on-boarding experience.
= 1.4 =
* Date: 22.November.2017
* NEW: Global switch to enable or disable the plugin.
* NEW: Test button.
* NEW: Stop Bulk Updater button.
* NEW: Support tab.
* Improvement: Changed source of filename from guid to wp_get_attachment_url() to prevent conflicts with other plugins. GUID was being replaced by other plugins. Thanks to @niresh12495 for [bringing this up] (https://wordpress.org/support/topic/image-title-description-and-alt-tag-replaced-with-attachment-idnumber/).
* Impreovement: Added checks to check if attachment is image before processing.
* FIX: Added [boolval() function for backwards compatibility](https://millionclues.com/wordpress-tips/solved-fatal-error-call-to-undefined-function-boolval/) with servers with PHP older than PHP 5.5.
* Added preview of premium options that ship with [Image Attributes Pro](https://imageattributespro.com/docs?utm_source=wordpress.org&utm_medium=changelog)
* UI Improvements.
* Code improvements.
= 1.3 =
* Improved the architecture of the plugin laying foundation for future updates. Utilizing my [starter plugin framework](http://millionclues.com/lab/wordpress-starter-plugin-a-framework-for-quick-plugin-development/)
* Bug fix: For images that had EXIF data, EXIF data was used instead of filename. Props to @mathieupellegrin for reporting this.
* NEW: Added option to Insert Image Title into HTML. WordPress stopped including image titles since 3.5. Code from [Restore Image Title](https://wordpress.org/plugins/restore-image-title/) plugin was used.
* NEW: Remove full stops ( . ) from filename.
* NEW: Remove commas ( , ) from filename.
* NEW: Remove all numbers ( 0-9 ) from filename.
* NEW: Added a warning and user confirmaton before while clicking "Run Bulk Updater" button to prevent accidental clicks.
* UI Improvement: Cleaned up the interface and moved the Bulk Updater to its own tab.
* UI Improvement: Bulk updater log is now displayed in a neat box instead of just printing the results on the page.
* Parts of the code was updated for more efficiency and faster processing.
* Tested on WordPress 4.8.1. Result = pass.
= 1.2 =
* Added: Character filter options. Plugin now removes hyphens and underscores.
* Bug Fix: Minor bug fix.
= 1.1 =
* Added: Options to choose individual image attributes for NEW uploads.
= 1.0 =
* First release of the plugin.