7 |
8 | **django-cropduster** is a project that makes a form field available that
9 | uses the [Jcrop jQuery plugin](https://github.com/tapmodo/Jcrop). It is a drop-in
10 | replacement for django's `ImageField` and allows users to generate multiple crops
11 | from images, using predefined sizes and aspect ratios. **django-cropduster**
12 | was created by developers at [The Atlantic](http://www.theatlantic.com/). It
13 | is compatible with python 2.7 and 3.4, and Django versions 1.4 - 1.8.
14 |
15 | * [Installation](#installation)
16 | * [Configuration](#configuration)
17 | * [Documentation & Examples](#documentation--examples)
18 | * [License](#license)
19 |
20 | Installation
21 | ------------
22 |
23 | The recommended way to install django-cropduster is from [PyPI](https://pypi.python.org/pypi/django-cropduster):
24 |
25 | pip install django-cropduster
26 |
27 | Alternatively, one can install a development copy of django-cropduster from
28 | source:
29 |
30 | pip install -e git+git://github.com/theatlantic/django-cropduster.git#egg=django-cropduster
31 |
32 | If the source is already checked out, use setuptools:
33 |
34 | python setup.py develop
35 |
36 | Configuration
37 | -------------
38 |
39 | To enable django-cropduster, `"cropduster"` must be added to `INSTALLED_APPS`
40 | in settings.py and you must include `cropduster.urls` in your django
41 | urlpatterns.
42 |
43 | ```python
44 | # settings.py
45 |
46 | INSTALLED_APPS = (
47 | # ...
48 | 'cropduster',
49 | )
50 |
51 | # urls.py
52 |
53 | urlpatterns = patterns('',
54 | # ...
55 | url(r'^cropduster/', include('cropduster.urls')),
56 | )
57 | ```
58 |
59 | Documentation & Examples
60 | ------------------------
61 |
62 | class Size(name, [label=None, w=None, h=None, auto=None,
63 | min_w=None, min_h=None, max_w=None, max_h=None, required=True])
64 |
65 | Use `Size` to define your crops. The `auto` parameter can be set to a list of
66 | other `Size` objects that will be automatically generated based on the
67 | user-selected crop of the parent `Size`.
68 |
69 | `CropDusterField` accepts the same arguments as Django's built-in `ImageField`
70 | but with an additional `sizes` keyword argument, which accepts a list of
71 | `Size` objects.
72 |
73 | An example models.py:
74 |
75 | ```python
76 | from cropduster.models import CropDusterField, Size
77 |
78 | class ExampleModel(models.Model):
79 | MODEL_SIZES = [
80 | # array of Size objects for initial crop
81 | Size("large", w=210, auto=[
82 | # array of Size objects auto cropped based on container Size
83 | Size('larger', w=768),
84 | Size('medium', w=85, h=113),
85 | # more sub Size objects ...
86 | ]),
87 | # more initial crop Size objects ...
88 | ]
89 |
90 | image = CropDusterField(upload_to="your/path/goes/here", sizes=MODEL_SIZES)
91 | ```
92 |
93 | To get a dictionary containing information about an image within a template,
94 | use the `get_crop` templatetag:
95 |
96 | ```django
97 | {% load cropduster_tags %}
98 |
99 | {% get_crop obj.image 'large' exact_size=1 as img %}
100 |
101 | {% if img %}
102 | 138 | """ % image_url) 139 | 140 | def test_dialog_change_width(self): 141 | """ 142 | Test that changing the width in the cropduster CKEDITOR dialog produces 143 | an image and html with the correct dimensions 144 | """ 145 | self.load_admin(StandaloneArticle) 146 | 147 | with self.open_cropduster_ckeditor_dialog(): 148 | with self.visible_selector('#id_image') as el: 149 | el.send_keys(os.path.join(self.TEST_IMG_DIR, 'img.png')) 150 | with self.clickable_selector('#upload-button') as el: 151 | el.click() 152 | time.sleep(1) 153 | with self.clickable_selector('#id_size-width') as el: 154 | el.send_keys(300) 155 | 156 | self.toggle_caption_checkbox() 157 | self.cropduster_ckeditor_ok() 158 | 159 | if self.is_s3: 160 | time.sleep(5) 161 | 162 | content_html = self.selenium.execute_script('return $("#id_content").val()') 163 | 164 | img_src_matches = re.search(r' src="([^"]+)"', content_html) 165 | self.assertIsNotNone(img_src_matches, "Image not found in content: %s" % content_html) 166 | image_url = img_src_matches.group(1) 167 | image_hash = re.search(r'img/([0-9a-f]+)\.png', image_url).group(1) 168 | 169 | try: 170 | image = Image.objects.get(image='ckeditor/img/original.png') 171 | except Image.DoesNotExist: 172 | raise AssertionError("Image not found in database") 173 | 174 | try: 175 | thumb = Thumb.objects.get(name=image_hash, image=image) 176 | except Thumb.DoesNotExist: 177 | raise AssertionError("Thumb not found in database") 178 | 179 | self.assertEqual( 180 | list(Thumb.objects.all()), [thumb], 181 | "Exactly one Thumb object should have been created") 182 | 183 | with default_storage.open("ckeditor/img/%s.png" % image_hash, mode='rb') as f: 184 | self.assertEqual(PIL.Image.open(f).size, (300, 356)) 185 | 186 | self.assertHTMLEqual( 187 | content_html, 188 | """ 189 |
194 | """ % image_url) 195 | -------------------------------------------------------------------------------- /tests/templates/404.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 |