{ "info": { "author": "Robin van der Rijst - Fabrique", "author_email": "robinr@fabrique.nl", "bugtrack_url": null, "classifiers": [ "Environment :: Web Environment", "Framework :: Django", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Topic :: Software Development :: Libraries :: Application Frameworks", "Topic :: Software Development :: Libraries :: Python Modules" ], "description": "=======================\nWagtail Easy Thumbnails\n=======================\n\nA simple django app that allows you to use `easy_thumbnails`__ with the images from `Wagtail`__,\nincluding the focal point that you can define on images in Wagtail.\n\n__ https://github.com/SmileyChris/easy-thumbnails\n__ https://wagtail.io/\n\nThis will allow you to use easy_thumbnail's features that the thumbnailer in Wagtail\ndoes not provide, such as JPEG quality control per image, forcing images to JPEG and\nthe powerful extension mechanism of custom processors.\n\nThis is not a drop-in replacement for the wagtail image tag. Rather, you will need use\nthe normal easy_thumbnail tag in combination with a filter and a processor to work nicely\nwith wagtail images.\n\n\nQuick start\n-----------\n1. Install ``wagtail_easy_thumbnails`` from Pypi::\n\n pip install wagtail_easy_thumbnails\n\n2. Add ``wagtail_easy_thumbnails`` to your ``INSTALLED_APPS`` setting like this::\n\n INSTALLED_APPS = (\n ...\n 'wagtail_easy_thumbnails',\n )\n\n\n3. Add the following filters to to your ``EASYTHUMBNAIL_PROCESSORS`` setting like this::\n\n THUMBNAIL_PROCESSORS = (\n # use this one instead of normal scale_and_crop\n 'wagtail_easy_thumbnails.processors.wagtail_scale_and_crop_with_focal_area',\n # 'easy_thumbnails.processors.scale_and_crop',\n ... other processors\n )\n\n4. Use in templates as follows::\n\n {% load thumbnail wagtail_thumbnail %}\n \"\"/\n\n \n\n {% thumbnail page.visual|wagtail_thumbnailer 300x100 crop zoom=100 as cropped_image %}\n \"\"/\n\n\n5. Use in code as follows::\n\n from easy_thumbnails.files import get_thumbnailer\n\n ...\n\n properties = {\n 'size': ...,\n 'crop': True,\n 'zoom': 100,\n }\n # image is the wagtail image (or subclass) instance\n wrapped_image = WagtailThumbnailerImageFieldFile(wagtail_image=image)\n\n # thumbnailer has the same properties as the template tag result, so .url, .width, etc.\n thumnailer = get_thumbnailer(wrapped_image).get_thumbnail(properties)\n\n\n\nThumbnail options\n-----------------\n\nThe following options can be used to create the thumbnails. Also see the `Easy Thumbnails documentation`__ for all thumbnailing options.\n\n__ http://easy-thumbnails.readthedocs.io/en/latest/index.html\n\n\n``size`` is a required option, and defines the bounds that the generated image\nmust fit within. If one of either width or height is 0, the ratio of the original\nimage is used to determine the resulting width or height, respectively.\n\nOther options are only provided if the given functionality is required:\n\n- ``crop`` required to make the processor do anything. If not given, the normal ``scale_and_crop`` processor is used. Options for crop are not supported for this processor.\n- ``zoom=`` where N is an integer between 0 and 100 specifying how close to the focal area the image is cropped. Default is 0, meaning as close to the outer image boundaries as possible, 100 means as close to the focal area as possible.\n- ``upscale`` if given and the resulting image is smaller that the requested size, the image is upscaled.\n\nIf the wagtail image does not have a focal area defined, the normal ``scale_and_crop`` processor\nis used to generate the thumbnail.\n\n\nSettings\n--------\nThe following settings can be set to override the defaults. Also see the `Easy Thumbnails documentation`__\nfor all thumbnail settings.\n\n__ http://easy-thumbnails.readthedocs.io/en/latest/ref/settings/\n\n- ``WAGTAIL_FOCAL_AREA_IMAGE_DEBUG``: Defaults to ``False``. If set to ``True``, the focal area is drawn on the resulting image (useful for debugging).\n- ``WAGTAIL_THUMBNAIL_ALWAYS_RECREATE`` Defaults to ``False``. If set to ``True``, the thumbnails are always regenerated, regardless of cached versions (useful for debugging)\n\n\nChanges\n-------\n\n0.3 (2017-11-27)\n\n- Fixed division by zero error in exceptional situations (thanks to lucasmoeskops)\n\n0.2 (2017-03-15)\n\n- Fixed github link in setup.py (thanks to reduxionist)\n- Fixed a bug where too much zoom was applied when focal area was smaller than target size\n- Some code cleanup\n\nLicense\n-------\nThis software is released under the MIT License, see LICENSE.\n\n\n", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/fabrique/wagtail-easy-thumbnails", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "wagtail-easy-thumbnails", "package_url": "https://pypi.org/project/wagtail-easy-thumbnails/", "platform": "", "project_url": "https://pypi.org/project/wagtail-easy-thumbnails/", "project_urls": { "Homepage": "https://github.com/fabrique/wagtail-easy-thumbnails" }, "release_url": "https://pypi.org/project/wagtail-easy-thumbnails/0.3/", "requires_dist": [ "easy-thumbnails (>=2.3)", "wagtail (>=1.5)" ], "requires_python": "", "summary": "Use easy_thumbnails with Django Wagtail images", "version": "0.3" }, "last_serial": 3367776, "releases": { "0.1": [ { "comment_text": "", "digests": { "md5": "0dc8082e27c94ac709d8798c69528862", "sha256": "c2d2be218027efa9a0d90e8311a54963d395d1095262aa5005f422b8c4ff8f3c" }, "downloads": -1, "filename": "wagtail_easy_thumbnails-0.1-py3-none-any.whl", "has_sig": false, "md5_digest": "0dc8082e27c94ac709d8798c69528862", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 9895, "upload_time": "2016-10-13T11:28:50", "url": "https://files.pythonhosted.org/packages/a7/fc/f6d66e3e8337ed25293e0df0b30964f65fad28beeac2be804cff70008bde/wagtail_easy_thumbnails-0.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "5c3f5a9761acf8e864a29220edf7f3d9", "sha256": "182f801b12a3f080acda25b1f0237279d191857c899e3fc155072c7368fad1c9" }, "downloads": -1, "filename": "wagtail-easy-thumbnails-0.1.tar.gz", "has_sig": false, "md5_digest": "5c3f5a9761acf8e864a29220edf7f3d9", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6790, "upload_time": "2016-10-13T11:28:52", "url": "https://files.pythonhosted.org/packages/a1/c0/b1e042982d306a5dc306e0af6e67867c048853481b761e3b16f84420a928/wagtail-easy-thumbnails-0.1.tar.gz" } ], "0.2": [ { "comment_text": "", "digests": { "md5": "4efbcc659468eed0f5ecb2867c496763", "sha256": "270436969a3061ac70d90efda39e995252bb1621685f30c63a6d7d612206ebcd" }, "downloads": -1, "filename": "wagtail-easy-thumbnails-0.2.tar.gz", "has_sig": false, "md5_digest": "4efbcc659468eed0f5ecb2867c496763", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6935, "upload_time": "2017-03-16T08:56:21", "url": "https://files.pythonhosted.org/packages/d5/53/58497690b63ba1b23e4c8c8e4e94f3ddf6627c18c5ff79cee6fc6c54c727/wagtail-easy-thumbnails-0.2.tar.gz" } ], "0.3": [ { "comment_text": "", "digests": { "md5": "1fd7a9fc0dec0a0f4efc3b51c4a38018", "sha256": "d54460d0fd2cd33c87659315e50bd48add7f89c140db981b93c606d47a2fdd43" }, "downloads": -1, "filename": "wagtail_easy_thumbnails-0.3-py3-none-any.whl", "has_sig": false, "md5_digest": "1fd7a9fc0dec0a0f4efc3b51c4a38018", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 10288, "upload_time": "2017-11-27T12:48:42", "url": "https://files.pythonhosted.org/packages/8d/51/3403ad794c6206de6c766759a8dad387a985eacbbe6a90edf563ee6da0c3/wagtail_easy_thumbnails-0.3-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "2c0a1ad11050bf10ed6c2be59185a769", "sha256": "85c29048bf39ad570ea6ed88a912882d9bf8fa3ccf2ac646adcde17a2f7f660f" }, "downloads": -1, "filename": "wagtail-easy-thumbnails-0.3.tar.gz", "has_sig": false, "md5_digest": "2c0a1ad11050bf10ed6c2be59185a769", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6987, "upload_time": "2017-11-27T12:48:43", "url": "https://files.pythonhosted.org/packages/0a/e9/5f5c7f342b5cc1510c2a41da51dea4d926036d9edc7cd0062df5c71734a0/wagtail-easy-thumbnails-0.3.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "1fd7a9fc0dec0a0f4efc3b51c4a38018", "sha256": "d54460d0fd2cd33c87659315e50bd48add7f89c140db981b93c606d47a2fdd43" }, "downloads": -1, "filename": "wagtail_easy_thumbnails-0.3-py3-none-any.whl", "has_sig": false, "md5_digest": "1fd7a9fc0dec0a0f4efc3b51c4a38018", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 10288, "upload_time": "2017-11-27T12:48:42", "url": "https://files.pythonhosted.org/packages/8d/51/3403ad794c6206de6c766759a8dad387a985eacbbe6a90edf563ee6da0c3/wagtail_easy_thumbnails-0.3-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "2c0a1ad11050bf10ed6c2be59185a769", "sha256": "85c29048bf39ad570ea6ed88a912882d9bf8fa3ccf2ac646adcde17a2f7f660f" }, "downloads": -1, "filename": "wagtail-easy-thumbnails-0.3.tar.gz", "has_sig": false, "md5_digest": "2c0a1ad11050bf10ed6c2be59185a769", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6987, "upload_time": "2017-11-27T12:48:43", "url": "https://files.pythonhosted.org/packages/0a/e9/5f5c7f342b5cc1510c2a41da51dea4d926036d9edc7cd0062df5c71734a0/wagtail-easy-thumbnails-0.3.tar.gz" } ] }