Middlebury

Difference between revisions of "CourseHub Administration"

 
Line 3: Line 3:
  
 
# Changes are made in Banner to add the data over several weeks/months
 
# Changes are made in Banner to add the data over several weeks/months
# Someone (usually in Academic Affairs/Registrar's office, Janis A. or Renee B.) goes into the [http://catalog.middlebury.edu/admin/terms Searchable Catalog Admin] screen and flag the term as "enabled": [[File:SearchableCatalogAdmin.png]]
+
# Someone (usually in Academic Affairs/Registrar's office, Janis A. or Renee B.) goes into the [http://catalog.middlebury.edu/admin/terms Searchable Catalog Admin] screen and flag the term as "enabled": [[File:SearchableCatalogAdmin.png|600px]]
 
# At 2am, the next Searchable Catalog sync with Banner will pick up the new term and make it available via the [http://catalog.middlebury.edu/offerings/search/catalog/catalog%2FMCUG/ catalog search UI] as well as to the Course Hub's back-end for importing. If the term (or a particular course for that matter) isn't available in the [http://catalog.middlebury.edu/offerings/search/catalog/catalog%2FMCUG/ catalog search UI], it won't be available to the Hub, since the hub just gets an [http://catalog.middlebury.edu/offerings/searchxml/catalog/catalog%2FMCUG?term=term%2F201410&department=&keywords=&time_start=0&time_end=86400&type%5B%5D=genera%3Aoffering%2FLCT&type%5B%5D=genera%3Aoffering%2FSEM&search=Search XML version] of the [http://catalog.middlebury.edu/offerings/search/catalog/catalog%2FMCUG?term=term%2F201410&department=&keywords=&time_start=0&time_end=86400&type%5B%5D=genera%3Aoffering%2FLCT&type%5B%5D=genera%3Aoffering%2FSEM&search=Search catalog search]. "Fun" tip: change "/offerings/search/" to "/offerings/searchxml/" in any search result to get an XML version.
 
# At 2am, the next Searchable Catalog sync with Banner will pick up the new term and make it available via the [http://catalog.middlebury.edu/offerings/search/catalog/catalog%2FMCUG/ catalog search UI] as well as to the Course Hub's back-end for importing. If the term (or a particular course for that matter) isn't available in the [http://catalog.middlebury.edu/offerings/search/catalog/catalog%2FMCUG/ catalog search UI], it won't be available to the Hub, since the hub just gets an [http://catalog.middlebury.edu/offerings/searchxml/catalog/catalog%2FMCUG?term=term%2F201410&department=&keywords=&time_start=0&time_end=86400&type%5B%5D=genera%3Aoffering%2FLCT&type%5B%5D=genera%3Aoffering%2FSEM&search=Search XML version] of the [http://catalog.middlebury.edu/offerings/search/catalog/catalog%2FMCUG?term=term%2F201410&department=&keywords=&time_start=0&time_end=86400&type%5B%5D=genera%3Aoffering%2FLCT&type%5B%5D=genera%3Aoffering%2FSEM&search=Search catalog search]. "Fun" tip: change "/offerings/search/" to "/offerings/searchxml/" in any search result to get an XML version.
 
# Course groups get added the the Active Directory (AD) by someone in CSNS (Mark P.). The Course groups are structured as follows:
 
# Course groups get added the the Active Directory (AD) by someone in CSNS (Mark P.). The Course groups are structured as follows:
Line 13: Line 13:
 
## Create the container page for the term called "winter" with title "Winter 2014" under /hub/MCUG/2013-2014/ or whatever page is appropriate for the upcoming term.
 
## Create the container page for the term called "winter" with title "Winter 2014" under /hub/MCUG/2013-2014/ or whatever page is appropriate for the upcoming term.
 
## On that page, add a "Subpage List" node titled "Browse Course Sites in Winter 2014".
 
## On that page, add a "Subpage List" node titled "Browse Course Sites in Winter 2014".
## Go to [http://courses.middlebury.edu/admin/course_hub/builder/terms/add Admin --> Course Hub --> Site Building] and add a new term definition: <br/> [[File:HubNewTerm.png]] <br/>That has the path of the new page as it's Import Path.
+
## Go to [http://courses.middlebury.edu/admin/course_hub/builder/terms/add Admin --> Course Hub --> Site Building] and add a new term definition: <br/> [[File:HubNewTerm.png|600px]] <br/>That has the path of the new page as it's Import Path.
## [http://courses.middlebury.edu/admin/course_hub/builder/terms List the terms] and click the test link to test the configuration: <br/>[[File:HubTestTerm.png]] <br/> It's ok to see a few errors of a small percentage of course groups missing, but generally the tests should look pass.
+
## [http://courses.middlebury.edu/admin/course_hub/builder/terms List the terms] and click the test link to test the configuration: <br/>[[File:HubTestTerm.png|600px]] <br/> It's ok to see a few errors of a small percentage of course groups missing, but generally the tests should look pass.
 
# Go to the [http://courses.middlebury.edu/admin/course_hub/builder/terms term-list] and click the "Build" link to populate the course sites. Note that this is a non-destructive operation and can be done multiple times throughout the lead-up-to or during the term without harming existing content.
 
