comments.py
No OneTemporary
Actions

Subscribers

None

File Metadata

Created: Sat, Nov 23, 03:52

comments.py
View Options

	# -- coding: utf-8 --
	## $Id$
	## Comments and reviews for records.

	## This file is part of the CERN Document Server Software (CDSware).
	## Copyright (C) 2002, 2003, 2004, 2005 CERN.
	##
	## The CDSware is free software; you can redistribute it and/or
	## modify it under the terms of the GNU General Public License as
	## published by the Free Software Foundation; either version 2 of the
	## License, or (at your option) any later version.
	##
	## The CDSware is distributed in the hope that it will be useful, but
	## WITHOUT ANY WARRANTY; without even the implied warranty of
	## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
	## General Public License for more details.
	##
	## You should have received a copy of the GNU General Public License
	## along with CDSware; if not, write to the Free Software Foundation, Inc.,
	## 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.

	__lastupdated__ = """FIXME: last updated"""

	from cdsware import webcomment
	from cdsware.config import *
	from cdsware.webuser import getUid, page_not_authorized, isGuestUser
	from cdsware.webaccount import create_login_page_box, create_register_page_box
	from cdsware.webpage import page, create_error_box
	from cdsware.search_engine import create_navtrail_links, guess_primary_collection_of_a_record

	from mod_python import apache
	import urllib

	def index(req):
	"""
	Redirects to display function
	"""
	req.err_headers_out.add("Location", "%s/comments.py/display?%s" % (weburl, req.args))
	raise apache.SERVER_RETURN, apache.HTTP_MOVED_PERMANENTLY

	def display(req, ln=cdslang, recid=-1, do='od', ds='all', nb=100, p=1, voted=-1, reported=-1, reviews=0):
	"""
	Display comments (reviews if enabled) associated with record having id recid where recid>0.
	This function can also be used to display remarks associated with basket having id recid where recid<-99.
	@param ln: language
	@param recid: record id, integer
	@param do: display order hh = highest helpful score, review only
	lh = lowest helpful score, review only
	hs = highest star score, review only
	ls = lowest star score, review only
	od = oldest date
	nd = newest date
	@param ds: display since all= no filtering by date
	nd = n days ago
	nw = n weeks ago
	nm = n months ago
	ny = n years ago
	where n is a single digit integer between 0 and 9
	@param nb: number of results per page
	@param p: results page
	@param voted: boolean, active if user voted for a review, see vote function
	@param reported: boolean, active if user reported a certain comment/review, see report function
	@param reviews: boolean, enabled for reviews, disabled for comments
	@return the full html page.
	"""
	(body, errors_to_display, warnings) = webcomment.perform_request_display_comments_or_remarks(recID=recid, display_order=do, display_since=ds, nb_per_page=nb,
	page=p, ln=ln, voted=voted, reported=reported, reviews=reviews)
	uid = getUid(req)

	navtrail = create_navtrail_links(cc=guess_primary_collection_of_a_record(recid)) + \
	""" > <a class="navtrail" href="%s/search.py?recid=%s&ln=%s">Detailed record #%s</a>""" % (weburl, recid, ln, recid) + \
	""" > <a class="navtrail">%s</a>""" % (reviews==1 and "Reviews" or "Comments",)

	return page(title="", body=body, navtrail=navtrail, description="", keywords="", uid=uid,
	cdspageheaderadd="", cdspageboxlefttopadd="", cdspageboxleftbottomadd="", cdspageboxrighttopadd="",
	cdspageboxrightbottomadd="", cdspagefooteradd="", lastupdated="", urlargs="", verbose=1, titleprologue="", titleepilogue="",
	req=req, errors=errors_to_display, warnings=warnings)

	def add(req, ln=cdslang, recid=-1, action='DISPLAY', msg="", note="", score="", reviews=0, comid=-1):
	"""
	Add a comment (review) to record with id recid where recid>0
	Also works for adding a remark to basket with id recid where recid<-99
	@param ln: languange
	@param recid: record id
	@param action: 'DISPLAY' to display add form
	'SUBMIT' to submit comment once form is filled
	'REPLY' to reply to an already existing comment
	@param msg: the body of the comment/review or remark
	@param score: star score of the review
	@param note: title of the review
	@param comid: comment id, needed for replying
	@return the full html page.
	"""
	actions = ['DISPLAY', 'REPLY', 'SUBMIT']

	uid = getUid(req)

	navtrail = create_navtrail_links(cc=guess_primary_collection_of_a_record(recid)) + \
	""" > <a class="navtrail" href="%s/search.py?recid=%s&ln=%s">Detailed record #%s</a>""" % (weburl, recid, ln, recid) + \
	""" > <a class="navtrail" href="%s/comments.py/display?recid=%s&ln=%s">%s</a>""" % (weburl, recid, ln, reviews==1 and 'Reviews' or 'Comments')

	if action not in actions:
	action = 'DISPLAY'

	# is page allowed to be viewed
	if uid == -1 or (not cfg_webcomment_allow_comments and not cfg_comment_allow_reviews):
	return page_not_authorized(req, "../comments.py/add")

	# if guest, must log in first
	if isGuestUser(uid):
	msg = "Before you add your comment, you need to log in first"
	referer = "%s/comments.py/add?recid=%s&ln=%s&reviews=%s&comid=%s&action=%s" % (weburl, recid, ln, reviews, comid, action)
	login_box = create_login_page_box(referer)
	return page(title="Login", body=msg+login_box, navtrail=navtrail, description="", keywords="",
	uid=uid, cdspageheaderadd="", cdspageboxlefttopadd="", cdspageboxleftbottomadd="",
	cdspageboxrighttopadd="", cdspageboxrightbottomadd="", cdspagefooteradd="",
	lastupdated="", language=cdslang, urlargs="", verbose=1, titleprologue="", titleepilogue="")
	# user logged in
	else:
	(body, errors, warnings) = webcomment.perform_request_add_comment_or_remark(recID=recid, uid=uid, action=action, msg=msg, note=note, score=score, reviews=reviews, comID=comid)
	title = "Add %s" % (reviews==1 and 'Review' or 'Comment')
	return page(title=title, body=body, navtrail=navtrail, description="", keywords="", uid=uid,
	cdspageheaderadd="", cdspageboxlefttopadd="", cdspageboxleftbottomadd="",
	cdspageboxrighttopadd="", cdspageboxrightbottomadd="", cdspagefooteradd="",
	lastupdated="", language=cdslang, urlargs="", verbose=1, titleprologue="", titleepilogue="", errors=errors, warnings=warnings)

	def vote(req, comid=-1, com_value=0, recid=-1, ln=cdslang, do='od', ds='all', nb=100, p=1, referer=None, reviews=0):
	"""
	Vote positively or negatively for a comment/review.
	@param comid: comment/review id
	@param com_value: +1 to vote positively
	-1 to vote negatively
	@param recid: the id of the record the comment/review is associated with
	@param ln: language
	@param do: display order hh = highest helpful score, review only
	lh = lowest helpful score, review only
	hs = highest star score, review only
	ls = lowest star score, review only
	od = oldest date
	nd = newest date
	@param ds: display since all= no filtering by date
	nd = n days ago
	nw = n weeks ago
	nm = n months ago
	ny = n years ago
	where n is a single digit integer between 0 and 9
	@param nb: number of results per page
	@param p: results page
	@param referer: http address of the calling function to redirect to (refresh)
	@param reviews: boolean, enabled for reviews, disabled for comments
	"""
	success = webcomment.perform_request_vote(comid, com_value)
	if referer:
	referer = referer + '''?recid=%s&ln=%s&do=%s&ds=%s&nb=%s&p=%s&voted=%s&reviews=%s''' % \
	(recid, ln, do, ds, nb, p, success, reviews)
	req.err_headers_out.add("Location", referer)
	raise apache.SERVER_RETURN, apache.HTTP_MOVED_PERMANENTLY
	else: #Note: sent to commetns display
	req.err_headers_out.add("Location", "%s/comments.py/display?recid=%s&ln=%s&reviews=1&voted=1" % (weburl, recid, ln))
	raise apache.SERVER_RETURN, apache.HTTP_MOVED_PERMANENTLY

	def report(req, comid=-1, recid=-1, ln=cdslang, do='od', ds='all', nb=100, p=1, referer=None, reviews=0):
	"""
	Report a comment/review for inappropriate content
	@param comid: comment/review id
	@param recid: the id of the record the comment/review is associated with
	@param ln: language
	@param do: display order hh = highest helpful score, review only
	lh = lowest helpful score, review only
	hs = highest star score, review only
	ls = lowest star score, review only
	od = oldest date
	nd = newest date
	@param ds: display since all= no filtering by date
	nd = n days ago
	nw = n weeks ago
	nm = n months ago
	ny = n years ago
	where n is a single digit integer between 0 and 9
	@param nb: number of results per page
	@param p: results page
	@param referer: http address of the calling function to redirect to (refresh)
	@param reviews: boolean, enabled for reviews, disabled for comments
	"""
	success = webcomment.perform_request_report(comid)
	if referer:
	referer = referer + '''?recid=%s&ln=%s&do=%s&ds=%s&nb=%s&p=%s&reported=%s&reviews=%s''' % \
	(recid, ln, do, ds, nb, p, success, reviews)
	req.err_headers_out.add("Location", referer)
	raise apache.SERVER_RETURN, apache.HTTP_MOVED_PERMANENTLY
	else: #Note: sent to comments display
	req.err_headers_out.add("Location", "%s/comments.py/display?recid=%s&ln=%s&reviews=1&voted=1" % (weburl, recid, ln))
	raise apache.SERVER_RETURN, apache.HTTP_MOVED_PERMANENTLY

comments.pyNo OneTemporaryActions

File Metadata

comments.pyView Options

Event Timeline

comments.py
No OneTemporary
Actions

comments.py
View Options