--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/app/soc/views/settings.py Sat Oct 18 05:11:37 2008 +0000
@@ -0,0 +1,182 @@
+#!/usr/bin/python2.5
+#
+# Copyright 2008 the Melange authors.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Home page settings views.
+
+edit: settings view for authorized Developers, Administrators, etc.
+"""
+
+__authors__ = [
+ '"Pawel Solyga" <pawel.solyga@gmail.com>',
+ '"Todd Larsen" <tlarsen@google.com>',
+ ]
+
+
+from google.appengine.api import users
+from google.appengine.ext import db
+
+from django import forms
+from django.utils.translation import ugettext_lazy
+
+from soc.logic import models
+from soc.logic import validate
+from soc.logic.models import document
+from soc.views import helper
+from soc.views.helper import access
+from soc.views.helper import decorators
+
+import soc.logic.models.home_settings
+import soc.models.document
+import soc.models.home_settings
+import soc.models.work
+import soc.views.helper.forms
+import soc.views.helper.responses
+import soc.views.helper.templates
+import soc.views.helper.widgets
+import soc.views.out_of_band
+
+
+class SettingsForm(helper.forms.DbModelForm):
+ """Django form displayed when creating or editing Settings.
+ """
+
+ class Meta:
+ """Inner Meta class that defines some behavior for the form.
+ """
+ #: db.Model subclass for which the form will gather information
+ model = soc.models.home_settings.HomeSettings
+
+ #: list of model fields which will *not* be gathered by the form
+ exclude = ['inheritance_line', 'home']
+
+ def clean_feed_url(self):
+ feed_url = self.cleaned_data.get('feed_url')
+
+ if feed_url == '':
+ # feed url not supplied (which is OK), so do not try to validate it
+ return None
+
+ if not validate.isFeedURLValid(feed_url):
+ raise forms.ValidationError('This URL is not a valid ATOM or RSS feed.')
+
+ return feed_url
+
+
+class DocSelectForm(helper.forms.DbModelForm):
+ """Django form displayed to select a Document.
+ """
+
+ # TODO(tlarsen): partial_path will be a hard-coded read-only
+ # field for some (most?) User Roles
+ partial_path = forms.CharField(required=False,
+ label=soc.models.work.Work.partial_path.verbose_name,
+ help_text=soc.models.work.Work.partial_path.help_text)
+
+ # TODO(tlarsen): actually, using these two text fields to specify
+ # the Document is pretty cheesy; this needs to be some much better
+ # Role-scoped Document selector that we don't have yet
+ link_name = forms.CharField(required=False,
+ label=soc.models.work.Work.link_name.verbose_name,
+ help_text=soc.models.work.Work.link_name.help_text)
+
+ class Meta:
+ model = None
+
+
+DEF_HOME_EDIT_TMPL = 'soc/settings/edit.html'
+
+@decorators.view
+def edit(request, page=None, path=None, logic=models.home_settings.logic,
+ template=DEF_HOME_EDIT_TMPL):
+ """View for authorized User to edit contents of a home page.
+
+ Args:
+ request: the standard django request object.
+ page: a soc.logic.site.page.Page object which is abstraction that
+ combines a Django view with sidebar menu info
+ template: the template path to use for rendering the template.
+
+ Returns:
+ A subclass of django.http.HttpResponse with generated template.
+ """
+
+ try:
+ access.checkIsDeveloper(request)
+ except soc.views.out_of_band.AccessViolationResponse, alt_response:
+ # TODO(tlarsen): change this to just limit Settings paths that can be
+ # viewed or modified by the User in their current Role
+ return alt_response.response()
+
+ # create default template context for use with any templates
+ context = helper.responses.getUniversalContext(request)
+ context['page'] = page
+
+ settings_form = None
+ doc_select_form = None
+ home_doc = None
+
+ if request.method == 'POST':
+ settings_form = SettingsForm(request.POST)
+ doc_select_form = DocSelectForm(request.POST)
+
+ if doc_select_form.is_valid() and settings_form.is_valid():
+ fields = {'feed_url': settings_form.cleaned_data.get('feed_url')}
+ partial_path = doc_select_form.cleaned_data.get('partial_path')
+ link_name = doc_select_form.cleaned_data.get('link_name')
+
+ home_doc = document.logic.getFromFields(
+ partial_path=partial_path, link_name=link_name)
+
+ if home_doc:
+ fields['home'] = home_doc
+ context['notice'] = ugettext_lazy('Settings saved.')
+ else:
+ context['notice'] = ugettext_lazy('Document not specified or could not be found; other Settings saved.')
+
+ settings = logic.updateOrCreateFromFields(fields, path=path)
+
+ if settings.home:
+ home_doc = settings.home
+ else: # request.method == 'GET'
+ # try to fetch HomeSettings entity by unique key_name
+ settings = logic.getFromFields(path=path)
+
+ if settings:
+ # populate form with the existing HomeSettings entity
+ settings_form = SettingsForm(instance=settings)
+
+ # check if ReferenceProperty to home Document is valid
+ try:
+ home_doc = settings.home
+ except db.Error:
+ pass
+
+ if home_doc:
+ doc_select_form = DocSelectForm(initial={
+ 'partial_path': home_doc.partial_path,
+ 'link_name': home_doc.link_name})
+ else:
+ doc_select_form = DocSelectForm()
+ else:
+ # no SiteSettings entity exists for this key_name, so show a blank form
+ settings_form = SettingsForm()
+ doc_select_form = DocSelectForm()
+
+ context.update({'settings_form': settings_form,
+ 'doc_select_form': doc_select_form,
+ 'home_doc': home_doc})
+
+ return helper.responses.respond(request, template, context)