October 3.0 updates!
Currently working on changes, because after upgrade to Laravel 9, there are changes in Http::get method, used for api calls to search endpoints. This changes will broke our plugin, then currently is plugin not working on version 3. Stay tuned to update.
Version 2 is out now!
See, how it works.
Are u sick from searching images, downloading and reuploading? Here is a light solution for creating all from one place.
Installation
For install this plugin you can use Plugin installation tool in octobercms backend, where type
SNiPI.UniqueMediaFinder
First steps
To allow search you need to create an applications in unsplash.com or pexels.com, where you can obtain api keys. This api keys is provided in plugin settings.
Search for stock photos in Unsplash or Pexels
For current most popular stock databases is used Unsplash and Pexels integration. Then you are able to obtain api keys for both and use both APIs for searching and downloading pictures.
Feature
This is currently quick extension, but i will provide more features for this, like informations, loading collections from current author, searching by multiple parameters like photo ortientation etc.
Bug reporting
Please, if you find some issues or have any ideas, please, provide feedback at snipi[at]snipi[dot]sk
Installation
For install this plugin you can use Plugin installation tool in octobercms backend, where type SNiPI.UniqueMediaFinder
Searching
This plugin creates new section in media library called Search providers (located after filters in left side). Each search provider is clickable, then when you navigate to provider, first click switches media browser to searching on selected provider. In first version of this plugin, search was performed over each provider, which creates unwanted requests, then, when you want to search on other providers, simply click to another provider. This will automatically call last search query, if is filled. When search query is empty, first load from provider contains latest or random pictures, regarding what provider offers.
Downloading
There are a two options how to download picture from search results. First, when you move cursor over preview, you can see two buttons. First is for show detailed informations, second for download. In details popup you can find button for download too, and this is second opinion how to download pictures. After successfull download, you are asked, if you want to navigate to folder, where photo was downloaded. If you cancel that confirmation, you can continue in browsing search results.
Metadata informations
When you wish to provide sourcing of photo, then probably you will get a simple way how to show that without copy+paste name or provider informations, right? When you allow to store metadata for downloaded files, then you can use component for showing media info, which belongs to specific file. Component is fully configurable and comes with simple styling for better looking "source". Part of stored data was search requests for dashboard widgets statistics.
Dashboard widgets
There are two main widgets. First, with providers limits and remaining api requests rate. Second is for statistics purpose, where you can see, what is most searched and which provider is most common used.
Known limitations
Many of limitations is based on specific provider. Please, see table bellow.
| Provider | Limit per hour | Limit per month |
|---|---|---|
| Unsplash | 50 (demo) 5000 (verified) | - |
| Pexels | 200 | 20000 |
| Pixabay | 5000 | - |
Unsplash verification
When u will get 5000 request per hour limit, you need to send your application for verification with screenshots, etc. Here i will probably talk more with unsplash api team, to get specific allowance for this plugin.
Pexels
You are able to send mail to api@pexels.com to get more rate limit.
Pixabay
Here is probably good way to get many photos, but, here is other limitation - maximum quality of image. In basic api requests you can get pictures with maximum 1280 px large size. For full HD images you need to send apply for full api access.
Installation
For install this plugin you can use Plugin installation tool in octobercms backend, where type
SNiPI.UniqueMediaFinder
First steps
To allow search you need to create an applications in unsplash.com or pexels.com, where you can obtain api keys. This api keys is provided in plugin settings.
Searching
To search, navigate to Media Library and look for icon with magnify glass. Click on icon opens modal window with input for search keyword. After hit "Search now" you get list of results. Each implementation has separated "tab" for results.
Dowloading
On search results are square previews. Move your cursor over, to show buttons. One (with eye) provide funcionality to show larger preview. One (with download icon) allows you to download current picture to your library.
Known limitations
Many of limitations is based on specific provider. Please, see table bellow.
| Provider | Limit per hour | Limit per month |
|---|---|---|
| Unsplash | 50 (demo) 5000 (verified) | - |
| Pexels | 200 | 20000 |
| Pixabay | 5000 | - |
Unsplash verification
When u will get 5000 request per hour limit, you need to send your application for verification with screenshots, etc. Here i will probably talk more with unsplash api team, to get specific allowance for this plugin.
Pexels
You are able to send mail to api@pexels.com to get more rate limit.
Pixabay
Here is probably good way to get many photos, but, here is other limitation - maximum quality of image. In basic api requests you can get pictures with maximum 1280 px large size. For full HD images you need to send apply for full api access.
-
This plugin has not been reviewed yet.
-
| 2.2.4 |
Removed exclamation marks from comments, because failed parsing in yaml.php May 12, 2022 |
|---|---|
| 2.2.3 |
Fixed yaml file because of A syntax error was detected in version.yaml May 12, 2022 |
| 2.2.2 |
Fix for "set filter" method from left sidebar May 03, 2022 |
| 2.2.1 |
Updated fix, changes in _body partial in core editor (removed upload-handler and created some unique id) May 03, 2022 |
| 2.2.0 |
Fix for upload images when plugin was not properly configured May 03, 2022 |
| 2.1.8 |
Fixed issue with reopenning popup inside froala editor, broken layout - https://octobercms.com/plugin/support/snipi-uniquemediafinder/weird-display-when-you-open-media-finder-several-times Mar 09, 2022 |
| 2.1.7 |
Removed annoying confirmation for reload downloaded picture Dec 06, 2021 |
| 2.1.6 |
added dropdown to select download quality for Pexels image Dec 06, 2021 |
| 2.1.5 |
Modified Metadata for promoting new plugin / MEMetadata Apr 30, 2021 |
| 2.1.4 |
Added requirement to RainLab.Translate to avoid error Apr 18, 2021 |
| 2.1.3 |
fix for $.of.flashMsg -> $.oc.confirm ... Apr 18, 2021 |
| 2.1.2 |
fix for default language / plural form of text Apr 18, 2021 |
| 2.1.1 |
Updated plugin name in composer.json Apr 18, 2021 |
| 2.1.0 |
!!! Check for existence OctoberCMS v2.0 (MediaLibrary is separated) - Update for handling media library for new "media" namespace classes - fix for "className" OctoberCMS flash message issues? Apr 18, 2021 |
| 2.0.15 |
pixabay X-RateLimit-Limit headers fix (strange when pexels and unsplash has Ratelimit and Pixabay RateLimit) Apr 11, 2021 |
| 2.0.14 |
fixed X-Ratelimit-Limit headers Apr 11, 2021 |
| 2.0.13 |
pixabay misstypo fix Apr 11, 2021 |
| 2.0.12 |
fixed pixabay download when not "FULL access" (missing configuration for largeImageURL instead of setting value) Apr 11, 2021 |
| 2.0.11 |
updated "about plugin" Apr 11, 2021 |
| 2.0.10 |
updated readme.md to reflect v.2 Apr 11, 2021 |
| 2.0.9 |
added component for snippet / Media Info with metadata Apr 11, 2021 |
| 2.0.8 |
removed unused partials Apr 11, 2021 |
| 2.0.7 |
fix on migration file, blocking uninstalling plugin Apr 11, 2021 |
| 2.0.6 |
fix for missing unsplash x-ratelimit-limit Apr 11, 2021 |
| 2.0.5 |
added binding for deleting folder (to remove all pictures from metadata storage) Apr 11, 2021 |
| 2.0.4 |
updated modals Apr 11, 2021 |
| 2.0.3 |
create_table_for_search_logging.php Apr 11, 2021 |
| 2.0.2 |
Created new features and widgets - Added widget for showing provider limits - Added widget for latest search queries Apr 11, 2021 |
| 2.0.1 |
create_table_for_database_storage.php Apr 11, 2021 |
| 2.0.0 |
!!! Refactoring whole plugin - complete refactoring - removed search button - created search providers in left sidebar in media library - fixed initialization when media library is called from RainLab.Pages or Blog in Popup - updated folder structure for better handling providers - created new features for searching with filters - updated detail informations popup - updated pagination - updated first loading for latest / random pictures from providers (for inspiration) Apr 11, 2021 |
| 1.2.1 |
added notation to list of pixbay photos (requested for accept api full access) Apr 08, 2021 |
| 1.2.0 |
added new provider / Pixabay Apr 08, 2021 |
| 1.1.3 |
Fixed provider in download button photo detail template Apr 08, 2021 |
| 1.1.2 |
Fixed typo in template Apr 08, 2021 |
| 1.1.1 |
fixed authorization on unsplash download request (401 response / Unauthorized) Apr 08, 2021 |
| 1.1.0 |
!!!Breaking updates Apr 07, 2021 |
| 1.0.5 |
Removed unused javascript code Apr 07, 2021 |
| 1.0.4 |
Added support for separated pagination Apr 07, 2021 |
| 1.0.3 |
Author code fix Apr 07, 2021 |
| 1.0.2 |
Updated slovak language Apr 07, 2021 |
| 1.0.1 |
Updated missing versions file Apr 07, 2021 |
| 1.0.0 |
!!!Initial plugin installation Apr 07, 2021 |
IMPORTANT NOTICE!
From version 1, to version 1.1.2 was changed authorization for downloading photos from unsplash, please update older plugin.
Version 2 and breaking changes
In version 2 i decide, to remove "seach" icon button and use whole search area to show search results. This allows me to use media library inside popup window too (known as media finder).