Merge branch 'feature/moodle' into feature/test-fixes-december-23

Web/Controls/Help/GettingStarted/Integration/Moodle/GettingStartedMoodle.ascx

@@ -53,6 +53,7 @@
             <%--<div class="notehelp">
             <p>To learn more about how the ONLYOFFICE connector for Moodle works, please visit our <a href="https://api.onlyoffice.com/editors/moodle" target="_blank"><b>API documentation</b></a>.</p>
             </div>--%>
+            <p>You can also install the Moodle AssignSubmission ONLYOFFICE Integration plugin. This plugin is an extension of the main Moodle plugin and allows users to add a custom submission of the "ONLYOFFICE document" type in the .pdf format.</p>
 
             <div class="gs_content gs_submenu" id="MainFeatures_block">
             <h3>Main features</h3>
@@ -72,31 +73,26 @@
             <p> </p>
             <ul>
                 <li>For viewing and editing: DOCX, XLSX, PPTX, DOCXF</li>
-                <li>For viewing only: PDF, TXT, CSV</li>
-                <li>For filling forms: OFORM</li>
+                <li>For viewing only: TXT, CSV</li>
+                <li>For filling forms: PDF</li>
                 <li>For converting to Office Open XML formats: ODT, ODS, ODP, DOC, XLS, PPT, PPS, EPUB, RTF, HTML, HTM</li>
             </ul>
     </div>
 
    <div class="gs_content gs_submenu" id="Whatsnew_block">
-       <h3>What's new in versions 2.2.0 and 3.0.0</h3>
+       <h3>What's new in version 4.4.0</h3>
        <p>Added</p>
        <ul>
-           <li>add protect option for editor</li>
-           <li>add ability to open editor in fullscreen mode</li>
-           <li>add mentions in comments in editor</li>
-           <li>"save as" in editor</li>
-           <li>add ability to create activity with empty file</li>
-           <li>add favicon on editor page</li>
-           <li>editor interface customization</li>
-           <li>de, es, fr, it, ja, ru, zh_cn translations</li>
-           <li>add support for ONLYOFFICE forms</li>
+           <li>desktop mode</li>
+           <li>disable plugins setting</li>
+           <li>macro launch setting</li>
+           <li>dsi-LK, ar-SA and sr-Latn-RS empty file template</li>
+           <li>service for checking editor versions</li>
        </ul>
        <p>Changed</p>
        <ul>
-           <li>set editor interface language</li>
-           <li>fixes building backup and restore</li>
-           <li>redesign to Moodle 4</li>
+           <li>fixed saveas dialog</li>
+           <li>support moodle v4.3</li>
        </ul>
        <%--<h3>What's new in version 2.1.0</h3>
        <p>Added</p>
@@ -119,15 +115,15 @@
             <h3>Requirements</h3>
             <p> </p>
             <ul>
-            <li>ONLYOFFICE Docs (Document Server) 4.2.7 or higher
+            <li>ONLYOFFICE Docs (Document Server) 8.0 or higher
             <p>You need an instance of ONLYOFFICE Docs that is resolvable and connectable both from Moodle and any end clients. It must be able to POST to Moodle directly.</p>
             <div class="notehelp">
             Please refer to the official <a href="https://helpcenter.onlyoffice.com/installation/docs-index.aspx" target="_blank"><b>documentation page</b></a> to learn more about installing ONLYOFFICE Docs.
             </div>
                 <p>You can also use <a href="<%=VirtualPathUtility.ToAbsolute("~/installation/docs-cloud-index.aspx")%>"><b>ONLYOFFICE Docs Cloud</b></a> (SaaS version).</p>
                 </li>
-            <li>Moodle v3.9.10 or later</li>
-            <li>ONLYOFFICE connector v3.0.0 for Moodle</li>
+            <li>Moodle v4.3 or later</li>
+            <li>ONLYOFFICE connector v4.4.0 for Moodle</li>
             </ul>
             <%--<div class="notehelp">ONLYOFFICE Docs and Moodle can be installed either on different computers, or on the same machine. In case you select the latter variant, you will need to set up a custom port for ONLYOFFICE Docs as by default both ONLYOFFICE Docs and Moodle work on port 80. See the corresponding instructions for <a href="https://localhost/installation/docs-community-install-docker.aspx#Installing" target="_blank"><b>Docker</b></a>, <a href="https://localhost/installation/docs-community-install-ubuntu.aspx#InstallingDebian" target="_blank"><b>Ubuntu</b></a>, <a href="https://localhost/installation/docs-community-install-centos.aspx#ChangingPort" target="_blank"><b>CentOS</b></a>, or <a href="https://localhost/installation/docs-community-install-windows.aspx#InstallingDocumentServer" target="_blank"><b>Windows</b></a>.</div>--%>
          </div>
@@ -141,12 +137,12 @@
                         <div class="notehelp">If you can’t find this location, then plugin installation is disabled on your site.</div>
                     </li>
                     <li>Click the <b>Install plugins from Moodle plugins directory</b> button.</li>
