| @@ -1,33 +1,87 @@ | ||
| 1 | -=== Plugin Name === | |
| 1 | +=== Image Source Control === | |
| 2 | 2 | Contributors: webzunft |
| 3 | -Tags: image, images, picture, picture source, image source, mediathek | |
| 4 | -Requires at least: 3.4 | |
| 5 | -Tested up to: 3.5 | |
| 6 | -Stable tag: 1.1.2.1 | |
| 3 | +Tags: image, images, picture, picture source, image source, mediathek, media, caption, copyright | |
| 4 | +Requires at least: 5.0 | |
| 5 | +Tested up to: 5.2 | |
| 6 | +Stable tag: 1.10 | |
| 7 | +Requires PHP: 5.6 | |
| 7 | 8 | License: GPLv3 or later |
| 8 | 9 | License URI: http://www.gnu.org/licenses/gpl-3.0.html |
| 9 | 10 | |
| 10 | -The Image Source Control saves the source of an image, lists them and warns if it is missing. | |
| 11 | +The Image Source Control manages image sources, displays them and warns if they are missing. | |
| 11 | 12 | |
| 12 | 13 | == Description == |
| 13 | 14 | |
| 14 | -Did you ever forget to add the source to an image file in the frontend and the lawer of the copyright holder knocked on your door? | |
| 15 | +Did you ever forget to add the source to an image file in the frontend and the lawyer of the copyright holder knocked on your door? | |
| 15 | 16 | |
| 16 | 17 | Image Source Control (ISC) helps to prevent this situation. |
| 17 | 18 | |
| 18 | -**Features** | |
| 19 | +> <strong>github repository</strong> | |
| 20 | +> | |
| 21 | +> I might not always be able to work on feature requests or fix buxes, but you can submit them to the github repository. | |
| 22 | +> I will definitely review them there. | |
| 23 | +> https://github.com/webgilde/image-source-control | |
| 19 | 24 | |
| 20 | -* adds an extra field (custom field) to mediathek to include the image source into | |
| 21 | -* lets you mark an image as your own | |
| 22 | -* lists images with missing sources | |
| 23 | -* shortcode to include the sources in content fields | |
| 24 | -* function to include sources of a post in templates | |
| 25 | +**Image Sources Lists** | |
| 25 | 26 | |
| 27 | +You can choose between different image source list types: | |
| 28 | + | |
| 29 | +* source as image caption/overlay (not compatible with all themes) | |
| 30 | +* source list below the content | |
| 31 | +* combined source list of all images | |
| 32 | + | |
| 33 | +**Frontend Features** | |
| 34 | + | |
| 35 | +* display sources for images in content, galleries, shortcodes and featured images | |
| 36 | +* show image source directly in the image (not working with all images and themes) | |
| 37 | +* include a list with all images and their sources of the current page/post | |
| 38 | +* include a list with all images and their sources with all images or only those included in posts | |
| 39 | +* attach lists be the content automatically or using shortcodes or template functions | |
| 40 | +* display image sources on archive pages | |
| 41 | + | |
| 42 | +**Backend Features** | |
| 43 | + | |
| 44 | +* manage image source within media dashboard and in the Image block settings | |
| 45 | +* mark an image to belong to the uploader | |
| 46 | +* lists images with missing sources in the backend | |
| 47 | +* warnings, if image source is missing | |
| 48 | +* link sources to any url | |
| 49 | +* manage, display and link licenses | |
| 50 | + | |
| 26 | 51 | **Localization** |
| 27 | 52 | |
| 28 | 53 | English, German |
| 29 | 54 | |
| 55 | +== Instructions == | |
| 56 | + | |
| 57 | +Also have a look at the [image source control website](http://webgilde.com/en/image-source-control/image-source-control-manual/). | |
| 58 | + | |
| 59 | +Find a list of images with missing sources under _Media > Missing sources_ | |
| 60 | + | |
| 61 | +**automatic image sources** | |
| 62 | + | |
| 63 | +You can choose to display image sources automatically below the post content or as a small overlay above your images. Just visit the settings page of the plugin to enable those options. | |
| 64 | + | |
| 65 | +**manually included image sources on pages/posts** | |
| 66 | + | |
| 67 | +You can add the image source list manually to pages or post via the shortcode `[isc_list]` in your content editor. You can use `[isc_list id="123]` to show the list of any post or page. | |
| 68 | + | |
| 69 | +You can also add the list with the function `isc_list()` within the loop in your template files. Use `isc_list( $post_id )` to show the image source list outside the loop. | |
| 70 | + | |
| 71 | +You should also check first if the function exists before using it: | |
| 72 | +`<?php if( function_exists('isc_list') ) { isc_list(); } ?>` | |
| 73 | + | |
| 74 | +**list all image sources** | |
| 75 | + | |
| 76 | +You can add a paginated list with ALL attachments and sources to a post or page using the shortcode `[isc_list_all]`. Use `[isc_list_all per_page="25"]` to show only a limited number of images per page. | |
| 77 | + | |
| 78 | +The plugin searches your post content and thumbnail for images (attachments) and lists them, if you included at least the image source or marked it as your own image. | |
| 79 | + | |
| 80 | +== Legal Notice == | |
| 81 | + | |
| 82 | +This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. | |
| 83 | + | |
| 30 | 84 | == Installation == |
| 31 | 85 | |
| 32 | 86 | This section describes how to install the plugin and get it working. |
| 33 | 87 | |
| @@ -34,54 +88,162 @@ | ||
| 34 | 88 | e.g. |
| 35 | 89 | |
| 36 | 90 | 1. Upload `wg-image-source-control`-folder to the `/wp-content/plugins/` directory |
| 37 | 91 | 1. Activate ISC through the 'Plugins' menu in WordPress |
| 92 | +1. Visit _Settings > Image Control_ to set up the plugin | |
| 38 | 93 | |
| 94 | +See the _Instructions_ section [here](https://wordpress.org/plugins/image-source-control-isc/#description). | |
| 95 | + | |
| 39 | 96 | == Screenshots == |
| 40 | 97 | |
| 41 | -1. Missing sources page to list images with missing source. | |
| 42 | -2. Two extra fields from ISC in mediathek | |
| 98 | +1. edit image source settings in the Image block | |
| 99 | +1. display a list with all images of your site and their sources | |
| 100 | +1. display image source within the image | |
| 101 | +1. some of the settings to customize how to display image sources | |
| 43 | 102 | |
| 44 | 103 | == Changelog == |
| 45 | 104 | |
| 46 | -= 1.1.2.1 = | |
| 105 | += 1.10 = | |
| 47 | 106 | |
| 48 | -* [fixed] wrong user level check caused shortcode to not work for normal visitors | |
| 107 | +* added image source settings to Image block | |
| 49 | 108 | |
| 50 | -= 1.1.2 = | |
| 51 | -* [fixed] wrong version number in main file so wordpress.org didn't inform about updates | |
| 52 | -* [fixed] some minor coding standard issues | |
| 53 | -* [fixed] small text for donate link | |
| 54 | -* [fixed] plugin url | |
| 55 | -* [removed] donate link (will come back after 10.000 downloads ;) | |
| 109 | += 1.9.7 = | |
| 56 | 110 | |
| 57 | -= 1.1.1 = | |
| 58 | -* [fixed] javascript file is now being loaded and missing fields can be added | |
| 59 | -* [feature] added button to reload the missing sources page after fields have been added | |
| 60 | -* [locale] updated German translation | |
| 111 | +* changed `licence` string to `license` to match en_US language base | |
| 112 | +* extended list of copyright licenses | |
| 61 | 113 | |
| 62 | -= 1.1 = | |
| 63 | -* [fixed] show image sources under the post | |
| 64 | -* [fixed] display "checked" attribute in frontend | |
| 65 | -* [fixed] don't display image titles in image source list without a source | |
| 66 | -* [feature] show sources for all images visible in the post content, not the post gallery | |
| 67 | -* [feature] automatically load image source list first time a post is displayed after plugin installation | |
| 114 | += 1.9.6 = | |
| 68 | 115 | |
| 69 | -= 1.0 = | |
| 70 | -* initial submittion | |
| 71 | -* [feature] Added image source fields to mediathek | |
| 72 | -* [feature] List images with missing sources | |
| 73 | -* [feature] Shortcode to include the sources in content fields | |
| 74 | -* [feature] Function to include sources of a post in templates | |
| 116 | +* fixed issue using [isc_list] without overlays | |
| 75 | 117 | |
| 76 | -== Instructions == | |
| 118 | += 1.9.5 = | |
| 77 | 119 | |
| 78 | -Find a list of images with missing sources under _Mediathek > Missing sources_ | |
| 120 | +* removed additional output introduced in 1.9.3 | |
| 79 | 121 | |
| 80 | -You can add the image source list to pages or post via the shortcode [isc_list] in your content editor. You can use `[isc_list id="123]`to show the list of any post or page. | |
| 122 | += 1.9.4 = | |
| 81 | 123 | |
| 82 | -You can also add the list with the function `isc_list()` within the loop in your template files. Use `isc_list( $post_id )` to show the image source list outside the loop. | |
| 124 | +* fixed index error | |
| 83 | 125 | |
| 84 | -You should also check first if the function exists before using it: | |
| 85 | -`<?php if( function_exists('isc_list') ) { isc_list(); } ?>` | |
| 126 | += 1.9.3 = | |
| 86 | 127 | |
| 87 | -The plugin searches your post content and thumbnail for images (attachments) and lists them, if you included at least the image source or marked it as your own image. | |
| 128 | +* prevent image source overlay on full image source list and below | |
| 129 | +* optimized query of missing-sources check | |
| 130 | +* only check for missing sources when an image was uploaded or once every 24 hours | |
| 131 | + | |
| 132 | += 1.9.2 = | |
| 133 | + | |
| 134 | +* prevent infinite loop for posts with automatic image source lists where images are not index yet | |
| 135 | +* moved German translation to wordpress.org | |
| 136 | + | |
| 137 | += 1.9.1 = | |
| 138 | + | |
| 139 | +* delayed displaying source overlay by 100 ms to give images a chance to load their height | |
| 140 | +* fixed wrong height of the overlay being used | |
| 141 | +* fixed missing textdomain code to allow translations added through wordpress.org | |
| 142 | + | |
| 143 | += 1.9 = | |
| 144 | + | |
| 145 | +THIS UPDATE CONTAINS SOME BASIC CHANGES ON HOW IMAGES ARE DETECTED IN THE CONTENT. PLEASE TEST IT. | |
| 146 | + | |
| 147 | +Please [reach out](https://wordpress.org/support/plugin/image-source-control-isc) in case you are suddenly missing any image sources. | |
| 148 | + | |
| 149 | +* rewritten the way how images are detected in the content of the post or page | |
| 150 | +* replaced use of image url with attachment ID where possible to lift some heavy loads | |
| 151 | +* fix for image names including dimensions (e.g., 300x250) | |
| 152 | +* works with version 2.4.0 of Gutenberg plugin | |
| 153 | +* place overlay correctly even when page continues to shift after being loaded | |
| 154 | +* load public JavaScript in footer by default | |
| 155 | +* prevent saving ISC post meta information on non-public post types | |
| 156 | + | |
| 157 | += 1.8.11.2 = | |
| 158 | + | |
| 159 | +* fixed align value not being understood correctly | |
| 160 | + | |
| 161 | += 1.8.11.1 = | |
| 162 | + | |
| 163 | +* fixed missing index issue | |
| 164 | +* call parent class in admin class constructor | |
| 165 | + | |
| 166 | += 1.8.11 = | |
| 167 | + | |
| 168 | +* cleanup | |
| 169 | +* removed log spam introduced with 1.8.10 | |
| 170 | +* prevent SQL injection through crafted img src attributes | |
| 171 | + | |
| 172 | += 1.8.10.1 = | |
| 173 | + | |
| 174 | +* hotfix for php below 5.3 | |
| 175 | + | |
| 176 | += 1.8.10 = | |
| 177 | + | |
| 178 | +* don’t list images attached to non-public posts in the full image list, when only visible images should be displayed, thanks to heiglandreas | |
| 179 | +* added fallback to read images from galleries | |
| 180 | +* added `isc_get_image_by_url_query` filter | |
| 181 | +* fixed image list being empty due to autosave | |
| 182 | +* read src from attribute according to dom documentation, thanks to heiglandreas | |
| 183 | +* tested with WordPress 4.4 beta 4 | |
| 184 | + | |
| 185 | += 1.8.9 = | |
| 186 | + | |
| 187 | +* rather use than error-log query | |
| 188 | + | |
| 189 | += 1.8.8 = | |
| 190 | + | |
| 191 | +* search for image urls regardless of their used protocol (http or https) | |
| 192 | + | |
| 193 | += 1.8.6 | 1.8.7 = | |
| 194 | + | |
| 195 | +* removed duplicate post links on full source list | |
| 196 | + | |
| 197 | += 1.8.5 = | |
| 198 | + | |
| 199 | +* fixed deprecated sanitize_url() | |
| 200 | + | |
| 201 | += 1.8.4 = | |
| 202 | + | |
| 203 | +* [feature] added option to display all images in the full list, not just those visible in posts | |
| 204 | +* [fixed] default author text not showing up | |
| 205 | + | |
| 206 | += 1.8.3 = | |
| 207 | + | |
| 208 | +* [fixed] saving pre text for source overlay, thanks to maler.whick | |
| 209 | + | |
| 210 | += 1.8.2 = | |
| 211 | + | |
| 212 | +* [feature] show image sources for changed images | |
| 213 | +* [feature] show image sources for images with query parameters | |
| 214 | + | |
| 215 | += 1.8.1 = | |
| 216 | + | |
| 217 | +* [fixed] set default value for new option to prevent error message | |
| 218 | + | |
| 219 | += 1.8 = | |
| 220 | + | |
| 221 | +* [feature] display image sources on archive pages (see settings) | |
| 222 | +* [feature] use `isc_thumbnail_source()` to display thumbnail source in templates | |
| 223 | +* [feature] added image sources for galleries and other shortcodes | |
| 224 | +* updated German translation | |
| 225 | + | |
| 226 | += 1.7.3 = | |
| 227 | + | |
| 228 | +* [fixed] bug on ajax calls preventing the source fields to show up on ajax called pages in the dashboard | |
| 229 | +* [fixed] bug on multisite update | |
| 230 | +* [optimized] don’t hide setting boxes | |
| 231 | +* [optimized] finished moving all publically needed function to its own class | |
| 232 | + | |
| 233 | += 1.7.2 = | |
| 234 | + | |
| 235 | +* [fixed] error message shown when list type settings was empty or unsaved | |
| 236 | +* [fixed] source overlay showing if no image source was set for it | |
| 237 | +* [optimized] trim source input | |
| 238 | + | |
| 239 | += 1.7.1 = | |
| 240 | + | |
| 241 | +* [fixed] source list function referring to the wrong plugin class | |
| 242 | + | |
| 243 | += 1.7.0 = | |
| 244 | + | |
| 245 | +* [optimized] manage different source display types on top of settings page | |
| 246 | +* [optimized] renamed settings page to "Image Sources" | |
| 247 | +* [removed] hiding source list elements in the frontend is no longer possible | |
| 248 | +* [fixed] show source list not only below posts, but every other post type | |
| 249 | +* [fixed] removed screenshots from main plugin files | |
