mirror of
https://github.com/searxng/searxng.git
synced 2026-09-23 14:46:04 +00:00
280aceb1ae
Engines like Pexels provide images that one would more likely expect in a category named ``stock_images``. By classifying engines like Pexels more precisely, we enable a more specific handling of them, which also helps to avoid mixing them with the more general image search on the internet. [1] We leave these engines *enabled* by default, take them out of ``images`` and move them into the specialization ``stock_images``. This makes it possible, on the one hand, for the admin to configure a tab in the UI, and on the other hand, the user can always select the group directly using the search syntax ``!stock_images ...``. What we need to keep in mind: 1. Technically speaking, there are no subcategories in the strict sense. Organizationally, the *subcategories* are derived from the `categories_as_tabs`. 2. From an admin’s perspective, `categories_as_tabs` is the tool for structuring their content. 3. In the context of “enabled/disabled by default”: We should avoid having the admin have to activate many individual engines when they want to structure their content (UI tabs). So if we leave an engine enabled by default and **move** it from `images` to a new category, the admin only needs to add the new category to `categories_as_tabs` to restructure their content. If the new category is also part of the translations (see `searx/searxng.msg` in this PR), this UI structure would also be available internationally. [1] https://github.com/searxng/searxng/pull/6690#issuecomment-5646291679 Signed-off-by: Markus Heiser <markus.heiser@darmarit.de>
96 lines
2.4 KiB
Python
96 lines
2.4 KiB
Python
# SPDX-License-Identifier: AGPL-3.0-or-later
|
|
"""
|
|
Flickr (Images)
|
|
|
|
More info on api-key : https://www.flickr.com/services/apps/create/
|
|
"""
|
|
|
|
from json import loads
|
|
from urllib.parse import urlencode
|
|
|
|
# about
|
|
about = {
|
|
"website": 'https://www.flickr.com',
|
|
"wikidata_id": 'Q103204',
|
|
"official_api_documentation": 'https://secure.flickr.com/services/api/flickr.photos.search.html',
|
|
"use_official_api": True,
|
|
"require_api_key": True,
|
|
"results": 'JSON',
|
|
}
|
|
|
|
categories = ["stock_images"]
|
|
|
|
page_size = 15
|
|
paging = True
|
|
api_key = None
|
|
|
|
|
|
url = (
|
|
'https://api.flickr.com/services/rest/?method=flickr.photos.search'
|
|
+ '&api_key={api_key}&{text}&sort=relevance'
|
|
+ '&extras=description%2C+owner_name%2C+url_o%2C+url_n%2C+url_z'
|
|
+ '&per_page={page_size}&format=json&nojsoncallback=1&page={page}'
|
|
)
|
|
photo_url = 'https://www.flickr.com/photos/{userid}/{photoid}'
|
|
|
|
paging = True
|
|
|
|
|
|
def build_flickr_url(user_id, photo_id):
|
|
return photo_url.format(userid=user_id, photoid=photo_id)
|
|
|
|
|
|
def request(query, params):
|
|
params['url'] = url.format(
|
|
text=urlencode({'text': query}), api_key=api_key, page_size=page_size, page=params['pageno']
|
|
)
|
|
return params
|
|
|
|
|
|
def response(resp):
|
|
results = []
|
|
|
|
search_results = loads(resp.text)
|
|
|
|
# return empty array if there are no results
|
|
if 'photos' not in search_results:
|
|
return []
|
|
|
|
if 'photo' not in search_results['photos']:
|
|
return []
|
|
|
|
photos = search_results['photos']['photo']
|
|
|
|
# parse results
|
|
for photo in photos:
|
|
if 'url_o' in photo:
|
|
img_src = photo['url_o']
|
|
elif 'url_z' in photo:
|
|
img_src = photo['url_z']
|
|
else:
|
|
continue
|
|
|
|
# For a bigger thumbnail, keep only the url_z, not the url_n
|
|
if 'url_n' in photo:
|
|
thumbnail_src = photo['url_n']
|
|
elif 'url_z' in photo:
|
|
thumbnail_src = photo['url_z']
|
|
else:
|
|
thumbnail_src = img_src
|
|
|
|
# append result
|
|
results.append(
|
|
{
|
|
'url': build_flickr_url(photo['owner'], photo['id']),
|
|
'title': photo['title'],
|
|
'img_src': img_src,
|
|
'thumbnail_src': thumbnail_src,
|
|
'content': photo['description']['_content'],
|
|
'author': photo['ownername'],
|
|
'template': 'images.html',
|
|
}
|
|
)
|
|
|
|
# return results
|
|
return results
|