~azzar1/unity/add-show-desktop-key : contents of www/dispatch/html.py at revision 200

~azzar1/unity/add-show-desktop-key : (revision 200)

# IVLE - Informatics Virtual Learning Environment
# Copyright (C) 2007-2008 The University of Melbourne
#
# This program 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.
#
# This program 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 this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA

# Module: dispatch.html
# Author: Matt Giuca
# Date: 12/12/2007

# Provides functions for writing the dispatch-generated HTML header and footer
# content (the common parts of the HTML pages shared across the entire site).
# Does not include the login page. See login.py.

import os.path

import conf
import conf.apps
from common import util

def write_html_head(req):
    """Writes the HTML header, given a request object.

    req: An IVLE request object. Reads attributes such as title. Also used to
    write to."""

    # Write the XHTML opening and head element
    # Note the inline JavaScript, which provides the client with constants
    # derived from the server configuration.
    if req.title != None:
        titlepart = req.title + ' - '
    else:
        titlepart = ''
    req.write("""<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
  <title>%sIVLE</title>
  <meta http-equiv="Content-Type" content="%s; charset=utf-8" />
""" % (titlepart, req.content_type))
    # Write inline JavaScript which gives the client code access to certain
    # server-side variables.
    if req.username:
        username = repr(req.username)
    else:
        username = "null"
    req.write("""  <script type="text/javascript">
    root_dir = %s;
    username = %s;
  </script>
""" % (repr(conf.root_dir), username))
    iconurl = get_icon_url(req.app)
    if iconurl:
        req.write("""  <link rel="shortcut icon" href="%s" />
""" % iconurl)
    req.write("""  <link rel="stylesheet" type="text/css" href="%s" />
""" % util.make_path('media/common/ivle.css'))

    # Write any app-specific style and script links
    for style in req.styles:
        req.write('  <link rel="stylesheet" type="text/css" href="%s" />\n'
            % util.make_path(style))
    for script in req.scripts:
        req.write('  <script type="text/javascript" src="%s" />\n'
            % util.make_path(script))

    req.write("</head>\n\n")

    # Open the body element and write a bunch of stuff there (the header)
    req.write("""<body>
<div id="ivleheader">
  <h1>IVLE</h1>
  <h2>Informatics Virtual Learning Environment</h2>
""")

    if req.username:
        req.write('  <p class="userhello">Welcome, <span '
            'class="username">%s</span> |\n'
            '    <a href="%s">Help</a> |\n'
            '    <a href="%s">Logout</a>\n'
            '  </p>\n' %
            (req.username, get_help_url(req), util.make_path('logout')))
    else:
        req.write('  <p class="userhello">Not logged in.</p>')

    # If the "debuginfo" app is installed, display a warning to the admin to
    # make sure it is removed in production.
    if "debuginfo" in conf.apps.app_url:
        req.write("  <p><small>Warning: debuginfo is enabled. Remove this "
            "app from conf.apps.app_url when placed into production."
            "</small></p>\n")

    if req.username:
        # Only print app tabs if logged in
        print_apps_list(req, req.app)
    req.write('</div>\n<div id="ivlebody">\n')

def write_html_foot(req):
    """Writes the HTML footer, given a request object.

    req: An IVLE request object. Written to.
    """
    req.write("</div>\n</body>\n</html>\n")

def get_help_url(req):
    """Gets the help URL most relevant to this page, to place as the
    "help" link at the top of the page."""
    if req.app == 'help':
        # We're already in help. Link to the exact current page
        # instead of the generic help page.
        return req.uri
    if conf.apps.app_url[req.app].hashelp:
        help_path = os.path.join('help', req.app)
    else:
        help_path = 'help'
    return util.make_path(help_path)

def get_icon_url(appurl, small=False):
    """Given an app's url name, gets the URL of the icon image for this app,
    relative to the site root. Returns None if the app has no icon."""
    if appurl is None: return None
    app = conf.apps.app_url[appurl]
    if small:
        icon_dir = conf.apps.app_icon_dir_small
    else:
        icon_dir = conf.apps.app_icon_dir
    if app.icon is None: return None
    return util.make_path(os.path.join(icon_dir, app.icon))

def print_apps_list(file, thisapp):
    """Prints all app tabs, as a UL. Prints a list item for each app that has
    a tab.

    file: Object with a "write" method - ie. the request object.
    Reads from: conf
    """
    file.write('  <ul class="apptabs">\n')

    for urlname in conf.apps.apps_in_tabs:
        app = conf.apps.app_url[urlname]
        if urlname == thisapp:
            li_attr = ' class="thisapp"'
        else:
            li_attr = ''
        file.write('    <li%s>' % li_attr)
        if app.icon:
            file.write('<img src="%s" alt="" /> ' % get_icon_url(urlname))
        file.write('<a href="%s">%s</a></li>\n'
            % (util.make_path(urlname), app.name))

    file.write('  </ul>\n')

