Add a getListRedirect and getListPublicRedirect function
Patch by: Sverre Rabbelier
#!/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 Groups.
"""
__authors__ = [
'"Sverre Rabbelier" <sverre@rabbelier.nl>',
'"Lennard de Rijk" <ljvderijk@gmail.com>',
]
from google.appengine.api import users
from django import forms
from django import http
from django.utils.translation import ugettext
from soc.logic import dicts
from soc.logic.models import user as user_logic
from soc.views.helper import decorators
from soc.views.helper import lists as list_helper
from soc.views.helper import redirects
from soc.views.helper import responses
from soc.views.helper import widgets
from soc.views.models import presence
from soc.views.models import document as document_view
from soc.views.models.request import view as request_view
from soc.views.sitemap import sidebar
import soc.views.helper
class View(presence.View):
"""View methods for the Group 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
"""
new_params = {}
new_params['extra_dynaexclude'] = ['founder','home', 'tos',
'member_template', 'status']
new_params['edit_extra_dynafields'] = {
'founded_by': forms.CharField(widget=widgets.ReadOnlyInput(),
required=False),
}
#set the extra_django_patterns and include the one from params
patterns = params.get('extra_django_patterns', [])
patterns += [
(r'^%(url_name)s/(?P<access_type>list_requests)/%(key_fields)s$',
'soc.views.models.%(module_name)s.list_requests',
'List of requests for %(name)s'),
(r'^%(url_name)s/(?P<access_type>list_roles)/%(key_fields)s$',
'soc.views.models.%(module_name)s.list_roles',
'List of roles for %(name)s')]
if params.get('group_applicant_url'):
# add the applicant pattern
patterns += [
(r'^%(url_name)s/(?P<access_type>applicant)/%(key_fields)s$',
'soc.views.models.%(module_name)s.applicant',
"%(name)s Creation via Accepted Application"),]
new_params['extra_django_patterns'] = patterns
# TODO(tlarsen): Add support for Django style template lookup
new_params['public_template'] = 'soc/group/public.html'
new_params['list_row'] = 'soc/group/list/row.html'
new_params['list_heading'] = 'soc/group/list/heading.html'
new_params['role_views'] = {}
params = dicts.merge(params, new_params, sub_merge=True)
super(View, self).__init__(params=params)
def _editGet(self, request, entity, form):
"""See base.View._editGet().
"""
# fill in the founded_by with data from the entity
form.fields['founded_by'].initial = entity.founder.name
super(View, self)._editGet(request, entity, form)
def _editPost(self, request, entity, fields):
"""See base.View._editPost().
"""
if not entity:
# only if we are creating a new entity we should fill in founder
user = user_logic.logic.getForCurrentAccount()
fields['founder'] = user
super(View, self)._editPost(request, entity, fields)
@decorators.merge_params
@decorators.check_access
def applicant(self, request, access_type,
page_name=None, params=None, **kwargs):
"""Handles the creation of a group via an approved group application.
Args:
request: the standard Django HTTP request object
access_type : the name of the access type which should be checked
page_name: the page name displayed in templates as page and header title
params: a dict with params for this View
kwargs: the Key Fields for the specified entity
"""
# get the context for this webpage
context = responses.getUniversalContext(request)
context['page_name'] = page_name
if request.method == 'POST':
return self.applicantPost(request, context, params, **kwargs)
else:
# request.method == 'GET'
return self.applicantGet(request, context, params, **kwargs)
def applicantGet(self, request, context, params, **kwargs):
"""Handles the GET request concerning the creation of a group via an
approved group application.
Args:
request: the standard Django HTTP request object
context: dictionary containing the context for this view
params: a dict with params for this View
kwargs: the Key Fields for the specified entity
"""
# find the application
application_logic = params['application_logic']
application = application_logic.logic.getFromKeyFields(kwargs)
# extract the application fields
field_names = application.properties().keys()
fields = dict( [(i, getattr(application, i)) for i in field_names] )
# create the form using the fields from the application as the initial value
form = params['applicant_create_form'](initial=fields)
# construct the appropriate response
return super(View, self)._constructResponse(request, entity=None,
context=context, form=form, params=params)
def applicantPost(self, request, context, params, **kwargs):
"""Handles the POST request concerning the creation of a group via an
approved group application.
Args:
request: the standard Django HTTP request object
context: dictionary containing the context for this view
params: a dict with params for this View
kwargs: the Key Fields for the specified entity
"""
# populate the form using the POST data
form = params['applicant_create_form'](request.POST)
if not form.is_valid():
# return the invalid form response
return self._constructResponse(request, entity=None, context=context,
form=form, params=params)
# collect the cleaned data from the valid form
key_name, fields = soc.views.helper.forms.collectCleanedFields(form)
# do post processing
self._applicantPost(request, context, fields)
if not key_name:
key_name = self._logic.getKeyNameFromFields(fields)
# create the group entity
entity = self._logic.updateOrCreateFromKeyName(fields, key_name)
# redirect to notifications list to see the admin invite
return http.HttpResponseRedirect('/notification/list')
def _applicantPost(self, request, context, fields):
"""Performs any required processing on the entity to post its edit page.
Args:
request: the django request object
context: the context for the webpage
fields: the new field values
"""
# fill in the founder of the group
user = user_logic.logic.getForCurrentAccount()
fields['founder'] = user
# If scope_logic is not defined, this entity has no scope
if not self._params['scope_logic']:
return
# If this entity is unscoped, do not try to retrieve a scope
if 'scope_path' not in fields:
return
scope = self._params['scope_logic'].logic.getFromKeyName(
fields['scope_path'])
fields['scope'] = scope
@decorators.merge_params
@decorators.check_access
def listRequests(self, request, access_type,
page_name=None, params=None, **kwargs):
"""Gives an overview of all the requests for a specific group.
Args:
request: the standard Django HTTP request object
access_type : the name of the access type which should be checked
page_name: the page name displayed in templates as page and header title
params: a dict with params for this View
kwargs: the Key Fields for the specified entity
"""
# set the pagename to include the link_id
page_name = '%s %s' %(page_name, kwargs['link_id'])
# get the group from the request
group_logic = params['logic']
group_entity = group_logic.getFromKeyFields(kwargs)
role_names = params['role_views'].keys()
# list all incoming requests
filter = {
'scope': group_entity,
'role': role_names,
'status': 'new'
}
# create the list parameters
inc_req_params = request_view.getParams()
# define the list redirect action to the request processing page
inc_req_params['list_action'] = (redirects.getProcessRequestRedirect, None)
inc_req_params['list_description'] = ugettext(
"An overview of the %(name)s's incoming requests." % params)
inc_req_content = list_helper.getListContent(
request, inc_req_params, filter, 0)
# list all outstanding invites
filter = {
'scope': group_entity,
'role': role_names,
'status': 'group_accepted'
}
# create the list parameters
out_inv_params = request_view.getParams()
# define the list redirect action to the request processing page
out_inv_params['list_action'] = (redirects.getProcessRequestRedirect, None)
out_inv_params['list_description'] = ugettext(
"An overview of the %(name)s's outstanding invites." % params)
out_inv_content = list_helper.getListContent(
request, out_inv_params, filter, 1)
# list all ignored requests
filter = {
'scope': group_entity,
'role': role_names,
'status': 'ignored'
}
# create the list parameters
ignored_params = request_view.getParams()
# define the list redirect action to the request processing page
ignored_params['list_action'] = (redirects.getProcessRequestRedirect, None)
ignored_params['list_description'] = ugettext(
"An overview of the %(name)s's ignored requests." % params)
ignored_content = list_helper.getListContent(
request, ignored_params, filter, 2)
contents = [inc_req_content, out_inv_content, ignored_content]
return self._list(request, params, contents, page_name)
@decorators.merge_params
@decorators.check_access
def listRoles(self, request, access_type,
page_name=None, params=None, **kwargs):
"""Gives an overview of all the roles in a specific group.
Args:
request: the standard Django HTTP request object
access_type : the name of the access type which should be checked
page_name: the page name displayed in templates as page and header title
params: a dict with params for this View
kwargs: the Key Fields for the specified entity
"""
# set the pagename to include the link_id
page_name = '%s %s' %(page_name, kwargs['link_id'])
# get the group from the request
group_logic = params['logic']
group_entity = group_logic.getFromKeyFields(kwargs)
# create the filter
filter = {
'scope' : group_entity,
'status': 'active'
}
role_views = params['role_views']
contents = []
index = 0
# for each role we create a separate list
for role_name in role_views.keys():
# create the list parameters
list_params = role_views[role_name].getParams().copy()
list_params['list_action'] = (redirects.getManageRedirect, list_params)
list_params['list_description'] = ugettext(
"An overview of the %s for this %s." % (
list_params['name_plural'], params['name']))
new_list_content = list_helper.getListContent(
request, list_params, filter, index)
contents += [new_list_content]
index += 1
# call the _list method from base.View to show the list
return self._list(request, params, contents, page_name)
def registerRole(self, role_name, role_view):
"""Adds a role to the role_views param.
Args:
role_name: The name of the role that needs to be added
role_view: The view that needs to be added to role_views.
"""
role_views = self._params['role_views']
role_views[role_name] = role_view
def getExtraMenus(self, id, user, params=None):
"""Returns the extra menu's for this view.
A menu item is generated for each group that the user has an active
role for. The public page for each group is added as menu item,
as well as all public documents for that group.
Args:
params: a dict with params for this View.
"""
params = dicts.merge(params, self._params)
logic = params['logic']
# set fields to match every active role this user has
fields = {'user': user,
'status': 'active'}
# get the role views and start filling group_entities
role_views = self._params['role_views']
role_descriptions = {}
for role_name in role_views.keys():
role_view = role_views[role_name]
role_view_params = role_view.getParams()
role_logic = role_view_params['logic']
roles = role_logic.getForFields(fields)
for role in roles:
group_key_name = role.scope.key().name()
existing_role_descriptions = role_descriptions.get(group_key_name)
if existing_role_descriptions:
# add this description to existing roles
existing_roles = existing_role_descriptions['roles']
existing_roles[role_name] = role
else:
# create a description of this role
role_description = {'roles': {role_name: role},
'group': role.scope}
# add the new entry to our dictionary
role_descriptions[group_key_name] = role_description
# get the document view params to add the group's documents to the menu
doc_params = document_view.view.getParams()
menus = []
# for each role description in our collection
for role_description in role_descriptions.itervalues():
#start with an empty menu
menu = {}
# get the group for this role description
group_entity = role_description['group']
# set the menu header name
menu['heading'] = group_entity.short_name
# get the documents for this group entity
doc_items = document_view.view.getMenusForScope(group_entity, params)
doc_items = sidebar.getSidebarMenu(id, user, doc_items,
params=doc_params)
# get the group specific items
group_items = self._getExtraMenuItems(role_description, params)
group_items = sidebar.getSidebarMenu(id, user, group_items,
params=self._params)
# add the items together
menu['items'] = doc_items + group_items
menu['group'] = params['name_plural']
# append this as a new menu
menus.append(menu)
return menus
def _getExtraMenuItems(self, role_description, params=None):
"""Used to implement group instance specific needs for the side menu.
Args:
role_description : dict containing all the roles which is a dict of
name and the role entity to which it belongs. Also
group contains the group entity to which these roles
belong.
params: a dict with params for this View.
"""
return []