-
Notifications
You must be signed in to change notification settings - Fork 4
/
Copy pathreadme.txt
121 lines (95 loc) · 5.32 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
=== Easy search and use CC-licensed images for WP ===
Contributors: lenasterg, nts on cti.gr, sch.gr
Donate link:
Tags: cc, creative commons, media library, free image, free photo, multisite
Requires at least: 4.6
Tested up to: 6.1
Stable tag: 3.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Easy search and use CC-licensed images for WP helps you search millions of CC-licensed images without leaving WordPress editor and use one into your post content or set as featured image very quickly.
== Description ==
Easy search and use CC-licensed images for WP helps you search millions of free photos using the [Openverse API](https://api.openverse.engineering/v1/) and insert the original image into your content or set as featured image very quickly.
It allows the user to filter the provider source.
The plugin is inspired and based on the [CCSearch] (https://ccsearch.creativecommons.org/) and it wouldnt't be possible without the [Openverse API](https://api.openverse.engineering/v1/) and until version 2.0 the [Creative Commons Catalog API](https://api.creativecommons.engineering).
After the plugin's activation, you can see the "Image with CC License" button above the editor and as option into the "Add Media" pop-up window.
By pressing it you can search using Latin characters for an image, browse the returned images, preview an image and its license and adjust the image settings:
- use of thumbnail or original image,
- set the image link (if any).
- Insert the image into the post or as featured image.
= Features =
- Works in WordPress editor and add a button above the content text area and into the “Add Media” pop-up window.
- Via a pop-up window, allows searching through millions of images using Creative Commons Catalog API power.
- Allows filtering by a provider
- Paginated results
- Quick insert original image or thumbnail with an (optional) link to the image URL or the original site
- Use image as a featured image for the blog post
- WPML compatible
- Multisite compatible
- Translation ready (it’s already translated in Greek)
- Tested up to WordPress 5.9 with Classic Editor plugin
You can find a blog post in [opensource.creativecommons.org](https://opensource.creativecommons.org/blog/entries/2019-07-24-cc-search-wp-plugin/) about the inspiration and how it works.
NOTE 1: Please, verify the license at the source. Creative Commons does not host the content and does not verify that the content is properly CC-licensed or that the attribution information is accurate or complete.
Please follow the link to the source of the content to independently verify before reuse.
NOTE 2: Currently, the plugin needs [Classic Editor](https://wordpress.org/plugins/classic-editor/) in order to work for WP 5+.
= Roadmap =
- Multiple images select support
- Gutenberg compatibility
- Multiselect options for filtering: providers
- select options for filtering: licenses, creator
- Image for the 'Image with CC license' editor button
- Info page
= Credits =
- The plugin is inspired and based on the [CC Search] (https://ccsearch.creativecommons.org/) and since version 2.0 wouldnt't be possible without the [Creative Commons Catalog API] (https://api.creativecommons.engineering/)
- The plugin since version 3.0 uses the [openverse API] (https://api.openverse.engineering/v1/)
- The plugin's code is based on the [WP Pexels] (https://wordpress.org/plugins/wp-pexels/) code by WPclever.net
- Pointer's code is based on [https://code.tutsplus.com/articles/integrating-with-wordpress-ui-admin-pointers--wp-26853] (https://code.tutsplus.com/articles/integrating-with-wordpress-ui-admin-pointers--wp-26853)
- Many thanks to [Stavroula Stasinou](https://www.linkedin.com/in/stavroulastas/) for the free creation of header image and plugin icon.
== Installation ==
1. Unzip the ls-wp-ccsearch.zip
2. Copy ls-wp-ccsearch folder to wp-content/plugins
3. Go to Plugins > Installed Plugins, find Easy search and use CC-licensed images for WP and click Active
4. Now when you create/edit the post, you can see the "Image with CC License" button above the editor and as option into the "Add Media" pop-up window.
5. Enjoy!
== Screenshots ==
1. The "Image with CC license" button on editor
2. Search for an image
3. Preview of an image and its license.
4. Image settings: use of thumbnail or original image, set the image link (if any). Insert the image into the post or as featured image.
5. The image and it's license into the editor
6. The published post with the image.
== Changelog ==
= 3.2 =
* Fix bug when image was set as post thumbnail. Props to @gnr5 for spotting the bug
* Display images sources sorted by name
* WordPress 6.1 compatibility
= 3.1 =
* Minor changes
= 3.0 =
* Changes to use openverse API urls
= 2.0 =
* Changes at creativecommons API urls
* Support also non -latin keywords
= 1.0 =
* Replaces curl with WordPress native functionality
* Fix some typos
* Sanitize input
* Renamed from WP CCsearch to Easy search and use CC-licensed images for WP
= 0.5.0 =
* Add class to img
* Larger colorbox height
* New strings added
* New screenshots
= 0.4.0 =
* Add wp-pointer on editor's button
* Fix: Wrong textdomain
* Removed unused code
* New strings added
= 0.3.0 =
* Add provider dropdown select
* Fix: Use full image when thumbnail url is broken
= 0.2.0 =
* Fix ls-wp-ccsearch.pot
* Greek translation added
= 0.1.0 =
* Released