First attempt at abstracting assets.

RE #39

icekit/assets/__init__.py

@@ -0,0 +1 @@
+default_app_config = '%s.apps.AppConfig' % __name__

icekit/assets/apps.py

@@ -0,0 +1,8 @@
+from __future__ import unicode_literals
+
+from django.apps import AppConfig
+
+
+class AppConfig(AppConfig):
+    name = '.'.join(__name__.split('.')[:-1])  # Name of package where `apps` module is located
+

icekit/assets/migrations/0001_initial.py

@@ -0,0 +1,29 @@
+# -*- coding: utf-8 -*-
+from __future__ import unicode_literals
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('contenttypes', '0002_remove_content_type_name'),
+        ('icekit', '0006_auto_20150911_0744'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='Asset',
+            fields=[
+                ('id', models.AutoField(verbose_name='ID', serialize=False, auto_created=True, primary_key=True)),
+                ('title', models.CharField(help_text='The title is shown in the "title" attribute', max_length=255, blank=True)),
+                ('caption', models.TextField(blank=True)),
+                ('admin_notes', models.TextField(help_text='Internal notes for administrators only.', blank=True)),
+                ('categories', models.ManyToManyField(related_name='assets_asset_related', to='icekit.MediaCategory', blank=True)),
+                ('polymorphic_ctype', models.ForeignKey(related_name='polymorphic_assets.asset_set+', editable=False, to='contenttypes.ContentType', null=True)),
+            ],
+            options={
+                'abstract': False,
+            },
+        ),
+    ]

icekit/assets/models.py

@@ -0,0 +1,53 @@
+from __future__ import unicode_literals
+
+import six
+from django.db import models
+from django.utils.translation import ugettext_lazy as _
+from fluent_contents.models import ContentItem
+from polymorphic import PolymorphicModel
+
+
+class Asset(PolymorphicModel):
+    """
+    A static asset available for use on a CMS page.
+    """
+    title = models.CharField(
+        max_length=255,
+        blank=True,
+        help_text=_('The title is shown in the "title" attribute'),
+    )
+    caption = models.TextField(
+        blank=True,
+    )
+    categories = models.ManyToManyField(
+        'icekit.MediaCategory',
+        blank=True,
+        related_name='%(app_label)s_%(class)s_related',
+    )
+    admin_notes = models.TextField(
+        blank=True,
+        help_text=_('Internal notes for administrators only.'),
+    )
+
+    def get_uses(self):
+        return [item.parent.get_absolute_url() for item in self.assetitem_set().all()]
+
+    def __str__(self):
+        return self.title
+
+
+class AssetItem(ContentItem):
+    """
+    Concrete uses of an Asset.
+    """
+    asset = models.ForeignKey(
+        'icekit.assets.models.Asset',
+    )
+
+    class Meta:
+        abstract = True
+        verbose_name = _('Asset Item')
+        verbose_name_plural = _('Asset Items')
+
+    def __str__(self):
+        return six.text_type(self.asset)

icekit/tests/settings.py

@@ -43,6 +43,7 @@
     'fluent_pages.pagetypes.fluentpage',
     'haystack',
     'icekit',
+    'icekit.assets',
     'icekit.page_types.article',
     'icekit.page_types.layout_page',
     'icekit.page_types.search_page',