https://github.com/torchbox/wagtail-makeup

Wagtail plugin to replace all your broken local images with unsplash ones
https://github.com/torchbox/wagtail-makeup

images local wagtail wagtail-plugin webdevelopment

Last synced: about 2 months ago
JSON representation

Wagtail plugin to replace all your broken local images with unsplash ones

• Host: GitHub
• URL: https://github.com/torchbox/wagtail-makeup
• Owner: torchbox
• License: mit
• Created: 2020-12-10T22:10:04.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2024-03-11T10:19:05.000Z (6 months ago)
• Last Synced: 2024-05-21T13:51:27.761Z (4 months ago)
• Topics: images, local, wagtail, wagtail-plugin, webdevelopment
• Language: Python
• Homepage:
• Size: 43.9 KB
• Stars: 5
• Watchers: 4
• Forks: 3
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: docs/CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-wagtail - Wagtail Makeup - A plugin that replaces all your images with [Unsplash](https://unsplash.com/) images. (Apps / Media)

README

        
# Wagtail Makeup

![tests](https://github.com/kevinhowbrook/wagtail-makeup/workflows/Tests/badge.svg)

[![codecov](https://codecov.io/gh/kevinhowbrook/wagtail-makeup/branch/main/graph/badge.svg?token=A4H7PFEL9J)](https://codecov.io/gh/kevinhowbrook/wagtail-makeup)

Tired of having no images locally when you need them? Don't want to fill your computer up with images?

Use Wagtail Makeup ;)

## Installation

Wagtail makeup depends on python unsplash:

```bash

pip install python-unsplash wagtailmakeup

```

## Configuration

Sign up for an Unsplash api key and add this to your settings:

```python

# settings.py

WAGTAIL_UNSPLASH = {

    "CLIENT_ID": "",

    "CLIENT_SECRET": ""

}

```

The API is rate limited to 50 request/hour... you can apply for a [higher rate limit](https://help.unsplash.com/en/articles/3887917-when-should-i-apply-for-a-higher-rate-limit).

## Using

You probably don't want this in your production settings, so add the following to you local.py settings:

```python

INSTALLED_APPS.append('wagtailmakeup')

```

Wagtail Makeup works by providing a new management command:

```bash

python manage.py make_up [search query] [amount of images]

```

So you want to replace all your broken images on your site with dogs (who wouldn't)

you can do it like this:

```python

python manage.py make_up dogs 10

```

Note: the amount value is the number of images to download, the higher this is, the more variance you will get 😎

## Contributing

Contributions are welcome, please see our [contributing guide](docs/CONTRIBUTING.md) for more details.