93 by mattgiuca New directory hierarchy.	1	# IVLE - Informatics Virtual Learning Environment
	2	# Copyright (C) 2007-2008 The University of Melbourne
	3	#
	4	# This program is free software; you can redistribute it and/or modify
	5	# it under the terms of the GNU General Public License as published by
	6	# the Free Software Foundation; either version 2 of the License, or
	7	# (at your option) any later version.
	8	#
	9	# This program is distributed in the hope that it will be useful,
	10	# but WITHOUT ANY WARRANTY; without even the implied warranty of
	11	# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	12	# GNU General Public License for more details.
	13	#
	14	# You should have received a copy of the GNU General Public License
	15	# along with this program; if not, write to the Free Software
	16	# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
	17
	18	# Module: dispatch.html
	19	# Author: Matt Giuca
	20	# Date: 12/12/2007
	21
	22	# Provides functions for writing the dispatch-generated HTML header and footer
	23	# content (the common parts of the HTML pages shared across the entire site).
	24	# Does not include the login page. See login.py.
	25
192 by mattgiuca dispatch.html: Only prints tabs if logged in.	26	import os.path
	27
93 by mattgiuca New directory hierarchy.	28	import conf
	29	import conf.apps
	30	from common import util
	31
	32	def write_html_head(req):
	33	"""Writes the HTML header, given a request object.
	34
	35	req: An IVLE request object. Reads attributes such as title. Also used to
	36	write to."""
	37
	38	# Write the XHTML opening and head element
175 by mattgiuca dispatch.html: HTML headers for all pages now include a JavaScript	39	# Note the inline JavaScript, which provides the client with constants
	40	# derived from the server configuration.
93 by mattgiuca New directory hierarchy.	41	if req.title != None:
199 by mattgiuca Added small versions of all the app icons to images. These are used for	42	titlepart = req.title + ' - '
93 by mattgiuca New directory hierarchy.	43	else:
	44	titlepart = ''
	45	req.write("""<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
	46	"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
	47	<html xmlns="http://www.w3.org/1999/xhtml">
	48	<head>
199 by mattgiuca Added small versions of all the app icons to images. These are used for	49	<title>%sIVLE</title>
169 by mattgiuca Added global common css file (media/common/ivle.css).	50	<meta http-equiv="Content-Type" content="%s; charset=utf-8" />
200 by mattgiuca fileservice.listing: Now returns a nicer date format for mtime_nice.	51	""" % (titlepart, req.content_type))
	52	# Write inline JavaScript which gives the client code access to certain
	53	# server-side variables.
	54	if req.username:
	55	username = repr(req.username)
	56	else:
	57	username = "null"
	58	req.write(""" <script type="text/javascript">
	59	root_dir = %s;
	60	username = %s;
175 by mattgiuca dispatch.html: HTML headers for all pages now include a JavaScript	61	</script>
200 by mattgiuca fileservice.listing: Now returns a nicer date format for mtime_nice.	62	""" % (repr(conf.root_dir), username))
	63	iconurl = get_icon_url(req.app)
199 by mattgiuca Added small versions of all the app icons to images. These are used for	64	if iconurl:
	65	req.write(""" <link rel="shortcut icon" href="%s" />
	66	""" % iconurl)
	67	req.write(""" <link rel="stylesheet" type="text/css" href="%s" />
	68	""" % util.make_path('media/common/ivle.css'))
169 by mattgiuca Added global common css file (media/common/ivle.css).	69
	70	# Write any app-specific style and script links
	71	for style in req.styles:
	72	req.write(' <link rel="stylesheet" type="text/css" href="%s" />\n'
	73	% util.make_path(style))
	74	for script in req.scripts:
	75	req.write(' <script type="text/javascript" src="%s" />\n'
	76	% util.make_path(script))
	77
	78	req.write("</head>\n\n")
93 by mattgiuca New directory hierarchy.	79
	80	# Open the body element and write a bunch of stuff there (the header)
	81	req.write("""<body>
191 by mattgiuca dispatch.html, ivle.css, browser.css: Major restyling of the IVLE website.	82	<div id="ivleheader">
197 by mattgiuca dispatch.html, ivle.css: Main IVLE header is now an h1/h2 pair, styled to the	83	<h1>IVLE</h1>
	84	<h2>Informatics Virtual Learning Environment</h2>
93 by mattgiuca New directory hierarchy.	85	""")
93 by mattgiuca New directory hierarchy.	86
124 by mattgiuca dispatch/request: Added new fields: method and username.	87	if req.username:
191 by mattgiuca dispatch.html, ivle.css, browser.css: Major restyling of the IVLE website.	88	req.write(' <p class="userhello">Welcome, <span '
192 by mattgiuca dispatch.html: Only prints tabs if logged in.	89	'class="username">%s</span> \|\n'
	90	' <a href="%s">Help</a> \|\n'
	91	' <a href="%s">Logout</a>\n'
	92	' </p>\n' %
	93	(req.username, get_help_url(req), util.make_path('logout')))
