Metadata-Version: 2.1
Name: wagtail-snippet-image
Version: 0.1.2
Summary: Creating a snippet images on Wagtail for sharing for social media.
Home-page: https://github.com/acrius/wagtail-snippet-image
License: MIT
Author: acrius
Author-email: acrius@mail.ru
Requires-Python: >=3.5,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires-Dist: django-snippet-image (>=0.1.2,<0.2.0)
Requires-Dist: wagtail (>=2.5,<3.0)
Project-URL: Repository, https://github.com/acrius/wagtail-snippet-image
Description-Content-Type: text/x-rst

==============================
wagtail-snippet-image
==============================

Package for creating a snippet images for sharing in social networks and etc.
Based on django-snippet-image_ and snippet-image_.
But for storage of images used Wagtail Images_.

.. _django-snippet-image: https://github.com/acrius/django-snippet-image
.. _snippet-image: https://github.com/acrius/snippet-image
.. _Images: https://docs.wagtail.io/en/stable/advanced_topics/images/index.html

Installation
--------------------------

`pip3 install wagtail-snippet-image`

How use it
--------------------------

.. code-block:: python

    from django.db.models import (
        CharField,
        ForeignKey,
        SET_NULL,
        CASCADE,
    )
    from wagtail_snippet_image import SnippetImageField
    from wagtail.core.models import Page
    from wagtail.admin.edit_handlers import FieldPanel
    from wagtail.images.edit_handlers import ImageChooserPanel
    from modelcluster.fields import ParentalKey
    from modelcluster.contrib.taggit import ClusterTaggableManager
    from taggit.models import TaggedItemBase


    class PageTag(TaggedItemBase):
        content_object = ParentalKey(
            'home.HomePage',
            on_delete=CASCADE,
            related_name='tagged_items',
        )


    class Statuses:
        DRAFT = 'draft'
        PUBLISH = 'publish'

        CHOICES = (
            (DRAFT, 'Draft'),
            (PUBLISH, 'Publish'),
        )


    class HomePage(Page):
        background = ForeignKey(
            'wagtailimages.Image',
            verbose_name='Изображение для обложки',
            related_name='cover_images',
            on_delete=SET_NULL,
            blank=True,
            null=True,
        )

        snippet_image_field = SnippetImageField(
            verbose_name='Example snippet image field',
            null=True,
        )

        status = CharField(
            max_length=20,
            choices=Statuses.CHOICES,
            default=Statuses.DRAFT,
        )

        tags = ClusterTaggableManager(through=PageTag, blank=True)

        content_panels = Page.content_panels + [
            ImageChooserPanel('background'),
            ImageChooserPanel('snippet_image_field'),
            FieldPanel('status'),
            FieldPanel('tags'),
        ]

        def get_snippet_image_background(self, snippet_type):
            return self.background and self.background.file and self.background.file.path \
                if snippet_type == 'default' else None

        def get_snippet_image_center(self, snippet_type):
            return (self.background.focal_point_x, self.background.focal_point_y) \
                if snippet_type == 'default' and self.background \
                   and self.background.focal_point_x and self.background.focal_point_y \
                else None

        def get_snippet_image_text(self, snippet_type):
            return self.title if snippet_type == 'default' else None

        def snippet_image_should_be_created(self):
            return self.status == Statuses.PUBLISH

        # Wagtail custom methods for create wagtail images for sharing snippet image
        def get_snippet_image_title(self, snippet_type):
            return self.title if snippet_type == 'default' else None

        def get_snippet_image_tags(self, snippet_type):
            return self.tags.names() if snippet_type == 'default' else None


And use it in template:

.. code-block:: html

    <meta property="og:image" content="{{ image(page.snippet_image_field, 'original') }}" />


Read more in home_.

.. _home: https://github.com/acrius/wagtail-snippet-image

