#!/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.
"""Views for Site Settings.
"""
__authors__ = [
'"Sverre Rabbelier" <sverre@rabbelier.nl>',
]
from django import forms
from soc.logic import dicts
from soc.views.helper import access
from soc.views.models import document as document_view
from soc.views.models import presence
import soc.models.site
import soc.logic.models.site
import soc.logic.dicts
class CreateForm(presence.SettingsValidationForm):
"""Django form displayed when creating or editing Site 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.site.Site
#: list of model fields which will *not* be gathered by the form
exclude = ['home', 'scope', 'scope_path', 'link_id']
link_id = forms.CharField(widget=forms.HiddenInput)
class EditForm(CreateForm):
"""Django form displayed a Document is edited.
"""
pass
class View(presence.View):
"""View methods for the Document model.
"""
def __init__(self, params=None):
"""Defines the fields and methods required for the base View class
to provide the user with list, public, create, edit and delete views.
Params:
params: a dict with params for this View
"""
rights = {}
rights['unspecified'] = [access.checkIsDeveloper]
rights['any_access'] = [access.allow]
rights['show'] = [access.allow]
new_params = {}
new_params['logic'] = soc.logic.models.site.logic
new_params['rights'] = rights
# TODO(alturin): add ugettext_lazy ?
new_params['name'] = "Site Settings"
new_params['name_short'] = "Site"
new_params['name_plural'] = "Site Settings"
# lower name and replace " " with "/"
new_params['url_name'] = "site/settings"
new_params['module_name'] = "site"
new_params['edit_form'] = EditForm
new_params['create_form'] = CreateForm
new_params['sidebar_defaults'] = [('/%s/edit', 'Edit %(name)s', 'edit')]
new_params['sidebar_heading'] = new_params['name_short']
new_params['public_template'] = 'soc/home/public.html'
patterns = []
page_name = "Home Page"
patterns += [(r'^$', 'soc.views.models.%(module_name)s.main_public',
page_name)]
page_name = "Edit Site"
patterns += [(r'^%(url_name)s/(?P<access_type>edit)$',
'soc.views.models.%(module_name)s.main_edit',
page_name)]
new_params['extra_django_patterns'] = patterns
params = dicts.merge(params, new_params)
super(View, self).__init__(params=params)
def getSidebarMenus(self, request, params=None):
"""See base.View.getSidebarMenus.
Returns a custom sidebar entry for the 'site' singleton.
"""
entity = self._logic.getFromFields(link_id=self._logic.DEF_SITE_LINK_ID)
submenus = []
if entity:
submenus = document_view.view.getMenusForScope(entity, self._params)
new_params = {}
new_params['sidebar_additional'] = submenus
params = dicts.merge(params, new_params)
return super(View, self).getSidebarMenus(request, params=params)
def mainPublic(self, request, page_name=None, **kwargs):
"""Displays the main site settings page.
Args:
request: the standard Django HTTP request object
page_name: the page name displayed in templates as page and header title
kwargs: not used
"""
keys = self._logic.getKeyFieldNames()
# No entity in this case, since Site key values are hard-coded for the
# Site singleton, so pass in None to match parent method footprint.
values = self._logic.getKeyValues(None)
key_values = dicts.zip(keys, values)
return self.public(request, "show", page_name, **key_values)
def mainEdit(self, request, page_name=None, **kwargs):
"""Displays the edit page for the main site settings page.
Args:
request: the standard Django HTTP request object
page_name: the page name displayed in templates as page and header title
kwargs: not used
"""
keys = self._logic.getKeyFieldNames()
# No entity in this case, since Site key values are hard-coded for the
# Site singleton, so pass in None to match parent method footprint.
values = self._logic.getKeyValues(None)
key_values = dicts.zip(keys, values)
return self.edit(request, page_name, seed=key_values, **key_values)
view = View()
create = view.create
edit = view.edit
delete = view.delete
list = view.list
public = view.public
main_public = view.mainPublic
main_edit = view.mainEdit