+
+
+
+.. _oerrecommender.pt: http://cosl.usu.edu/svndev/eduCommons3/tags/3.1.0-final/portlet/oerrecommender.pt
+
+Here is the renderer for the oerrecommenderportlet.py_ file.
+
+::
+
+ class Renderer(base.Renderer):
+ """ Render the OER Portlet """
+ render = ViewPageTemplateFile('oerrecommender.pt')
+
+ def __init__(self, context, request, view, manager, data):
+ super(Renderer, self).__init__(context, request, view, manager, data)
+ self.props = self.context.portal_properties.educommons_properties
+
+ @property
+ def available(self):
+ return self.props.oerrecommender_enabled
+
+.. _oerrecommenderportlet.py: http://cosl.usu.edu/svndev/eduCommons3/tags/3.1.0-final/portlet/oerrecommenderportlet.py
+
+You'll notice that the renderer is where we define which page template to use when rendering the template. This file also contains a property that allows the portlet to be conditionally displayed based on whether the oerrecommender is enabled.
+
+.. _CourseBuilder Portlet:
+
+CourseBuilder Portlet
+======================
+The Course Builder tool allows users to quickly create a course with its associated files and departments. In this coursebuilder.pt_ template file you can see the portlet displaying a link to the Course Builder form (the '@@' symbol signifies that the resource is a view).
+
+.. _coursebuilder.pt: http://cosl.usu.edu/svndev/eduCommons3/tags/3.1.0-final/portlet/coursebuilder.pt
+
+::
+
+ -
+
+
- + Course Builder + + +
- + Build a Course + + +
+
+
+
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/accessibilityview.py
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/accessibilityview.py (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/accessibilityview.py (revision 126)
@@ -0,0 +1,23 @@
+from zope.publisher.browser import BrowserView
+from zope.annotation.interfaces import IAnnotations
+from enpraxis.educommons.interfaces import IAccessibilityCompliantable
+from enpraxis.educommons import eduCommonsMessageFactory as _
+
+
+class AccessibilityCompliantView(BrowserView):
+ """ Provides view of object with access to annotations in placeless environments"""
+ def changeAccessibility(self, value):
+ """ Provides annotation to placeless script """
+ context = self.context
+ message = ''
+ if IAccessibilityCompliantable.providedBy(context):
+ anno = IAnnotations(context)
+ if value == 'True':
+ anno['eduCommons.accessible'] = True
+ message=_(u'Accessibility Compliant set to True')
+ elif value == 'False':
+ anno['eduCommons.accessible'] = False
+ message=_(u'Accessibility Compliant set to False')
+ return message
+
+
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/ada_compliant.pt
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/ada_compliant.pt (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/ada_compliant.pt (revision 126)
@@ -0,0 +1,31 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Set the accessibility flag if your content meets the criteria outlined
+
+ here
+ .
+
+
+
+
+
+
+
+
+
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/adaview.py
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/adaview.py (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/adaview.py (revision 126)
@@ -0,0 +1,23 @@
+from zope.publisher.browser import BrowserView
+from zope.annotation.interfaces import IAnnotations
+from enpraxis.educommons.interfaces import IAccessibilityCompliantable
+
+
+class ADACompliantView(BrowserView):
+ """ Provides view of object with access to annotations in placeless environments"""
+ def changeADA(self, value):
+ """ Provides annotation to placeless script """
+ context = self.context
+ message = ''
+ if IAccessibilityCompliantable.providedBy(context):
+ anno = IAnnotations(context)
+ if value == 'True':
+ anno['eduCommons.ADA'] = True
+ message=_(u'ADA Compliant set to True')
+ elif value == 'False':
+ anno['eduCommons.ADA'] = False
+ message=_(u'ADA Compliant set to False')
+ return message
+
+
+
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/cc_table.pt
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/cc_table.pt (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/cc_table.pt (revision 126)
@@ -0,0 +1,180 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Set the accessibility flag if your content meets the criteria outlined *LINK HERE*
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/clear_copyright.pt
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/clear_copyright.pt (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/clear_copyright.pt (revision 126)
@@ -0,0 +1,31 @@
++ This folder has no visible items. To add content, press the + add button, or paste content from another location. +
+ +| Select: All | +|||||
|---|---|---|---|---|---|
|
+ All |
+ |||||
|
+ All |
+ |||||
| + | |
+ |
+ |
+ |
+
+ |
+
|
+ Flags: c - Cleared Copyright + a - Accessible + + |
+ |||||
| + + + + | +
+
+ |
+
+ + + size + | ++ 08/19/2001 03:01 AM + | ++ + + | ++ c + a + | +
+
+
+
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/configure.zcml
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/configure.zcml (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/configure.zcml (revision 126)
@@ -0,0 +1,389 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Set cleared copyright if content object has been correctly licensed from the author, and is free from copyright violations.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Download PDF
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/coursestopic.py
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/coursestopic.py (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/coursestopic.py (revision 126)
@@ -0,0 +1,102 @@
+from Products.Five.browser import BrowserView
+from Products.Five.browser.pagetemplatefile import ViewPageTemplateFile
+from enpraxis.educommons.utilities.interfaces import IECUtility
+from enpraxis.educommons.interfaces import IOpenOCWSite
+from zope.component import getUtility
+
+class CoursesView(BrowserView):
+ """ A course listing view """
+
+class DivisionCourseListView(BrowserView):
+ """ A course listing view for a division """
+
+ __call__ = ViewPageTemplateFile('divisioncourses.pt')
+
+ def __init__(self, context, request):
+ self.context = context
+ self.request = request
+ self.ecutil = getUtility(IECUtility)
+
+ def getCourses(self):
+ path = {'query':'/'.join(self.context.getPhysicalPath()) + '/'}
+ results = self.context.portal_catalog.searchResults(path=path, portal_type='Course')
+ results = list(results)
+ results.sort(lambda x, y : cmp(self.ecutil.getFullCourseTitle(x), self.ecutil.getFullCourseTitle(y)))
+ return results
+
+ def getFullCourseTitle(self, brain):
+ """ Returns the title with term and ID information """
+ full_title = self.ecutil.getFullCourseTitle(brain)
+ return full_title
+
+
+class ProfCourseListView(BrowserView):
+ """ A course listing view for a professor """
+
+ __call__ = ViewPageTemplateFile('profslisting.pt')
+
+ def __init__(self, context, request):
+ self.context = context
+ self.request = request
+ self.ecutil = getUtility(IECUtility)
+ self.current_instructor = ''
+
+ def getCoursesByInstructor(self, brains):
+ """ Aggregates Courses by Instructor Name """
+ iname = ''
+ courselist = []
+ tlist = None
+
+ for x in brains:
+ if x.portal_type == 'Course':
+ if iname != x.getInstructorName:
+ if tlist:
+ courselist.append((iname, tlist))
+ tlist = [x]
+ iname = x.getInstructorName
+ else:
+ if tlist:
+ tlist.append(x)
+ #Sort by full Course title
+ tlist = list(tlist)
+ tlist.sort(lambda x, y : cmp(self.ecutil.getFullCourseTitle(x),self.ecutil.getFullCourseTitle(y)))
+ else:
+ tlist = [x]
+
+ if tlist:
+ courselist.append((iname, tlist))
+
+ return courselist
+
+ def getProfName(self, name):
+ """ Returns the professor's name, or default string if none exists """
+ if name == '':
+ return 'No Professor Listed'
+ return name
+
+ def getFullCourseTitle(self, brain):
+ """ Returns the title with term and ID information """
+ full_title = self.ecutil.getFullCourseTitle(brain)
+ return full_title
+
+ def getOddEvenClass(self, oddrow=None):
+ """ assigns a css class based on odd even in the tal repeat """
+ cssclass = 'course-listing odd'
+ if oddrow:
+ cssclass = 'course-listing even'
+ return cssclass
+
+
+class DivisionPageView(BrowserView):
+ """ A default divison page view """
+
+ __call__ = ViewPageTemplateFile('templates/division_view.pt')
+
+ def isOpenOCW(self):
+ return IOpenOCWSite.providedBy(self.context.portal_url.getPortalObject())
+
+
+class CoursePageView(BrowserView):
+ """ A default course page view """
+
+ __call__ = ViewPageTemplateFile('templates/course_view.pt')
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/dashboard.py
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/dashboard.py (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/dashboard.py (revision 126)
@@ -0,0 +1,32 @@
+from zope.interface import implements
+from zope.component import adapts, queryUtility
+
+from zope.app.container.interfaces import INameChooser
+
+from Products.PluggableAuthService.interfaces.authservice import IPropertiedUser
+
+from plone.portlets.interfaces import IPortletManager
+from plone.portlets.constants import USER_CATEGORY
+
+from plone.app.portlets.interfaces import IDefaultDashboard
+from plone.app.portlets import portlets
+
+from plone.app.portlets.storage import UserPortletAssignmentMapping
+
+class DefaultDashboard(object):
+ """The default default dashboard.
+ """
+
+ implements(IDefaultDashboard)
+ adapts(IPropertiedUser)
+
+ def __init__(self, principal):
+ self.principal = principal
+
+ def __call__(self):
+ return {
+ 'plone.dashboard1' : (portlets.news.Assignment(), portlets.events.Assignment(),),
+ 'plone.dashboard2' : (portlets.recent.Assignment(),),
+ 'plone.dashboard3' : (),
+ 'plone.dashboard4' : (),
+ }
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/divisioncourses.pt
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/divisioncourses.pt (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/divisioncourses.pt (revision 126)
@@ -0,0 +1,28 @@
+
+
+
++ Title or id +
+ +
+ description
+
+
+
+
+
+ 
+ RSS Feeds
+
+
+
+ RSS Feeds
+
+
+
+
+ The body
+
+
+
+
+
+
+ + There are currently no results for this search. +
+ + + + ++ Return to Top +
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/feedbackform.py =================================================================== --- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/feedbackform.py (revision 126) +++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/feedbackform.py (revision 126) @@ -0,0 +1,83 @@ +################################################################################## +# Copyright (C) 2007 Utah State University, All rights reserved. +# +# 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA +# +################################################################################## + +__author__ = 'Brent Lambert' +__docformat__ = 'restructuredtext' +__version__ = "$Revision: 1 $"[11:-2] + + +from zope.formlib.form import FormFields, action +from plone.app.form.base import AddForm +from zope.app.form.interfaces import WidgetInputError +from zope.component import getMultiAdapter +from Products.PageTemplates import PageTemplateFile +from enpraxis.educommons import eduCommonsMessageFactory as _ +from Products.MailHost.MailHost import MailHostError +from Products.statusmessages.interfaces import IStatusMessage +from interfaces import IFeedbackForm +from Products.SecureMailHost.mail import Mail + + +def validate_feedback(form, action, data): + """ Validate the from email address, if it exists. """ + errors = form.validate(action, data) + if errors: + return errors + if data.has_key('email') and data['email']: + email = data['email'].encode('ascii') + if not form.context.MailHost.validateSingleEmailAddress(email): + ew = form.widgets.get('email') + ew._error = WidgetInputError(form.context.__name__, ew.label, _('Invalid email address')) + return ew._error + + +class FeedbackForm(AddForm): + """ A form for getting feedback from end users. """ + + form_fields = FormFields(IFeedbackForm) + label = u'Feedback' + description = _(u'We appreciate your feedback. If you find this site useful, or think it could be better, or are having problems using it, please feel free to use the form below to let us know about it.') + + @action(_(u'Submit'), + validator=validate_feedback, + name=u'Submit') + def action_submit(self, action, data): + # Convert post variables into email fields + mto = self.context.email_from_address + if data.has_key('email') and data['email']: + mfrom='%s<%s>' % (data['name'], data['email'].encode('ascii')) + else: + # If no return email is provided, use the TO address. + # Do this so that the from field will pass validation. + mfrom = mto + subject = data['subject'] + message = data['body'] + # Post the message + try: + self.context.MailHost.secureSend(message, mto=mto, mfrom=mfrom, subject=subject, charset='utf8') + except MailHostError, e: + IStatusMessage(self.request).addStatusMessage(_(u'Feedback request failed.'), type='error') + url = getMultiAdapter((self.context, self.request), name='absolute_url')() + self.request.response.redirect(url) + return '' + + self.request.response.redirect('thanks') + return '' + + Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/foldercontents.pt =================================================================== --- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/foldercontents.pt (revision 126) +++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/foldercontents.pt (revision 126) @@ -0,0 +1,70 @@ + + + +
+
+
+
+
+
+
+
+
+ Up one level
+
+
+
+
+
+
+
+
+
+
+
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/foldercontents.py
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/foldercontents.py (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/foldercontents.py (revision 126)
@@ -0,0 +1,320 @@
+
+from zope.component import getMultiAdapter
+from zope.interface import implements
+
+from AccessControl import Unauthorized
+from Acquisition import aq_parent, aq_inner
+from OFS.interfaces import IOrderedContainer
+from Products.ATContentTypes.interface import IATTopic
+from Products.CMFCore.utils import getToolByName
+from Products.Five import BrowserView
+
+from plone.memoize import instance
+from plone.app.content.browser.interfaces import IFolderContentsView
+from plone.app.content.browser.tableview import Table
+from kss.core import KSSView
+from zope.component import getUtility
+from enpraxis.educommons.utilities.interfaces import IECUtility
+
+from Products.CMFPlone.interfaces import IPloneSiteRoot
+
+from zope.app.pagetemplate import ViewPageTemplateFile
+from plone.app.content.batching import Batch
+from plone.memoize import instance
+
+from plone.app.content.browser.foldercontents import FolderContentsTable as DefaultTable
+from plone.app.content.browser.foldercontents import FolderContentsView as DefaultView
+
+from zope.annotation import IAnnotations
+
+import urllib
+
+NOT_ADDABLE_TYPES = ('Favorite',)
+
+class OrderContentsView(DefaultView):
+ """
+ """
+
+ def contents_table(self):
+ parent = getUtility(IECUtility).FindECParent(self.context)
+ table = OrderContentsTable(self.context, self.request, contentFilter={'path':{'query':'/'.join(parent.getPhysicalPath())+'/'},'getExcludeFromNav':False,'sort_on':'getObjPositionInCourse'})
+ return table.render()
+
+
+class OrderContentsTable(DefaultTable):
+ """
+ The foldercontents table renders the table and its actions.
+ """
+
+ def __init__(self, context, request, contentFilter={}):
+ self.context = context
+ self.request = request
+ self.contentFilter = contentFilter
+
+ url = self.context.absolute_url()
+ view_url = url + '/@@order_courseobjs'
+ self.table = OrderTable(request, url, view_url, self.items,
+ show_sort_column=self.show_sort_column,
+ buttons=self.buttons)
+
+ @property
+ @instance.memoize
+ def items(self):
+ """
+ """
+ plone_utils = getToolByName(self.context, 'plone_utils')
+ plone_view = getMultiAdapter((self.context, self.request), name=u'plone')
+ portal_workflow = getToolByName(self.context, 'portal_workflow')
+ portal_properties = getToolByName(self.context, 'portal_properties')
+ site_properties = portal_properties.site_properties
+
+ use_view_action = site_properties.getProperty('typesUseViewActionInListings', ())
+ browser_default = self.context.browserDefault()
+
+ if IATTopic.providedBy(self.context):
+ contentsMethod = self.context.queryCatalog
+ else:
+ contentsMethod = self.context.portal_catalog.searchResults
+
+ results = []
+
+ brains = self.context.portal_catalog.searchResults(self.contentFilter)
+
+ i = 0
+ for obj in [brain for brain in brains if not getattr(brain.aq_explicit, 'exclude_from_nav', True) and brain.portal_type != 'Course']:
+
+ if (i + 1) % 2 == 0:
+ table_row_class = "draggable even"
+ else:
+ table_row_class = "draggable odd"
+
+ if getattr(obj.aq_explicit, 'exclude_from_nav', True):
+ continue
+
+ url = obj.getURL()
+ path = obj.getPath or "/".join(obj.getPhysicalPath())
+ icon = plone_view.getIcon(obj);
+
+ type_class = 'contenttype-' + plone_utils.normalizeString(
+ obj.portal_type)
+
+ review_state = obj.review_state
+ state_class = 'state-' + plone_utils.normalizeString(review_state)
+ relative_url = obj.getURL(relative=True)
+ obj_type = obj.portal_type
+
+ modified = plone_view.toLocalizedTime(
+ obj.ModificationDate, long_format=1)
+
+ if obj_type in use_view_action:
+ view_url = url + '/view'
+ elif obj.is_folderish:
+ view_url = url + "/folder_contents"
+ else:
+ view_url = url
+
+ is_browser_default = len(browser_default[1]) == 1 and (
+ obj.id == browser_default[1][0])
+
+ results.append(dict(
+ url = url,
+ id = obj.getId,
+ quoted_id = urllib.quote_plus(obj.getId),
+ path = path,
+ title_or_id = obj.pretty_title_or_id(),
+ description = obj.Description,
+ obj_type = obj_type,
+ size = obj.getObjSize,
+ modified = modified,
+ icon = icon.html_tag(),
+ type_class = type_class,
+ wf_state = review_state,
+ state_title = portal_workflow.getTitleForStateOnType(review_state,
+ obj_type),
+ state_class = state_class,
+ is_browser_default = is_browser_default,
+ folderish = obj.is_folderish,
+ relative_url = relative_url,
+ view_url = view_url,
+ table_row_class = table_row_class,
+ is_expired = self.context.isExpired(obj),
+ ))
+
+ i += 1
+
+ return results
+
+ @property
+ def buttons(self):
+ buttons = []
+ portal_actions = getToolByName(self.context, 'portal_actions')
+ button_actions = portal_actions.listActionInfos(object=aq_inner(self.context), categories=('folder_buttons', ))
+
+ # Do not show buttons if there is no data, unless there is data to be
+ # pasted
+ if not len(self.items):
+ return []
+
+ for button in button_actions:
+ # Make proper classes for our buttons
+ if button['id'] not in ['paste','cut','copy','import']:
+ buttons.append(self.setbuttonclass(button))
+ return buttons
+
+
+
+class OrderTable(Table):
+ """
+ The table renders a table with sortable columns etc.
+
+ It is meant to be subclassed to provide methods for getting specific table info.
+ """
+ @property
+ @instance.memoize
+ def batch(self):
+ ba = Batch(self.items,pagesize=len(self.items),)
+ map(self.set_checked, ba)
+ return ba
+
+ render = ViewPageTemplateFile("table.pt")
+
+
+
+
+class FolderContentsCCView(DefaultView):
+ """
+ """
+ def contents_table(self):
+ table = FolderContentsCCTable(self.context, self.request)
+ return table.render()
+
+
+
+class FolderContentsCCTable(DefaultTable):
+ """
+ The foldercontents table renders the table and its actions.
+ """
+
+ def __init__(self, context, request, contentFilter={}):
+ self.context = context
+ self.request = request
+ self.contentFilter = contentFilter
+
+ url = self.context.absolute_url()
+ view_url = url + '/folder_contents'
+ self.table = CCTable(request, url, view_url, self.items,
+ show_sort_column=0,
+ buttons=self.buttons)
+
+ @property
+ @instance.memoize
+ def items(self):
+ """
+ """
+ plone_utils = getToolByName(self.context, 'plone_utils')
+ plone_view = getMultiAdapter((self.context, self.request), name=u'plone')
+ portal_workflow = getToolByName(self.context, 'portal_workflow')
+ portal_properties = getToolByName(self.context, 'portal_properties')
+ site_properties = portal_properties.site_properties
+
+ use_view_action = site_properties.getProperty('typesUseViewActionInListings', ())
+ browser_default = self.context.browserDefault()
+
+ if IATTopic.providedBy(self.context):
+ contentsMethod = self.context.queryCatalog
+ else:
+ contentsMethod = self.context.getFolderContents
+
+ results = []
+ for i, obj in enumerate(contentsMethod(self.contentFilter)):
+ if (i + 1) % 2 == 0:
+ table_row_class = "draggable even"
+ else:
+ table_row_class = "draggable odd"
+
+ url = obj.getURL()
+ path = obj.getPath or "/".join(obj.getPhysicalPath())
+ icon = plone_view.getIcon(obj);
+
+ type_class = 'contenttype-' + plone_utils.normalizeString(
+ obj.portal_type)
+
+ review_state = obj.review_state
+ state_class = 'state-' + plone_utils.normalizeString(review_state)
+ relative_url = obj.getURL(relative=True)
+ obj_type = obj.portal_type
+
+ modified = plone_view.toLocalizedTime(
+ obj.ModificationDate, long_format=1)
+
+ if obj_type in use_view_action:
+ view_url = url + '/view'
+ elif obj.is_folderish:
+ view_url = url + "/folder_contents"
+ else:
+ view_url = url
+
+ is_browser_default = len(browser_default[1]) == 1 and (
+ obj.id == browser_default[1][0])
+ #Refactor :: determine why ProxyIndex not accessible here
+ if IAnnotations(obj.getObject()).has_key('eduCommons.clearcopyright'):
+ cc_status = IAnnotations(obj.getObject())['eduCommons.clearcopyright']
+ else:
+ cc_status = False
+
+ if IAnnotations(obj.getObject()).has_key('eduCommons.accessible'):
+ accessibility_status = IAnnotations(obj.getObject())['eduCommons.accessible']
+ else:
+ accessibility_status = False
+
+ results.append(dict(
+ url = url,
+ id = obj.getId,
+ quoted_id = urllib.quote_plus(obj.getId),
+ path = path,
+ title_or_id = obj.pretty_title_or_id(),
+ description = obj.Description,
+ obj_type = obj_type,
+ size = obj.getObjSize,
+ modified = modified,
+ icon = icon.html_tag(),
+ type_class = type_class,
+ wf_state = review_state,
+ state_title = portal_workflow.getTitleForStateOnType(review_state,
+ obj_type),
+ state_class = state_class,
+ is_browser_default = is_browser_default,
+ folderish = obj.is_folderish,
+ relative_url = relative_url,
+ view_url = view_url,
+ table_row_class = table_row_class,
+ is_expired = self.context.isExpired(obj),
+ #Refactor :: determine why ProxyIndex not accessible here
+ cc_status = cc_status,
+ accessibility_status = accessibility_status
+ ))
+ return results
+
+
+
+class CCTable(Table):
+ """
+ The table renders a table with sortable columns etc.
+
+ It is meant to be subclassed to provide methods for getting specific table info.
+ """
+ render = ViewPageTemplateFile("cc_table.pt")
+
+class FolderContentsCCKSSView(KSSView):
+ def update_table(self, pagenumber='1', sort_on='getObjPositionInCourse'):
+ self.request.set('sort_on', sort_on)
+ self.request.set('pagenumber', pagenumber)
+ table = FolderContentsCCTable(self.context, self.request,
+ contentFilter={'sort_on':sort_on})
+ return self.replace_table(table)
+
+ def replace_table(self, table):
+ core = self.getCommandSet('core')
+ core.replaceInnerHTML('#folderlisting-main-table', table.render())
+ return self.render()
+
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/footer.pt
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/footer.pt (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/footer.pt (revision 126)
@@ -0,0 +1,18 @@
+
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/icon_document_actions.pt
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/icon_document_actions.pt (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/icon_document_actions.pt (revision 126)
@@ -0,0 +1,65 @@
+
+
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/interfaces.py
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/interfaces.py (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/interfaces.py (revision 126)
@@ -0,0 +1,89 @@
+##################################################################################
+# Copyright (C) 2007 Utah State University, All rights reserved.
+#
+# 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+#
+##################################################################################
+
+__author__ = 'David Ray, Jon Thomas, Brent Lambert'
+__docformat__ = 'restructuredtext'
+__version__ = "$Revision: 1 $"[11:-2]
+
+
+from zope.publisher.interfaces.browser import IBrowserView
+from zope.viewlet.interfaces import IViewletManager
+from zope.interface import Interface
+from zope import schema
+from zope.schema import Iterable
+
+class ITemplateForm(Interface):
+ """ Template form. """
+
+ template = schema.Choice(title=u'Template Selector',
+ description=u'Choose a template to apply to your object.',
+ required=True,
+ vocabulary="Template Choices")
+
+class IFeedbackForm(Interface):
+ """ Feedback form for end users. """
+
+ name = schema.TextLine(title=u'Name',
+ description=u'Please Provide us with your name so we know who you are.',
+ required=False)
+
+ email = schema.TextLine(title=u'Email',
+ description=u'Please provide us with your email so that we can contact you if necessary.',
+ required=False)
+
+ subject = schema.TextLine(title=u'Subject',
+ description=u'A simple statement indicating the nature of your feedback.',
+ required=False)
+
+ body = schema.Text(title=u'Comments',
+ description=u'Please include any comments you would like us to hear.',
+ required=True)
+
+class IReportContentForm(Interface):
+ """ Report Content form for end users. """
+
+ name = schema.TextLine(title=u'Name',
+ description=u'Please provide us with your name so we know who you are.',
+ required=False)
+
+ email = schema.TextLine(title=u'Email',
+ description=u'Please provide us with your email so that we can contact you if necessary.',
+ required=False)
+
+ body = schema.Text(title=u'Comments',
+ description=u'Please provide comments regarding the nature of the inappropriate content.',
+ required=True)
+
+
+
+class IAfterTitle(IViewletManager):
+ """ Marker interface for after title viewlet manager. """
+
+
+class IeduCommonsSharingPageRole(Interface):
+ """A named utility providing information about roles that are managed
+ by the sharing page.
+
+ Utility names should correspond to the role name.
+ """
+
+ title = schema.TextLine(title=u"A friendly name for the role")
+
+ required_permission = schema.TextLine(title=u"Permission required to manag this local role",
+ required=False)
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/languageselector.pt
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/languageselector.pt (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/languageselector.pt (revision 126)
@@ -0,0 +1,47 @@
+
+
+
+ Title
+
+
+
+
+
+
+
+
+
+ Up one level
+
+
+
+
+ Description +
+-
+
+
-
+
+
+
+
+
+
+ - + + + +
+
+
+
+
+ Previous
+
+
+
+
+
+ Next
+
+
+
+
+
+
+
+
+ + Return to Top +
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/profslisting.pt =================================================================== --- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/profslisting.pt (revision 126) +++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/profslisting.pt (revision 126) @@ -0,0 +1,98 @@ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+ Download PDF
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/reportcontentform.py
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/reportcontentform.py (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/reportcontentform.py (revision 126)
@@ -0,0 +1,88 @@
+##################################################################################
+# Copyright (C) 2007 Utah State University, All rights reserved.
+#
+# 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+#
+##################################################################################
+
+__author__ = 'Brent Lambert'
+__docformat__ = 'restructuredtext'
+__version__ = "$Revision: 1 $"[11:-2]
+
+
+from zope.formlib.form import FormFields, action
+from plone.app.form.base import AddForm
+from zope.app.form.interfaces import WidgetInputError
+from zope.component import getMultiAdapter
+from Products.PageTemplates import PageTemplateFile
+from enpraxis.educommons import eduCommonsMessageFactory as _
+from Products.MailHost.MailHost import MailHostError
+from Products.statusmessages.interfaces import IStatusMessage
+from interfaces import IReportContentForm
+from Products.SecureMailHost.mail import Mail
+
+
+def validate_report(form, action, data):
+ """ Validate the from email address, if it exists. """
+ errors = form.validate(action, data)
+ if errors:
+ return errors
+ if data.has_key('email') and data['email']:
+ email = data['email'].encode('ascii')
+ if not form.context.MailHost.validateSingleEmailAddress(email):
+ ew = form.widgets.get('email')
+ ew._error = WidgetInputError(form.context.__name__, ew.label, _('Invalid email address'))
+ return ew._error
+
+
+class ReportContentForm(AddForm):
+ """ A form for getting feedback from end users. """
+
+ form_fields = FormFields(IReportContentForm)
+ label = u'Report Content'
+ description = u'Please complete the following form to send a report to the site administrator.'
+
+ @action(_(u'Submit'),
+ validator=validate_report,
+ name=u'Submit')
+ def action_submit(self, action, data):
+ # Convert post variables into email fields
+ message = ''
+ mto = self.context.email_from_address
+ if data.has_key('email') and data['email']:
+ mfrom='%s' %data['email'].encode('ascii')
+ else:
+ # If no return email is provided, use the TO address.
+ # Do this so that the from field will pass validation.
+ mfrom = mto
+ if data['name'] != None:
+ name = data['name']
+ message += '%s has reported the following content as inappropriate, please review: \n\n' % name
+ else:
+ message += 'The following content has been reported as inappropriate, please review: \n\n'
+ subject = 'Content Reported as Inappropriate'
+ message += '\t %s \n\n' % self.context.absolute_url()
+ message += data['body']
+ # Post the message
+ try:
+ self.context.MailHost.secureSend(message, mto=mto, mfrom=mfrom, subject=subject, charset='utf8')
+ except MailHostError, e:
+ IStatusMessage(self.request).addStatusMessage(_('Report Content request failed.'), type='error')
+ url = getMultiAdapter((self.context, self.request), name='absolute_url')()
+ self.request.response.redirect(url)
+ return ''
+
+ self.request.response.redirect('content_reported')
+ return ''
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/reusecourse.py
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/reusecourse.py (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/reusecourse.py (revision 126)
@@ -0,0 +1,174 @@
+import string, xmlrpclib, httplib
+
+from StringIO import StringIO
+from base64 import encodestring, decodestring
+
+from Products.CMFCore.utils import getToolByName
+from enpraxis.educommons import eduCommonsMessageFactory as _
+from Products.Five.browser.pagetemplatefile import ViewPageTemplateFile
+from collective.imstransport.utilities.interfaces import IIMSTransportUtility
+from enpraxis.educommons.portlet.coursebuilderform import EitherOrWidget
+
+from plone.app.form.base import AddForm
+from zope.app.form.browser import PasswordWidget
+from zope.formlib.form import FormFields, action, applyChanges
+from zope.interface import Interface
+from zope.schema.interfaces import IVocabularyFactory
+from zope.schema.vocabulary import SimpleVocabulary, SimpleTerm
+from zope.schema import TextLine, Choice
+from zope.component import getUtility
+from zope.publisher.browser import BrowserView
+
+
+class BasicAuthTransport(xmlrpclib.Transport):
+ """ taken from http://www.zope.org/Members/Amos/XML-RPC """
+ def __init__(self, username=None, password=None, verbose=0):
+ self.username=username
+ self.password=password
+ self.verbose=verbose
+
+ def request(self, host, handler, request_body, verbose=0):
+ h = httplib.HTTP(host)
+ h.putrequest("POST", handler)
+ h.putheader("Host", host)
+ h.putheader("User-Agent", self.user_agent)
+ h.putheader("Content-Type", "text/xml")
+ h.putheader("Content-Length", str(len(request_body)))
+
+ # basic auth
+ if self.username is not None and self.password is not None:
+ h.putheader("AUTHORIZATION", "Basic %s" % string.replace(
+ encodestring("%s:%s" % (self.username, self.password)),
+ "\012", ""))
+ h.endheaders()
+
+ if request_body:
+ h.send(request_body)
+
+ errcode, errmsg, headers = h.getreply()
+
+ if errcode != 200:
+ raise xmlrpclib.ProtocolError(
+ host + handler,
+ errcode, errmsg,
+ headers
+ )
+
+ return self.parse_response(h.getfile())
+
+class XMLRPC(BrowserView):
+
+ def importPackage(self, div_id, div_title, zip_title, zip_file, pkg_type, rtype):
+ if hasattr(self.context, div_id):
+ div = getattr(self.context, div_id)
+ else:
+ self.context.invokeFactory('Division', id=div_id, title=div_title)
+ div = getattr(self.context, div_id)
+
+ zip_title = self.context.generateUniqueId(zip_title)
+ div.invokeFactory('Course', zip_title)
+ course = getattr(div, zip_title)
+
+ zip_file = StringIO(decodestring(zip_file))
+
+ ims_util = getUtility(IIMSTransportUtility)
+ ims_util.importZipfile(course, zip_file, pkg_type, rtype=rtype)
+
+ def retrieveDivisions(self):
+ """ Returns the ID and Title for each Division in the target instance """
+ brains = self.context.portal_catalog.searchResults(Type='Division')
+ return [(x.id, x.Title) for x in brains]
+
+
+
+
+def remotedivisionsvocab(context):
+ """ Get the list of current divisions from OpenOCW and return it as a vocabulary """
+ ecprops = context.portal_url.portal_properties.educommons_properties
+ remote_url = ecprops.reusecourse_instance
+ remote = xmlrpclib.Server(remote_url)
+ try:
+ terms = remote.retrieveDivisions()
+ return SimpleVocabulary([SimpleTerm(x[0], x[1]) for x in terms])
+ except xmlrpclib.Fault:
+ message = _('The remote site is unavailable of configured incorrectly. Please contact an administrator.')
+ url = '%s/folder_contents' % context.absolute_url()
+ context.plone_utils.addPortalMessage(message)
+ context.request.response.redirect(url)
+
+
+
+
+
+class ICourseExportForm(Interface):
+ """ Interface for Course Export Display form """
+
+ remote_division = Choice(title=u'Division',
+ required=False,
+ vocabulary="eduCommons.remotedivisionsvocab")
+
+
+ open_ocw_username = TextLine(title=u'OpenOCW User Name',
+ description=_(u'Your user name on OpenOCW'),
+ required=True)
+
+ open_ocw_password = TextLine(title=u'OpenOCW User Password',
+ description=_(u'Your user password on OpenOCW'),
+ required=True)
+
+
+class CourseExportForm(AddForm):
+ """ Renderer for Course Export Form """
+
+ form_fields = FormFields(ICourseExportForm)
+ form_fields['remote_division'].custom_widget = EitherOrWidget
+ form_fields['open_ocw_password'].custom_widget = PasswordWidget
+
+ label = _(u'Export a Course to OpenOCW')
+ description = _(u'Reuse this course on OpenOCW. In order to do so, you must have an account at OpenOCW.org.')
+
+ def __init__(self, context, request):
+ super(CourseExportForm, self).__init__(context, request)
+ self.plone_utils = getToolByName(self.context, 'plone_utils')
+
+ @action(_(u'Reuse'),
+ name=u'Reuse')
+
+ def action_submit(self, action, data):
+ """ Reuse a course. """
+ ecprops = self.context.portal_url.portal_properties.educommons_properties
+ remote_url = ecprops.reusecourse_instance
+ rtype = 'eduCommons'
+
+ username = self.request.form['form.open_ocw_username']
+ password = self.request.form['form.open_ocw_password']
+ div_title = self.request.form['form.remote_division']
+ newdivision = self.request.form['form.newdivision']
+
+ remote=xmlrpclib.Server(remote_url,
+ BasicAuthTransport(username, password) )
+
+ course = self.context.getECParent()
+
+ zip_title = '%s.zip' % course.getId()
+ zip_file = getattr(course, zip_title).data
+ zip_file = encodestring(zip_file)
+ pkg_type = 'Default'
+
+ if not newdivision:
+ remotedivvocab = getUtility(IVocabularyFactory, name='eduCommons.remotedivisionsvocab')(self.context)
+ div_id = remotedivvocab.getTermByToken(div_title).value
+ else:
+ div_id = self.plone_utils.normalizeString(newdivision)
+ div_title = newdivision
+
+
+ remote.importPackage(div_id, div_title, zip_title, zip_file, pkg_type, rtype)
+
+ del zip_file
+ del remote
+
+ # Redirect to the the login page at the remote instance, with the appropriate came_form var
+ new_course_url = '%s/login_form' % remote_url
+ self.request.RESPONSE.redirect(new_course_url)
+
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/rss.pt
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/rss.pt (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/rss.pt (revision 126)
@@ -0,0 +1,27 @@
+
++ Title or id +
+ +
+ description
+
+
+
+
+
+
+ RSS Feeds
+
+
+
+ RSS Feeds
+
+
+
+
+ The body
+
+
+
+
+
+
+
+
+
+
+ Professor Name +
++ There are currently no results for this search. +
+ +
+
+
+
+
+
+
+ 
+
+
+
+
+
+
+
+
+
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/rss_template.pt
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/rss_template.pt (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/rss_template.pt (revision 126)
@@ -0,0 +1,131 @@
+
++ title or id +
+ + + ++ Description +
+ + + + ++ Receive notification of new OCW courses on your desktop, or add them to your blog or website. +
+ +Available Feeds
++ RSS FAQs +
+
+
+
+
+
+
+ Courses in all departments
+
+
+
Department Feeds
+ + + + +What is RSS?
+ +RSS stands for Really Simple Syndication. RSS is a time-saving way for you to receive news and information updates (often called 'RSS feeds', 'news feeds' or simply 'feeds') from your favorite Web sites and blogs.
+ +Typically RSS feeds consist of headlines and short summaries of new articles, blog entries or search results, though some Web sites and blogs offer the full text of articles or blog entrees as feeds.
+ +Why use RSS?
+ +By using RSS you can stay on top of the news and information you need without using your e-mail system and without repeatedly checking multiple Web sites to see if they have been updated. RSS simplifies the way you stay informed and helps you take control of overloaded email inboxes.
+ +How to I start using RSS feeds?
+ +In general, the first thing you need is something called a news reader. This is a piece of software that checks RSS feeds and lets you read any new articles that have been added to them. There are many different versions, some of which are accessed using a browser, and some of which are downloadable applications. Browser-based news readers let you catch up with your RSS feed subscriptions from any computer, whereas downloadable applications let you store them on your main computer, in the same way that you either download your e-mail, or keep it on a web-based service.
+ +Once you have chosen a news reader, all you have to do is to decide what content you want to receive in your news reader, by finding and subscribing to the relevant RSS feeds. For example, if you would like the latest courses added to OCW, simply visit the Course List page or this page and you will notice an orange RSS button.
+ +
+
+ If you click on the button you can subscribe to the feed in various ways, including by dragging the URL of the RSS feed into your news reader or by cutting and pasting the same URL into a new feed in your news reader. Most sites that offer RSS feeds use a similar orange RSS button, but some may just have a normal web link to the feed.
+ +Some browsers, including Firefox and Safari, automatically check for RSS feeds for you when you visit a Web site, and display an icon when they find one. This can make subscribing to RSS feeds much easier. For more details on these, please check their Web sites.
+ +How do I get a news reader?
+ +There is a range of different news readers available and new versions are appearing all the time.
+ +Different news readers work on different operating systems, so you will need to choose one that will work with your computer.
+ +Here is one + + list + + of available readers from Google.
+ ++ Return to Top +
+ + +This material was created or adapted from material created by MIT OCW, Copyright © 2007 MIT in accordance with the MIT OCW Terms of Use, http://ocw.mit.edu/OcwWeb/Global/terms-of-use.htm.
+ + + + + + + + +
+
+
+
+
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/sharing.py
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/sharing.py (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/sharing.py (revision 126)
@@ -0,0 +1,417 @@
+from zope.component import getUtilitiesFor, queryUtility, getMultiAdapter
+
+from Products.Five.browser import BrowserView
+from Products.Five.browser.pagetemplatefile import ViewPageTemplateFile
+
+from Acquisition import aq_inner, aq_parent, aq_base
+from AccessControl import Unauthorized
+from zExceptions import Forbidden
+
+from Products.CMFCore.utils import getToolByName
+from Products.CMFCore import permissions
+from Products.CMFPlone import PloneMessageFactory as _
+
+from plone.memoize.instance import memoize, clearafter
+
+from plone.app.workflow.interfaces import ISharingPageRole
+
+from enpraxis.educommons.browser.interfaces import IeduCommonsSharingPageRole
+
+AUTH_GROUP = 'AuthenticatedUsers'
+STICKY = (AUTH_GROUP,)
+
+class SharingView(BrowserView):
+
+ # Actions
+ template = ViewPageTemplateFile('sharing.pt')
+
+ def __call__(self):
+ """Perform the update and redirect if necessary, or render the page
+ """
+
+ postback = True
+
+ form = self.request.form
+ submitted = form.get('form.submitted', False)
+
+ save_button = form.get('form.button.Save', None) is not None
+ cancel_button = form.get('form.button.Cancel', None) is not None
+
+ if submitted and not cancel_button:
+
+ if not self.request.get('REQUEST_METHOD','GET') == 'POST':
+ raise Forbidden
+
+ # Update the acquire-roles setting
+ inherit = bool(form.get('inherit', False))
+ self.update_inherit(inherit)
+
+ # Update settings for users and groups
+ entries = form.get('entries', [])
+ roles = [r['id'] for r in self.roles()]
+ settings = []
+ for entry in entries:
+ settings.append(
+ dict(id = entry['id'],
+ type = entry['type'],
+ roles = [r for r in roles if entry.get('role_%s' % r, False)]))
+ if settings:
+ self.update_role_settings(settings)
+
+ # Other buttons return to the sharing page
+ if cancel_button:
+ postback = False
+
+ if postback:
+ return self.template()
+ else:
+ context_state = self.context.restrictedTraverse("@@plone_context_state")
+ url = context_state.view_url()
+ self.request.response.redirect(url)
+
+ # View
+
+ @memoize
+ def roles(self):
+ """Get a list of roles that can be managed.
+
+ Returns a list of dics with keys:
+
+ - id
+ - title
+ """
+ context = aq_inner(self.context)
+ portal_membership = getToolByName(context, 'portal_membership')
+
+ pairs = []
+
+ #check to see if OpenOCW installed
+ portal_setup = self.aq_parent.portal_setup
+ if 'openOCW-final' in portal_setup.getImportStepRegistry().listSteps():
+ #user default sharing page roles
+ for name, utility in getUtilitiesFor(ISharingPageRole):
+ permission = utility.required_permission
+ if permission is None or portal_membership.checkPermission(permission, context):
+ pairs.append(dict(id = name, title = utility.title))
+ else:
+ #use eduCommons sharing page roles
+ for name, utility in getUtilitiesFor(IeduCommonsSharingPageRole):
+ permission = utility.required_permission
+ if permission is None or portal_membership.checkPermission(permission, context):
+ pairs.append(dict(id = name, title = utility.title))
+
+ pairs.sort(lambda x, y: cmp(x['id'], y['id']))
+ return pairs
+
+ @memoize
+ def role_settings(self):
+ """Get current settings for users and groups for which settings have been made.
+
+ Returns a list of dicts with keys:
+
+ - id
+ - title
+ - type (one of 'group' or 'user')
+ - roles
+
+ 'roles' is a dict of settings, with keys of role ids as returned by
+ roles(), and values True if the role is explicitly set, False
+ if the role is explicitly disabled and None if the role is inherited.
+ """
+
+ existing_settings = self.existing_role_settings()
+ user_results = self.user_search_results()
+ group_results = self.group_search_results()
+
+ return existing_settings + user_results + group_results
+
+ def inherited(self, context=None):
+ """Return True if local roles are inherited here.
+ """
+ if context is None:
+ context = self.context
+ if getattr(aq_base(context), '__ac_local_roles_block__', None):
+ return False
+ return True
+
+ # helper functions
+
+ @memoize
+ def existing_role_settings(self):
+ """Get current settings for users and groups that have already got
+ at least one of the managed local roles.
+
+ Returns a list of dicts as per role_settings()
+ """
+ context = aq_inner(self.context)
+
+ portal_membership = getToolByName(aq_inner(self.context), 'portal_membership')
+ portal_groups = getToolByName(aq_inner(self.context), 'portal_groups')
+ portal = getToolByName(aq_inner(self.context), 'portal_url').getPortalObject()
+ acl_users = getattr(portal, 'acl_users')
+
+ info = []
+
+ # This logic is adapted from computeRoleMap.py
+
+ local_roles = acl_users.getLocalRolesForDisplay(context)
+ acquired_roles = self._inherited_roles()
+ available_roles = [r['id'] for r in self.roles()]
+
+ # first process acquired roles
+ items = {}
+ for name, roles, rtype, rid in acquired_roles:
+ items[rid] = dict(id = rid,
+ name = name,
+ type = rtype,
+ sitewide = [],
+ acquired = roles,
+ local = [],)
+
+ # second process local roles
+ for name, roles, rtype, rid in local_roles:
+ if items.has_key(rid):
+ items[rid]['local'] = roles
+ else:
+ items[rid] = dict(id = rid,
+ name = name,
+ type = rtype,
+ sitewide = [],
+ acquired = [],
+ local = roles,)
+
+ # Make sure we always get the authenticated users virtual group
+ if AUTH_GROUP not in items:
+ items[AUTH_GROUP] = dict(id = AUTH_GROUP,
+ name = _(u'Logged-in users'),
+ type = 'group',
+ sitewide = [],
+ acquired = [],
+ local = [],)
+
+ # Sort the list: first the authenticated users virtual group, then
+ # all other groups and then all users, alphabetically
+
+ dec_users = [( a['id'] not in STICKY,
+ a['type'],
+ a['name'],
+ a) for a in items.values()]
+ dec_users.sort()
+
+ # Add the items to the info dict, assigning full name if possible.
+ # Also, recut roles in the format specified in the docstring
+
+ for d in dec_users:
+ item = d[-1]
+ name = item['name']
+ rid = item['id']
+ global_roles = set()
+
+ if item['type'] == 'user':
+ member = acl_users.getUserById(rid)
+ if member is not None:
+ name = member.getProperty('fullname') or member.getId() or name
+ global_roles = set(member.getRoles())
+ elif item['type'] == 'group':
+ g = portal_groups.getGroupById(rid)
+ name = g.getGroupTitleOrName()
+ global_roles = set(g.getRoles())
+
+ # This isn't a proper group, so it needs special treatment :(
+ if rid == AUTH_GROUP:
+ name = _(u'Logged-in users')
+
+ info_item = dict(id = item['id'],
+ type = item['type'],
+ title = name,
+ roles = {})
+
+ # Record role settings
+ have_roles = False
+ for r in available_roles:
+ if r in global_roles:
+ info_item['roles'][r] = 'global'
+ elif r in item['acquired']:
+ info_item['roles'][r] = 'acquired'
+ have_roles = True # we want to show acquired roles
+ elif r in item['local']:
+ info_item['roles'][r] = True
+ have_roles = True # at least one role is set
+ else:
+ info_item['roles'][r] = False
+
+ if have_roles or rid in STICKY:
+ info.append(info_item)
+
+ return info
+
+ def user_search_results(self):
+ """Return search results for a query to add new users
+
+ Returns a list of dicts, as per role_settings()
+ """
+ context = aq_inner(self.context)
+ acl_users = getToolByName(context, 'acl_users')
+
+ search_term = self.request.form.get('search_term', None)
+ if not search_term:
+ return []
+
+ existing_users = set([u['id'] for u in self.existing_role_settings()
+ if u['type'] == 'user'])
+ empty_roles = dict([(r['id'], False) for r in self.roles()])
+ info = []
+
+ hunter = getMultiAdapter((context, self.request), name='pas_search')
+ for userinfo in hunter.searchUsers(fullname=search_term):
+ userid = userinfo['userid']
+ if userid not in existing_users:
+ user = acl_users.getUserById(userid)
+ roles = empty_roles.copy()
+ for r in user.getRoles():
+ if r in roles:
+ roles[r] = 'global'
+ info.append(dict(id = userid,
+ title = user.getProperty('fullname') or user.getId() or userid,
+ type = 'user',
+ roles = roles))
+ return info
+
+ def group_search_results(self):
+ """Return search results for a query to add new groups
+
+ Returns a list of dicts, as per role_settings()
+ """
+ context = aq_inner(self.context)
+ portal_groups = getToolByName(context, 'portal_groups')
+
+ search_term = self.request.form.get('search_term', None)
+ if not search_term:
+ return []
+
+ existing_groups = set([g['id'] for g in self.existing_role_settings()
+ if g['type'] == 'group'])
+ empty_roles = dict([(r['id'], False) for r in self.roles()])
+ info = []
+
+ hunter = getMultiAdapter((context, self.request), name='pas_search')
+ for groupinfo in hunter.searchGroups(id=search_term):
+ groupid = groupinfo['groupid']
+ if groupid not in existing_groups:
+ group = portal_groups.getGroupById(groupid)
+ roles = empty_roles.copy()
+ for r in group.getRoles():
+ if r in roles:
+ roles[r] = 'global'
+ info.append(dict(id = groupid,
+ title = group.getGroupTitleOrName(),
+ type = 'group',
+ roles = roles))
+ return info
+
+ def _inherited_roles(self):
+ """Returns a tuple with the acquired local roles."""
+ context = aq_inner(self.context)
+
+ if not self.inherited(context):
+ return []
+
+ portal = getToolByName(context, 'portal_url').getPortalObject()
+ result = []
+ cont = True
+ if portal != context:
+ parent = aq_parent(context)
+ while cont:
+ if not getattr(parent, 'acl_users', False):
+ break
+ userroles = parent.acl_users._getLocalRolesForDisplay(parent)
+ for user, roles, role_type, name in userroles:
+ # Find user in result
+ found = 0
+ for user2, roles2, type2, name2 in result:
+ if user2 == user:
+ # Check which roles must be added to roles2
+ for role in roles:
+ if not role in roles2:
+ roles2.append(role)
+ found = 1
+ break
+ if found == 0:
+ # Add it to result and make sure roles is a list so
+ # we may append and not overwrite the loop variable
+ result.append([user, list(roles), role_type, name])
+ if parent == portal:
+ cont = False
+ elif not self.inherited(parent):
+ # Role acquired check here
+ cont = False
+ else:
+ parent = aq_parent(parent)
+
+ # Tuplize all inner roles
+ for pos in range(len(result)-1,-1,-1):
+ result[pos][1] = tuple(result[pos][1])
+ result[pos] = tuple(result[pos])
+
+ return tuple(result)
+
+ def update_inherit(self, status=True):
+ """Enable or disable local role acquisition on the context.
+ """
+ context = aq_inner(self.context)
+ portal_membership = getToolByName(context, 'portal_membership')
+
+ if not portal_membership.checkPermission(permissions.ModifyPortalContent, context):
+ raise Unauthorized
+
+ if not status:
+ context.__ac_local_roles_block__ = True
+ else:
+ if getattr(aq_base(context), '__ac_local_roles_block__', None):
+ context.__ac_local_roles_block__ = None
+
+ context.reindexObjectSecurity()
+
+ @clearafter
+ def update_role_settings(self, new_settings):
+ """Update local role settings and reindex object security if necessary.
+
+ new_settings is a list of dicts with keys id, for the user/group id;
+ type, being either 'user' or 'group'; and roles, containing the list
+ of role ids that are set.
+ """
+
+ reindex = False
+ context = aq_inner(self.context)
+
+ managed_roles = frozenset([r['id'] for r in self.roles()])
+ member_ids_to_clear = []
+ for s in new_settings:
+ user_id = s['id']
+
+ existing_roles = frozenset(context.get_local_roles_for_userid(userid=user_id))
+ selected_roles = frozenset(s['roles'])
+
+ # We will remove those roles that we are managing and which set
+ # on the context, but which were not selected
+ to_remove = (managed_roles & existing_roles) - selected_roles
+
+ # Leaving us with the selected roles, less any roles that we
+ # want to remove
+ new_roles = (selected_roles | existing_roles) - to_remove
+
+ # take away roles that we are managing, that were not selected
+ # and which were part of the existing roles
+
+ if new_roles:
+ context.manage_setLocalRoles(user_id, list(new_roles))
+ reindex = True
+ elif existing_roles:
+ member_ids_to_clear.append(user_id)
+
+ if member_ids_to_clear:
+ context.manage_delLocalRoles(userids=member_ids_to_clear)
+ reindex = True
+
+ if reindex:
+ self.context.reindexObjectSecurity()
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/skinless.py
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/skinless.py (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/skinless.py (revision 126)
@@ -0,0 +1,12 @@
+
+
+if context.Type() == 'Page':
+ title = context.Title()
+ content = context.CookedBody(stx_level=2)
+elif context.Type() == 'Division':
+ title = context.Title()
+ content = context.text()
+else:
+ title = context.portal_ECObjectTool.getFullCourseTitle(context)
+ content = context.text()
+return title, content
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/skinless_byline_view.pt
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/skinless_byline_view.pt (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/skinless_byline_view.pt (revision 126)
@@ -0,0 +1,50 @@
++ Sharing for + "title" +
+ +-
+
- + Info + +
- + You are adjusting the sharing privileges for a default view in a container. + To adjust them for the entire container, + go here. + +
+ You can control who can view and edit your item using the list below. +
+ + + +
+
+
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/skinless_view.pt
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/skinless_view.pt (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/skinless_view.pt (revision 126)
@@ -0,0 +1,73 @@
+Citation: Citation Info
+
+
+
+
+ ![]()
+ ![]()
+
+
+
+
+
+ This work is licensed under a
+
+
+ Creative Commons License.
+
+
+ All Rights Reserved.
+
+
+
+
+
+
+
+
+
+
+
+
+
++ Title or id +
+ ++ Description +
+ +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Courses
+ + ++ + + + + + +
+ + + + ++ There are currently no items in this folder. +
+
+
+
+
+
+
+
+
+
+ Cross Listed Courses
+ + ++ + + + + + + + +
+ + + + +
+
+
+
+
+
+
+
+
+ Other Resources
+ + ++ + + + + + + + +
+ + + + +
+
+
+ «
+
+ Previous
+ n
+ items
+
+
+
+
+
+
+
+ Next
+ n
+ items
+
+ »
+
+
+
+
+
+ 1
+
+ ...
+
+
+
+
+
+
+
+
+
+
+
+
+
+ [Current page number]
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ...
+
+ 3457
+
+
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/summary_table.pt
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/summary_table.pt (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/summary_table.pt (revision 126)
@@ -0,0 +1,149 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/summarycontents.py
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/summarycontents.py (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/summarycontents.py (revision 126)
@@ -0,0 +1,164 @@
+from zope.component import getMultiAdapter
+from Products.CMFCore.utils import getToolByName
+from plone.app.content.browser.foldercontents import FolderContentsView, FolderContentsTable
+import urllib
+from zope.component import getUtility
+from enpraxis.educommons.utilities.interfaces import IECUtility
+from plone.app.content.browser.tableview import Table
+from kss.core import KSSView
+from zope.app.pagetemplate import ViewPageTemplateFile
+from Acquisition import aq_parent, aq_inner
+from zope.annotation import IAnnotations
+
+
+
+class SummaryContentsView(FolderContentsView):
+ """
+ Override contents table to use FindECParent and use SummaryContentsTable
+ """
+
+ def contents_table(self):
+ ecutil = getUtility(IECUtility)
+ parent = ecutil.FindECParent(self.context)
+ path = '/'.join(parent.getPhysicalPath())
+ request = self.request
+ if request.has_key('state'):
+ review_state = request['state']
+ else:
+ review_state = ''
+ table = SummaryContentsTable(parent, self.request, contentFilter={'path':path,'review_state':review_state})
+ return table.render()
+
+
+class SummaryContentsTable(FolderContentsTable):
+ """
+ The foldercontents table renders the table and its actions.
+ """
+
+
+ def __init__(self, context, request, contentFilter={}):
+ """
+ Initialize the table
+ """
+ super(SummaryContentsTable, self).__init__(context, request, contentFilter)
+
+ url = self.context.absolute_url()
+ view_url = url + '/summary_contents'
+ self.table = SummaryTable(request, url, view_url, self.items,
+ show_sort_column=self.show_sort_column,
+ buttons=self.buttons)
+
+ @property
+ def items(self):
+ """
+ """
+ plone_utils = getToolByName(self.context, 'plone_utils')
+ plone_view = getMultiAdapter((self.context, self.request), name=u'plone')
+ portal_workflow = getToolByName(self.context, 'portal_workflow')
+ portal_properties = getToolByName(self.context, 'portal_properties')
+ site_properties = portal_properties.site_properties
+
+ use_view_action = site_properties.getProperty('typesUseViewActionInListings', ())
+ browser_default = self.context.browserDefault()
+
+
+ contentsMethod = self.context.queryCatalog
+
+ results = list()
+ for i, obj in enumerate(contentsMethod(self.contentFilter)):
+ if i % 2 == 0:
+ table_row_class = "draggable even"
+ else:
+ table_row_class = "draggable odd"
+
+ url = obj.getURL()
+ path = obj.getPath or "/".join(obj.getPhysicalPath())
+ icon = plone_view.getIcon(obj);
+
+ type_class = 'contenttype-' + plone_utils.normalizeString(
+ obj.portal_type)
+
+ review_state = obj.review_state
+ state_class = 'state-' + plone_utils.normalizeString(review_state)
+ relative_url = obj.getURL(relative=True)
+ obj_type = obj.portal_type
+
+ modified = plone_view.toLocalizedTime(
+ obj.ModificationDate, long_format=1)
+
+ if obj_type in use_view_action:
+ view_url = url + '/view'
+ elif obj.is_folderish:
+ view_url = url + "/folder_contents"
+ else:
+ view_url = url
+
+ is_browser_default = len(browser_default[1]) == 1 and (
+ obj.id == browser_default[1][0])
+
+ if IAnnotations(obj.getObject()).has_key('eduCommons.clearcopyright'):
+ cc_status = IAnnotations(obj.getObject())['eduCommons.clearcopyright']
+ else:
+ cc_status = False
+
+ results.append(dict(
+ url = url,
+ id = obj.getId,
+ quoted_id = urllib.quote_plus(obj.getId),
+ path = path,
+ title_or_id = obj.pretty_title_or_id(),
+ description = obj.Description,
+ obj_type = obj_type,
+ size = obj.getObjSize,
+ modified = modified,
+ icon = icon.html_tag(),
+ type_class = type_class,
+ wf_state = review_state,
+ state_title = portal_workflow.getTitleForStateOnType(review_state,
+ obj_type),
+ state_class = state_class,
+ is_browser_default = is_browser_default,
+ folderish = obj.is_folderish,
+ relative_url = relative_url,
+ view_url = view_url,
+ table_row_class = table_row_class,
+ is_expired = self.context.isExpired(obj),
+ cc_status = cc_status,
+ ))
+ return results
+
+ @property
+ def buttons(self):
+ buttons = []
+ portal_actions = getToolByName(self.context, 'portal_actions')
+ button_actions = portal_actions.listActionInfos(object=aq_inner(self.context), categories=('folder_buttons', ))
+
+ # Do not show buttons if there is no data, unless there is data to be
+ # pasted
+ if not len(self.items):
+ return []
+
+ for button in button_actions:
+ # Make proper classes for our buttons
+ if button['id'] not in ['paste','cut','copy','import']:
+ buttons.append(self.setbuttonclass(button))
+ return buttons
+
+class SummaryTable(Table):
+ """
+ The table renders a table that is
+
+ the summary portlet.
+
+ """
+
+ render = ViewPageTemplateFile("summary_table.pt")
+ batching = ViewPageTemplateFile("summary_batching.pt")
+
+class SummaryContentsKSSView(KSSView):
+ def update_table(self, pagenumber='1', sort_on='getObjPositionInCourse'):
+ self.request.set('sort_on', sort_on)
+ self.request.set('pagenumber', pagenumber)
+ table = SummaryContentsTable(self.context, self.request,
+ contentFilter={'sort_on':sort_on})
+ return self.replace_table(table)
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/table.pt
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/table.pt (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/table.pt (revision 126)
@@ -0,0 +1,147 @@
++ This folder has no visible items. To add content, press the + add button, or paste content from another location. +
+ +|
+ All |
+ |||||
|---|---|---|---|---|---|
| + | |
+ |
+ |
+ |
+
+ |
+
| + + + + | +
+
+ |
+
+ + + size + | ++ 08/19/2001 03:01 AM + | ++ + + | ++ © + | +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/templatechooser.py
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/templatechooser.py (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/templatechooser.py (revision 126)
@@ -0,0 +1,79 @@
+##################################################################################
+# Copyright (C) 2007 Utah State University, All rights reserved.
+#
+# 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+#
+##################################################################################
+
+__author__ = 'David Ray, John Thomas, Brent Lambert'
+__docformat__ = 'restructuredtext'
+__version__ = "$Revision: 1 $"[11:-2]
+
+
+from zope.formlib.form import PageForm, FormFields, action
+from zope.app.form.interfaces import WidgetInputError
+from zope.component import getMultiAdapter
+from Products.PageTemplates import PageTemplateFile
+from enpraxis.educommons import eduCommonsMessageFactory as _
+from Products.MailHost.MailHost import MailHostError
+from Products.statusmessages.interfaces import IStatusMessage
+from interfaces import ITemplateForm
+
+from Products.CMFDefault.formlib.widgets import ChoiceRadioWidget
+
+from zope.interface import implements
+from zope.component import getUtility
+from zope.schema.vocabulary import SimpleVocabulary
+
+
+
+def templateVocabulary(context):
+ template_actions = context.portal_actions.listActionInfos(object=context, categories=('template_buttons'))
+ items = ()
+ for template_action in template_actions:
+ id = template_action['id']
+ title = str(template_action['title'])
+ items += (title, id),
+
+ return SimpleVocabulary.fromItems(items)
+
+
+class TemplateForm(PageForm):
+ """ A form for selecting templates on objects """
+
+ form_fields = FormFields(ITemplateForm)
+ form_fields['template'].custom_widget = ChoiceRadioWidget
+
+ label = u'Template Chooser'
+ description = u'Preview and choose templates for your content object'
+
+
+ @action(_(u'Apply Template', default=u'Apply Template'),
+ name=u'Submit')
+ def action_submit(self, action, data):
+ # Apply the template
+ if data.has_key('template') and data['template']:
+ context = self.context
+ template = '@@%s' % data['template']
+ template = context.restrictedTraverse(str(template))
+ text = template(context)
+ context.setText(text)
+ if data['template'] in ['syllabus_view']:
+ context.setPresentation(True)
+ self.request.response.redirect('view')
+
+ return ''
+
+
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/templates/__init__.py
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/templates/__init__.py (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/templates/__init__.py (revision 126)
@@ -0,0 +1,1 @@
+# make directory a product
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/templates/aboutprof_view.pt
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/templates/aboutprof_view.pt (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/templates/aboutprof_view.pt (revision 126)
@@ -0,0 +1,29 @@
++ This folder has no visible items. To add content, press the + add button, or paste content from another location. +
+ +| + | |
+ |
+ |
+ |
+
+ |
+
|---|---|---|---|---|---|
| + + + + | +
+
+ |
+
+ + + size + | ++ 08/19/2001 03:01 AM + | ++ + + | ++ + ▲ + + + + ▼ + + | +
+
+
+
+
+
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/templates/abouttext_view.pt
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/templates/abouttext_view.pt (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/templates/abouttext_view.pt (revision 126)
@@ -0,0 +1,37 @@
+|
+
+ |
+
+ Professor X, Ph.D.+Department Head / Professor +Department Name Additional notes about Professor X. + + |
+
About OpenCourseWare
++This site is involved in making course materials available through an open content license. +
+ ++More information about this site: +
+ +-
+
- Terms of Use +
- Privacy Policy +
About eduCommons
+ +eduCommons' goals are to:
+ +-
+
- Provide free, searchable, access to course materials for educators, + students, and self-learners around the world. +
- Catalyze the growth of communities of learners. +
- Extend the reach and impact of the "opencourseware" concept. +
Appreciation
+ +eduCommons would not be possible without:
+ +-
+
- Generous funding from the William and Flora Hewlett Foundation. + +
- Generous support from MIT OpenCourseWare + including sharing their process documentation which has contributed significantly to the success of eduCommons. +
Checklist for Accessibility
+Creating accessible Web-based resources is a necessary step towards a classroom environment that supports the learning needs of all students. This checklist identifies several of the basic steps relevant to creating accessible Web-based resources in an educational setting; it is not a complete list to creating accessible Web content.
+| Accessibility Issue | +Yes | +No | +N/A | +
|---|---|---|---|
| Appropriate text descriptions for images. | +|||
| Transcript or alternative provided for audio content. | +|||
| Captioning provided for video/media content. | +|||
| At least one video is opened on the user's computer (i.e., video is not embedded on the Web page). | +|||
| Hyperlinks provide clear information as to end location or function. | +|||
| Other elements beside color are used to convey information (e.g., asterisk, etc.). | +|||
| Sufficient color contrast is present to differentiate between the foreground and background. | +|||
| Tables with data have appropriate row and column headers identified. | +|||
| MS PowerPoint presentations accessible or are available in an accessible format | +|||
| Adobe PDF documents are accessible or available in an accessible format | +|||
| Interactive experiences are accessible or alternate available that conveys the same educational objectives. | +
+
This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 United States License.
+ 2008, High Tech Center Training Unit of the California Community Colleges
+
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/templates/configure.zcml
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/templates/configure.zcml (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/templates/configure.zcml (revision 126)
@@ -0,0 +1,92 @@
+This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 United States License.
+ 2008, High Tech Center Training Unit of the California Community Colleges
+
+
+
+
+
+
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/templates/division_view.pt
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/templates/division_view.pt (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/templates/division_view.pt (revision 126)
@@ -0,0 +1,30 @@
+|
+
+ |
+
+ COURSE TITLE+Professor X, Ph.D. +Department Name Course Structure: Hour long classes - four times a week + + |
+
Course Description
+ ++ Put any additional information about the course not in the right hand side of the box here. +
+ +
+
+
+
+
+
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/templates/faq_view.pt
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/templates/faq_view.pt (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/templates/faq_view.pt (revision 126)
@@ -0,0 +1,780 @@
+|
+
+ |
+
+ Department Name+ +Institution Name +ABOUT THE DEPARTMENT ++ Link to Department...Tu es Petrus, et super hanc petram aedificabo Ecclesiam meam, + et portae inferi non praevalebunt adversum eam. Et tibi dabo claves regni coelorum. + + |
+
+ This document provides the help for the
+
About eduCommons
+-
+
What is
+ +The idea behind
+ + + + +Why is
+ +Because technology makes it possible for us to increase the reach of +educational opportunity, we have a moral obligation to do so.
+ + + + +How does
+ +
+ +Many individual faculty members at
+ + + + +What are the long-term goals of the
+ +We expect
+ + + + +Will
+ +We are committed to
+ + +
Using eduCommons OCW Materials
+-
+
+
Do I need to register to use
+ +Because
+ + + + +Where are the course materials?
+ +To find what courses are available at this time, view the complete course list. +Once you have accessed a particular course site, the left-hand +navigation bar of each course homepage will detail what materials are +available for that individual course.
+ + + + +How do I find what courses are available?
+ +You can, utilize the Search function that can be found in the right-hand corner of every page on the +
+ + +Or, to see what courses are available is to click on Courses in the top navigation bar on every page of the +
+ + + + +How can I use
+ +
+ + + + +What are the prerequisites to use
+ +Because
+ + + + +Does
+ +
+ + + + +How do I get a copy of the course pack for a particular
+ +The course-pack materials that accompany most
+ + + + +I have seen (or I am/represent) an +individual, organization, or institution that offers to teach
+ +No,
+ + + + +Can I/my organization state on our Web site or in our literature that we make use of
+ +To reference
+ +[See also Intellectual Property]
+ + + + +Can I link to the
+Links to
+ +In addition to meeting the terms of the license, links to
+ +[See also Intellectual Property]
+ + + +
Content
+-
+
+
Why is there such variation in the breadth and depth of content presented on individual
+ +Each
+ + + + +Why do some
+In some cases, solutions to homework assignments, quizzes, and exams +are only discussed and presented in the classroom, and not made +available in print or electronic format to the
+ + + + +Why doesn't every
+Although video lectures are useful for students, there are many reasons +that
+ +Another key concern about video is cost. The technology for +compressing and storing video becomes more and more affordable by the +day, but it is still not affordable, or feasible from a production +standpoint, for us to be compressing 20 video lectures for all of our +courses.
+ +A key
+ + + +
Intellectual Property
+-
+
+
Who owns the intellectual property published on the
+ +Prior to making any course materials publicly available, the
+ +The intellectual property policies created for
+ + + + +What are the Terms of Use for
+ +See the Terms of Use for more information.
+ + +If you would like to use
+ + + +What are the Terms of Use for the discussion software?
+ +See the Terms of Use for more information.
+ + +How does
+ +A commercial use would involve the assessment of a direct or indirect +fee for use of the
+ + +How do I properly cite my reuse of
+ +To reuse or repost materials from
+ +For your convenience, at the bottom of each page, we provide a citation in APA format, a copyright statement and a license for that page.
+ +Or you may chose to cite the resource in the following manner: "This material was created by or adapted from material created by
+ +As an example, the citation for "Understanding Online Interaction" +taught by Utah State University Professor David Wiley would read, "This material was +created or adapted from material created by Utah State University faculty member David +Wiley, Associate Professor. Copyright © 2004, David Wiley."
+ + +If you want to use the course materials on your Web site, and the materials are licensed using a Creative Commons license, you must also +include a copy of the Creative Commons license, or +clear and reasonable link to its URL (for example, http://creativecommons.org/licenses/by-nc-sa/2.5/), with every copy of the materials or the derivative work(s) you create from it.
+ + + + +How can I contribute my own educational materials to
+ +The intent of
+ + + +What do I do if I believe a portion of
+ +
+ +To file the notification, you must be either the copyright +owner of the work or an individual authorized to act on behalf of the +copyright owner. Your notification must include: +
+ +-
+
+
- Identification of the copyrighted work, or, in the case of multiple +works at the same location, a representative list of such works at that +site. + +
- Identification of the material that is claimed to be infringing or +to be the subject of infringing activity. You must include sufficient +information, such as a specific URL or other specific identification, +for us to locate the material. + +
- Information for us to be able to contact the claimant (e.g., email address, phone number). + +
- A statement that the claimant believes that the use of the material +has not been authorized by the copyright owner or an authorized agent. + +
- A statement that the information in the notification is accurate +and that the claimant is, or is authorized to act on behalf of, the +copyright owner. + +
If you do not include an electronic signature with +your claim, you may be asked to send or fax a follow-up copy with a +signature.
+ + +
eduCommons Faculty
+-
+
+
Are
+ +Participation of
+ + + + +How do I contact a specific member of the
+ +
+ + + + +Will inquiries to
+ +Yes inquiries will be answered.
+ + +
Translations
+-
+
+
Can I translate the course materials in
+ +You may translate course materials in
+ +"These
+ + [See Also How do I properly cite my reuse of
Usability
+-
+
+
What are the technical requirements for viewing
+ +The majority of
+ + + + +What is metadata and why is it important to
+ +Metadata is, literally, "data about data." Metadata can be better +understood as information that describes other information. For +example, this Web page of FAQs for
+ + + + +How do I change the font-size on the
+ +The fonts and style of the
+ + + + +Will the
+ +All course materials published on the
+ + + +How can I ensure my content is accessible?
+ +While there is no automated way to ensure that a piece of content is entirely accessible, you can review and implement, as needed, the accessibility guidelines. + +
+ + + +Why does this PDF not open correctly in copy of Adobe Acrobat Reader?
+ +A small percentage of the PDF documents offered on the
+ + +
Privacy and Data Collection
+-
+
+
What information does
+ +The information we learn from visitors helps us improve the
+ + +-
+
+
-
+Information You Provide: We receive and store any +information you enter on our Web site or give us in any other way. You +provide most such information when you submit feedback on the site, +contact us by email, or agree to participate in a visitor survey. This +information may include your name and email address, your academic +status, your institution, your geographic region, how you are using+
+
+
-
+Automatic Information: We receive and store certain types +of information whenever you interact with the+
+
+
[See Also Privacy Policy]
+ + + + +-
+
What are "cookies," and does
+ +
+ + +
+ +[See Also Privacy Policy]
+ + + + +Does
+ +Information about our site visitors is an important part of +understanding and extending the impact of
+ +-
+
+
-
+Agents: We employ companies and individuals to perform +functions on our behalf. Examples include compiling and categorizing +user feedback, analyzing survey data or data about your use of the +site, and providing customer support. These agents have access to user +information needed to perform their functions, for example, but may not +use this information for any other purposes. These agents are bound by +non-disclosure agreements.+
+
+
-
++
+
+
-
+Institutions interested in the "opencourseware movement": +Part of+
+
+
[See Also Privacy Policy]
+ + +-
+
Technology
+-
+
+
What technology is used to publish the
+ +
+ +The planning tools used by the
+ +For more information on eduCommons, please contact The Center for Open and Sustainable Learning (http://cosl.usu.edu/).
+ + + + +Is
+ +
+ + + + +What is RSS?
+ +RSS (Really Simple Syndication) and an aggregator allow you to +subscribe to discussion forums, blogs and other websites in order to receive timely, +organized updates of posts, news, and other information you care about.
+ + +
Other Questions
+-
+
+
How can I support
+ +It is particularly generous of you to offer a financial contribution to +support
+ + + + +
+ +<YourUniveristy>
+ +<Street Address>
+ +<City, State, Zip>How do I apply for admission to
+ +
+ + + +
+ +Office of Admissions
+ +<YourUniveristy>
+ +<Street Address>
+ +<City, State, Zip>
+ +<Phone: 999-999-9999>
+ +http://www.yoursitehere.com/admissions/
+ +This material was created or adapted from material created by MIT OCW, Copyright © 2005 MIT in accordance with the MIT OCW Terms of Use, http://ocw.mit.edu/OcwWeb/Global/terms-of-use.htm. +
+We welcome your feedback on
+Before sending us your feedback, you may want to view Help » Frequently Asked Questions. +
++ +
+Possible feedback topics include: +
-
+
- stories and experience with using
- issues with content within a course +
- request a course that hasn't been posted yet +
- problems using the site +
- suggestions on improving the site +
+ eduCommons+is a free and open educational resource for faculty, + students, and self-learners throughout the world. +We hope you find eduCommons valuable whether you're:
+
does not grant credits or degrees, and does not provide + access to faculty. gives you open access to the materials + used in a variety of courses. + |
+
+ Welcome!+
|
+
+ What's New+
|
+
+ Content+
|
+
+ About eduCommons+
|
+
+This site has not yet set a privacy policy. +
+ ++ Please please use the + feedback form to request privacy policy information.
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/templates/schedule_view.pt =================================================================== --- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/templates/schedule_view.pt (revision 126) +++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/templates/schedule_view.pt (revision 126) @@ -0,0 +1,104 @@ +Course Schedule Information
+ +| Lesson | +Topic | +Audio | +Video | +
| 1 | ++ | + | + |
| 2 | ++ | + | + |
| 3 | ++ | + | + |
| 4 | ++ | + | + |
| 5 | ++ | + | + |
| 6 | ++ | + | + |
| 7 | ++ | + | + |
| 8 | ++ | + | + |
| 9 | ++ | + | + |
| 10 | ++ | + | + |
| 11 | ++ | + | + |
| 12 | ++ | + | + |
| 13 | ++ | + | + |
| 14 | ++ | + | + |
| 15 | ++ | + | + |
Course Description
+Paragraph about Course
+ +Course Objectives
+-
+
- Objective 1 +
- Objective 2 +
- Objective 3 +
- Objective 4 +
- Objective etc. +
- Objective etc. +
Prerequisites
+ +Class One
+Description of Class One
+ +Class Two
+Description of Class Two
+ +Required Textbook
+Book Title. Edition (Author(s), Year, Publisher), Year.
+ +Other Reading
+-
+
- Reading One +
- Reading Two +
- Reading Three +
Grading
+| Component | +Percentage | +
| + | 100% | +
| Problem Sets | +20% | +
| Written Report/Oral Presentation of Special Project | +15% | +
| Examination 1 | +20% | +
| Examination 2 | +20% | +
| Final Examination | +25% | +
The table above includes sample data. Edit the table as befits the class being worked on.
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/templates/tou_view.pt =================================================================== --- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/templates/tou_view.pt (revision 126) +++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/browser/templates/tou_view.pt (revision 126) @@ -0,0 +1,84 @@ +
+This document provides the terms of use for the
Intellectual Property
+ +Course Materials
+Course materials made available through
+ +
Comments
+All comments posted in
+Representing material posted in eduCommons by another individual as your own work in online or +offline settings is strictly prohibited and constitutes grounds for +immediate termination of your eduCommons account and may lead to civil +and/or criminal charges. +
+ +Liability Disclaimer
+ ++Information, advice, opinions, and other expressions in eduCommons +are provided "as is" without warranty of any kind, express or implied, +including, but not limited to, the implied warranties of merchantability, +fitness for a particular purpose, or non-infringement. The entire liability +for any use of any materials available through eduCommons lies with +the user of the materials. +
+ +Abuse of the eduCommons OCW Site
+ ++The following list describes +activities that are strictly prohibited within eduCommons. +Attempting or succeeding to allow or commit any of the acts prohibited +below constitutes grounds for immediate termination of your eduCommons +account and may lead to civil and/or criminal charges. Prohibited +activities include, but are not limited to, the following: +
+ +
+
+-
+
- Users shall not do anything + to intentionally degrade the performance of eduCommons + hardware, software, or network resources. +
- Users shall not attempt to + gain unauthorized access to any portion of eduCommons. +
- Users shall not post + commercial solicitations or "spam" comments in eduCommons. +
- Users shall not attempt to + spread viruses, worms, or other files harmful to computer systems + and/or networks via eduCommons. +
- Users shall not gather + personal information about other users (including, but not limited to, + harvesting email addresses) via eduCommons. +
- Users shall not share their + password or account with other individuals. +
- Users shall refrain from + making harassing, intimidating, or libelous statements or other + expressions in eduCommons. +
- Users shall refrain from + offensive/inflammatory statements or other expressions (for example, + offensive images) in eduCommons. +
- Users shall not engage in + impersonation or other behavior designed to deceive eduCommons + users and/or community leaders. +
- Users shall respect the + intellectual freedom of others’ expression of their opinions + and ideas. +
+
+
+
+
+
+
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/docs/IMSContentPackaging.html
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/docs/IMSContentPackaging.html (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/docs/IMSContentPackaging.html (revision 126)
@@ -0,0 +1,482 @@
+
+
+
+
+
+
+
+
+Changes in version 3.1.0
+-
+
- "Download Course" Additions +
- Moved "download this course" into a "Reuse Course" portlet. The course downloads now include IMS information. Using a portlet will also allow for additional formats, such as Common Cartridge, to be added in the future. +
- Display License and Caption for Embedded Objects +
- Using the Kupu editor, eduCommons can now display separate licenses and citations for image objects embedded in a page, distinct from the overall page license. +
- Captcha integration +
- We now integrate captcha on the registration page to prevent spambot submissions. +
- Lingua Plone 2.0 Integration +
- LinguaPlone 2.0 has been implemented into eduCommons 3.1.0, allowing users to localize content and support multiple languages on a single OpenCourseWare site. +
- Add accessibility check +
- This is intended to help institutions who want to include accessibility check into their workflow. +
- Enable Javascript/Page-specific CSS and embed tags by default +
- We have enabled Javascript and page-specific CSS and embed tags by default. +
- Documentation for Adding Small Widgets +
- Add eduCommons-specific documentation and examples for adding Plone 3 portlets. +
- Add "Remix this course" functionality +
- This feature is designed to allow courses from MIT OpenCourseWare (pending implementation by MIT OCW) as well as other eduCommons OCWs to be easily imported into OpenOCW (or another eduCommons site if specified, but OpenOCW will be the default). On published eduCommons OCW courses that have been packaged, a "Remix this course" link appears. This allows unauthenticated users to send the entire course to OpenOCW (OpenOCW login credentials must be provided). +
- Update "download this course" to improve handling of large courses +
- "Download this course" is no longer auto-generated when a course is published or changed. Instead, a new "Package course" button appears in the contents view of the course once it has been published. The "Download this course" .zip file now includes IMS information. It now appears in its own portlet, along with the "Remix this course" link. +
- Other updates +
- Updated eduCommons to exclude new content from showing in the left nav by default (including zip imports). +Improved IE 6 and 7 compatibility. +
+
+Changes in version 3.0.2
+Fixed bugs in 3.0.1 migration release
+
+
+Changes in version 3.0.1
+Added migration support for from eduCommons 2.3.1
+
+
+Changes in version 3.0.0
+-
+
- Added full support for Plone 3.0 +
- Inline editing +Working Copy support +Link and reference integrity checking +Automatic locking and unlocking +Easy collaboration and sharing +Versioning, history and reverting content +Upgraded visual HTML editor +
- Added OpenOCW Functionality +
- Simplified Workflow +Refactored Security +Eased Production processes +
- Simplified Course Building +
- Course Builder Widget allows 'one step' production of Division, Course, and templates Course objects (syllabus, etc). +
+
+Changes in version 2.3.1
+-
+
- Added Migration from 2.2.0 +
- The migration process has been improved and simplified. +
+
+Changes in version 2.3.0
+-
+
- Added i18n Support for Spanish, Dutch, French, and Chinese +
- Translations are now available for the aforementioned languages. +
- Added Support for MOCSL Tools +
- The Folksemantic AddOn Product allows for seamless interaction with +Annorate, Make A Path, and Send2Wiki. +
- Fixed Metadata Bugs +
- The Citations were presenting incorrect metadata; now pulling in correct +metadata per object. +
- Added Course Wide Instructor Metadata +
- A flag is now available to note if the Instructor of the Course is also the +principal creator for objects within the course. +
- Added MIT CP Import Support +
- Via the IMS Transport Tool, an end user can now import IMS Content Packages. +eduCommons will strip the package of it's chrome and import content, navigation, +and metadata. +
- Added Zip File Download for Courses +
- End Users can now get a Zip File download of a course object, stripped of eduCommons +chrome and ready for reuse +
- Extended RSS Feed Support +
- Departments and Courses now have configurable feeds per object, and the ability to turn +feeds on and off +
- Added Recursive Copyright Clearance +
- Folderish Objects may now recrusively clear or revoke copyight +
+
+Changes in version 2.2.0
+Front end UI Enhancements
+Auto-citation generation (from metadata) displayed inline with documents and included in skinless content. Simplify conformance with Attribution terms of Creative Commons licenses for those who build derivative works.
+Social Bookmarking Dropdown. Help users bookmark and later find OERs hosted in eduCommons using popular social bookmarking services.
+Integration with MyOCW (pending MyOCW release dates).
+Expanded support for IMS Content Packaging, including a transform engine that can translate from popular IMS CP formats to and from eduCommons.
+Updated internationalization support, with translation updates for a predetermined set of languages.
+Finalized support for content translation using the LinguaPlone product.
+
+
+Changes in version 2.1.1
+-
+
- Updated Internationalization Files +
- Updated internationalization files to reflect the latest eduCommons changes. +
- Added Support for Inline Translations +
- Integrated the LinguaPlone product with eduCommons, making it now possible +to have multiple translations of content within the same eduCommons instance. +
- RSS Feeds on front page, and RSS feeds for departments +
- RSS feed icon now appears on the front page of eduCommons, as well as on the +courses listing page. A new RSS feed now appears for departments, which +lists the latest published courses in a department. +
- Added Support for Social Bookmarking Services +
- Added support for bookmarking services, starting with del.icio.us. Support +for more to come. +
- Added a Skinless View for Documents +
- eduCommons now provides a skinless view of documents, making it both possible +and easy to reuse content. +
+
+Changes in version 2.1.0-final
+-
+
- A new IMS Transport Engine +
- A refactored IMS Content Packaging engine that provides a more robust import +and export functionality. On import eduCommons will identify where required +tags missing in the manifest file, if it is not able to read it directly. +
- IMS Content Packaging Documentation +
- This version ships with detailed documentation on how to write out an IMS +Content Package that eduCommons can consume. The documentation is provided +in raw text, web based, and in a standalone (PDF) file. +
- A New Content Licensing Engine +
- eduCommons now allows a default content license and a rights holder to be +set sitewide. It also includes the ability to license an individual piece +of content, should the need arise to publish content under a license +different to the site wide one. +
- Copyright Bylines +
- Content is now published with the appropriate copyright byline, including +the ability to specify copyright dates, the rights holder, and the license +itself. The license includes a hyper-link to the legal terms of the license +as well as an icon (if the license includes one). +
- Creative Commons License Support +
- eduCommons now includes a license selector that integrates with Creative +Commons Licenses (www.creativecommons.org), allowing eduCommons to remain +flexible with the latest CC offerings. +
- Support for Other Licenses +
- eduCommons supports other licenses, including the traditional all rights +reserved, and GNU Free Document Licenses, as well as allowing content +developers to input their own license. +
- RDF and machine readable Creative Commons License Support +
- eduCommons will publish by default any metadata for a content object in +embedded RDF format. eduCommons will also publish machine readable creative +commons licenses, that can be read and processed by search engines. +
- Content Licensing Product for Plone 2.5 +
- The content licensing features in eduCommons are shipped in a standalone product +that can also be used in a default Plone 2.5 instance. +
- Native Support for Plone 2.5 +
- This version of eduCommons supports the latest version of Plone (2.5), with some +functionality now taking advantage of the new Zope 3 component architecture. +
- Improved HTML Validation/Fixing Engine +
- The HTML Validation/Fixer Engine has been updated, and now displays a detailed +report of problems within the body of an HTML document, and provides a simple +method to fix most problems, and identify remaining ones that need extra +attention. This functionality works when a content developer's editor is not +set to use the FCKeditor. +
+
+Changes in version 2.0.0-final
+-
+
- Human Readable URLS +
- URLs are human readable, instead of being based on an auto generated id. +
- Recursive Folder Change State +
- Can change workflow state recursively on content in subfolders. +
- Native Support for Plone 2.1 +
- Integrated eduCommons custom skin files with new Plone 2.1 functionality. +Content objects are now based on ATContentTypes. Substantial changes across +the code base. eduCommons is currently based on Plone-2.1.2 and Zope-2.8.6. +
- Content Status History on Object Views in Edit Mode +
- The content status history of an object is now available in the view from +a history link at the top of the page while in edit mode. +
- No Redirect on Front Page +
- Front page no longer redirects to an ECIndex folder, but renders directly. +
- Removed Forum Support +
- Forum support is being replaced by new social software in the future, which +means that the old OLS code base is no longer being maintained. If you require +forum support it is recommended that you use the excellent zForum +(http://www.zforum.org) plone product until the new software is in place. +
- Improved IMS Content packaging +
- Workflow status history is now written in the IMS content package instead +of being stored in a binary blob. +
- eduCommons Custom Skin Support +
- eduCommons can now reskinned in release mode without requiring eduCommons +to be restarted. +
- Courses Object Removed +
- The courses object has been removed, and departments are now put in the +root of the site. This simplifies the UI and removes confusion over what +the Courses object is/was. +
- Improved Default Templates +
- Default templates for the front page, FAQ and about pages propagate the +eduCommons site title, making it easier to customize default site text. +
- Department and Course IDs +
- Departments and Courses now support the display of ID's in front of their +titles. Courses also support the display of the year and semester that the +course was taught in. +
+
+Changes in version 1.6.1-final
+-
+
- eduCommons Document HTML Fixer +
- Implement an HTML engine that can fix HTML mistakes automatically in ecDocuments. +
- RDF Headers/Metadata +
- Add RDF headers to ECDocuments implementing the RDF/Dublin Core standard. +
- Support for Plone 2.1.1/Zope 2.8.2 +
- Implementing support for the latest Plone (2.1.1) and Zope (2.8.2) code bases. +
- Support for Default Templates +
- Support for adding default templates for commonly used pages within eduCommons. +
- Review and Revise IMS Export Rights +
- Changes in the UI to only present IMS import/export to administrators and managers. +This is necessary because producers do not have rights on content that is not in the +"In Progress" state, which prevents producers from being able to import/export +content not in the appropriate state. +
- Zip export (non-ims) +
- Allow a producer administrator or manager to export course content in a zip file format. +
- Creative Commons metadata header +
- Add a metadata header to ECDocuments for the creative commons license. +
- Removal of "Courses" link in bread crumb +
- Remove the "Courses" link in the breadcrumb due to the fact that is is confusing to users. +
- XHTML Validation of an Entire Course +
- Adding the ability to do validation of XHTML across a course, while reporting +errors in a log file. +
- Add Folders to Course Contents +
- Add folders to course content pages so that objects which externally link to other +objects will retain their links with out having to rewrite them. +
- Migration from 1.5.2-final +
- Implement the ability to migrate existing 1.5.2-final sites to 1.6.1-final. +
+
+
+
+
+
+
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/docs/INSTALL.html
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/docs/INSTALL.html (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/docs/INSTALL.html (revision 126)
@@ -0,0 +1,460 @@
+
+
+
+
+
+
+
+
+IMS Content Packaging and eduCommons 3.1.1-final
+This document details how to write IMS Content packages that are compatible with +eduCommons 3.1.1-final.
+eduCommons uses version 1.2 of the IMS Content Packaging Specification. XML Schemas +for the specification can be found at http://imsglobal.org/xsd/imscp_v1p2.xsd and +http://imsglobal.org/xsd/imsmd_v1p2p4.xsd.
+
+
+Using XML Schemas and a Validating XML Editor
+In the process of writing software that exports eduCommons supported IMS Content +Packages, it is highly recommended to use a validating XML editor and associated +schema files to check manifests for validity. eduCommons in some circumstances +will expect import manifests to meet validity standards, and the chances of +creating content packages that will work with eduCommons will be greatly increased. +eduCommons provides XML schema files on export for this purpose.
+An XML schema file for eduCommons specific metadata can be found both online +(http://cosl.usu.edu/xsd/eduCommonsv1.1.xsd) and in eduCommons IMS Content +Packages.
+To use the IMS Content Package XML schemas along with the eduCommons schema, make +sure your manifest specifies these packages and the relevant XML schema informtation +in the header. Below is an example of attributes which you may want to set on the +manifest tag.
++xmlns="http://www.imsglobal.org/xsd/imscp_v1p1" +xmlns:eduCommons="http://cosl.usu.edu/xsd/eduCommonsv1.1" +xmlns:imsmd="http://www.imsglobal.org/xsd/imsmd_v1p2" +xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" +xsi:schemaLocation="http://www.imsglobal.org/xsd/imscp_v1p1 imscp_v1p2.xsd + http://www.imsglobal.org/xsd/imsmd_v1p2 imsmd_v1p2p4.xsd + http://cosl.usu.edu/xsd/eduCommonsv1.2 eduCommonsv1.2.xsd"> ++
+
+
+Specifying and Using eduCommons Namespaces
+The IMS CP specification allows content packages to be extended using custom +metadata fields. eduCommons takes advantage of this to pass information that +does not fit into the LOM metadata format. Using the eduCommons extensions +requires the use of the eduCommons namespace in typical XML style.
+eduCommons can read values from colon prefixed tags, or by using an xmlns +attribute on the top level eduCommons tag as shown below. Although both methods +are acceptable, the latter is preferred due to the fact that it makes the +corresponding XML more readable. Examples in the rest of the document will +be given in this format.
++<manifest xmlns=".... + xmlns:eduCommons="http://cosl.usu.edu/xsd/eduCommonsv1.2" + ... + > + + ... + + <eduCommons:eduCommons> + <eduComons:objectType> + Course + </eduCommons:objectType> + </eduCommons:eduCommons> + + ... + </manifest> ++
+<eduCommons xmlns="http://cosl.usu.edu/xsd/eduCommonsv1.2"> + <objectType> + Course + </objectType> +</eduCommons> ++
+
+Setting Metadata on eduCommons Enabled IMS Content Packages
+eduCommons stores metadata for every content object entered into its repository. +In order to write a content package that eduCommons can process, it is necessary +to include a metadata section for every resource specified in the manifest.
+It is also important to note that eduCommons currently will not read top level +metadata sections, nor will it support nested manifests within IMS Content +Packages. Support for nested manifests, and non eduCommons content packages +are currently listed as future eduCommons features.
+An example of how to lay out your manifest section to be eduCommons friendly is +given below.
++<manifest> + <organizations> + <organization> + </organization> + </organizations> + <metadata> + ... any metadata specified here is ignored by eduCommons ... + </metadata> + <resources> + <resource> + <metadata> + ... metadata specified here is used to apply metadata + to content objects ... + </metadata> + <file href=" ... used by eduCommons to name the content object + and find it within the package ..."/> + </resource> + ... + </resources> + <manifest> + ... nested manifests are not currently supported by eduCommons, + but may be at a future date ... + </manifest> +</manifest> ++
+
+The eduCommons Course Object
+The eduCommons course object is different to other content objects in that +it has extra requirements. eduCommons represents courses as both a document +and a container for content objects. This means in an IMS Manifest it will +appear as a content object that is connected to an HTML file (used to +render the front course page) and is also a folder which contains all content +related to the course. It appears in the manifest as both.
+Courses also have additional metadata associated with them in the eduCommons +specific metadata section. This extra metadata is specified in a further section +below.
+Each manifest should specify a course object as the initial resource.
+
+
+LOM Metadata Fields Read By eduCommons on Import
+eduCommons uses Dublin Core fields to store metadata internally. In order to +be able to support IEEE LOM metadata standards in IMS Content Packages, some +mapping between metadata standards must be done. Not all LOM metadata fields +are supported, and although eduCommons may populate some of these extra fields +on output, it only supports reading data from the following fields:
+
+
+1. General
+
+
+1.2 Title
+eduCommons uses this field to set the title on an object. This field is +required.
+
+
+1.3 Language
+eduCommons uses the language setting to set the language of the content object +and its metadata. eduCommons does not support setting language values on metadata +or individual metadata fields. All LOM language attributes in "langstring" nodes +are ignored by eduCommons. This field is optional, but recommended.
+
+
+1.4 Description
+eduCommons sets descriptions on content objects using this field. This field is +optional, but recommended.
+
+
+1.5 Keyword
+eduCommons supports the use of keywords for search purposes over content. It +uses this LOM field. This field is optional.
+
+
+2. Lifecycle
+
+
+2.3 Contribute
+eduCommons supports a number of fields based on the LOM Contribute node.
+When the role in a contribute node is set to "creator", eduCommons will +set the eduCommons creator field to the name value in the VCARD of this +section. When the role is set to "creator" it will also use the date field +to set the creation date on the eduCommons content object.
+eduCommons will set its contributors field with the names listed in any other +LOM based contribute nodes. The roles defined in additional LOM based contribute +nodes are not read or stored by eduCommons.
+eduCommons also supports a number of eduCommons specific contribute nodes +which are detailed in the next section.
+
+
+Other
+eduCommons may support a larger number of LOM fields in the future. The current +supported set is likely to be expanded. However, attempts will be made to remain +compatible with the above listed fields.
+
+
+LOM Based eduCommons Metadata Fields
+
+
+The rights holder field
+eduCommons supports setting a rights holder for every content object. However, it +also supports setting content to use a site wide default, making it possible to +set a default rights holder over the whole eduComomns site. To use the site wide +default setting, use "(site default)" as the rights holder name.
+eduCommons will read an write the rights holder information in a contribute +section in the LOM metadata section of an IMS content package. The source +tag in this contribute section is set to "eduCommonsv1.1" signifying that this +role is defined by eduCommons and is not a standard LOM role. An example of how +the rights holder is given below. The date field can be set to a publication or +creation date. It does not matter, as eduCommons does not use the date field in +this section.
++<contribute> + <role> + <source> + <langstring xml:lang="en"> + eduCommonsv1.2 + </langstring> + </source> + <value> + <langstring xml:lang="en"> + rights holder + </langstring> + </value> + </role> + <centity> + <vcard> + BEGIN:VCARD + FN: John Smith + END:VCARD + </vcard> + </centity> + <date> + <datetime> + 2006-08-07 15:59:23 + </datetime> + </date> +</contribute> ++
-
+
- Note +
- The VCARD Section In The Xml File Should Be Left Aligned, With No Whitespace In +Order To Comply With VCARD Standards. +
+
+The Instructor and InstructorEmail fields
+The instructor field is also encoded in a LOM contribute node, similar to the +rights holder field above. Things to note here are that eduCommons will read both +the FN: and EMAIL;INTERNET: fields out of the VCARD, and use them to set +the Instructor and InstructorEmail settings accordingly.
++<contribute> + <role> + <source> + eduCommonsv1.2 + </source> + <value> + instructor + </value> + </role> + <centity> + <vcard> + BEGIN:VCARD + FN: John Smith + EMAIL;INTERNET: johnsmith@somewhere.com + END:VCARD + </vcard> + </centity> + <date> + <datetime> + 2006-08-07 15:59:23 + </datetime> + </date> +</contribute> ++
-
+
- Note +
- The VCARD Section In The Xml File Should Be Left Aligned, With No Whitespace In +Order To Comply With VCARD Standards. +
+
+eduCommons Specific Metadata
+This section details eduCommons metadata that does not appear within the LOM +metadata section. Instead it appears in a section following the LOM metadata as +follows.
++<metadata> + <lom xmlns="http://www.imsglobal.org/xsd/imsmd_v1p2"> + <general> + </general> + <lifecycle> + </lifecycle> + ... + </lom> + <eduCommons xmlns="http://cosl.usu.edu/xsd/eduCommonsv1.2"> + <objectType> + </objectType> + ... + </eduCommons> +</metadata> ++
The following section describes the tags supported by eduCommons in detail.
+
+
+
+eduCommons Metadata Tags
+
+
+The objectType tag
+The objectType tag is used to signify what type of content object eduCommons +should create for the given resource. Possible values are Course, Document, +File, Image, or Link. This field is required. HTML or plain text resources +should use the document setting. Images should use the image setting. All other +resources should use the File setting, unless they are an external link. If +a resource is in HTML format and represents a course home page, use the Course +setting and make sure the resource appears first in the manifest resources +section.
++<objectType> + Course +</objectType> ++
+
+The copyright tag
+The copyright tag is used by eduCommons to license content objects. It also uses +the field to render copyright bylines for objects. The field should specify both +the copyright and the date. e. g. "Copyright 2006". This field is optional. If +it is not included, the site default copyright string will be used instead.
++<copyright> + Copyright 2006 +</copyright> ++
+
+The license tag
+The license tag is used to assign a copyright license to a content object. It +is also used to render a copyright byline for an object.
+The license field supports four parameters:
+-
+
- License Cateogory +
- License Name +
- License URL +
- License Icon URL +
The category field appears as an attribute in the license tag, and must be +set to one of the following:
+-
+
- (site default) +
- All Rights Reserved +
- GNU Free Document License +
- Creative Commons License +
- Other +
The category field is also used as a label by eduCommons to allow a user to +select a copyright license for a content object. It is a required field.
+The licenseName tag is used to identify the name of the license. This name +will be used in the copyright byline, and should slot into the following sentence: +This resource is licensed under a ____________. This is an optional field only +if "(site default)" is chosen. Otherwise it must be specified.
+The licenseUrl tag is used to specify a public web site where the legal definition +of the license is displayed. It allows the license name in the copyright byline to +be linked directly to the definition. It is optional.
+The licenseIconUrl tag is used to specify a public icon image that represents +the content license. This field is optional, and likely not to be included, unless +the license includes a representative icon. An example where you would want +to include this field would be to specify a creative commons icon along with +the license.
+Below is an example of how the license field would be encoded within the eduCommons +metadata.
++<license category="Creative Commons License"> + <licenseName> + Attribution 2.5 + </licenseName> + <licenseUrl> + http://creativecommons.org + </licenseUrl> + <licenseIconUrl> + http://creativecommons.org + </licenseIconUrl> +</license> ++
+
+The clearedCopyright tag
+The clearedCoypright field is used by eduCommons to keep track of whether or not +a content object has been cleared for publication in an open content environment. +It can be set to either "true" or "false". This field is optional, and is set to +"false" by default.
++<clearedCopyright> + true +</clearedCopyright> ++
+
+Example IMS Content Packages
+You can create example IMS packages by building content in eduCommons and then +use the IMS export functionality to export them. This feature can be useful +in figuring out how to write compatible packages.
+
+
+
+
+
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/docs/LOCALIZATION.html
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/docs/LOCALIZATION.html (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/docs/LOCALIZATION.html (revision 126)
@@ -0,0 +1,162 @@
+
+
+
+
+
+
+eduCommons 3.1.1-final Installation
+Installation Instructions
+ +
+
+Installation
+This section describes how to install a server based instance of eduCommons on +a UNIX based platform (linux, OSX).
+Installation involves the following packages:
++++
+- Python-2.4.4.tar.gz (http://python.org/2.4.4/)
+- Zope-2.10.5-final.tar.gz (http://www.zope.org/Products/Zope/2.10.5)
+
Python library packages:
++++
+- Imaging-1.1.6.tar.gz (http://www.pythonware.com/products/pil/)
+- PyXML-0.8.4.tar.gz (http://sourceforge.net/project/showfiles.php?group_id=6473)
+- elementtree-1.2.6.tar.gz (http://effbot.org/downloads/#elementtree)
+- libxml2-python-2.6.15.tar.gz (ftp://xmlsoft.org/libxml2/python/)
+- Beautiful Soup 3.0.4 (http://www.crummy.com/software/BeautifulSoup/download/)
+
Plone package:
++++
+- Plone-3.0.6.tar.gz (http://plone.org/products/plone/releases/3.0.6)
+
eduCommons-related Packages:
+(Correct versions of these products are shipped in the eduCommons archive unless ohterwise noted)
++++
+- eduCommons (3.1.0-final)
+- leftskin (1.0.2-final)
+- ContentLicensing (2.0.0)
+- ZipFileTransport (2.0.1)
+- IMSTransport (2.0.1)
+- PloneBookmarklets (2.0.0)
+- ProxyIndex (1.2.1)
+- FileSystemStorage (2.6.2)
+- LinguaPlone (2.0)
+- easy_install (download here: http://peak.telecommunity.com/dist/ez_setup.py)
+- collective.captcha (installed via easy_install)
+
+
+I. Installation Steps
+-
+
Installing Python:
+It is likely that the Python programming language is already installed on +your server. Try typing:
++$ python +
+on the command line to see what version you have installed (Ctrl-D will exit). +You should see something like the following:
++Python 2.4.4 (#1, Oct 7 2006, 21:17:24) +[GCC 3.4.6 20060404 (Red Hat 3.4.6-3)] on linux2 +Type "help", "copyright", "credits" or "license" for more information. +>>> +
+eduCommons and its supporting software requires version 2.4.4. If your server +does not have Python, or if the version of Python installed is not 2.4.4, you +will have to install a new version.
+Some platforms may have an updated version of Python available through their +package managers (yum, apt, fink). If you can not find a suitable version, or +if you prefer to build Python from source, simply download the source package +and use a command line interface to type in the following instructions:
++tar -zxvf Python-2.4.4.tar.gz +cd Python-2.4.4 +./configure +make +sudo make install +
+By default this will install a new version of Python in the /usr/local directory +on your server.
+
+Installing Python library packages
+Once you have Python installed it will be necessary to include a number of +libraries that extend the functionality of your Python installation. If you +have installed Python using a package manager, it may be likely that some +(or all) of these packages may also be available for installation. As long +as suitable library versions can be found, it should be fine to use them. In +cases where it is not possible to load prebuilt packages, use the following +instructions below:
+-
+
Installing Python Imaging Libary (PIL)
+PIL is now a required package for the latest version of Plone.
+Unpack and install Imaging-1.1.6:
++tar -zxvf Imaging-1.1.6.tar.gz +cd Imaging +/usr/local/bin/python setup.py build +sudo /usr/local/bin/python setup.py install +
+You may require additional packages to build the imaging library. See +the PIL website for additional installation instructions.
+
+Installing PyXML
+Unpack and install PyXML:
++tar -zxvf PyXML-0.8.4.tar.gz +cd PyXML-0.8.4 +/usr/local/bin/python setup.py build +sudo /usr/local/bin/python setup.py install +
+
+Installing elementtree
+elementtree is now a required dependency for the latest version of Plone.
+Unpack and install elementtree:
++tar -zxvf elementtree-1.2.6.tar.gz +cd elementtree-1.2.6 +/usr/local/bin/python setup.py build +sudo /usr/local/bin/python setup.py install +
+
+Installing libxml2-python
+If your target platform includes binary only distributions of libxml2 and +libxslt, you may need to also include the development packages in order for +the following to work.
+Unpack and install libxml2-python:
++tar -zxvf libxml2-python-2.6.15.tar.gz +cd libxml2-python-2.6.15 +/usr/local/bin/python setup.py build +sudo /usr/local/bin/python setup.py install +
+
+Install Beautiful Soup
+Unpack and install Beautiful Soup 3.0.4 into your python library.
++tar -zxvf BeautifulSoup-3.0.4.tar.gz +cd BeautifulSoup-3.0.4 +/usr/local/bin/python setup.py build +sudo /usr/local/bin/python setup.py install +
+
+
+
+++
+- +
Install Easy Install
+++Easy Install (easy_install) is a python module bundled with setuptools +that lets you automatically download, build, install, and manage Python packages.
+Download http://peak.telecommunity.com/dist/ez_setup.py and install it using the +correct version of python:
++/usr/local/bin/python ez_setup.py +++++
+- +
Install collective.captcha
+collective.captcha is a Python package that is installable via Easy Install
++/usr/local/bin/easy_install collective.captcha ++
-
+
Installing Zope
+Unpack, build and install Zope:
++tar -zxvf Zope-2.10.5-final.tar.gz +cd Zope-2.10.5-final +./configure --with-python=/usr/local/bin/python --prefix /opt/Zope-2.10.5 +make +sudo make install +
+
+Create a Zope instance
+Create an instance in your Zope install:
++sudo /opt/Zope-2.10.5/bin/mkzopeinstance.py +
+When prompted for a directory enter in the following:
++/opt/Zope-2.10.5/web +
+You can substitute the web directory for a name that better describes your site. +The documentation will assume that you have chosen web as your instance directory.
+When prompted for a username and password, enter in the username/password you will +use for managing your Zope instance.
+
+Install Zope Products
+eduCommons relies on several Zope products in order to run. You will need to install +the following packages in the following order. The commands listed below assume that +you have the source tarballs in the root of your home account:
+-
+
Plone-3.0.6
+Install Plone into your Zope instance Products folder.lib/python directory
++cd /opt/Zope-2.10.5/web/Products +sudo tar -zxvf ~/Plone-3.0.6.tar.gz +
+Once you have unpacked Plone you need to move the products back up to the Products +directory as follows:
++cd /opt/Zope-2.10.5/web/Products +sudo su +cd Plone-3.0.6 +mv * .. +cd .. +sudo rm -rf Plone-3.0.6 +
+The Plone tarball came with a lib/python directory. The contents of it need to go +up one level, into the lib/python of your Zope install.
++cd /opt/Zope-2.10.5/web/Products +cp -r lib/* ../lib/ +sudo rm -rf /opt/Zope-2.10.5/web/Products/lib +
+The Plone tarball also contains a Products directory. The contents of it need to go +up one level, into the web/Products directory of your Zope install.
++cd /opt/Zope-2.10.5/web/Products +cp -r Products/* ../Products/ +sudo rm -rf /opt/Zope-2.10.5/web/Products/Products +
+
+eduCommons
+This is the eduCommons product source package. To install use the following:
++cd /opt/Zope-2.10.5/web/Products +sudo tar -zxvf ~/eduCommons-3.1.1-final.tar.gz +
+eduCommons includes a number of products which need to be put in the root +of the Products folder. To do this use the following:
++cd /opt/Zope-2.10.5/web/Products +sudo mv eduCommons-3.1.1-final/* . +sudo rm -rf eduCommons-3.1.1-final +
+The products that now ship with eduCommons are as follows:
+-
+
eduCommons
+A Plone product which implements the core functionality of eduCommons.
+
+leftskin
+A Plone product which customizes the Plone layout.
+
+ContentLicensing
+A Plone product that adds the ability to set copyright licenses on content +objects. Auto installed with the eduCommons product.
+
+ZipFileTransport
+A Plone product that adds the ability to import and export content via +ZIP archives. Auto installed with the eduCommons product.
+
+IMSTransport
+A Plone product that imports and exports contents in IMS content packages. +Auto installed with the eduCommons product.
+
+PloneBookmarklets
+A Plone product that adds the ability to integrate documents with popular social +bookmarking sites.
+
+ProxyIndex
+ProxyIndex is a plugin to zope catalog index.
+
+FileSystemStorage
+FileSystemStorage is a product that provides the framework for content types to store data +directly on the filesystem, rather than in the ZODB.
+
+LinguaPlone
+A tool to manage and maintain multilingual Plone content.
+
+
+
+Configure your Zope site
+Now that all the necessary Zope products are installed it is time to clean up and +configure the site. The first task is to create a zope user and group in which +zope can run under. This can be done via the following:
++sudo /usr/sbin/groupadd zope +sudo /usr/sbin/adduser -g zope -s /bin/false -d /opt/Zope-2.10.5 zope +
+Once that is done we can now set the proper permissions needed for Zope to run +securely. This can be done via the following:
++cd /opt/Zope-2.10.5/web/Products +sudo chgrp -R zope * +sudo chmod go-w * +
+FileSystemStorage comes with its own documentation and we recommend you read it +(/opt/Zope-2.10.5/web/Products/FileSystemStorage/README.txt). Create folders for +storage and backup. We suggest setting things up in the following way:
++cd /opt/Zope-2.10.5/web/var +mkdir fss_storage +mkdir fss_backup +
+Now edit the filesystemstorage.conf.in configuration file for FileSystemStorage located +in /opt/Zope-2.10.5/web/Products/FileSystemStorage/etc. There are several configuration +options here (see README.txt), but most can be left at the default. We suggest a +hierarchical file structure, which can be set up by uncommenting and editing this line:
++# storage-strategy flat +change to: +storage-strategy site1 +
+Zope needs to be able to write to the log directory, and its database files. To +enable this enter the following:
++cd /opt/Zope-2.10.5/web +sudo chgrp -R zope log var +sudo chmod -R g+w log var +
+The last bit of configuration that needs to be done is to edit the zope.conf file. +found in the etc/ directory of your Zope Instance. Uncomment and edit the +following settings:
++effective-user zope +
+And set the default port you want the Zope server to run on:
++<http-server> + # valid keys are "address and "force-connection-close" + address 8080 + # force-connection-close on +</http-server> +
+
+Apply Security Patch
+Plone's Security Panel is broken for Products that add Roles that come alphabetically +before 'Anonymous'. eduCommons adds the Administrator Role, which breaks the Security +Panel. This is a documented bug (http://dev.plone.org/plone/ticket/7690).
+In order to remedy this problem, apply the patch found in the eduCommons/extras folder. +Copy the patch to /opt/Zope-2.10.5/web/lib/python/plone/app/controlpanel.
++cd /opt/Zope-2.10.5/web/lib/python/plone/app/controlpanel +cp /opt/Zope-2.10.5/web/Products/eduCommons/extras/plone.app.controlpanel.security.py.patch . +
+Apply the patch by running the following command:
++patch -p0 < plone.app.controlpanel.security.py.patch +
+You may get this message: "can't find file to patch at input line 1 Perhaps you used +the wrong -p or --strip option? File to patch:" Enter the following:
++security.py +
+
+Overwrite Kupu's html2captioned transform
+Kupu allows for dynamically generated captions on inserted images. eduCommons utilizes +this feature to provide license and copyright holder information for embedded images +in documents. In order for this functionality to occur, the default transformation +must be customized
++cp /opt/Zope-2.10.5/web/Products/eduCommons/extras/html2captioned.py /opt/Zope-2.10.5/web/Products/kupu/plone +
+
+
+
+II. Configuration Steps
+-
+
Launch Zope
+Once Zope has been properly configured it can then be launched via the following +commands:
++cd /opt/Zope-2.10.5/web +sudo bin/zopectl start +
+You should now be able to open a browser and go to the ZMI with the following URL +(assuming that you configured Zope to run on port 8080)
++http://<server name>:8080/manage +
+You should then get a dialog prompt asking for your Zope admin username and password.
+
+Install eduCommons Product
+Once you have logged into the ZMI via the management interface, you are now ready +to create the site. Start by creating a plone site with the pull down menu in the +top right corner. Give the plone site an ID and title. The ID will be used in the +URL to access the site, so name it appropriately. The title will appear several +places within the eduCommons install, and should be based on your group or institution.
+Under "Extension Profiles" you need to do a multi-select (hold down the CTRL or the +Apple key). Select Working Copy Support (Iterate), ContentLicensing, IMSTransport, LinguaPlone, +PloneBookmarklets, Zip File Transport, eduCommons, and Left Skin so they are all highlighted. +Then click "Add Plone Site."
+Once the eduCommons instance has been created, you will need to QuickInstall the FileSystemStorage Product. +In the ZMI:
++1. Navigate to your eduCommons instance +2. Navigate to portal_quickinstaller +3. Select the checkbox to the left of FileSystemStorage +4. Click Install +
+If you wish to localize content in other languages you will need to QuickInstall install LinguaPlone. +This can be done either now from the ZMI or later, via Site Setup --> Add-on Products. +In the ZMI:
++1. Navigate to your eduCommons instance +2. Navigate to portal_quickinstaller +3. Select the checkbox to the left of LinguPlone +4. Click Install +
+If you have installed LinguaPlone you will also need to select your supported languages. +In the ZMI:
++1. Navigate to your eduCommons instance +2. Navigate to portal_languages +3. Select one or more Allowed languages (use the control or apple key to multi-select) +4. Click Save +
+Additional instructions for localizing content using LinguaPlone are available in LOCALIZATION.txt.
+Finally, you need to reorder the Layers in your eduCommons Skins Selections. +In the ZMI:
++1. Navigate to your eduCommons instance +2. Navigate to portal_skins +3. Click on the Properties tab +4. Under the Skins Selections, in the Layers textbox for LeftSkin, cut the LinguaPlone entry + and paste it one a new line below the eduCommons entry +5. Click Save (be sure to click the Save button for the Skins selection section) +
+
+Configure eduCommons
+Additional configuration information is provided in SETUP.txt (or online at +http://cosl.usu.edu/projects/educommons/documentation/how-to/educommons-setup-instructions). +This will help you to further customize eduCommons.
+
+
+
+
+
+
+
+
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/docs/MIGRATION.html
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/docs/MIGRATION.html (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/docs/MIGRATION.html (revision 126)
@@ -0,0 +1,99 @@
+
+
+
+
+
+
+
+
+LinguaPlone Translation Instructions
+In the context of Department, Course, and ECObjects, translations must occur in a 'top down' +manner. A Department must be translated prior to translating a Course, which must be +translated prior to any objects in the Course being translated.
+By default, LinguaPlone will tag newly created content objects in the default language setting +for the instance. Objects that exist in the ZODB prior to LinguaPlone being installed will be +'neutral', in terms of their language setting. In order to maintain the correct relationships +between languages, existing objects must have their language 'set'.
+To set an existing object's language, click translate into on the management toolbar, and then +click manage translations.... This interface will allow you to change the content language +setting from neutral to the appropriate setting for your instance.
+
+
+Localization with eduCommons 3.1.1-final
+
+
+Overview
+If you want to translate eduCommons into your language, here are instructions on how to get +started, as well as some guidelines that you should follow when performing a translation. You do +not need to know anything about programming to create an eduCommons translation. This +has been adapted for eduCommons from the plone translator guidelines. Please see our eduCommons +Localization Team page for a list of our volunteer translators.
+
+
+Introduction
+Since eduCommons is customized from Plone, it has built-in support for internationalization. As of +June 2006 Plone has 56 different translations. eduCommons requires some additional +translation work, but follows the same process as Plone. Adding an eduCommons translation is much +less time consuming because most of the translation work has already been done in Plone.
+There are about 400 strings needed for a translation of eduCommons (compared to about 1600 strings +for a Plone translation). Some of these are sentences or paragraphs, but the major part are one or +two words. These strings are scattered around in Plone, for example in page templates. Other items +to translate are widget labels, and workflow states. All those strings are collected in master +files. Currently eduCommons contains six .pot files. Each language requires its own .po files that +corresponds to the strings or message ids declared in the .pot files. The .pot is the blueprint for +the .po files.
+
+
+Tools
+When creating the .po files, we strongly recommend using a specialized tool called poEdit +(http://www.poedit.net). This makes the translation process very easy. But a normal +text editor work fine if you prefer that (both vim and emacs are great for this, and have special +modes for PO files). poEdit exists for both Linux and Windows, and Mac OS X.
+If you use a plain text editor instead of a dedicated tool, you should make sure you use utf-8 +as your charset, even if your country usually uses iso-8859-* or similar. The reason for this is +that Plone uses a few characters (like the ellipsis) that don't have representations in other +charsets.
+
+
+Step-by-step guide
+++1. Check if somebody is working on your language already. Even if they do, contact them and +offer to help with testing. There's no way the eduCommons team can know what is a high-quality +translation in a language they don't know, so your input is very valuable to us. We want +good translations, not just a translation. So if you think something is badly done, tell us. +Give polite feedback if something feels wrong with the translation to your language. A +translation can always be made better.
+2. Be sure that you have used eduCommons enough to grasp the general concepts and how they +interact. eduCommons is an advanced system, so be sure you know enough before you start +translating key concepts like workflow. Check the language specific terms for your language, +or create one if it doesn't exist. This will help you keep consistent translations for your +language.
+3. Download the files to base your translation on. We recommend that you always use the +English language files as your starting point, both because they are always the most current +ones (other translations will usually lag a bit behind), and because you should try to match +the original text. Translating between similar languages may be tempting (like Danish and +Norwegian), but will usually result in a lower quality translation. Of course, if the only +language you understand is Italian, and you want to provide a Chinese translation, we prefer +this translation compared to not getting one at all :)
+4. Here is a link to the most recent translation files available for eduCommons (plone.po and +eduCommons.po). Remember, unless there is already an existing translation available, you need +to grab the .pot files.
+++http://cosl.usu.edu/svndev/eduCommons3/trunk/i18n/
+Here are links to the latest translations for each of the eduCommons products on the Plone +Collective site (these links may change, so check back for the most accurate information):
+http://svn.plone.org/svn/collective/ZipFileTransport/branches/cosl-plone3/i18n/
+http://svn.plone.org/svn/collective/IMSTransport/branches/cosl-plone3/i18n/
+http://svn.plone.org/svn/collective/ContentLicensing/branches/cosl-plone3/i18n/
+http://svn.plone.org/svn/collective/PloneBookmarklets/branches/plone3/i18n/
+5. Open poEdit or your editor of choice and load the first of the master files. In poEdit +select File --> Open (for existing .po translation files) or File --> New catalog from POT file. +(to create a new translation from a .pot file). Be sure to set the language and language code in +Catalog --> Settings. With poEdit or other editors you will need to save your new translation files +as <product>-<language-code>.po (e.g. for a French translation: plone-fr.po, eduCommons-fr.po, etc). +Have a look at http://www.i18nguy.com for the correct language code.
+6. In poEdit, the first line shows the exact string that you have to translate. Your translation is +entered in the area below the original string. It's easy. This is why we recommend poEdit.
++
+- In other text editors things will look a little different. An example section can look like this:
+++++#. Default: "Export"+#: ../skins/eduCommons/Export_form.cpt+msgid "Export"+msgstr ""++The first line (marked with Default) shows the exact string that you have to translate. +Message attributes in the form ${foo} have to be included in the translated string exactly +as they are. These are variables that will be filled in the rendering process. Do not touch +this.
+The next lines (marked with :) list which templates inside eduCommons use this string. There +might be several templates re-using the same string, but it is normally in the same context. +Do not touch this.
+The next to last line (starting with msgid) holds the unique identifier for the string. Do +not touch this.
+Finally, the last line is where your job starts. Enter the text in your language, be careful +to keep the same casing (where appropriate, some languages have different rules that should +be applied).
+8. If there is programming code in a string, only translate the string, not the code. For example in, +Default: "${number} items matching your criteria." you would only translate "items matching your +criteria." The code in the first part should be left as it is, so the translation will look like this: +${number} TRANSLATION.
+9. Keep translating (but take breaks, this isn't done in one sitting - it's repetetive (but +rewarding) work. After you have translated all of plone.pot, you should start on eduCommons.pot. +Don't worry, you have already completed the biggest part.
+10. If you can, test your files. Get other people from your own country to test. This means having other +people check your file and putting your file in an eduCommons test instance, browsing it in +your language.
+11. If you are unsure about the best translation of a message, you can set it to fuzzy, so +others can look at these. Setting a message to fuzzy means adding a "#, fuzzy"-line directly +above the line starting with msgid (poEdit has a button for this).
+12. Since some of the translation files are hosted on the Plone Collective, if you know how SVN +works, you can get an account with Plone (Here's how to request write access to the Collective.) +and maintain the files in SVN yourself (see next section). If not, no problem, just e-mail your +translation to us at eduCommons [at] cosl [dot] usu [dot] edu, and we will add it for you and put it into the +eduCommons distribution in the next release. We will also add you to our our eduCommons +Localization Team page.
+13. Please check on your translations periodically to keep them updated as new versions are +released. A quick find for "" will reveal any new or missing stings that need to be translated.
+14. If you have other questions or about contributing a translation to eduCommons please contact +us at educommons [at] cosl [dot] usu [dot] edu. Thank you for you help!
+
+
+
+
+
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/docs/MIGRATIONS_OLD.html
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/docs/MIGRATIONS_OLD.html (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/docs/MIGRATIONS_OLD.html (revision 126)
@@ -0,0 +1,148 @@
+
+
+
+
+
+
+Migrating to eduCommons 3.1.1-final
+ +
+
+Preparation
+A few things you should do before beginning the migration:
++++
+- VERY IMPORTANT: SAVE A BACKUP OF YOUR Data.fs FILE, which is located in the [old instance home]/var directory of your eduCommons site. This file contains all of the content for your site. (This way you will able to restore your file from this Data.fs file if anything goes wrong.)
+- Using the Zope Management Interface (ZMI), export any customizations you have made in your [old site] --> portal_skins --> custom folder and then delete all files in the custom folder. You can re-import these customizations once you have migrated the site.
+- Verify that your current instance is eduCommons-3.0.2-final.
+
+
+Migration of eduCommons 3.0.2-final to 3.1.1-final
+The migration eduCommons from version 3.0.2-final to version 3.1.1-final +includes the following:
++++
+- Movement of Data.fs file to a new 3.1.1-final instance
+- Migration to Plone 3.0.6
+- Migration to the eduCommons 3.1.1-final instance
+- Final steps
+
+
+Movement of Data.fs file to a new 3.1.1-final instance
+For the first step, you will move the Data.fs file from the old instance to +the new instance. First of all, install an eduCommons-3.1.1-final +instance using the installations instructions found in [new instance home]/eduCommons/docs/. Stop both sites. Then +copy the Data.fs file from the var directory of the old site to the +var directory of the new site:
++sudo cp -rvfp [old instance home]/var/Data.fs [new instance home]/var/ ++
+
+Migration of Plone
+The following steps need to be performed in the ZMI, as eduCommons-3.1.1-final utlizes Plone 3.0.6, instead of 3.0.4:
++++
+- Open your 3.1.1-final eduCommons site in the ZMI. (click educommons setup, then click Zope Management Interface.)
+- Run portal_migration migration (click the upgrade button on the migrate tab)
+
+
+Installation of FileSystemStorage Product
+At this point in time, we need to ensure that the FileSystemStorage AddOn Product is installed:
++++
+- Open your 3.1.1-final eduCommons site in the ZMI. (click educommons setup, then click Zope Management Interface.)
+- Navigate to portal_quickinstaller
+- Select FileSystemStorage
+- Press Install
+
+
+Migration of the eduCommons 3.1.1-final instance
+eduCommons 3.1.1-final uses the portal_setup tool to perform the necessary upgrade from 3.0.2 to 3.1.1-final:
++++
+- Open your 3.1.1-final eduCommons site in the ZMI. (click educommons Setup, then click Zope Management Interface.)
+- Navigate to portal_setup
+- Press the 'Upgrades' tab
+- From the drop down menu, select 'Products.eduCommons:default' and click Choose Profile button.
+- Choose the 'Migration :: 3.0.2 to 3.1.0' option
+- Press Upgrade
+
+
+Final Steps
++Your site should now be migrated. Navigate to your site in the browser and ensure it has migrated.+
+
+
+
+
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/docs/PORTLETS.html
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/docs/PORTLETS.html (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/docs/PORTLETS.html (revision 126)
@@ -0,0 +1,165 @@
+
+
+
+
+
+
+Migrating to eduCommons 3.0.2
+ +
+
+Preparation
+A few things you should do before beginning the migration:
++++
+- VERY IMPORTANT: SAVE A BACKUP OF YOUR Data.fs FILE, which is located in the [old instance home]/var directory of your eduCommons site. This file contains all of the content for your site. (This way you will able to restore your file from this Data.fs file if anything goes wrong.)
+- Using the Zope Management Interface (ZMI), export any customizations you have made in your [old site] --> portal_skins --> custom folder and then delete all files in the custom folder. You can re-import these customizations once you have migrated the site.
+- Verify that your current instance is eduCommons-2.3.1-final.
+
+
+Migration of eduCommons 2.3.1-final to 3.0.2
+The migration eduCommons from version 2.3.1-final to version 3.1.1-final +includes the following:
++++
+- Pre-migration of Data.fs in version 2.3.1-final
+- Movement of Data.fs file to a new 3.0.2 instance
+- Migration of Plone 3.0.4
+- Migration of the eduCommons 3.1.1-final instance
+- Final steps
+
+
+Pre-migration of Data.fs in version 2.3.1-final
+For this step, you will need to copy the migration source code found in version 3.1.1-final. The file is located at eduCommons/extras/PreMigrate.py . +Copy this into [old instance]/Products/eduCommons/Extensions.
+Run the migration script by following these steps:
++++
+- Open your 2.3.1-final eduCommons site in the ZMI. (click educommons Setup, then click Zope Management Interface.)
+- From the drop down menu, select "External method" and click the Add button.
+- Enter the following parameters:
++
+- Id: Pre_Migrate_eduCommons3.0.2
+- Title: Pre_Migrate_eduCommons3.0.2
+- Module Name: eduCommons.Migrate
+- Function Name: pre_migrate_2_3_1_to_3_0_2
+- Click Add
+- Click on the Pre_Migrate_eduCommons3.0.2 script you just added
+- Click the test tab.
+- Verify that the method ran successfully. (It should give you feedback.)
+
+
+Movement of Data.fs file to a new 3.0.2 instance
+For the next step you will move the Data.fs file from the old instance to +the new instance. First of all, install an eduCommons-3.0.2 +instance using the installations instructions found in [new instance home]/eduCommons/docs/. Stop both sites. Then +copy the Data.fs file from the var directory of the old site to the +var directory of the new site:
++sudo cp -rvfp [old instance home]/var/Data.fs [new instance home]/var/ ++
+
+Migration of Plone
+The following steps need to be performed in the ZMI, as eduCommons-3.1.1-final utlizes Plone 3.0.4, instead of 2.5.x:
++++
+- Open your 3.0.2 eduCommons site in the ZMI. (click educommons setup, then click Zope Management Interface.)
++
+- Run portal_migration migration (click the upgrade button on the migrate tab)
+
+
+Migration of the eduCommons 3.0.2 instance
+Run the migration script included with the 3.1.1-final instance by following these steps:
++++
+- Copy the migration script found in Products/eduCommons/extras/Migrate.py to [new_instance]/Extensions/
+- Open your 3.1.1-final eduCommons site in the ZMI. (click educommons Setup, then click Zope Management Interface.)
+- Navigate to the root of the ZMI (click the Root Folder link located in the upper left portion of the page)
+- From the drop down menu, select "External method" and click the Add button.
+- Enter the following parameters:
++
+- Id: Migrate_eduCommons3.0.2
+- Title: Migrate_eduCommons2.0.2
+- Module Name: Migrate
+- Function Name: migrate_2_3_1_to_3_0_2
++
+- Click Add
+- Click on the Migrate_eduCommons3.0.2 script you just added
+- Click the test tab.
+- Verify that the method ran successfully. (It should give you feedback.)
+
+
+Final Steps
+++Your site should now be migrated. Navigate to your site in the browser and ensure it has migrated. +Based on the nature of the changes from Plone 2.5.x to Plone 3.0.4, if you performed major customizations, you may or may not need to refactor those changes to work properly in a Plone 3 environment.
+Here are some additional steps you may need to follow after migration, depending on how you have customized your site:
++
+- Check Course Homepage and About the Professor pages to see if the images render. In past versions of eduCommons, some of these image links may be broken, but rendered due to acquisition. The course folder appears twice in the link (i.e. department/course/course/page).
+- The Site homepage links to the Courses List, Frequently Asked Questions, and Help will need to be modified as follows:
++
+- OLD: <a title="List of Courses" href="/Courses_listing/">list of courses</a>.
+- NEW: <a title="List of Courses" href="/courselist/">list of courses</a>.
+- OLD: <a title="Frequently Asked Questions" href="/Help/">Frequently Asked Questions</a>
+- NEW: <a title="Frequently Asked Questions" href="/help/">Frequently Asked Questions</a>
+- OLD: <a title="Feedback" href="/Feedback/">feedback</a>
+- NEW: <a title="Feedback" href="/feedback/">feedback</a>
+- The Site's About page links to the Terms of Use and Privacy Policy will need to be modified as follows:
++
+- OLD: <a title="Terms of Use" href="../About/terms_of_use">Terms of Use</a>
+- NEW: <a title="Terms of Use" href="../about/terms_of_use">Terms of Use</a>
+- OLD: <a title="Privacy Policy" href="../About/privacy_policy">Privacy Policy</a>
+- NEW: <a title="Privacy Policy" href="../about/privacy_policy">Privacy Policy</a>
+- The top banner, portal logo, and top nav color setting can be checked and adjusted by managers and administrators via Site Setup --> Left Skin Settings. Any changes made to these settings must be done after having checked the Development Mode box. In order to change the background color in the top nav color, a 1px x 1px transparent gif needs to be loaded first to hide the top nav background image. Be sure to uncheck the Development Mode box after Left Skin changes have been saved to improve site performance.
+- In order to restore the "Join" link, login to the site as manager and click Site Setup --> Security. Then check the "Enable self-registration" box and click save.
+
+
+
+
+
+
+
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/docs/default.css
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/docs/default.css (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/docs/default.css (revision 126)
@@ -0,0 +1,331 @@
+/*
+:Author: David Goodger
+:Contact: goodger@users.sourceforge.net
+:Date: $Date: 2005-09-23 15:58:00 -0600 (Fri, 23 Sep 2005) $
+:Revision: $Revision: 1964 $
+:Copyright: This stylesheet has been placed in the public domain.
+t
+Default cascading style sheet for the HTML output of Docutils.
+
+See http://docutils.sf.net/docs/howto/html-stylesheets.html for how to
+customize this style sheet.
+*/
+
+/* "! important" is used here to override other ``margin-top`` and
+ ``margin-bottom`` styles that are later in the stylesheet or
+ more specific. See http://www.w3.org/TR/CSS1#the-cascade */
+
+body {
+
+ background: #B49F78;
+ margin-top: 0px;
+ font-family: Verdana, Arial, Helvetica, sans-serif;
+ text-align:center;
+}
+
+.document {
+ width: 800px;
+ margin:0 auto;
+ padding: 0 5px 0 5px;
+ color: #666;
+ background: #FFF;
+ border: 1px solid black;
+ text-align: left;
+}
+
+.document a:link, .document a:visited, .document a:hover, .document a:active {
+ color: #CC6600;
+}
+
+.first {
+ margin-top: 0 ! important }
+
+.last, .with-subtitle {
+ margin-bottom: 0 ! important }
+
+.hidden {
+ display: none }
+
+a.toc-backref {
+ text-decoration: none ;
+ color: black }
+
+blockquote.epigraph {
+ margin: 2em 5em ; }
+
+dl.docutils dd {
+ margin-bottom: 0.5em }
+
+/* Uncomment (and remove this text!) to get bold-faced definition list terms
+dl.docutils dt {
+ font-weight: bold }
+*/
+
+div.abstract {
+ margin: 2em 5em }
+
+div.abstract p.topic-title {
+ font-weight: bold ;
+ text-align: center }
+
+div.admonition, div.attention, div.caution, div.danger, div.error,
+div.hint, div.important, div.note, div.tip, div.warning {
+ margin: 2em ;
+ border: medium outset ;
+ padding: 1em }
+
+div.admonition p.admonition-title, div.hint p.admonition-title,
+div.important p.admonition-title, div.note p.admonition-title,
+div.tip p.admonition-title {
+ font-weight: bold ;
+ }
+
+div.attention p.admonition-title, div.caution p.admonition-title,
+div.danger p.admonition-title, div.error p.admonition-title,
+div.warning p.admonition-title {
+ color: red ;
+ font-weight: bold ;
+ }
+
+/* Uncomment (and remove this text!) to get reduced vertical space in
+ compound paragraphs.
+div.compound .compound-first, div.compound .compound-middle {
+ margin-bottom: 0.5em }
+
+div.compound .compound-last, div.compound .compound-middle {
+ margin-top: 0.5em }
+*/
+
+div.dedication {
+ margin: 2em 5em ;
+ text-align: center ;
+ font-style: italic }
+
+div.dedication p.topic-title {
+ font-weight: bold ;
+ font-style: normal }
+
+div.figure {
+ margin-left: 2em }
+
+div.header {
+ clear: both;
+ font-size: smaller;
+ text-align: center;
+
+}
+
+div.footer {
+ clear: both;
+ font-size: smaller;
+ text-align: center;
+ padding-top: 5px;
+
+}
+
+hr.footer {
+ display: none;
+}
+
+
+
+
+
+div.footer a {
+ color: #fff;
+ text-decoration: underline;
+}
+
+div.line-block {
+ display: block ;
+ margin-top: 1em ;
+ margin-bottom: 1em }
+
+div.line-block div.line-block {
+ margin-top: 0 ;
+ margin-bottom: 0 ;
+ margin-left: 1.5em }
+
+div.sidebar {
+ margin-left: 1em ;
+ border: medium outset ;
+ padding: 1em ;
+ background-color: #ffffee ;
+ width: 40% ;
+ float: right ;
+ clear: right }
+
+div.sidebar p.rubric {
+ ;
+ font-size: medium }
+
+div.system-messages {
+ margin: 5em }
+
+div.system-messages h1 {
+ color: red }
+
+div.system-message {
+ border: medium outset ;
+ padding: 1em }
+
+div.system-message p.system-message-title {
+ color: red ;
+ font-weight: bold }
+
+div.topic {
+ margin: 2em }
+
+h1, h1, h3, h4, h5, h6 {
+ font-size: 1em;
+}
+
+h1.section-subtitle, h2.section-subtitle, h3.section-subtitle,
+h4.section-subtitle, h5.section-subtitle, h6.section-subtitle {
+ margin-top: 0.4em }
+
+h1.title {
+ text-align: center }
+
+h2.subtitle {
+ text-align: center }
+
+hr.docutils {
+ width: 75% }
+
+img.align-left {
+ clear: left }
+
+img.align-right {
+ clear: right }
+
+img.borderless {
+ border: 0 }
+
+ol.simple, ul.simple {
+ margin-bottom: 1em }
+
+ol.arabic {
+ list-style: decimal }
+
+ol.loweralpha {
+ list-style: lower-alpha }
+
+ol.upperalpha {
+ list-style: upper-alpha }
+
+ol.lowerroman {
+ list-style: lower-roman }
+
+ol.upperroman {
+ list-style: upper-roman }
+
+p.attribution {
+ text-align: right ;
+ margin-left: 50% }
+
+p.caption {
+ font-style: italic }
+
+p.credits {
+ font-style: italic ;
+ font-size: smaller }
+
+p.label {
+ white-space: nowrap }
+
+p.rubric {
+ font-weight: bold ;
+ font-size: larger ;
+ color: maroon ;
+ text-align: center }
+
+p.sidebar-title {
+ ;
+ font-weight: bold ;
+ font-size: larger }
+
+p.sidebar-subtitle {
+ ;
+ font-weight: bold }
+
+p.topic-title {
+ font-weight: bold }
+
+pre.address {
+ margin-bottom: 0 ;
+ margin-top: 0 ;
+ font-family: serif ;
+ font-size: 100% }
+
+pre.line-block {
+ font-family: serif ;
+ font-size: 100% }
+
+pre.literal-block, pre.doctest-block {
+ margin-left: 2em ;
+ margin-right: 2em ;
+ background-color: #eeeeee }
+
+span.classifier {
+ ;
+ font-style: oblique }
+
+span.classifier-delimiter {
+ ;
+ font-weight: bold }
+
+span.interpreted {
+ }
+
+span.option {
+ white-space: nowrap }
+
+span.pre {
+ white-space: pre }
+
+span.problematic {
+ color: red }
+
+span.section-subtitle {
+ /* font-size relative to parent (h1..h6 element) */
+ font-size: 80% }
+
+table.citation {
+ border-left: solid thin gray }
+
+table.docinfo {
+ margin: 2em 4em }
+
+table.docutils {
+ margin-top: 0.5em ;
+ margin-bottom: 0.5em }
+
+table.footnote {
+ border-left: solid thin black }
+
+table.docutils td, table.docutils th,
+table.docinfo td, table.docinfo th {
+ padding-left: 0.5em ;
+ padding-right: 0.5em ;
+ vertical-align: top }
+
+table.docutils th.field-name, table.docinfo th.docinfo-name {
+ font-weight: bold ;
+ text-align: left ;
+ white-space: nowrap ;
+ padding-left: 0 }
+
+h1 tt.docutils, h2 tt.docutils, h3 tt.docutils,
+h4 tt.docutils, h5 tt.docutils, h6 tt.docutils {
+ font-size: 100% }
+
+tt.docutils {
+ background-color: #eeeeee }
+
+ul.auto-toc {
+ list-style-type: none }
+
+.reference {
+ color: #FFF;
+}
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/docs/src/CHANGES.txt
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/docs/src/CHANGES.txt (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/docs/src/CHANGES.txt (revision 126)
@@ -0,0 +1,311 @@
+========================
+Changes in version 3.1.0
+========================
+
+"Download Course" Additions
+ Moved "download this course" into a "Reuse Course" portlet. The course downloads now include IMS information. Using a portlet will also allow for additional formats, such as Common Cartridge, to be added in the future.
+
+Display License and Caption for Embedded Objects
+ Using the Kupu editor, eduCommons can now display separate licenses and citations for image objects embedded in a page, distinct from the overall page license.
+
+Captcha integration
+ We now integrate captcha on the registration page to prevent spambot submissions.
+
+Lingua Plone 2.0 Integration
+ LinguaPlone 2.0 has been implemented into eduCommons 3.1.0, allowing users to localize content and support multiple languages on a single OpenCourseWare site.
+
+Add accessibility check
+ This is intended to help institutions who want to include accessibility check into their workflow.
+
+Enable Javascript/Page-specific CSS and embed tags by default
+ We have enabled Javascript and page-specific CSS and embed tags by default.
+
+Documentation for Adding Small Widgets
+ Add eduCommons-specific documentation and examples for adding Plone 3 portlets.
+
+Add "Remix this course" functionality
+ This feature is designed to allow courses from MIT OpenCourseWare (pending implementation by MIT OCW) as well as other eduCommons OCWs to be easily imported into OpenOCW (or another eduCommons site if specified, but OpenOCW will be the default). On published eduCommons OCW courses that have been packaged, a "Remix this course" link appears. This allows unauthenticated users to send the entire course to OpenOCW (OpenOCW login credentials must be provided).
+
+Update "download this course" to improve handling of large courses
+ "Download this course" is no longer auto-generated when a course is published or changed. Instead, a new "Package course" button appears in the contents view of the course once it has been published. The "Download this course" .zip file now includes IMS information. It now appears in its own portlet, along with the "Remix this course" link.
+
+Other updates
+ Updated eduCommons to exclude new content from showing in the left nav by default (including zip imports).
+ Improved IE 6 and 7 compatibility.
+
+========================
+Changes in version 3.0.2
+========================
+
+Fixed bugs in 3.0.1 migration release
+
+
+========================
+Changes in version 3.0.1
+========================
+
+Added migration support for from eduCommons 2.3.1
+
+
+========================
+Changes in version 3.0.0
+========================
+
+Added full support for Plone 3.0
+ Inline editing
+ Working Copy support
+ Link and reference integrity checking
+ Automatic locking and unlocking
+ Easy collaboration and sharing
+ Versioning, history and reverting content
+ Upgraded visual HTML editor
+
+Added OpenOCW Functionality
+ Simplified Workflow
+ Refactored Security
+ Eased Production processes
+
+Simplified Course Building
+ Course Builder Widget allows 'one step' production of Division, Course, and templates Course objects (syllabus, etc).
+
+
+========================
+Changes in version 2.3.1
+========================
+
+Added Migration from 2.2.0
+ The migration process has been improved and simplified.
+
+
+========================
+Changes in version 2.3.0
+========================
+
+Added i18n Support for Spanish, Dutch, French, and Chinese
+ Translations are now available for the aforementioned languages.
+
+Added Support for MOCSL Tools
+ The Folksemantic AddOn Product allows for seamless interaction with
+ Annorate, Make A Path, and Send2Wiki.
+
+Fixed Metadata Bugs
+ The Citations were presenting incorrect metadata; now pulling in correct
+ metadata per object.
+
+Added Course Wide Instructor Metadata
+ A flag is now available to note if the Instructor of the Course is also the
+ principal creator for objects within the course.
+
+Added MIT CP Import Support
+ Via the IMS Transport Tool, an end user can now import IMS Content Packages.
+ eduCommons will strip the package of it's chrome and import content, navigation,
+ and metadata.
+
+Added Zip File Download for Courses
+ End Users can now get a Zip File download of a course object, stripped of eduCommons
+ chrome and ready for reuse
+
+Extended RSS Feed Support
+ Departments and Courses now have configurable feeds per object, and the ability to turn
+ feeds on and off
+
+Added Recursive Copyright Clearance
+ Folderish Objects may now recrusively clear or revoke copyight
+
+
+========================
+Changes in version 2.2.0
+========================
+
+Front end UI Enhancements
+
+Auto-citation generation (from metadata) displayed inline with documents and included in skinless content. Simplify conformance with Attribution terms of Creative Commons licenses for those who build derivative works.
+
+Social Bookmarking Dropdown. Help users bookmark and later find OERs hosted in eduCommons using popular social bookmarking services.
+
+Integration with MyOCW (pending MyOCW release dates).
+
+Expanded support for IMS Content Packaging, including a transform engine that can translate from popular IMS CP formats to and from eduCommons.
+
+Updated internationalization support, with translation updates for a predetermined set of languages.
+
+Finalized support for content translation using the LinguaPlone product.
+
+
+========================
+Changes in version 2.1.1
+========================
+
+Updated Internationalization Files
+ Updated internationalization files to reflect the latest eduCommons changes.
+
+Added Support for Inline Translations
+ Integrated the LinguaPlone product with eduCommons, making it now possible
+ to have multiple translations of content within the same eduCommons instance.
+
+RSS Feeds on front page, and RSS feeds for departments
+ RSS feed icon now appears on the front page of eduCommons, as well as on the
+ courses listing page. A new RSS feed now appears for departments, which
+ lists the latest published courses in a department.
+
+Added Support for Social Bookmarking Services
+ Added support for bookmarking services, starting with del.icio.us. Support
+ for more to come.
+
+Added a Skinless View for Documents
+ eduCommons now provides a skinless view of documents, making it both possible
+ and easy to reuse content.
+
+==============================
+Changes in version 2.1.0-final
+==============================
+
+A new IMS Transport Engine
+ A refactored IMS Content Packaging engine that provides a more robust import
+ and export functionality. On import eduCommons will identify where required
+ tags missing in the manifest file, if it is not able to read it directly.
+
+IMS Content Packaging Documentation
+ This version ships with detailed documentation on how to write out an IMS
+ Content Package that eduCommons can consume. The documentation is provided
+ in raw text, web based, and in a standalone (PDF) file.
+
+A New Content Licensing Engine
+ eduCommons now allows a default content license and a rights holder to be
+ set sitewide. It also includes the ability to license an individual piece
+ of content, should the need arise to publish content under a license
+ different to the site wide one.
+
+Copyright Bylines
+ Content is now published with the appropriate copyright byline, including
+ the ability to specify copyright dates, the rights holder, and the license
+ itself. The license includes a hyper-link to the legal terms of the license
+ as well as an icon (if the license includes one).
+
+Creative Commons License Support
+ eduCommons now includes a license selector that integrates with Creative
+ Commons Licenses (www.creativecommons.org), allowing eduCommons to remain
+ flexible with the latest CC offerings.
+
+Support for Other Licenses
+ eduCommons supports other licenses, including the traditional all rights
+ reserved, and GNU Free Document Licenses, as well as allowing content
+ developers to input their own license.
+
+RDF and machine readable Creative Commons License Support
+ eduCommons will publish by default any metadata for a content object in
+ embedded RDF format. eduCommons will also publish machine readable creative
+ commons licenses, that can be read and processed by search engines.
+
+Content Licensing Product for Plone 2.5
+ The content licensing features in eduCommons are shipped in a standalone product
+ that can also be used in a default Plone 2.5 instance.
+
+Native Support for Plone 2.5
+ This version of eduCommons supports the latest version of Plone (2.5), with some
+ functionality now taking advantage of the new Zope 3 component architecture.
+
+Improved HTML Validation/Fixing Engine
+ The HTML Validation/Fixer Engine has been updated, and now displays a detailed
+ report of problems within the body of an HTML document, and provides a simple
+ method to fix most problems, and identify remaining ones that need extra
+ attention. This functionality works when a content developer's editor is not
+ set to use the FCKeditor.
+
+
+
+
+==============================
+Changes in version 2.0.0-final
+==============================
+
+Human Readable URLS
+ URLs are human readable, instead of being based on an auto generated id.
+
+Recursive Folder Change State
+ Can change workflow state recursively on content in subfolders.
+
+Native Support for Plone 2.1
+ Integrated eduCommons custom skin files with new Plone 2.1 functionality.
+ Content objects are now based on ATContentTypes. Substantial changes across
+ the code base. eduCommons is currently based on Plone-2.1.2 and Zope-2.8.6.
+
+Content Status History on Object Views in Edit Mode
+ The content status history of an object is now available in the view from
+ a history link at the top of the page while in edit mode.
+
+No Redirect on Front Page
+ Front page no longer redirects to an ECIndex folder, but renders directly.
+
+Removed Forum Support
+ Forum support is being replaced by new social software in the future, which
+ means that the old OLS code base is no longer being maintained. If you require
+ forum support it is recommended that you use the excellent zForum
+ (http://www.zforum.org) plone product until the new software is in place.
+
+Improved IMS Content packaging
+ Workflow status history is now written in the IMS content package instead
+ of being stored in a binary blob.
+
+eduCommons Custom Skin Support
+ eduCommons can now reskinned in release mode without requiring eduCommons
+ to be restarted.
+
+Courses Object Removed
+ The courses object has been removed, and departments are now put in the
+ root of the site. This simplifies the UI and removes confusion over what
+ the Courses object is/was.
+
+Improved Default Templates
+ Default templates for the front page, FAQ and about pages propagate the
+ eduCommons site title, making it easier to customize default site text.
+
+Department and Course IDs
+ Departments and Courses now support the display of ID's in front of their
+ titles. Courses also support the display of the year and semester that the
+ course was taught in.
+
+==============================
+Changes in version 1.6.1-final
+==============================
+
+eduCommons Document HTML Fixer
+ Implement an HTML engine that can fix HTML mistakes automatically in ecDocuments.
+
+RDF Headers/Metadata
+ Add RDF headers to ECDocuments implementing the RDF/Dublin Core standard.
+
+Support for Plone 2.1.1/Zope 2.8.2
+ Implementing support for the latest Plone (2.1.1) and Zope (2.8.2) code bases.
+
+Support for Default Templates
+ Support for adding default templates for commonly used pages within eduCommons.
+
+
+Review and Revise IMS Export Rights
+ Changes in the UI to only present IMS import/export to administrators and managers.
+ This is necessary because producers do not have rights on content that is not in the
+ "In Progress" state, which prevents producers from being able to import/export
+ content not in the appropriate state.
+
+
+Zip export (non-ims)
+ Allow a producer administrator or manager to export course content in a zip file format.
+
+Creative Commons metadata header
+ Add a metadata header to ECDocuments for the creative commons license.
+
+Removal of "Courses" link in bread crumb
+ Remove the "Courses" link in the breadcrumb due to the fact that is is confusing to users.
+
+XHTML Validation of an Entire Course
+ Adding the ability to do validation of XHTML across a course, while reporting
+ errors in a log file.
+
+Add Folders to Course Contents
+ Add folders to course content pages so that objects which externally link to other
+ objects will retain their links with out having to rewrite them.
+
+Migration from 1.5.2-final
+ Implement the ability to migrate existing 1.5.2-final sites to 1.6.1-final.
+
Index: /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/docs/src/IMSContentPackaging.txt
===================================================================
--- /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/docs/src/IMSContentPackaging.txt (revision 126)
+++ /enpraxis.educommons/tags/3.2.0-pre/enpraxis/educommons/docs/src/IMSContentPackaging.txt (revision 126)
@@ -0,0 +1,529 @@
+IMS Content Packaging and eduCommons $$version$$
+================================================
+
+This document details how to write IMS Content packages that are compatible with
+eduCommons $$version$$.
+
+eduCommons uses version 1.2 of the IMS Content Packaging Specification. XML Schemas
+for the specification can be found at http://imsglobal.org/xsd/imscp_v1p2.xsd and
+http://imsglobal.org/xsd/imsmd_v1p2p4.xsd.
+
+Using XML Schemas and a Validating XML Editor
+=============================================
+
+In the process of writing software that exports eduCommons supported IMS Content
+Packages, it is highly recommended to use a validating XML editor and associated
+schema files to check manifests for validity. eduCommons in some circumstances
+will expect import manifests to meet validity standards, and the chances of
+creating content packages that will work with eduCommons will be greatly increased.
+eduCommons provides XML schema files on export for this purpose.
+
+An XML schema file for eduCommons specific metadata can be found both online
+(http://cosl.usu.edu/xsd/eduCommonsv1.1.xsd) and in eduCommons IMS Content
+Packages.
+
+To use the IMS Content Package XML schemas along with the eduCommons schema, make
+sure your manifest specifies these packages and the relevant XML schema informtation
+in the header. Below is an example of attributes which you may want to set on the
+*manifest* tag.
+
+::
+
+ xmlns="http://www.imsglobal.org/xsd/imscp_v1p1"
+ xmlns:eduCommons="http://cosl.usu.edu/xsd/eduCommonsv1.1"
+ xmlns:imsmd="http://www.imsglobal.org/xsd/imsmd_v1p2"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://www.imsglobal.org/xsd/imscp_v1p1 imscp_v1p2.xsd
+ http://www.imsglobal.org/xsd/imsmd_v1p2 imsmd_v1p2p4.xsd
+ http://cosl.usu.edu/xsd/eduCommonsv1.2 eduCommonsv1.2.xsd">
+
+
+
+Specifying and Using eduCommons Namespaces
+==========================================
+
+The IMS CP specification allows content packages to be extended using custom
+metadata fields. eduCommons takes advantage of this to pass information that
+does not fit into the LOM metadata format. Using the eduCommons extensions
+requires the use of the eduCommons namespace in typical XML style.
+
+eduCommons can read values from colon prefixed tags, or by using an *xmlns*
+attribute on the top level eduCommons tag as shown below. Although both methods
+are acceptable, the latter is preferred due to the fact that it makes the
+corresponding XML more readable. Examples in the rest of the document will
+be given in this format.
+
+::
+
+
+
+Adding Portlets To eduCommons
+A portlet is a user-interface component that can be "plugged-in" to the architecture of Plone, the framework upon which eduCommons is based. There are several portlets that are natively available when you install eduCommons: the Course Info portlet that appears in the right navigation is an example, the Course Builder portlet is another. This tutorial will explain how portlets can be added and removed and how you can create your own portlet from scratch.
+ +
+
+Adding and Removing Existing Portlets
+If a portlet already exists that you either want to remove or add, follow these steps.
+-
+
- navigate to the site as an administrator. +
- click on the manage portlets link. +
The manage portlets page allows you to add and remove portlets.
+-
+
- To add a portlet click on the Add portlet... drop down menu and select the portlet to add. +
- To delete a portlet click on the small red x next to the portlet to remove. +
You can also change the order that the portlets appear by using the small blue arrows next to the porlets.
+
+
+Creating Your Own Portlet
+One of the simplest ways to create a portlet is to use the ZopeSkel tool to create a skeleton product that you can then modify for your own purposes. The Plone site has an excellent article describing how to install and use the ZopeSkel tool. Once you have ZopeSkel installed you can create a new portlet package using the plone3_portlet template.
++paster create -t plone3_portlet ++
Enter the information, as prompted, for the portlet you are creating. To select the defaults, just press enter.
++Enter project name: SamplePortletProject +Variables: + egg: SamplePortletProject + package: sampleportletproject + project: SamplePortletProject +Enter namespace_package (Namespace package (like plone)) ['collective']: sample_portlet_project +Enter namespace_package2 (Nested namespace package (like app)) ['portlet']: +Enter package (The package contained namespace package (like example)) ['example']: +Enter zope2product (Are you creating a Zope 2 Product?) [True]: +Enter version (Version) ['0.1']: +Enter description (One-line description of the package) ['']: This is a sample portlet product +Enter long_description (Multi-line description (in reST)) ['']: +Enter author (Author name) ['Plone Foundation']: +Enter author_email (Author email) ['plone-developers@lists.sourceforge.net']: +Enter keywords (Space-separated keywords/tags) ['']: +Enter url (URL of homepage) ['http://plone.org']: +Enter license_name (License name) ['GPL']: +Enter zip_safe (True/False: if the package can be distributed as a .zip file) [False]: +Enter portlet_name (Portlet name (human readable)) ['Example portlet']: Sample Portlet +Enter portlet_type_name (Portlet type name (should not contain spaces)) ['ExamplePortlet']: SamplePortlet ++
A portlet package will be created in the folder where you ran the script. Follow the directions in the Plone article to install the new portlet package using easy_install. Another option is to tell the paster script to create a Plone 2 product and then copy this product into the Products directory of your plone instance (the Plone 2 product is buried down a few levels in the package). In either case, after you restart your Plone instance and navigate to the Add-on Products page of your Plone site you will see the new product listed. After installing the product into your Plone site you will be able to manage it as you do the other portlets in your site.
+
+
+Customizing Portlets
+If you look at the code, generated in the last section, you will see that this new product is relatively simple. It contains a configure.zcml file, a template file, a python file, a profile folder, and a tests folder. Often the only places that will need to be changed to customize the portlet will be the template file and the renderer within the python file. Here are some examples of portlets that do just that:
+
+
+OerRecommender Portlet
+This is the oerrecommender.pt template file for the oerrecommender. The file consists of a script tag that retrieves a series of recommendations from oerrecommender.org.
+
+<div id="recommendations">
+ <script language="JavaScript"
+ tal:define="url here/absolute_url"
+ tal:attributes="src string:http://www.oerrecommender.org/recommendations.pjs?educommons=true&u=${url}&title=true;"
+ type="text/javascript">
+ </script>
+</div>
+
+Here is the renderer for the oerrecommenderportlet.py file.
+
+class Renderer(base.Renderer):
+ """ Render the OER Portlet """
+ render = ViewPageTemplateFile('oerrecommender.pt')
+
+ def __init__(self, context, request, view, manager, data):
+ super(Renderer, self).__init__(context, request, view, manager, data)
+ self.props = self.context.portal_properties.educommons_properties
+
+ @property
+ def available(self):
+ return self.props.oerrecommender_enabled
+
+You'll notice that the renderer is where we define which page template to use when rendering the template. This file also contains a property that allows the portlet to be conditionally displayed based on whether the oerrecommender is enabled.
+
+
+CourseBuilder Portlet
+The Course Builder tool allows users to quickly create a course with its associated files and departments. In this coursebuilder.pt template file you can see the portlet displaying a link to the Course Builder form (the '@@' symbol signifies that the resource is a view).
+
+<dl class="portlet portletCourseBuilder"
+ i18n:domain="eduCommons">
+
+ <dt class="portletHeader"
+ i18n:translate="box_course_builder">
+ Course Builder
+ </dt>
+
+ <dd class="portletItem even">
+ <a href=""
+ i18n:translate="text_build_course"
+ tal:attributes="href string:${here/portal_url}/@@coursebuilderform">Build a Course</a>
+ </dd>
+
+</dl>
+
+
+
+CourseInfo Portlet
+The CourseInfo portlet displays course statistics for the objects within each course. Methods are defined with the python file that are then used with the template file. For example, the renderer for the portlet in the courseinfoportlet.py file contains several methods
++... +def statePercent(self, state=''): + """ return the percent value for a given state """ + + if 0 == self.total: + return '0%' + else: + width = float(self.stateCounts[state])/float(self.total) * 100.0 + return '%d%%' %int(width) +... ++
that are then used in the courseinfo.pt template file.
++... + <img alt="barchart" class="statecolumnimage" + tal:attributes="width python:view.statePercent(item); + src string:bargraphic.gif" /> +... ++
+
+Additional Resources
+There are some great resources to help you in customizing existing portlets and for adding functionality to portlets that you've created using the ZopeSkel product.
+If you would like to do some quick and dirty customization through-the-web you'll probably want to use the portal_view_customizations tool in the ZMI. It's similar to portal_skins but for view, viewlets, and portlets.
+Martin Aspeli has a whole tutorial on customizing a plone site which includes a section on customizing portlet renderers.
+The Plone site also has a tutorial that shows how to override existing portlets.
+
+
+
+
+.. _oerrecommender.pt: http://cosl.usu.edu/svndev/eduCommons3/tags/3.1.0-final/portlet/oerrecommender.pt
+
+Here is the renderer for the oerrecommenderportlet.py_ file.
+
+::
+
+ class Renderer(base.Renderer):
+ """ Render the OER Portlet """
+ render = ViewPageTemplateFile('oerrecommender.pt')
+
+ def __init__(self, context, request, view, manager, data):
+ super(Renderer, self).__init__(context, request, view, manager, data)
+ self.props = self.context.portal_properties.educommons_properties
+
+ @property
+ def available(self):
+ return self.props.oerrecommender_enabled
+
+.. _oerrecommenderportlet.py: http://cosl.usu.edu/svndev/eduCommons3/tags/3.1.0-final/portlet/oerrecommenderportlet.py
+
+You'll notice that the renderer is where we define which page template to use when rendering the template. This file also contains a property that allows the portlet to be conditionally displayed based on whether the oerrecommender is enabled.
+
+.. _CourseBuilder Portlet:
+
+CourseBuilder Portlet
+======================
+The Course Builder tool allows users to quickly create a course with its associated files and departments. In this coursebuilder.pt_ template file you can see the portlet displaying a link to the Course Builder form (the '@@' symbol signifies that the resource is a view).
+
+.. _coursebuilder.pt: http://cosl.usu.edu/svndev/eduCommons3/tags/3.1.0-final/portlet/coursebuilder.pt
+
+::
+
+ -
+
+
- + Course Builder + + +
- + Build a Course + + +
Starting Migration
\n' + print >> out, '- \n'
+
+ oldsite = self.eduCommons
+
+ # If we have a previous attempt, erase it
+ if getattr(self, 'mig_ec', None):
+ self.manage_delObjects(['mig_ec'])
+
+ # Create a new plone site
+ addPloneSite(self,
+ 'mig_ec',
+ extension_ids = ('Products.ContentLicensing:default',
+ 'Products.IMSTransport:default',
+ 'Products.PloneBookmarklets:default',
+ 'Products.ZipFileTransport:default',
+ 'Products.eduCommons:default',
+ 'Products.leftskin:default',
+ ))
+
+ newsite = self.mig_ec
+ print >> out, '
- New eduCommons site Created \n' + + # Copy MailHost Settings + newsite.MailHost = oldsite.MailHost + + # Copy about folder contents + + newsite.about.manage_delObjects(['abouttext_text', + 'terms-of-use', + 'privacy-policy']) + objs = oldsite.about.manage_copyObjects(oldsite.about.objectIds()) + newsite.about.manage_pasteObjects(objs) + newsite.about.manage_renameObjects(['copy_of_index_html'], ['abouttext_text']) + setWorkflow(self, newsite.about, oldsite.about, {'index_html':'abouttext_text'}, False) + print >> out, '
- Migrated the About folder \n' + + # Copy Help folder contents + + newsite.help.manage_delObjects(['help_text']) + objs = oldsite.help.manage_copyObjects(oldsite.help.objectIds()) + newsite.help.manage_pasteObjects(objs) + newsite.help.manage_renameObjects(['copy_of_index_html'], ['help_text']) + setWorkflow(self, newsite.help, oldsite.help, {'index_html':'help_text'}, False) + print >> out, '
- Migrated the Help folder \n' + + # Copy the old feedback contents + + objs = oldsite.feedback.manage_copyObjects(oldsite.feedback.objectIds()) + newsite.feedback.manage_pasteObjects(objs) + newsite.feedback.manage_renameObjects(['copy_of_index_html'], ['feedback']) + setWorkflow(self, newsite.feedback, oldsite.feedback, {'index_html':'feedback'}, False) + print >> out, '
- Migrated the Feedback folder \n' + + # Migrate other top level content + + objs = oldsite.portal_catalog.searchResults(portal_type=['File', 'Image', 'Document'], + path={'query':'/', + 'depth':2,}) + newsite.manage_delObjects(['front-page']) + obj_ids = [x.id for x in objs] + co = oldsite.manage_copyObjects(obj_ids) + newsite.manage_pasteObjects(co) + for x in obj_ids: + obj = getattr(oldsite, x) + newobj = getattr(newsite, x) + if x != 'front-page': + newobj.setExcludeFromNav(True) + if obj.__annotations__.has_key('review_state'): + moveWorkflow(self, newobj, obj.__annotations__['review_state']) + + # Copy OCW content + + depts = oldsite.portal_catalog.searchResults(Type='Folder', + path={'query':'/', + 'depth':2,}) + print >> out, '
- Migrating Divisions \n' + print >> out, '
- Migrated %s \n' %obj.Title() + elif dept.id not in ['help', 'about', 'feedback']: + co = oldsite.manage_copyObjects(obj.id) + newsite.manage_pasteObjects(co) + setWorkflow(self, getattr(newsite, obj.id), obj) + + print >> out, '
- Migrated Content \n' + + + + # Migrate Theme + if getattr(oldsite.portal_skins.custom, 'base_properties', None): + oldprops = oldsite.portal_skins.custom.base_properties + newprops = newsite.portal_skins.custom.base_properties + + ns = newsite.portal_skins + os = oldsite.portal_skins + + copyProperty(os, ns, 'logoName', 'logoName', True) + copyProperty(os, ns, 'headerColor', 'portalHeaderBackgroundColor') + copyProperty(os, ns, 'bannerImage', 'portalHeaderBackgroundImage', True) + copyProperty(os, ns, 'topNavBackground', 'portalTopNavBackgroundColor') + copyProperty(os, ns, 'topNavBarBgImage', 'portalTopNavBackgroundImage', True) + #copyProperty(os, ns, 'leftNavColor', 'portalColumnOneBackgroundColor') + copyProperty(os, ns, 'leftBgName', 'portalColumnOneBackgroundImage', True) + copyProperty(os, ns, 'favicon', 'faviconName', True) + + print >> out, '
- Migrated theme \n' + + # Properties + #Migrate ContentLicensing Propertiese + old_cl_props = oldsite.portal_properties.contentlicensing_properties + new_cl_props = newsite.portal_properties.content_licensing_properties + for prop in old_cl_props.propertyMap(): + #Overwrite default new values with default old values + if prop['id'] in new_cl_props.propertyIds(): + id = prop['id'] + if id != 'Jurisdiction': + key_value = {id : old_cl_props.getProperty(id) } + new_cl_props.manage_changeProperties(**key_value) + else: + for value in new_cl_props.jurisdiction_options: + if old_cl_props.getProperty(id) in value: + new_cl_props.manage_changeProperties(Jurisdiction=value) + #Add properties if they don't exist in new + else: + id = prop['id'] + type = prop['type'] + value = old_cl_props.getProperty(id) + new_cl_props.manage_addProperty(id=id, type=type, value=value) + + print >> out, '
- Migrated ContentLicensing Properties \n' + + #Migrate IMSTransport Properties + old_ims_props = oldsite.portal_properties.ims_properties + new_ims_props = newsite.portal_properties.ims_transport_properties + for prop in old_ims_props.propertyMap(): + #Overwrite default new values with default old values + if prop['id'] in new_ims_props.propertyIds(): + id = prop['id'] + key_value = {id : old_ims_props.getProperty(id) } + new_ims_props.manage_changeProperties(**key_value) + #Add if doesn't exist in new (different engines) + else: + id = prop['id'] + type = prop['type'] + value = old_ims_props.getProperty(id) + new_ims_props.manage_addProperty(id=id, type=type, value=value) + + + print >> out, '
- Migrated IMSTransport Properties \n' + + #Migrate relevant old site properties + old_site_props = oldsite.portal_properties.migrateable_properties + newsite.manage_changeProperties(title=old_site_props.site_title, + description=old_site_props.description, + email_from_address=old_site_props.email_from_address, + email_from_name=old_site_props.email_from_name + ) + ec_props = newsite.portal_properties.educommons_properties + ec_props.manage_changeProperties(division_descriptor=old_site_props.division_descriptor, + course_descriptor=old_site_props.course_descriptor + ) + + print >> out, '
- Migrated Site properties \n' + + #Migrate Users + old_users = oldsite.acl_users.manage_copyObjects(['local_roles', + 'mutable_properties', + 'portal_role_manager', + 'source_groups', + 'source_users']) + newsite.acl_users.manage_delObjects(['local_roles', + 'mutable_properties', + 'portal_role_manager', + 'source_groups', + 'source_users']) + newsite.acl_users.manage_pasteObjects(old_users) + + #Activate plugins for each copied object + acl_users = newsite.acl_users + acl_users.local_roles.manage_activateInterfaces(['ILocalRolesPlugin', + 'IRolesPlugin']) + acl_users.mutable_properties.manage_activateInterfaces(['IPropertiesPlugin', + 'IUserEnumerationPlugin']) + acl_users.portal_role_manager.manage_activateInterfaces(['IRoleAssignerPlugin', + 'IRoleEnumerationPlugin', + 'IRolesPlugin']) + acl_users.source_groups.manage_activateInterfaces(['IGroupEnumerationPlugin', + 'IGroupIntrospection', + 'IGroupManagement', + 'IGroupsPlugin']) + acl_users.source_users.manage_activateInterfaces(['IAuthenticationPlugin', + 'IUserAdderPlugin', + 'IUserEnumerationPlugin', + 'IUserIntrospection', + 'IUserManagement']) + + old_pgd = oldsite.portal_groupdata + newsite.portal_groupdata = old_pgd + + old_pmd = oldsite.portal_memberdata + newsite.portal_memberdata = old_pmd + + #Set all users default editor to Kupu + users = newsite.acl_users.getUsers() + for user in users: + user.setProperties(wysiwyg_editor = 'Kupu') + + print >> out, '
- Migrated Users \n' + + # Move new site into place + + self.manage_delObjects(oldsite.getId()) + self.manage_renameObject(newsite.getId(), 'eduCommons', REQUEST=None) + + + print >> out, '
- \n'
+
+ for dept in depts:
+ obj = dept.getObject()
+ if obj.__annotations__.has_key('dept.text'):
+ migrateDivision(self, newsite, obj)
+ print >> out, '
or
. In the latter case we strip out
+# the enclosing tag since we are going to insert our own.
+PATIMG = '\\]+class\s*=[^=>]*captioned[^>]+\\>'
+PATA = '(?:(?P\\]*\\>)'+PATIMG+'\\)' + '|' + PATIMG
+PAT0 = '(?P'+PATA+')'
+PAT1 = '<(?:p|div)[^>]*>'+PAT0 + '' + '|' + PAT0.replace('0>','1>')
+IMAGE_PATTERN = re.compile(PAT1, re.IGNORECASE)
+
+# Regex to match stupid IE attributes. In IE generated HTML an
+# attribute may not be enclosed by quotes if it doesn't contain
+# certain punctuation.
+ATTR_VALUE = '=(?:"?)(?P<%s>(?<=")[^"]*|[^ \/>]*)'
+ATTR_CLASS = ATTR_VALUE % 'class'
+ATTR_WIDTH = ATTR_VALUE % 'width'
+ATTR_HEIGHT = ATTR_VALUE % 'height'
+ATTR_ALT = ATTR_VALUE % 'alt'
+
+ATTR_PATTERN = re.compile('''
+ (?P\<
+ ( class%s
+ | src\s*=\s*"resolveuid/(?P([^/"#? ]*))
+ | width%s
+ | alt%s
+ | height%s
+ | .
+ )*\>
+ )''' % (ATTR_CLASS, ATTR_WIDTH, ATTR_ALT, ATTR_HEIGHT), re.VERBOSE | re.IGNORECASE | re.DOTALL)
+SRC_TAIL = re.compile(r'/([^" \/>]+)')
+
+CLASS_PATTERN = re.compile('\s*class\s*=\s*("[^"]*captioned[^"]*"|[^" \/>]+)')
+ALT_PATTERN = re.compile('\\balt\s*=\s*("[^"]*"|[^" \/>]+)')
+END_TAG_PATTERN = re.compile('(]*?)( */?>)')
+IMAGE_TEMPLATE = '''\
+
' % (url, d['originalalt'], target.height, target.width )
+
+
+ if subtarget:
+ d['isfullsize'] = subtarget.width == target.width and subtarget.height == target.height
+ d['width'] = subtarget.width
+
+ if atag: # Must preserve original link, don't overwrite with a link to the image
+ d['isfullsize'] = True
+ d['tag'] = "%s%s" % (atag, d['tag'])
+
+ return template(**d)
+ return match.group(0) # No change
+
+ if isinstance(data, unicode):
+ data = data.decode('utf8')
+ html = IMAGE_PATTERN.sub(replaceImage, data)
+
+ # Replace urls that use UIDs with human friendly urls.
+ def replaceUids(match):
+ tag = match.group('tag')
+ uid = match.group('uid')
+ target = self.resolveuid(context, rc, uid)
+ if target:
+ try:
+ url = target.getRemoteUrl()
+ except AttributeError:
+ url = target.absolute_url_path()
+ return tag + url
+ return match.group(0)
+
+ html = UID_PATTERN.sub(replaceUids, html)
+ if isinstance(html, unicode):
+ html = html.encode('utf8') # Indexing requires a string result.
+ idata.setData(html)
+ return idata
+
+ # No context to use for replacements, so don't bother trying.
+ idata.setData(data)
+ return idata
+
+def register():
+ return HTMLToCaptioned()
+
+def initialize():
+ engine = getToolByName(portal, 'portal_transforms')
+ engine.registerTransform(register())
+
+ATTR_HREF = ATTR_VALUE % 'href'
+LINK_PATTERN = re.compile(
+ r'(?P\<(?:img\s[^>]*src|a\s[^>]*href)\s*=\s*(?:"?))(?P(?<=")[^"]*|[^ \/>]*)',
+ re.IGNORECASE)
+FRAGMENT_TYPE = 'CompositePack Fragments'
+NAVIGATION_PAGE = 'Navigation Page'
+
+SUMMARY_PATTERN = re.compile(r'(\]*>.*?)|(\]*\>)', re.IGNORECASE|re.DOTALL)
+
+class Migration:
+ FIELDS = ('portal_type', 'typename', 'fieldname',
+ 'fieldlabel', 'position', 'action', 'commit_changes',
+ 'image_tails', 'paths', 'pathuids', 'uids', 'found',
+ 'batch_size',
+ )
+
+ def __init__(self, tool):
+ self.tool = tool
+ self.url_tool = getToolByName(tool, 'portal_url')
+ self.portal = self.url_tool.getPortalObject()
+ self.portal_base = self.url_tool.getPortalPath()
+ self.portal_base_url = self.portal.absolute_url()
+ self.prefix_length = len(self.portal_base)+1
+ self.uid_catalog = getToolByName(tool, 'uid_catalog')
+ self.reference_tool = getToolByName(tool, 'reference_catalog')
+ self.portal_catalog = getToolByName(tool, 'portal_catalog')
+ self._continue = True
+ self._firstoutput = False
+ self.commit_changes = False
+ self._objects = []
+ self.image_tails = []
+
+ def initImageSizes(self):
+ self.image_tails = self.tool._getImageSizes()
+
+ def initFromRequest(self):
+ self.initImageSizes()
+ self.uids = None
+ self.found = 0
+ request = self.tool.REQUEST
+ rfg = request.form.get
+ fields = [f for f in rfg('fields',()) if f.get('selected',0)]
+ if fields:
+ f = fields[0]
+ self.portal_type = f.portal_type
+ self.typename = f.type.decode('utf-8')
+ self.fieldname = f.name.decode('utf-8')
+ self.fieldlabel = f.label.decode('utf-8')
+ else:
+ self.portal_type = rfg('portal_type', None)
+ self.fieldname = None
+ self.fieldlabel = None
+ self.typename = None
+
+ self.position = 0
+ self.action = rfg('button', None)
+ self.commit_changes = rfg('commit', False)
+ self.batch_size = 10
+ if self.commit_changes:
+ self.uids = rfg('uids', [])
+
+ pathuids = rfg('folderpaths', [])
+ self.paths = self.tool.convertUidsToPaths(pathuids)
+ self.pathuids = pathuids
+
+ def initCommit(self):
+ """Reset counters for a commit pass"""
+ self.restoreState()
+ request = self.tool.REQUEST
+ rfg = request.form.get
+ self.commit_changes = True
+ self._firstoutput = True
+ self.found = 0
+ self.position = 0
+ self.batch_size = 5
+ self.uids = rfg('uids')
+
+ def saveState(self):
+ SESSION = self.tool.REQUEST.SESSION
+ SESSION['kupu_migrator'] = dict([(f, getattr(self, f, None)) for f in self.FIELDS])
+
+ def restoreState(self):
+ SESSION = self.tool.REQUEST.SESSION
+ state = SESSION['kupu_migrator']
+ for f in self.FIELDS:
+ setattr(self, f, state[f])
+
+# def clearState(self):
+# return
+# SESSION = self.tool.REQUEST.SESSION
+# if SESSION.has_key('kupu_migrator'):
+# del SESSION['kupu_migrator']
+
+ def status(self):
+ s = [ '%s=%s' % (f,getattr(self, f, 'unset')) for f in
+ self.FIELDS ]
+ return '\n'.join(s)
+
+ def mkQuery(self):
+ query = {}
+ if self.portal_type:
+ query['portal_type'] = sanitize_portal_type(self.portal_type)
+ if self.paths:
+ query['path'] = self.paths
+ query['Language'] = 'all'
+ return query
+
+ def getInfo(self, saveState=True):
+ info = {}
+ if self._continue:
+ info['nexturi'] = self.tool.absolute_url_path()+'/kupu_migration.xml?button=continue'
+ if self.commit_changes and self._objects and self.position < getattr(self, '_total', -1):
+ info['delay'] = 5 # Avoid killing everyone else with conflict errors.
+ else:
+ info['nexturi'] = None
+
+ info['firstoutput'] = self._firstoutput
+
+ if hasattr(self, '_total'):
+ info['total'] = self._total
+ info['position'] = self.position
+ if self._total==0:
+ info['percent'] = '100%'
+ else:
+ info['percent'] = '%d%%' % ((100.*self.position)/self._total)
+
+ info['objects'] = self._objects
+ info['action'] = action = self.action
+ info['action_check'] = action=='check'
+ info['action_touid'] = action=='touid'
+ info['action_topath'] = action=='topath'
+ info['typename'] = self.typename
+ info['fieldlabel'] = self.fieldlabel
+ info['checkboxes'] = action != 'check' and not self.commit_changes
+ info['commit_changes'] = self.commit_changes
+ info['dryrun'] = not (self.action == 'check' or self.commit_changes)
+ info['found'] = self.found
+
+ if saveState:
+ self.saveState()
+ return info
+
+ def docontinue(self):
+ """Scan selected documents looking for convertible links"""
+ uids = self.uids
+ if uids is None:
+ self.uids = uids = []
+ brains = self.portal_catalog.searchResults(self.mkQuery())
+ for b in brains:
+ uid = self.UIDfromBrain(b)
+ if uid:
+ uids.append(uid)
+ self._firstoutput = True
+ self._continue = True
+ return True
+
+ pos = self.position
+ self._total = total = len(uids)
+
+ uids = uids[pos:pos+self.batch_size]
+ self.position = pos + len(uids)
+ if not uids:
+ self._continue = False
+ return False # Done
+
+ self._objects = res = []
+ for uid in uids:
+ obj = self.reference_tool.lookupObject(uid)
+ if self.portal_type==FRAGMENT_TYPE and obj.portal_type!=FRAGMENT_TYPE:
+ try:
+ fldr = obj.cp_container.titles
+ except:
+ continue
+ else:
+ for o in fldr.objectValues([FRAGMENT_TYPE]):
+ objinfo = self.object_check(o)
+ if objinfo:
+ res.append(objinfo)
+ else:
+ objinfo = self.object_check(obj)
+ if objinfo:
+ res.append(objinfo)
+
+ self._continue = True
+ return True
+
+ def brain_check(self, brain):
+ object = brain.getObject()
+ return self.object_check(object)
+
+ def link_summary(self, data, start, link):
+ """Summary information for a link"""
+ m = SUMMARY_PATTERN.match(data, start)
+ if m:
+ text = m.group(0)
+ else:
+ text = data[start:start+200]
+ bits = text.split(link, 1)
+ if len(bits)==1:
+ bits.append('')
+ return bits
+
+ def object_check(self, object):
+ """Check the relative links within this object."""
+ def checklink(match):
+ matched = match.group(0)
+ newlink = link = decodeEntities(match.group('href'))
+ classification, uid, relpath, tail = self.classifyLink(link, base)
+
+ if self.action=='check':
+ if classification=='bad':
+ abslink = urljoin(base, link)
+ before, after = self.link_summary(data, match.start(), link)
+ summary = {'text':link, 'url':abslink,
+ 'before': before,
+ 'after': after, }
+ info.append(summary)
+ elif self.action=='touid':
+ if classification=='internal':
+ if uid and uid==objuid:
+ newlink = tail
+ elif uid:
+ newlink = 'resolveuid/%s%s' % (uid, tail)
+ else:
+ newlink = relpath+tail
+
+ elif self.action=='topath':
+ if classification=='internal':
+ newlink = relpath+tail
+
+ if newlink != link:
+ prefix = match.group('prefix')
+ newlink = html_quote(newlink).encode('ascii', 'xmlcharrefreplace')
+ changes.append((match.start()+len(prefix), match.end(), newlink))
+ return prefix + newlink
+ return matched
+
+ info = []
+ changes = []
+ try:
+ objuid = aq_base(object).UID
+ except:
+ return None # only archetypes objects
+
+ baseobj = object
+ if object.portal_type==FRAGMENT_TYPE:
+ baseobj = object.aq_parent.aq_parent.aq_parent
+ base = baseobj.absolute_url()
+ if getattr(baseobj.aq_explicit, 'isPrincipiaFolderish', 0):
+ base += '/'
+
+ field = object.getField(self.fieldname)
+ if field is None:
+ return None
+
+ content_type = field.getContentType(object)
+ if content_type != 'text/html':
+ # Don't attempt to modify non-html
+ return None
+
+ data = field.getEditAccessor(object)().decode('utf8')
+ __traceback_info__ = (object, data)
+ newdata = LINK_PATTERN.sub(checklink, data)
+ if data != newdata and self.commit_changes:
+ mutator = field.getMutator(object)
+ if mutator:
+ mutator(newdata.encode('utf8'), mimetype='text/html')
+ object.reindexObject() # Need to flag update
+
+ if info or changes:
+ self.found += 1
+ title = object.Title()
+ if not title:
+ title = object.getId()
+ if not title:
+ title = '
-
+
- + %(tag)s + +
- + %(caption)s + +