--- 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} +