-                    <li>Select your current <a href="https://docs.moodle.org/311/en/Moodle_version">Moodle version</a>.</li>
+                    <li>Select your current <a href="https://docs.moodle.org/403/en/Moodle_version">Moodle version</a>.</li>
                     <li>Search for the <b>ONLYOFFICE document</b> plugin.</li>
                     <li>Click the <b>Install</b> button, then click <b>Continue</b>.</li>
                     <li>Confirm the installation request.</li>
                     <li>Check the plugin validation report.
-                        <div class="notehelp">It is extremely important that you choose your <a href="https://docs.moodle.org/311/en/Moodle_version">Moodle version</a> correctly. If you mistakenly download and install the wrong version of the plugin for your Moodle server, this may lead to some serious problems, even freezing of the Moodle site.</div>
+                        <div class="notehelp">It is extremely important that you choose your <a href="https://docs.moodle.org/403/en/Moodle_version">Moodle version</a> correctly. If you mistakenly download and install the wrong version of the plugin for your Moodle server, this may lead to some serious problems, even freezing of the Moodle site.</div>
                     </li>
                 </ol>
                 <h6><b>Using the GitHub .ZIP archive</b></h6>
@@ -179,7 +175,22 @@
                         </li>
                         <li>Click <b>Continue</b> on the <b>Upgrading to new version</b> page.</li>
                      </ol>
-                                
+                   <h6><b>Installing the Moodle AssignSubmission ONLYOFFICE Integration plugin</b></h6>
+                <div class="notehelp">Please note: the Moodle AssignSubmission ONLYOFFICE Integration plugin requires the main ONLYOFFICE plugin to be installed.</div>
+                <ol>
+                    <li>Log as an admin into your Moodle instance and go to <b>Site administration</b> > <b>Plugins</b> > <b>Install plugins</b>.
+                        <div class="notehelp">If you can’t find this location, then plugin installation is disabled on your site.</div>
+                    </li>
+                    <li>Click the <b>Install plugins from Moodle plugins directory</b> button.</li>
+                    <li>Select your current <a href="https://docs.moodle.org/403/en/Moodle_version">Moodle version</a>.</li>
+                    <li>Search for the <b>ONLYOFFICE Assign Submission</b> plugin.</li>
+                    <li>Click the <b>Install</b> button, then click <b>Continue</b>.</li>
+                    <li>Confirm the installation request.</li>
+                    <li>Check the plugin validation report.
+                        <div class="notehelp">It is extremely important that you choose your <a href="https://docs.moodle.org/403/en/Moodle_version">Moodle version</a> correctly. If you mistakenly download and install the wrong version of the plugin for your Moodle server, this may lead to some serious problems, even freezing of the Moodle site.</div>
+                    </li>
+                </ol>
+                <p>Alternatively, you can download the plugin from the <a href="https://github.com/ONLYOFFICE/moodle-assignsubmission_onlyoffice/releases" target="_blank"><b>GitHub page</b></a> and install it from the ZIP file.</p>             
               </div>
     </div>
 
@@ -194,7 +205,13 @@
                 <li>Optionally, specify the secret used to sign the data in the <b>Document Server Secret</b> field. The secret key is used to validate the JSON web token upon the request to Document Server. To learn more, check the <a href="https://api.onlyoffice.com/editors/signature/" target="_blank"><b>API documentation</b></a> for configuring JWT on the ONLYOFFICE Docs side.
                 <div class="notehelp">Starting from ONLYOFFICE Docs <b>v7.2</b>, JWT is enabled by default and the secret key is generated automatically. You need to enable it on the Moodle side as well: find your secret key in the ONLYOFFICE Docs configuration file, then specify the same secret key in the connector settings. For more details, see the <a href="<%=VirtualPathUtility.ToAbsolute("~/integration/gettingstarted-moodle.aspx#JWT_block")%>">Enabling JWT for the ONLYOFFICE and Moodle integration</a> section of this article.</div>
                 </li>
-                <li><b>Enable Force Save</b> - when this option is disabled, your changes are saved to the editors’ cache automatically. When this option is enabled, all changes to a document are sent to the storage directly when you click the <b>Save</b> button.</li>
+                <li><b>Enable Force Save</b> - when this option is disabled, your changes are saved to the editors’ cache automatically. When this option is enabled, all changes to a document are sent to the storage directly when you click the <b>Save</b> button.
+                    <div class="screen_block">
+                               <img alt="ONLYOFFICE_configure" target="ONLYOFFICE_configure_3" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Moodle/small/configure.png")%>" />
+				               <img alt="ONLYOFFICE_configure" id="ONLYOFFICE_configure_3" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Moodle/big/configure.png")%>" />
+			                   <div target="ONLYOFFICE_configure_3" class="screenphoto magnifier"></div>
+                </div>
+                </li>
                 <li>Optionally, specify the editor customization settings by checking the necessary boxes:
                     <ul>
                         <li><b>Display Chat menu button</b> - this option is used to display or hide the Chat menu button.</li>