# Go to the [http://courses.middlebury.edu/admin/course_hub/builder/terms term-list] and click the "Build" link to populate the course sites. Note that this is a non-destructive operation and can be done multiple times throughout the lead-up-to or during the term without harming existing content.
  

Latest revision as of 10:57, 31 October 2013

Setting up the Course Hub for a new Term

Here are the processes that go into setting up the Course Hub for a new term:

  1. Changes are made in Banner to add the data over several weeks/months
  2. Someone (usually in Academic Affairs/Registrar's office, Janis A. or Renee B.) goes into the Searchable Catalog Admin screen and flag the term as "enabled": SearchableCatalogAdmin.png
  3. At 2am, the next Searchable Catalog sync with Banner will pick up the new term and make it available via the catalog search UI as well as to the Course Hub's back-end for importing. If the term (or a particular course for that matter) isn't available in the catalog search UI, it won't be available to the Hub, since the hub just gets an XML version of the catalog search. "Fun" tip: change "/offerings/search/" to "/offerings/searchxml/" in any search result to get an XML version.
  4. Course groups get added the the Active Directory (AD) by someone in CSNS (Mark P.). The Course groups are structured as follows:
    • subj0101a-f12 -- which is a parent for the following three groups, needed for building the course's Hub site
    • subj0101a-f12-instructors -- needs to be populated for building the course's Hub site
    • subj0101a-f12-students
    • subj0101a-f12-audits
  5. At some point Adam adds the new term information and container page to the Course Hub. You are welcome to do this if you'd like, or I can handle it. The process is as follows:
    1. Create the container page for the term called "winter" with title "Winter 2014" under /hub/MCUG/2013-2014/ or whatever page is appropriate for the upcoming term.
    2. On that page, add a "Subpage List" node titled "Browse Course Sites in Winter 2014".
    3. Go to Admin --> Course Hub --> Site Building and add a new term definition:
      HubNewTerm.png
      That has the path of the new page as it's Import Path.
    4. List the terms and click the test link to test the configuration:
      HubTestTerm.png
      It's ok to see a few errors of a small percentage of course groups missing, but generally the tests should look pass.
  6. Go to the term-list and click the "Build" link to populate the course sites. Note that this is a non-destructive operation and can be done multiple times throughout the lead-up-to or during the term without harming existing content.

Term Setup Notes

  • The instructor-group for a course must exist and have at least one member when the course site is built for permissions to be set correctly. If the instructor-group is added and populated in the AD later, then rebuilding the course sites for the term will fix the permissions.

Creating a new CourseHub Installation

  1. Create a new database, sites/xxx/ directory, and sites/xxx/settings.php
  2. Run the Drupal installer
  3. Log in as the admin, go to /admin/build/modules, enable the following modules:
    • Features
    • CAS Midd
    • Masquerade
  4. Go to /admin/build/features and enable the Course Hub feature.
  5. Go to /admin/build/themes and enable the Course Hub, Course Hub Dashboard, and Course Hub Site themes. Make the Course Hub theme the default.
  6. Set the Admin theme to Garland.
  7. On the front page, change the theme to the Course Hub theme and make it allowed for all children.
  8. Go to /admin/build/block and add the following blocks to each region of the themes:
    • Course Hub theme:
      • Left Sidebar:
        • Course Hub Dashboard Link
        • Course Hub Nav Spacer
        • New Sub-section
        • Feedback Link
        • Midd CAS Login
        • Masquerade (only visible to people with the 'masquerade' role)
        • Statistics (only visible to people with the 'view statistics' role)
      • Content Top:
        • Recycle Buttons
      • Task Bar:
        • Midd CAS Login w/ name
    • Course Hub Dashboard theme:
      • Left Sidebar:
        • Course Hub Dashboard Link
        • Course Hub Dashboard Semester Nav
        • Course Hub Nav Spacer
        • New Sub-section
        • Feedback Link
        • Midd CAS Login
        • Masquerade (only visible to people with the 'masquerade' role)
        • Statistics (only visible to people with the 'view statistics' role)
      • Task Bar:
        • Midd CAS Login w/ name
    • Course Hub Site theme:
      • Left Sidebar:
        • Course Hub Dashboard Link
        • Course Hub Dashboard Semester Nav
        • Course Hub Nav Spacer
        • Course Hub Menu
        • Feedback Link
        • Midd CAS Login
        • Masquerade (only visible to people with the 'masquerade' role)
        • Statistics (only visible to people with the 'view statistics' role)
      • Right Sidebar
        • New Sub-section
        • Resource Link Sidebar
        • Roster Link
      • Content Top:
        • Recycle Buttons
        • Resource Controls
        • Syllabus Controls
        • Updates Heading
      • Task Bar:
        • Midd CAS Login w/ name
  9. Go to /admin/settings/site-information and set the Default front page to mm/7.
  10. Rename the Home page Course Hub
  11. Add a subpage to at /about called Using the Course Hub. Create a page node with info about the Course Hub, also add this node to the root page so that it will be visible to anonymous users hitting the front page.
  12. Add a subpage to hold all course sites at /hub called Browse all Course Sites
  13. Configure the CAS-MM Sync module and run a user sync to import users and groups.
  14. Add groups to the masqueraders role and the view statistics role.
Powered by MediaWiki