--- loncom/html/adm/help/tex/Domain_Configuration_LangTZAuth.tex 2008/07/23 02:41:55 1.1
+++ loncom/html/adm/help/tex/Domain_Configuration_LangTZAuth.tex 2014/06/26 15:07:10 1.9
@@ -1,36 +1,54 @@
\label{Domain_Configuration_LangTZAuth}
-The login page can be customized for your domain, by:
+Prior to LON-CAPA 2.7, default language and authentication type/argument
+were defined in the domain's entry in the domain.tab file. Those settings
+will continue to be used by servers in your domain until you have
+displayed and saved the Default authentication/language/timezone data
+table. Once that has been done, whenever values need to be determined
+for these settings in the domain they will be retrieved from the configuration.db
+file on the primary library server in your domain, which is where
+information saved from the {}``Domain Configuration'' data tables
+is stored. Any information in the domain.tab file will no longer be
+consulted, except by servers running pre-2.7 versions of LON-CAPA.
+
+Default domain configurations can be assigned for:
\begin{itemize}
-\item uploading custom image files,
-\item changing colors of text, links or backgrounds
-\item enabling/disabling display of sepcific links
+\item default language used by users in your domain, unless overridden by
+a user preference
+\item default authentication type for new users in the domain. You will
+need to set the default authentication if you intend to allow a user
+to create a LON-CAPA account if the user successfully authenticated
+via a central service at your institution (e.g., Kerberos), but is
+without a LON-CAPA account. The default authentication is also the
+default offered when Course Coordinators or Authors create new accounts,
+assuming user creation is permitted in these contexts.
+\item default timezone - this will be the timezone used when showing any
+times in your domain, unless overridden at a course level, by a course-wide
+timezone. The timezones available are mostly in the form Continent/City,
+although for the USA there are some in the form America/State/City
+as well as EST5EDT, CST6CDT, MST7MDT, PST8PDT and HST (for Eastern,
+Central, Mountain, Pacific and Hawaii Timezones, which adjust for
+daylight savings as appropriate). If no default timezone is set times
+will be displayed according to the timezone of the server hosting
+the user's LON-CAPA session.
+\item portal/default URL - starting with LON-CAPA 2.10, a default URL can
+be specified. This URL will be included in e-mail sent to confirm self-enrollment etc.
+and might be for a load-balancer LON-CAPA server, or in the case of a multi-domain server,
+for a specific alias used for the domain.
\end{itemize}
-Logos displayed in the login page configuration table are scaled down
-from the full size used in the login-page itself.
-
+Domain configurations can also be set for institutional user types via the same screen.
-\hfill{}
-
-\noindent The following elements are configurable:
+Prior to LON-CAPA 2.11, institutional user types were defined in the \&inst\_usertypes
+subroutine in localenroll.pm, which would be customized for consistency with types
+defined in institutional data feeds. Setting of user types via the Domain Configuration
+web GUI supersedes use of localenroll::inst\_usertypes(). Items that can be set are:
\begin{itemize}
-\item Header image at the top of the page
-\item Main Logo centred in the upper part of the main panel
-\item Domain logo in the lower left corner of the main panel
-\item Header above the login panel - can also be set to use text (\char`\"{}Log
-in\char`\"{}) instead of an image.
-\item Backgrond colors for the page itself, the main panel, and the left
-(side) panel.
-\item Text color used for text on the page
-\item Enable/disable display of three links:
-
-\begin{itemize}
-\item Course Catalog, for a catalog of courses;
-\item Admin E-mail, for the e-mail address of the administrator;
-\item New User, for users to create their own accounts.
-\end{itemize}
-\item Default colors for links in the page, depending on status: either
-active, visited or default (if neither apply).
+\item Internal ID (e.g., faculty)
+\item Name Displayed (e.g., Faculty/Academic Staff)
+\item Order (Listing order, 1 through N, when the type is to be selected from a list).
+\item Whether status type can also be assigned to a non-institutional user with an e-mail
+ address as username
\end{itemize}
+