@@ -202,15 +219,18 @@
                         <li><b>Display the header more compact</b> - this option is used to display the additional action buttons either in the upper part of the editor window header next to the logo or in the toolbar.</li>
                         <li><b>Display Feedback & Support menu button</b> - this option is used to display or hide the Feedback & Support menu button.</li>
                         <li><b>Display monochrome toolbar header</b> - this option is used to display the editor toolbar in monochrome.</li>
+                        <li><b>Enable plugins</b>> - this option is used to enable/disable the Plugins tab in the editors interface.</li>
+                        <li><b>Run document macros</b>> - this option is used to automatically run or disable all macros within the document.</li>
                     </ul>
                 </li>
             </ul>
             <p>When ready, click <b>Save changes</b>.</p>                        
                 <div class="screen_block">
-                               <img alt="ONLYOFFICE_configure" target="ONLYOFFICE_configure_3" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Moodle/small/configure.png")%>" />
-				               <img alt="ONLYOFFICE_configure" id="ONLYOFFICE_configure_3" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Moodle/big/configure.png")%>" />
-			                   <div target="ONLYOFFICE_configure_3" class="screenphoto magnifier"></div>
+                               <img alt="ONLYOFFICE_configure" target="ONLYOFFICE_configure_10" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Moodle/small/configure2.png")%>" />
+				               <img alt="ONLYOFFICE_configure" id="ONLYOFFICE_configure_10" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Moodle/big/configure2.png")%>" />
+			                   <div target="ONLYOFFICE_configure_10" class="screenphoto magnifier"></div>
                 </div>
+            <div class="notehelp">Please note: the Moodle AssignSubmission ONLYOFFICE Integration plugin does not require additional settings – all the settings are configured from the main plugin.</div>
         </div>
    </div>
 
@@ -318,6 +338,36 @@
 			                   <div target="ONLYOFFICE_readfile_7" class="screenphoto magnifier"></div>
 		                </div>
               <p>To open the editor in fullscreen mode, click the <b>Open full screen</b> button at the top right corner above the editor window.</p>
+              <h3>Adding submissions</h3>  
+              <div class="notehelp">Please note: the Moodle AssignSubmission ONLYOFFICE Integration plugin is required to build advanced digital forms for Moodle assignments.</div>
+              <p>To add a custom submission of the "ONLYOFFICE document" type in the <code>.pdf</code> format,</p>   
+              <ol>
+                  <li>Open the <b>My Courses</b> section and switch to the necessary course.</li>
+                  <li>Activate the <b>Edit Mode</b> using the switcher at the top right corner.</li>
+                  <li>Click <b>Add an activity or resource</b>.</li>
+                  <li>Select the <b>Assignment</b> activity in the pop-up window.</li>
+                  <li>In the <b>Submission types</b> tab, select the <b>ONLYOFFICE document</b> type. Once done, the form creator (<code>.docxf</code>) will become available on the Assignment creation/editing page – here you can prepare a form which will become available for students to fill out after saving.</li>
+                  <li>Click <b>Save and return to course</b> or <b>Save and display</b>. The created assignment will appear in the course section.</li>
+              </ol>
+                        <div class="screen_block">
+                                <img alt="ONLYOFFICE_assignments" target="ONLYOFFICE_assignments_11" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Moodle/small/assignment.png")%>" />
+				               <img alt="ONLYOFFICE_assignments" id="ONLYOFFICE_assignments_11" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Moodle/big/assignment.png")%>" />
+			                   <div target="ONLYOFFICE_assignments_11" class="screenphoto magnifier"></div>
+		                </div>
+              <h3>Filling out forms</h3>
+              <p>To fill out the form,</p>
+              <ol>
+                  <li>Select the created assignment and click <b>Add submission</b>.
+                      <div class="screen_block">
+                                <img alt="ONLYOFFICE_assignments" target="ONLYOFFICE_assignments_12" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Moodle/small/assignment2.png")%>" />
+				               <img alt="ONLYOFFICE_assignments" id="ONLYOFFICE_assignments_12" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Moodle/big/assignment2.png")%>" />
+			                   <div target="ONLYOFFICE_assignments_12" class="screenphoto magnifier"></div>
+		                </div>
+                  </li>
+                  <li>The form in the <code>.pdf</code> format will open (for Docs v8.0 or later. For older versions, the <code>.oform</code> format is used). Each student gets their own copy of the pdf form and works on their own assignment.</li>
+                  <li>Fill out the form and click <b>Save changes</b>.</li>
+              </ol>
+              <p>A teacher can view all assignments by clicking the <b>View all submissions</b> button.</p>
               <h3>Protecting files with a password</h3>
               <p>ONLYOFFICE files can be protected with a password so as to prevent unauthorized access. To do that,</p>
               <ol>