forked from tomaszsita/wp-manual-image-crop
-
Notifications
You must be signed in to change notification settings - Fork 0
/
readme.txt
143 lines (110 loc) · 5.14 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
=== Manual Image Crop ===
Contributors: tomasz.sita, mcaskill
Tags: crop, cropping, thumbnail, featured image, gallery, images, picture, image, image area
Tested up to: 4.9.8
Requires at least: 4.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=WB5ZQWGUM7T96
Stable tag: 1.13
Plugin allows you to manually crop all the image sizes registered in your WordPress theme (including the featured image).
== Description ==
Plugin allows you to manually crop all the image sizes registered in your WordPress theme (including the featured image).
Simply click on the "Crop" link next to any image in your media library.
The "lightbox" style interface will be brought up and you are ready to go.
Whole cropping process is really intuitive and simple.
Apart from media library list, the plugin adds links in few more places:
* Below featured image box ("Crop featured image")
* In the media insert modal window (once you select an image)
= Enjoying using Manual Image Crop? =
[Donate the plugin here](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=WB5ZQWGUM7T96 "Donate")
Thank you!
= GitHub Repository =
https://github.com/mcaskill/wp-manual-image-crop
= Translations =
* Danish (Jan Francke-Larsen)
* Dutch (Bernardo Hulsman)
* French (Gabriel Féron)
* German (Bertram Greenhough)
* Hungarian (Roland Kal)
* Italian (Alessandro Curci)
* Polish (Tomasz Sita, Maciej Gryniuk)
* Russian (Andrey Hohlov)
* Slovak (Patrik Benyak)
* Spanish (Andrew Kurtis)
* Swedish (Karl Oskar Mattsson)
Please contact me if you want to add a translation (or submit a pull request on GitHub)
== Installation ==
= Manually: =
* Upload `manual-image-crop` to the `/wp-content/plugins/` directory
* Activate the plugin through the 'Plugins' menu in WordPress
= Automatically: =
* Navigate to the 'Plugins' menu inside of the wordpress wp-admin dashboard, and select AD NEW
* Search for 'Manual Imag Crop', and click install
* When the plugin has been installed, Click 'Activate'
== Filters ==
The plugin includes filters that can be used by other plugins:
=mic_do_crop=
Provides $do_crop (bool), $metadata (array), and $dims (array). Returning false for $do_crop will prevent Manual Image Crop from cropping the image. $metadata contains the crop parameters, so another plugin can take over the actual cropping.
=mic_dst_file_path=
Provides $path (string) and $data (array). Manual Image Crop will write the new image to $path and save that path to the image metadata. $data contains the crop parameters that the user chose in WordPress admin.
=mic_dst_file_url=
Provides $url (string) and $data (array). Manual Image Crop will return $url in an AJAX response if the image crop is successful. $data contains the crop parameters that the user chose in WordPress admin.
The admin screen uses this URL to display the updated image. This URL is not stored with the image or used elsewhere in WordPress. wp_get_attachment_image_src is used instead to generate the image URL.
== Actions ==
The plugin includes actions that can be used by other plugins:
= mic_crop_done =
Triggered after a crop has been successfully completed, immediately before the JSON response is sent to the browser. Provides $data (array) and $imageMetadata (array).
== Changelog ==
= 1.13 =
* Fixed thickbox bug where crop preview was scrolled off screen (WP 4.7)
* Filters added (Ryan DeBeasi)
* Action mic_crop_done added (Joey Line)
* Added warnings about conflicting plugins
* Removed distributed vendor packages and instead using versions included with WordPress
* Danish and Slovak translations added
* Polish translation updated
* Code cleanup
= 1.12.1 =
* Better handling of undersized images
= 1.12 =
* Fixed 'streched images' issue
= 1.11 =
* Hungarian translation added
* Swedish translation added
* Security improvements
= 1.10 =
* Fixed handling of array $crop param
= 1.09 =
* Dutch translation added
* Better error handling
* Fixed overwriting of previously saved crops
* Minor tweaks all around
= 1.08 =
* More descriptive error messages
* Russian translation added
* Hooked 'Crop' link to new media library layout (WP 4.0)
* A few minor edits
= 1.07 =
* Fixed 'Cannot use string offset as an array' error
= 1.06 =
* French, German, Italian, Polish, Spanish translations added
* Settings page added (quality, visibility, custom labels)
* Compatibility with Retina/HiDPI (@2x) plugin added
* Fixed issue with closing editor window from within media uploader screen
= 1.05 =
* WordPress 3.9 compatibility issues fixed
* Removed randomly floated 'Maximum upload file size'
= 1.04 =
* Added remembering of the previously selected area after cropping the specific image size
* Fixed the "wp_enqueue_script was called incorrectly" warning in the WP debug mode
= 1.03 =
* Fixed the issue with overwriting the original image when cropping image size registered after the attachment had been uploaded
= 1.02 =
* Fixed HTTP Authentication no preview issue
* Fixed path issues on multisite/subfolder WP installations
= 1.01 =
* Fixed Chrome stretched image issue
* Improved compatibility with other plugins using 'thickbox'
= 1.0 =
* Initial version