--- loncom/html/adm/help/tex/Domain_Configuration_Request_Courses.tex 2011/03/15 20:41:39 1.2
+++ loncom/html/adm/help/tex/Domain_Configuration_Request_Courses.tex 2014/06/26 15:07:10 1.9
@@ -1,20 +1,30 @@
\label{Domain_Configuration_Request_Courses}
-A domain configuration can be used to determine which users in the domain may request creation of: (a) official courses, (b) unofficial courses, or (c) communities, within the domain.
+A domain configuration can be used to determine which users in the domain may request creation of: (a) official courses, (b) unofficial courses, (c) communities, or (d) textbook courses within the domain.
The default is for no course or community requests by any domain users.
-Communities are similar to courses except the Coordinator may only browse areas of the shared LON-CAPA repository for which he/she has an author or co-author role.
+Communities are similar to courses except the Coordinator may only browse areas of the shared LON-CAPA repository for which he/she has an author or co-author role. Textbook courses use a simplified (1 page) request form, in
+which the options include cloning of available pre-fabricated textbook courses or template courses, for which
+the requester has cloning rights.
-Course/Community requests may be set to be processed automatically, queued for approval by a Domain Coordinator, or (for official courses) validated against institutional instructor of record data.
+Course/Community requests may be set to be processed automatically, queued for approval by a Domain Coordinator, or (for official courses, for example) validated against institutional instructor of record data. The ``With validation'' option is only displayed if the crsreq\_checks() subroutine in localenroll.pm has been customized to indicate that a particular course type can be validated if the owner belongs to a specific institutional group (e.g., Faculty).
+
+The crsreq\_checks() routine is closely tied to validate\_crsreq(). ``With validation'' should not be a possible choice in the domain configuration menu for a particular course type and institutional affiliation, unless corresponding validation code has been implemented in validate\_crsreq().
LON-CAPA can be configured to send messages to Domain Coordinators to notify them when a course has been requested and queued pending approval. Recipients of such messages are selected from users with an active Domain Coordinator role for the domain. These same users will also receive messages when a course request has been approved by a Domain Coordinator.
-LON-CAPA messages are sent to course requestors when a queued course is approved, or and official course which had been queued pending validation of instructor status, is created when validation occurs.
+LON-CAPA messages are sent to course requestors when a queued course is approved, or an official course which had been queued pending validation of instructor status, is created when validation occurs.
The course request settings for each course type may be different for the various affiliations defined for the institution (e.g., Faculty, Staff etc.). In addition, settings may be defined for users with ``advanced'' roles in LON-CAPA (i.e., users with author, co-author, coordinator, instructor or administrator roles) which will override the course request settings based on affiliation.
The ``default'' settings which apply to a particular user based on domain configuration, may be overridden for that specific user, by a Domain Coordinator in the user's domain. The ``Add/Modify a User'' page for a user includes a section where custom settings can be selected for requests for creation of Courses/Communities in the domain.
-Lastly, an individual user may still be able to request courses or communitis, even if settings preclude that in the user's home domain. Domain Coordinators displaying the ``Add/Modify a User'' page for an existing user from a different domain will see a section where custom settings can be selected to allow requests for creation of Courses/Communities in the domain for which Domain Coordination is being carried out.
+An individual user may still be able to request courses or communities, even if settings preclude that in the user's home domain. Domain Coordinators displaying the ``Add/Modify a User'' page for an existing user from a different domain will see a section where custom settings can be selected to allow requests for creation of Courses/Communities in the domain for which Domain Coordination is being carried out.
+
+Details of pre-fabricated courses: "textbooks" and "templates" for cloning when creating a new "textbook" course can be uploaded (subject, title, image, author, publisher, and LON-CAPA course domain/ID).
+
+Validation of unofficial and textbook courses, and communities can be via a validating server/script
+Form fields to send to the validator can be specified by customizing the \&crsreq\_updates() subroutine in
+localenroll.pm.