Annotation of loncom/html/adm/help/tex/Domain_Configuration_Login_Page.tex, revision 1.6
1.1 raeburn 1: \label{Domain_Configuration_Login_Page}
1.4 raeburn 2: If your domain has more than one server you have the option to configure whether
1.6 ! raeburn 3: any of the servers will redirect to another server whenever the log-in page is requested. This can be useful if you maintain a portal or "Load Balancer" server which
1.4 raeburn 4: forms your institution's gateway to LON-CAPA. You can specify the path to which
5: the user should be redirected, and also whether log-in page requests from specific
6: IP addresses should be exempt from the redirection. The exemption is useful
7: if you run a monitoring script which tests log-in, course display, and logout periodically for each of your LON-CAPA servers.
8:
9: If your domain only has one LON-CAPA server, or you have multiple servers and will
10: display their log-in pages, their appearance can be customized as follows:
1.1 raeburn 11:
12: \begin{itemize}
1.2 raeburn 13: \item uploading custom image files
1.1 raeburn 14: \item changing colors of text, links or backgrounds
1.2 raeburn 15: \item enabling/disabling display of specific links
1.1 raeburn 16: \end{itemize}
17: Logos displayed in the login page configuration table are scaled down
18: from the full size used in the login-page itself.
19:
20:
21:
22: \hfill{}
23:
24: \noindent The following elements are configurable:
25:
26: \begin{itemize}
27: \item Header image at the top of the page
1.2 raeburn 28: \item Main Logo centered in the upper part of the main panel
1.1 raeburn 29: \item Domain logo in the lower left corner of the main panel
30: \item Header above the login panel - can also be set to use text (\char`\"{}Log
31: in\char`\"{}) instead of an image.
1.2 raeburn 32: \item Background colors for the page itself, the main panel, and the left
1.1 raeburn 33: (side) panel.
34: \item Text color used for text on the page
1.5 raeburn 35: \item Text colors used for active, visited and unvisited links
1.1 raeburn 36: \item Enable/disable display of three links:
37:
38: \begin{itemize}
1.3 bisitz 39: \item Course/Community Catalog, for a catalog of courses and communities
1.2 raeburn 40: \item Admin E-mail, for the e-mail address of the administrator
1.5 raeburn 41: \item Contact Helpdesk, to display a web form used to submit a help request
1.2 raeburn 42: \item New User, for users to create their own accounts
1.1 raeburn 43: \end{itemize}
44: \item Default colors for links in the page, depending on status: either
45: active, visited or default (if neither apply).
46: \end{itemize}
1.5 raeburn 47:
48: \hfill{}
49:
50: A ``Log-in Help'' link will be displayed immediately above any of the three optional links:
51: Catalog, Contact Helpdesk and New User. Configuration options determine to which
52: file(s) the ``Log-in Help'' points. The default file can be replaced with a custom HTML file
53: containing information pertinent to your institution. In addition, versions of the custom
54: file, translated into the twelve languages supported by LON-CAPA can be uploaded, and the
55: link will automatically point to the appropriate (localized) file, depending on the viewer's
56: language preference (as reported by the client web browser).
57:
58: \hfill{}
59:
60: Where the ``Contact Helpdesk'' web form is in use it can be configured to include a CAPTCHA
61: mechanism to discourage robotic form completion. There are two types of CAPTCHA to choose
62: from -- the ``original'' CAPTCHA which uses a self-contained perl module included with the
1.6 ! raeburn 63: LONCAPA prerequisites, or ReCAPTCHA, which uses an external web service --
1.5 raeburn 64: https://google.com/recaptcha -- and requires you to create an account and generate public
65: and private keys which will be entered in the domain configuration form. If you have more
66: than one server in your domain, you should request ``global'' keys, as the same keys will be
67: used by the Contact Helpdesk ReCAPTCHA on all servers in your domain.
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>