#!/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 Documents.
"""
__authors__ = [
'"Sverre Rabbelier" <sverre@rabbelier.nl>',
'"Lennard de Rijk" <ljvderijk@gmail.com>',
'"Pawel Solyga" <pawel.solyga@gmail.com>',
]
from django import forms
from soc.logic import cleaning
from soc.logic import dicts
from soc.logic.models.document import logic as document_logic
from soc.logic.models.user import logic as user_logic
from soc.views.helper import access
from soc.views.helper import decorators
from soc.views.helper import redirects
from soc.views.helper import widgets
from soc.views.models import base
class View(base.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 = access.Checker(params)
rights['any_access'] = ['allow']
rights['show'] = ['checkIsDocumentReadable']
rights['create'] = ['checkIsUser']
rights['edit'] = ['checkIsDocumentWritable']
rights['delete'] = ['checkIsDocumentWritable']
rights['list'] = ['checkDocumentList']
rights['pick'] = ['checkDocumentPick']
new_params = {}
new_params['logic'] = document_logic
new_params['rights'] = rights
new_params['name'] = "Document"
new_params['pickable'] = True
new_params['export_content_type'] = 'text/text'
new_params['export_extension'] = '.html'
new_params['export_function'] = lambda x: (x.content, x.link_id)
new_params['delete_redirect'] = '/'
new_params['list_key_order'] = [
'link_id', 'scope_path', 'name', 'short_name', 'title',
'content', 'prefix','read_access','write_access']
new_params['no_create_raw'] = True
new_params['no_create_with_scope'] = True
new_params['no_create_with_key_fields'] = True
new_params['no_list_raw'] = True
new_params['sans_link_id_create'] = True
new_params['sans_link_id_list'] = True
new_params['create_dynafields'] = [
{'name': 'link_id',
'base': forms.fields.CharField,
'label': 'Document Link ID',
},
]
new_params['create_extra_dynaproperties'] = {
'content': forms.fields.CharField(
widget=widgets.FullTinyMCE(attrs={'rows': 25, 'cols': 100})),
'scope_path': forms.fields.CharField(widget=forms.HiddenInput,
required=True),
'prefix': forms.fields.CharField(widget=widgets.ReadOnlyInput(),
required=True),
'clean_content': cleaning.clean_html_content('content'),
'clean_link_id': cleaning.clean_link_id('link_id'),
'clean_scope_path': cleaning.clean_scope_path('scope_path'),
'clean': cleaning.validate_document_acl(self, True),
}
new_params['extra_dynaexclude'] = ['author', 'created', 'home_for',
'modified_by', 'modified']
new_params['edit_extra_dynaproperties'] = {
'doc_key_name': forms.fields.CharField(widget=forms.HiddenInput),
'created_by': forms.fields.CharField(
widget=widgets.ReadOnlyInput(), required=False),
'last_modified_by': forms.fields.CharField(
widget=widgets.ReadOnlyInput(), required=False),
'clean': cleaning.validate_document_acl(self),
}
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, order=None, **kwargs):
"""See base.View.list.
"""
return super(View, self).list(request, access_type, page_name=page_name,
params=params, filter=kwargs)
def _public(self, request, entity, context):
"""Performs any processing needed for the Document's public page.
For args see base.View._public().
"""
# check if the current user is allowed to visit the edit page
rights = self._params['rights']
allowed_to_edit = False
try:
# use the IsDocumentWritable check because we have no django args
rights.checkIsDocumentWritable({'key_name': entity.key().name(),
'prefix': entity.prefix,
'scope_path': entity.scope_path,
'link_id': entity.link_id},
'key_name')
allowed_to_edit = True
except:
pass
if allowed_to_edit:
# add the document edit redirect to the context
context['edit_redirect'] = redirects.getEditRedirect(
entity, {'url_name': 'document'})
return super(View, self)._public(request, entity, context)
def _edit(self, request, entity, context, params):
"""Hook for edit View.
Adds the title of the document to the edit View.
For args see base.View._edit().
"""
context['page_name'] = "%s titled '%s'" %(context['page_name'],
entity.title)
return super(View, self)._edit(request, entity, context, params)
def _editPost(self, request, entity, fields):
"""See base.View._editPost().
"""
user = user_logic.getForCurrentAccount()
if not entity:
fields['author'] = user
else:
fields['author'] = entity.author
fields['modified_by'] = user
super(View, self)._editPost(request, entity, fields)
def _editGet(self, request, entity, form):
"""See base.View._editGet().
"""
form.fields['created_by'].initial = entity.author.name
form.fields['last_modified_by'].initial = entity.modified_by.name
form.fields['doc_key_name'].initial = entity.key().id_or_name()
super(View, self)._editGet(request, entity, form)
def getMenusForScope(self, entity, params):
"""Returns the featured menu items for one specifc entity.
A link to the home page of the specified entity is also included.
Args:
entity: the entity for which the entry should be constructed
params: a dict with params for this View.
"""
filter = {
'prefix' : params['url_name'],
'scope_path': entity.key().id_or_name(),
'is_featured': True,
}
entities = self._logic.getForFields(filter)
submenus = []
# add a link to the home page
submenu = (redirects.getHomeRedirect(entity, params), "Home", 'show')
submenus.append(submenu)
# add a link to all featured documents
for entity in entities:
#TODO only if a document is readable it might be added
submenu = (redirects.getPublicRedirect(entity, self._params),
entity.short_name, 'show')
submenus.append(submenu)
return submenus
view = View()
admin = decorators.view(view.admin)
create = decorators.view(view.create)
edit = decorators.view(view.edit)
delete = decorators.view(view.delete)
list = decorators.view(view.list)
public = decorators.view(view.public)
export = decorators.view(view.export)
pick = decorators.view(view.pick)