Add an export() view, and implement it as text/text for Document.
For every Model except Document, the public() view is displayed for any
attempts to access the export() view.
Currently, the permissions for export() are the same as for public(). This
seems reasonable for Document, since anyone could extract the raw HTML from
the page source anyway. The permissions should probably be different for
other types of exports, such as vCard or iCard exports of profiles, CSV
exports of lists, etc.
Patch by: Todd Larsen
Review by: to-be-reviewed
#!/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.
"""This module contains the view code for Notifications.
"""
__authors__ = [
'"Lennard de Rijk" <ljvderijk@gmail.com>',
]
import time
from django import forms
from django.utils.translation import ugettext_lazy
from soc.logic import cleaning
from soc.logic import dicts
from soc.logic import validate
from soc.models import notification as notification_model
from soc.views import helper
from soc.views import out_of_band
from soc.views.helper import access
from soc.views.helper import lists as list_helper
from soc.views.helper import redirects
from soc.views.models import base
from soc.logic.models import notification as notification_logic
from soc.logic.models import user as user_logic
class CreateForm(helper.forms.BaseForm):
"""Form for creating a Notification.
"""
# to user field
to_user = forms.fields.CharField(label='To User')
def __init__(self, *args, **kwargs):
""" Calls super and then redefines the order in which the fields appear.
for parameters see BaseForm.__init__()
"""
super(CreateForm, self).__init__(*args, **kwargs)
# set form fields order
self.fields.keyOrder = ['to_user', 'subject', 'message']
class Meta:
"""Inner Meta class that defines some behavior for the form.
"""
model = notification_model.Notification
# exclude the necessary fields from the form
exclude = ['link_id', 'scope', 'scope_path', 'from_user', 'unread']
clean_to_user = cleaning.clean_existing_user('to_user')
class View(base.View):
"""View methods for the Notification 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.deny]
rights['edit'] = [access.deny]
rights['show'] = [access.checkIsMyNotification]
rights['delete'] = [access.checkIsMyNotification]
rights['list'] = [access.checkIsUser]
# create is developer only for the time being to test functionality
rights['create'] = [access.checkIsDeveloper]
new_params = {}
new_params['logic'] = notification_logic.logic
new_params['rights'] = rights
new_params['name'] = "Notification"
new_params['no_create_with_key_fields'] = True
new_params['create_form'] = CreateForm
new_params['edit_redirect'] = '/%(url_name)s/list'
params = dicts.merge(params, new_params)
super(View, self).__init__(params=params)
def list(self, request, access_type,
page_name=None, params=None, filter=None):
"""Lists all notifications that the current logged in user has stored.
for parameters see base.list()
"""
params = dicts.merge(params, self._params)
try:
access.checkAccess(access_type, request, params['rights'])
except out_of_band.Error, error:
return helper.responses.errorResponse(error, request)
# get the current user
user_entity = user_logic.logic.getForCurrentAccount()
# only select the notifications for this user so construct a filter
filter = {
'scope': user_entity,
'unread': True,
}
# create the list parameters
un_params = params.copy() # unread notifications
# define the list redirect action to show the notification
un_params['list_action'] = (redirects.getPublicRedirect, params)
un_params['list_description'] = ugettext_lazy(
"An overview of your unread Notifications.")
# TODO(Lennard) when list sorting is implemented sort on descending date
un_list = list_helper.getListContent(
request, un_params, filter, 0)
# Now get the read list
# Reuse the filter, but only for read notifications
filter['unread'] = False
rn_params = params.copy() # read notifications
rn_params['list_action'] = (redirects.getPublicRedirect, params)
rn_params['list_description'] = ugettext_lazy(
"An overview of your read Notifications.")
rn_list = list_helper.getListContent(
request, rn_params, filter, 1)
# fill contents with all the needed lists
contents = [un_list, rn_list]
# call the _list method from base to display the list
return self._list(request, params, contents, page_name)
def _editPost(self, request, entity, fields):
"""See base.View._editPost().
"""
# get the current user
current_user = user_logic.logic.getForCurrentAccount()
fields['link_id'] = '%i' % (time.time())
fields['scope'] = fields['to_user']
fields['from_user'] = current_user
fields['scope_path'] = fields['to_user'].link_id
def _editSeed(self, request, seed):
"""Checks if scope_path is seeded and puts it into to_user.
for parameters see base._editSeed()
"""
# if scope_path is present
if 'scope_path' in seed.keys():
# fill the to_user field with the scope path
seed['to_user'] = seed['scope_path']
def _public(self, request, entity, context):
"""Marks the Notification as read if that hasn't happened yet.
for parameters see base._public()
"""
# if the user viewing is the user for which this notification is meant
# and the notification has not been read yet
if entity.unread:
# get the current user
user = user_logic.logic.getForCurrentAccount()
# if the message is meant for the user that is reading it
if entity.scope.key() == user.key():
# mark the entity as read
self._logic.updateModelProperties(entity, {'unread' : False} )
context['entity_type_url'] = self._params['url_name']
context['entity_suffix'] = self._logic.getKeySuffix(entity)
view = View()
create = view.create
edit = view.edit
delete = view.delete
list = view.list
public = view.public
export = view.export