569

Product support

Get help in the plugin support forum.

  • Added on Apr 7, 2021
  • Current version: 2.2.4
  • Compatibility
    October CMS v3.x not tested
    October CMS v2.x use latest
    October CMS v1.x use latest
  • Created by

Categories

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.


Buymeacoffee.com

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.

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).