CMS improvements
[snf-cloudcms] / cloudcms / models.py
1 # Copyright 2012 GRNET S.A. All rights reserved.
2 #
3 # Redistribution and use in source and binary forms, with or
4 # without modification, are permitted provided that the following
5 # conditions are met:
6 #
7 #   1. Redistributions of source code must retain the above
8 #      copyright notice, this list of conditions and the following
9 #      disclaimer.
10 #
11 #   2. Redistributions in binary form must reproduce the above
12 #      copyright notice, this list of conditions and the following
13 #      disclaimer in the documentation and/or other materials
14 #      provided with the distribution.
15 #
16 # THIS SOFTWARE IS PROVIDED BY GRNET S.A. ``AS IS'' AND ANY EXPRESS
17 # OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
18 # WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
19 # PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL GRNET S.A OR
20 # CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
21 # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
22 # LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
23 # USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
24 # AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25 # LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
26 # ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
27 # POSSIBILITY OF SUCH DAMAGE.
28 #
29 # The views and conclusions contained in the software and
30 # documentation are those of the authors and should not be
31 # interpreted as representing official policies, either expressed
32 # or implied, of GRNET S.A.
33
34 import datetime
35
36 from django.db import models
37 from django.conf import settings
38 from django.contrib.sites import models as sites_models
39 from django.utils.translation import ugettext_lazy as _, ugettext, ungettext
40 from django.core.cache import cache
41 from django.utils import simplejson
42
43 from feincms import translations
44 from feincms.module.medialibrary.fields import MediaFileForeignKey
45 from feincms.module.medialibrary.models import MediaFile
46
47
48 class Application(models.Model):
49     """
50     Application object refers to the application each cms is deployed for.
51
52     Each cms deployment should contain at least one application object linked
53     to the site object the cms is deployed for.
54
55     Enabling cloudcms.context_processors.application in CONTEXT_PROCESSROS setting
56     let you can access the application object throughout the html templates.
57     """
58
59     MESSAGE_TYPE_CHOICES = (
60         ('NM','No Message'),
61         ('success','Success'),
62         ('error','Error'),
63         ('warning','Warning'),
64         ('info','Info'),
65     )
66  
67
68     code = models.CharField('Identifier', max_length=100, null=False, blank=False,
69             help_text="Just a codename of the application, to be used in "\
70                     "several places where no free text is allowed"\
71                     "(e.g. urls, paths, etc)")
72     title = models.CharField(max_length=255, null=False, blank=False,
73             help_text="The title of the application")
74
75     logo = MediaFileForeignKey(MediaFile, blank=True, null=True)
76     favicon = MediaFileForeignKey(MediaFile, blank=True, null=True,
77             related_name="as_favicon")
78     site = models.ForeignKey(sites_models.Site)
79     app_url = models.URLField(help_text="The url of the application UI (not "\
80             "the cms)", verify_exists=False, blank=True, null=True)
81     accounts_url = models.CharField(max_length=255, default="/", blank=True,
82             null=True, help_text="Tha accounts login page")
83     index_url = models.CharField(max_length=255, default="/", blank=False,
84             null=False)
85     linked_in_username = models.CharField(max_length=255, blank=True)
86     twitter_username = models.CharField(max_length=255, blank=True)
87     facebook_username = models.CharField(max_length=255, blank=True)
88
89     show_twitter_feed_on_top = models.BooleanField(default=False)
90     extra_styles = models.TextField(default="", blank=True)
91
92     footer_top = models.TextField(default="", blank=True)
93     footer_bottom = models.TextField(default="", blank=True)
94
95     message_type = models.CharField(max_length=20, 
96                                     choices= MESSAGE_TYPE_CHOICES,
97                                     default = 'NM' )
98     custom_message = models.TextField(default="", blank=True)
99     
100     @classmethod
101     def current(cls):
102         return cls.objects.get(site__pk=settings.SITE_ID)
103
104     def __unicode__(self):
105         return self.title
106
107
108 # http://stackoverflow.com/a/2680060/114435
109 dthandler = lambda obj: obj.isoformat() if isinstance(obj, datetime.datetime) else None
110
111 class Client(models.Model):
112     """
113     Model which refers to a service/application client. Client model contains
114     multiple ClientVersionSource to identify it's version downloads.
115     """
116     uid = models.CharField(max_length=255)
117     name = models.CharField(max_length=255)
118
119     def get_sources(self):
120         sources = {}
121         from cloudcms.clients import ClientVersions
122         for s in self.clientversionsource_set.all():
123             sources[s.os] = {'type': s.source_type,
124                              'args': [s.link]}
125
126         return ClientVersions(sources, cache_backend=cache)
127
128     def to_json(self):
129         return simplejson.dumps(list(self.get_sources().get_latest_versions()),
130                 default=dthandler)
131
132     def get_default_os(self):
133         try:
134             return self.clientversionsource_set.filter(default=True)[0].os
135         except IndexError:
136             return self.clientversionsource_set.filter()[0].os
137
138     def __unicode__(self):
139         return self.name
140
141
142 class ClientVersionSource(models.Model):
143     """
144     Client version source. source_type choices should map to
145     cloudcms.clients.SOURCE_TYPES.
146     """
147
148     default = models.BooleanField(default=True)
149     source_type = models.CharField(max_length=60,
150             choices=(('link','Link'),
151                      ('direct','Direct'),
152                      ('redmine_files','Redmine files')))
153     os = models.CharField(max_length=255)
154     link = models.CharField(max_length=255)
155     logo = MediaFileForeignKey(MediaFile, blank=True, null=True)
156     architecture = models.CharField(max_length=255, null=True, blank=True,
157             help_text="""Depending the source type this can be left empty and
158             let source type identify the architecture""")
159     client = models.ForeignKey(Client)
160     version_regex = models.CharField(max_length=255, help_text="""Regular expression to
161             match the version of the file based on retrieved source filenames
162             (used in redmine source types)""", null=True, blank=True)
163     file_regex = models.CharField(max_length=255, help_text="""Return only files that
164             match this expression""", null=True, blank=True)
165
166     def __unicode__(self):
167         return "[%s] %s" % (self.get_source_type_display(), self.os)
168
169
170 # hook for feincms configuration, is this appropriate place ??? who knows
171 from cloudcms.cms import *
172
173 class Service(models.Model, translations.TranslatedObjectMixin):
174     """
175     Service.
176     """
177
178     ordering = models.SmallIntegerField(_('ordering'), default=0)
179     image_faq = MediaFileForeignKey(MediaFile, blank=True, null=True, related_name='image_faq')
180     image_userguide = MediaFileForeignKey(MediaFile, blank=True, null=True,related_name='image_userguide')
181     class_name = models.CharField(_('class name'), max_length=100, blank=True)
182     
183     
184     class Meta:
185         verbose_name = _('service')
186         verbose_name_plural = _('services')
187         ordering = ['-ordering',]
188
189     objects = translations.TranslatedObjectManager()
190
191     def get_first_question(self):
192         try:
193             return self.faqs.filter(is_active=True)[0]
194         except:
195             return None
196         
197     def get_first_entry(self):
198         try:
199             return self.userguideentries.filter(is_active=True)[0]
200         except:
201             return None
202         
203     def __unicode__(self):
204         trans = translations.TranslatedObjectMixin.__unicode__(self)
205         return trans or _('Unnamed category')
206
207
208 class ServiceTranslation(translations.Translation(Service)):
209     """
210     Service translation
211     """
212     title = models.CharField(_('service title'), max_length=100)
213     slug = models.SlugField(_('slug'), unique=True)
214     description = models.CharField(_('description'), max_length=250, blank=True)
215     cms_page = models.ForeignKey(Page, null=True, blank=True)
216     title_faq = models.CharField(_('service title (faq section)'), max_length=100, blank=True)
217     title_userguide = models.CharField(_('service title (userguide section)'), max_length=100, blank=True)
218     
219     class Meta:
220         verbose_name = _('service translation')
221         verbose_name_plural = _('service translations')
222         ordering = ['title']
223
224     def __unicode__(self):
225         return self.title
226
227     def save(self, *args, **kwargs):
228         if not self.slug:
229             self.slug = slugify(self.title)
230
231         super(ServiceTranslation, self).save(*args, **kwargs)
232