Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/candylabshq/wagtail-opengraph-image-generator
Wagtail Open Graph Image Generator will assist you in automatically creating Open Graph images for your pages.
https://github.com/candylabshq/wagtail-opengraph-image-generator
opengraph seo-tools wagtail wagtail-plugin
Last synced: 3 months ago
JSON representation
Wagtail Open Graph Image Generator will assist you in automatically creating Open Graph images for your pages.
- Host: GitHub
- URL: https://github.com/candylabshq/wagtail-opengraph-image-generator
- Owner: candylabshq
- License: mit
- Created: 2019-12-20T10:24:55.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2023-10-04T01:49:58.000Z (over 1 year ago)
- Last Synced: 2024-10-01T22:09:53.058Z (3 months ago)
- Topics: opengraph, seo-tools, wagtail, wagtail-plugin
- Language: Python
- Homepage:
- Size: 1.19 MB
- Stars: 40
- Watchers: 3
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-wagtail - wagtail-opengraph-image-generator - Assists you in automatically creating Open Graph images for your Wagtail pages. (Apps / SEO and SMO)
README
# wagtail-opengraph-image-generator
Wagtail Open Graph Image Generator will assist you in automatically creating [Open Graph](https://ogp.me/) images for your pages.
There are a handful of configuration options to popuplate images with your page's content.
Besides the title, there are options to provide a static company logo, subtitle, background image and page logo in the SVG format. While the resulting image will be a little bit opinionated, the defaults should work just fine in most cases.
The final image will be saved in the PNG format in a configurable Wagtail collection. It then can be used in your templates and code.
## Features
* Automatic creation of Open Graph protocol compatible images
* Live preview and configuration in a seperate tab in the Edit and Create views
* Several dynamic fields that can be configured to supply content for your generated image
## Requirements
* Python 3.7+
* Wagtail 4
* Django 3.0+
* `wagtail.contrib.settings` in `INSTALLED_APPS`
_Other versions might work but have not been tested._
## Installation
Install with pip:
`pip install wagtail-opengraph-image-generator`
Add `wagtail_opengraph_image_generator` to your `INSTALLED_APPS`
Finally, apply the migrations with `python manage.py migrate`
## Usage
Once the addon is installed, you will notice a new tab in your edit/create view.
This new panel will allow you to preview your new Open Graph image before you save it.
Depending on your exact configuration this panel will provide slightly different options and customizations.
### Embedding in your template
Accessing the generated image is done with an image tag. Make sure to load it in your template and call `get_existing_og_image [page-object]` to save the image in a variable. You can then use it as any other Wagtail image.
```
{% load wagtail_opengraph_image_generator_tags %}
{% get_existing_og_image self as og_image %}
{% if og_image %}
{% image og_image original as og_image %}
{% endif %}
```
## Examples
A basic example with a default background image, company logo and subtitle might look like this:
A more advanced example with additional background and page logo fields might look like this:
## Documentation
For more information on getting started, an overview of all available settings and release notes, please see [our documentation on Read the Docs](https://wagtail-opengraph-image-generator.readthedocs.io/en/latest/).
## Support
Feel free to open issues and, even better, pull requests!
The development of this plugin is supported by [candylabs GmbH](https://go.candylabs.de/aqPw)
If you need commerical support developing a Wagtail site, Django application, MVP or digital platform, we'd love to hear from you at [[email protected]](mailto:[email protected])!
