--- loncom/html/adm/help/tex/Course_Prefs_ExternalTools.tex 2025/06/16 23:16:59 1.1.2.2
+++ loncom/html/adm/help/tex/Course_Prefs_ExternalTools.tex 2025/06/16 17:01:11 1.2
@@ -2,7 +2,7 @@
The domain coordinator for your domain can choose to enable definition and configuration of External Tools by course type, or for specific course(s). If tool definition is available in your course you will be able to use: Settings $>$ Course Settings $>$ Display (``External Tools'' checked) to create new External Tool definitions for use in your course, or to modify existing ones.
-Note: External Tools may also have been defined at a domain level for use in your course. If the tool you want to use is already available then you do not need to define your own, but can simply click``Upload'' in the function categories listed at the right side of the Course Editor, below the editor tabs, and then click ``External Tool''. From there you'll choose `` Defined in domain'' and select the tool to add. If the tool you want to use is not available at a domain level, then after you have defined the tool (see below) clicking the ``Defined in course'' option will allow you to add an instance of that tool to the folder currently being edited. Tools added to the ``Supplemental content'' area will not store grades passed back from the Provider. If you wish to use that functionality you should add a tool instance to a folder or sub-folder in the ``Main Content'' area, and check ``Yes'' for Gradable.
+Note: External Tools may also have been defined at a domain level for use in your course. If the tool you want to use is already available then you do not need to define your own, but can simply click ``External'' in the function categories listed at the right side of the Course Editor, below the editor tabs, and then click ``External Tool''. From there you'll choose `` Defined in domain'' and select the tool to add. If the tool you want to use is not available at a domain level, then after you have defined the tool (see below) clicking the ``Defined in course'' option will allow you to add an instance of that tool to the folder currently being edited. Tools added to the ``Supplemental content'' area will not store grades passed back from the Provider. If you wish to use that functionality you should add a tool instance to a folder or sub-folder in the ``Main Content'' area, and check ``Yes'' for Gradable.
By defining an External Tool in a course you enable use of LON-CAPA as an LTI Consumer (where LTI = Learning Tool Interoperability). Under the LTI protocol, the user's identity, as well as the course context, can be sent to the external tool (the Provider), which will trust the identity and role information provided by LON-CAPA (the Consumer). Integrity of data in the payload sent by LON-CAPA to the user's web browser, which the browser then submits to the Provider, is assured by including a signature in the payload which the Provider must verify on receipt. The external tool will assign appropriate privileges to the user within the tool, based on the user's role.
@@ -10,7 +10,7 @@ The shared key and secret used to sign t
When you use Settings $>$ Course Settings $>$ Display (``External Tools'' checked) a table will be displayed listing all currently available External Tools (i.e., LTI Providers) defined in the course, as well as an ``Add'' checkbox (for the last row in the table), used to add a new External Tool.
-Internally in LON-CAPA each external tool you configure for your course receives a unique numerical ID (starting at 1), which remains unchanged, regardless of any future changes made to the configuration for that particular tool. A drop-down list in the left column of the External Tools table can be used to change the order in which available tools are listed in both the configuration table, and also in the dropdown list in the ``External Tool'' item in the Course Editor (``Upload'' tab), when one or more tools are available.
+Internally in LON-CAPA each external tool you configure for your course receives a unique numerical ID (starting at 1), which remains unchanged, regardless of any future changes made to the configuration for that particular tool. A drop-down list in the left column of the External Tools table can be used to change the order in which available tools are listed in both the configuration table, and also in the dropdown list in the ``External Tool'' item in the Course Editor (``External tab''), when one or more tools are available.
Settings available in each External Tool definition are:
@@ -26,7 +26,7 @@ Each External Tool can be configured to
\item{\textbf{Optional settings}}
-There are seven optional settings, for which you can set default values, which optionally you may allow to be overridden for each tool instance: Display target (iFrame, Tab, or Window), Width and Height (if target is Window), default link text and explanation (unless target is iFrame), destination URL (if different from Provider URL), and return LON-CAPA URL.
+There are seven optional settings, for which you can set default values, which optionally you may allow to be overridden for each tool instance: Display target (iFrame, Tab, or Window), Width and Height (if target is Window), default link text explanation (unless target is iFrame), destination URL (if different from Provider URL), and return LON-CAPA URL.
Optionally, you can also:
\begin{itemize}