124 by mattgiuca dispatch/request: Added new fields: method and username.	94	else:
191 by mattgiuca dispatch.html, ivle.css, browser.css: Major restyling of the IVLE website.	95	req.write(' <p class="userhello">Not logged in.</p>')
124 by mattgiuca dispatch/request: Added new fields: method and username.	96
93 by mattgiuca New directory hierarchy.	97	# If the "debuginfo" app is installed, display a warning to the admin to
	98	# make sure it is removed in production.
	99	if "debuginfo" in conf.apps.app_url:
191 by mattgiuca dispatch.html, ivle.css, browser.css: Major restyling of the IVLE website.	100	req.write(" <p><small>Warning: debuginfo is enabled. Remove this "
	101	"app from conf.apps.app_url when placed into production."
186 by mattgiuca Added a bit of "chrome" (some CSS styling and minor touching up of the HTML).	102	"</small></p>\n")
93 by mattgiuca New directory hierarchy.	103
192 by mattgiuca dispatch.html: Only prints tabs if logged in.	104	if req.username:
	105	# Only print app tabs if logged in
	106	print_apps_list(req, req.app)
191 by mattgiuca dispatch.html, ivle.css, browser.css: Major restyling of the IVLE website.	107	req.write('</div>\n<div id="ivlebody">\n')
	108
93 by mattgiuca New directory hierarchy.	109	def write_html_foot(req):
	110	"""Writes the HTML footer, given a request object.
	111
	112	req: An IVLE request object. Written to.
	113	"""
191 by mattgiuca dispatch.html, ivle.css, browser.css: Major restyling of the IVLE website.	114	req.write("</div>\n</body>\n</html>\n")
93 by mattgiuca New directory hierarchy.	115
192 by mattgiuca dispatch.html: Only prints tabs if logged in.	116	def get_help_url(req):
	117	"""Gets the help URL most relevant to this page, to place as the
	118	"help" link at the top of the page."""
	119	if req.app == 'help':
	120	# We're already in help. Link to the exact current page
	121	# instead of the generic help page.
	122	return req.uri
	123	if conf.apps.app_url[req.app].hashelp:
	124	help_path = os.path.join('help', req.app)
	125	else:
	126	help_path = 'help'
	127	return util.make_path(help_path)
	128
200 by mattgiuca fileservice.listing: Now returns a nicer date format for mtime_nice.	129	def get_icon_url(appurl, small=False):
	130	"""Given an app's url name, gets the URL of the icon image for this app,
199 by mattgiuca Added small versions of all the app icons to images. These are used for	131	relative to the site root. Returns None if the app has no icon."""
200 by mattgiuca fileservice.listing: Now returns a nicer date format for mtime_nice.	132	if appurl is None: return None
	133	app = conf.apps.app_url[appurl]
199 by mattgiuca Added small versions of all the app icons to images. These are used for	134	if small:
	135	icon_dir = conf.apps.app_icon_dir_small
	136	else:
	137	icon_dir = conf.apps.app_icon_dir
	138	if app.icon is None: return None
	139	return util.make_path(os.path.join(icon_dir, app.icon))
	140
191 by mattgiuca dispatch.html, ivle.css, browser.css: Major restyling of the IVLE website.	141	def print_apps_list(file, thisapp):
93 by mattgiuca New directory hierarchy.	142	"""Prints all app tabs, as a UL. Prints a list item for each app that has
	143	a tab.
	144
	145	file: Object with a "write" method - ie. the request object.
	146	Reads from: conf
	147	"""
191 by mattgiuca dispatch.html, ivle.css, browser.css: Major restyling of the IVLE website.	148	file.write(' <ul class="apptabs">\n')
93 by mattgiuca New directory hierarchy.	149
	150	for urlname in conf.apps.apps_in_tabs:
	151	app = conf.apps.app_url[urlname]
191 by mattgiuca dispatch.html, ivle.css, browser.css: Major restyling of the IVLE website.	152	if urlname == thisapp:
	153	li_attr = ' class="thisapp"'
	154	else:
	155	li_attr = ''
196 by mattgiuca Added application icons, displayed in the tabs at the top of the IVLE page.	156	file.write(' <li%s>' % li_attr)
	157	if app.icon:
200 by mattgiuca fileservice.listing: Now returns a nicer date format for mtime_nice.	158	file.write('<img src="%s" alt="" /> ' % get_icon_url(urlname))
196 by mattgiuca Added application icons, displayed in the tabs at the top of the IVLE page.	159	file.write('<a href="%s">%s</a></li>\n'
	160	% (util.make_path(urlname), app.name))
93 by mattgiuca New directory hierarchy.	161
191 by mattgiuca dispatch.html, ivle.css, browser.css: Major restyling of the IVLE website.	162	file.write(' </ul>\n')