java-spring: https

fix: remove on develop pull request

.github/workflows/lint-java.yml

@@ -0,0 +1,31 @@
+name: Lint Java
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [master, main]
+    paths: ['web/documentserver-example/java/**']
+  pull_request:
+    branches: [master, main]
+    paths: ['web/documentserver-example/java/**']
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: ./web/documentserver-example/java
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v3
+
+      - name: Install Java 11
+        uses: actions/setup-java@v3
+        with:
+          distribution: 'temurin'
+          java-version: '11'
+          
+      - name: Run linter
+        run: |
+          mvn -version
+          mvn package

.github/workflows/lint-nodejs.yml

@@ -0,0 +1,35 @@
+name: ESLint
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [master, main]
+    paths: ['web/documentserver-example/nodejs/**']
+  pull_request:
+    branches: [master, main]
+    paths: ['web/documentserver-example/nodejs/**']
+
+env:
+  NODE_VERSION: 16
+
+jobs:
+  lint:
+    name: Lint 
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: ./web/documentserver-example/nodejs
+    steps:
+      - name: Install NodeJS
+        uses: actions/setup-node@v3
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+      
+      - name: Code Checkout
+        uses: actions/checkout@v3
+
+      - name: Install Dependencies
+        run: npm ci
+        
+      - name: Code Linting
+        run: npm run lint

.github/workflows/lint-php.yml

@@ -0,0 +1,31 @@
+name: PHPCs
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [master, main]
+    paths: ['web/documentserver-example/php/**']
+  pull_request:
+    branches: [master, main]
+    paths: ['web/documentserver-example/php/**']
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: ./web/documentserver-example/php
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.2'
+          tools: cs2pr, phpcs
+          
+      - name: Run phpcs
+        run: |
+          phpcs --version
+          phpcs -q --extensions=php,module,inc,install,test,profile,theme,info --ignore=node_modules,bower_components,vendor,css,js,lib --standard=./ruleset.xml ./

.github/workflows/lint-python.yml

@@ -0,0 +1,40 @@
+name: PyLint
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [master, main]
+    paths: ['web/documentserver-example/python/**']
+  pull_request:
+    branches: [master, main]
+    paths: ['web/documentserver-example/python/**']
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: ./web/documentserver-example/python
+    steps:
+      - uses: actions/checkout@v3
+      
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.10' 
+
+      - name: Install Dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install flake8
+          pip install pylint
+          if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
+
+      - name: Lint Flake8
+        run: |
+          flake8 ./**/*.py --count --select=E9,F63,F7,F82 --show-source --statistics
+          flake8 ./**/*.py --count --max-complexity=10 --max-line-length=79 --statistics
+          
+      - name: Lint Pylint
+        run: |
+          pylint ./**/*.py

.github/workflows/lint-ruby.yml

@@ -0,0 +1,31 @@
+name: Rubocop
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [master, main]
+    paths: ['web/documentserver-example/ruby/**']
+  pull_request:
+    branches: [master, main]
+    paths: ['web/documentserver-example/ruby/**']
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: ./web/documentserver-example/ruby
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v3
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.0'
+          bundler-cache: true
+      - name: Install dependencies
+        run: | 
+          bundle install
+      - name: Rubocop
+        run: |
+          gem install rubocop
+          rubocop

.github/workflows/lint-spring.yml

@@ -0,0 +1,31 @@
+name: Lint Spring
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [master, main]
+    paths: ['web/documentserver-example/java-spring/**']
+  pull_request:
+    branches: [master, main]
+    paths: ['web/documentserver-example/java-spring/**']
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: ./web/documentserver-example/java-spring
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v3
+
+      - name: Install Java 11
+        uses: actions/setup-java@v3
+        with:
+          distribution: 'temurin'
+          java-version: '11'
+          
+      - name: Run linter
+        run: |
+          mvn -version
+          mvn package

.gitmodules

@@ -26,3 +26,7 @@
 	path = web/documentserver-example/ruby/public/assets
 	url = https://github.com/ONLYOFFICE/document-templates
 	branch = main/en
+[submodule "web/documentserver-example/java-spring/src/main/resources/assets"]
+	path = web/documentserver-example/java-spring/src/main/resources/assets
+	url = https://github.com/ONLYOFFICE/document-templates
+	branch = main/en

3rd-Party.license

@@ -90,6 +90,65 @@ License:        Apache 2.0
 License File:   prime-jwt.license
 
 
+web/documentserver-example/java-spring
+
+jQuery        - jQuery is a new kind of JavaScript Library.        jQuery is a fast and concise JavaScript Library that simplifies HTML document traversing, event handling, animating, and Ajax interactions for rapid web development. jQuery is designed to change the way that you write JavaScript.        NOTE: This package is maintained on behalf of the library owners by the NuGet Community Packages project at https://nugetpackages.codeplex.com/ (https://jquery.org/license/)
+License:        MIT
+License File:   jQuery.license
+
+jQuery.BlockUI - The jQuery BlockUI Plugin lets you simulate synchronous behavior when using AJAX, without locking the browser. (https://github.com/malsup/blockui/)
+License:        MIT, GPL
+License File:   jQuery.BlockUI.license
+
+jQuery.FileUpload - File Upload widget with multiple file selection, drag&drop support, progress bar, validation and preview images, audio and video for jQuery. Supports cross-domain, chunked and resumable file uploads. Works with any server-side platform (Google App Engine, PHP, Python, Ruby on Rails, Java, etc.) that supports standard HTML form file uploads. (https://github.com/blueimp/jQuery-File-Upload/blob/master/LICENSE.txt)
+License:        MIT
+License File:   jQuery.FileUpload.license
+
+jQuery.iframe-transport - jQuery Iframe Transport Plugin for File Upload (https://github.com/blueimp/jQuery-File-Upload/blob/master/LICENSE.txt)
+License:        MIT
+License File:   jQuery.iframe-transport.license
+
+jQuery.UI     - jQuery UI is an open source library of interface components — interactions, full-featured widgets, and animation effects — based on the stellar jQuery javascript library . Each component is built according to jQuery's event-driven architecture (find something, manipulate it) and is themeable, making it easy for developers of any skill level to integrate and extend into their own code. (https://jquery.org/license/)
+License:        MIT
+License File:   jQuery.UI.license
+
+Prime JWT     - is intended to be fast and easy to use. Prime JWT has a single external dependency on Jackson. (https://github.com/ws-apps/prime-jwt/blob/master/LICENSE)
+License:        Apache 2.0
+License File:   prime-jwt.license
+
+Spring Boot   - Helps create Spring-powered, production-grade applications and services. Has external dependencies on Spring Framework. (https://github.com/spring-projects/spring-boot/blob/main/LICENSE.txt)
+License:        Apache 2.0
+License File:   spring-boot.license
+
+Spring Boot Devtools - Provides fast application restarts, LiveReload, and configurations for enhanced development experience. (https://github.com/spring-projects/spring-boot/blob/main/LICENSE.txt)
+License:        Apache 2.0
+License File:   spring-boot.license
+
+Spring Boot Starter Thymeleaf - A modern server-side Java template engine for both web and standalone environments. (https://github.com/spring-projects/spring-boot/blob/main/LICENSE.txt)
+License:        Apache 2.0
+License File:   spring-boot.license
+
+Spring Data JPA - Persist data in SQL stores with Java Persistence API using Spring Data and Hibernate. (https://github.com/spring-projects/spring-data-jpa/blob/main/LICENSE.txt)
+License:        Apache 2.0
+License File:   spring-data-jpa.license
+
+H2 Database Engine - This software contains unmodified binary redistributions for H2 database engine. H2 is a relational DBMS that can be embedded in java applications. (https://h2database.com/html/license.html)
+License:        MPL 2.0 or EPL 1.0
+License File:   h2database.license
+
+JSON.simple   - JSON.simple is a simple Java toolkit for JSON. You can use JSON.simple to encode or decode JSON text. (https://github.com/fangyidong/json-simple/blob/master/LICENSE.txt)
+License:        Apache 2.0
+License File:   JSON.simple.license
+
+Gson          - Gson is a Java library that can be used to convert Java Objects into their JSON representation. (https://github.com/google/gson/blob/master/LICENSE)
+License:        Apache 2.0
+License File:   gson.license
+
+Jackson Databind - General-purpose data-binding functionality and tree-model for Jackson Data Processor. (https://github.com/FasterXML/jackson-databind/blob/master/LICENSE)
+License:        Apache 2.0
+License File:   jackson-databind.license
+
+
 web/documentserver-example/nodejs
 
 body-parser   - Node.js body parsing middleware. (https://github.com/expressjs/body-parser/blob/master/LICENSE)
@@ -112,10 +171,18 @@ express       - Fast, unopinionated, minimalist web framework for node. (https:/
 License:        MIT
 License File:   express.license
 
+fast-xml-parser - Validate XML, Parse XML to JS/JSON and vice versa, or parse XML to Nimn rapidly without C/C++ based libraries and no callback. (https://github.com/NaturalIntelligence/fast-xml-parser/blob/master/LICENSE)
+License:        MIT
+License File:   fast-xml-parser.license
+
 formidable    - A Node.js module for parsing form data, especially file uploads. (https://github.com/node-formidable/formidable/blob/master/LICENSE)
 License:        MIT
 License File:   formidable.license
 
+he            - a robust HTML entity encoder/decoder written in JavaScript. (https://github.com/mathiasbynens/he/blob/master/LICENSE-MIT.txt)
+License:        MIT
+License File:   he.license
+
 jQuery        - jQuery is a new kind of JavaScript Library.        jQuery is a fast and concise JavaScript Library that simplifies HTML document traversing, event handling, animating, and Ajax interactions for rapid web development. jQuery is designed to change the way that you write JavaScript.        NOTE: This package is maintained on behalf of the library owners by the NuGet Community Packages project at https://nugetpackages.codeplex.com/ (https://jquery.org/license/)
 License:        MIT
 License File:   jQuery.license
@@ -156,10 +223,6 @@ serve-favicon - Node.js middleware for serving a favicon. (https://github.com/ex
 License:        MIT
 License File:   serve-favicon.license
 
-sync-request  - Make synchronous web requests with cross-platform support. (https://github.com/ForbesLindesay/sync-request/blob/master/LICENSE)
-License:        MIT
-License File:   sync-request.license
-
 urllib        - Request HTTP URLs in a complex world — basic and digest authentication, redirections, cookies, timeout and more. (https://github.com/node-modules/urllib/blob/master/LICENSE)
 License:        MIT
 License File:   urllib.license
@@ -187,6 +250,14 @@ jQuery.UI     - jQuery UI is an open source library of interface components —
 License:        MIT
 License File:   jQuery.UI.license
 
+JWT           - JSON Web Token implementation (https://github.com/firebase/php-jwt/blob/master/LICENSE)
+License:        BSD-3-Clause
+License File:   jwt.license
+
+PHP_CodeSniffer - PHP_CodeSniffer is a set of two PHP scripts; the main phpcs script that tokenizes PHP, JavaScript and CSS files to detect violations of a defined coding standard, and a second phpcbf script to automatically correct coding standard violations. PHP_CodeSniffer is an essential development tool that ensures your code remains clean and consistent. (https://github.com/squizlabs/PHP_CodeSniffer/blob/master/licence.txt)
+License:        BSD-3-Clause
+License File:   PHP_CodeSniffer.license
+
 
 web/documentserver-example/ruby
 

CHANGELOG.md

@@ -0,0 +1,49 @@
+# Change Log
+
+- php: linter refactoring
+
+## 1.5.0
+- nodejs: added wopi putRelativeFile action
+- nodejs: wopi editnew action for exisiting file
+- nodejs: fix wopi actions after restart
+- setting an unavailable language
+- description in the tooltip on the main page
+- nodejs: referenceData
+- option to send directUrl
+
+## 1.4.0
+- nodejs: option to send directUrl
+- opening file on client by directUrl
+- offline viewer for anonymous
+- added hy, eu, zh-TW, ms, pt-PT
+
+## 1.3.1
+- charp: fix references
+- ruby: update rails 
+
+## 1.3.0
+- update empty files
+- anonymous without chat
+- changed jwt implementation in csharp, csharp-mvc, php, ruby
+
+## 1.2.0
+- ruby v3.0
+- set filetype in setHistoryData
+- read filetype from input request
+- creating file on WOPI
+- upload on WOPI page
+- fix xss
+- set userInfoGroups
+- check JWT on downloading history
+- upload dialog on mobile
+- anonymous without id
+- renaming from editor
+- new skin languages
+- ignore certificate
+
+## 1.1.0
+- creating docxf
+- opening docxf, oform
+
+## 1.0.0
+- added java spring

Readme.md

@@ -1,14 +1,19 @@
-## Document Server integration example
+## Integration examples
 
-These examples show the way to integrate [ONLYOFFICE Document Server][2] into your own website or application using one of the programming languages. The package contains examples written in .Net (C# MVC), .Net (C#), Java, Node.js, PHP and Ruby.
+Test examples are simple document management systems that can be built into your application for testing.
+Do NOT use these integration examples on your own server without proper code modifications!
+In case you enabled any of the test examples, disable it before going for production.
+
+These examples show the way to integrate [ONLYOFFICE Docs][2] into your own website or application using one of the programming languages.
+The package contains examples written in .Net (C# MVC), .Net (C#), Java, Node.js, PHP and Ruby.
 
 You should change `http://documentserver` to your server address in these files:
-* .Net (C# MVC) - `web/documentserver-example/csharp-mvc/web.appsettings.config`
-* .Net (C#) - `web/documentserver-example/csharp/settings.config`
-* Java - `web/documentserver-example/java/src/main/resources/settings.properties`
-* Node.js - `web/documentserver-example/nodejs/config/default.json`
-* PHP - `web/documentserver-example/php/config.php`
-* Ruby - `web/documentserver-example/ruby/config/application.rb`
+* [.Net (C# MVC)](https://github.com/ONLYOFFICE/document-server-integration/tree/master/web/documentserver-example/csharp-mvc) - `web/documentserver-example/csharp-mvc/web.appsettings.config`
+* [.Net (C#)](https://github.com/ONLYOFFICE/document-server-integration/tree/master/web/documentserver-example/csharp) - `web/documentserver-example/csharp/settings.config`
+* [Java](https://github.com/ONLYOFFICE/document-server-integration/tree/master/web/documentserver-example/java) - `web/documentserver-example/java/src/main/resources/settings.properties`
+* [Node.js](https://github.com/ONLYOFFICE/document-server-integration/tree/master/web/documentserver-example/nodejs) - `web/documentserver-example/nodejs/config/default.json`
+* [PHP](https://github.com/ONLYOFFICE/document-server-integration/tree/master/web/documentserver-example/php) - `web/documentserver-example/php/config.php`
+* [Ruby](https://github.com/ONLYOFFICE/document-server-integration/tree/master/web/documentserver-example/ruby) - `web/documentserver-example/ruby/config/application.rb`
 
 More information on how to use these examples can be found here: [http://api.onlyoffice.com/editors/demopreview](http://api.onlyoffice.com/editors/demopreview "http://api.onlyoffice.com/editors/demopreview")
 
@@ -62,6 +67,15 @@ The methods described below are available for all of the test examples.
 | **Response**       | **Code:** 200 OK <br />**Content on success:**<br /> `[{ "version": <file_version>, "id": <file_id>, "contentLength": <file_size_in_kilobytes>, "pureContentLength": <file_size_in_bytes>, "title": <file_name>, "updated": <last_change_date>}]`<br />**Content on error:**<br /> `"File not found"` |
 | **Sample**         | `curl -X GET http://localhost/files/{fileId}`                |
 
+## Important security info
+
+Please keep in mind the following security aspects when you are using test examples:
+
+* There is no protection of the storage from unauthorized access since there is no need for authorization.
+* There are no checks against parameter substitution in links, since the parameters are generated by the code according to the pre-arranged scripts.
+* There are no data checks in requests of saving the file after editing, since each test example is intended for requests only from ONLYOFFICE Document Server.
+* There are no prohibitions on using test examples from other sites, since they are intended to interact with ONLYOFFICE Document Server from another domain.
+
 ## Project Information
 
 Official website: [https://www.onlyoffice.com](https://www.onlyoffice.com/?utm_source=github&utm_medium=cpc&utm_campaign=GitHubIntegrationEx)
@@ -72,9 +86,9 @@ ONLYOFFICE for developers: [https://www.onlyoffice.com/developer-edition.aspx](h
 
 ## User Feedback and Support
 
-If you have any problems with or questions about [ONLYOFFICE Document Server][2], please visit our official forum to find answers to your questions: [dev.onlyoffice.org][1] or you can ask and answer ONLYOFFICE development questions on [Stack Overflow][3].
+If you have any problems with or questions about [ONLYOFFICE Document Server][2], please visit our official forum to find answers to your questions: [forum.onlyoffice.com][1] or you can ask and answer ONLYOFFICE development questions on [Stack Overflow][3].
 
-  [1]: http://dev.onlyoffice.org
+  [1]: https://forum.onlyoffice.com
   [2]: https://github.com/ONLYOFFICE/DocumentServer
   [3]: http://stackoverflow.com/questions/tagged/onlyoffice
   

build/msbuild/zip.proj

@@ -4,12 +4,14 @@
   <PropertyGroup>
     <To Condition=" '$(To)' == '' ">..\deploy\</To>
     <RootDir Condition="$(RootDir)==''">..\..\</RootDir>
-    <NameCSharp>$(To).Net (C#) Example</NameCSharp>
+    <NameCSharp>$(To)DotNet (Csharp) Example</NameCSharp>
     <DirCSharp>$(RootDir)web\documentserver-example\csharp\</DirCSharp>
-    <NameMvc>$(To).Net (C# MVC) Example</NameMvc>
+    <NameMvc>$(To)DotNet (Csharp MVC) Example</NameMvc>
     <DirMvc>$(RootDir)web\documentserver-example\csharp-mvc\</DirMvc>
     <NameJava>$(To)Java Example</NameJava>
     <DirJava>$(RootDir)web\documentserver-example\java\</DirJava>
+    <NameSpring>$(To)Java Spring Example</NameSpring>
+    <DirSpring>$(RootDir)web\documentserver-example\java-spring\</DirSpring>
     <NameNodeJS>$(To)Node.js Example</NameNodeJS>
     <DirNodeJS>$(RootDir)web\documentserver-example\nodejs\</DirNodeJS>
     <NamePHP>$(To)PHP Example</NamePHP>
@@ -24,43 +26,49 @@
     <RemoveDir Directories="$(To)" ContinueOnError="true" />
 
     <ItemGroup>
-      <ZipFilesCSharp Include="$(DirCSharp)**" Exclude="$(DirCSharp)obj\**" />
+      <ZipFilesCSharp Include="$(DirCSharp)**" Exclude="$(DirCSharp).vs\**;$(DirCSharp)bin\*.pdb;$(DirCSharp)bin\*.xml;$(DirCSharp)obj\**;$(DirCSharp)packages\**;$(DirCSharp)**\.git" />
     </ItemGroup>
     <Copy SourceFiles="@(ZipFilesCSharp)" DestinationFiles="@(ZipFilesCSharp->'$(NameCSharp)\%(RecursiveDir)%(Filename)%(Extension)')" />
     <Zip Files="$(NameCSharp)" WorkingDirectory="$(To)" ZipFileName="$(NameCSharp).zip" />
 
     <ItemGroup>
-      <ZipFilesMVC Include="$(DirMvc)**" Exclude="$(DirMvc)obj\**" />
+      <ZipFilesMVC Include="$(DirMvc)**" Exclude="$(DirMvc).vs\**;$(DirMvc)bin\*.pdb;$(DirMvc)bin\*.xml;$(DirMvc)obj\**;$(DirMvc)packages\**;$(DirMvc)**\.git" />
     </ItemGroup>
     <Copy SourceFiles="@(ZipFilesMVC)" DestinationFiles="@(ZipFilesMVC->'$(NameMvc)\%(RecursiveDir)%(Filename)%(Extension)')" />
     <Zip Files="$(NameMvc)" WorkingDirectory="$(To)" ZipFileName="$(NameMvc).zip" />
 
     <ItemGroup>
-      <ZipFilesJava Include="$(DirJava)**" />
+      <ZipFilesJava Include="$(DirJava)**" Exclude="$(DirJava)**\.git" />
     </ItemGroup>
     <Copy SourceFiles="@(ZipFilesJava)" DestinationFiles="@(ZipFilesJava->'$(NameJava)\%(RecursiveDir)%(Filename)%(Extension)')" />
     <Zip Files="$(NameJava)" WorkingDirectory="$(To)" ZipFileName="$(NameJava).zip" />
 
     <ItemGroup>
-      <ZipFilesNodeJS Include="$(DirNodeJS)**" Exclude="$(DirNodeJS)node_modules\**" />
+      <ZipFilesSpring Include="$(DirSpring)**" Exclude="$(DirSpring)**\.git" />
+    </ItemGroup>
+    <Copy SourceFiles="@(ZipFilesSpring)" DestinationFiles="@(ZipFilesSpring->'$(NameSpring)\%(RecursiveDir)%(Filename)%(Extension)')" />
+    <Zip Files="$(NameSpring)" WorkingDirectory="$(To)" ZipFileName="$(NameSpring).zip" />
+
+    <ItemGroup>
+      <ZipFilesNodeJS Include="$(DirNodeJS)**" Exclude="$(DirNodeJS)node_modules\**;$(DirNodeJS)**\.git" />
     </ItemGroup>
     <Copy SourceFiles="@(ZipFilesNodeJS)" DestinationFiles="@(ZipFilesNodeJS->'$(NameNodeJS)\%(RecursiveDir)%(Filename)%(Extension)')" />
     <Zip Files="$(NameNodeJS)" WorkingDirectory="$(To)" ZipFileName="$(NameNodeJS).zip" />
 
     <ItemGroup>
-      <ZipFilesPHP Include="$(DirPHP)**" />
+      <ZipFilesPHP Include="$(DirPHP)**" Exclude="$(DirPHP)**\.git" />
     </ItemGroup>
     <Copy SourceFiles="@(ZipFilesPHP)" DestinationFiles="@(ZipFilesPHP->'$(NamePHP)\%(RecursiveDir)%(Filename)%(Extension)')" />
     <Zip Files="$(NamePHP)" WorkingDirectory="$(To)" ZipFileName="$(NamePHP).zip" />
 
     <ItemGroup>
-      <ZipFilesRuby Include="$(DirRuby)**" />
+      <ZipFilesRuby Include="$(DirRuby)**" Exclude="$(DirRuby)**\.git" />
     </ItemGroup>
     <Copy SourceFiles="@(ZipFilesRuby)" DestinationFiles="@(ZipFilesRuby->'$(NameRuby)\%(RecursiveDir)%(Filename)%(Extension)')" />
     <Zip Files="$(NameRuby)" WorkingDirectory="$(To)" ZipFileName="$(NameRuby).zip" />
 
     <ItemGroup>
-      <ZipFilesPython Include="$(DirPython)**" />
+      <ZipFilesPython Include="$(DirPython)**" Exclude="$(DirPython)**\.git" />
     </ItemGroup>
     <Copy SourceFiles="@(ZipFilesPython)" DestinationFiles="@(ZipFilesPython->'$(NamePython)\%(RecursiveDir)%(Filename)%(Extension)')" />
     <Zip Files="$(NamePython)" WorkingDirectory="$(To)" ZipFileName="$(NamePython).zip" />

web/documentserver-example/csharp-mvc/3rd-Party.license

@@ -24,11 +24,15 @@ jQuery.UI     - jQuery UI is an open source library of interface components —
 License:        MIT
 License File:   jQuery.UI.license
 
+JWT           - JWT (JSON Web Token) Implementation for .NET (Public Domain) (https://github.com/jwt-dotnet/jwt/)
+License:        MIT
+License File:   JWT.license
+
 Microsoft.Web.Infrastructure - This package contains the Microsoft.Web.Infrastructure assembly that lets you dynamically register HTTP modules at run time. (https://www.microsoft.com/web/webpi/eula/aspnetmvc3update-eula.htm)
 License:        MS-EULA License
 License File:   Microsoft.Web.Infrastructure.license
 
-Newtonsoft.Json - Json.NET is a popular high-performance JSON framework for .NET (https://licenses.nuget.org/MIT)
+Newtonsoft.Json - Json.NET is a popular high-performance JSON framework for .NET (https://github.com/JamesNK/Newtonsoft.Json)
 License:        MIT
 License File:   Newtonsoft.Json.license
 

web/documentserver-example/csharp-mvc/App_Start/BundleConfig.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -22,8 +22,10 @@ namespace OnlineEditorsExampleMVC
 {
     public class BundleConfig
     {
+        // register bundles
         public static void RegisterBundles(BundleCollection bundles)
         {
+            // create a jquery script bundle
             bundles.Add(new ScriptBundle("~/bundles/jquery").Include(
                 "~/Scripts/jquery-{version}.js",
                 "~/Scripts/jquery-ui.js",
@@ -33,15 +35,19 @@ namespace OnlineEditorsExampleMVC
                 "~/Scripts/jquery.dropdownToggle.js"
                             ));
 
+            // create the main script bundle
             bundles.Add(new ScriptBundle("~/bundles/scripts").Include(
                 "~/Scripts/jscript.js"
                             ));
 
+            // create a style bundle
             bundles.Add(new StyleBundle("~/Content/css").Include(
                 "~/Content/stylesheet.css",
-                "~/Content/jquery-ui.css"
+                "~/Content/jquery-ui.css",
+                "~/Content/media.css"
                             ));
 
+            // create an editor style bundle
             bundles.Add(new StyleBundle("~/Content/editor").Include(
                 "~/Content/editor.css"
                             ));

web/documentserver-example/csharp-mvc/App_Start/FilterConfig.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -22,6 +22,7 @@ namespace OnlineEditorsExampleMVC
 {
     public class FilterConfig
     {
+        // register global filters
         public static void RegisterGlobalFilters(GlobalFilterCollection filters)
         {
             filters.Add(new HandleErrorAttribute());

web/documentserver-example/csharp-mvc/App_Start/RouteConfig.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -23,10 +23,12 @@ namespace OnlineEditorsExampleMVC
 {
     public class RouteConfig
     {
+        // register routes
         public static void RegisterRoutes(RouteCollection routes)
         {
             routes.IgnoreRoute("{resource}.axd/{*pathInfo}");
 
+            // create a route map
             routes.MapRoute(
                 name: "Default",
                 url: "{action}",

web/documentserver-example/csharp-mvc/App_Start/WebApiConfig.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/csharp-mvc/Content/editor.css

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/csharp-mvc/Content/images/block-content.svg

@@ -0,0 +1,5 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<rect x="3" y="11" width="4" height="1" fill="#444444"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M2 13V10H10V8H1C0.447715 8 0 8.44772 0 9V14C0 14.5523 0.447715 15 1 15H10V13H2Z" fill="#444444"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M23.5243 10.5534L22.2366 10.3386C22.143 9.95592 22.0065 9.59014 21.8288 9.24897L22.6532 8.22679C22.8285 8.01077 22.8205 7.69994 22.6357 7.49145L22.1235 6.91502C21.9379 6.70675 21.63 6.6627 21.3952 6.81106L20.2939 7.50337C19.8095 7.16494 19.2608 6.91502 18.6689 6.77L18.4535 5.4753C18.4083 5.20115 18.171 5 17.8926 5H17.1207C16.8428 5 16.6048 5.20115 16.5606 5.4753L16.344 6.77041C15.8546 6.89023 15.3958 7.08363 14.9771 7.33835L13.9297 6.59088C13.704 6.42961 13.394 6.45483 13.197 6.65139L12.6517 7.19707C12.4552 7.39406 12.4299 7.7041 12.5916 7.92983L13.3408 8.97921C13.0885 9.39477 12.8971 9.85099 12.7773 10.336L11.4753 10.5534C11.2015 10.5986 11 10.8359 11 11.1144V11.8856C11 12.1641 11.2015 12.4014 11.4753 12.4466L12.7773 12.664C12.8757 13.0631 13.0185 13.4444 13.2083 13.7978L12.3877 14.8142C12.213 15.0301 12.2203 15.3411 12.4051 15.5494L12.9169 16.1258C13.1026 16.3345 13.4106 16.3778 13.6455 16.2298L14.7626 15.528C15.2353 15.8513 15.7701 16.0889 16.344 16.2298L16.5606 17.5247C16.6048 17.7988 16.8428 18 17.1207 18H17.8926C18.171 18 18.4083 17.7989 18.4535 17.5247L18.6693 16.2298C19.1525 16.1116 19.6055 15.9215 20.0205 15.6712L21.1115 16.4504C21.3368 16.6122 21.6471 16.5868 21.8439 16.3897L22.3894 15.8442C22.5857 15.6478 22.6123 15.3379 22.4492 15.1118L21.6725 14.0227C21.9255 13.6058 22.118 13.1487 22.237 12.6616L23.5248 12.4465C23.7993 12.4013 24 12.1641 24 11.8856V11.1143C23.9996 10.8359 23.7989 10.5986 23.5243 10.5534ZM17.5204 13.9375C16.1745 13.9375 15.0829 12.8457 15.0829 11.5C15.0829 10.1541 16.1745 9.0625 17.5204 9.0625C18.866 9.0625 19.9578 10.1541 19.9578 11.5C19.9578 12.8457 18.866 13.9375 17.5204 13.9375Z" fill="#444444"/>
+</svg>

web/documentserver-example/csharp-mvc/Content/images/comment.svg

@@ -0,0 +1,3 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M5 6C4.44772 6 4 6.44772 4 7V16.4074C4 16.9597 4.44772 17.4074 5 17.4074H6.72783C7.02679 17.4074 7.31006 17.5412 7.50002 17.772L8.56115 19.0616C8.96117 19.5477 9.7055 19.5477 10.1055 19.0616L11.1667 17.772C11.3566 17.5412 11.6399 17.4074 11.9388 17.4074H19C19.5523 17.4074 20 16.9597 20 16.4074V7C20 6.44772 19.5523 6 19 6H5ZM17 9H7V10H17V9ZM17 11H7V12H17V11ZM7 13H15V14H7V13Z" fill="#444444"/>
+</svg>

web/documentserver-example/csharp-mvc/Content/images/delete.svg

@@ -0,0 +1,3 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M18 18.0001L17.9952 16.401L13.5964 12.0025L17.9998 7.59937L17.9998 6L16.4004 6.00008L11.997 10.4032L7.59925 6.00568L5.99999 6.00013L5.99988 7.60497L10.3977 12.0025L6.00447 16.3954L6.00001 18.0001L7.60384 17.9947L11.997 13.6018L16.3958 18.0003L18 18.0001Z" fill="#444444"/>
+</svg>

web/documentserver-example/csharp-mvc/Content/images/desktop.svg

@@ -0,0 +1,3 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M19 6H5L5 15H19V6ZM5 4C3.89543 4 3 4.89543 3 6V15C3 16.1046 3.89543 17 5 17H10V18H6V20H18V18H14V17H19C20.1046 17 21 16.1046 21 15V6C21 4.89543 20.1046 4 19 4H5Z" fill="#444444"/>
+</svg>

web/documentserver-example/csharp-mvc/Content/images/download.svg

@@ -0,0 +1,4 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M6 16V13H7.2V11H5C4.44772 11 4 11.4477 4 12V17C4 17.5523 4.44772 18 5 18H19C19.5523 18 20 17.5523 20 17V12C20 11.4477 19.5523 11 19 11H16.8V13H18V16H6Z" fill="#444444"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M13.9996 8.5L15.2025 8.5C15.7911 8.5 16 8.49063 16 8.75503C16 8.94763 15.8986 9.29489 15.6987 9.4874L12.6667 12.6478C12.179 13.1174 11.821 13.1174 11.3333 12.6478L8.30133 9.4874C8.10142 9.29489 8 8.94763 8 8.75503C8 8.49056 8.20889 8.5 8.79749 8.5C8.79749 8.5 9.4909 8.5 9.99708 8.5C9.99708 8.28638 9.99708 5 9.99708 5L13.9996 5C13.9996 5 13.9996 8.29916 13.9996 8.5Z" fill="#444444"/>
+</svg>

web/documentserver-example/csharp-mvc/Content/images/embeded.svg

@@ -0,0 +1,5 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<rect x="4" y="6" width="16" height="13" rx="1" stroke="#444444" stroke-width="2"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M14.148 8.69651C13.8858 8.43384 13.4601 8.43384 13.1979 8.69651V8.69651C12.9362 8.95858 12.9362 9.38302 13.1979 9.64509L15.3401 11.7908C15.7296 12.1809 15.7299 12.8126 15.3409 13.2031L13.1967 15.3554C12.9357 15.6173 12.9357 16.041 13.1967 16.3029V16.3029C13.4591 16.5663 13.8855 16.5663 14.1478 16.3029L17.3302 13.1086V13.1086C17.668 12.7702 17.668 12.2222 17.3302 11.8838L14.148 8.69651Z" fill="#444444"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M9.85199 16.3035C10.1142 16.5662 10.5399 16.5662 10.8021 16.3035V16.3035C11.0638 16.0414 11.0638 15.617 10.8021 15.3549L8.65987 13.2092C8.2704 12.8191 8.27006 12.1874 8.65911 11.7969L10.8033 9.64461C11.0643 9.38266 11.0643 8.959 10.8033 8.69706V8.69706C10.5409 8.43371 10.1145 8.43371 9.85218 8.69706L6.66983 11.8914V11.8914C6.33201 12.2298 6.33201 12.7778 6.66983 13.1162L9.85199 16.3035Z" fill="#444444"/>
+</svg>

web/documentserver-example/csharp-mvc/Content/images/file_docxf.svg

@@ -0,0 +1,6 @@
+<svg width="30" height="40" viewBox="0 0 30 40" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M0 3C0 1.34315 1.34315 0 3 0H22.9167L30 7.08333V37C30 38.6569 28.6569 40 27 40H3C1.34315 40 0 38.6569 0 37V3Z" fill="#27ABA3"/>
+<path d="M22.9165 0L29.9998 7.08333H25.9165C24.2597 7.08333 22.9165 5.74019 22.9165 4.08333V0Z" fill="#008078"/>
+<rect x="6.5" y="15.5" width="17" height="5" stroke="white"/>
+<rect x="6.5" y="23.5" width="17" height="5" stroke="white"/>
+</svg>

web/documentserver-example/csharp-mvc/Content/images/fill-forms.svg

@@ -0,0 +1,4 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M6 16V13H7V11H5C4.44772 11 4 11.4477 4 12V17C4 17.5523 4.44772 18 5 18H19C19.5523 18 20 17.5523 20 17V12C20 11.4477 19.5523 11 19 11H17V13H18V16H6Z" fill="#444444"/>
+<path d="M11 15H9V13L16 6H17V7H18V8L11 15Z" fill="#444444"/>
+</svg>

web/documentserver-example/csharp-mvc/Content/images/filter.svg

@@ -0,0 +1,3 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M10.4 10.4L4 4H20L13.6 10.4V17.8667V21.0667L10.4 17.8667V10.4Z" fill="#444444"/>
+</svg>

web/documentserver-example/csharp-mvc/Content/images/mobile-fill-forms.svg

@@ -0,0 +1,6 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M5 5C5 3.89543 5.89543 3 7 3H16C17.1046 3 18 3.89543 18 5V8H17V6H6V18H17V16H18V19C18 20.1046 17.1046 21 16 21H7C5.89543 21 5 20.1046 5 19V5ZM13 4H10V5H13V4ZM12 19.5C12 19.7761 11.7761 20 11.5 20C11.2239 20 11 19.7761 11 19.5C11 19.2239 11.2239 19 11.5 19C11.7761 19 12 19.2239 12 19.5Z" fill="#444444"/>
+<rect x="7" y="9" width="1" height="6" fill="#444444"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M12 8V9L11 9V15H12V16H9V15H10V9H9V8H12Z" fill="#444444"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M15 10H18V14H15H14H13V15H14H18C18.5523 15 19 14.5523 19 14V10C19 9.44772 18.5523 9 18 9H14H13V10H14H15Z" fill="#444444"/>
+</svg>

web/documentserver-example/csharp-mvc/Content/images/mobile.svg

@@ -0,0 +1,3 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M8 3C6.89543 3 6 3.89543 6 5V19C6 20.1046 6.89543 21 8 21H16C17.1046 21 18 20.1046 18 19V5C18 3.89543 17.1046 3 16 3H8ZM16.8462 6H7.15385V18H16.8462V6ZM10.3846 4H13.6154V5H10.3846V4ZM12 20C12.2974 20 12.5385 19.7761 12.5385 19.5C12.5385 19.2239 12.2974 19 12 19C11.7026 19 11.4615 19.2239 11.4615 19.5C11.4615 19.7761 11.7026 20 12 20Z" fill="#444444"/>
+</svg>

web/documentserver-example/csharp-mvc/Content/images/review.svg

@@ -0,0 +1,3 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M6 5C5.44772 5 5 5.44772 5 6V18C5 18.5523 5.44772 19 6 19H17C17.5523 19 18 18.5523 18 18V13.4142L14.4142 17H11V15H8V14H11V13.5858L11.5858 13H8V12H12.5858L13.5858 11H8V10H14.5858L18 6.58579V6C18 5.44772 17.5523 5 17 5H6ZM8 8H15V9H8V8ZM12 16H14L21 9V8H20V7H19L12 14V16Z" fill="#444444"/>
+</svg>

web/documentserver-example/csharp-mvc/Content/media.css

@@ -0,0 +1,684 @@
+/**
+ *
+ * (c) Copyright Ascensio System SIA 2023
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
+ @media (min-width: 1280px)  and (max-width: 1380px) {
+    .copy {
+        margin-right: 6.5%;
+    }
+
+    footer table tr td:first-child {
+        margin-left: 6.5%;
+    }
+}
+
+@media (max-width: 1280px)  and (min-width: 1080px) {
+
+    .tableRow td:first-child {
+        flex-grow: 1;
+        width: 25%;
+    }
+
+    .tableHeaderCellFileName {
+        width: 25%;
+    }
+
+    .tableHeaderCellEditors {
+        width: 13%;
+    }
+
+    .tableHeaderCellViewers {
+        width: 29%;
+        text-align: right;
+    }
+
+    .tableHeaderCellDownload {
+        width: 21%;
+        padding-right: 18px;
+    }
+
+    .tableHeaderCellRemove {
+        padding-left: 13px;
+    }
+
+    footer table tr td:first-child {
+        margin-left: 5%;
+    }
+
+    .copy {
+        margin-right: 5%;
+        padding-right: 32px;
+    }
+
+    .left-panel {
+        margin-left: 48px;
+        width: 20%;
+    }
+}
+
+@media (max-width: 1080px) {
+    .copy {
+        margin-right: 32px;
+    }
+
+    footer table tr td:first-child {
+        margin-left: 0;
+    }
+
+    .tableRow {
+        width: 90%;
+    }
+
+    .tableHeaderCellFileName {
+        width: 16%;
+    }
+
+    .tableHeaderCellEditors {
+        width: 13%;
+    }
+
+    .tableHeaderCellViewers {
+        width: 38%;
+    }
+
+    .tableHeaderCellDownload {
+        width: 23%;
+    }
+
+    .tableHeaderCellRemove {
+        padding-left: 0px;
+    }
+}
+
+@media (max-width: 1008px) {
+    .left-panel {
+        margin-left: 0;
+    }
+
+    .main-panel {
+        left: -1%;
+        padding: 48px 26px 24px;
+    }
+}
+
+@media (max-width: 769px) and (min-width: 593px) {
+    .contentCells-icon{
+        width: 5%;
+    }
+    .tableRow {
+        width: 55%;
+    }
+
+    .tableRow td:first-child {
+        border: none;
+        flex-grow: 1;
+        width: 100%;
+        max-width: 100%;
+    }
+
+    .tableHeader {
+        display: none;
+    }
+
+    .scroll-table-body {
+        top: 31px;
+    }
+
+    footer {
+        height: 80px;
+    }
+
+    .main {
+        height: calc(100% - 128px); 
+    }
+
+    .main-panel {
+        left: 0;
+        padding: 48px 18px 24px;
+    }
+
+    footer table td {
+        margin-left: 0;
+        margin-right: 0;
+        padding-right: 4px;
+        padding-left: 4px;
+    }
+
+    .copy {
+        margin:auto;
+        padding-right: 3%;
+    }
+
+    footer table tr td:first-child {
+        margin-left: auto;
+        padding-left: 1%;
+        margin-right: 1.5%;
+    }
+
+    .contentCells-shift {
+        padding-right: 22px;
+    }
+}
+
+@media (max-width: 715px) {
+    .tableRow {
+        width: 45%;
+    }
+}
+@media (max-width: 670px) and (min-width: 620px){
+    .main-panel{
+        width: 90%;
+    }
+}
+@media (max-width: 681px) and (min-width: 593px) {
+
+    .left-panel {
+        width: 10%;
+    }
+
+    .main-panel {
+        left: 2%;
+        padding: 48px 0 24px;
+    }
+
+    .help-block {
+        margin: 48px 20px 24px;
+    }
+    .file-upload{
+        width: 100%;
+    }
+    #fileupload{
+        width: 100%;
+    }
+}
+
+@media (max-width: 1080px) and (min-width: 970px) {
+    .tableHeader {
+        width: 90%;
+    }
+
+    .tableRow td:first-child {
+        flex-grow: 0;
+        width: 15%;
+    }
+
+    .tableHeaderCellFileName {
+        width: 16%;
+    }
+
+    .tableHeaderCellEditors {
+        width: 13%;
+    }
+
+    .tableHeaderCellViewers {
+        text-align: right;
+        width: 37%;
+    }
+
+    .tableHeaderCellDownload {
+        padding-right: 22px;
+        width: 22%;
+    }
+}
+
+@media (max-width: 986px) and (min-width: 890px) {
+    .tableHeader {
+        width: 75%;
+    }
+
+    .tableHeaderCellEditors {
+        width: 26%;
+        text-align: left;
+    }
+
+    .tableHeaderCellFileName {
+        width: 17%;
+    }
+
+    .tableHeaderCellViewers {
+        width: 27%;
+        text-align: right;
+    }
+
+    .tableHeaderCellDownload {
+        padding-right: 18px;
+        width: 20%;
+    }
+
+    .tableHeaderCellRemove {
+        padding-left: 0;
+    }
+
+    .tableRow {
+        width: 75%;
+    }
+
+    .tableRow td:last-child {
+        padding-right: 38px;
+    }
+
+    .tableRow td:first-child {
+        flex-grow: 0;
+        width: 15%;
+    }
+
+    .contentCells-icon {
+        width: 3%;
+    }
+}
+
+@media (max-width: 890px) and (min-width: 769px ) {
+    .left-panel{
+        width: 20%;
+    }
+    .contentCells-shift {
+        padding-right: 28px;
+    }
+
+    .main-panel {
+        width: 580px;
+    }
+
+    .tableRow {
+        width: 95%;
+    }
+
+    .tableHeader {
+        width: 95%;
+    }
+
+    .tableHeaderCellViewers {
+        width: 22%;
+        text-align: right;
+    }
+
+    .tableHeaderCellDownload {
+        padding-right: 4px;
+        width: 20%;
+        text-align: right;
+    }
+
+    .tableHeaderCellFileName {
+        width: 20%;
+    }
+
+    .tableHeaderCellEditors {
+        text-align: left;
+        width: 31%;
+    }
+
+    .tableHeaderCellViewers {
+        width: 18%;
+    }
+}
+
+@media (max-width: 890px) {
+    .tableRow td:first-child {
+        max-width: 17%;
+    }
+    #portal-info {
+        max-width: 60vw;
+    }
+}
+
+.downloadContentCellShift:after {
+    bottom: 0;
+    left: 0;
+    content: "";
+    background: #e5e5e5;
+    height: 1px;
+    position: absolute;
+    width: 100%;
+}
+
+@media (max-width: 769px) {
+    .tableRow td:first-child {
+        max-width: 100%;
+    }
+}
+
+
+@media (max-width: 593px ) {
+    #portal-info {
+        width: 50vw;
+    }
+    .file-upload{
+        width: 100%;
+    }
+    #fileupload{
+        width: 100%;
+    }
+    .tableHeader {
+        display: none;
+    }
+
+    .scroll-table-body {
+        top: 31px;
+    }
+
+    footer table tr {
+        justify-content: center;
+    }
+
+    footer table td {
+        padding-top: 16px;
+        padding-right: 32px;
+        padding-left: 32px;
+    }
+
+    footer {
+        height: 80px;
+    }
+
+    .main {
+        height: calc(100% - 128px); 
+    }
+    
+    .copy {
+        width: 100%;
+        text-align: center;
+        margin: 0;
+    }
+
+    .left-panel {
+        width: 10%;
+    }
+
+    .help-block {
+        margin: 16px 10px 6px;
+    }
+
+    .main-panel {
+        left: 2%;
+        padding: 16px 0 6px;
+    }
+
+    .tableRow {
+        width: 40%;
+    }
+
+    .tableRow td {
+        border: none;
+    }
+
+    .firstContentCellShift {
+        border: none;
+        flex-basis: 10%;
+        flex-grow: 1;
+    }
+
+    .downloadContentCellShift {
+        max-width: 7%;
+        margin-right: -11px;
+        margin-left: auto;
+    }
+
+    .contentCells-icon {
+        width: 13%;
+    }
+
+    .tableRow td:last-child {
+        width: 12%;
+        padding-right: 40px;
+        border: none;
+    }
+
+    .contentCells-shift {
+        padding-right: 35px;
+    }
+
+    .downloadContentCellShift:after {
+        width: 85%;
+    }
+
+    .firstContentCellViewers {
+        margin-left: 0;
+        border-bottom: 1px solid #e5e5e5 !important;
+    }
+
+    .firstContentCellViewers ~ td {
+        border-bottom: 1px solid #e5e5e5;
+    }
+    .tableRow td:first-child{
+        border: none;
+        width: 85%;
+    }
+    .contentCellsEmpty{
+        display: none;
+        width: 1%;
+    }
+    /* Mobile Upload*/
+    .blockUI.blockMsg.blockPage.ui-dialog.ui-widget.ui-corner-all.ui-widget-content.ui-draggable {
+        width: 344px !important;
+        box-shadow: 0px 7px 15px rgba(85, 85, 85, 0.1);
+        border-radius: 2px;
+        top: 10% !important;
+        margin-left: -172px !important;
+    }
+
+    .ui-dialog .ui-dialog-titlebar {
+        padding: 0;
+    }
+    .ui-dialog .ui-dialog-content {
+        padding: 0 !important;
+    }
+    #mainProgress {
+        margin: 24px 16px 0 !important;
+    }
+    .blockTitle {
+        padding: 10px 10px 6px 16px !important;
+        font-size: 14px !important;
+    }
+    #mainProgress .describeUpload {
+        padding: 8px 0 !important;
+    }
+    .dialog-close {
+        margin: 0 !important;
+    }
+    .step-descr{
+        line-height: 150%;
+    }
+    .step {
+        line-height: 160%;
+    }
+    .buttonsMobile{
+        display: flex;
+        flex-direction: row;
+        flex-wrap: wrap;
+        justify-content: space-between;
+        align-items: center;
+    }
+    .button.gray{
+        margin: 0;
+    }
+    .button, .button:hover{
+        display: flex;
+        justify-content: center;
+        padding: 0 !important;
+        width: 144px;
+        height: 56px;
+        margin-bottom: 24px !important;
+    }
+}
+
+@media (max-width: 560px) and (min-width: 510px) {
+    .contentCells-icon {
+        width: 13%;
+    }
+
+    .downloadContentCellShift {
+        padding-right: 45px;
+        max-width: 4%;
+    }
+}
+
+@media (max-width: 510px)  and (min-width: 470px) {
+    .tableRow {
+        width: 35%;
+    }
+
+    .tableRow td:first-child{
+        width: 83%;
+    }
+    .contentCells-icon {
+        width: 13%;
+    }
+
+    .downloadContentCellShift {
+        max-width: 6%;
+        padding-right: 37px;
+    }
+
+    .firstContentCellShift {
+        flex-basis: 9%;
+    }
+
+    .tableRow td:last-child {
+        padding-right: 28px;
+    }
+}
+
+@media (max-width: 470px)  and (min-width: 420px) {
+    .tableRow {
+        width: 30%;
+    }
+    .tableRow td:first-child{
+        width: 85%;
+    }
+    .contentCells-icon {
+        width: 11%;
+    }
+
+    .downloadContentCellShift {
+        max-width: 3%;
+        padding-right: 37px;
+        padding-left: 0;
+    }
+
+    .firstContentCellShift {
+        margin-left: 1px;
+        flex-basis: 14%;
+    }
+
+    .tableRow td:last-child {
+        width: 5%;
+        padding-right: 63px;
+    }
+    .firstContentCellViewers{
+        padding-right: 2px;
+        width: 12%;
+    }
+    .contentCellsEmpty{
+        display: none;
+    }
+}
+
+@media (max-width: 420px) and (min-width: 320px) {
+    .tableRow {
+        width: 25%;
+    }
+
+    .tableRow td:last-child {
+        width: 6%;
+        padding-right: 16px;
+    }
+
+    .downloadContentCellShift {
+        max-width: 4%;
+        margin-right: -18px;
+        margin-left: -1px;
+    }
+
+    .firstContentCellShift {
+        flex-basis: 2%;
+    }
+
+    .contentCells-icon{
+        width: 10%;
+    }
+    footer table td {
+        margin: 0;
+        padding-right: 5px;
+        padding-left: 5px;
+    }
+
+    .copy {
+        padding-right: 5px;
+        margin: 0;
+    }
+    .firstContentCellViewers{
+        padding-right: 2px;
+        width: 11%;
+    }
+}
+
+@media (max-width: 1160px) {
+    .left-panel {
+        margin-left: 0;
+    }
+}
+
+@media (min-width: 593px) {
+    .contentCellsEmpty {
+        display: none;
+    }
+}
+@media (max-width: 769px) and (min-width: 715px){
+    .tableRow{
+        width: 50%;
+    }
+}
+@media (max-width: 510px) {
+    .tableRow td:first-child{
+        flex-grow: 0;
+    }
+}
+@media (max-width: 1100px) and (min-width: 890px){
+    .main-panel > span{
+        max-width: 70%;
+    }
+}
+@media (max-width: 780px) and (min-width: 600px) {
+    .main-panel{
+        display: flex;
+        flex-direction: column;
+    }
+    .main-panel > span{
+        max-width: 45%;
+    }
+}
+@media (max-width: 600px) and (min-width: 320px) {
+    .main-panel{
+        display: flex;
+        flex-direction: column;
+    }
+}
+@media (max-width:600px) and (min-width:500px){
+    .main-panel > span{
+        max-width:35%;
+    }
+}
+@media (max-width:500px) and (min-width:400px){
+    .main-panel > span{
+        max-width:20%;
+    }
+}
+@media (max-width:400px) and (min-width:320px){
+    .main-panel > span{
+        max-width:15%;
+    }
+}

web/documentserver-example/csharp-mvc/Content/stylesheet.css

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -22,6 +22,7 @@
 }
 
 body {
+    display: block;
     background: #FFFFFF;
     color: #333333;
     font-family: Open Sans;
@@ -30,8 +31,10 @@ body {
     font-weight: normal;
     height: 100%;
     margin: 0;
+    overflow-y: overlay;
     padding: 0;
     text-decoration: none;
+    overflow-x:hidden;
 }
 
 form {
@@ -52,30 +55,32 @@ a:visited {
 
 header {
     background: #333333;
-    height: 72px;
+    height: 48px;
     margin: 0 auto;
     min-width: 1152px;
     width: auto;
 }
 
 header img {
-    margin: 22px 0 22px 32px;
+    margin: 10px 0 22px 32px;
 }
 
 .center {
+    position:relative;
     margin: 0 auto 0;
     width: 1152px;
 }
 
 .main {
-    height: calc(100% - 136px);
-    min-height: 549px;
+    display: table;
+    height: calc(100% - 112px);
+    min-height: 536px;
 }
 
 .table-main {
     border-spacing: 0;
     height: 100%;
-    min-height: 549px;
+    min-height: 536px;
 }
 
 .section {
@@ -89,11 +94,15 @@ header img {
     -moz-box-sizing: border-box;
     height: 100%;
     list-style: none;
-    padding: 48px 32px;
+    padding: 48px 32px 24px;
     position: relative;
     width: 896px;
 }
 
+#portal-info {
+    max-width: 65vw;
+}
+
 .portal-name {
     color: #FF6F3D;
     font-size: 24px;
@@ -154,7 +163,11 @@ label .checkbox {
     background-image: url("images/file_pptx.svg");
 }
 
-.create-sample {
+.try-editor.form {
+    background-image: url("images/file_docxf.svg");
+}
+
+.side-option {
     color: #666666;
     line-height: 24px;
 }
@@ -185,19 +198,19 @@ label .checkbox {
     -webkit-user-select: none;
 }
 
-#beginEdit {
+.button.orange {
     background: #FF6F3D;
     border: 1px solid #FF6F3D;
     color: #FFFFFF;
 }
 
-#beginEdit.disable {
+.button.orange.disable {
     background: #EDC2B3;
     border: 1px solid #EDC2B3;
     cursor: default;
 }
 
-#beginEdit:not(.disable):hover {
+.button.orange:not(.disable):hover {
     background: #ff7a4b;
 }
 
@@ -353,19 +366,33 @@ footer {
     background: #333333;
     color: #AAAAAA;
     height: 64px;
-    min-width: 1152px;
-    width: auto;
+    width: 100%;
+	position: relative;
+	left: 0;
+	bottom: 0;
+}
+footer > .center {
+    width: 100%;
 }
-
 footer table {
+    width:100%;
     border-spacing: 0;
 }
 
 footer table tr {
+    position: relative;
+    display: flex;
+    flex-direction: row;
+    align-items: center;
+    align-content: center;
+    flex-wrap: wrap;
+    width: 100vw;
     height: 64px;
 }
 
 footer table td {
+	display: block;
+    position:relative;
     padding-left: 32px;
 }
 
@@ -380,13 +407,19 @@ footer a:visited {
 footer a:hover {
     text-decoration: none;
 }
-
+footer table tr td:first-child {
+    margin-left: 14%;
+}
 .copy {
-    padding-left: 510px;
+    color:#aaaaaa;
+    width:max-content;
+    position:relative;
+    margin-left:auto;
+    margin-right:14%;
 }
 
 .help-block {
-    margin: 48px 32px;
+    margin: 48px 32px 24px;
 }
 
 .help-block span {
@@ -539,6 +572,7 @@ footer a:hover {
 }
 
 .contentCells {
+	display: block;
     border-bottom: 1px solid #EFEFEF;
     font-family: 'Open Sans', sans-serif;
     font-size: 16px;
@@ -568,34 +602,12 @@ footer a:hover {
 
 .info {
     cursor: pointer;
-    padding: 3px 5px;
-    position: absolute;
-}
-
-.tooltip {
-    background: #FFFFFF;
-    border-radius: 5px;
-    box-shadow: 0px 7px 25px rgba(85, 85, 85, 0.15);
-    color: #666666;
-    line-height: 160%;
-    max-width: 312px;
-    padding: 14px;
-    position: absolute;
-}
-
-.arrow {
-    border-top: 8px solid transparent;
-    border-bottom: 8px solid transparent;
-    border-right: 8px solid #FFFFFF;
-    left: -4px;
-    position: absolute;
-    top: 50%;
-    transform: translate(-50%, -50%);
+    margin: -2px 5px;
 }
 
 .user-block-table {
     height: 100%;
-    padding: 14px 0;
+    padding-top: 14px;
     width: 100%;
 }
 
@@ -609,13 +621,9 @@ footer a:hover {
     box-sizing: border-box;
     border-radius: 3px;
     cursor: pointer;
-}
-
-#user,
-#language {
-    width: 100%;
     margin-top: 5px;
-    padding-left: 5px;
+    padding: 2px 5px;
+    width: 100%;
 }
 
 .icon-delete {
@@ -646,4 +654,114 @@ footer a:hover {
 .scroll-table-body::-webkit-scrollbar-thumb {
     background: #D0D5DA;
     border-radius: 3px;
-}
+}
+
+.descrFilePass {
+    display: block;
+    font-weight: bold;
+    line-height: 167%;
+}
+
+#filePass {
+    border: 1px solid #D0D5DA;
+    border-radius: 3px;
+    box-sizing: border-box;
+    display: inline-block;
+    height: 33px;
+    letter-spacing: -0.02em;
+    line-height: 150%;
+    margin-right: 8px;
+    outline: none;
+    padding: 7px 8px;
+    vertical-align: bottom;
+    user-select: none;
+    -moz-user-select: none;
+    -webkit-user-select: none;
+    width: 250px;
+}
+
+.errorInput {
+    border-color: #CB0000 !important;
+}
+
+.errorPass {
+    color: #CB0000;
+    display: block;
+    line-height: 160%;
+    letter-spacing: -0.02em;
+    word-wrap: break-word;
+}
+
+html {
+    overflow-x: hidden;
+}
+
+
+.tableRow {
+    width: 100%;
+    display: flex;
+    flex-wrap: wrap;
+    flex-direction: row;
+    position: relative;
+}
+
+
+    .tableRow td:first-child {
+        display: flex;
+        flex-grow: 1;
+        max-width: 25%;
+    }
+
+.tableHeaderCellFileName {
+    width: 30%;
+}
+
+.tableHeaderCellEditors {
+    width: 28%;
+}
+
+.tableHeaderCellViewers {
+    text-align: center;
+    width: 18%
+}
+
+.firstContentCellViewers {
+    margin-left: auto;
+}
+
+.user-descr {
+    display: inline-table;
+    width: 30vw;
+    min-width: 200px;
+    max-width: 400px;
+    margin-top: 20px;
+}
+
+.user-descr > b {
+    margin-left: 25px;
+}
+
+.tooltip {
+    background: #FFFFFF;
+    border-radius: 5px;
+    box-shadow: 0px 7px 25px rgba(85, 85, 85, 0.15);
+    color: #666666;
+    line-height: 160%;
+    max-width: 455px;
+    padding: 14px;
+    position: absolute;
+}
+
+.tooltip ul {
+    margin: 0;
+}
+
+.arrow {
+    border-top: 8px solid transparent;
+    border-bottom: 8px solid transparent;
+    border-right: 8px solid #FFFFFF;
+    left: -4px;
+    position: absolute;
+    top: 50%;
+    transform: translate(-50%, -50%);
+}

web/documentserver-example/csharp-mvc/Controllers/HomeController.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -16,6 +16,7 @@
  *
  */
 
+using System;
 using System.IO;
 using System.Web.Mvc;
 using OnlineEditorsExampleMVC.Helpers;
@@ -30,22 +31,27 @@ namespace OnlineEditorsExampleMVC.Controllers
             return View();
         }
 
-        public ActionResult Editor(string fileName, string editorsMode, string editorsType)
+        // viewing file in the editor
+        public ActionResult Editor(string fileName, string editorsMode, string editorsType, string directUrl)
         {
             var file = new FileModel
             {
-                Mode = editorsMode,
-                Type = editorsType,
-                FileName = Path.GetFileName(fileName)
+                Mode = editorsMode,  // editor mode: edit or view
+                Type = editorsType,  // editor type: desktop, mobile, embedded
+                FileName = Path.GetFileName(fileName),  // file name
+                IsEnabledDirectUrl = directUrl != null ? Convert.ToBoolean(directUrl) : false
             };
 
             return View("Editor", file);
         }
 
+        // creating a sample document
         public ActionResult Sample(string fileExt, bool? sample)
         {
-            var fileName = DocManagerHelper.CreateDemo(fileExt, sample ?? false);
-            DocManagerHelper.CreateMeta(fileName, Request.Cookies.GetOrDefault("uid", ""), Request.Cookies.GetOrDefault("uname", ""));
+            var fileName = DocManagerHelper.CreateDemo(fileExt, sample ?? false);  // create a sample document
+            var id = Request.Cookies.GetOrDefault("uid", null);
+            var user = Users.getUser(id);
+            DocManagerHelper.CreateMeta(fileName, user.id, user.name);  // create meta information for the sample document
             Response.Redirect(Url.Action("Editor", "Home", new { fileName = fileName }));
             return null;
         }

web/documentserver-example/csharp-mvc/Global.asax.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/csharp-mvc/Helpers/DocManagerHelper.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -25,11 +25,13 @@ using System.Web;
 using System.Web.Configuration;
 using System.Web.Script.Serialization;
 using OnlineEditorsExampleMVC.Models;
+using System.Net;
 
 namespace OnlineEditorsExampleMVC.Helpers
 {
     public class DocManagerHelper
     {
+        // get max file size
         public static long MaxFileSize
         {
             get
@@ -40,49 +42,81 @@ namespace OnlineEditorsExampleMVC.Helpers
             }
         }
 
+        // get all the supported file extensions
         public static List<string> FileExts
         {
-            get { return ViewedExts.Concat(EditedExts).Concat(ConvertExts).ToList(); }
+            get { return ViewedExts.Concat(EditedExts).Concat(ConvertExts).Concat(FillFormExts).ToList(); }
         }
 
+        // get file extensions that can be viewed
         public static List<string> ViewedExts
         {
             get { return (WebConfigurationManager.AppSettings["files.docservice.viewed-docs"] ?? "").Split(new char[] { '|', ',' }, StringSplitOptions.RemoveEmptyEntries).ToList(); }
         }
 
+        public static List<string> FillFormExts
+        {
+            get { return (WebConfigurationManager.AppSettings["files.docservice.fillform-docs"] ?? "").Split(new char[] { '|', ',' }, StringSplitOptions.RemoveEmptyEntries).ToList(); }
+        }
+
+        // get file extensions that can be edited
         public static List<string> EditedExts
         {
             get { return (WebConfigurationManager.AppSettings["files.docservice.edited-docs"] ?? "").Split(new char[] { '|', ',' }, StringSplitOptions.RemoveEmptyEntries).ToList(); }
         }
 
+        // get file extensions that can be converted
         public static List<string> ConvertExts
         {
             get { return (WebConfigurationManager.AppSettings["files.docservice.convert-docs"] ?? "").Split(new char[] { '|', ',' }, StringSplitOptions.RemoveEmptyEntries).ToList(); }
         }
 
+        // get current user host address
         public static string CurUserHostAddress(string userAddress = null)
         {
             return Regex.Replace(userAddress ?? HttpContext.Current.Request.UserHostAddress, "[^0-9a-zA-Z.=]", "_");
         }
 
+        // get the storage path of the file
         public static string StoragePath(string fileName, string userAddress = null)
         {
-            var directory = HttpRuntime.AppDomainAppPath + CurUserHostAddress(userAddress) + "\\";
+            var directory = "";
+            if (!string.IsNullOrEmpty(WebConfigurationManager.AppSettings["storage-path"]) && Path.IsPathRooted(WebConfigurationManager.AppSettings["storage-path"]))
+            {
+                directory = WebConfigurationManager.AppSettings["storage-path"] + "\\";
+            }
+            else
+            {
+                directory = HttpRuntime.AppDomainAppPath + WebConfigurationManager.AppSettings["storage-path"] + CurUserHostAddress(userAddress) + "\\";
+            }
+            
             if (!Directory.Exists(directory))
             {
                 Directory.CreateDirectory(directory);
             }
-            return directory + Path.GetFileName(fileName);
+            return directory + (fileName.Contains("\\") ? fileName : Path.GetFileName(fileName));
         }
 
+        // get the path to the forcesaved file version
         public static string ForcesavePath(string fileName, string userAddress, Boolean create)
         {
-            var directory = HttpRuntime.AppDomainAppPath + CurUserHostAddress(userAddress) + "\\";
+            // create the directory to this file version
+            var directory = "";
+            if (!string.IsNullOrEmpty(WebConfigurationManager.AppSettings["storage-path"]) && Path.IsPathRooted(WebConfigurationManager.AppSettings["storage-path"]))
+            {
+                directory = WebConfigurationManager.AppSettings["storage-path"] + "\\";
+            }
+            else
+            {
+                directory = HttpRuntime.AppDomainAppPath + WebConfigurationManager.AppSettings["storage-path"] + CurUserHostAddress(userAddress) + "\\";
+            }
+            
             if (!Directory.Exists(directory))
             {
                 return "";
             }
 
+            // create the directory to the history of this file version
             directory = directory + Path.GetFileName(fileName) + "-hist" + "\\";
             if (!Directory.Exists(directory))
             {
@@ -96,6 +130,7 @@ namespace OnlineEditorsExampleMVC.Helpers
                 }
             }
 
+            // get the path to the given file
             directory = directory + Path.GetFileName(fileName);
             if (!File.Exists(directory))
             {
@@ -108,85 +143,107 @@ namespace OnlineEditorsExampleMVC.Helpers
             return directory;
         }
 
+        // get the history directory
         public static string HistoryDir(string storagePath)
         {
             return storagePath += "-hist";
         }
 
+        // get the path to the file version by the history path and file version
         public static string VersionDir(string histPath, int version)
         {
             return Path.Combine(histPath, version.ToString());
         }
 
+        // get the path to the file version by the file name, user address and file version
         public static string VersionDir(string fileName, string userAddress, int version)
         {
             return VersionDir(HistoryDir(StoragePath(fileName, userAddress)), version);
         }
 
+        // get the file version by the history path
         public static int GetFileVersion(string historyPath)
         {
-            if (!Directory.Exists(historyPath)) return 0;
-            return Directory.EnumerateDirectories(historyPath).Count() + 1;
+            if (!Directory.Exists(historyPath)) return 1;  // if the history path doesn't exist, then the file version is 1
+            return Directory.EnumerateDirectories(historyPath).Count() + 1;  // take only directories from the history folder and count them
         }
 
+        // get the file version by the file name and user address
         public static int GetFileVersion(string fileName, string userAddress)
         {
             return GetFileVersion(HistoryDir(StoragePath(fileName, userAddress)));
         }
 
+        // get a file name with an index if the file with such a name already exists
         public static string GetCorrectName(string fileName, string userAddress = null)
         {
             var baseName = Path.GetFileNameWithoutExtension(fileName);
             var ext = Path.GetExtension(fileName).ToLower();
             var name = baseName + ext;
 
-            for (var i = 1; File.Exists(StoragePath(name, userAddress)); i++)
+            for (var i = 1; File.Exists(StoragePath(name, userAddress)); i++)  // run through all the files with such a name in the storage directory
             {
-                name = baseName + " (" + i + ")" + ext;
+                name = baseName + " (" + i + ")" + ext;  // and add an index to the base name
             }
             return name;
         }
 
+        // get all the stored files from the user host address
         public static List<FileInfo> GetStoredFiles()
         {
-            var directory = HttpRuntime.AppDomainAppPath + WebConfigurationManager.AppSettings["storage-path"] + CurUserHostAddress(null) + "\\";
+            var directory = "";
+            if (!string.IsNullOrEmpty(WebConfigurationManager.AppSettings["storage-path"]) && Path.IsPathRooted(WebConfigurationManager.AppSettings["storage-path"]))
+            {
+                directory = WebConfigurationManager.AppSettings["storage-path"] + "\\";
+            }
+            else
+            {
+                directory = HttpRuntime.AppDomainAppPath + WebConfigurationManager.AppSettings["storage-path"] + CurUserHostAddress(null) + "\\";
+            }
+            
             if (!Directory.Exists(directory)) return new List<FileInfo>();
 
             var directoryInfo = new DirectoryInfo(directory);
 
+            // take files from the root directory
             List<FileInfo> storedFiles = directoryInfo.GetFiles("*.*", SearchOption.TopDirectoryOnly).ToList();
 
             return storedFiles;
         }
 
+        // create demo document
         public static string CreateDemo(string fileExt, bool withContent)
         {
-            var demoName = (withContent ? "sample." : "new.") + fileExt;
-            var demoPath = "assets\\" + (withContent ? "sample\\" : "new\\");
+            var demoName = (withContent ? "sample." : "new.") + fileExt;  // create sample or new template file with the necessary extension
+            var demoPath = "assets\\" + (withContent ? "sample\\" : "new\\");  // get the path to the sample document
 
-            var fileName = GetCorrectName(demoName);
+            var fileName = GetCorrectName(demoName);  // get a file name with an index if the file with such a name already exists
 
-            File.Copy(HttpRuntime.AppDomainAppPath + demoPath + demoName, StoragePath(fileName)); 
+            File.Copy(HttpRuntime.AppDomainAppPath + demoPath + demoName, StoragePath(fileName));  // copy file to the storage directory
 
             return fileName;
         }
 
+        // create meta information
         public static void CreateMeta(string fileName, string uid, string uname, string userAddress = null)
         {
-            var histDir = HistoryDir(StoragePath(fileName, userAddress));
+            var histDir = HistoryDir(StoragePath(fileName, userAddress));  // create history directory
             Directory.CreateDirectory(histDir);
+            // create createdInfo.json file with meta information in the history directory (creation time, user id and name)
             File.WriteAllText(Path.Combine(histDir, "createdInfo.json"), new JavaScriptSerializer().Serialize(new Dictionary<string, object> {
                 { "created", DateTime.Now.ToString("yyyy'-'MM'-'dd HH':'mm':'ss") },
-                { "id", string.IsNullOrEmpty(uid) ? "uid-1" : uid },
-                { "name", string.IsNullOrEmpty(uname) ? "John Smith" : uname }
+                { "id", uid },
+                { "name", uname }
             }));
         }
 
+        // get file url
         public static string GetFileUri(string fileName, Boolean forDocumentServer)
         {
             var uri = new UriBuilder(GetServerUrl(forDocumentServer))
                 {
-                    Path = HttpRuntime.AppDomainAppVirtualPath + "/"
+                    Path = HttpRuntime.AppDomainAppVirtualPath
+                           + (HttpRuntime.AppDomainAppVirtualPath.EndsWith("/") ? "" : "/")
                            + CurUserHostAddress() + "/"
                            + fileName,
                     Query = ""
@@ -195,18 +252,19 @@ namespace OnlineEditorsExampleMVC.Helpers
             return uri.ToString();
         }
 
+        // get the path url
         public static string GetPathUri(string path)
         {
             var uri = new UriBuilder(GetServerUrl(true))
             {
-                Path = HttpRuntime.AppDomainAppVirtualPath + "/"
-                           + path,
+                Path = HttpRuntime.AppDomainAppVirtualPath + "/" + path,
                 Query = ""
             };
 
             return uri.ToString();
         }
 
+        // get the server url
         public static string GetServerUrl(Boolean forDocumentServer)
         {
             if (forDocumentServer && !WebConfigurationManager.AppSettings["files.docservice.url.example"].Equals(""))
@@ -224,6 +282,7 @@ namespace OnlineEditorsExampleMVC.Helpers
             }
         }
 
+        // get the callback url
         public static string GetCallback(string fileName)
         {
             var callbackUrl = new UriBuilder(GetServerUrl(true))
@@ -234,32 +293,108 @@ namespace OnlineEditorsExampleMVC.Helpers
                     + "webeditor.ashx",
                 Query = "type=track"
                         + "&fileName=" + HttpUtility.UrlEncode(fileName)
-                        + "&userAddress=" + HttpUtility.UrlEncode(HttpContext.Current.Request.UserHostAddress)
+                        + "&userAddress=" + HttpUtility.UrlEncode(CurUserHostAddress(HttpContext.Current.Request.UserHostAddress))
             };
             return callbackUrl.ToString();
         }
 
+        // get url to the created file
+        public static string GetCreateUrl(FileUtility.FileType fileType)
+        {
+            var createUrl = new UriBuilder(GetServerUrl(false))
+            {
+                Path =
+                    HttpRuntime.AppDomainAppVirtualPath
+                    + (HttpRuntime.AppDomainAppVirtualPath.EndsWith("/") ? "" : "/")
+                    + "Sample",
+                Query = "fileExt=" + DocManagerHelper.GetInternalExtension(fileType).Trim('.')
+            };
+            return createUrl.ToString();
+        }
+
+        // create the public history url
+        public static string GetHistoryDownloadUrl(string filename, string version, string file, Boolean isServer = true)
+        {
+            var userAddress = "&userAddress=" + HttpUtility.UrlEncode(CurUserHostAddress(HttpContext.Current.Request.UserHostAddress));
+            var downloadUrl = new UriBuilder(GetServerUrl(isServer))
+            {
+                Path =
+                    HttpRuntime.AppDomainAppVirtualPath
+                    + (HttpRuntime.AppDomainAppVirtualPath.EndsWith("/") ? "" : "/")
+                    + "webeditor.ashx",
+                Query = "type=downloadhistory"
+                        + "&fileName=" + HttpUtility.UrlEncode(filename)
+                        + userAddress
+                        + "&ver=" + version
+                        + "&file="+ file
+            };
+            return downloadUrl.ToString();
+        }
+
+        // get url to download a file
+        public static string GetDownloadUrl(string fileName, Boolean isServer = true)
+        {
+            var userAddress = isServer ? "&userAddress=" + HttpUtility.UrlEncode(CurUserHostAddress(HttpContext.Current.Request.UserHostAddress)) : "";
+            var downloadUrl = new UriBuilder(GetServerUrl(isServer))
+            {
+                Path =
+                    HttpRuntime.AppDomainAppVirtualPath
+                    + (HttpRuntime.AppDomainAppVirtualPath.EndsWith("/") ? "" : "/")
+                    + "webeditor.ashx",
+                Query = "type=download"
+                        + "&fileName=" + HttpUtility.UrlEncode(fileName)
+                        + userAddress
+            };
+            return downloadUrl.ToString();
+        }
+
+        // get an editor internal extension
         public static string GetInternalExtension(FileUtility.FileType fileType)
         {
             switch (fileType)
             {
-                case FileUtility.FileType.Word:
+                case FileUtility.FileType.Word:  // .docx for word file type
                     return ".docx";
-                case FileUtility.FileType.Cell:
+                case FileUtility.FileType.Cell:  // .xlsx for cell file type
                     return ".xlsx";
-                case FileUtility.FileType.Slide:
+                case FileUtility.FileType.Slide:  // .pptx for slide file type
                     return ".pptx";
                 default:
-                    return ".docx";
+                    return ".docx";  // the default file type is .docx
             }
         }
 
+        // get image url for templates
+        public static string GetTemplateImageUrl(FileUtility.FileType fileType)
+        {
+            var path = new UriBuilder(GetServerUrl(true)) // templates image url in the "From Template" section
+            {
+                Path = HttpRuntime.AppDomainAppVirtualPath
+                    + (HttpRuntime.AppDomainAppVirtualPath.EndsWith("/") ? "" : "/")
+                    + "Content\\images\\"
+            };
+            switch (fileType)
+            {
+                case FileUtility.FileType.Word:  // for word file type
+                    return path + "file_docx.svg";
+                case FileUtility.FileType.Cell:  // for cell file type
+                    return path + "file_xlsx.svg";
+                case FileUtility.FileType.Slide:  // for slide file type
+                    return path + "file_pptx.svg";
+                default:
+                    return path + "file_docx.svg";  // the default value
+            }
+        }
+
+        // get file information
         public static List<Dictionary<string, object>> GetFilesInfo(string fileId = null)
         {
             var files = new List<Dictionary<string, object>>();
 
+            // run through all the stored files
             foreach (var file in GetStoredFiles())
             {
+                // write all the parameters to the map
                 var dictionary = new Dictionary<string, object>();
                 dictionary.Add("version", GetFileVersion(file.Name, null));
                 dictionary.Add("id", ServiceConverter.GenerateRevisionId(DocManagerHelper.CurUserHostAddress() + "/" + file.Name + "/" + File.GetLastWriteTime(DocManagerHelper.StoragePath(file.Name, null)).GetHashCode()));
@@ -268,6 +403,7 @@ namespace OnlineEditorsExampleMVC.Helpers
                 dictionary.Add("title", file.Name);
                 dictionary.Add("updated", file.LastWriteTime.ToString());
 
+                // get file information by its id
                 if (fileId != null) 
                 {
                     if (fileId.Equals(dictionary["id"]))
@@ -284,5 +420,33 @@ namespace OnlineEditorsExampleMVC.Helpers
 
             return files;
         }
+
+        // enable certificate ignore
+        public static void VerifySSL()
+        {
+            // hack. http://ubuntuforums.org/showthread.php?t=1841740
+            if(WebConfigurationManager.AppSettings["files.docservice.verify-peer-off"].Equals("true")) {
+                ServicePointManager.ServerCertificateValidationCallback += (s, ce, ca, p) => true;
+                ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls12 | SecurityProtocolType.Tls11 | SecurityProtocolType.Tls;
+            }
+        }
+
+        public static Dictionary<string, string> GetLanguages()
+        {
+            var languages = new Dictionary<string, string>();
+            String[] couples = (WebConfigurationManager.AppSettings["files.docservice.languages"] ?? "").Split('|');
+            foreach (string couple in couples)
+            {   
+                String[] tmp = couple.Split(':');
+                languages.Add(tmp[0],tmp[1]);
+            }
+            return languages;
+        }
+
+        public static string GetDirectUrl()
+        {
+            string isEnabledDirectUrl = HttpUtility.ParseQueryString(HttpContext.Current.Request.Url.Query).Get("directUrl");
+            return isEnabledDirectUrl != null ? isEnabledDirectUrl : "false";
+        }
     }
 }

web/documentserver-example/csharp-mvc/Helpers/DocumentConverter.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -69,7 +69,7 @@ namespace OnlineEditorsExampleMVC.Helpers
         /// <param name="documentRevisionId">Key for caching on service</param>
         /// <param name="isAsync">Perform conversions asynchronously</param>
         /// <param name="convertedDocumentUri">Uri to the converted document</param>
-        /// <returns>The percentage of completion of conversion</returns>
+        /// <returns>The percentage of conversion completion</returns>
         /// <example>
         /// string convertedDocumentUri;
         /// GetConvertedUri("http://helpcenter.onlyoffice.com/content/GettingStarted.pdf", ".pdf", ".docx", "http://helpcenter.onlyoffice.com/content/GettingStarted.pdf", false, out convertedDocumentUri);
@@ -81,45 +81,56 @@ namespace OnlineEditorsExampleMVC.Helpers
                                           string toExtension,
                                           string documentRevisionId,
                                           bool isAsync,
-                                          out string convertedDocumentUri)
+                                          out string convertedDocumentUri,
+                                          string filePass = null,
+                                          string lang = null)
         {
             convertedDocumentUri = string.Empty;
 
+            // check if the fromExtension parameter is defined; if not, get it from the document url
             fromExtension = string.IsNullOrEmpty(fromExtension) ? Path.GetExtension(documentUri).ToLower() : fromExtension;
 
+            // check if the file name parameter is defined; if not, get random uuid for this file
             var title = Path.GetFileName(documentUri);
             title = string.IsNullOrEmpty(title) ? Guid.NewGuid().ToString() : title;
 
+            // get document key
             documentRevisionId = string.IsNullOrEmpty(documentRevisionId)
                                      ? documentUri
                                      : documentRevisionId;
             documentRevisionId = GenerateRevisionId(documentRevisionId);
 
+            // specify request parameters
             var request = (HttpWebRequest)WebRequest.Create(DocumentConverterUrl);
             request.Method = "POST";
             request.ContentType = "application/json";
             request.Accept = "application/json";
             request.Timeout = ConvertTimeout;
 
+            // write all the necessary parameters to the body object
             var body = new Dictionary<string, object>() {
                 { "async", isAsync },
                 { "filetype", fromExtension.Trim('.') },
                 { "key", documentRevisionId },
                 { "outputtype", toExtension.Trim('.') },
                 { "title", title },
-                { "url", documentUri }
+                { "url", documentUri },
+                { "password", filePass },
+                { "region", lang }
             };
 
             if (JwtManager.Enabled)
             {
+                // create payload object
                 var payload = new Dictionary<string, object>
                     {
                         { "payload", body }
                     };
 
-                var payloadToken = JwtManager.Encode(payload);
-                var bodyToken = JwtManager.Encode(body);
-                string JWTheader = WebConfigurationManager.AppSettings["files.docservice.header"].Equals("") ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
+                var payloadToken = JwtManager.Encode(payload);  // encode the payload object to the payload token
+                var bodyToken = JwtManager.Encode(body);  // encode the body object to the body token
+                // create header token
+                string JWTheader = string.IsNullOrEmpty(WebConfigurationManager.AppSettings["files.docservice.header"]) ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
                 request.Headers.Add(JWTheader, "Bearer " + payloadToken);
 
                 body.Add("token", bodyToken);
@@ -127,20 +138,22 @@ namespace OnlineEditorsExampleMVC.Helpers
 
             var bytes = Encoding.UTF8.GetBytes(new JavaScriptSerializer().Serialize(body));
             request.ContentLength = bytes.Length;
-            using (var requestStream = request.GetRequestStream())
+            using (var requestStream = request.GetRequestStream())  // get the request stream
             {
-                requestStream.Write(bytes, 0, bytes.Length);
+                requestStream.Write(bytes, 0, bytes.Length);  // and write the serialized body object to it
             }
 
+            DocManagerHelper.VerifySSL();
+
             string dataResponse;
             using (var response = request.GetResponse())
-            using (var stream = response.GetResponseStream())
+            using (var stream = response.GetResponseStream())  // get the response stream
             {
                 if (stream == null) throw new Exception("Response is null");
 
                 using (var reader = new StreamReader(stream))
                 {
-                    dataResponse = reader.ReadToEnd();
+                    dataResponse = reader.ReadToEnd();  // and read it
                 }
             }
 
@@ -154,9 +167,10 @@ namespace OnlineEditorsExampleMVC.Helpers
         /// <returns>Supported key</returns>
         public static string GenerateRevisionId(string expectedKey)
         {
+            // if the expected key length is greater than 20, it is hashed and a fixed length value is stored in the string format 
             if (expectedKey.Length > 20) expectedKey = expectedKey.GetHashCode().ToString();
             var key = Regex.Replace(expectedKey, "[^0-9-.a-zA-Z_=]", "_");
-            return key.Substring(key.Length - Math.Min(key.Length, 20));
+            return key.Substring(key.Length - Math.Min(key.Length, 20));  // the resulting key length is 20 or less
         }
 
         #endregion
@@ -168,7 +182,7 @@ namespace OnlineEditorsExampleMVC.Helpers
         /// </summary>
         /// <param name="jsonDocumentResponse">The resulting json from editing service</param>
         /// <param name="responseUri">Uri to the converted document</param>
-        /// <returns>The percentage of completion of conversion</returns>
+        /// <returns>The percentage of conversion completion</returns>
         private static int GetResponseUri(string jsonDocumentResponse, out string responseUri)
         {
             if (string.IsNullOrEmpty(jsonDocumentResponse)) throw new ArgumentException("Invalid param", "jsonDocumentResponse");
@@ -176,21 +190,22 @@ namespace OnlineEditorsExampleMVC.Helpers
             var responseFromService = Json.Decode(jsonDocumentResponse);
             if (jsonDocumentResponse == null) throw new WebException("Invalid answer format");
 
-            var errorElement = responseFromService.error;
-            if (errorElement != null) ProcessResponseError(Convert.ToInt32(errorElement));
+            var errorElement = responseFromService.error;  // if an error occurs
+            if (errorElement != null) ProcessResponseError(Convert.ToInt32(errorElement));  // then get an error message
 
+            // check if the conversion is completed and save the result to a variable
             var isEndConvert = responseFromService.endConvert;
 
             int resultPercent;
             responseUri = string.Empty;
-            if (isEndConvert)
+            if (isEndConvert)  // if the conversion is completed
             {
-                responseUri = responseFromService.fileUrl;
+                responseUri = responseFromService.fileUrl;  // get the file url
                 resultPercent = 100;
             }
-            else
+            else  // if the conversion isn't completed
             {
-                resultPercent = responseFromService.percent;
+                resultPercent = responseFromService.percent;  // get the percentage value
                 if (resultPercent >= 100) resultPercent = 99;
             }
 
@@ -222,7 +237,7 @@ namespace OnlineEditorsExampleMVC.Helpers
                     break;
                 case -5:
                     // public const int c_nErrorUnexpectedGuid = -5;
-                    errorMessage = String.Format(errorMessageTemplate, "Error unexpected guid");
+                    errorMessage = String.Format(errorMessageTemplate, "Incorrect password");
                     break;
                 case -4:
                     // public const int c_nErrorDownloadError = -4;

web/documentserver-example/csharp-mvc/Helpers/JwtManager.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -16,12 +16,12 @@
  *
  */
 
-using System;
+using JWT;
+using JWT.Algorithms;
+using JWT.Builder;
+using JWT.Serializers;
 using System.Collections.Generic;
-using System.Security.Cryptography;
-using System.Text;
 using System.Web.Configuration;
-using System.Web.Script.Serialization;
 
 namespace OnlineEditorsExampleMVC.Helpers
 {
@@ -30,76 +30,31 @@ namespace OnlineEditorsExampleMVC.Helpers
         private static readonly string Secret;
         public static readonly bool Enabled;
 
-        private static readonly JavaScriptSerializer Serializer;
-
         static JwtManager()
         {
-            Secret = WebConfigurationManager.AppSettings["files.docservice.secret"] ?? "";
-            Enabled = !string.IsNullOrEmpty(Secret);
-            Serializer = new JavaScriptSerializer();
+            Secret = WebConfigurationManager.AppSettings["files.docservice.secret"] ?? "";  // get token secret from the config parameters
+            Enabled = !string.IsNullOrEmpty(Secret);  // check if the token is enabled
         }
 
+        // encode a payload object into a token using a secret key
         public static string Encode(IDictionary<string, object> payload)
         {
-            var header = new Dictionary<string, object>
-                {
-                    { "alg", "HS256" },
-                    { "typ", "JWT" }
-                };
-
-            var encHeader = Base64UrlEncode(Serializer.Serialize(header));
-            var encPayload = Base64UrlEncode(Serializer.Serialize(payload));
-            var hashSum = Base64UrlEncode(CalculateHash(encHeader, encPayload));
-
-            return string.Format("{0}.{1}.{2}", encHeader, encPayload, hashSum);
+            var encoder = new JwtEncoder(new HMACSHA256Algorithm(),
+                                         new JsonNetSerializer(),
+                                         new JwtBase64UrlEncoder());
+            return encoder.Encode(payload, Secret);
         }
 
+        // decode a token into a payload object using a secret key
         public static string Decode(string token)
         {
             if (!Enabled || string.IsNullOrEmpty(token)) return "";
 
-            var split = token.Split('.');
-            if (split.Length != 3) return "";
-
-            var hashSum = Base64UrlEncode(CalculateHash(split[0], split[1]));
-            if (hashSum != split[2]) return "";
-            return Base64UrlDecode(split[1]);
-        }
-
-        private static byte[] CalculateHash(string encHeader, string encPayload)
-        {
-            using (var hasher = new HMACSHA256(Encoding.UTF8.GetBytes(Secret)))
-            {
-                var bytes = Encoding.UTF8.GetBytes(string.Format("{0}.{1}", encHeader, encPayload));
-                return hasher.ComputeHash(bytes);
-            }
-        }
-
-        private static string Base64UrlEncode(string str)
-        {
-            return Base64UrlEncode(Encoding.UTF8.GetBytes(str));
-        }
-
-        private static string Base64UrlEncode(byte[] bytes)
-        {
-            return Convert.ToBase64String(bytes)
-                          .TrimEnd('=').Replace('+', '-').Replace('/', '_');
-        }
-
-        private static string Base64UrlDecode(string payload)
-        {
-            var b64 = payload.Replace('_', '/').Replace('-', '+');
-            switch (b64.Length%4)
-            {
-                case 2:
-                    b64 += "==";
-                    break;
-                case 3:
-                    b64 += "=";
-                    break;
-            }
-            var bytes = Convert.FromBase64String(b64);
-            return Encoding.UTF8.GetString(bytes);
+            return JwtBuilder.Create()
+                    .WithAlgorithm(new HMACSHA256Algorithm())
+                    .WithSecret(Secret)
+                    .MustVerifySignature()
+                    .Decode(token);
         }
     }
 }

web/documentserver-example/csharp-mvc/Helpers/TrackManager.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -30,11 +30,13 @@ namespace OnlineEditorsExampleMVC.Helpers
 {
     public class TrackManager
     {
+        // read request body
         public static Dictionary<string, object> readBody(HttpContext context)
         {
             string body;
             try
             {
+                // read request body by streams and check if it is correct
                 using (var receiveStream = context.Request.InputStream)
                 using (var readStream = new StreamReader(receiveStream))
                 {
@@ -50,29 +52,33 @@ namespace OnlineEditorsExampleMVC.Helpers
             var jss = new JavaScriptSerializer();
             var fileData = jss.Deserialize<Dictionary<string, object>>(body);
 
+            // check if the document token is enabled
             if (JwtManager.Enabled)
             {
-                string JWTheader = WebConfigurationManager.AppSettings["files.docservice.header"].Equals("") ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
+                string JWTheader = string.IsNullOrEmpty(WebConfigurationManager.AppSettings["files.docservice.header"]) ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
 
                 string token = null;
 
+                // if the document token is in the data
                 if (fileData.ContainsKey("token"))
                 {
-                    token = JwtManager.Decode(fileData["token"].ToString());
+                    token = JwtManager.Decode(fileData["token"].ToString());  // decode it
                 }
-                else if (context.Request.Headers.AllKeys.Contains(JWTheader, StringComparer.InvariantCultureIgnoreCase))
+                else if (context.Request.Headers.AllKeys.Contains(JWTheader, StringComparer.InvariantCultureIgnoreCase))  // if the Authorization header exists
                 {
                     var headerToken = context.Request.Headers.Get(JWTheader).Substring("Bearer ".Length);
-                    token = JwtManager.Decode(headerToken);
+                    token = JwtManager.Decode(headerToken);  // decode its part after Authorization prefix
                 }
-                else
+                else  // otherwise, an error occurs
                 {
                     context.Response.Write("{\"error\":1,\"message\":\"JWT expected\"}");
                 }
 
-                if (token != null && !token.Equals(""))
+                if (token != null && !token.Equals(""))  // invalid signature error
                 {
-                    fileData = (Dictionary<string, object>)jss.Deserialize<Dictionary<string, object>>(token)["payload"];
+                    fileData = jss.Deserialize<Dictionary<string, object>>(token);
+                    if (fileData.ContainsKey("payload"))
+                        fileData = (Dictionary<string, object>)fileData["payload"];
                 }
                 else
                 {
@@ -83,21 +89,30 @@ namespace OnlineEditorsExampleMVC.Helpers
             return fileData;
         }
 
+        // file saving process
         public static int processSave(Dictionary<string, object> fileData, string fileName, string userAddress)
         {
+            if (string.IsNullOrEmpty((string)fileData["url"])) {
+                throw new Exception("DownloadUrl is null");
+            }
             var downloadUri = (string)fileData["url"];
-            string curExt = Path.GetExtension(fileName).ToLower();
-            string downloadExt = Path.GetExtension(downloadUri).ToLower() ?? "";
+            string curExt = Path.GetExtension(fileName).ToLower();  // get current file extension
+
+            var downloadExt = "." + (string)fileData["filetype"]; // get the extension of the downloaded file
+
             var newFileName = fileName;
 
+            // convert downloaded file to the file with the current extension if these extensions aren't equal
             if (!curExt.Equals(downloadExt, StringComparison.InvariantCultureIgnoreCase))
             {
                 try
                 {
+                    // convert file and give url to a new file
                     string newFileUri;
                     var result = ServiceConverter.GetConvertedUri(downloadUri, downloadExt, curExt, ServiceConverter.GenerateRevisionId(downloadUri), false, out newFileUri);
                     if (string.IsNullOrEmpty(newFileUri))
                     {
+                        // get the correct file name if it already exists
                         newFileName = DocManagerHelper.GetCorrectName(Path.GetFileNameWithoutExtension(fileName) + downloadExt, userAddress);
                     }
                     else 
@@ -111,53 +126,75 @@ namespace OnlineEditorsExampleMVC.Helpers
                 }
             }
 
-            var storagePath = DocManagerHelper.StoragePath(newFileName, userAddress);
-            var histDir = DocManagerHelper.HistoryDir(storagePath);
-            if (!Directory.Exists(histDir)) Directory.CreateDirectory(histDir);
+            DocManagerHelper.VerifySSL();
 
-            var versionDir = DocManagerHelper.VersionDir(histDir, DocManagerHelper.GetFileVersion(histDir));
-            if (!Directory.Exists(versionDir)) Directory.CreateDirectory(versionDir);
-
-            File.Move(DocManagerHelper.StoragePath(fileName, userAddress), Path.Combine(versionDir, "prev" + curExt));
-
-            DownloadToFile(downloadUri, storagePath);
-            DownloadToFile((string)fileData["changesurl"], Path.Combine(versionDir, "diff.zip"));
-
-            var hist = fileData.ContainsKey("changeshistory") ? (string)fileData["changeshistory"] : null;
-            if (string.IsNullOrEmpty(hist) && fileData.ContainsKey("history"))
+            try
             {
-                var jss = new JavaScriptSerializer();
-                hist = jss.Serialize(fileData["history"]);
-            }
+                var bytesFile = DownloadFile(downloadUri); // download document file
+                var storagePath = DocManagerHelper.StoragePath(newFileName, userAddress);  // get the file path
 
-            if (!string.IsNullOrEmpty(hist))
+                var histDir = DocManagerHelper.HistoryDir(storagePath);  // get the path to the history directory
+                if (!Directory.Exists(histDir)) Directory.CreateDirectory(histDir);
+
+                var versionDir = DocManagerHelper.VersionDir(histDir, DocManagerHelper.GetFileVersion(histDir));  // get the path to the file version
+                if (!Directory.Exists(versionDir)) Directory.CreateDirectory(versionDir);  // if the path doesn't exist, create it
+
+                // get the path to the previous file version and move it to the storage directory
+                File.Move(DocManagerHelper.StoragePath(fileName, userAddress), Path.Combine(versionDir, "prev" + curExt));
+
+                SaveFile(bytesFile, storagePath);// save document file
+
+                byte[] bytesChanges = DownloadFile((string)fileData["changesurl"]); // download changes file
+                SaveFile(bytesChanges, Path.Combine(versionDir, "diff.zip")); // save file changes to the diff.zip archive
+
+                var hist = fileData.ContainsKey("changeshistory") ? (string)fileData["changeshistory"] : null;
+                if (string.IsNullOrEmpty(hist) && fileData.ContainsKey("history"))
+                {
+                    var jss = new JavaScriptSerializer();
+                    hist = jss.Serialize(fileData["history"]);
+                }
+
+                if (!string.IsNullOrEmpty(hist))
+                {
+                    File.WriteAllText(Path.Combine(versionDir, "changes.json"), hist);  // write the history changes to the changes.json file
+                }
+
+                File.WriteAllText(Path.Combine(versionDir, "key.txt"), (string)fileData["key"]);  // write the key value to the key.txt file
+
+                string forcesavePath = DocManagerHelper.ForcesavePath(newFileName, userAddress, false);  // get the path to the forcesaved file version
+                if (!forcesavePath.Equals(""))  // if the forcesaved file version exists
+                {
+                    File.Delete(forcesavePath);  // remove it
+                }
+
+            } catch (Exception)
             {
-                File.WriteAllText(Path.Combine(versionDir, "changes.json"), hist);
-            }
-
-            File.WriteAllText(Path.Combine(versionDir, "key.txt"), (string)fileData["key"]);
-
-            string forcesavePath = DocManagerHelper.ForcesavePath(newFileName, userAddress, false);
-            if (!forcesavePath.Equals(""))
-            {
-                File.Delete(forcesavePath);
+                return 1;
             }
 
             return 0;
         }
 
+        // file force saving process
         public static int processForceSave(Dictionary<string, object> fileData, string fileName, string userAddress)
         {
+            if ( string.IsNullOrEmpty((string)fileData["url"])) {
+                throw new Exception("DownloadUrl is null");
+            }
             var downloadUri = (string)fileData["url"];
 
-            string curExt = Path.GetExtension(fileName).ToLower();
-            string downloadExt = Path.GetExtension(downloadUri).ToLower();
+            string curExt = Path.GetExtension(fileName).ToLower();  // get current file extension
+
+            var downloadExt = "." + (string)fileData["filetype"];  // get the extension of the downloaded file
+
             Boolean newFileName = false;
 
+            // convert downloaded file to the file with the current extension if these extensions aren't equal
             if (!curExt.Equals(downloadExt))
             {
                 try
                 {
+                    // convert file and give url to a new file
                     string newFileUri;
                     var result = ServiceConverter.GetConvertedUri(downloadUri, downloadExt, curExt, ServiceConverter.GenerateRevisionId(downloadUri), false, out newFileUri);
                     if (string.IsNullOrEmpty(newFileUri))
@@ -175,49 +212,62 @@ namespace OnlineEditorsExampleMVC.Helpers
                 }
             }
 
-            string forcesavePath = "";
-            Boolean isSubmitForm = fileData["forcesavetype"].ToString().Equals("3");
+            DocManagerHelper.VerifySSL();
 
-            if (isSubmitForm)
+            try
             {
-                if (newFileName)
+                var bytesFile = DownloadFile(downloadUri); // download document file
+
+                string forcesavePath = "";
+                Boolean isSubmitForm = fileData["forcesavetype"].ToString().Equals("3");  // SubmitForm
+
+                if (isSubmitForm)  // if the form is submitted
                 {
-                    fileName = DocManagerHelper.GetCorrectName(Path.GetFileNameWithoutExtension(fileName) + "-form" + downloadExt, userAddress);
+                    if (newFileName)
+                    {
+                        fileName = DocManagerHelper.GetCorrectName(Path.GetFileNameWithoutExtension(fileName) + "-form" + downloadExt, userAddress);  // get the correct file name if it already exists
                 } else
-                {
-                    fileName = DocManagerHelper.GetCorrectName(Path.GetFileNameWithoutExtension(fileName) + "-form" + curExt, userAddress);
+                    {
+                        fileName = DocManagerHelper.GetCorrectName(Path.GetFileNameWithoutExtension(fileName) + "-form" + curExt, userAddress);
+                    }
+                    forcesavePath = DocManagerHelper.StoragePath(fileName, userAddress);
                 }
-                forcesavePath = DocManagerHelper.StoragePath(fileName, userAddress);
-            }
-            else
-            {
-                if (newFileName)
+                else
                 {
-                    fileName = DocManagerHelper.GetCorrectName(Path.GetFileNameWithoutExtension(fileName) + downloadExt, userAddress);
+                    if (newFileName)
+                    {
+                        fileName = DocManagerHelper.GetCorrectName(Path.GetFileNameWithoutExtension(fileName) + downloadExt, userAddress);
+                    }
+                    forcesavePath = DocManagerHelper.ForcesavePath(fileName, userAddress, false);
+                if (string.IsNullOrEmpty(forcesavePath))  // create forcesave path if it doesn't exist
+                    {
+                        forcesavePath = DocManagerHelper.ForcesavePath(fileName, userAddress, true);
+                    }
                 }
-                forcesavePath = DocManagerHelper.ForcesavePath(fileName, userAddress, false);
-                if (forcesavePath.Equals(""))
-                {
-                    forcesavePath = DocManagerHelper.ForcesavePath(fileName, userAddress, true);
-                }
-            }
 
-            DownloadToFile(downloadUri, forcesavePath);
+                SaveFile(bytesFile, forcesavePath);// save document file
 
-            if (isSubmitForm)
+                if (isSubmitForm)
+                {
+                    var jss = new JavaScriptSerializer();
+                    var actions = jss.Deserialize<List<object>>(jss.Serialize(fileData["actions"]));
+                    var action = jss.Deserialize<Dictionary<string, object>>(jss.Serialize(actions[0]));
+                    var user = action["userid"].ToString();  // get the user id
+                    DocManagerHelper.CreateMeta(fileName, user, "Filling Form", userAddress);  // create meta data for the forcesaved file
+                }
+            } catch (Exception)
             {
-                var jss = new JavaScriptSerializer();
-                var actions = jss.Deserialize<List<object>>(jss.Serialize(fileData["actions"]));
-                var action = jss.Deserialize<Dictionary<string, object>>(jss.Serialize(actions[0]));
-                var user = action["userid"].ToString();
-                DocManagerHelper.CreateMeta(fileName, user, "Filling Form", userAddress);
+                return 1;
             }
 
             return 0;
         }
 
-        public static void commandRequest(string method, string key)
+        // create a command request
+        public static void commandRequest(string method, string key, object meta = null)
         {
+            DocManagerHelper.VerifySSL();
+
             string documentCommandUrl = WebConfigurationManager.AppSettings["files.docservice.url.site"] + WebConfigurationManager.AppSettings["files.docservice.url.command"];
 
             var request = (HttpWebRequest)WebRequest.Create(documentCommandUrl);
@@ -229,6 +279,12 @@ namespace OnlineEditorsExampleMVC.Helpers
                 { "key", key }
             };
 
+            if (meta != null) 
+            {
+                body.Add("meta", meta);
+            }
+
+            // check if a secret key to generate token exists or not
             if (JwtManager.Enabled)
             {
                 var payload = new Dictionary<string, object>
@@ -236,10 +292,10 @@ namespace OnlineEditorsExampleMVC.Helpers
                         { "payload", body }
                     };
 
-                var payloadToken = JwtManager.Encode(payload);
-                var bodyToken = JwtManager.Encode(body);
-                string JWTheader = WebConfigurationManager.AppSettings["files.docservice.header"].Equals("") ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
-                request.Headers.Add(JWTheader, "Bearer " + payloadToken);
+                var payloadToken = JwtManager.Encode(payload);  // encode a payload object into a header token
+                var bodyToken = JwtManager.Encode(body);  // encode body into a body token
+                string JWTheader = string.IsNullOrEmpty(WebConfigurationManager.AppSettings["files.docservice.header"]) ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
+                request.Headers.Add(JWTheader, "Bearer " + payloadToken);  // add a header Authorization with a header token and Authorization prefix in it
 
                 body.Add("token", bodyToken);
             }
@@ -248,21 +304,23 @@ namespace OnlineEditorsExampleMVC.Helpers
             request.ContentLength = bytes.Length;
             using (var requestStream = request.GetRequestStream())
             {
+                // write bytes to the output stream
                 requestStream.Write(bytes, 0, bytes.Length);
             }
 
             string dataResponse;
-            using (var response = request.GetResponse())
+            using (var response = request.GetResponse())  // get the response
             using (var stream = response.GetResponseStream())
             {
                 if (stream == null) throw new Exception("Response is null");
 
                 using (var reader = new StreamReader(stream))
                 {
-                    dataResponse = reader.ReadToEnd();
+                    dataResponse = reader.ReadToEnd();  // and read it
                 }
             }
 
+            // convert stream to json string
             var jss = new JavaScriptSerializer();
             var responseObj = jss.Deserialize<Dictionary<string, object>>(dataResponse);
             if (!responseObj["error"].ToString().Equals("0"))
@@ -271,25 +329,30 @@ namespace OnlineEditorsExampleMVC.Helpers
             }
         }
 
-        private static void DownloadToFile(string url, string path)
+        // save file
+        private static void SaveFile(byte[] data, string path)
         {
-            if (string.IsNullOrEmpty(url)) throw new ArgumentException("url");
-            if (string.IsNullOrEmpty(path)) throw new ArgumentException("path");
+            using (var fs = File.Open(path, FileMode.Create))
+            {
+                fs.Write(data, 0, data.Length);
+            }
+        }
+
+        // save file information from the url to the file specified
+        private static byte[] DownloadFile(string url)
+        {
+            if (string.IsNullOrEmpty(url)) throw new ArgumentException("url");  // url isn't specified
 
             var req = (HttpWebRequest)WebRequest.Create(url);
-            using (var stream = req.GetResponse().GetResponseStream())
+            req.Timeout = 5000;
+            using (var stream = req.GetResponse().GetResponseStream())  // get input stream of the file information from the url
             {
                 if (stream == null) throw new Exception("stream is null");
-                const int bufferSize = 4096;
 
-                using (var fs = File.Open(path, FileMode.Create))
+                using (MemoryStream memoryStream = new MemoryStream())
                 {
-                    var buffer = new byte[bufferSize];
-                    int readed;
-                    while ((readed = stream.Read(buffer, 0, bufferSize)) != 0)
-                    {
-                        fs.Write(buffer, 0, readed);
-                    }
+                    stream.CopyTo(memoryStream);
+                    return memoryStream.ToArray();
                 }
             }
         }

web/documentserver-example/csharp-mvc/Helpers/Users.cs

@@ -0,0 +1,204 @@
+/**
+ *
+ * (c) Copyright Ascensio System SIA 2023
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
+using System.Collections.Generic;
+using System.Linq;
+
+namespace OnlineEditorsExampleMVC.Helpers
+{
+    public class Users
+    {
+        static List<string> descr_user_1 = new List<string>()
+        {
+            "File author by default",
+            "Doesn’t belong to any group",
+            "Can review all the changes",
+            "Can perform all actions with comments",
+            "The file favorite state is undefined",
+            "Can create files from templates using data from the editor",
+            "Can see the information about all users"
+        };
+
+        static List<string> descr_user_2 = new List<string>()
+        {
+            "Belongs to Group2",
+            "Can review only his own changes or changes made by users with no group",
+            "Can view comments, edit his own comments and comments left by users with no group. Can remove his own comments only",
+            "This file is marked as favorite",
+            "Can create new files from the editor",
+            "Can see the information about users from Group2 and users who don’t belong to any group"
+        };
+
+        static List<string> descr_user_3 = new List<string>()
+        {
+            "Belongs to Group3",
+            "Can review changes made by Group2 users",
+            "Can view comments left by Group2 and Group3 users. Can edit comments left by the Group2 users",
+            "This file isn’t marked as favorite",
+            "Can’t copy data from the file to clipboard",
+            "Can’t download the file",
+            "Can’t print the file",
+            "Can create new files from the editor",
+            "Can see the information about Group2 users"
+        };
+
+        static List<string> descr_user_0 = new List<string>()
+        {
+            "The name is requested when the editor is opened",
+            "Doesn’t belong to any group",
+            "Can review all the changes",
+            "Can perform all actions with comments",
+            "The file favorite state is undefined",
+            "Can't mention others in comments",
+            "Can't create new files from the editor",
+            "Can’t see anyone’s information",
+            "Can't rename files from the editor",
+            "Can't view chat",
+            "View file without collaboration",
+        };
+
+        private static List<User> users = new List<User>() {
+            new User(
+                    "uid-1",
+                    "John Smith",
+                    "smith@example.com",
+                    "",
+                    null,
+                    new Dictionary<string, object>(),
+                    null,
+                    null,
+                    new List<string>(),
+                    descr_user_1,
+                    true
+                ),
+            new User(
+                    "uid-2",
+                    "Mark Pottato",
+                    "pottato@example.com",
+                    "group-2",
+                    new List<string>() { "group-2", "" },
+                    new Dictionary<string, object>()
+                    {
+                        { "view",  ""  },
+                        { "edit", new List<string>() { "group-2", "" } },
+                        { "remove", new List<string>() { "group-2" } }
+                    },
+                    new List<string>() { "group-2", "" },
+                    true,
+                    new List<string>(),
+                    descr_user_2,
+                    false
+                ),
+            new User(
+                    "uid-3",
+                    "Hamish Mitchell",
+                    "mitchell@example.com",
+                    "group-3",
+                    new List<string>() { "group-2" },
+                    new Dictionary<string,object>()
+                    {
+                        { "view", new List<string>() { "group-2", "group-3" } },
+                        { "edit", new List<string>() { "group-2" } },
+                        { "remove", new List<string>() { } }
+                    },
+                    new List<string>() { "group-2" },
+                    false,
+                    new List<string>() { "copy", "download", "print" },
+                    descr_user_3,
+                    false
+                ),
+            new User(
+                    "uid-0",
+                    null,
+                    null,
+                    "",
+                    null,
+                    new Dictionary<string,object>(),
+                    new List<string>(),
+                    null,
+                    new List<string>(),
+                    descr_user_0,
+                    false
+                )
+        };
+
+        // get a user by id specified
+        public static User getUser(string id)
+        {
+            foreach(User user in users)
+            {
+                if (user.id.Equals(id)) return user;
+            }
+            return users[0];
+        }
+
+        // get a list of all the users
+        public static List<User> getAllUsers()
+        {
+            return users;
+        }
+
+        // get a list of users with their names and emails for mentions
+        public static List<Dictionary<string, object>> getUsersForMentions(string id)
+        {
+            List<Dictionary<string, object>> usersData = new List<Dictionary<string, object>>();
+            foreach (User user in users)
+            {
+                if (!user.id.Equals(id) && user.name != null && user.email != null)
+                {
+                    usersData.Add(new Dictionary<string, object>()
+                    {
+                        {"name", user.name },
+                        {"email", user.email }
+                    });
+                }
+            }
+            return usersData;
+        }
+    }
+
+    public class User
+    {
+        public string id;
+        public string name;
+        public string email;
+        public string group;
+        public List<string> reviewGroups;
+        public Dictionary<string, object> commentGroups;
+        public bool? favorite;
+        public List<string> deniedPermissions;
+        public List<string> descriptions;
+        public bool templates;
+        public List<string> userInfoGroups;
+
+        public User(string id, string name, string email, string group, List<string> reviewGroups, Dictionary<string, object> commentGroups, List<string> userInfoGroups, bool? favorite, List<string> deniedPermissions, List<string> descriptions, bool templates)
+        {
+            this.id = id;
+            this.name = name;
+            this.email = email;
+            this.group = group;
+            this.reviewGroups = reviewGroups;
+            this.commentGroups = commentGroups;
+            this.favorite = favorite;
+            this.deniedPermissions = deniedPermissions;
+            this.descriptions = descriptions;
+            this.templates = templates;
+            this.userInfoGroups = userInfoGroups;
+        }
+    }
+}

web/documentserver-example/csharp-mvc/Helpers/Utils.cs

@@ -1,9 +1,28 @@
-using System.Web;
+/**
+ *
+ * (c) Copyright Ascensio System SIA 2023
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
+using System.Web;
 
 namespace OnlineEditorsExampleMVC.Helpers
 {
     public static class Utils
     {
+        // get the request header or return the default one
         public static string GetOrDefault(this HttpRequest request, string header, string def)
         {
             var value = request[header];
@@ -11,6 +30,7 @@ namespace OnlineEditorsExampleMVC.Helpers
             return def;
         }
 
+        // get a cookie from the cookie collection or return the default one
         public static string GetOrDefault(this HttpCookieCollection cookies, string cookie, string def)
         {
             var cook = cookies[cookie];

web/documentserver-example/csharp-mvc/Models/FileModel.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -21,79 +21,103 @@ using System.Collections;
 using System.Collections.Generic;
 using System.IO;
 using System.Web;
+using System.Web.Configuration;
 using System.Web.Mvc;
 using System.Web.Script.Serialization;
 using OnlineEditorsExampleMVC.Helpers;
 
 namespace OnlineEditorsExampleMVC.Models
 {
+    // create file model
     public class FileModel
     {
-        public string Mode { get; set; }
-        public string Type { get; set; }
+        public string Mode { get; set; }  // editor mode
+        public string Type { get; set; }  // editor type
+        public bool IsEnabledDirectUrl { get; set; }  // is enabled direct url
 
+        // get file url for Document Server
         public string FileUri
         {
             get { return DocManagerHelper.GetFileUri(FileName, true); }
         }
 
+        // get file url for user
         public string FileUriUser
         {
-            get { return DocManagerHelper.GetFileUri(FileName, false); }
+            get { return Path.IsPathRooted(WebConfigurationManager.AppSettings["storage-path"]) ? DownloadUrl + "&dmode=emb" : DocManagerHelper.GetFileUri(FileName, false); }
         }
 
-        public string FileName { get; set; }
+        public string FileName { get; set; }  // file name
 
+        // get document type
         public string DocumentType
         {
             get { return FileUtility.GetFileType(FileName).ToString().ToLower(); }
         }
 
+        // get document key
         public string Key
         {
             get { return ServiceConverter.GenerateRevisionId(DocManagerHelper.CurUserHostAddress() + "/" + FileName + "/" + File.GetLastWriteTime(DocManagerHelper.StoragePath(FileName, null)).GetHashCode()); }
         }
 
+        // get the callback url
         public string CallbackUrl
         {
             get { return DocManagerHelper.GetCallback(FileName); }
         }
 
+        public string DownloadUrl
+        {
+            get { return DocManagerHelper.GetDownloadUrl(FileName); }
+        }
+
+        // get the document config
         public string GetDocConfig(HttpRequest request, UrlHelper url)
         {
             var jss = new JavaScriptSerializer();
 
-            var ext = Path.GetExtension(FileName).ToLower();
-            var editorsMode = Mode ?? "edit";
+            var ext = Path.GetExtension(FileName).ToLower();  // get file extension
+            var editorsMode = Mode ?? "edit";  // get editor mode
 
-            var canEdit = DocManagerHelper.EditedExts.Contains(ext);
-            var mode = canEdit && editorsMode != "view" ? "edit" : "view";
-            var submitForm = canEdit && (editorsMode.Equals("edit") || editorsMode.Equals("fillForms"));
+            var canEdit = DocManagerHelper.EditedExts.Contains(ext);  // check if the file with such an extension can be edited
 
-            var userId = request.Cookies.GetOrDefault("uid", "uid-1");
-            var uname = userId.Equals("uid-0") ? null : request.Cookies.GetOrDefault("uname", "John Smith");
-            string userGroup = null;
-            List<string> reviewGroups = null;
-            if (userId.Equals("uid-2"))
-            {
-                userGroup = "group-2";
-                reviewGroups = new List<string>() { "group-2", "" };
+            var id = request.Cookies.GetOrDefault("uid", null);
+            var user = Users.getUser(id);  // get the user
+            
+            if ((!canEdit && editorsMode.Equals("edit") || editorsMode.Equals("fillForms")) && DocManagerHelper.FillFormExts.Contains(ext)) {
+                editorsMode = "fillForms";
+                canEdit = true;
             }
-            if (userId.Equals("uid-3"))
+            var submitForm = editorsMode.Equals("fillForms") && id.Equals("uid-1") && false;  // check if the Submit form button is displayed or not
+            var mode = canEdit && editorsMode != "view" ? "edit" : "view";  // set the mode parameter: change it to view if the document can't be edited
+
+            // favorite icon state
+            bool? favorite = user.favorite;
+
+            var actionLink = request.GetOrDefault("actionLink", null);  // get the action link (comment or bookmark) if it exists
+            var actionData = string.IsNullOrEmpty(actionLink) ? null : jss.DeserializeObject(actionLink);  // get action data for the action link
+
+            var directUrl = DocManagerHelper.GetDownloadUrl(FileName, false);
+            var createUrl = DocManagerHelper.GetCreateUrl(FileUtility.GetFileType(FileName));
+            var templatesImageUrl = DocManagerHelper.GetTemplateImageUrl(FileUtility.GetFileType(FileName)); // image url for templates
+            var templates = new List<Dictionary<string, string>>
             {
-                userGroup = "group-3";
-                reviewGroups = new List<string>() { "group-2" };
-            }
-
-            object favorite = null;
-            if (!string.IsNullOrEmpty(request.Cookies.GetOrDefault("uid", null)))
-            {
-                favorite = request.Cookies.GetOrDefault("uid", null).Equals("uid-2");
-            }
-
-            var actionLink = request.GetOrDefault("actionLink", null);
-            var actionData = string.IsNullOrEmpty(actionLink) ? null : jss.DeserializeObject(actionLink);
+                new Dictionary<string, string>()
+                {
+                    { "image", "" },
+                    { "title", "Blank" },
+                    { "url", createUrl },
+                },
+                new Dictionary<string, string>()
+                {
+                    { "image", templatesImageUrl },
+                    { "title", "With sample content" },
+                    { "url", createUrl + "&sample=true" },
+                }
+            };
 
+            // specify the document config
             var config = new Dictionary<string, object>
                 {
                     { "type", Type ?? "desktop" },
@@ -102,7 +126,8 @@ namespace OnlineEditorsExampleMVC.Models
                         "document", new Dictionary<string, object>
                             {
                                 { "title", FileName },
-                                { "url", FileUri },
+                                { "url", DownloadUrl },
+                                { "directUrl", IsEnabledDirectUrl ? directUrl : "" },
                                 { "fileType", ext.Trim('.') },
                                 { "key", Key },
                                 {
@@ -114,16 +139,22 @@ namespace OnlineEditorsExampleMVC.Models
                                         }
                                 },
                                 {
+                                    // the permission for the document to be edited and downloaded or not
                                     "permissions", new Dictionary<string, object>
                                         {
                                             { "comment", editorsMode != "view" && editorsMode != "fillForms" && editorsMode != "embedded" && editorsMode != "blockcontent" },
-                                            { "download", true },
-                                            { "edit", canEdit && (editorsMode == "edit" || editorsMode == "filter") || editorsMode == "blockcontent" },
+                                            { "copy", !user.deniedPermissions.Contains("copy") },
+                                            { "download", !user.deniedPermissions.Contains("download") },
+                                            { "edit", canEdit && (editorsMode == "edit" || editorsMode == "view" || editorsMode == "filter" || editorsMode == "blockcontent") },
+                                            { "print", !user.deniedPermissions.Contains("print") },
                                             { "fillForms", editorsMode != "view" && editorsMode != "comment" && editorsMode != "embedded" && editorsMode != "blockcontent" },
                                             { "modifyFilter", editorsMode != "filter" },
                                             { "modifyContentControl", editorsMode != "blockcontent" },
-                                            { "review", editorsMode == "edit" || editorsMode == "review" },
-                                            { "reviewGroups", reviewGroups }
+                                            { "review", canEdit && (editorsMode == "edit" || editorsMode == "review") },
+                                            { "chat", !user.id.Equals("uid-0") },
+                                            { "reviewGroups", user.reviewGroups },
+                                            { "commentGroups", user.commentGroups },
+                                            { "userInfoGroups", user.userInfoGroups }
                                         }
                                 }
                             }
@@ -134,35 +165,46 @@ namespace OnlineEditorsExampleMVC.Models
                                 { "actionLink", actionData },
                                 { "mode", mode },
                                 { "lang", request.Cookies.GetOrDefault("ulang", "en") },
-                                { "callbackUrl", CallbackUrl },
+                                { "callbackUrl", CallbackUrl },  // absolute URL to the document storage service
+                                { "coEditing", editorsMode == "view" && user.id.Equals("uid-0") ? 
+                                    new Dictionary<string, object>{
+                                        {"mode", "strict"},
+                                        {"change", false}
+                                    } : null },
+                                { "createUrl", !user.id.Equals("uid-0") ? createUrl : null },
+                                { "templates", user.templates ? templates : null },
                                 {
+                                    // the user currently viewing or editing the document
                                     "user", new Dictionary<string, object>
                                         {
-                                            { "id", userId },
-                                            { "name", uname },
-                                            { "group", userGroup }
+                                            { "id", !user.id.Equals("uid-0") ? user.id : null  },
+                                            { "name", user.name },
+                                            { "group", user.group }
                                         }
                                 },
                                 {
+                                    // the parameters for the embedded document type
                                     "embedded", new Dictionary<string, object>
                                         {
-                                            { "saveUrl", FileUriUser },
-                                            { "embedUrl", FileUriUser },
-                                            { "shareUrl", FileUriUser },
-                                            { "toolbarDocked", "top" }
+                                            { "saveUrl", directUrl },  // the absolute URL that will allow the document to be saved onto the user personal computer
+                                            { "embedUrl", directUrl },  // the absolute URL to the document serving as a source file for the document embedded into the web page
+                                            { "shareUrl", directUrl },  // the absolute URL that will allow other users to share this document
+                                            { "toolbarDocked", "top" }  // the place for the embedded viewer toolbar (top or bottom)
                                         }
                                 },
                                 {
+                                    // the parameters for the editor interface
                                     "customization", new Dictionary<string, object>
                                         {
-                                            { "about", true },
-                                            { "feedback", true },
-                                            { "forcesave", false },
-                                            { "submitForm", submitForm },
+                                            { "about", true },  // the About section display
+                                            { "comments", true },
+                                            { "feedback", true },  // the Feedback & Support menu button display
+                                            { "forcesave", false },  // adds the request for the forced file saving to the callback handler
+                                            { "submitForm", submitForm },  // if the Submit form button is displayed or not
                                             {
-                                                "goback", new Dictionary<string, object>
+                                                "goback", new Dictionary<string, object>  // settings for the Open file location menu button and upper right corner button
                                                     {
-                                                        { "url", url.Action("Index", "Home") }
+                                                        { "url", DocManagerHelper.GetServerUrl(false) }  // the absolute URL to the website address which will be opened when clicking the Open file location menu button
                                                     }
                                             }
                                         }
@@ -171,8 +213,10 @@ namespace OnlineEditorsExampleMVC.Models
                     }
                 };
 
+            // if the secret key to generate token exists
             if (JwtManager.Enabled)
             {
+                // encode the document config into a token
                 var token = JwtManager.Encode(config);
                 config.Add("token", token);
             }
@@ -180,39 +224,41 @@ namespace OnlineEditorsExampleMVC.Models
             return jss.Serialize(config);
         }
 
+        // get the document history
         public void GetHistory(out string history, out string historyData)
-        {
+        {            
+            var storagePath = WebConfigurationManager.AppSettings["storage-path"];
             var jss = new JavaScriptSerializer();
             var histDir = DocManagerHelper.HistoryDir(DocManagerHelper.StoragePath(FileName, null));
 
             history = null;
             historyData = null;
 
-            if (DocManagerHelper.GetFileVersion(histDir) > 0)
+            if (DocManagerHelper.GetFileVersion(histDir) > 0)  // if the file was modified (the file version is greater than 0)
             {
                 var currentVersion = DocManagerHelper.GetFileVersion(histDir);
                 var hist = new List<Dictionary<string, object>>();
                 var histData = new Dictionary<string, object>();
 
-                for (var i = 1; i <= currentVersion; i++)
+                for (var i = 1; i <= currentVersion; i++)  // run through all the file versions
                 {
                     var obj = new Dictionary<string, object>();
                     var dataObj = new Dictionary<string, object>();
-                    var verDir = DocManagerHelper.VersionDir(histDir, i);
+                    var verDir = DocManagerHelper.VersionDir(histDir, i);  // get the path to the given file version
 
-                    var key = i == currentVersion ? Key : File.ReadAllText(Path.Combine(verDir, "key.txt"));
+                    var key = i == currentVersion ? Key : File.ReadAllText(Path.Combine(verDir, "key.txt"));  // get document key
 
                     obj.Add("key", key);
                     obj.Add("version", i);
 
-                    if (i == 1)
+                    if (i == 1)  // check if the version number is equal to 1
                     {
-                        var infoPath = Path.Combine(histDir, "createdInfo.json");
+                        var infoPath = Path.Combine(histDir, "createdInfo.json");  // get meta data of this file
 
                         if (File.Exists(infoPath))
                         {
                             var info = jss.Deserialize<Dictionary<string, object>>(File.ReadAllText(infoPath));
-                            obj.Add("created", info["created"]);
+                            obj.Add("created", info["created"]);  // write meta information to the object (user information and creation date)
                             obj.Add("user", new Dictionary<string, object>() {
                                 { "id", info["id"] },
                                 { "name", info["name"] },
@@ -220,35 +266,72 @@ namespace OnlineEditorsExampleMVC.Models
                         }
                     }
 
+                    var ext = Path.GetExtension(FileName).ToLower();
+                    dataObj.Add("fileType", ext.Replace(".", ""));
                     dataObj.Add("key", key);
-                    dataObj.Add("url", i == currentVersion ? FileUri : DocManagerHelper.GetPathUri(Directory.GetFiles(verDir, "prev.*")[0].Substring(HttpRuntime.AppDomainAppPath.Length)));
-                    dataObj.Add("version", i);
-                    if (i > 1)
+                    // write file url to the data object
+                    string prevFileUrl;
+                    string directPrevFileUrl;
+                    if (Path.IsPathRooted(storagePath) && !string.IsNullOrEmpty(storagePath))
                     {
+                        prevFileUrl = i == currentVersion ? DocManagerHelper.GetHistoryDownloadUrl(FileName, i.ToString(), "prev" + ext)
+                            : DocManagerHelper.GetDownloadUrl(Directory.GetFiles(verDir, "prev.*")[0].Replace(storagePath + "\\", ""));
+                        directPrevFileUrl = i == currentVersion ? DocManagerHelper.GetHistoryDownloadUrl(FileName, i.ToString(), "prev" + ext, false)
+                            : DocManagerHelper.GetDownloadUrl(Directory.GetFiles(verDir, "prev.*")[0].Replace(storagePath + "\\", ""), false);
+                    }
+                    else {
+                        prevFileUrl = i == currentVersion ? FileUri
+                            : DocManagerHelper.GetHistoryDownloadUrl(FileName, i.ToString(), "prev" + ext);
+                        directPrevFileUrl = i == currentVersion ? DocManagerHelper.GetHistoryDownloadUrl(FileName, i.ToString(), "prev" + ext, false)
+                            : DocManagerHelper.GetDownloadUrl(Directory.GetFiles(verDir, "prev.*")[0].Replace(storagePath + "\\", ""), false);
+                    }
+
+                    dataObj.Add("url", prevFileUrl);
+                    if (IsEnabledDirectUrl)
+                    {
+                        dataObj.Add("directUrl", directPrevFileUrl);
+                    }
+                    dataObj.Add("version", i);
+                    if (i > 1)  // check if the version number is greater than 1 (the file was modified)
+                    {
+                        // get the path to the changes.json file
                         var changes = jss.Deserialize<Dictionary<string, object>>(File.ReadAllText(Path.Combine(DocManagerHelper.VersionDir(histDir, i - 1), "changes.json")));
-                        var change = ((Dictionary<string, object>)((ArrayList)changes["changes"])[0]);
+                        var changesArray = (ArrayList)changes["changes"];
+                        var change = changesArray.Count > 0
+                            ? (Dictionary<string, object>)changesArray[0]
+                            : new Dictionary<string, object>();
 
-                        obj.Add("changes", changes["changes"]);
+                        // write information about changes to the object
+                        obj.Add("changes", change.Count > 0 ? changes["changes"] : null);
                         obj.Add("serverVersion", changes["serverVersion"]);
-                        obj.Add("created", change["created"]);
-                        obj.Add("user", change["user"]);
+                        obj.Add("created", change.Count > 0  ? change["created"] : null);
+                        obj.Add("user", change.Count > 0 ? change["user"] : null);
 
-                        var prev = (Dictionary<string, object>)histData[(i - 2).ToString()];
-                        dataObj.Add("previous", new Dictionary<string, object>() {
-                            { "key", prev["key"] },
+                        var prev = (Dictionary<string, object>)histData[(i - 2).ToString()];  // get the history data from the previous file version
+                        dataObj.Add("previous", IsEnabledDirectUrl ? new Dictionary<string, object>() {  // write information about previous file version to the data object with direct url
+                            { "fileType", prev["fileType"] },
+                            { "key", prev["key"] },  // write key and url information about previous file version
+                            { "url", prev["url"] },
+                            { "directUrl", prev["directUrl"] },
+                        } : new Dictionary<string, object>() {  // write information about previous file version to the data object without direct url
+                            { "fileType", prev["fileType"] },
+                            { "key", prev["key"] },  // write key and url information about previous file version
                             { "url", prev["url"] },
                         });
-                        dataObj.Add("changesUrl", DocManagerHelper.GetPathUri(Path.Combine(DocManagerHelper.VersionDir(histDir, i - 1), "diff.zip").Substring(HttpRuntime.AppDomainAppPath.Length)));
+                        // write the path to the diff.zip archive with differences in this file version
+                        var changesUrl = DocManagerHelper.GetHistoryDownloadUrl(FileName, (i - 1).ToString(), "diff.zip");
+                        dataObj.Add("changesUrl", changesUrl);
                     }
                     if(JwtManager.Enabled)
                     {
                         var token = JwtManager.Encode(dataObj);
                         dataObj.Add("token", token);
                     }
-                    hist.Add(obj);
-                    histData.Add((i - 1).ToString(), dataObj);
+                    hist.Add(obj);  // add object dictionary to the hist list
+                    histData.Add((i - 1).ToString(), dataObj);  // write data object information to the history data
                 }
 
+                // write history information about the current file version to the history object
                 history = jss.Serialize(new Dictionary<string, object>()
                 {
                     { "currentVersion", currentVersion },
@@ -258,10 +341,12 @@ namespace OnlineEditorsExampleMVC.Models
             }
         }
 
+        // get a document which will be compared with the current document
         public void GetCompareFileData(out string compareConfig)
         {
             var jss = new JavaScriptSerializer();
 
+            // get the path to the compared file
             var compareFileUrl = new UriBuilder(DocManagerHelper.GetServerUrl(true))
             {
                 Path = HttpRuntime.AppDomainAppVirtualPath
@@ -270,25 +355,41 @@ namespace OnlineEditorsExampleMVC.Models
                 Query = "type=assets&fileName=" + HttpUtility.UrlEncode("sample.docx")
             };
 
+            var directCompareFileUrl = new UriBuilder(DocManagerHelper.GetServerUrl(false))
+            {
+                Path = HttpRuntime.AppDomainAppVirtualPath
+                    + (HttpRuntime.AppDomainAppVirtualPath.EndsWith("/") ? "" : "/")
+                    + "webeditor.ashx",
+                Query = "type=assets&fileName=" + HttpUtility.UrlEncode("sample.docx")
+            };
+
+            // create an object with the information about the compared file
             var dataCompareFile = new Dictionary<string, object>
             {
                 { "fileType", "docx" },
                 { "url", compareFileUrl.ToString() }
             };
 
-            if (JwtManager.Enabled)
+            if (IsEnabledDirectUrl)
             {
-                var compareFileToken = JwtManager.Encode(dataCompareFile);
-                dataCompareFile.Add("token", compareFileToken);
+                dataCompareFile.Add("directUrl", directCompareFileUrl.ToString());
+            }
+
+            if (JwtManager.Enabled)  // if the secret key to generate token exists
+            {
+                var compareFileToken = JwtManager.Encode(dataCompareFile);  // encode the dataCompareFile object into the token
+                dataCompareFile.Add("token", compareFileToken);  // and add it to the dataCompareFile object
             }
 
             compareConfig = jss.Serialize(dataCompareFile);
         }
 
+        // get a logo config
         public void GetLogoConfig(out string logoUrl)
         {
             var jss = new JavaScriptSerializer();
 
+            // get the path to the logo image
             var mailMergeUrl = new UriBuilder(DocManagerHelper.GetServerUrl(true))
             {
                 Path = HttpRuntime.AppDomainAppVirtualPath
@@ -296,25 +397,40 @@ namespace OnlineEditorsExampleMVC.Models
                     + "Content\\images\\logo.png"
             };
 
+            var directMailMergeUrl = new UriBuilder(DocManagerHelper.GetServerUrl(false))
+            {
+                Path = HttpRuntime.AppDomainAppVirtualPath
+                    + (HttpRuntime.AppDomainAppVirtualPath.EndsWith("/") ? "" : "/")
+                    + "Content\\images\\logo.png"
+            };
+
+            // create a logo config
             var logoConfig = new Dictionary<string, object>
             {
                 { "fileType", "png"},
                 { "url", mailMergeUrl.ToString()}
             };
 
-            if (JwtManager.Enabled)
+            if (IsEnabledDirectUrl)
             {
-                var token = JwtManager.Encode(logoConfig);
-                logoConfig.Add("token", token);
+                logoConfig.Add("directUrl", directMailMergeUrl.ToString());
+            }
+
+            if (JwtManager.Enabled)  // if the secret key to generate token exists
+            {
+                var token = JwtManager.Encode(logoConfig);  // encode logoConfig into the token
+                logoConfig.Add("token", token);  // and add it to the logo config
             }
 
             logoUrl = jss.Serialize(logoConfig).Replace("{", "").Replace("}", "");
         }
 
+        // get a mail merge config
         public void GetMailMergeConfig(out string dataMailMergeRecipients)
         {
             var jss = new JavaScriptSerializer();
 
+            // get the path to the recipients data for mail merging
             var mailMergeUrl = new UriBuilder(DocManagerHelper.GetServerUrl(true))
             {
                 Path =
@@ -324,19 +440,43 @@ namespace OnlineEditorsExampleMVC.Models
                 Query = "type=csv"
             };
 
+            var directMailMergeUrl = new UriBuilder(DocManagerHelper.GetServerUrl(false))
+            {
+                Path =
+                    HttpRuntime.AppDomainAppVirtualPath
+                    + (HttpRuntime.AppDomainAppVirtualPath.EndsWith("/") ? "" : "/")
+                    + "webeditor.ashx",
+                Query = "type=csv"
+            };
+
+            // create a mail merge config
             var mailMergeConfig = new Dictionary<string, object>
             {
                 { "fileType", "csv" },
                 { "url", mailMergeUrl.ToString()}
             };
 
-            if (JwtManager.Enabled)
+            if (IsEnabledDirectUrl)
             {
-                var mailmergeToken = JwtManager.Encode(mailMergeConfig);
-                mailMergeConfig.Add("token", mailmergeToken);
+                mailMergeConfig.Add("directUrl", directMailMergeUrl.ToString());
+            }
+
+            if (JwtManager.Enabled)  // if the secret key to generate token exists
+            {
+                var mailmergeToken = JwtManager.Encode(mailMergeConfig);  // encode mailMergeConfig into the token
+                mailMergeConfig.Add("token", mailmergeToken);  // and add it to the mail merge config
             }
 
             dataMailMergeRecipients = jss.Serialize(mailMergeConfig);
         }
+
+        //get a users for mentions
+        public void GetUsersMentions(HttpRequest request, out string usersForMentions)
+        {
+            var jss = new JavaScriptSerializer();
+            var id = request.Cookies.GetOrDefault("uid", null);
+            var user = Users.getUser(id);
+            usersForMentions = !user.id.Equals("uid-0") ? jss.Serialize(Users.getUsersForMentions(user.id)) : null;
+        }
     }
 }

web/documentserver-example/csharp-mvc/Models/FileUtility.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -30,33 +30,37 @@ namespace OnlineEditorsExampleMVC.Models
             Slide
         }
 
+        // get file type
         public static FileType GetFileType(string fileName)
         {
             var ext = Path.GetExtension(fileName).ToLower();
 
-            if (ExtsDocument.Contains(ext)) return FileType.Word;
-            if (ExtsSpreadsheet.Contains(ext)) return FileType.Cell;
-            if (ExtsPresentation.Contains(ext)) return FileType.Slide;
+            if (ExtsDocument.Contains(ext)) return FileType.Word;  // word type for document extensions
+            if (ExtsSpreadsheet.Contains(ext)) return FileType.Cell;  // cell type for spreadsheet extensions
+            if (ExtsPresentation.Contains(ext)) return FileType.Slide;  // slide type for presentation extensions
 
-            return FileType.Word;
+            return FileType.Word;  // the default type is word
         }
 
+        // document extensions
         public static readonly List<string> ExtsDocument = new List<string>
             {
                 ".doc", ".docx", ".docm",
                 ".dot", ".dotx", ".dotm",
                 ".odt", ".fodt", ".ott", ".rtf", ".txt",
                 ".html", ".htm", ".mht", ".xml",
-                ".pdf", ".djvu", ".fb2", ".epub", ".xps"
+                ".pdf", ".djvu", ".fb2", ".epub", ".xps", ".oxps", ".oform"
             };
 
+        // spreadsheet extensions
         public static readonly List<string> ExtsSpreadsheet = new List<string>
             {
-                ".xls", ".xlsx", ".xlsm",
+                ".xls", ".xlsx", ".xlsm", ".xlsb",
                 ".xlt", ".xltx", ".xltm",
                 ".ods", ".fods", ".ots", ".csv"
             };
 
+        // presentation extensions
         public static readonly List<string> ExtsPresentation = new List<string>
             {
                 ".pps", ".ppsx", ".ppsm",

web/documentserver-example/csharp-mvc/OnlineEditorsExampleMVC.csproj

@@ -13,7 +13,7 @@
     <AppDesignerFolder>Properties</AppDesignerFolder>
     <RootNamespace>OnlineEditorsExampleMVC</RootNamespace>
     <AssemblyName>OnlineEditorsExampleMVC</AssemblyName>
-    <TargetFrameworkVersion>v4.5</TargetFrameworkVersion>
+    <TargetFrameworkVersion>v4.8</TargetFrameworkVersion>
     <MvcBuildViews>false</MvcBuildViews>
     <UseIISExpress>true</UseIISExpress>
     <IISExpressSSLPort />
@@ -43,6 +43,9 @@
     <WarningLevel>4</WarningLevel>
   </PropertyGroup>
   <ItemGroup>
+    <Reference Include="JWT, Version=9.0.0.0, Culture=neutral, PublicKeyToken=6f98bca0f40f2ecf, processorArchitecture=MSIL">
+      <HintPath>packages\JWT.9.0.3\lib\net46\JWT.dll</HintPath>
+    </Reference>
     <Reference Include="Microsoft.CSharp" />
     <Reference Include="System" />
     <Reference Include="System.ComponentModel.DataAnnotations" />
@@ -50,49 +53,49 @@
     <Reference Include="System.Web" />
     <Reference Include="System.Web.Extensions" />
     <Reference Include="System.Web.Services" />
-    <Reference Include="Antlr3.Runtime">
+    <Reference Include="Antlr3.Runtime, Version=3.5.0.2, Culture=neutral, PublicKeyToken=eb42632606e9261f, processorArchitecture=MSIL">
       <HintPath>packages\Antlr.3.5.0.2\lib\Antlr3.Runtime.dll</HintPath>
     </Reference>
-    <Reference Include="EntityFramework">
+    <Reference Include="EntityFramework, Version=6.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089, processorArchitecture=MSIL">
       <HintPath>packages\EntityFramework.6.4.4\lib\net45\EntityFramework.dll</HintPath>
     </Reference>
-    <Reference Include="Microsoft.Web.Infrastructure">
+    <Reference Include="Microsoft.Web.Infrastructure, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, processorArchitecture=MSIL">
       <HintPath>packages\Microsoft.Web.Infrastructure.1.0.0.0\lib\net40\Microsoft.Web.Infrastructure.dll</HintPath>
     </Reference>
-    <Reference Include="Newtonsoft.Json">
-      <HintPath>packages\Newtonsoft.Json.12.0.3\lib\net45\Newtonsoft.Json.dll</HintPath>
+    <Reference Include="Newtonsoft.Json, Version=13.0.0.0, Culture=neutral, PublicKeyToken=30ad4fe6b2a6aeed, processorArchitecture=MSIL">
+      <HintPath>packages\Newtonsoft.Json.13.0.1\lib\net45\Newtonsoft.Json.dll</HintPath>
     </Reference>
-    <Reference Include="System.Net.Http.Formatting">
+    <Reference Include="System.Net.Http.Formatting, Version=5.2.7.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, processorArchitecture=MSIL">
       <HintPath>packages\Microsoft.AspNet.WebApi.Client.5.2.7\lib\net45\System.Net.Http.Formatting.dll</HintPath>
     </Reference>
-    <Reference Include="System.Web.Helpers">
+    <Reference Include="System.Web.Helpers, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, processorArchitecture=MSIL">
       <HintPath>packages\Microsoft.AspNet.WebPages.3.2.7\lib\net45\System.Web.Helpers.dll</HintPath>
     </Reference>
-    <Reference Include="System.Web.Http">
+    <Reference Include="System.Web.Http, Version=5.2.7.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, processorArchitecture=MSIL">
       <HintPath>packages\Microsoft.AspNet.WebApi.Core.5.2.7\lib\net45\System.Web.Http.dll</HintPath>
     </Reference>
-    <Reference Include="System.Web.Http.WebHost">
+    <Reference Include="System.Web.Http.WebHost, Version=5.2.7.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, processorArchitecture=MSIL">
       <HintPath>packages\Microsoft.AspNet.WebApi.WebHost.5.2.7\lib\net45\System.Web.Http.WebHost.dll</HintPath>
     </Reference>
-    <Reference Include="System.Web.Mvc">
+    <Reference Include="System.Web.Mvc, Version=5.2.7.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, processorArchitecture=MSIL">
       <HintPath>packages\Microsoft.AspNet.Mvc.5.2.7\lib\net45\System.Web.Mvc.dll</HintPath>
     </Reference>
-    <Reference Include="System.Web.Optimization">
+    <Reference Include="System.Web.Optimization, Version=1.1.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, processorArchitecture=MSIL">
       <HintPath>packages\Microsoft.AspNet.Web.Optimization.1.1.3\lib\net40\System.Web.Optimization.dll</HintPath>
     </Reference>
-    <Reference Include="System.Web.Razor">
+    <Reference Include="System.Web.Razor, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, processorArchitecture=MSIL">
       <HintPath>packages\Microsoft.AspNet.Razor.3.2.7\lib\net45\System.Web.Razor.dll</HintPath>
     </Reference>
-    <Reference Include="System.Web.WebPages">
+    <Reference Include="System.Web.WebPages, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, processorArchitecture=MSIL">
       <HintPath>packages\Microsoft.AspNet.WebPages.3.2.7\lib\net45\System.Web.WebPages.dll</HintPath>
     </Reference>
-    <Reference Include="System.Web.WebPages.Deployment">
+    <Reference Include="System.Web.WebPages.Deployment, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, processorArchitecture=MSIL">
       <HintPath>packages\Microsoft.AspNet.WebPages.3.2.7\lib\net45\System.Web.WebPages.Deployment.dll</HintPath>
     </Reference>
-    <Reference Include="System.Web.WebPages.Razor">
+    <Reference Include="System.Web.WebPages.Razor, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, processorArchitecture=MSIL">
       <HintPath>packages\Microsoft.AspNet.WebPages.3.2.7\lib\net45\System.Web.WebPages.Razor.dll</HintPath>
     </Reference>
-    <Reference Include="WebGrease">
+    <Reference Include="WebGrease, Version=1.6.5135.21930, Culture=neutral, PublicKeyToken=31bf3856ad364e35, processorArchitecture=MSIL">
       <HintPath>packages\WebGrease.1.6.0\lib\WebGrease.dll</HintPath>
     </Reference>
   </ItemGroup>
@@ -109,6 +112,7 @@
     <Compile Include="Helpers\DocManagerHelper.cs" />
     <Compile Include="Helpers\DocumentConverter.cs" />
     <Compile Include="Helpers\JwtManager.cs" />
+    <Compile Include="Helpers\Users.cs" />
     <Compile Include="Helpers\Utils.cs" />
     <Compile Include="Models\FileModel.cs" />
     <Compile Include="Models\FileUtility.cs" />
@@ -119,36 +123,42 @@
   </ItemGroup>
   <ItemGroup>
     <Content Include="Content\editor.css" />
-    <Content Include="Content\images\alert.png" />
-    <Content Include="Content\images\block-content-24.png" />
+    <Content Include="Content\images\block-content.svg" />
     <Content Include="Content\images\cell.ico" />
-    <Content Include="Content\images\close.png" />
-    <Content Include="Content\images\comment-24.png" />
-    <Content Include="Content\images\corner.png" />
-    <Content Include="Content\images\delete-24.png" />
-    <Content Include="Content\images\desktop-24.png" />
-    <Content Include="Content\images\done.png" />
-    <Content Include="Content\images\download-24.png" />
-    <Content Include="Content\images\embeded-24.png" />
-    <Content Include="Content\images\file_docx.png" />
-    <Content Include="Content\images\file_pptx.png" />
-    <Content Include="Content\images\file_upload.png" />
-    <Content Include="Content\images\file_xlsx.png" />
-    <Content Include="Content\images\fill-forms-24.png" />
-    <Content Include="Content\images\filter-24.png" />
+    <Content Include="Content\images\close.svg" />
+    <Content Include="Content\images\comment.svg" />
+    <Content Include="Content\images\delete.svg" />
+    <Content Include="Content\images\desktop.svg" />
+    <Content Include="Content\images\done.svg" />
+    <Content Include="Content\images\download.svg" />
+    <Content Include="Content\images\embeded.svg" />
+    <Content Include="Content\images\error.svg" />
+    <Content Include="Content\images\file_docx.svg" />
+    <Content Include="Content\images\file_docxf.svg" />
+    <Content Include="Content\images\file_pptx.svg" />
+    <Content Include="Content\images\file_upload.svg" />
+    <Content Include="Content\images\file_xlsx.svg" />
+    <Content Include="Content\images\fill-forms.svg" />
+    <Content Include="Content\images\filter.svg" />
+    <Content Include="Content\images\icon_docx.svg" />
+    <Content Include="Content\images\icon_pptx.svg" />
+    <Content Include="Content\images\icon_xlsx.svg" />
+    <Content Include="Content\images\info.svg" />
     <Content Include="Content\images\loader16.gif" />
     <Content Include="Content\images\logo.png" />
-    <Content Include="Content\images\mobile-24.png" />
-    <Content Include="Content\images\question_small.png" />
-    <Content Include="Content\images\review-24.png" />
+    <Content Include="Content\images\logo.svg" />
+    <Content Include="Content\images\mobile-fill-forms.svg" />
+    <Content Include="Content\images\mobile.svg" />
+    <Content Include="Content\images\notdone.svg" />
+    <Content Include="Content\images\review.svg" />
     <Content Include="Content\images\slide.ico" />
     <Content Include="Content\images\word.ico" />
     <Content Include="Content\jquery-ui.css" />
+    <Content Include="Content\media.css" />
     <Content Include="Content\stylesheet.css" />
     <Content Include="favicon.ico" />
     <Content Include="Global.asax" />
     <Content Include="LICENSE" />
-    <Content Include="ReadMe.txt" />
     <Content Include="Scripts\jquery-1.8.2.js" />
     <Content Include="Scripts\jquery-ui.js" />
     <Content Include="Scripts\jquery.blockUI.js" />
@@ -175,10 +185,12 @@
     <Content Include="assets\AUTHORS.md" />
     <Content Include="assets\LICENSE" />
     <Content Include="assets\new\new.docx" />
+    <Content Include="assets\new\new.docxf" />
     <Content Include="assets\new\new.pptx" />
     <Content Include="assets\new\new.xlsx" />
     <Content Include="assets\sample\csv.csv" />
     <Content Include="assets\sample\sample.docx" />
+    <Content Include="assets\sample\sample.docxf" />
     <Content Include="assets\sample\sample.pptx" />
     <Content Include="assets\sample\sample.xlsx" />
     <None Include="packages.config" />

web/documentserver-example/csharp-mvc/Properties/AssemblyInfo.cs

@@ -7,7 +7,7 @@ using System.Runtime.InteropServices;
 [assembly: AssemblyConfiguration("")]
 [assembly: AssemblyCompany("Ascensio System SIA")]
 [assembly: AssemblyProduct("OnlineEditorsExampleMVC")]
-[assembly: AssemblyCopyright("Ascensio System SIA 2021")]
+[assembly: AssemblyCopyright("Ascensio System SIA 2023")]
 [assembly: AssemblyTrademark("")]
 [assembly: AssemblyCulture("")]
 

web/documentserver-example/csharp-mvc/README.md

@@ -0,0 +1,81 @@
+## Overview
+
+This example will help you integrate ONLYOFFICE Docs into your web application written in .Net (C# MVC).
+
+**Please note**: It is intended for testing purposes and demonstrating functionality of the editors. Do NOT use this integration example on your own server without proper code modifications! In case you enabled the test example, disable it before going for production.
+
+## Step 1. Install ONLYOFFICE Docs
+
+Download and install ONLYOFFICE Docs (packaged as Document Server).
+
+See the detailed guide to learn how to install Document Server [for Windows](https://helpcenter.onlyoffice.com/installation/docs-developer-install-windows.aspx), [for Linux](https://helpcenter.onlyoffice.com/installation/docs-developer-install-ubuntu.aspx), or [for Docker](https://helpcenter.onlyoffice.com/server/developer-edition/docker/docker-installation.aspx).
+
+## Step 2. Download the .Net (C# MVC) code for the editors integration
+
+Download the [.Net (C# MVC) example](https://api.onlyoffice.com/editors/demopreview) from our site.
+
+To connect the editors to your website, specify the path to the editors installation and the path to the storage folder in the *settings.config* file:
+```
+<add key="storage-path" value=""/>
+<add key="files.docservice.url.site" value="https://documentserver/" />
+```
+where the **documentserver** is the name of the server with the ONLYOFFICE Document Server installed and the **storage-path** is the path where files will be created and stored. You can set an absolute path.
+
+If you want to experiment with the editor configuration, modify the [parameters](https://api.onlyoffice.com/editors/advanced) in the *DocEditor.aspx* file.
+
+## Step 3. Install the prerequisites
+Сheck if your system meets the system requirements:
+* **Microsoft .NET Framework**: version 4.5 (download it from the [official Microsoft website](https://www.microsoft.com/en-US/download/details.aspx?id=30653));
+* **Internet Information Services**: version 7 or later.
+
+Configure the IIS components for the server to work correctly:
+1.	Open Windows features:
+
+	**Start** -> **Control Panel** -> **Programs** -> **Programs and Features** -> **Turn Windows features on or off**
+
+2. In the opened window, find **Internet Information Services** and choose all the necessary features. To do this, open the **World Wide Web Services** list and check the following components:
+* **Application Development Features**: .NET Extensibility 4.8, ASP.NET 4.8, ISAPI Extensions, ISAPI Filters,
+* **Common HTTP Features**: Default Document,
+* **Security**: Request Filtering.
+
+## Step 4. Run your website with the editors
+1. Run the Internet Information Service (IIS) Manager:
+
+	**Start** -> **Control Panel** -> **System and Security** -> **Administrative Tools** -> **Internet Information Services (IIS) Manager**
+2. Add your website in the IIS Manager.
+
+	On the **Connections** panel right-click the **Sites** node in the tree, then click **Add Website**.
+
+	![add](screenshots/add.png)
+3. In the **Add Website** dialog box specify the name of the folder with the .Net (C# MVC) project in the **Site name** box.
+
+	Specify the path to the folder with your project in the **Physical Path** box.
+
+	Specify the unique value used only for this website in the **Port** box.
+
+	![sitename](screenshots/sitename.png)
+4. Check for the .NET platform version specified in IIS Manager for you website. Choose **v4.0.** version.
+	
+	**Application Pools** -> right-click the platform name -> **Set application Pool defaults** -> **.NET CLR version**
+
+	![platform](screenshots/platform.png)
+5. Browse your website with the IIS Manager:
+
+	Right-click the site -> **Manage Website** -> **Browse**
+
+	![browse](screenshots/browse.png)
+
+## Step 5. Check accessibility
+
+In case the example and Document Server are installed on different computers, make sure that your server with the example installed has access to the Document Server with the address which you specify instead of **documentserver** in the configuration files. 
+
+Make sure that the Document Server has access to the server with the example installed with the address which you specify instead of **example.com** in the configuration files.
+
+## Important security info
+
+Please keep in mind the following security aspects when you are using test examples:
+
+* There is no protection of the storage from unauthorized access since there is no need for authorization.
+* There are no checks against parameter substitution in links, since the parameters are generated by the code according to the pre-arranged scripts.
+* There are no data checks in requests of saving the file after editing, since each test example is intended for requests only from ONLYOFFICE Document Server.
+* There are no prohibitions on using test examples from other sites, since they are intended to interact with ONLYOFFICE Document Server from another domain.

web/documentserver-example/csharp-mvc/ReadMe.txt

@@ -1,16 +0,0 @@
-For the ONLYOFFICE Applications example to work properly you need to do the following:
-
-1. Download and extract the Example.zip into a directory selected for it, for instance, C:\OnlyofficeExample
-
-2. Run the IIS Manager (C:\Windows\system32\inetsrv\InetMgr.exe or Start -> All Programs -> Administrative Tools -> Internet Information Services (IIS) Manager for Windows Server 2003)
-
-3. Add the unpacked Example to the list of sites with the physical path to the C:\OnlyofficeExample (or the one you selected) folder.
-
-4. Make sure that the user account under which the IIS NetworkService process is executed has the write access rights for the C:\OnlyofficeExample\App_Data folder (this is significant for the IIS later than 6.0).
-
-5. Make the created ONLYOFFIC<49> Applications example available through IP or domain name so that it could be connected from the web by the document service for proper document rendering.
-
-
-
-
-

web/documentserver-example/csharp-mvc/Scripts/jquery.dropdownToggle.js

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/csharp-mvc/Scripts/jscript.js

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -16,9 +16,24 @@
  *
  */
 
+var directUrl;
+
 if (typeof jQuery != "undefined") {
     jq = jQuery.noConflict();
 
+    directUrl = getUrlVars()["directUrl"] == "true";
+
+    mustReload = false;
+
+    if (directUrl)
+        jq("#directUrl").prop("checked", directUrl);
+    else
+        directUrl = jq("#directUrl").prop("checked");
+
+    jq("#directUrl").change(function () {
+        window.location = "?directUrl=" + jq(this).prop("checked");
+    });
+
     jq(function () {
         jq('#fileupload').fileupload({
             dataType: 'json',
@@ -28,6 +43,7 @@ if (typeof jQuery != "undefined") {
                 jq(".current").removeClass("current");
                 jq("#step1").addClass("current");
                 jq("#mainProgress .error-message").hide().find("span").text("");
+                jq("#blockPassword").hide();
                 jq("#mainProgress").removeClass("embedded");
                 jq("#uploadFileName").text("");
 
@@ -59,8 +75,9 @@ if (typeof jQuery != "undefined") {
                 jq("#uploadFileName").text(response.filename);
                 jq("#uploadFileName").addClass(response.documentType);
 
+                mustReload = true;
+
                 jq("#step1").addClass("done").removeClass("current");
-                jq("#step2").addClass("current");
 
                 checkConvert();
             }
@@ -70,7 +87,8 @@ if (typeof jQuery != "undefined") {
     });
     
     var timer = null;
-    var checkConvert = function () {
+    var checkConvert = function (filePass) {
+	    filePass = filePass ? filePass : null;
         if (timer != null) {
             clearTimeout(timer);
         }
@@ -78,41 +96,56 @@ if (typeof jQuery != "undefined") {
         if (!jq("#mainProgress").is(":visible")) {
             return;
         }
+        jq("#step2").addClass("current");
+        jq("#filePass").val("");
 
         var fileName = jq("#hiddenFileName").val();
         var posExt = fileName.lastIndexOf('.');
         posExt = 0 <= posExt ? fileName.substring(posExt).trim().toLowerCase() : '';
 
         if (ConverExtList.indexOf(posExt) == -1) {
+            jq("#step2").addClass("done").removeClass("current");
             loadScripts();
             return;
         }
 
         timer = setTimeout(function () {
-            var requestAddress = UrlConverter
-                + "&filename=" + encodeURIComponent(jq("#hiddenFileName").val());
 
             jq.ajax({
                 async: true,
                 contentType: "text/xml",
-                type: "get",
-                url: requestAddress,
+                type: "post",
+                dataType: "json",
+                data: JSON.stringify({ filename: fileName, filePass: filePass }),
+                url: UrlConverter,
                 complete: function (data) {
                     var responseText = data.responseText;
                     var response = jq.parseJSON(responseText);
                     if (response.error) {
-                        jq(".current").removeClass("current");
-                        jq(".step:not(.done)").addClass("error");
-                        jq("#mainProgress .error-message").show().find("span").text(response.error);
-                        jq('#hiddenFileName').val("");
-                        return;
+                        if (response.error.includes("Incorrect password")) {
+                            jq(".current").removeClass("current");
+                            jq("#step2").addClass("error");
+                            jq("#blockPassword").show();
+                            if (filePass) {
+                                jq("#filePass").addClass("errorInput");
+                                jq(".errorPass").text("The password is incorrect, please try again.");
+                            }
+                            return;
+                        } else {
+                            jq(".current").removeClass("current");
+                            jq(".step:not(.done)").addClass("error");
+                            jq("#mainProgress .error-message").show().find("span").text(response.error);
+                            jq('#hiddenFileName').val("");
+                            return;
+                        }
                     }
 
                     jq("#hiddenFileName").val(response.filename);
 
                     if (response.step && response.step < 100) {
-                        checkConvert();
+                        checkConvert(filePass);
                     } else {
+                        jq("#step2").addClass("done").removeClass("current");
                         loadScripts();
                     }
                 }
@@ -124,7 +157,6 @@ if (typeof jQuery != "undefined") {
         if (!jq("#mainProgress").is(":visible")) {
             return;
         }
-        jq("#step2").addClass("done").removeClass("current");
         jq("#step3").addClass("current");
 
         if (jq("#loadScripts").is(":empty")) {
@@ -149,7 +181,7 @@ if (typeof jQuery != "undefined") {
         var posExt = fileName.lastIndexOf('.');
         posExt = 0 <= posExt ? fileName.substring(posExt).trim().toLowerCase() : '';
 
-        if (EditedExtList.indexOf(posExt) != -1) {
+        if (EditedExtList.indexOf(posExt) != -1 || FillExtList.indexOf(posExt) != -1) {
             jq("#beginEdit").removeClass("disable");
         }
     };
@@ -175,16 +207,32 @@ if (typeof jQuery != "undefined") {
 
         userSel.on("change", function () {
             setCookie("uid", userSel.val());
-            setCookie("uname", userSel.find("option:selected").text())
         });
         langSel.on("change", function () {
             setCookie("ulang", langSel.val());
         });
     };
 
+    jq(document).on("click", "#enterPass", function () {
+        var filePass = jq("#filePass").val();
+        if (filePass) {
+            jq("#step2").removeClass("error");
+            jq("#blockPassword").hide();
+            checkConvert(filePass);
+        } else {
+            jq("#filePass").addClass("errorInput");
+            jq(".errorPass").text("Password can't be blank.");
+        }
+    });
+
+    jq(document).on("click", "#skipPass", function () {
+        jq("#blockPassword").hide();
+        loadScripts();
+    });
+
     jq(document).on("click", "#beginEdit:not(.disable)", function () {
         var fileId = encodeURIComponent(jq('#hiddenFileName').val());
-        var url = UrlEditor + "?fileName=" + fileId;
+        var url = UrlEditor + "?fileName=" + fileId + "&directUrl=" + directUrl;
         window.open(url, "_blank");
         jq('#hiddenFileName').val("");
         jq.unblockUI();
@@ -192,7 +240,7 @@ if (typeof jQuery != "undefined") {
 
     jq(document).on("click", "#beginView:not(.disable)", function () {
         var fileId = encodeURIComponent(jq('#hiddenFileName').val());
-        var url = UrlEditor + "?mode=view&fileName=" + fileId;
+        var url = UrlEditor + "?editorsMode=view&fileName=" + fileId + "&directUrl=" + directUrl;
         window.open(url, "_blank");
         jq('#hiddenFileName').val("");
         jq.unblockUI();
@@ -200,7 +248,7 @@ if (typeof jQuery != "undefined") {
 
     jq(document).on("click", "#beginEmbedded:not(.disable)", function () {
         var fileId = encodeURIComponent(jq('#hiddenFileName').val());
-        var url = UrlEditor + "?editorsType=embedded&editorsMode=embedded&fileName=" + fileId;
+        var url = UrlEditor + "?editorsType=embedded&editorsMode=embedded&fileName=" + fileId + "&directUrl=" + directUrl;
 
         jq("#mainProgress").addClass("embedded");
         jq("#beginEmbedded").addClass("disable");
@@ -212,6 +260,9 @@ if (typeof jQuery != "undefined") {
         jq('#hiddenFileName').val("");
         jq("#embeddedView").attr("src", "");
         jq.unblockUI();
+        if (mustReload) {
+            document.location.reload();
+        }
     });
 
     jq(document).on("click", ".try-editor", function (e) {
@@ -241,7 +292,68 @@ if (typeof jQuery != "undefined") {
         });
     });
 
-    jq(".info").mouseover(function (event) {
+        function showUserTooltip (isMobile) {
+        if ( jq("div#portal-info").is(":hidden") ) {
+            jq("div#portal-info").show();
+            jq("div.stored-list").hide();
+        } else if (isMobile && jq("div#portal-info").is(":visible")) {
+            jq("div#portal-info").hide();
+            jq("div.stored-list").show();
+        }
+    };
+
+    function getUrlVars() {
+        var vars = [], hash;
+        var hashes = window.location.href.slice(window.location.href.indexOf('?') + 1).split('&');
+        for (var i = 0; i < hashes.length; i++) {
+            hash = hashes[i].split('=');
+            vars.push(hash[0]);
+            vars[hash[0]] = hash[1];
+        }
+        return vars;
+    };
+
+    var fileList = jq("tr.tableRow");
+
+    var mouseIsOverTooltip = false;
+    var hideTooltipTimeout = null;
+    if (/android|avantgo|playbook|blackberry|blazer|compal|elaine|fennec|hiptop|iemobile|ip(hone|od|ad)|iris|kindle|lge |maemo|midp|mmp|opera m(ob|in)i|palm( os)?|phone|p(ixi|re)\\|plucker|pocket|psp|symbian|treo|up\\.(browser|link)|vodafone|wap|windows (ce|phone)|xda|xiino/i
+        .test(navigator.userAgent)) {
+            if (fileList.length > 0) {
+                if (hideTooltipTimeout != null) {
+                    clearTimeout(hideTooltipTimeout);
+                }
+                jq("#info").on("touchend", function () {
+                    showUserTooltip(true);
+                });
+            }
+    } else {
+        jq("#info").mouseover(function (event) {
+            if (fileList.length > 0) {
+                if (hideTooltipTimeout != null) {
+                    clearTimeout(hideTooltipTimeout);
+                }
+                showUserTooltip(false);
+
+                jq("div#portal-info").mouseenter(function () {
+                    mouseIsOverTooltip = true;
+                }).mouseleave(function () {
+                    mouseIsOverTooltip = false;
+                    jq("div.stored-list").show();
+                    jq("div#portal-info").hide();
+                })
+            }
+        }).mouseleave(function () {
+            hideTooltipTimeout = setTimeout(function () {
+                if (mouseIsOverTooltip == false && fileList.length > 0) {
+                    jq("div.stored-list").show();
+                    jq("div#portal-info").hide();
+                }
+            }, 500);
+        });
+    }
+
+    jq(".info-tooltip").mouseover(function (event) {
         var target = event.target;
         var id = target.dataset.id ? target.dataset.id : target.id;
         var tooltip = target.dataset.tooltip;

web/documentserver-example/csharp-mvc/Views/Home/Editor.aspx

@@ -14,7 +14,7 @@
     <meta name="mobile-web-app-capable" content="yes" />
     <!--
     *
-    * (c) Copyright Ascensio System SIA 2021
+    * (c) Copyright Ascensio System SIA 2023
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
@@ -46,34 +46,43 @@
     <script type="text/javascript" language="javascript">
 
         var docEditor;
+        var config;
 
-        var innerAlert = function (message) {
+        var innerAlert = function (message, inEditor) {
             if (console && console.log)
                 console.log(message);
+            if (inEditor && docEditor)
+                docEditor.showMessage(message);
         };
 
+        // the application is loaded into the browser
         var onAppReady = function () {
             innerAlert("Document editor ready");
         };
 
+        // the document is modified
         var onDocumentStateChange = function (event) {
             var title = document.title.replace(/\*$/g, "");
             document.title = title + (event.data ? "*" : "");
         };
 
+        // the user is trying to switch the document from the viewing into the editing mode
         var onRequestEditRights = function () {
-            location.href = location.href.replace(RegExp("action=view\&?", "i"), "");
+            location.href = location.href.replace(RegExp("editorsMode=view\&?", "i"), "");
         };
 
+        // an error or some other specific event occurs
         var onError = function (event) {
             if (event)
                 innerAlert(event.data);
         };
 
+        // the document is opened for editing with the old document.key value
         var onOutdatedVersion = function (event) {
             location.reload(true);
         };
 
+        // replace the link to the document which contains a bookmark
         var replaceActionLink = function(href, linkParam) {
             var link;
             var actionIndex = href.indexOf("&actionLink=");
@@ -90,41 +99,86 @@
             return link;
         }
 
+        // the user is trying to get link for opening the document which contains a bookmark, scrolling to the bookmark position
         var onMakeActionLink = function (event) {
             var actionData = event.data;
             var linkParam = JSON.stringify(actionData);
-            docEditor.setActionLink(replaceActionLink(location.href, linkParam));
+            docEditor.setActionLink(replaceActionLink(location.href, linkParam));  // set the link to the document which contains a bookmark
         };
 
+        // the meta information of the document is changed via the meta command
         var onMetaChange = function (event) {
-            var favorite = !!event.data.favorite;
-            var title = document.title.replace(/^\☆/g, "");
-            document.title = (favorite ? "☆" : "") + title;
-            docEditor.setFavorite(favorite);
+            if (event.data.favorite) {
+                var favorite = !!event.data.favorite;
+                var title = document.title.replace(/^\☆/g, "");
+                document.title = (favorite ? "☆" : "") + title;
+                docEditor.setFavorite(favorite);  // change the Favorite icon state
+            }
+
+            innerAlert("onMetaChange: " + JSON.stringify(event.data));
         };
 
+        // the user is trying to insert an image by clicking the Image from Storage button
         var onRequestInsertImage = function (event) {
             <% string logoUrl;%>
             <% Model.GetLogoConfig(out logoUrl); %>
-            docEditor.insertImage({
+            docEditor.insertImage({  // insert an image into the file
                 "c": event.data.c,
                 <%= logoUrl%>
             })
         };
 
+        // the user is trying to select document for comparing by clicking the Document from Storage button
         var onRequestCompareFile = function () {
             <% string compareFileData; %>
             <% Model.GetCompareFileData(out compareFileData); %>
-            docEditor.setRevisedFile(<%=compareFileData%>);
+            docEditor.setRevisedFile(<%=compareFileData%>);  // select a document for comparing
         };
 
+        // the user is trying to select recipients data by clicking the Mail merge button
         var onRequestMailMergeRecipients = function (event) {
             <% string dataMailMergeRecipients; %>
             <% Model.GetMailMergeConfig(out dataMailMergeRecipients); %>
-            docEditor.setMailMergeRecipients(<%= dataMailMergeRecipients%>);
+            docEditor.setMailMergeRecipients(<%= dataMailMergeRecipients%>);  // insert recipient data for mail merge into the file
+        };
+        
+         var onRequestSaveAs = function (event) {  //  the user is trying to save file by clicking Save Copy as... button
+             var title = event.data.title;
+             var url = event.data.url;
+             var data = {
+                 title: title,
+                 url: url
+             };
+             let xhr = new XMLHttpRequest();
+             xhr.open("POST", "webeditor.ashx?type=saveas");
+             xhr.setRequestHeader('Content-Type', 'application/json');
+             xhr.send(JSON.stringify(data));
+             xhr.onload = function () {
+                 innerAlert(xhr.responseText);
+                 innerAlert(JSON.parse(xhr.responseText).file, true);
+             }
+         };
+
+         var onRequestRename = function(event) { //  the user is trying to rename file by clicking Rename... button
+            innerAlert("onRequestRename: " + JSON.stringify(event.data));
+
+            var newfilename = event.data;
+            var data = {
+                newfilename: newfilename,
+                dockey: config.document.key,
+                ext: config.document.fileType
+            };
+
+            let xhr = new XMLHttpRequest();
+            xhr.open("POST", "webeditor.ashx?type=rename");
+            xhr.setRequestHeader('Content-Type', 'application/json');
+            xhr.send(JSON.stringify(data));
+            xhr.onload = function () {
+                innerAlert(xhr.responseText);
+            }
         };
 
-        var config = <%= Model.GetDocConfig(Request, Url) %>;
+        config = <%= Model.GetDocConfig(Request, Url) %>;
 
         config.width = "100%";
         config.height = "100%";
@@ -144,22 +198,60 @@
 
         <% string hist, histData; %>
         <% Model.GetHistory(out hist, out histData); %>
-        <% if (!string.IsNullOrEmpty(hist) && !string.IsNullOrEmpty(histData))
-        { %>
-        config.events['onRequestHistory'] = function () {
-            docEditor.refreshHistory(<%= hist %>);
+
+        <% string usersForMentions; %>
+        <% Model.GetUsersMentions(Request, out usersForMentions); %>
+
+        if (config.editorConfig.user.id) {
+            <% if (!string.IsNullOrEmpty(hist) && !string.IsNullOrEmpty(histData))
+            { %>
+                // the user is trying to show the document version history
+                config.events['onRequestHistory'] = function () {
+                    docEditor.refreshHistory(<%= hist %>);  // show the document version history
+                };
+                // the user is trying to click the specific document version in the document version history
+                config.events['onRequestHistoryData'] = function (event) {
+                    var ver = event.data;
+                    var histData = <%= histData %>;
+                    docEditor.setHistoryData(histData[ver - 1]);  // send the link to the document for viewing the version history
+                };
+                // the user is trying to go back to the document from viewing the document version history
+                config.events['onRequestHistoryClose '] = function () {
+                    document.location.reload();
+                };
+            <% } %>
+
+            // add mentions for not anonymous users
+            <% if (!string.IsNullOrEmpty(usersForMentions))
+            { %>
+                config.events['onRequestUsers'] = function () {
+                    docEditor.setUsers({  // set a list of users to mention in the comments
+                        "users": <%= usersForMentions %>
+                    });
+                };
+            <% } %>
+
+            // the user is mentioned in a comment
+            config.events['onRequestSendNotify'] = function (event) {
+                event.data.actionLink = replaceActionLink(location.href, JSON.stringify(event.data.actionLink));
+                var data = JSON.stringify(event.data);
+                innerAlert("onRequestSendNotify: " + data);
+            };
+            // prevent file renaming for anonymous users
+            config.events['onRequestRename'] = onRequestRename;
+        }
+
+        if (config.editorConfig.createUrl) {
+            config.events.onRequestSaveAs = onRequestSaveAs;
         };
-        config.events['onRequestHistoryData'] = function (event) {
-            var ver = event.data;
-            var histData = <%= histData %>;
-            docEditor.setHistoryData(histData[ver - 1]);
-        };
-        config.events['onRequestHistoryClose '] = function () {
-            document.location.reload();
-        };
-        <% } %>
 
         var сonnectEditor = function () {
+            if ((config.document.fileType === "docxf" || config.document.fileType === "oform")
+                && DocsAPI.DocEditor.version().split(".")[0] < 7) {
+                innerAlert("Please update ONLYOFFICE Docs to version 7.0 to work on fillable forms online.");
+                return;
+            }
+
             docEditor = new DocsAPI.DocEditor("iframeEditor", config);
         };
 

web/documentserver-example/csharp-mvc/Views/Home/Index.aspx

@@ -1,8 +1,10 @@
 <%@ Page Title="ONLYOFFICE" Language="C#" Inherits="System.Web.Mvc.ViewPage" %>
 
+<%@ Import Namespace="System.IO" %>
 <%@ Import Namespace="System.Web.Configuration" %>
 <%@ Import Namespace="OnlineEditorsExampleMVC.Helpers" %>
 <%@ Import Namespace="OnlineEditorsExampleMVC.Models" %>
+<%@ Import Namespace="System.Collections.Generic" %>
 
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 
@@ -13,7 +15,7 @@
     <meta name="viewport" content="width=device-width" />
     <!--
     *
-    * (c) Copyright Ascensio System SIA 2021
+    * (c) Copyright Ascensio System SIA 2023
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
@@ -64,8 +66,11 @@
                                         <li>
                                             <a class="try-editor slide" data-type="pptx">Presentation</a>
                                         </li>
+                                        <li>
+                                            <a class="try-editor form" data-type="docxf">Form template</a>
+                                        </li>
                                     </ul>
-                                    <label class="create-sample">
+                                    <label class="side-option">
                                         <input id="createSample" class="checkbox" type="checkbox" />With sample content
                                     </label>
                                 </div>
@@ -81,162 +86,192 @@
                                     <tr>
                                         <td valign="middle">
                                             <span class="select-user">Username</span>
-                                            <img class="info" data-id="user" data-tooltip="You can open the same document using different users in different Web browser sessions, so you can check out multi-user editing functions" src="content/images/info.svg" />
-                                            <select class="select-user" id="user">
-                                                <option value="uid-1">John Smith</option>
-                                                <option value="uid-2">Mark Pottato</option>
-                                                <option value="uid-3">Hamish Mitchell</option>
-                                                <option value="uid-0">anonymous</option>
-                                            </select>
+                                             <img id="info" class="info" src="content/images/info.svg" />
+                                             <select class="select-user" id="user">
+                                            <% foreach (User user in Users.getAllUsers())
+                                               { %>
+                                                    <option value="<%= user.id %>"><%= user.name.IsEmpty() ? "Anonymous" : user.name %></option>
+                                                 <% } %>
+                                             </select>
                                         </td>
                                     </tr>
                                     <tr>
                                         <td valign="middle">
                                             <span class="select-user">Language</span>
-                                            <img class="info" data-id="language" data-tooltip="Choose the language for ONLYOFFICE editors interface" src="content/images/info.svg" />
+                                            <img class="info info-tooltip" data-id="language"
+                                                 data-tooltip="Choose the language for ONLYOFFICE editors interface"
+                                                 src="content/images/info.svg" />
                                             <select class="select-user" id="language">
-                                                <option value="en">English</option>
-                                                <option value="be">Belarusian</option>
-                                                <option value="bg">Bulgarian</option>
-                                                <option value="ca">Catalan</option>
-                                                <option value="zh">Chinese</option>
-                                                <option value="cs">Czech</option>
-                                                <option value="da">Danish</option>
-                                                <option value="nl">Dutch</option>
-                                                <option value="fi">Finnish</option>
-                                                <option value="fr">French</option>
-                                                <option value="de">German</option>
-                                                <option value="el">Greek</option>
-                                                <option value="hu">Hungarian</option>
-                                                <option value="id">Indonesian</option>
-                                                <option value="it">Italian</option>
-                                                <option value="ja">Japanese</option>
-                                                <option value="ko">Korean</option>
-                                                <option value="lv">Latvian</option>
-                                                <option value="lo">Lao</option>
-                                                <option value="nb">Norwegian</option>
-                                                <option value="pl">Polish</option>
-                                                <option value="pt">Portuguese</option>
-                                                <option value="ro">Romanian</option>
-                                                <option value="ru">Russian</option>
-                                                <option value="sk">Slovak</option>
-                                                <option value="sl">Slovenian</option>
-                                                <option value="sv">Swedish</option>
-                                                <option value="es">Spanish</option>
-                                                <option value="tr">Turkish</option>
-                                                <option value="uk">Ukrainian</option>
-                                                <option value="vi">Vietnamese</option>
+                                                <% Dictionary<string, string> languages = DocManagerHelper.GetLanguages(); 
+                                                foreach (var lang in languages)
+                                                    { %>
+                                                        <option value="<%= lang.Key %>"><%= lang.Value %></option>
+                                                    <% } %>
                                             </select>
                                         </td>
                                     </tr>
+                                    <tr>
+                                        <td valign="middle">
+                                            <label class="side-option">
+                                                <input id="directUrl" type="checkbox" class="checkbox" />Try opening on client
+                                                <img id="directUrlInfo" class="info info-tooltip" data-id="directUrlInfo" data-tooltip="Some files can be opened in the user's browser without connecting to the document server." src="content/images/info.svg" />
+                                            </label>
+                                        </td>
+                                    </tr>
                                 </tbody>
                             </table>
                         </div>
                     </td>
                     <td class="section">
                         <div class="main-panel">
-                            <%  var storedFiles = DocManagerHelper.GetStoredFiles();
-                                if (!storedFiles.Any())
+                            <% var storedFiles = DocManagerHelper.GetStoredFiles(); %>
+                            <div id="portal-info"  style="display: <%= storedFiles.Any() ? "none" : "table-cell" %>">
+                                <span class="portal-name">ONLYOFFICE Document Editors – Welcome!</span>
+                                <span class="portal-descr">
+                                    Get started with a demo-sample of ONLYOFFICE Document Editors, the first html5-based editors.
+                                    <br /> You may upload your own documents for testing using the "<b>Upload file</b>" button and <b>selecting</b> the necessary files on your PC.
+                                </span>
+                                <span class="portal-descr">Please do NOT use this integration example on your own server without proper code modifications, it is intended for testing purposes only. In case you enabled this test example, disable it before going for production.</span>
+                                <span class="portal-descr">You can open the same document using different users in different Web browser sessions, so you can check out multi-user editing functions.</span>
+                                <% foreach (User user in Users.getAllUsers())
+                                  { %>
+                                  <div class="user-descr">
+                                   <b><%= user.name.IsEmpty() ? "Anonymous" : user.name %></b>
+                                       <ul>
+                                       <% foreach (string description in user.descriptions)
+                                               { %>
+                                                   <li><%= description %></li>
+                                            <% } %>
+                                       </ul>
+                                   </div>
+                                   <% } %>
+                            </div>
+                            <%
+                                if (storedFiles.Any())
                                 { %>
-                                    <span class="portal-name">ONLYOFFICE Document Editors – Welcome!</span>
-                                        <span class="portal-descr">
-                                            Get started with a demo-sample of ONLYOFFICE Document Editors, the first html5-based editors.
-                                            <br /> You may upload your own documents for testing using the "<b>Upload file</b>" button and <b>selecting</b> the necessary files on your PC.
-                                    </span>
-                            <%  }
-                                else 
-                                { %>
-                                    <div class="stored-list">
-                                        <span class="header-list">Your documents</span>
-                                        <table class="tableHeader" cellspacing="0" cellpadding="0" width="100%">
-                                            <thead>
-                                                <tr>
-                                                    <td class="tableHeaderCell tableHeaderCellFileName">Filename</td>
-                                                    <td class="tableHeaderCell tableHeaderCellEditors contentCells-shift">Editors</td>
-                                                    <td class="tableHeaderCell tableHeaderCellViewers">Viewers</td>
-                                                    <td class="tableHeaderCell tableHeaderCellDownload">Download</td>
-                                                    <td class="tableHeaderCell tableHeaderCellRemove">Remove</td>
-                                                </tr>
-                                            </thead>
-                                        </table>
-                                        <div class="scroll-table-body">
-                                            <table cellspacing="0" cellpadding="0" width="100%">
-                                                <tbody>
-                                                    <%  foreach (var storedFile in storedFiles)
-                                                        { 
+                                <div class="stored-list">
+                                    <span class="header-list">Your documents</span>
+                                    <table class="tableHeader" cellspacing="0" cellpadding="0" width="100%">
+                                        <thead>
+                                            <tr>
+                                                <td class="tableHeaderCell tableHeaderCellFileName">Filename</td>
+                                                <td class="tableHeaderCell tableHeaderCellEditors contentCells-shift">Editors</td>
+                                                <td class="tableHeaderCell tableHeaderCellViewers">Viewers</td>
+                                                <td class="tableHeaderCell tableHeaderCellDownload">Download</td>
+                                                <td class="tableHeaderCell tableHeaderCellRemove">Remove</td>
+                                            </tr>
+                                        </thead>
+                                    </table>
+                                    <div class="scroll-table-body">
+                                        <table cellspacing="0" cellpadding="0" width="100%">
+                                            <tbody>
+                                            <% foreach (var storedFile in storedFiles)
+                                               {
+                                                            var isEnabledDirectUrl = DocManagerHelper.GetDirectUrl();
                                                             var editUrl = "doceditor.aspx?fileID=" + HttpUtility.UrlEncode(storedFile.Name);
-                                                            var docType = FileUtility.GetFileType(storedFile.Name).ToString().ToLower(); %>
+                                                            var docType = FileUtility.GetFileType(storedFile.Name).ToString().ToLower();
+                                                            var ext = Path.GetExtension(storedFile.Name).ToLower();
+                                                            var canEdit = DocManagerHelper.EditedExts.Contains(ext);
+                                                            var isFillFormDoc = DocManagerHelper.FillFormExts.Contains(ext);
+                                                        %>
 
-                                                            <tr class="tableRow" title="<%= storedFile.Name %>">
+                                                            <tr class="tableRow" title="<%= storedFile.Name %> [<%= DocManagerHelper.GetFileVersion(storedFile.Name, HttpContext.Current.Request.UserHostAddress.Replace(':', '_')) %>]">
                                                                 <td class="contentCells">
-                                                                    <a class="stored-edit <%= docType %>" href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name }) %>" target="_blank">
-                                                                        <span title="<%= storedFile.Name %>"><%= storedFile.Name %></span>
+                                                                    <a class="stored-edit <%= docType %>" href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, directUrl = isEnabledDirectUrl }) %>" target="_blank">
+                                                                        <span><%= storedFile.Name %></span>
                                                                     </a>
                                                                 </td>
-                                                                <td class="contentCells contentCells-icon">
-                                                                    <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "edit" }) %>" target="_blank">
-                                                                        <img src="content/images/desktop-24.png" alt="Open in editor for full size screens" title="Open in editor for full size screens"/>
-                                                                    </a>
-                                                                </td>
-                                                                <td class="contentCells contentCells-icon">
-                                                                    <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "mobile", editorsMode = "edit" }) %>" target="_blank">
-                                                                        <img src="content/images/mobile-24.png" alt="Open in editor for mobile devices" title="Open in editor for mobile devices"/>
-                                                                    </a>
-                                                                </td>
-                                                                <td class="contentCells contentCells-icon">
-                                                                    <% if (docType == "word") { %>
-                                                                        <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "review" }) %>" target="_blank">
-                                                                            <img src="content/images/review-24.png" alt="Open in editor for review" title="Open in editor for review"/>
+                                                                <% if (canEdit) { %>
+                                                                    <td class="contentCells contentCells-icon">
+                                                                        <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "edit", directUrl = isEnabledDirectUrl }) %>" target="_blank">
+                                                                            <img src="content/images/desktop.svg" alt="Open in editor for full size screens" title="Open in editor for full size screens"/>
                                                                         </a>
+                                                                    </td>
+                                                                    <td class="contentCells contentCells-icon">
+                                                                        <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "mobile", editorsMode = "edit", directUrl = isEnabledDirectUrl }) %>" target="_blank">
+                                                                            <img src="content/images/mobile.svg" alt="Open in editor for mobile devices" title="Open in editor for mobile devices"/>
+                                                                        </a>
+                                                                    </td>
+                                                                    <td class="contentCells contentCells-icon">
+                                                                        <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "comment", directUrl = isEnabledDirectUrl }) %>" target="_blank">
+                                                                            <img src="content/images/comment.svg" alt="Open in editor for comment" title="Open in editor for comment"/>
+                                                                        </a>
+                                                                    </td>
+                                                                    <% if (docType == "word") { %>
+                                                                        <td class="contentCells contentCells-icon">
+                                                                            <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "review", directUrl = isEnabledDirectUrl }) %>" target="_blank">
+                                                                                <img src="content/images/review.svg" alt="Open in editor for review" title="Open in editor for review"/>
+                                                                            </a>
+                                                                        </td>
                                                                     <% } else if (docType == "cell") { %>
-                                                                        <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "filter" }) %>" target="_blank">
-                                                                            <img src="content/images/filter-24.png" alt="Open in editor without access to change the filter" title="Open in editor without access to change the filter" />
-                                                                        </a>
+                                                                        <td class="contentCells contentCells-icon">
+                                                                            <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "filter", directUrl = isEnabledDirectUrl }) %>" target="_blank">
+                                                                                <img src="content/images/filter.svg" alt="Open in editor without access to change the filter" title="Open in editor without access to change the filter" />
+                                                                            </a>
+                                                                         </td>
                                                                     <% } %>
-                                                                </td>
-                                                                <td class="contentCells contentCells-icon">
-                                                                    <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "comment" }) %>" target="_blank">
-                                                                        <img src="content/images/comment-24.png" alt="Open in editor for comment" title="Open in editor for comment"/>
+                                                                    <% if (docType == "word") { %>
+                                                                        <td class="contentCells contentCells-icon">
+                                                                            <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "blockcontent", directUrl = isEnabledDirectUrl }) %>" target="_blank">
+                                                                                <img src="content/images/block-content.svg" alt="Open in editor without content control modification" title="Open in editor without content control modification"/>
+                                                                            </a>
+                                                                        </td>
+                                                                    <% } else { %>
+                                                                        <td class="contentCells contentCells-icon"></td>
+                                                                    <% } %>
+                                                                    <% if (docType != "word" && docType != "cell") { %>
+                                                                        <td class="contentCells contentCells-icon "></td>
+                                                                    <% } %>
+                                                                    <% if (isFillFormDoc) { %>
+                                                                        <td class="contentCells contentCells-shift contentCells-icon firstContentCellShift">
+                                                                            <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "fillForms", directUrl = isEnabledDirectUrl }) %>" target="_blank">
+                                                                                <img src="content/images/fill-forms.svg" alt="Open in editor for filling in forms" title="Open in editor for filling in forms"/>
+                                                                            </a>
+                                                                        </td>
+                                                                    <% } else { %>
+                                                                        <td class="contentCells contentCells-shift contentCells-icon firstContentCellShift"></td>
+                                                                        <% } %>
+                                                                <% } else if (isFillFormDoc) { %>
+                                                                    <td class="contentCells contentCells-icon "></td>
+                                                                    <td class="contentCells contentCells-icon">
+                                                                       <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "mobile", editorsMode = "fillForms", directUrl = isEnabledDirectUrl }) %>" target="_blank">
+                                                                           <img src="content/images/mobile-fill-forms.svg" alt="Open in editor for filling in forms for mobile devices" title="Open in editor for filling in forms for mobile devices"/>
+                                                                       </a>
+                                                                    </td>
+                                                                    <td class="contentCells contentCells-icon "></td>
+                                                                    <td class="contentCells contentCells-icon "></td>
+                                                                    <td class="contentCells contentCells-icon "></td>
+                                                                    <td class="contentCells contentCells-shift contentCells-icon firstContentCellShift">
+                                                                       <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "fillForms", directUrl = isEnabledDirectUrl }) %>" target="_blank">
+                                                                           <img src="content/images/fill-forms.svg" alt="Open in editor for filling in forms" title="Open in editor for filling in forms"/>
+                                                                       </a>
+                                                                    </td>
+                                                                <% } else { %>
+                                                                    <td class="contentCells contentCells-shift contentCells-icon contentCellsEmpty" colspan="6"></td>
+                                                                <% } %>
+                                                                <td class="contentCells contentCells-icon firstContentCellViewers">
+                                                                    <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "view", directUrl = isEnabledDirectUrl }) %>" target="_blank">
+                                                                        <img src="content/images/desktop.svg" alt="Open in viewer for full size screens" title="Open in viewer for full size screens"/>
                                                                     </a>
                                                                 </td>
                                                                 <td class="contentCells contentCells-icon">
-                                                                    <% if (docType == "word") { %>
-                                                                        <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "fillForms" }) %>" target="_blank">
-                                                                            <img src="content/images/fill-forms-24.png" alt="Open in editor for filling in forms" title="Open in editor for filling in forms"/>
-                                                                        </a>
-                                                                    <% } %>
-                                                                </td>
-                                                                <td class="contentCells contentCells-shift contentCells-icon">
-                                                                    <% if (docType == "word") { %>
-                                                                        <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "blockcontent" }) %>" target="_blank">
-                                                                            <img src="content/images/block-content-24.png" alt="Open in editor without content control modification" title="Open in editor without content control modification"/>
-                                                                        </a>
-                                                                    <% } %>
-                                                                </td>
-
-                                                                <td class="contentCells contentCells-icon">
-                                                                    <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "view" }) %>" target="_blank">
-                                                                        <img src="content/images/desktop-24.png" alt="Open in viewer for full size screens" title="Open in viewer for full size screens"/>
-                                                                    </a>
-                                                                </td>
-                                                                <td class="contentCells contentCells-icon">
-                                                                    <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "mobile", editorsMode = "view" }) %>" target="_blank">
-                                                                        <img src="content/images/mobile-24.png" alt="Open in viewer for mobile devices" title="Open in viewer for mobile devices"/>
+                                                                    <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "mobile", editorsMode = "view", directUrl = isEnabledDirectUrl }) %>" target="_blank">
+                                                                        <img src="content/images/mobile.svg" alt="Open in viewer for mobile devices" title="Open in viewer for mobile devices"/>
                                                                     </a>
                                                                 </td>
                                                                 <td class="contentCells contentCells-icon contentCells-shift">
-                                                                    <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "embedded", editorsMode = "embedded" }) %>" target="_blank">
-                                                                        <img src="content/images/embeded-24.png" alt="Open in embedded mode" title="Open in embedded mode"/>
+                                                                    <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "embedded", editorsMode = "embedded", directUrl = isEnabledDirectUrl }) %>" target="_blank">
+                                                                        <img src="content/images/embeded.svg" alt="Open in embedded mode" title="Open in embedded mode"/>
                                                                     </a>
                                                                 </td>
-                                                                <td class="contentCells contentCells-icon contentCells-shift">
-                                                                    <a href="webeditor.ashx?type=download&filename=<%= HttpUtility.UrlEncode(storedFile.Name) %>">
-                                                                        <img class="icon-download" src="content/images/download-24.png" alt="Download" title="Download" />
+                                                                <td class="contentCells contentCells-icon contentCells-shift downloadContentCellShift">
+                                                                    <a href="webeditor.ashx?type=download&fileName=<%= HttpUtility.UrlEncode(storedFile.Name) %>">
+                                                                        <img class="icon-download" src="content/images/download.svg" alt="Download" title="Download" />
                                                                     </a>
                                                                 </td>
                                                                 <td class="contentCells contentCells-icon contentCells-shift">
                                                                     <a class="delete-file" data-filename="<%= storedFile.Name %>">
-                                                                        <img class="icon-delete" src="content/images/delete-24.png" alt="Delete" title="Delete" />
+                                                                        <img class="icon-delete" src="content/images/delete.svg" alt="Delete" title="Delete" />
                                                                     </a>
                                                                 </td>
                                                             </tr>
@@ -263,14 +298,23 @@
             <span id="step2" class="step">2. Conversion.</span>
             <span class="step-descr">The file is converted to OOXML so that you can edit it.</span>
             <br />
+            <div id="blockPassword">
+                <span class="descrFilePass">The file is password protected.</span>
+                <br />
+                <div>
+                    <input id="filePass" type="password"/>
+                    <div id="enterPass" class="button orange">Enter</div>
+                    <div id="skipPass" class="button gray">Skip</div>
+                </div>
+                <span class="errorPass"></span>
+                <br />
+            </div>
             <span id="step3" class="step">3. Loading editor scripts.</span>
             <span class="step-descr">They are loaded only once, they will be cached on your computer.</span>
             <input type="hidden" name="hiddenFileName" id="hiddenFileName" />
             <br />
-            <br />
             <span class="progress-descr">Note the speed of all operations depends on your connection quality and server location.</span>
             <br />
-            <br />
             <div class="error-message">
                 <b>Upload error: </b><span></span>
                 <br />
@@ -279,10 +323,12 @@
         </div>
         <iframe id="embeddedView" src="" height="345px" width="432px" frameborder="0" scrolling="no" allowtransparency></iframe>
         <br />
-        <div id="beginEdit" class="button disable">Edit</div>
-        <div id="beginView" class="button gray disable">View</div>
-        <div id="beginEmbedded" class="button gray disable">Embedded view</div>
-        <div id="cancelEdit" class="button gray">Cancel</div>
+        <div class="buttonsMobile">
+            <div id="beginEdit" class="button orange disable">Edit</div>
+            <div id="beginView" class="button gray disable">View</div>
+            <div id="beginEmbedded" class="button gray disable">Embedded view</div>
+            <div id="cancelEdit" class="button gray">Cancel</div>
+        </div>
     </div>
 
     <span id="loadScripts" data-docs="<%= WebConfigurationManager.AppSettings["files.docservice.url.site"] + WebConfigurationManager.AppSettings["files.docservice.url.preloader"] %>"></span>
@@ -308,8 +354,9 @@
     </footer>
 
     <%: Scripts.Render("~/bundles/jquery", "~/bundles/scripts") %>
-    
+
     <script language="javascript" type="text/javascript">
+        var FillExtList = '<%= string.Join(",", DocManagerHelper.FillFormExts.ToArray()) %>';
         var ConverExtList = '<%= string.Join(",", DocManagerHelper.ConvertExts.ToArray()) %>';
         var EditedExtList = '<%= string.Join(",", DocManagerHelper.EditedExts.ToArray()) %>';
         var UrlConverter = '<%= Url.Content("~/webeditor.ashx?type=convert") %>';

web/documentserver-example/csharp-mvc/Views/Shared/Error.aspx

@@ -5,7 +5,7 @@
     <meta name="viewport" content="width=device-width" />
     <!--
     *
-    * (c) Copyright Ascensio System SIA 2021
+    * (c) Copyright Ascensio System SIA 2023
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.

web/documentserver-example/csharp-mvc/Web.config

@@ -10,7 +10,7 @@
   </configSections>
   <appSettings configSource="web.appsettings.config" />
   <system.web>
-    <httpRuntime targetFramework="4.5" />
+    <httpRuntime maxRequestLength="51200" targetFramework="4.5" />
     <compilation debug="true" targetFramework="4.5" />
     <pages>
       <namespaces>
@@ -26,28 +26,41 @@
   </system.web>
   <system.webServer>
     <validation validateIntegratedModeConfiguration="false" />
-	<httpProtocol>
-		<customHeaders>
-			<add name="Access-Control-Allow-Origin" value="*" />
-		</customHeaders>
-	</httpProtocol>
+    <httpProtocol>
+      <customHeaders>
+        <add name="Access-Control-Allow-Origin" value="*" />
+      </customHeaders>
+    </httpProtocol>
     <handlers>
       <remove name="ExtensionlessUrlHandler-Integrated-4.0" />
       <remove name="OPTIONSVerbHandler" />
       <remove name="TRACEVerbHandler" />
       <add name="ExtensionlessUrlHandler-Integrated-4.0" path="*." verb="*" type="System.Web.Handlers.TransferRequestHandler" preCondition="integratedMode,runtimeVersionv4.0" />
     </handlers>
+    <security>
+      <requestFiltering>
+        <requestLimits maxAllowedContentLength="52428800" />
+      </requestFiltering>
+    </security>
   </system.webServer>
   <runtime>
     <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
       <dependentAssembly>
-        <assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed" />
-        <bindingRedirect oldVersion="0.0.0.0-12.0.0.0" newVersion="12.0.0.0" />
+        <assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed" culture="neutral" />
+        <bindingRedirect oldVersion="0.0.0.0-13.0.0.0" newVersion="13.0.0.0" />
       </dependentAssembly>
       <dependentAssembly>
-        <assemblyIdentity name="WebGrease" publicKeyToken="31bf3856ad364e35" />
+        <assemblyIdentity name="WebGrease" publicKeyToken="31bf3856ad364e35" culture="neutral" />
         <bindingRedirect oldVersion="0.0.0.0-1.6.5135.21930" newVersion="1.6.5135.21930" />
       </dependentAssembly>
+      <dependentAssembly>
+        <assemblyIdentity name="System.Web.Helpers" publicKeyToken="31bf3856ad364e35" />
+        <bindingRedirect oldVersion="1.0.0.0-3.0.0.0" newVersion="3.0.0.0" />
+      </dependentAssembly>
+      <dependentAssembly>
+        <assemblyIdentity name="System.Web.WebPages" publicKeyToken="31bf3856ad364e35" />
+        <bindingRedirect oldVersion="1.0.0.0-3.0.0.0" newVersion="3.0.0.0" />
+      </dependentAssembly>
       <dependentAssembly>
         <assemblyIdentity name="System.Web.Mvc" publicKeyToken="31bf3856ad364e35" />
         <bindingRedirect oldVersion="1.0.0.0-5.2.7.0" newVersion="5.2.7.0" />
@@ -58,7 +71,4 @@
       </dependentAssembly>
     </assemblyBinding>
   </runtime>
-  <entityFramework>
-    <defaultConnectionFactory type="System.Data.Entity.Infrastructure.SqlConnectionFactory, EntityFramework" />
-  </entityFramework>
 </configuration>

web/documentserver-example/csharp-mvc/WebEditor.ashx.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -19,6 +19,7 @@
 using System;
 using System.Collections.Generic;
 using System.IO;
+using System.Text;
 using System.Linq;
 using System.Net;
 using System.Web;
@@ -37,6 +38,7 @@ namespace OnlineEditorsExampleMVC
     {
         public void ProcessRequest(HttpContext context)
         {
+            // define functions for each type of operation
             switch (context.Request["type"])
             {
                 case "upload":
@@ -45,6 +47,9 @@ namespace OnlineEditorsExampleMVC
                 case "download":
                     Download(context);
                     break;
+                case "downloadhistory":
+                    DownloadHistory(context);
+                    break;
                 case "convert":
                     Convert(context);
                     break;
@@ -63,21 +68,105 @@ namespace OnlineEditorsExampleMVC
                 case "files":
                     Files(context);
                     break;
+                case "saveas":
+                    SaveAs(context);
+                    break;
+                case "rename":
+                    Rename(context);
+                    break;
             }
         }
 
+        private static void SaveAs(HttpContext context)
+        {
+            context.Response.ContentType = "text/plain";
+            try
+            {
+                    string fileData;
+                try
+                {
+                    using (var receiveStream = context.Request.InputStream)
+                    using (var readStream = new StreamReader(receiveStream))
+                    {
+                        fileData = readStream.ReadToEnd();
+                        if (string.IsNullOrEmpty(fileData)) context.Response.Write("{\"error\":\"Request stream is empty\"}");
+                    }
+                }
+                catch (Exception e)
+                {
+                    throw new HttpException((int)HttpStatusCode.BadRequest, e.Message);
+                }
+    
+                var jss = new JavaScriptSerializer();
+                var body = jss.Deserialize<Dictionary<string, object>>(fileData);
+                var fileUrl = (string) body["url"];
+                var title = (string) body["title"];
+                var fileName = DocManagerHelper.GetCorrectName(title);
+                var extension = "." + (Path.GetExtension(fileName).ToLower() ?? "").Trim('.');
+    
+                var allExt = DocManagerHelper.ConvertExts
+                    .Concat(DocManagerHelper.EditedExts)
+                    .Concat(DocManagerHelper.ViewedExts)
+                    .Concat(DocManagerHelper.FillFormExts)
+                    .ToArray();
+    
+                if (!allExt.Contains(extension))
+                { 
+                    context.Response.Write("{\"error\":\"File type is not supported\"}");
+                }
+                
+                var req = (HttpWebRequest)WebRequest.Create(fileUrl);
+    
+                DocManagerHelper.VerifySSL();
+
+                using (var stream = req.GetResponse().GetResponseStream())
+                {
+                    
+                    if (stream == null || req.GetResponse().ContentLength <= 0 || req.GetResponse().ContentLength > DocManagerHelper.MaxFileSize)
+                    {
+                        context.Response.Write("{\"error\": \"File size is incorrect\"}");
+                    }
+                    const int bufferSize = 4096;
+                
+                    using (var fs = File.Open(DocManagerHelper.StoragePath(fileName, null), FileMode.Create))
+                    {
+                        var buffer = new byte[bufferSize];
+                        int readed;
+                        while ((readed = stream.Read(buffer, 0, bufferSize)) != 0)
+                        {
+                            fs.Write(buffer, 0, readed);  // write bytes to the output stream
+                        }
+                    }
+                }
+                    
+                var id = context.Request.Cookies.GetOrDefault("uid", null);
+                var user = Users.getUser(id);  // get the user
+                DocManagerHelper.CreateMeta(fileName, user.id, user.name, null);
+    
+                context.Response.Write("{ \"file\": \"" + fileName + "\"}");
+            }
+            catch (Exception e)
+            {
+                context.Response.Write("{ \"error\": \"" + 1 + "\", \"message\": \"" + e.Message + "\"}");
+            }
+        }
+
+        // upload a file
         private static void Upload(HttpContext context)
         {
             context.Response.ContentType = "text/plain";
             try
             {
+                DocManagerHelper.VerifySSL();
+                
                 var httpPostedFile = context.Request.Files[0];
                 string fileName;
 
+                // check from which browser the request came for
                 if (HttpContext.Current.Request.Browser.Browser.ToUpper() == "IE")
                 {
                     var files = httpPostedFile.FileName.Split(new char[] { '\\' });
-                    fileName = files[files.Length - 1];
+                    fileName = files[files.Length - 1];  // get file name
                 }
                 else
                 {
@@ -85,23 +174,26 @@ namespace OnlineEditorsExampleMVC
                 }
 
                 var curSize = httpPostedFile.ContentLength;
-                if (DocManagerHelper.MaxFileSize < curSize || curSize <= 0)
+                if (DocManagerHelper.MaxFileSize < curSize || curSize <= 0)  // check if the file size exceeds the maximum file size
                 {
                     throw new Exception("File size is incorrect");
                 }
 
                 var curExt = (Path.GetExtension(fileName) ?? "").ToLower();
-                if (!DocManagerHelper.FileExts.Contains(curExt))
+                if (!DocManagerHelper.FileExts.Contains(curExt))  // check if the file extension is supported by the editor
                 {
                     throw new Exception("File type is not supported");
                 }
 
-                fileName = DocManagerHelper.GetCorrectName(fileName);
+                fileName = DocManagerHelper.GetCorrectName(fileName);  // get the correct file name if such a name already exists
                 var documentType = FileUtility.GetFileType(fileName).ToString().ToLower();
 
-                var savedFileName = DocManagerHelper.StoragePath(fileName);
-                httpPostedFile.SaveAs(savedFileName);
-                DocManagerHelper.CreateMeta(fileName, context.Request.Cookies.GetOrDefault("uid", ""), context.Request.Cookies.GetOrDefault("uname", ""));
+                var savedFileName = DocManagerHelper.StoragePath(fileName);  // get the storage path to the uploading file
+                httpPostedFile.SaveAs(savedFileName);  // and save it
+                // get file meta information or create the default one
+                var id = context.Request.Cookies.GetOrDefault("uid", null);
+                var user = Users.getUser(id);
+                DocManagerHelper.CreateMeta(fileName, user.id, user.name);
 
                 context.Response.Write("{ \"filename\": \"" + fileName + "\", \"documentType\": \"" + documentType + "\"}");
             }
@@ -111,20 +203,37 @@ namespace OnlineEditorsExampleMVC
             }
         }
 
+        // convert a file
         private static void Convert(HttpContext context)
         {
             context.Response.ContentType = "text/plain";
             try
             {
-                var fileName = Path.GetFileName(context.Request["filename"]);
-                var fileUri = DocManagerHelper.GetFileUri(fileName, true);
+                string fileData;
 
-                var extension = (Path.GetExtension(fileUri).ToLower() ?? "").Trim('.');
+                using (var receiveStream = context.Request.InputStream)
+                using (var readStream = new StreamReader(receiveStream))
+                {
+                    fileData = readStream.ReadToEnd();
+                    if (string.IsNullOrEmpty(fileData)) context.Response.Write("{\"error\":1,\"message\":\"Request stream is empty\"}");
+                }
+
+                var jss = new JavaScriptSerializer();
+                var body = jss.Deserialize<Dictionary<string, object>>(fileData);
+
+                var fileName = Path.GetFileName(body["filename"].ToString());
+                var lang = context.Request.Cookies.GetOrDefault("ulang", null);
+                var filePass = body["filePass"] != null ? body["filePass"].ToString() : null;
+                var fileUri = DocManagerHelper.GetDownloadUrl(fileName);
+
+                var extension = (Path.GetExtension(fileName).ToLower() ?? "").Trim('.');
                 var internalExtension = DocManagerHelper.GetInternalExtension(FileUtility.GetFileType(fileName)).Trim('.');
 
+                // check if the file with such an extension can be converted
                 if (DocManagerHelper.ConvertExts.Contains("." + extension)
                     && !string.IsNullOrEmpty(internalExtension))
                 {
+                    // generate document key
                     var key = ServiceConverter.GenerateRevisionId(fileUri);
 
                     var downloadUri = new UriBuilder(DocManagerHelper.GetServerUrl(true))
@@ -135,19 +244,23 @@ namespace OnlineEditorsExampleMVC
                         Query = "type=download&fileName=" + HttpUtility.UrlEncode(fileName)
                     };
 
+                    // get the url to the converted file
                     string newFileUri;
-                    var result = ServiceConverter.GetConvertedUri(downloadUri.ToString(), extension, internalExtension, key, true, out newFileUri);
+                    var result = ServiceConverter.GetConvertedUri(downloadUri.ToString(), extension, internalExtension, key, true, out newFileUri, filePass, lang);
                     if (result != 100)
                     {
                         context.Response.Write("{ \"step\" : \"" + result + "\", \"filename\" : \"" + fileName + "\"}");
                         return;
                     }
 
+                    // get a file name of an internal file extension with an index if the file with such a name already exists
                     var correctName = DocManagerHelper.GetCorrectName(Path.GetFileNameWithoutExtension(fileName) + "." + internalExtension);
 
                     var req = (HttpWebRequest)WebRequest.Create(newFileUri);
 
-                    using (var stream = req.GetResponse().GetResponseStream())
+                    DocManagerHelper.VerifySSL();
+
+                    using (var stream = req.GetResponse().GetResponseStream())  // get response stream of the converting file
                     {
                         if (stream == null) throw new Exception("Stream is null");
                         const int bufferSize = 4096;
@@ -158,14 +271,16 @@ namespace OnlineEditorsExampleMVC
                             int readed;
                             while ((readed = stream.Read(buffer, 0, bufferSize)) != 0)
                             {
-                                fs.Write(buffer, 0, readed);
+                                fs.Write(buffer, 0, readed);  // write bytes to the output stream
                             }
                         }
                     }
 
-                    Remove(fileName);
-                    fileName = correctName;
-                    DocManagerHelper.CreateMeta(fileName, context.Request.Cookies.GetOrDefault("uid", ""), context.Request.Cookies.GetOrDefault("uname", ""));
+                    Remove(fileName);  // remove the original file and its history if it exists
+                    fileName = correctName;  // create meta information about the converted file with user id and name specified
+                    var id = context.Request.Cookies.GetOrDefault("uid", null);
+                    var user = Users.getUser(id);
+                    DocManagerHelper.CreateMeta(fileName, user.id, user.name);
                 }
 
                 var documentType = FileUtility.GetFileType(fileName).ToString().ToLower();
@@ -177,6 +292,7 @@ namespace OnlineEditorsExampleMVC
             }
         }
 
+        // define tracker status
         private enum TrackerStatus
         {
             NotFound = 0,
@@ -188,14 +304,16 @@ namespace OnlineEditorsExampleMVC
             CorruptedForceSave = 7
         }
 
+        // track file changes
         private static void Track(HttpContext context)
         {
+            // read request body
             var fileData = TrackManager.readBody(context);
 
             var userAddress = context.Request["userAddress"];
             var fileName = Path.GetFileName(context.Request["fileName"]);
-            var status = (TrackerStatus) (int) fileData["status"];
-            var saved = 1;
+            var status = (TrackerStatus) (int) fileData["status"];  // get status from the request body
+            var saved = 0;
             switch (status)
             {
                 case TrackerStatus.Editing:
@@ -204,13 +322,13 @@ namespace OnlineEditorsExampleMVC
                         var jss = new JavaScriptSerializer();
                         var actions = jss.Deserialize <List<object>> (jss.Serialize(fileData["actions"]));
                         var action = jss.Deserialize <Dictionary<string, object>> (jss.Serialize(actions[0]));
-                        if (action != null && action["type"].ToString().Equals("0"))
+                        if (action != null && action["type"].ToString().Equals("0"))  // finished edit
                         {
-                            var user = action["userid"].ToString();
+                            var user = action["userid"].ToString();  // the user who finished editing
                             var users = jss.Deserialize<List<object>>(jss.Serialize(fileData["users"]));
                             if (!users.Contains(user))
                             {
-                                TrackManager.commandRequest("forcesave", fileData["key"].ToString());
+                                TrackManager.commandRequest("forcesave", fileData["key"].ToString());  // create a command request with the forcesave method
                             }
 
                         }
@@ -221,10 +339,12 @@ namespace OnlineEditorsExampleMVC
                     }
                     break;
 
+                // MustSave, Corrupted
                 case TrackerStatus.MustSave:
                 case TrackerStatus.Corrupted:
                     try
                     {
+                        // saving a document
                         saved = TrackManager.processSave(fileData, fileName, userAddress);
                     }
                     catch (Exception)
@@ -234,10 +354,12 @@ namespace OnlineEditorsExampleMVC
                     context.Response.Write("{\"error\":" + saved + "}");
                     return;
 
+                // MustForceSave, CorruptedForceSave
                 case TrackerStatus.MustForceSave:
                 case TrackerStatus.CorruptedForceSave:
                     try
                     {
+                        // force saving a document
                         saved = TrackManager.processForceSave(fileData, fileName, userAddress);
                     }
                     catch (Exception)
@@ -248,16 +370,17 @@ namespace OnlineEditorsExampleMVC
                     return;
             }
 
-            context.Response.Write("{\"error\":0}");
+            context.Response.Write("{\"error\":" + saved + "}");
         }
 
+        // remove a file
         private static void Remove(HttpContext context)
         {
             context.Response.ContentType = "text/plain";
             try
             {
                 var fileName = Path.GetFileName(context.Request["fileName"]);
-                Remove(fileName);
+                Remove(fileName);  // remove a file and its history if it exists
 
                 context.Response.Write("{ \"success\": true }");
             }
@@ -267,15 +390,17 @@ namespace OnlineEditorsExampleMVC
             }
         }
 
+        // remove a file by its name
         private static void Remove(string fileName)
         {
-            var path = DocManagerHelper.StoragePath(fileName, null);
-            var histDir = DocManagerHelper.HistoryDir(path);
+            var path = DocManagerHelper.StoragePath(fileName, null);  // delete file
+            var histDir = DocManagerHelper.HistoryDir(path);  // delete file history
 
             if (File.Exists(path)) File.Delete(path);
             if (Directory.Exists(histDir)) Directory.Delete(histDir, true);
         }
 
+        // get files information
         private static void Files(HttpContext context)
         {
             List<Dictionary<string, object>> files = null;
@@ -287,12 +412,12 @@ namespace OnlineEditorsExampleMVC
 
                 if (context.Request["fileId"] == null)
                 {
-                    files = DocManagerHelper.GetFilesInfo();
+                    files = DocManagerHelper.GetFilesInfo();  // get the information about the files from the storage path
                     context.Response.Write(jss.Serialize(files));
                 }
                 else
                 {
-                    var fileId = context.Request["fileId"];
+                    var fileId = context.Request["fileId"];  // get file id from the request
                     files = DocManagerHelper.GetFilesInfo(fileId);
                     if (files.Count == 0)
                     {
@@ -310,6 +435,7 @@ namespace OnlineEditorsExampleMVC
             }
         }
 
+        // get sample files from the assests
         private static void Assets(HttpContext context)
         {
             var fileName = Path.GetFileName(context.Request["filename"]);
@@ -317,6 +443,7 @@ namespace OnlineEditorsExampleMVC
             download(filePath, context);
         }
 
+        // download a csv file
         private static void GetCsv(HttpContext context)
         {
             var fileName = "csv.csv";
@@ -324,16 +451,38 @@ namespace OnlineEditorsExampleMVC
             download(filePath, context);
         }
 
+        // download a file
         private static void Download(HttpContext context)
         {
             try
             {
-                var fileName = Path.GetFileName(context.Request["filename"]);
+                var fileName = Path.IsPathRooted(WebConfigurationManager.AppSettings["storage-path"]) ? context.Request["fileName"] 
+                    : Path.GetFileName(context.Request["fileName"]);
+                var userAddress = context.Request["userAddress"];
+                var isEmbedded = context.Request["dmode"];
 
-                var filePath = DocManagerHelper.ForcesavePath(fileName, null, false);
-                if (filePath.Equals(""))
+                if (JwtManager.Enabled && isEmbedded == null && userAddress != null)
                 {
-                    filePath = DocManagerHelper.StoragePath(fileName, null);
+                    string JWTheader = string.IsNullOrEmpty(WebConfigurationManager.AppSettings["files.docservice.header"]) ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
+
+                    string token = "";
+                    if (context.Request.Headers.AllKeys.Contains(JWTheader, StringComparer.InvariantCultureIgnoreCase))
+                    {
+                        var headerToken = context.Request.Headers.Get(JWTheader).Substring("Bearer ".Length);
+                        token = JwtManager.Decode(headerToken);
+                    }
+                    if (string.IsNullOrEmpty(token))
+                    {
+                        context.Response.StatusCode = (int)HttpStatusCode.Forbidden;
+                        context.Response.Write("JWT validation failed");
+                        return;
+                    }
+                }
+
+                var filePath = DocManagerHelper.ForcesavePath(fileName, userAddress, false);  // get the path to the force saved document version
+                if (string.IsNullOrEmpty(filePath))
+                {
+                    filePath = DocManagerHelper.StoragePath(fileName, userAddress);  // or to the original document
                 }
                 download(filePath, context);
             }
@@ -343,10 +492,11 @@ namespace OnlineEditorsExampleMVC
             }
         }
 
+        // download data from the url to the file
         private static void download(string filePath, HttpContext context)
         {
             var fileinf = new FileInfo(filePath);
-            context.Response.AddHeader("Content-Length", fileinf.Length.ToString());
+            context.Response.AddHeader("Content-Length", fileinf.Length.ToString());  // set headers to the response
             context.Response.AddHeader("Content-Type", MimeMapping.GetMimeMapping(filePath));
             var tmp = HttpUtility.UrlEncode(Path.GetFileName(filePath));
             tmp = tmp.Replace("+", "%20");
@@ -358,5 +508,88 @@ namespace OnlineEditorsExampleMVC
         {
             get { return false; }
         }
+
+        // download a history file
+        private static void DownloadHistory(HttpContext context)
+        {
+            try
+            {
+                var fileName = Path.GetFileName(context.Request["fileName"]);
+                var userAddress = Path.GetFileName(context.Request["userAddress"]);
+                var version = System.Convert.ToInt32(context.Request["ver"]);
+                var file = Path.GetFileName(context.Request["file"]);
+
+                if (JwtManager.Enabled)
+                {
+                    string JWTheader = string.IsNullOrEmpty(WebConfigurationManager.AppSettings["files.docservice.header"]) ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
+
+                    if (context.Request.Headers.AllKeys.Contains(JWTheader, StringComparer.InvariantCultureIgnoreCase))
+                    {
+                        var headerToken = context.Request.Headers.Get(JWTheader).Substring("Bearer ".Length);
+                        string token = JwtManager.Decode(headerToken);
+
+                        if (string.IsNullOrEmpty(token))
+                        {
+                            context.Response.StatusCode = (int)HttpStatusCode.Forbidden;
+                            context.Response.Write("JWT validation failed");
+                            return;
+                        }
+                    }
+                    else
+                    {
+                        context.Response.StatusCode = (int)HttpStatusCode.Forbidden;
+                        context.Response.Write("JWT validation failed");
+                        return;
+                    }
+                }
+                var histPath = DocManagerHelper.HistoryDir(DocManagerHelper.StoragePath(fileName, userAddress));
+                var filePath = Path.Combine(DocManagerHelper.VersionDir(histPath, version), file);  // get the path to document version
+
+                download(filePath, context);
+            }
+            catch (Exception)
+            {
+                context.Response.Write("{ \"error\": \"File not found!\"}");
+            }
+        }
+
+        // rename a file
+        private static void Rename(HttpContext context)
+        {
+            // read request body
+            context.Response.ContentType = "text/plain";
+            string fileData;
+            try
+            {
+                using (var receiveStream = context.Request.InputStream)
+                using (var readStream = new StreamReader(receiveStream))
+                {
+                    fileData = readStream.ReadToEnd();
+                    if (string.IsNullOrEmpty(fileData)) context.Response.Write("{\"error\":\"Request stream is empty\"}");
+                }
+            }
+            catch (Exception e)
+            {
+                throw new HttpException((int)HttpStatusCode.BadRequest, e.Message);
+            }
+
+            var jss = new JavaScriptSerializer();
+            var body = jss.Deserialize<Dictionary<string, object>>(fileData);
+            var newFileName = (string) body["newfilename"];
+            var docKey = (string) body["dockey"];
+
+            var origExt = '.' + (string) body["ext"];
+            var curExt = Path.GetExtension(newFileName).ToLower();
+
+            if (string.Compare(origExt, curExt, true) != 0)
+            {
+                newFileName += origExt;
+            }
+            var meta =  new Dictionary<string, object>() {
+                { "title", newFileName }
+            };
+            TrackManager.commandRequest("meta", docKey, meta);
+            context.Response.Write("{ \"result\": \"OK\"}");
+        }
     }
 }

web/documentserver-example/csharp-mvc/licenses/3rd-Party.license

@@ -24,11 +24,15 @@ jQuery.UI     - jQuery UI is an open source library of interface components —
 License:        MIT
 License File:   jQuery.UI.license
 
+JWT           - JWT (JSON Web Token) Implementation for .NET (Public Domain) (https://github.com/jwt-dotnet/jwt/)
+License:        MIT
+License File:   JWT.license
+
 Microsoft.Web.Infrastructure - This package contains the Microsoft.Web.Infrastructure assembly that lets you dynamically register HTTP modules at run time. (https://www.microsoft.com/web/webpi/eula/aspnetmvc3update-eula.htm)
 License:        MS-EULA License
 License File:   Microsoft.Web.Infrastructure.license
 
-Newtonsoft.Json - Json.NET is a popular high-performance JSON framework for .NET (https://licenses.nuget.org/MIT)
+Newtonsoft.Json - Json.NET is a popular high-performance JSON framework for .NET (https://github.com/JamesNK/Newtonsoft.Json)
 License:        MIT
 License File:   Newtonsoft.Json.license
 

web/documentserver-example/csharp-mvc/licenses/JWT.license

@@ -0,0 +1,21 @@
+# Public Domain
+
+Written by John Sheehan (http://john-sheehan.com)
+
+This work is public domain.
+
+The person who associated a work with this deed has dedicated the work to the public domain by waiving all of his or her rights to the work worldwide under copyright law, including all related and neighboring rights, to the extent allowed by law.
+
+For more information, please visit: http://creativecommons.org/publicdomain/zero/1.0/
+
+# MIT
+
+Copyright (c) 2019 Jwt.Net Maintainers and Contributors.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+For more information, please visit: https://opensource.org/licenses/MIT

web/documentserver-example/csharp-mvc/packages.config

@@ -1,16 +1,17 @@
 <?xml version="1.0" encoding="utf-8"?>
 <packages>
-  <package id="Antlr" version="3.5.0.2" targetFramework="net45" />
-  <package id="EntityFramework" version="6.4.4" targetFramework="net45" />
-  <package id="Microsoft.AspNet.Mvc" version="5.2.7" targetFramework="net45" />
-  <package id="Microsoft.AspNet.Razor" version="3.2.7" targetFramework="net45" />
-  <package id="Microsoft.AspNet.Web.Optimization" version="1.1.3" targetFramework="net45" />
-  <package id="Microsoft.AspNet.WebApi.Client" version="5.2.7" targetFramework="net45" />
-  <package id="Microsoft.AspNet.WebApi.Core" version="5.2.7" targetFramework="net45" />
-  <package id="Microsoft.AspNet.WebApi.WebHost" version="5.2.7" targetFramework="net45" />
-  <package id="Microsoft.AspNet.WebPages" version="3.2.7" targetFramework="net45" />
-  <package id="Microsoft.CSharp" version="4.7.0" targetFramework="net45" />
-  <package id="Microsoft.Web.Infrastructure" version="1.0.0.0" targetFramework="net45" />
-  <package id="Newtonsoft.Json" version="12.0.3" targetFramework="net45" />
-  <package id="WebGrease" version="1.6.0" targetFramework="net45" />
+  <package id="Antlr" version="3.5.0.2" targetFramework="net48" />
+  <package id="EntityFramework" version="6.4.4" targetFramework="net48" />
+  <package id="JWT" version="9.0.3" targetFramework="net48" />
+  <package id="Microsoft.AspNet.Mvc" version="5.2.7" targetFramework="net48" />
+  <package id="Microsoft.AspNet.Razor" version="3.2.7" targetFramework="net48" />
+  <package id="Microsoft.AspNet.Web.Optimization" version="1.1.3" targetFramework="net48" />
+  <package id="Microsoft.AspNet.WebApi.Client" version="5.2.7" targetFramework="net48" />
+  <package id="Microsoft.AspNet.WebApi.Core" version="5.2.7" targetFramework="net48" />
+  <package id="Microsoft.AspNet.WebApi.WebHost" version="5.2.7" targetFramework="net48" />
+  <package id="Microsoft.AspNet.WebPages" version="3.2.7" targetFramework="net48" />
+  <package id="Microsoft.CSharp" version="4.7.0" targetFramework="net48" />
+  <package id="Microsoft.Web.Infrastructure" version="1.0.0.0" targetFramework="net48" />
+  <package id="Newtonsoft.Json" version="13.0.1" targetFramework="net48" />
+  <package id="WebGrease" version="1.6.0" targetFramework="net48" />
 </packages>

web/documentserver-example/csharp-mvc/web.appsettings.config

@@ -1,22 +1,24 @@
-<?xml version="1.0"?>
+<?xml version="1.0"?>
 <appSettings>
   <clear />
-  <add key="webpages:Version" value="2.0.0.0" />
-  <add key="webpages:Enabled" value="false" />
-  <add key="PreserveLoginUrl" value="true" />
-  <add key="ClientValidationEnabled" value="true" />
-  <add key="UnobtrusiveJavaScriptEnabled" value="true" />
+  <add key="version" value="1.5.0"/>
 
-  <add key="filesize-max" value="5242880"/>
-
-  <add key="files.docservice.viewed-docs" value=".pdf|.djvu|.xps"/>
-  <add key="files.docservice.edited-docs" value=".docx|.xlsx|.csv|.pptx|.txt"/>
-  <add key="files.docservice.convert-docs" value=".docm|.dotx|.dotm|.dot|.doc|.odt|.fodt|.ott|.xlsm|.xltx|.xltm|.xlt|.xls|.ods|.fods|.ots|.pptm|.ppt|.ppsx|.ppsm|.pps|.potx|.potm|.pot|.odp|.fodp|.otp|.rtf|.mht|.html|.htm|.xml|.epub|.fb2"/>
+  <add key="filesize-max" value="52428800"/>
+  <add key="storage-path" value=""/>
+  
+  <add key="files.docservice.fillform-docs" value=".oform|.docx"/>
+  <add key="files.docservice.viewed-docs" value=".pdf|.djvu|.xps|.oxps"/>
+  <add key="files.docservice.edited-docs" value=".docx|.xlsx|.csv|.pptx|.txt|.docxf"/>
+  <add key="files.docservice.convert-docs" value=".docm|.dotx|.dotm|.dot|.doc|.odt|.fodt|.ott|.xlsm|.xlsb|.xltx|.xltm|.xlt|.xls|.ods|.fods|.ots|.pptm|.ppt|.ppsx|.ppsm|.pps|.potx|.potm|.pot|.odp|.fodp|.otp|.rtf|.mht|.html|.htm|.xml|.epub|.fb2"/>
   <add key="files.docservice.timeout" value="120000" />
   <add key="files.docservice.secret" value="" />
   <add key="files.docservice.header" value="Authorization" />
 
-  <add key="files.docservice.url.site" value="https://documentserver/"/>
+  <add key="files.docservice.verify-peer-off" value="true"/>
+
+  <add key="files.docservice.languages" value="en:English|hy:Armenian|az:Azerbaijani|eu:Basque|be:Belarusian|bg:Bulgarian|ca:Catalan|zh:Chinese (People's Republic of China)|zh-TW:Chinese (Traditional, Taiwan)|cs:Czech|da:Danish|nl:Dutch|fi:Finnish|fr:French|gl:Galego|de:German|el:Greek|hu:Hungarian|id:Indonesian|it:Italian|ja:Japanese|ko:Korean|lv:Latvian|lo:Lao|ms:Malay (Malaysia)|nb:Norwegian|pl:Polish|pt:Portuguese (Brazil)|pt-PT:Portuguese (Portugal)|ro:Romanian|ru:Russian|sk:Slovak|sl:Slovenian|es:Spanish|sv:Swedish|tr:Turkish|uk:Ukrainian|vi:Vietnamese|aa-AA: Test Language"/>
+
+  <add key="files.docservice.url.site" value="http://documentserver/"/>
 
   <add key="files.docservice.url.converter" value="ConvertService.ashx"/>
   <add key="files.docservice.url.api" value="web-apps/apps/api/documents/api.js"/>
@@ -25,4 +27,10 @@
 
   <add key="files.docservice.url.example" value=""/>
 
+  <add key="webpages:Version" value="2.0.0.0" />
+  <add key="webpages:Enabled" value="false" />
+  <add key="PreserveLoginUrl" value="true" />
+  <add key="ClientValidationEnabled" value="true" />
+  <add key="UnobtrusiveJavaScriptEnabled" value="true" />
+
 </appSettings>

web/documentserver-example/csharp/3rd-Party.license

@@ -19,3 +19,11 @@ License File:   jQuery.iframe-transport.license
 jQuery.UI     - jQuery UI is an open source library of interface components — interactions, full-featured widgets, and animation effects — based on the stellar jQuery javascript library . Each component is built according to jQuery's event-driven architecture (find something, manipulate it) and is themeable, making it easy for developers of any skill level to integrate and extend into their own code. (https://jquery.org/license/)
 License:        MIT
 License File:   jQuery.UI.license
+
+JWT           - JWT (JSON Web Token) Implementation for .NET (Public Domain) (https://github.com/jwt-dotnet/jwt/)
+License:        MIT
+License File:   JWT.license
+
+Newtonsoft.Json - Json.NET is a popular high-performance JSON framework for .NET (https://github.com/JamesNK/Newtonsoft.Json)
+License:        MIT
+License File:   Newtonsoft.Json.license

web/documentserver-example/csharp/App_Themes/images/block-content.svg

@@ -0,0 +1,5 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<rect x="3" y="11" width="4" height="1" fill="#444444"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M2 13V10H10V8H1C0.447715 8 0 8.44772 0 9V14C0 14.5523 0.447715 15 1 15H10V13H2Z" fill="#444444"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M23.5243 10.5534L22.2366 10.3386C22.143 9.95592 22.0065 9.59014 21.8288 9.24897L22.6532 8.22679C22.8285 8.01077 22.8205 7.69994 22.6357 7.49145L22.1235 6.91502C21.9379 6.70675 21.63 6.6627 21.3952 6.81106L20.2939 7.50337C19.8095 7.16494 19.2608 6.91502 18.6689 6.77L18.4535 5.4753C18.4083 5.20115 18.171 5 17.8926 5H17.1207C16.8428 5 16.6048 5.20115 16.5606 5.4753L16.344 6.77041C15.8546 6.89023 15.3958 7.08363 14.9771 7.33835L13.9297 6.59088C13.704 6.42961 13.394 6.45483 13.197 6.65139L12.6517 7.19707C12.4552 7.39406 12.4299 7.7041 12.5916 7.92983L13.3408 8.97921C13.0885 9.39477 12.8971 9.85099 12.7773 10.336L11.4753 10.5534C11.2015 10.5986 11 10.8359 11 11.1144V11.8856C11 12.1641 11.2015 12.4014 11.4753 12.4466L12.7773 12.664C12.8757 13.0631 13.0185 13.4444 13.2083 13.7978L12.3877 14.8142C12.213 15.0301 12.2203 15.3411 12.4051 15.5494L12.9169 16.1258C13.1026 16.3345 13.4106 16.3778 13.6455 16.2298L14.7626 15.528C15.2353 15.8513 15.7701 16.0889 16.344 16.2298L16.5606 17.5247C16.6048 17.7988 16.8428 18 17.1207 18H17.8926C18.171 18 18.4083 17.7989 18.4535 17.5247L18.6693 16.2298C19.1525 16.1116 19.6055 15.9215 20.0205 15.6712L21.1115 16.4504C21.3368 16.6122 21.6471 16.5868 21.8439 16.3897L22.3894 15.8442C22.5857 15.6478 22.6123 15.3379 22.4492 15.1118L21.6725 14.0227C21.9255 13.6058 22.118 13.1487 22.237 12.6616L23.5248 12.4465C23.7993 12.4013 24 12.1641 24 11.8856V11.1143C23.9996 10.8359 23.7989 10.5986 23.5243 10.5534ZM17.5204 13.9375C16.1745 13.9375 15.0829 12.8457 15.0829 11.5C15.0829 10.1541 16.1745 9.0625 17.5204 9.0625C18.866 9.0625 19.9578 10.1541 19.9578 11.5C19.9578 12.8457 18.866 13.9375 17.5204 13.9375Z" fill="#444444"/>
+</svg>

web/documentserver-example/csharp/App_Themes/images/comment.svg

@@ -0,0 +1,3 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M5 6C4.44772 6 4 6.44772 4 7V16.4074C4 16.9597 4.44772 17.4074 5 17.4074H6.72783C7.02679 17.4074 7.31006 17.5412 7.50002 17.772L8.56115 19.0616C8.96117 19.5477 9.7055 19.5477 10.1055 19.0616L11.1667 17.772C11.3566 17.5412 11.6399 17.4074 11.9388 17.4074H19C19.5523 17.4074 20 16.9597 20 16.4074V7C20 6.44772 19.5523 6 19 6H5ZM17 9H7V10H17V9ZM17 11H7V12H17V11ZM7 13H15V14H7V13Z" fill="#444444"/>
+</svg>

web/documentserver-example/csharp/App_Themes/images/delete.svg

@@ -0,0 +1,3 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M18 18.0001L17.9952 16.401L13.5964 12.0025L17.9998 7.59937L17.9998 6L16.4004 6.00008L11.997 10.4032L7.59925 6.00568L5.99999 6.00013L5.99988 7.60497L10.3977 12.0025L6.00447 16.3954L6.00001 18.0001L7.60384 17.9947L11.997 13.6018L16.3958 18.0003L18 18.0001Z" fill="#444444"/>
+</svg>

web/documentserver-example/csharp/App_Themes/images/desktop.svg

@@ -0,0 +1,3 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M19 6H5L5 15H19V6ZM5 4C3.89543 4 3 4.89543 3 6V15C3 16.1046 3.89543 17 5 17H10V18H6V20H18V18H14V17H19C20.1046 17 21 16.1046 21 15V6C21 4.89543 20.1046 4 19 4H5Z" fill="#444444"/>
+</svg>

web/documentserver-example/csharp/App_Themes/images/download.svg

@@ -0,0 +1,4 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M6 16V13H7.2V11H5C4.44772 11 4 11.4477 4 12V17C4 17.5523 4.44772 18 5 18H19C19.5523 18 20 17.5523 20 17V12C20 11.4477 19.5523 11 19 11H16.8V13H18V16H6Z" fill="#444444"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M13.9996 8.5L15.2025 8.5C15.7911 8.5 16 8.49063 16 8.75503C16 8.94763 15.8986 9.29489 15.6987 9.4874L12.6667 12.6478C12.179 13.1174 11.821 13.1174 11.3333 12.6478L8.30133 9.4874C8.10142 9.29489 8 8.94763 8 8.75503C8 8.49056 8.20889 8.5 8.79749 8.5C8.79749 8.5 9.4909 8.5 9.99708 8.5C9.99708 8.28638 9.99708 5 9.99708 5L13.9996 5C13.9996 5 13.9996 8.29916 13.9996 8.5Z" fill="#444444"/>
+</svg>

web/documentserver-example/csharp/App_Themes/images/embeded.svg

@@ -0,0 +1,5 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<rect x="4" y="6" width="16" height="13" rx="1" stroke="#444444" stroke-width="2"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M14.148 8.69651C13.8858 8.43384 13.4601 8.43384 13.1979 8.69651V8.69651C12.9362 8.95858 12.9362 9.38302 13.1979 9.64509L15.3401 11.7908C15.7296 12.1809 15.7299 12.8126 15.3409 13.2031L13.1967 15.3554C12.9357 15.6173 12.9357 16.041 13.1967 16.3029V16.3029C13.4591 16.5663 13.8855 16.5663 14.1478 16.3029L17.3302 13.1086V13.1086C17.668 12.7702 17.668 12.2222 17.3302 11.8838L14.148 8.69651Z" fill="#444444"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M9.85199 16.3035C10.1142 16.5662 10.5399 16.5662 10.8021 16.3035V16.3035C11.0638 16.0414 11.0638 15.617 10.8021 15.3549L8.65987 13.2092C8.2704 12.8191 8.27006 12.1874 8.65911 11.7969L10.8033 9.64461C11.0643 9.38266 11.0643 8.959 10.8033 8.69706V8.69706C10.5409 8.43371 10.1145 8.43371 9.85218 8.69706L6.66983 11.8914V11.8914C6.33201 12.2298 6.33201 12.7778 6.66983 13.1162L9.85199 16.3035Z" fill="#444444"/>
+</svg>

web/documentserver-example/csharp/App_Themes/images/file_docxf.svg

@@ -0,0 +1,6 @@
+<svg width="30" height="40" viewBox="0 0 30 40" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M0 3C0 1.34315 1.34315 0 3 0H22.9167L30 7.08333V37C30 38.6569 28.6569 40 27 40H3C1.34315 40 0 38.6569 0 37V3Z" fill="#27ABA3"/>
+<path d="M22.9165 0L29.9998 7.08333H25.9165C24.2597 7.08333 22.9165 5.74019 22.9165 4.08333V0Z" fill="#008078"/>
+<rect x="6.5" y="15.5" width="17" height="5" stroke="white"/>
+<rect x="6.5" y="23.5" width="17" height="5" stroke="white"/>
+</svg>

web/documentserver-example/csharp/App_Themes/images/fill-forms.svg

@@ -0,0 +1,4 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M6 16V13H7V11H5C4.44772 11 4 11.4477 4 12V17C4 17.5523 4.44772 18 5 18H19C19.5523 18 20 17.5523 20 17V12C20 11.4477 19.5523 11 19 11H17V13H18V16H6Z" fill="#444444"/>
+<path d="M11 15H9V13L16 6H17V7H18V8L11 15Z" fill="#444444"/>
+</svg>

web/documentserver-example/csharp/App_Themes/images/filter.svg

@@ -0,0 +1,3 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M10.4 10.4L4 4H20L13.6 10.4V17.8667V21.0667L10.4 17.8667V10.4Z" fill="#444444"/>
+</svg>

web/documentserver-example/csharp/App_Themes/images/mobile-fill-forms.svg

@@ -0,0 +1,6 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M5 5C5 3.89543 5.89543 3 7 3H16C17.1046 3 18 3.89543 18 5V8H17V6H6V18H17V16H18V19C18 20.1046 17.1046 21 16 21H7C5.89543 21 5 20.1046 5 19V5ZM13 4H10V5H13V4ZM12 19.5C12 19.7761 11.7761 20 11.5 20C11.2239 20 11 19.7761 11 19.5C11 19.2239 11.2239 19 11.5 19C11.7761 19 12 19.2239 12 19.5Z" fill="#444444"/>
+<rect x="7" y="9" width="1" height="6" fill="#444444"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M12 8V9L11 9V15H12V16H9V15H10V9H9V8H12Z" fill="#444444"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M15 10H18V14H15H14H13V15H14H18C18.5523 15 19 14.5523 19 14V10C19 9.44772 18.5523 9 18 9H14H13V10H14H15Z" fill="#444444"/>
+</svg>

web/documentserver-example/csharp/App_Themes/images/mobile.svg

@@ -0,0 +1,3 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M8 3C6.89543 3 6 3.89543 6 5V19C6 20.1046 6.89543 21 8 21H16C17.1046 21 18 20.1046 18 19V5C18 3.89543 17.1046 3 16 3H8ZM16.8462 6H7.15385V18H16.8462V6ZM10.3846 4H13.6154V5H10.3846V4ZM12 20C12.2974 20 12.5385 19.7761 12.5385 19.5C12.5385 19.2239 12.2974 19 12 19C11.7026 19 11.4615 19.2239 11.4615 19.5C11.4615 19.7761 11.7026 20 12 20Z" fill="#444444"/>
+</svg>

web/documentserver-example/csharp/App_Themes/images/review.svg

@@ -0,0 +1,3 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M6 5C5.44772 5 5 5.44772 5 6V18C5 18.5523 5.44772 19 6 19H17C17.5523 19 18 18.5523 18 18V13.4142L14.4142 17H11V15H8V14H11V13.5858L11.5858 13H8V12H12.5858L13.5858 11H8V10H14.5858L18 6.58579V6C18 5.44772 17.5523 5 17 5H6ZM8 8H15V9H8V8ZM12 16H14L21 9V8H20V7H19L12 14V16Z" fill="#444444"/>
+</svg>

web/documentserver-example/csharp/App_Themes/media.css

@@ -0,0 +1,684 @@
+/**
+ *
+ * (c) Copyright Ascensio System SIA 2023
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
+ @media (min-width: 1280px)  and (max-width: 1380px) {
+    .copy {
+        margin-right: 6.5%;
+    }
+
+    footer table tr td:first-child {
+        margin-left: 6.5%;
+    }
+}
+
+@media (max-width: 1280px)  and (min-width: 1080px) {
+
+    .tableRow td:first-child {
+        flex-grow: 1;
+        width: 25%;
+    }
+
+    .tableHeaderCellFileName {
+        width: 25%;
+    }
+
+    .tableHeaderCellEditors {
+        width: 13%;
+    }
+
+    .tableHeaderCellViewers {
+        width: 29%;
+        text-align: right;
+    }
+
+    .tableHeaderCellDownload {
+        width: 21%;
+        padding-right: 18px;
+    }
+
+    .tableHeaderCellRemove {
+        padding-left: 13px;
+    }
+
+    footer table tr td:first-child {
+        margin-left: 5%;
+    }
+
+    .copy {
+        margin-right: 5%;
+        padding-right: 32px;
+    }
+
+    .left-panel {
+        margin-left: 48px;
+        width: 20%;
+    }
+}
+
+@media (max-width: 1080px) {
+    .copy {
+        margin-right: 32px;
+    }
+
+    footer table tr td:first-child {
+        margin-left: 0;
+    }
+
+    .tableRow {
+        width: 90%;
+    }
+
+    .tableHeaderCellFileName {
+        width: 16%;
+    }
+
+    .tableHeaderCellEditors {
+        width: 13%;
+    }
+
+    .tableHeaderCellViewers {
+        width: 38%;
+    }
+
+    .tableHeaderCellDownload {
+        width: 23%;
+    }
+
+    .tableHeaderCellRemove {
+        padding-left: 0px;
+    }
+}
+
+@media (max-width: 1008px) {
+    .left-panel {
+        margin-left: 0;
+    }
+
+    .main-panel {
+        left: -1%;
+        padding: 48px 26px 24px;
+    }
+}
+
+@media (max-width: 769px) and (min-width: 593px) {
+    .contentCells-icon{
+        width: 5%;
+    }
+    .tableRow {
+        width: 55%;
+    }
+
+    .tableRow td:first-child {
+        border: none;
+        flex-grow: 1;
+        width: 100%;
+        max-width: 100%;
+    }
+
+    .tableHeader {
+        display: none;
+    }
+
+    .scroll-table-body {
+        top: 31px;
+    }
+
+    footer {
+        height: 80px;
+    }
+
+    .main {
+        height: calc(100% - 128px); 
+    }
+
+    .main-panel {
+        left: 0;
+        padding: 48px 18px 24px;
+    }
+
+    footer table td {
+        margin-left: 0;
+        margin-right: 0;
+        padding-right: 4px;
+        padding-left: 4px;
+    }
+
+    .copy {
+        margin:auto;
+        padding-right: 3%;
+    }
+
+    footer table tr td:first-child {
+        margin-left: auto;
+        padding-left: 1%;
+        margin-right: 1.5%;
+    }
+
+    .contentCells-shift {
+        padding-right: 22px;
+    }
+}
+
+@media (max-width: 715px) {
+    .tableRow {
+        width: 45%;
+    }
+}
+@media (max-width: 670px) and (min-width: 620px){
+    .main-panel{
+        width: 90%;
+    }
+}
+@media (max-width: 681px) and (min-width: 593px) {
+
+    .left-panel {
+        width: 10%;
+    }
+
+    .main-panel {
+        left: 2%;
+        padding: 48px 0 24px;
+    }
+
+    .help-block {
+        margin: 48px 20px 24px;
+    }
+    .file-upload{
+        width: 100%;
+    }
+    #fileupload{
+        width: 100%;
+    }
+}
+
+@media (max-width: 1080px) and (min-width: 970px) {
+    .tableHeader {
+        width: 90%;
+    }
+
+    .tableRow td:first-child {
+        flex-grow: 0;
+        width: 15%;
+    }
+
+    .tableHeaderCellFileName {
+        width: 16%;
+    }
+
+    .tableHeaderCellEditors {
+        width: 13%;
+    }
+
+    .tableHeaderCellViewers {
+        text-align: right;
+        width: 37%;
+    }
+
+    .tableHeaderCellDownload {
+        padding-right: 22px;
+        width: 22%;
+    }
+}
+
+@media (max-width: 986px) and (min-width: 890px) {
+    .tableHeader {
+        width: 75%;
+    }
+
+    .tableHeaderCellEditors {
+        width: 26%;
+        text-align: left;
+    }
+
+    .tableHeaderCellFileName {
+        width: 17%;
+    }
+
+    .tableHeaderCellViewers {
+        width: 27%;
+        text-align: right;
+    }
+
+    .tableHeaderCellDownload {
+        padding-right: 18px;
+        width: 20%;
+    }
+
+    .tableHeaderCellRemove {
+        padding-left: 0;
+    }
+
+    .tableRow {
+        width: 75%;
+    }
+
+    .tableRow td:last-child {
+        padding-right: 38px;
+    }
+
+    .tableRow td:first-child {
+        flex-grow: 0;
+        width: 15%;
+    }
+
+    .contentCells-icon {
+        width: 3%;
+    }
+}
+
+@media (max-width: 890px) and (min-width: 769px ) {
+    .left-panel{
+        width: 20%;
+    }
+    .contentCells-shift {
+        padding-right: 28px;
+    }
+
+    .main-panel {
+        width: 580px;
+    }
+
+    .tableRow {
+        width: 95%;
+    }
+
+    .tableHeader {
+        width: 95%;
+    }
+
+    .tableHeaderCellViewers {
+        width: 22%;
+        text-align: right;
+    }
+
+    .tableHeaderCellDownload {
+        padding-right: 4px;
+        width: 20%;
+        text-align: right;
+    }
+
+    .tableHeaderCellFileName {
+        width: 20%;
+    }
+
+    .tableHeaderCellEditors {
+        text-align: left;
+        width: 31%;
+    }
+
+    .tableHeaderCellViewers {
+        width: 18%;
+    }
+}
+
+@media (max-width: 890px) {
+    .tableRow td:first-child {
+        max-width: 17%;
+    }
+    #portal-info {
+        max-width: 60vw;
+    }
+}
+
+.downloadContentCellShift:after {
+    bottom: 0;
+    left: 0;
+    content: "";
+    background: #e5e5e5;
+    height: 1px;
+    position: absolute;
+    width: 100%;
+}
+
+@media (max-width: 769px) {
+    .tableRow td:first-child {
+        max-width: 100%;
+    }
+}
+
+
+@media (max-width: 593px ) {
+    #portal-info {
+        width: 50vw;
+    }
+    .file-upload{
+        width: 100%;
+    }
+    #fileupload{
+        width: 100%;
+    }
+    .tableHeader {
+        display: none;
+    }
+
+    .scroll-table-body {
+        top: 31px;
+    }
+
+    footer table tr {
+        justify-content: center;
+    }
+
+    footer table td {
+        padding-top: 16px;
+        padding-right: 32px;
+        padding-left: 32px;
+    }
+
+    footer {
+        height: 80px;
+    }
+
+    .main {
+        height: calc(100% - 128px); 
+    }
+    
+    .copy {
+        width: 100%;
+        text-align: center;
+        margin: 0;
+    }
+
+    .left-panel {
+        width: 10%;
+    }
+
+    .help-block {
+        margin: 16px 10px 6px;
+    }
+
+    .main-panel {
+        left: 2%;
+        padding: 16px 0 6px;
+    }
+
+    .tableRow {
+        width: 40%;
+    }
+
+    .tableRow td {
+        border: none;
+    }
+
+    .firstContentCellShift {
+        border: none;
+        flex-basis: 10%;
+        flex-grow: 1;
+    }
+
+    .downloadContentCellShift {
+        max-width: 7%;
+        margin-right: -11px;
+        margin-left: auto;
+    }
+
+    .contentCells-icon {
+        width: 13%;
+    }
+
+    .tableRow td:last-child {
+        width: 12%;
+        padding-right: 40px;
+        border: none;
+    }
+
+    .contentCells-shift {
+        padding-right: 35px;
+    }
+
+    .downloadContentCellShift:after {
+        width: 85%;
+    }
+
+    .firstContentCellViewers {
+        margin-left: 0;
+        border-bottom: 1px solid #e5e5e5 !important;
+    }
+
+    .firstContentCellViewers ~ td {
+        border-bottom: 1px solid #e5e5e5;
+    }
+    .tableRow td:first-child{
+        border: none;
+        width: 85%;
+    }
+    .contentCellsEmpty{
+        display: none;
+        width: 1%;
+    }
+    /* Mobile Upload*/
+    .blockUI.blockMsg.blockPage.ui-dialog.ui-widget.ui-corner-all.ui-widget-content.ui-draggable {
+        width: 344px !important;
+        box-shadow: 0px 7px 15px rgba(85, 85, 85, 0.1);
+        border-radius: 2px;
+        top: 10% !important;
+        margin-left: -172px !important;
+    }
+
+    .ui-dialog .ui-dialog-titlebar {
+        padding: 0;
+    }
+    .ui-dialog .ui-dialog-content {
+        padding: 0 !important;
+    }
+    #mainProgress {
+        margin: 24px 16px 0 !important;
+    }
+    .blockTitle {
+        padding: 10px 10px 6px 16px !important;
+        font-size: 14px !important;
+    }
+    #mainProgress .describeUpload {
+        padding: 8px 0 !important;
+    }
+    .dialog-close {
+        margin: 0 !important;
+    }
+    .step-descr{
+        line-height: 150%;
+    }
+    .step {
+        line-height: 160%;
+    }
+    .buttonsMobile{
+        display: flex;
+        flex-direction: row;
+        flex-wrap: wrap;
+        justify-content: space-between;
+        align-items: center;
+    }
+    .button.gray{
+        margin: 0;
+    }
+    .button, .button:hover{
+        display: flex;
+        justify-content: center;
+        padding: 0 !important;
+        width: 144px;
+        height: 56px;
+        margin-bottom: 24px !important;
+    }
+}
+
+@media (max-width: 560px) and (min-width: 510px) {
+    .contentCells-icon {
+        width: 13%;
+    }
+
+    .downloadContentCellShift {
+        padding-right: 45px;
+        max-width: 4%;
+    }
+}
+
+@media (max-width: 510px)  and (min-width: 470px) {
+    .tableRow {
+        width: 35%;
+    }
+
+    .tableRow td:first-child{
+        width: 83%;
+    }
+    .contentCells-icon {
+        width: 13%;
+    }
+
+    .downloadContentCellShift {
+        max-width: 6%;
+        padding-right: 37px;
+    }
+
+    .firstContentCellShift {
+        flex-basis: 9%;
+    }
+
+    .tableRow td:last-child {
+        padding-right: 28px;
+    }
+}
+
+@media (max-width: 470px)  and (min-width: 420px) {
+    .tableRow {
+        width: 30%;
+    }
+    .tableRow td:first-child{
+        width: 85%;
+    }
+    .contentCells-icon {
+        width: 11%;
+    }
+
+    .downloadContentCellShift {
+        max-width: 3%;
+        padding-right: 37px;
+        padding-left: 0;
+    }
+
+    .firstContentCellShift {
+        margin-left: 1px;
+        flex-basis: 14%;
+    }
+
+    .tableRow td:last-child {
+        width: 5%;
+        padding-right: 63px;
+    }
+    .firstContentCellViewers{
+        padding-right: 2px;
+        width: 12%;
+    }
+    .contentCellsEmpty{
+        display: none;
+    }
+}
+
+@media (max-width: 420px) and (min-width: 320px) {
+    .tableRow {
+        width: 25%;
+    }
+
+    .tableRow td:last-child {
+        width: 6%;
+        padding-right: 16px;
+    }
+
+    .downloadContentCellShift {
+        max-width: 4%;
+        margin-right: -18px;
+        margin-left: -1px;
+    }
+
+    .firstContentCellShift {
+        flex-basis: 2%;
+    }
+
+    .contentCells-icon{
+        width: 10%;
+    }
+    footer table td {
+        margin: 0;
+        padding-right: 5px;
+        padding-left: 5px;
+    }
+
+    .copy {
+        padding-right: 5px;
+        margin: 0;
+    }
+    .firstContentCellViewers{
+        padding-right: 2px;
+        width: 11%;
+    }
+}
+
+@media (max-width: 1160px) {
+    .left-panel {
+        margin-left: 0;
+    }
+}
+
+@media (min-width: 593px) {
+    .contentCellsEmpty {
+        display: none;
+    }
+}
+@media (max-width: 769px) and (min-width: 715px){
+    .tableRow{
+        width: 50%;
+    }
+}
+@media (max-width: 510px) {
+    .tableRow td:first-child{
+        flex-grow: 0;
+    }
+}
+@media (max-width: 1100px) and (min-width: 890px){
+    .main-panel > span{
+        max-width: 70%;
+    }
+}
+@media (max-width: 780px) and (min-width: 600px) {
+    .main-panel{
+        display: flex;
+        flex-direction: column;
+    }
+    .main-panel > span{
+        max-width: 45%;
+    }
+}
+@media (max-width: 600px) and (min-width: 320px) {
+    .main-panel{
+        display: flex;
+        flex-direction: column;
+    }
+}
+@media (max-width:600px) and (min-width:500px){
+    .main-panel > span{
+        max-width:35%;
+    }
+}
+@media (max-width:500px) and (min-width:400px){
+    .main-panel > span{
+        max-width:20%;
+    }
+}
+@media (max-width:400px) and (min-width:320px){
+    .main-panel > span{
+        max-width:15%;
+    }
+}

web/documentserver-example/csharp/App_Themes/stylesheet.css

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -22,6 +22,7 @@ html {
 }
 
 body {
+    display: block;
     background: #FFFFFF;
     color: #333333;
     font-family: Open Sans;
@@ -30,8 +31,10 @@ body {
     font-weight: normal;
     height: 100%;
     margin: 0;
+    overflow-y: overlay;
     padding: 0;
     text-decoration: none;
+    overflow-x: hidden;
 }
 
 form {
@@ -52,30 +55,32 @@ a:visited {
 
 header {
     background: #333333;
-    height: 72px;
+    height: 48px;
     margin: 0 auto;
     min-width: 1152px;
     width: auto;
 }
 
 header img {
-    margin: 22px 0 22px 32px;
+    margin: 10px 0 22px 32px;
 }
 
 .center {
+    position: relative;
     margin: 0 auto 0;
     width: 1152px;
 }
 
 .main {
-    height: calc(100% - 136px);
-    min-height: 549px;
+    display: table;
+    height: calc(100% - 112px);
+    min-height: 536px;
 }
 
 .table-main {
     border-spacing: 0;
     height: 100%;
-    min-height: 549px;
+    min-height: 536px;
 }
 
 .section {
@@ -89,11 +94,15 @@ header img {
     -moz-box-sizing: border-box;
     height: 100%;
     list-style: none;
-    padding: 48px 32px;
+    padding: 48px 32px 24px;
     position: relative;
     width: 896px;
 }
 
+#portal-info {
+    max-width: 65vw;
+}
+
 .portal-name {
     color: #FF6F3D;
     font-size: 24px;
@@ -119,6 +128,7 @@ header img {
 label .checkbox {
     margin: 0 5px 3px 0;
     vertical-align: middle;
+    cursor: pointer;
 }
 
 .try-editor-list {
@@ -153,7 +163,11 @@ label .checkbox {
     background-image: url("images/file_pptx.svg");
 }
 
-.create-sample {
+.try-editor.form {
+    background-image: url("images/file_docxf.svg");
+}
+
+.side-option {
     color: #666666;
     line-height: 24px;
 }
@@ -184,19 +198,19 @@ label .checkbox {
     -webkit-user-select: none;
 }
 
-#beginEdit {
+.button.orange {
     background: #FF6F3D;
     border: 1px solid #FF6F3D;
     color: #FFFFFF;
 }
 
-#beginEdit.disable {
+.button.orange.disable {
     background: #EDC2B3;
     border: 1px solid #EDC2B3;
     cursor: default;
 }
 
-#beginEdit:not(.disable):hover {
+.button.orange:not(.disable):hover {
     background: #ff7a4b;
 }
 
@@ -352,20 +366,36 @@ footer {
     background: #333333;
     color: #AAAAAA;
     height: 64px;
-    min-width: 1152px;
-    width: auto;
+    width: 100%;
+	position: relative;
+	left: 0;
+	bottom: 0;
 }
 
-footer table {
-    border-spacing: 0;
+    footer > .center {
+        width: 100%;
+    }
+
+    footer table {
+        width: 100%;
+        border-spacing: 0;
 }
 
 footer table tr {
-    height: 64px;
+            position: relative;
+            display: flex;
+            flex-direction: row;
+            align-items: center;
+            align-content: center;
+            flex-wrap: wrap;
+            width: 100vw;
+            height: 64px;
 }
 
 footer table td {
-    padding-left: 32px;
+	display: block;
+            position: relative;
+            padding-left: 32px;
 }
 
 footer a,
@@ -380,12 +410,20 @@ footer a:hover {
     text-decoration: none;
 }
 
+    footer table tr td:first-child {
+        margin-left: 14%;
+    }
+
 .copy {
-    padding-left: 510px;
+    color: #aaaaaa;
+    width: max-content;
+    position: relative;
+    margin-left: auto;
+    margin-right: 14%;
 }
 
 .help-block {
-    margin: 48px 32px;
+    margin: 48px 32px 24px;
 }
 
 .help-block span {
@@ -500,12 +538,12 @@ footer a:hover {
 
 .tableHeader tr {
     background: transparent;
-    cursor: default;
-    height: 40px;
-    -khtml-user-select: none;
-    user-select: none;
-    -moz-user-select: none;
-    -webkit-user-select: none;
+        cursor: default;
+        height: 40px;
+        -khtml-user-select: none;
+        user-select: none;
+        -moz-user-select: none;
+        -webkit-user-select: none;
 }
 
 .tableHeaderCell {
@@ -538,6 +576,7 @@ footer a:hover {
 }
 
 .contentCells {
+	display: block;
     border-bottom: 1px solid #EFEFEF;
     font-family: 'Open Sans', sans-serif;
     font-size: 16px;
@@ -567,34 +606,12 @@ footer a:hover {
 
 .info {
     cursor: pointer;
-    padding: 3px 5px;
-    position: absolute;
-}
-
-.tooltip {
-    background: #FFFFFF;
-    border-radius: 5px;
-    box-shadow: 0px 7px 25px rgba(85, 85, 85, 0.15);
-    color: #666666;
-    line-height: 160%;
-    max-width: 312px;
-    padding: 14px;
-    position: absolute;
-}
-
-.arrow {
-    border-top: 8px solid transparent;
-    border-bottom: 8px solid transparent;
-    border-right: 8px solid #FFFFFF;
-    left: -4px;
-    position: absolute;
-    top: 50%;
-    transform: translate(-50%, -50%);
+    margin: -2px 5px;
 }
 
 .user-block-table {
     height: 100%;
-    padding: 14px 0;
+    padding-top: 14px;
     width: 100%;
 }
 
@@ -607,14 +624,10 @@ footer a:hover {
     border: 1px solid #D0D5DA;
     box-sizing: border-box;
     border-radius: 3px;
-    cursor: pointer;
-}
-
-#user,
-#language {
-    width: 100%;
-    margin-top: 5px;
-    padding-left: 5px;
+            cursor: pointer;
+            margin-top: 5px;
+            padding: 2px 5px;
+            width: 100%;
 }
 
 .icon-delete {
@@ -645,4 +658,114 @@ footer a:hover {
 .scroll-table-body::-webkit-scrollbar-thumb {
     background: #D0D5DA;
     border-radius: 3px;
-}
+}
+
+.descrFilePass {
+    display: block;
+    font-weight: bold;
+    line-height: 167%;
+}
+
+#filePass {
+    border: 1px solid #D0D5DA;
+    border-radius: 3px;
+    box-sizing: border-box;
+    display: inline-block;
+    height: 33px;
+    letter-spacing: -0.02em;
+    line-height: 150%;
+    margin-right: 8px;
+    outline: none;
+    padding: 7px 8px;
+    vertical-align: bottom;
+    user-select: none;
+    -moz-user-select: none;
+    -webkit-user-select: none;
+    width: 250px;
+}
+
+.errorInput {
+    border-color: #CB0000 !important;
+}
+
+.errorPass {
+    color: #CB0000;
+    display: block;
+    line-height: 160%;
+    letter-spacing: -0.02em;
+    word-wrap: break-word;
+}
+
+html {
+    overflow-x: hidden;
+}
+
+
+.tableRow {
+    width: 100%;
+    display: flex;
+    flex-wrap: wrap;
+    flex-direction: row;
+    position: relative;
+}
+
+
+    .tableRow td:first-child {
+        display: flex;
+        flex-grow: 1;
+        max-width: 25%;
+    }
+
+.tableHeaderCellFileName {
+    width: 30%;
+}
+
+.tableHeaderCellEditors {
+    width: 28%;
+}
+
+.tableHeaderCellViewers {
+    text-align: center;
+    width: 18%
+}
+
+.firstContentCellViewers {
+    margin-left: auto;
+}
+
+.user-descr {
+    display: inline-table;
+    width: 30vw;
+    min-width: 200px;
+    max-width: 400px;
+    margin-top: 20px;
+}
+
+.user-descr > b {
+    margin-left: 25px;
+}
+
+.tooltip {
+    background: #FFFFFF;
+    border-radius: 5px;
+    box-shadow: 0px 7px 25px rgba(85, 85, 85, 0.15);
+    color: #666666;
+    line-height: 160%;
+    max-width: 455px;
+    padding: 14px;
+    position: absolute;
+}
+
+    .tooltip ul {
+        margin: 0;
+    }
+
+.arrow {
+    border-top: 8px solid transparent;
+    border-bottom: 8px solid transparent;
+    border-right: 8px solid #FFFFFF;
+    left: -4px;
+    position: absolute;
+    top: 50%;
+    transform: translate(-50%, -50%);
+}

web/documentserver-example/csharp/Default.aspx

@@ -1,18 +1,22 @@
 <%@ Page Language="C#" AutoEventWireup="true" CodeBehind="Default.aspx.cs" Inherits="OnlineEditorsExample._Default" Title="ONLYOFFICE" %>
 
 <%@ Import Namespace="System.IO" %>
+<%@ Import Namespace="System.Web.WebPages" %>
 <%@ Import Namespace="System.Linq" %>
 <%@ Import Namespace="System.Web.Configuration" %>
+<%@ Import Namespace="OnlineEditorsExample" %>
+<%@ Import Namespace="System.Collections.Generic" %>
 
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 
 <html xmlns="http://www.w3.org/1999/xhtml">
 <head runat="server">
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+    <meta name="viewport" content="width=device-width" />
     <title>ONLYOFFICE</title>
     <!--
     *
-    * (c) Copyright Ascensio System SIA 2021
+    * (c) Copyright Ascensio System SIA 2023
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
@@ -32,6 +36,7 @@
     <link rel="stylesheet" type="text/css" href="https://fonts.googleapis.com/css?family=Open+Sans:900,800,700,600,500,400,300&subset=latin,cyrillic-ext,cyrillic,latin-ext" />
 
     <link rel="stylesheet" type="text/css" href="app_themes/stylesheet.css" />
+    <link rel="stylesheet" type="text/css" href="app_themes/media.css" />
 
     <link rel="stylesheet" type="text/css" href="app_themes/jquery-ui.css" />
 
@@ -64,8 +69,11 @@
                                             <li>
                                                 <a class="try-editor slide" data-type="slide">Presentation</a>
                                             </li>
+                                            <li>
+                                                <a class="try-editor form" data-type="docxf">Form template</a>
+                                            </li>
                                         </ul>
-                                        <label class="create-sample">
+                                        <label class="side-option">
                                             <input id="createSample" class="checkbox" type="checkbox" />With sample content
                                         </label>
                                     </div>
@@ -80,70 +88,68 @@
                                         <tr>
                                             <td valign="middle">
                                                 <span class="select-user">Username</span>
-                                                <img class="info" data-id="user" data-tooltip="You can open the same document using different users in different Web browser sessions, so you can check out multi-user editing functions" src="app_themes/images/info.svg" />
+                                                <img id="info" class="info" src="app_themes/images/info.svg" />
                                                 <select class="select-user" id="user">
-                                                    <option value="uid-1">John Smith</option>
-                                                    <option value="uid-2">Mark Pottato</option>
-                                                    <option value="uid-3">Hamish Mitchell</option>
-                                                    <option value="uid-0">anonymous</option>
+                                                    <% foreach (User user in Users.getAllUsers())
+                                                       { %>
+                                                           <option value="<%= user.id %>"><%= user.name.IsEmpty() ? "Anonymous" : user.name %></option>
+                                                    <% } %>
                                                 </select>
                                             </td>
                                         </tr>
                                         <tr>
                                             <td valign="middle">
                                                 <span class="select-user">Language</span>
-                                                <img class="info" data-id="language" data-tooltip="Choose the language for ONLYOFFICE editors interface" src="app_themes/images/info.svg" />
+                                            <img class="info info-tooltip" data-id="language"
+                                                 data-tooltip="Choose the language for ONLYOFFICE editors interface"
+                                                 src="app_themes/images/info.svg" />
                                                 <select class="select-user" id="language">
-                                                    <option value="en">English</option>
-                                                    <option value="be">Belarusian</option>
-                                                    <option value="bg">Bulgarian</option>
-                                                    <option value="ca">Catalan</option>
-                                                    <option value="zh">Chinese</option>
-                                                    <option value="cs">Czech</option>
-                                                    <option value="da">Danish</option>
-                                                    <option value="nl">Dutch</option>
-                                                    <option value="fi">Finnish</option>
-                                                    <option value="fr">French</option>
-                                                    <option value="de">German</option>
-                                                    <option value="el">Greek</option>
-                                                    <option value="hu">Hungarian</option>
-                                                    <option value="id">Indonesian</option>
-                                                    <option value="it">Italian</option>
-                                                    <option value="ja">Japanese</option>
-                                                    <option value="ko">Korean</option>
-                                                    <option value="lv">Latvian</option>
-                                                    <option value="lo">Lao</option>
-                                                    <option value="nb">Norwegian</option>
-                                                    <option value="pl">Polish</option>
-                                                    <option value="pt">Portuguese</option>
-                                                    <option value="ro">Romanian</option>
-                                                    <option value="ru">Russian</option>
-                                                    <option value="sk">Slovak</option>
-                                                    <option value="sl">Slovenian</option>
-                                                    <option value="sv">Swedish</option>
-                                                    <option value="es">Spanish</option>
-                                                    <option value="tr">Turkish</option>
-                                                    <option value="uk">Ukrainian</option>
-                                                    <option value="vi">Vietnamese</option>
+                                                    <% Dictionary<string, string> languages = GetLanguages(); 
+                                                    foreach (var lang in languages)
+                                                        { %>
+                                                            <option value="<%= lang.Key %>"><%= lang.Value %></option>
+                                                        <% } %>
                                                 </select>
                                             </td>
                                         </tr>
+                                        <tr>
+                                        <td valign="middle">
+                                            <label class="side-option">
+                                                <input id="directUrl" type="checkbox" class="checkbox" />Try opening on client
+                                                <img id="directUrlInfo" class="info info-tooltip" data-id="directUrlInfo" data-tooltip="Some files can be opened in the user's browser without connecting to the document server." src="app_themes/images/info.svg" />
+                                            </label>
+                                        </td>
+                                    </tr>
                                     </tbody>
                                 </table>
                             </div>
                         </td>
                         <td class="section">
+                        <% var storedFiles = GetStoredFiles(); %>
                             <div class="main-panel">
-                            <%  var storedFiles = GetStoredFiles();
-                                if (!storedFiles.Any())
-                                { %>
+                                <div id="portal-info" style="display: <%= storedFiles.Any() ? "none" : "table-cell" %>">
                                     <span class="portal-name">ONLYOFFICE Document Editors – Welcome!</span>
                                     <span class="portal-descr">
                                         Get started with a demo-sample of ONLYOFFICE Document Editors, the first html5-based editors.
                                         <br /> You may upload your own documents for testing using the "<b>Upload file</b>" button and <b>selecting</b> the necessary files on your PC.
                                     </span>
-                            <%  }
-                                else
+                                    <span class="portal-descr">Please do NOT use this integration example on your own server without proper code modifications, it is intended for testing purposes only. In case you enabled this test example, disable it before going for production.</span>
+                                    <span class="portal-descr">You can open the same document using different users in different Web browser sessions, so you can check out multi-user editing functions.</span>
+                                    <% foreach (User user in Users.getAllUsers())
+                                      { %>
+                                      <div class="user-descr">
+                                       <b><%= user.name.IsEmpty() ? "Anonymous" : user.name %></b>
+                                           <ul>
+                                           <% foreach (string description in user.descriptions)
+                                                   { %>
+                                                       <li><%= description %></li>
+                                                <% } %>
+                                           </ul>
+                                       </div>
+                                       <% } %>
+                                </div>
+                            <%
+                                if (storedFiles.Any())
                                 { %>
                                     <div class="stored-list">
                                         <span class="header-list">Your documents</span>
@@ -163,80 +169,111 @@
                                                 <tbody>
                                                 <%  foreach (var storedFile in storedFiles)
                                                     {
-                                                        var editUrl = "doceditor.aspx?fileID=" + HttpUtility.UrlEncode(storedFile.Name);
-                                                        var docType = DocumentType(storedFile.Name); %>
+                                                        var directUrlParam = GetDirectUrlParam();
+                                                        var editUrl = "doceditor.aspx?fileID=" + HttpUtility.UrlEncode(storedFile.Name) + directUrlParam;
+                                                        var ext = Path.GetExtension(storedFile.Name).ToLower();
+                                                        var docType = DocumentType(storedFile.Name);
+                                                        var canEdit = EditedExts.Contains(ext);
+                                                        var isFillFormDoc = FillFormsExts.Contains(ext);
+                                                        %>
 
-                                                        <tr class="tableRow" title="<%= storedFile.Name %>">
+                                                        <tr class="tableRow" title="<%= storedFile.Name %> [<%= GetFileVersion(storedFile.Name, HttpContext.Current.Request.UserHostAddress.Replace(':','_')) %>]">
                                                             <td class="contentCells">
                                                                 <a class="stored-edit <%= docType %>" href="<%= editUrl %>" target="_blank">
-                                                                    <span title="<%= storedFile.Name %>"><%= storedFile.Name %></span>
+                                                                    <span><%= storedFile.Name %></span>
                                                                 </a>
                                                             </td>
-
-                                                            <td class="contentCells contentCells-icon">
-                                                                <a href="<%= editUrl + "&editorsType=desktop&editorsMode=edit" %>" target="_blank">
-                                                                    <img src="app_themes/images/desktop-24.png" alt="Open in editor for full size screens" title="Open in editor for full size screens"/>
-                                                                </a>
-                                                            </td>
-                                                            <td class="contentCells contentCells-icon">
-                                                                <a href="<%= editUrl + "&editorsType=mobile&editorsMode=edit" %>" target="_blank">
-                                                                    <img src="app_themes/images/mobile-24.png" alt="Open in editor for mobile devices" title="Open in editor for mobile devices"/>
-                                                                </a>
-                                                            </td>
-                                                            <td class="contentCells contentCells-icon">
-                                                                <% if (docType == "word") { %>
-                                                                    <a href="<%= editUrl + "&editorsType=desktop&editorsMode=review" %>" target="_blank">
-                                                                        <img src="app_themes/images/review-24.png" alt="Open in editor for review" title="Open in editor for review"/>
+                                                            <% if (canEdit) { %>
+                                                                <td class="contentCells contentCells-icon">
+                                                                    <a href="<%= editUrl + "&editorsType=desktop&editorsMode=edit" %>" target="_blank">
+                                                                        <img src="app_themes/images/desktop.svg" alt="Open in editor for full size screens" title="Open in editor for full size screens"/>
                                                                     </a>
+                                                                </td>
+                                                                <td class="contentCells contentCells-icon">
+                                                                    <a href="<%= editUrl + "&editorsType=mobile&editorsMode=edit" %>" target="_blank">
+                                                                        <img src="app_themes/images/mobile.svg" alt="Open in editor for mobile devices" title="Open in editor for mobile devices"/>
+                                                                    </a>
+                                                                </td>
+                                                                <td class="contentCells contentCells-icon">
+                                                                    <a href="<%= editUrl + "&editorsType=desktop&editorsMode=comment" %>" target="_blank">
+                                                                         <img src="app_themes/images/comment.svg" alt="Open in editor for comment" title="Open in editor for comment"/>
+                                                                    </a>
+                                                                </td>
+                                                                <% if (docType == "word") { %>
+                                                                    <td class="contentCells contentCells-icon">
+                                                                        <a href="<%= editUrl + "&editorsType=desktop&editorsMode=review" %>" target="_blank">
+                                                                            <img src="app_themes/images/review.svg" alt="Open in editor for review" title="Open in editor for review"/>
+                                                                        </a>
+                                                                    </td>
                                                                 <% } else if (docType == "cell") { %>
-                                                                    <a href="<%= editUrl + "&editorsType=desktop&editorsMode=filter" %>" target="_blank">
-                                                                        <img src="app_themes/images/filter-24.png" alt="Open in editor without access to change the filter" title="Open in editor without access to change the filter" />
-                                                                    </a>
+                                                                    <td class="contentCells contentCells-icon">
+                                                                        <a href="<%= editUrl + "&editorsType=desktop&editorsMode=filter" %>" target="_blank">
+                                                                            <img src="app_themes/images/filter.svg" alt="Open in editor without access to change the filter" title="Open in editor without access to change the filter" />
+                                                                        </a>
+                                                                    </td>
                                                                 <% } %>
-                                                            </td>
-                                                            <td class="contentCells contentCells-icon">
-                                                                <a href="<%= editUrl + "&editorsType=desktop&editorsMode=comment" %>" target="_blank">
-                                                                    <img src="app_themes/images/comment-24.png" alt="Open in editor for comment" title="Open in editor for comment"/>
-                                                                </a>
-                                                            </td>
-                                                            <td class="contentCells contentCells-icon">
                                                                 <% if (docType == "word") { %>
-                                                                    <a href="<%= editUrl + "&editorsType=desktop&editorsMode=fillForms" %>" target="_blank">
-                                                                        <img src="app_themes/images/fill-forms-24.png" alt="Open in editor for filling in forms" title="Open in editor for filling in forms"/>
-                                                                    </a>
+                                                                    <td class="contentCells contentCells-icon">
+                                                                        <a href="<%= editUrl + "&editorsType=desktop&editorsMode=blockcontent" %>" target="_blank">
+                                                                            <img src="app_themes/images/block-content.svg" alt="Open in editor without content control modification" title="Open in editor without content control modification"/>
+                                                                        </a>
+                                                                    </td>
+                                                                <% } else{%>
+                                                                    <td class="contentCells contentCells-icon"></td>
+                                                                <%} %>
+                                                                <%if (docType != "word" && docType != "cell"){%>
+                                                                    <td class="contentCells contentCells-icon "></td>
                                                                 <% } %>
-                                                            </td>
-                                                            <td class="contentCells contentCells-shift contentCells-icon">
-                                                                <% if (docType == "word") { %>
-                                                                    <a href="<%= editUrl + "&editorsType=desktop&editorsMode=blockcontent" %>" target="_blank">
-                                                                        <img src="app_themes/images/block-content-24.png" alt="Open in editor without content control modification" title="Open in editor without content control modification"/>
-                                                                    </a>
+                                                                    <% if (isFillFormDoc) { %>
+                                                                        <td class="contentCells contentCells-shift contentCells-icon firstContentCellShift">
+                                                                            <a href="<%= editUrl + "&editorsType=desktop&editorsMode=fillForms" %>" target="_blank">
+                                                                                <img src="app_themes/images/fill-forms.svg" alt="Open in editor for filling in forms" title="Open in editor for filling in forms"/>
+                                                                            </a>
+                                                                        </td>
+                                                                <% } else { %>
+                                                                    <td class="contentCells contentCells-shift contentCells-icon firstContentCellShift"></td>
                                                                 <% } %>
-                                                            </td>
-
-                                                            <td class="contentCells contentCells-icon">
+                                                                <% } else if (isFillFormDoc) { %>
+                                                                    <td class="contentCells contentCells-icon "></td>
+                                                                    <td class="contentCells contentCells-icon">
+                                                                        <a href="<%= editUrl + "&editorsType=mobile&editorsMode=fillForms" %>" target="_blank">
+                                                                           <img src="app_themes/images/mobile-fill-forms.svg" alt="Open in editor for filling in forms for mobile devices" title="Open in editor for filling in forms for mobile devices"/>
+                                                                        </a>
+                                                                    </td>
+                                                                    <td class="contentCells contentCells-icon "></td>
+                                                                    <td class="contentCells contentCells-icon "></td>
+                                                                    <td class="contentCells contentCells-icon "></td>
+                                                                    <td class="contentCells contentCells-shift contentCells-icon firstContentCellShift">
+                                                                        <a href="<%= editUrl + "&editorsType=desktop&editorsMode=fillForms" %>" target="_blank">
+                                                                            <img src="app_themes/images/fill-forms.svg" alt="Open in editor for filling in forms" title="Open in editor for filling in forms"/>
+                                                                        </a>
+                                                                    </td>
+                                                            <% } else { %>
+                                                                <td class="contentCells contentCells-shift contentCells-icon contentCellsEmpty" colspan="6"></td>
+                                                            <% } %>
+                                                            <td class="contentCells contentCells-icon firstContentCellViewers">
                                                                 <a href="<%= editUrl + "&editorsType=desktop&editorsMode=view" %>" target="_blank">
-                                                                    <img src="app_themes/images/desktop-24.png" alt="Open in viewer for full size screens" title="Open in viewer for full size screens"/>
+                                                                    <img src="app_themes/images/desktop.svg" alt="Open in viewer for full size screens" title="Open in viewer for full size screens"/>
                                                                 </a>
                                                             </td>
                                                             <td class="contentCells contentCells-icon">
                                                                 <a href="<%= editUrl + "&editorsType=mobile&editorsMode=view" %>" target="_blank">
-                                                                    <img src="app_themes/images/mobile-24.png" alt="Open in viewer for mobile devices" title="Open in viewer for mobile devices"/>
+                                                                    <img src="app_themes/images/mobile.svg" alt="Open in viewer for mobile devices" title="Open in viewer for mobile devices"/>
                                                                 </a>
                                                             </td>
                                                             <td class="contentCells contentCells-icon contentCells-shift">
                                                                 <a href="<%= editUrl + "&editorsType=embedded&editorsMode=embedded" %>" target="_blank">
-                                                                    <img src="app_themes/images/embeded-24.png" alt="Open in embedded mode" title="Open in embedded mode"/>
+                                                                    <img src="app_themes/images/embeded.svg" alt="Open in embedded mode" title="Open in embedded mode"/>
                                                                 </a>
                                                             </td>
-                                                            <td class="contentCells contentCells-icon contentCells-shift">
-                                                                <a href="webeditor.ashx?type=download&filename=<%= HttpUtility.UrlEncode(storedFile.Name) %>">
-                                                                    <img class="icon-download" src="app_themes/images/download-24.png" alt="Download" title="Download" />
+                                                            <td class="contentCells contentCells-icon contentCells-shift downloadContentCellShift">
+                                                                <a href="webeditor.ashx?type=download&fileName=<%= HttpUtility.UrlEncode(storedFile.Name) %>">
+                                                                    <img class="icon-download" src="app_themes/images/download.svg" alt="Download" title="Download" />
                                                                 </a>
                                                             </td>
                                                             <td class="contentCells contentCells-icon contentCells-shift">
                                                                 <a class="delete-file" data-filename="<%= storedFile.Name %>">
-                                                                    <img class="icon-delete" src="app_themes/images/delete-24.png" alt="Delete" title="Delete" />
+                                                                    <img class="icon-delete" src="app_themes/images/delete.svg" alt="Delete" title="Delete" />
                                                                 </a>
                                                             </td>
                                                         </tr>
@@ -263,14 +300,23 @@
                 <span id="step2" class="step">2. Conversion.</span>
                 <span class="step-descr">The file is converted to OOXML so that you can edit it.</span>
                 <br />
+                <div id="blockPassword">
+                    <span class="descrFilePass">The file is password protected.</span>
+                    <br />
+                    <div>
+                        <input id="filePass" type="password"/>
+                        <div id="enterPass" class="button orange">Enter</div>
+                        <div id="skipPass" class="button gray">Skip</div>
+                    </div>
+                    <span class="errorPass"></span>
+                    <br />
+                </div>
                 <span id="step3" class="step">3. Loading editor scripts.</span>
                 <span class="step-descr">They are loaded only once, they will be cached on your computer.</span>
                 <input type="hidden" name="hiddenFileName" id="hiddenFileName" />
                 <br />
-                <br />
                 <span class="progress-descr">Note the speed of all operations depends on your connection quality and server location.</span>
                 <br />
-                <br />
                 <div class="error-message">
                     <b>Upload error: </b><span></span>
                     <br />
@@ -279,10 +325,12 @@
             </div>
             <iframe id="embeddedView" src="" height="345px" width="432px" frameborder="0" scrolling="no" allowtransparency></iframe>
             <br />
-            <div id="beginEdit" class="button disable">Edit</div>
-            <div id="beginView" class="button gray disable">View</div>
-            <div id="beginEmbedded" class="button gray disable">Embedded view</div>
-            <div id="cancelEdit" class="button gray">Cancel</div>
+            <div class="buttonsMobile">
+                <div id="beginEdit" class="button orange disable">Edit</div>
+                <div id="beginView" class="button gray disable">View</div>
+                <div id="beginEmbedded" class="button gray disable">Embedded view</div>
+                <div id="cancelEdit" class="button gray">Cancel</div>
+            </div>
         </div>
 
         <span id="loadScripts" data-docs="<%= UrlPreloadScripts %>"></span>
@@ -316,6 +364,7 @@
     <script language="javascript" type="text/javascript" src="script/jquery.dropdownToggle.js"></script>
     <script language="javascript" type="text/javascript" src="script/jscript.js"></script>
     <script language="javascript" type="text/javascript">
+        var FillFormExtList = '<%= string.Join(",", FillFormsExts.ToArray()) %>';
         var ConverExtList = '<%= string.Join(",", ConvertExts.ToArray()) %>';
         var EditedExtList = '<%= string.Join(",", EditedExts.ToArray()) %>';
     </script>

web/documentserver-example/csharp/Default.aspx.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -32,13 +32,15 @@ namespace OnlineEditorsExample
 {
     internal static class FileType
     {
+        // the spreadsheet extension list
         public static readonly List<string> ExtsSpreadsheet = new List<string>
             {
-                ".xls", ".xlsx", ".xlsm",
+                ".xls", ".xlsx", ".xlsm", ".xlsb",
                 ".xlt", ".xltx", ".xltm",
                 ".ods", ".fods", ".ots", ".csv"
             };
 
+        // the presentation extension list
         public static readonly List<string> ExtsPresentation = new List<string>
             {
                 ".pps", ".ppsx", ".ppsm",
@@ -47,21 +49,23 @@ namespace OnlineEditorsExample
                 ".odp", ".fodp", ".otp"
             };
 
+        // the document extension list
         public static readonly List<string> ExtsDocument = new List<string>
             {
                 ".doc", ".docx", ".docm",
                 ".dot", ".dotx", ".dotm",
                 ".odt", ".fodt", ".ott", ".rtf", ".txt",
                 ".html", ".htm", ".mht", ".xml",
-                ".pdf", ".djvu", ".fb2", ".epub", ".xps"
+                ".pdf", ".djvu", ".fb2", ".epub", ".xps", ".oxps", ".oform"
             };
 
+        // get an internal file extension
         public static string GetInternalExtension(string extension)
         {
-            extension = Path.GetExtension(extension).ToLower();
-            if (ExtsDocument.Contains(extension)) return ".docx";
-            if (ExtsSpreadsheet.Contains(extension)) return ".xlsx";
-            if (ExtsPresentation.Contains(extension)) return ".pptx";
+            extension = Path.GetExtension(extension).ToLower();  // get file extension
+            if (ExtsDocument.Contains(extension)) return ".docx";  // .docx for text document extensions
+            if (ExtsSpreadsheet.Contains(extension)) return ".xlsx";  // .xlsx for spreadsheet extensions
+            if (ExtsPresentation.Contains(extension)) return ".pptx";  // .pptx for presentation extensions
             return string.Empty;
         }
     }
@@ -69,11 +73,14 @@ namespace OnlineEditorsExample
     public partial class _Default : Page
     {
 
+        // get the virtual path
         public static string VirtualPath
         {
             get
             {
-                return
+                return Path.IsPathRooted(WebConfigurationManager.AppSettings["storage-path"]) ? 
+                    WebConfigurationManager.AppSettings["storage-path"] + "/"
+                    :
                     HttpRuntime.AppDomainAppVirtualPath
                     + (HttpRuntime.AppDomainAppVirtualPath.EndsWith("/") ? "" : "/")
                     + WebConfigurationManager.AppSettings["storage-path"]
@@ -88,6 +95,7 @@ namespace OnlineEditorsExample
             get { return _ismono.HasValue ? _ismono.Value : (_ismono = (bool?)(Type.GetType("Mono.Runtime") != null)).Value; }
         }
 
+        // get maximum file size
         private static long MaxFileSize
         {
             get
@@ -98,21 +106,30 @@ namespace OnlineEditorsExample
             }
         }
 
+        // get all the supported file extensions
         private static List<string> FileExts
         {
-            get { return ViewedExts.Concat(EditedExts).Concat(ConvertExts).ToList(); }
+            get { return ViewedExts.Concat(EditedExts).Concat(ConvertExts).Concat(FillFormsExts).ToList(); }
         }
 
+        // file extensions that can be viewed
         private static List<string> ViewedExts
         {
             get { return (WebConfigurationManager.AppSettings["files.docservice.viewed-docs"] ?? "").Split(new char[] { '|', ',' }, StringSplitOptions.RemoveEmptyEntries).ToList(); }
         }
+        
+        public static List<string> FillFormsExts
+        {
+            get { return (WebConfigurationManager.AppSettings["files.docservice.fillform-docs"] ?? "").Split(new char[] { '|', ',' }, StringSplitOptions.RemoveEmptyEntries).ToList(); }
+        }
 
+        // file extensions that can be edited
         public static List<string> EditedExts
         {
             get { return (WebConfigurationManager.AppSettings["files.docservice.edited-docs"] ?? "").Split(new char[] { '|', ',' }, StringSplitOptions.RemoveEmptyEntries).ToList(); }
         }
 
+        // file extensions that can be converted
         public static List<string> ConvertExts
         {
             get { return (WebConfigurationManager.AppSettings["files.docservice.convert-docs"] ?? "").Split(new char[] { '|', ',' }, StringSplitOptions.RemoveEmptyEntries).ToList(); }
@@ -120,43 +137,80 @@ namespace OnlineEditorsExample
 
         private static string _fileName;
 
+        // get current user host address
         public static string CurUserHostAddress(string userAddress)
         {
             return Regex.Replace(userAddress ?? HttpContext.Current.Request.UserHostAddress, "[^0-9a-zA-Z.=]", "_");
         }
 
+        // get the storage path of the given file
         public static string StoragePath(string fileName, string userAddress)
         {
-            var directory = HttpRuntime.AppDomainAppPath + WebConfigurationManager.AppSettings["storage-path"] + CurUserHostAddress(userAddress) + "\\";
+            var directory = "";
+            if (Path.IsPathRooted(WebConfigurationManager.AppSettings["storage-path"]))
+            {
+                directory = WebConfigurationManager.AppSettings["storage-path"] + "\\";
+            }
+            else
+            {
+                directory = HttpRuntime.AppDomainAppPath + WebConfigurationManager.AppSettings["storage-path"] + CurUserHostAddress(userAddress) + "\\";
+            }
+
             if (!Directory.Exists(directory))
             {
-                Directory.CreateDirectory(directory);
+                Directory.CreateDirectory(directory);  // if the file directory doesn't exist, make it
             }
-            return directory + Path.GetFileName(fileName);
+            return directory + (fileName.Contains("\\") ? fileName : Path.GetFileName(fileName));
         }
 
+        // get the path to the history file version
+        public static string HistoryPath(string fileName, string userAddress, string version, string file)
+        {
+            var directory = "";
+            if (Path.IsPathRooted(WebConfigurationManager.AppSettings["storage-path"]))
+            {
+                directory = WebConfigurationManager.AppSettings["storage-path"] + "\\";
+            }
+            else
+            {
+                directory = HttpRuntime.AppDomainAppPath + WebConfigurationManager.AppSettings["storage-path"] + CurUserHostAddress(userAddress) + "\\";
+            }
+            var filepath = directory + Path.GetFileName(fileName) + "-hist" + "\\" + version + "\\" + file;
+            return filepath;
+        }
+
+        // get the path to the forcesaved file version
         public static string ForcesavePath(string fileName, string userAddress, Boolean create)
         {
-            var directory = HttpRuntime.AppDomainAppPath + WebConfigurationManager.AppSettings["storage-path"] + CurUserHostAddress(userAddress) + "\\";
-            if (!Directory.Exists(directory))
+            var directory = "";
+            if (Path.IsPathRooted(WebConfigurationManager.AppSettings["storage-path"]))
+            {
+                directory = WebConfigurationManager.AppSettings["storage-path"] + "\\";
+            }
+            else
+            {
+                directory = HttpRuntime.AppDomainAppPath + WebConfigurationManager.AppSettings["storage-path"] + CurUserHostAddress(userAddress) + "\\";
+            }
+            
+            if (!Directory.Exists(directory))  // the directory with host address doesn't exist
             {
                 return "";
             }
 
-            directory = directory + Path.GetFileName(fileName) + "-hist" + "\\";
+            directory = directory + Path.GetFileName(fileName) + "-hist" + "\\";  // get the path to the history of the given file
             if (!Directory.Exists(directory))
             {
-                if (create)
+                if (create)  // create history directory if it doesn't exist
                 {
                     Directory.CreateDirectory(directory);
                 }
-                else
+                else  // the history directory doesn't exist and we are not supposed to create it
                 {
                     return "";
                 }
             }
 
-            directory = directory + Path.GetFileName(fileName);
+            directory = directory + Path.GetFileName(fileName);  // get the path to the given file
             if (!File.Exists(directory))
             {
                 if (!create)
@@ -168,39 +222,46 @@ namespace OnlineEditorsExample
             return directory;
         }
 
+        // create the path to the file history
         public static string HistoryDir(string storagePath)
         {
             return storagePath += "-hist";
         }
 
+        // get the path to the specified file version by its history directory
         public static string VersionDir(string histPath, int version)
         {
             return Path.Combine(histPath, version.ToString());
         }
 
+        // get the path to the specified file version by the file name and the user address
         public static string VersionDir(string fileName, string userAddress, int version)
         {
             return VersionDir(HistoryDir(StoragePath(fileName, userAddress)), version);
         }
 
+        // get the last file version by its history directory
         public static int GetFileVersion(string historyPath)
         {
-            if (!Directory.Exists(historyPath)) return 0;
-            return Directory.EnumerateDirectories(historyPath).Count() + 1;
+            if (!Directory.Exists(historyPath)) return 1;
+            return Directory.EnumerateDirectories(historyPath).Count() + 1;  // run through all the file versions and count them
         }
 
+        // get the last file version by the file name and the user address
         public static int GetFileVersion(string fileName, string userAddress)
         {
             return GetFileVersion(HistoryDir(StoragePath(fileName, userAddress)));
         }
 
+        // get url to the original file
         public static string FileUri(string fileName, Boolean forDocumentServer)
         {
             var uri = new UriBuilder(GetServerUrl(forDocumentServer));
-            uri.Path = VirtualPath + fileName;
+            uri.Path = VirtualPath + fileName;  // get full url address to the file
             return uri.ToString();
         }
 
+        // get server url
         public static string GetServerUrl(Boolean forDocumentServer)
         {
             if (forDocumentServer && !WebConfigurationManager.AppSettings["files.docservice.url.example"].Equals(""))
@@ -218,15 +279,16 @@ namespace OnlineEditorsExample
             }
         }
 
+        // get the document type
         public static string DocumentType(string fileName)
         {
             var ext = Path.GetExtension(fileName).ToLower();
 
-            if (FileType.ExtsDocument.Contains(ext)) return "word";
-            if (FileType.ExtsSpreadsheet.Contains(ext)) return "cell";
-            if (FileType.ExtsPresentation.Contains(ext)) return "slide";
+            if (FileType.ExtsDocument.Contains(ext)) return "word";  // word for text document extensions
+            if (FileType.ExtsSpreadsheet.Contains(ext)) return "cell";  // cell for spreadsheet extensions
+            if (FileType.ExtsPresentation.Contains(ext)) return "slide";  // slide for presentation extensions
 
-            return "word";
+            return "word";  // the default document type is word
         }
 
         protected string UrlPreloadScripts = WebConfigurationManager.AppSettings["files.docservice.url.site"] + WebConfigurationManager.AppSettings["files.docservice.url.preloader"];
@@ -236,14 +298,15 @@ namespace OnlineEditorsExample
         {
         }
 
+        // uploading a file by the HtthContext object
         public static string DoUpload(HttpContext context)
         {
             var httpPostedFile = context.Request.Files[0];
 
-            if (HttpContext.Current.Request.Browser.Browser.ToUpper() == "IE")
+            if (HttpContext.Current.Request.Browser.Browser.ToUpper() == "IE")  // check from which browser the request came for
             {
                 var files = httpPostedFile.FileName.Split(new char[] { '\\' });
-                _fileName = files[files.Length - 1];
+                _fileName = files[files.Length - 1];  // get file name
             }
             else
             {
@@ -251,33 +314,37 @@ namespace OnlineEditorsExample
             }
 
             var curSize = httpPostedFile.ContentLength;
-            if (MaxFileSize < curSize || curSize <= 0)
+            if (MaxFileSize < curSize || curSize <= 0)  // check if the file size exceeds the maximum file size
             {
                 throw new Exception("File size is incorrect");
             }
 
             var curExt = (Path.GetExtension(_fileName) ?? "").ToLower();
-            if (!FileExts.Contains(curExt))
+            if (!FileExts.Contains(curExt))  // check if the file extension is supported by the editor
             {
                 throw new Exception("File type is not supported");
             }
 
-            _fileName = GetCorrectName(_fileName);
+            _fileName = GetCorrectName(_fileName);  // get the correct file name if such a name already exists
 
-            var savedFileName = StoragePath(_fileName, null);
-            httpPostedFile.SaveAs(savedFileName);
+            var savedFileName = StoragePath(_fileName, null);  // get the storage path to the uploading file
+            httpPostedFile.SaveAs(savedFileName);  // and save it
 
-            DocEditor.CreateMeta(_fileName, context.Request.Cookies.GetOrDefault("uid", "uid-1"), context.Request.Cookies.GetOrDefault("uname", "John Smith"), null);
+            // get file meta information or create the default one
+            var id = context.Request.Cookies.GetOrDefault("uid", null);
+            var user = Users.getUser(id);  // get the user
+            DocEditor.CreateMeta(_fileName, user.id, user.name, null);
 
             return _fileName;
         }
 
+        // uploading a file by the file url and the request
         public static string DoUpload(string fileUri, HttpRequest request)
         {
-            _fileName = GetCorrectName(Path.GetFileName(fileUri));
+            _fileName = GetCorrectName(Path.GetFileName(fileUri));  // get the correct file name if such a name already exists
 
             var curExt = (Path.GetExtension(_fileName) ?? "").ToLower();
-            if (!FileExts.Contains(curExt))
+            if (!FileExts.Contains(curExt))  // check if the file extension is supported by the editor
             {
                 throw new Exception("File type is not supported");
             }
@@ -286,13 +353,9 @@ namespace OnlineEditorsExample
 
             try
             {
-                // hack. http://ubuntuforums.org/showthread.php?t=1841740
-                if (IsMono)
-                {
-                    ServicePointManager.ServerCertificateValidationCallback += (s, ce, ca, p) => true;
-                }
+                VerifySSL();
 
-                using (var stream = req.GetResponse().GetResponseStream())
+                using (var stream = req.GetResponse().GetResponseStream())  // get response stream of the uploading file
                 {
                     if (stream == null) throw new Exception("stream is null");
                     const int bufferSize = 4096;
@@ -303,12 +366,15 @@ namespace OnlineEditorsExample
                         int readed;
                         while ((readed = stream.Read(buffer, 0, bufferSize)) != 0)
                         {
-                            fs.Write(buffer, 0, readed);
+                            fs.Write(buffer, 0, readed);  // write bytes to the output stream
                         }
                     }
                 }
 
-                DocEditor.CreateMeta(_fileName, request.Cookies.GetOrDefault("uid", "uid-1"), request.Cookies.GetOrDefault("uname", "John Smith"), null);
+                // get file meta information or create the default one
+                var id = request.Cookies.GetOrDefault("uid", null);
+                var user = Users.getUser(id);  // get the user
+                DocEditor.CreateMeta(_fileName, user.id, user.name, null);
             }
             catch (Exception)
             {
@@ -317,42 +383,126 @@ namespace OnlineEditorsExample
             return _fileName;
         }
 
+        public static string DoSaveAs(HttpContext context)
+        {
+            string fileData;
+            try
+            {
+                using (var receiveStream = context.Request.InputStream)
+                using (var readStream = new StreamReader(receiveStream))
+                {
+                    fileData = readStream.ReadToEnd();
+                    if (string.IsNullOrEmpty(fileData)) return "{\"error\":\"Request stream is empty\"}";
+                }
+            }
+            catch (Exception e)
+            {
+                throw new HttpException((int)HttpStatusCode.BadRequest, e.Message);
+            }
+
+            var jss = new JavaScriptSerializer();
+            var body = jss.Deserialize<Dictionary<string, object>>(fileData);
+            var fileUrl = (string) body["url"];
+            var title = (string) body["title"];
+            var fileName = GetCorrectName(title);
+            var extension = "." + (Path.GetExtension(fileName).ToLower() ?? "").Trim('.');
+
+            var allExt = ConvertExts.Concat(EditedExts).Concat(ViewedExts).Concat(FillFormsExts).ToArray();
+
+            if (!allExt.Contains(extension))
+            {
+                return "{\"error\":\"File type is not supported\"}";
+            }
+            
+            var req = (HttpWebRequest)WebRequest.Create(fileUrl);
+            
+            VerifySSL();
+            
+            using (var stream = req.GetResponse().GetResponseStream())
+            {
+                
+                if (stream == null || req.GetResponse().ContentLength <= 0 || req.GetResponse().ContentLength > MaxFileSize)
+                {
+                    return "{\"error\": \"File size is incorrect\"}";
+                }
+                const int bufferSize = 4096;
+            
+                using (var fs = File.Open(StoragePath(fileName, null), FileMode.Create))
+                {
+                    var buffer = new byte[bufferSize];
+                    int readed;
+                    while ((readed = stream.Read(buffer, 0, bufferSize)) != 0)
+                    {
+                        fs.Write(buffer, 0, readed);  // write bytes to the output stream
+                    }
+                }
+            }
+                
+            var id = context.Request.Cookies.GetOrDefault("uid", null);
+            var user = Users.getUser(id);  // get the user
+            DocEditor.CreateMeta(fileName, user.id, user.name, null);
+
+            return "{\"file\": \"" + fileName + "\"}";
+        }
+
+        // converting a file
         public static string DoConvert(HttpContext context)
         {
-            _fileName = Path.GetFileName(context.Request["filename"]);
+            string fileData;
+            try
+            {
+                using (var receiveStream = context.Request.InputStream)
+                using (var readStream = new StreamReader(receiveStream))
+                {
+                    fileData = readStream.ReadToEnd();
+                    if (string.IsNullOrEmpty(fileData)) context.Response.Write("{\"error\":1,\"message\":\"Request stream is empty\"}");
+                }
+            }
+            catch (Exception e)
+            {
+                throw new HttpException((int)HttpStatusCode.BadRequest, e.Message);
+            }
+
+            var jss = new JavaScriptSerializer();
+            var body = jss.Deserialize<Dictionary<string, object>>(fileData);
+
+            _fileName = Path.GetFileName(body["filename"].ToString());
+            var filePass = body["filePass"] != null ? body["filePass"].ToString() : null;
+            var lang = context.Request.Cookies.GetOrDefault("ulang", null);
 
             var extension = (Path.GetExtension(_fileName).ToLower() ?? "").Trim('.');
             var internalExtension = FileType.GetInternalExtension(_fileName).Trim('.');
 
+            // check if the file with such an extension can be converted
             if (ConvertExts.Contains("." + extension)
                 && !string.IsNullOrEmpty(internalExtension))
             {
+                // generate document key
                 var key = ServiceConverter.GenerateRevisionId(FileUri(_fileName, true));
 
                 var fileUrl = new UriBuilder(_Default.GetServerUrl(true));
                 fileUrl.Path = HttpRuntime.AppDomainAppVirtualPath
                     + (HttpRuntime.AppDomainAppVirtualPath.EndsWith("/") ? "" : "/")
                     + "webeditor.ashx";
-                fileUrl.Query = "type=download&fileName=" + HttpUtility.UrlEncode(_fileName);
+                fileUrl.Query = "type=download&fileName=" + HttpUtility.UrlEncode(_fileName)
+                + "&userAddress=" + HttpUtility.UrlEncode(CurUserHostAddress(HttpContext.Current.Request.UserHostAddress));
 
+                // get the url to the converted file
                 string newFileUri;
-                var result = ServiceConverter.GetConvertedUri(fileUrl.ToString() , extension, internalExtension, key, true, out newFileUri); ;
+                var result = ServiceConverter.GetConvertedUri(fileUrl.ToString() , extension, internalExtension, key, true, out newFileUri, filePass, lang);
                 if (result != 100)
                 {
                     return "{ \"step\" : \"" + result + "\", \"filename\" : \"" + _fileName + "\"}";
                 }
 
+                // get a file name of an internal file extension with an index if the file with such a name already exists
                 var fileName = GetCorrectName(Path.GetFileNameWithoutExtension(_fileName) + "." + internalExtension);
 
                 var req = (HttpWebRequest)WebRequest.Create(newFileUri);
 
-                // hack. http://ubuntuforums.org/showthread.php?t=1841740
-                if (IsMono)
-                {
-                    ServicePointManager.ServerCertificateValidationCallback += (s, ce, ca, p) => true;
-                }
+                VerifySSL();
 
-                using (var stream = req.GetResponse().GetResponseStream())
+                using (var stream = req.GetResponse().GetResponseStream())  // get response stream of the converting file
                 {
                     if (stream == null) throw new Exception("Stream is null");
                     const int bufferSize = 4096;
@@ -363,53 +513,73 @@ namespace OnlineEditorsExample
                         int readed;
                         while ((readed = stream.Read(buffer, 0, bufferSize)) != 0)
                         {
-                            fs.Write(buffer, 0, readed);
+                            fs.Write(buffer, 0, readed);  // write bytes to the output stream
                         }
                     }
                 }
 
+                // remove the original file and its history if it exists
                 var storagePath = StoragePath(_fileName, null);
                 var histDir = HistoryDir(storagePath);
                 File.Delete(storagePath);
                 if (Directory.Exists(histDir)) Directory.Delete(histDir, true);
 
+                // create meta information about the converted file with user id and name specified
                 _fileName = fileName;
-                DocEditor.CreateMeta(_fileName, context.Request.Cookies.GetOrDefault("uid", "uid-1"), context.Request.Cookies.GetOrDefault("uname", "John Smith"), null);
+                var id = context.Request.Cookies.GetOrDefault("uid", null);
+                var user = Users.getUser(id);  // get the user
+                DocEditor.CreateMeta(_fileName, user.id, user.name, null);
             }
 
             return "{ \"filename\" : \"" + _fileName + "\"}";
         }
 
+        // get the correct file name if such a name already exists
         public static string GetCorrectName(string fileName, string userAddress = null)
         {
-            var baseName = Path.GetFileNameWithoutExtension(fileName);
-            var ext = Path.GetExtension(fileName).ToLower();
-            var name = baseName + ext;
+            var baseName = Path.GetFileNameWithoutExtension(fileName);  // get file name without extension
+            var ext = Path.GetExtension(fileName).ToLower();  // get file extension
+            var name = baseName + ext;  // get full file name
 
+            // if the file with such a name already exists in this directory
             for (var i = 1; File.Exists(StoragePath(name, userAddress)); i++)
             {
-                name = baseName + " (" + i + ")" + ext;
+                name = baseName + " (" + i + ")" + ext;  // add an index after its base name
             }
             return name;
         }
 
+        // get all the stored files from the folder
         protected static List<FileInfo> GetStoredFiles()
         {
-            var directory = HttpRuntime.AppDomainAppPath + WebConfigurationManager.AppSettings["storage-path"] + CurUserHostAddress(null) + "\\";
+            var directory = "";
+            if (Path.IsPathRooted(WebConfigurationManager.AppSettings["storage-path"]))
+            {
+                directory = WebConfigurationManager.AppSettings["storage-path"] + "\\";
+            }
+            else
+            {
+                directory = HttpRuntime.AppDomainAppPath + WebConfigurationManager.AppSettings["storage-path"] + CurUserHostAddress(null) + "\\";
+            }
+            
             if (!Directory.Exists(directory)) return new List<FileInfo>();
 
-            var directoryInfo = new DirectoryInfo(directory);
+            var directoryInfo = new DirectoryInfo(directory);  // read the user host directory contents
 
+            // get the list of stored files from the host directory
             List<FileInfo> storedFiles = directoryInfo.GetFiles("*.*", SearchOption.TopDirectoryOnly).ToList();
             return storedFiles;
         }
 
+        // get files information
         public static List<Dictionary<string, object>> GetFilesInfo(string fileId = null)
         {
             var files = new List<Dictionary<string, object>>();
 
+            // run through all the files from the directory
             foreach (var file in GetStoredFiles())
             {
+                // write file parameters to the file object
                 var dictionary = new Dictionary<string, object>();
                 dictionary.Add("version", GetFileVersion(file.Name, null));
                 dictionary.Add("id", ServiceConverter.GenerateRevisionId(_Default.CurUserHostAddress(null) + "/" + file.Name + "/" + File.GetLastWriteTime(_Default.StoragePath(file.Name, null)).GetHashCode()));
@@ -419,9 +589,10 @@ namespace OnlineEditorsExample
                 dictionary.Add("updated", file.LastWriteTime.ToString());
                 if (fileId != null)
                 {
+                    // if file id is defined and it is equal to the document key value
                     if (fileId.Equals(dictionary["id"]))
                     {
-                        files.Add(dictionary);
+                        files.Add(dictionary);  // add file object to the files
                         break;
                     }
                 }
@@ -433,5 +604,33 @@ namespace OnlineEditorsExample
 
             return files;
         }
+
+        // enable certificate ignore
+        public static void VerifySSL()
+        {
+            // hack. http://ubuntuforums.org/showthread.php?t=1841740
+            if(WebConfigurationManager.AppSettings["files.docservice.verify-peer-off"].Equals("true")) {
+                ServicePointManager.ServerCertificateValidationCallback += (s, ce, ca, p) => true;
+                ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls12 | SecurityProtocolType.Tls11 | SecurityProtocolType.Tls;
+            }
+        }
+        
+        public static Dictionary<string, string> GetLanguages()
+        {
+            var languages = new Dictionary<string, string>();
+            String[] couples = (WebConfigurationManager.AppSettings["files.docservice.languages"] ?? "").Split('|');
+            foreach (string couple in couples)
+            {   
+                String[] tmp = couple.Split(':');
+                languages.Add(tmp[0],tmp[1]);
+            }
+            return languages;
+        }
+
+        public static string GetDirectUrlParam()
+        {
+            string isEnabledDirectUrl = HttpUtility.ParseQueryString(HttpContext.Current.Request.Url.Query).Get("directUrl");
+            return "&directUrl=" + (isEnabledDirectUrl != null ? isEnabledDirectUrl : "false");
+        }
     }
 }

web/documentserver-example/csharp/DocEditor.aspx

@@ -11,11 +11,11 @@
     <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, minimum-scale=1, user-scalable=no, minimal-ui" />
     <meta name="apple-mobile-web-app-capable" content="yes" />
     <meta name="mobile-web-app-capable" content="yes" />
-    <link rel="icon" href="<%= "app_themes/images/" + documentType + ".ico" %>" type="image/x-icon" />
+    <link rel="icon" href="<%= "app_themes/images/" + DocumentType + ".ico" %>" type="image/x-icon" />
     <title>ONLYOFFICE</title>
     <!--
     *
-    * (c) Copyright Ascensio System SIA 2021
+    * (c) Copyright Ascensio System SIA 2023
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
@@ -64,34 +64,43 @@
     <script type="text/javascript" language="javascript">
 
         var docEditor;
+        var config;
 
-        var innerAlert = function (message) {
+        var innerAlert = function (message, inEditor) {
             if (console && console.log)
                 console.log(message);
+            if (inEditor && docEditor)
+                docEditor.showMessage(message);
         };
 
+        // the application is loaded into the browser
         var onAppReady = function () {
             innerAlert("Document editor ready");
         };
 
+        // the document is modified
         var onDocumentStateChange = function (event) {
             var title = document.title.replace(/\*$/g, "");
             document.title = title + (event.data ? "*" : "");
         };
 
+        // the user is trying to switch the document from the viewing into the editing mode
         var onRequestEditRights = function () {
             location.href = location.href.replace(RegExp("editorsMode=view\&?", "i"), "");
         };
 
+        // an error or some other specific event occurs
         var onError = function (event) {
             if (event)
                 innerAlert(event.data);
         };
 
+        // the document is opened for editing with the old document.key value
         var onOutdatedVersion = function (event) {
             location.reload(true);
         };
 
+        // replace the link to the document which contains a bookmark
         var replaceActionLink = function(href, linkParam) {
             var link;
             var actionIndex = href.indexOf("&actionLink=");
@@ -108,35 +117,80 @@
             return link;
         }
 
+        // the user is trying to get link for opening the document which contains a bookmark, scrolling to the bookmark position
         var onMakeActionLink = function (event) {
             var actionData = event.data;
             var linkParam = JSON.stringify(actionData);
-            docEditor.setActionLink(replaceActionLink(location.href, linkParam));
+            docEditor.setActionLink(replaceActionLink(location.href, linkParam));  // set the link to the document which contains a bookmark
         };
 
+        // the meta information of the document is changed via the meta command
         var onMetaChange = function (event) {
-            var favorite = !!event.data.favorite;
-            var title = document.title.replace(/^\☆/g, "");
-            document.title = (favorite ? "☆" : "") + title;
-            docEditor.setFavorite(favorite);
+            if (event.data.favorite) {
+                var favorite = !!event.data.favorite;
+                var title = document.title.replace(/^\☆/g, "");
+                document.title = (favorite ? "☆" : "") + title;
+                docEditor.setFavorite(favorite);  // change the Favorite icon state
+            }
+
+            innerAlert("onMetaChange: " + JSON.stringify(event.data));
         };
 
+        // the user is trying to insert an image by clicking the Image from Storage button
         var onRequestInsertImage = function (event) {
-            docEditor.insertImage({
+            docEditor.insertImage({  // insert an image into the file
                 "c": event.data.c,
-                <%= InsertImageConfig%>
+                <%= InsertImageConfig %>
             })
         };
 
+        // the user is trying to select document for comparing by clicking the Document from Storage button
         var onRequestCompareFile = function () {
-            docEditor.setRevisedFile(<%= compareFileData%>);
+            docEditor.setRevisedFile(<%= CompareFileData %>);  // select a document for comparing
         };
 
+        // the user is trying to select recipients data by clicking the Mail merge button
         var onRequestMailMergeRecipients = function (event) {
-            docEditor.setMailMergeRecipients(<%= dataMailMergeRecipients%>);
+            docEditor.setMailMergeRecipients(<%= DataMailMergeRecipients %>);  // insert recipient data for mail merge into the file
+        };
+        
+        var onRequestSaveAs = function (event) {  //  the user is trying to save file by clicking Save Copy as... button
+            var title = event.data.title;
+            var url = event.data.url;
+            var data = {
+                title: title,
+                url: url
+            };
+            let xhr = new XMLHttpRequest();
+            xhr.open("POST", "webeditor.ashx?type=saveas");
+            xhr.setRequestHeader('Content-Type', 'application/json');
+            xhr.send(JSON.stringify(data));
+            xhr.onload = function () {
+                innerAlert(xhr.responseText);
+                innerAlert(JSON.parse(xhr.responseText).file, true);
+            }
         };
 
-        var config = <%= DocConfig %>;
+        var onRequestRename = function(event) { //  the user is trying to rename file by clicking Rename... button
+            innerAlert("onRequestRename: " + JSON.stringify(event.data));
+
+            var newfilename = event.data;
+            var data = {
+                newfilename: newfilename,
+                dockey: config.document.key,
+                ext: config.document.fileType
+            };
+
+            let xhr = new XMLHttpRequest();
+            xhr.open("POST", "webeditor.ashx?type=rename");
+            xhr.setRequestHeader('Content-Type', 'application/json');
+            xhr.send(JSON.stringify(data));
+            xhr.onload = function () {
+                innerAlert(xhr.responseText);
+            }
+        };
+
+        config = <%= DocConfig %>;
 
         config.width = "100%";
         config.height = "100%";
@@ -154,22 +208,53 @@
             "onRequestMailMergeRecipients": onRequestMailMergeRecipients,
         };
 
-        <% if (!string.IsNullOrEmpty(History) && !string.IsNullOrEmpty(HistoryData))
-        { %>
-        config.events['onRequestHistory'] = function () {
-            docEditor.refreshHistory(<%= History %>);
+        if (config.editorConfig.user.id) {
+            <% if (!string.IsNullOrEmpty(History) && !string.IsNullOrEmpty(HistoryData))
+            { %>
+                config.events['onRequestHistory'] = function () {  // the user is trying to show the document version history
+                    docEditor.refreshHistory(<%= History %>);  // show the document version history
+                };
+                config.events['onRequestHistoryData'] = function (event) {  // the user is trying to click the specific document version in the document version history
+                    var ver = event.data;
+                    var histData = <%= HistoryData %>;
+                    docEditor.setHistoryData(histData[ver - 1]);  // send the link to the document for viewing the version history
+                };
+                config.events['onRequestHistoryClose '] = function () {  // the user is trying to go back to the document from viewing the document version history
+                    document.location.reload();
+                };
+            <% } %>
+
+            // add mentions for not anonymous users
+            <% if (!string.IsNullOrEmpty(UsersForMentions))
+            { %>
+                config.events['onRequestUsers'] = function () {
+                    docEditor.setUsers({  // set a list of users to mention in the comments
+                        "users": <%= UsersForMentions %>
+                    });
+                };
+            <% } %>
+
+            // the user is mentioned in a comment
+            config.events['onRequestSendNotify'] = function (event) {
+                event.data.actionLink = replaceActionLink(location.href, JSON.stringify(event.data.actionLink));
+                var data = JSON.stringify(event.data);
+                innerAlert("onRequestSendNotify: " + data);
+            };
+            // prevent file renaming for anonymous users
+            config.events['onRequestRename'] = onRequestRename;
+        }
+
+        if (config.editorConfig.createUrl) {
+            config.events.onRequestSaveAs = onRequestSaveAs;
         };
-        config.events['onRequestHistoryData'] = function (event) {
-            var ver = event.data;
-            var histData = <%= HistoryData %>;
-            docEditor.setHistoryData(histData[ver - 1]);
-        };
-        config.events['onRequestHistoryClose '] = function () {
-            document.location.reload();
-        };
-        <% } %>
 
         var сonnectEditor = function () {
+            if ((config.document.fileType === "docxf" || config.document.fileType === "oform")
+                && DocsAPI.DocEditor.version().split(".")[0] < 7) {
+                innerAlert("Please update ONLYOFFICE Docs to version 7.0 to work on fillable forms online.");
+                return;
+            }
+
             docEditor = new DocsAPI.DocEditor("iframeEditor", config);
         };
 

web/documentserver-example/csharp/DocEditor.aspx.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -32,20 +32,23 @@ namespace OnlineEditorsExample
     {
         public static string FileName;
 
+        // get url to the original file
         public static string FileUri
         {
             get { return _Default.FileUri(FileName, true); }
         }
 
+        // get url to the original file for Document Server
         public static string FileUriUser
         {
-            get { return _Default.FileUri(FileName, false); }
+            get { return Path.IsPathRooted(WebConfigurationManager.AppSettings["storage-path"]) ? getDownloadUrl(FileName) + "&dmode=emb" : _Default.FileUri(FileName, false); }
         }
 
         protected string Key
         {
             get
             {
+                // generate document key
                 return ServiceConverter.GenerateRevisionId(_Default.CurUserHostAddress(null)
                                                            + "/" + Path.GetFileName(FileUri)
                                                            + "/" + File.GetLastWriteTime(_Default.StoragePath(FileName, null)).GetHashCode());
@@ -61,10 +64,12 @@ namespace OnlineEditorsExample
         protected string History { get; private set; }
         protected string HistoryData { get; private set; }
         protected string InsertImageConfig { get; private set; }
-        protected string compareFileData { get; private set; }
-        protected string dataMailMergeRecipients { get; private set; }
-        protected string documentType { get { return _Default.DocumentType(FileName); } }
+        protected string CompareFileData { get; private set; }
+        protected string DataMailMergeRecipients { get; private set; }
+        protected string UsersForMentions { get; private set; }
+        protected string DocumentType { get { return _Default.DocumentType(FileName); } }
 
+        // get callback url
         public static string CallbackUrl
         {
             get
@@ -76,73 +81,121 @@ namespace OnlineEditorsExample
                     + "webeditor.ashx";
                 callbackUrl.Query = "type=track"
                                     + "&fileName=" + HttpUtility.UrlEncode(FileName)
-                                    + "&userAddress=" + HttpUtility.UrlEncode(HttpContext.Current.Request.UserHostAddress);
+                                    + "&userAddress=" + HttpUtility.UrlEncode(_Default.CurUserHostAddress(HttpContext.Current.Request.UserHostAddress));
                 return callbackUrl.ToString();
             }
         }
 
+        // get url to the created file
+        public static string getCreateUrl(String documentType, String editorsType)
+        {
+            var createUrl = new UriBuilder(_Default.GetServerUrl(false));
+            createUrl.Path =
+                HttpRuntime.AppDomainAppVirtualPath
+                + (HttpRuntime.AppDomainAppVirtualPath.EndsWith("/") ? "" : "/")
+                + "doceditor.aspx";
+            createUrl.Query = "type=" + documentType
+                                + "&editorsType=" + editorsType;
+            return createUrl.ToString();
+        }
+
+        // get url to download a file
+        public static string getDownloadUrl(string fileName, Boolean isServer = true)
+        {
+            var userAddress = isServer ? "&userAddress=" + HttpUtility.UrlEncode(_Default.CurUserHostAddress(HttpContext.Current.Request.UserHostAddress)) : "";
+            var downloadUrl = new UriBuilder(_Default.GetServerUrl(isServer));
+                downloadUrl.Path =
+                    HttpRuntime.AppDomainAppVirtualPath
+                    + (HttpRuntime.AppDomainAppVirtualPath.EndsWith("/") ? "" : "/")
+                    + "webeditor.ashx";
+                downloadUrl.Query = "type=download"
+                                    + "&fileName=" + HttpUtility.UrlEncode(fileName)
+                                    + userAddress;
+                return downloadUrl.ToString();
+        }
+
+        // loading a page
         protected void Page_Load(object sender, EventArgs e)
         {
+            // get file url
             var externalUrl = Request["fileUrl"];
             if (!string.IsNullOrEmpty(externalUrl))
             {
+                // and upload the file by the file url and the request
                 FileName = _Default.DoUpload(externalUrl, Request);
             }
-            else
+            else  // if it doesn't exist
             {
+                // get file name
                 FileName = Path.GetFileName(Request["fileID"]);
             }
 
+            // get file type
             var type = Request["type"];
             if (!string.IsNullOrEmpty(type))
             {
+                // create demo document of a specified file type
                 Try(type, Request["sample"], Request);
                 Response.Redirect("doceditor.aspx?fileID=" + HttpUtility.UrlEncode(FileName));
             }
 
+            // get file extension
             var ext = Path.GetExtension(FileName).ToLower();
 
+            // get editor mode or set the default one (edit)
             var editorsMode = Request.GetOrDefault("editorsMode", "edit");
 
-            var canEdit = _Default.EditedExts.Contains(ext);
-            var mode = canEdit && editorsMode != "view" ? "edit" : "view";
-            var submitForm = canEdit && (editorsMode.Equals("edit") || editorsMode.Equals("fillForms"));
+            var canEdit = _Default.EditedExts.Contains(ext);  // check if this file can be edited
+            var editorsType = Request.GetOrDefault("editorsType", "desktop");
 
-            var userId = Request.Cookies.GetOrDefault("uid", "uid-1");
-            var uname = userId.Equals("uid-0") ? null : Request.Cookies.GetOrDefault("uname", "John Smith");
-            string userGroup = null;
-            List<string> reviewGroups = null;
-            if (userId.Equals("uid-2"))
-            {
-                userGroup = "group-2";
-                reviewGroups = new List<string>() { "group-2", "" };
-            }
-            if (userId.Equals("uid-3"))
-            {
-                userGroup = "group-3";
-                reviewGroups = new List<string>() { "group-2" };
-            }
+            var id = Request.Cookies.GetOrDefault("uid", null);
+            var user = Users.getUser(id);  // get the user
+            
+            if ((!canEdit && editorsMode.Equals("edit") || editorsMode.Equals("fillForms")) && _Default.FillFormsExts.Contains(ext)) {
+                editorsMode = "fillForms";
+                canEdit = true;
+            }            
+            var submitForm = editorsMode.Equals("fillForms") && id.Equals("uid-1") && false;  // check if the Submit form button is displayed or hidden
+            var mode = canEdit && editorsMode != "view" ? "edit" : "view";  // get the editor opening mode (edit or view)
 
             var jss = new JavaScriptSerializer();
 
-            object favorite = null;
-            if (!string.IsNullOrEmpty(Request.Cookies.GetOrDefault("uid", null)))
+            // favorite icon state
+            bool? favorite = user.favorite;
+
+            var actionLink = Request.GetOrDefault("actionLink", null);  // get the action link (comment or bookmark) if it exists
+            var actionData = string.IsNullOrEmpty(actionLink) ? null : jss.DeserializeObject(actionLink);  // get action data for the action link
+
+            var directUrl = getDownloadUrl(FileName, false);
+            var createUrl = getCreateUrl(DocumentType, editorsType);
+            var templatesImageUrl = GetTemplateImageUrl(ext); // image url for templates
+            var templates = new List<Dictionary<string, string>>
             {
-                favorite = Request.Cookies.GetOrDefault("uid", null).Equals("uid-2");
-            }
-
-            var actionLink = Request.GetOrDefault("actionLink", null);
-            var actionData = string.IsNullOrEmpty(actionLink) ? null : jss.DeserializeObject(actionLink);
+                new Dictionary<string, string>()
+                {
+                    { "image", "" },
+                    { "title", "Blank" },
+                    { "url", createUrl }
+                },
+                new Dictionary<string, string>()
+                {
+                    { "image", templatesImageUrl },
+                    { "title", "With sample content" },
+                    { "url", createUrl + "&sample=true" }
+                }
+            };
 
+            // specify the document config
             var config = new Dictionary<string, object>
                 {
-                    { "type", Request.GetOrDefault("editorsType", "desktop") },
-                    { "documentType", documentType },
+                    { "type", editorsType },
+                    { "documentType", DocumentType },
                     {
                         "document", new Dictionary<string, object>
                             {
                                 { "title", FileName },
-                                { "url", FileUri },
+                                { "url", getDownloadUrl(FileName) },
+                                { "directUrl", IsEnabledDirectUrl() ? directUrl : "" },
                                 { "fileType", ext.Trim('.') },
                                 { "key", Key },
                                 {
@@ -154,16 +207,22 @@ namespace OnlineEditorsExample
                                         }
                                 },
                                 {
+                                    // the permission for the document to be edited and downloaded or not
                                     "permissions", new Dictionary<string, object>
                                         {
                                             { "comment", editorsMode != "view" && editorsMode != "fillForms" && editorsMode != "embedded" && editorsMode != "blockcontent"},
-                                            { "download", true },
-                                            { "edit", canEdit && (editorsMode == "edit" || editorsMode == "filter") || editorsMode == "blockcontent" },
+                                            { "copy", !user.deniedPermissions.Contains("copy") },
+                                            { "download", !user.deniedPermissions.Contains("download") },
+                                            { "edit", canEdit && (editorsMode == "edit" || editorsMode =="view" || editorsMode == "filter" || editorsMode == "blockcontent") },
+                                            { "print", !user.deniedPermissions.Contains("print") },
                                             { "fillForms", editorsMode != "view" && editorsMode != "comment" && editorsMode != "embedded" && editorsMode != "blockcontent" },
                                             { "modifyFilter", editorsMode != "filter" },
                                             { "modifyContentControl", editorsMode != "blockcontent" },
-                                            { "review", editorsMode == "edit" || editorsMode == "review" },
-                                            { "reviewGroups", reviewGroups }
+                                            { "review", canEdit && (editorsMode == "edit" || editorsMode == "review") },
+                                            { "chat", !user.id.Equals("uid-0") },
+                                            { "reviewGroups", user.reviewGroups },
+                                            { "commentGroups", user.commentGroups },
+                                            { "userInfoGroups", user.userInfoGroups }
                                         }
                                 }
                             }
@@ -174,35 +233,46 @@ namespace OnlineEditorsExample
                                 { "actionLink", actionData },
                                 { "mode", mode },
                                 { "lang", Request.Cookies.GetOrDefault("ulang", "en") },
-                                { "callbackUrl", CallbackUrl },
+                                { "callbackUrl", CallbackUrl },  // absolute URL to the document storage service
+                                { "coEditing", editorsMode == "view" && user.id.Equals("uid-0") ? 
+                                    new Dictionary<string, object>{
+                                        {"mode", "strict"},
+                                        {"change", false}
+                                    } : null },
+                                { "createUrl", !user.id.Equals("uid-0") ? createUrl : null },
+                                { "templates", user.templates ? templates : null },
                                 {
+                                    // the user currently viewing or editing the document
                                     "user", new Dictionary<string, object>
                                         {
-                                            { "id", userId },
-                                            { "name",  uname },
-                                            { "group", userGroup }
+                                            { "id", !user.id.Equals("uid-0") ? user.id : null },
+                                            { "name",  user.name },
+                                            { "group", user.group }
                                         }
                                 },
                                 {
+                                    // the parameters for the embedded document type
                                     "embedded", new Dictionary<string, object>
                                         {
-                                            { "saveUrl", FileUriUser },
-                                            { "embedUrl", FileUriUser },
-                                            { "shareUrl", FileUriUser },
-                                            { "toolbarDocked", "top" }
+                                            { "saveUrl", directUrl },  // the absolute URL that will allow the document to be saved onto the user personal computer
+                                            { "embedUrl", directUrl },  // the absolute URL to the document serving as a source file for the document embedded into the web page
+                                            { "shareUrl", directUrl },  // the absolute URL that will allow other users to share this document
+                                            { "toolbarDocked", "top" }  // the place for the embedded viewer toolbar (top or bottom)
                                         }
                                 },
                                 {
+                                    // the parameters for the editor interface
                                     "customization", new Dictionary<string, object>
                                         {
-                                            { "about", true },
-                                            { "feedback", true },
-                                            { "forcesave", false },
-                                            { "submitForm", submitForm },
+                                            { "about", true },  // the About section display
+                                            { "comments", true },
+                                            { "feedback", true },  // the Feedback & Support menu button display
+                                            { "forcesave", false },  // adds the request for the forced file saving to the callback handler
+                                            { "submitForm", submitForm },  // if the Submit form button is displayed or not
                                             {
-                                                "goback", new Dictionary<string, object>
+                                                "goback", new Dictionary<string, object>  // settings for the Open file location menu button and upper right corner button
                                                     {
-                                                        { "url", _Default.GetServerUrl(false) + "default.aspx" }
+                                                        { "url", _Default.GetServerUrl(false) + "default.aspx" }  // the absolute URL to the website address which will be opened when clicking the Open file location menu button
                                                     }
                                             }
                                         }
@@ -211,8 +281,10 @@ namespace OnlineEditorsExample
                     }
                 };
 
+            // if the secret key to generate token exists
             if (JwtManager.Enabled)
             {
+                // encode the document config into a token
                 var token = JwtManager.Encode(config);
                 config.Add("token", token);
             }
@@ -221,19 +293,26 @@ namespace OnlineEditorsExample
 
             try
             {
+                // a logo which will be inserted into the document
                 Dictionary<string, object> logoConfig = GetLogoConfig();
                 InsertImageConfig = jss.Serialize(logoConfig).Replace("{", "").Replace("}", "");
 
+                // a document which will be compared with the current document
                 Dictionary<string, object> compareFile = GetCompareFile();
-                compareFileData = jss.Serialize(compareFile);
+                CompareFileData = jss.Serialize(compareFile);
 
+                // recipient data for mail merging
                 Dictionary<string, object> mailMergeConfig = GetMailMergeConfig();
-                dataMailMergeRecipients = jss.Serialize(mailMergeConfig);
+                DataMailMergeRecipients = jss.Serialize(mailMergeConfig);
 
+                // get users for mentions
+                List<Dictionary<string, object>> usersData = Users.getUsersForMentions(user.id);
+                UsersForMentions = !user.id.Equals("uid-0") ? jss.Serialize(usersData) : null;
 
                 Dictionary<string, object> hist;
                 Dictionary<string, object> histData;
   
+                // get the document history
                 GetHistory(out hist, out histData);
                 if (hist != null && histData != null)
                 {
@@ -244,38 +323,40 @@ namespace OnlineEditorsExample
             catch { }
         }
 
+        // get the document history
         private void GetHistory(out Dictionary<string, object> history, out Dictionary<string, object> historyData)
         {
+            var storagePath = WebConfigurationManager.AppSettings["storage-path"];
             var jss = new JavaScriptSerializer();
             var histDir = _Default.HistoryDir(_Default.StoragePath(FileName, null));
 
             history = null;
             historyData = null;
 
-            if (_Default.GetFileVersion(histDir) > 0)
+            if (_Default.GetFileVersion(histDir) > 0)  // if the file was modified (the file version is greater than 0)
             {
                 var currentVersion = _Default.GetFileVersion(histDir);
                 var hist = new List<Dictionary<string, object>>();
                 var histData = new Dictionary<string, object>();
 
-                for (var i = 1; i <= currentVersion; i++)
+                for (var i = 1; i <= currentVersion; i++)  // run through all the file versions
                 {
                     var obj = new Dictionary<string, object>();
                     var dataObj = new Dictionary<string, object>();
-                    var verDir = _Default.VersionDir(histDir, i);
+                    var verDir = _Default.VersionDir(histDir, i);  // get the path to the given file version
 
-                    var key = i == currentVersion ? Key : File.ReadAllText(Path.Combine(verDir, "key.txt"));
+                    var key = i == currentVersion ? Key : File.ReadAllText(Path.Combine(verDir, "key.txt"));  // get document key
 
                     obj.Add("key", key);
                     obj.Add("version", i);
 
-                    if (i == 1)
+                    if (i == 1)  // check if the version number is equal to 1
                     {
-                        var infoPath = Path.Combine(histDir, "createdInfo.json");
+                        var infoPath = Path.Combine(histDir, "createdInfo.json");  // get meta data of this file
 
                         if (File.Exists(infoPath)) {
                             var info = jss.Deserialize<Dictionary<string, object>>(File.ReadAllText(infoPath));
-                            obj.Add("created", info["created"]);
+                            obj.Add("created", info["created"]);  // write meta information to the object (user information and creation date)
                             obj.Add("user", new Dictionary<string, object>() {
                                 { "id", info["id"] },
                                 { "name", info["name"] },
@@ -283,35 +364,69 @@ namespace OnlineEditorsExample
                         }
                     }
 
+                    var ext = Path.GetExtension(FileName).ToLower();
+                    dataObj.Add("fileType", ext.Replace(".", ""));
                     dataObj.Add("key", key);
-                    dataObj.Add("url", i == currentVersion ? FileUri : MakePublicUrl(Directory.GetFiles(verDir, "prev.*")[0]));
-                    dataObj.Add("version", i);
-                    if (i > 1)
+                    // write file url to the data object
+                    var directPrevFileUrl = i == currentVersion ? _Default.FileUri(FileName, false) : MakePublicHistoryUrl(FileName, i.ToString(), "prev" + ext, false);
+                    var prevFileUrl = i == currentVersion ? FileUri : MakePublicHistoryUrl(FileName, i.ToString(), "prev" + ext);
+                    if (Path.IsPathRooted(storagePath))
                     {
+                        prevFileUrl = i == currentVersion ? getDownloadUrl(FileName) : getDownloadUrl(Directory.GetFiles(verDir, "prev.*")[0].Replace(storagePath + "\\", ""));
+                        directPrevFileUrl = i == currentVersion ? getDownloadUrl(FileName, false) : getDownloadUrl(Directory.GetFiles(verDir, "prev.*")[0].Replace(storagePath + "\\", ""), false);
+                    }
+
+                    dataObj.Add("url", prevFileUrl);  // write file url to the data object
+
+                    if (IsEnabledDirectUrl())
+                    {
+                        dataObj.Add("directUrl", directPrevFileUrl); // write direct url to the data object
+                    } 
+
+                    dataObj.Add("version", i);
+                    if (i > 1)  // check if the version number is greater than 1 (the file was modified)
+                    {
+                        // get the path to the changes.json file 
                         var changes = jss.Deserialize<Dictionary<string, object>>(File.ReadAllText(Path.Combine(_Default.VersionDir(histDir, i - 1), "changes.json")));
-                        var change = ((Dictionary<string, object>)((ArrayList)changes["changes"])[0]);
+                        var changesArray = (ArrayList)changes["changes"];
+                        var change = changesArray.Count > 0
+                            ? (Dictionary<string, object>)changesArray[0]
+                            : new Dictionary<string, object>();
 
-                        obj.Add("changes", changes["changes"]);
+                        // write information about changes to the object
+                        obj.Add("changes", change.Count > 0 ? changes["changes"] : null);
                         obj.Add("serverVersion", changes["serverVersion"]);
-                        obj.Add("created", change["created"]);
-                        obj.Add("user", change["user"]);
+                        obj.Add("created", change.Count > 0 ? change["created"] : null);
+                        obj.Add("user", change.Count > 0 ? change["user"] : null);
 
-                        var prev = (Dictionary<string, object>)histData[(i - 2).ToString()];
-                        dataObj.Add("previous", new Dictionary<string, object>() {
-                            { "key", prev["key"] },
-                            { "url", prev["url"] },
-                        });
-                        dataObj.Add("changesUrl", MakePublicUrl(Path.Combine(_Default.VersionDir(histDir, i - 1), "diff.zip")));
+                        var prev = (Dictionary<string, object>)histData[(i - 2).ToString()];  // get the history data from the previous file version
+
+                        Dictionary<string, object> dataPrev = new Dictionary<string, object>() {  // write information about previous file version to the data object
+                            { "fileType", prev["fileType"] },
+                            { "key", prev["key"] },  // write key and url information about previous file version
+                            { "url", prev["url"] }
+                        };
+
+                        if (IsEnabledDirectUrl())
+                        {
+                            dataPrev.Add("directUrl", prev["directUrl"]);
+                        }
+
+                        dataObj.Add("previous", dataPrev);
+                        // write the path to the diff.zip archive with differences in this file version
+                        var changesUrl = MakePublicHistoryUrl(FileName, (i - 1).ToString(), "diff.zip");
+                        dataObj.Add("changesUrl", changesUrl);
                     }
                     if (JwtManager.Enabled)
                     {
                         var token = JwtManager.Encode(dataObj);
                         dataObj.Add("token", token);
                     }
-                    hist.Add(obj);
-                    histData.Add((i - 1).ToString(), dataObj);
+                    hist.Add(obj);  // add object dictionary to the hist list
+                    histData.Add((i - 1).ToString(), dataObj);  // write data object information to the history data
                 }
 
+                // write history information about the current file version to the history object
                 history = new Dictionary<string, object>()
                 {
                     { "currentVersion", currentVersion },
@@ -321,53 +436,82 @@ namespace OnlineEditorsExample
             }
         }
 
+        // get a logo config
         private Dictionary<string, object> GetLogoConfig()
         {
+            // get the path to the logo image
             var InsertImageUrl = new UriBuilder(_Default.GetServerUrl(true));
             InsertImageUrl.Path = HttpRuntime.AppDomainAppVirtualPath
                 + (HttpRuntime.AppDomainAppVirtualPath.EndsWith("/") ? "" : "/")
                 + "App_Themes\\images\\logo.png";
 
+            var DirectImageUrl = new UriBuilder(_Default.GetServerUrl(false));
+            DirectImageUrl.Path = HttpRuntime.AppDomainAppVirtualPath
+                + (HttpRuntime.AppDomainAppVirtualPath.EndsWith("/") ? "" : "/")
+                + "App_Themes\\images\\logo.png";
+
+            // create a logo config
             Dictionary<string, object> logoConfig = new Dictionary<string, object>
                 {
                     { "fileType", "png"},
                     { "url", InsertImageUrl.ToString()}
                 };
 
-            if (JwtManager.Enabled)
+            if (IsEnabledDirectUrl())
             {
-                var insImageToken = JwtManager.Encode(logoConfig);
-                logoConfig.Add("token", insImageToken);
+                logoConfig.Add("directUrl", DirectImageUrl.ToString());
+            }
+
+            if (JwtManager.Enabled)  // if the secret key to generate token exists
+            {
+                var insImageToken = JwtManager.Encode(logoConfig);  // encode logoConfig into the token
+                logoConfig.Add("token", insImageToken);  // and add it to the logo config
             }
 
             return logoConfig;
         }
 
+        // get a document which will be compared with the current document
         private Dictionary<string, object> GetCompareFile()
         {
+            // get the path to the compared file
             var compareFileUrl = new UriBuilder(_Default.GetServerUrl(true));
             compareFileUrl.Path = HttpRuntime.AppDomainAppVirtualPath
                 + (HttpRuntime.AppDomainAppVirtualPath.EndsWith("/") ? "" : "/")
                 + "webeditor.ashx";
             compareFileUrl.Query = "type=assets&fileName=" + HttpUtility.UrlEncode("sample.docx");
 
+            var DirectFileUrl = new UriBuilder(_Default.GetServerUrl(false));
+            DirectFileUrl.Path = HttpRuntime.AppDomainAppVirtualPath
+                + (HttpRuntime.AppDomainAppVirtualPath.EndsWith("/") ? "" : "/")
+                + "webeditor.ashx";
+            DirectFileUrl.Query = "type=assets&fileName=" + HttpUtility.UrlEncode("sample.docx");
+
+            // create an object with the information about the compared file
             Dictionary<string, object> dataCompareFile = new Dictionary<string, object>
                 {
                     { "fileType", "docx" },
                     { "url", compareFileUrl.ToString() }
                 };
 
-            if (JwtManager.Enabled)
+            if (IsEnabledDirectUrl())
             {
-                var compareFileToken = JwtManager.Encode(dataCompareFile);
-                dataCompareFile.Add("token", compareFileToken);
+                dataCompareFile.Add("directUrl", DirectFileUrl.ToString());
+            }
+
+            if (JwtManager.Enabled)  // if the secret key to generate token exists
+            {
+                var compareFileToken = JwtManager.Encode(dataCompareFile);  // encode the dataCompareFile object into the token
+                dataCompareFile.Add("token", compareFileToken);  // and add it to the dataCompareFile object
             }
 
             return dataCompareFile;
         }
 
+        // get a mail merge config
         private Dictionary<string, object> GetMailMergeConfig()
         {
+            // get the path to the recipients data for mail merging
             var mailmergeUrl = new UriBuilder(_Default.GetServerUrl(true));
             mailmergeUrl.Path =
                     HttpRuntime.AppDomainAppVirtualPath
@@ -375,64 +519,132 @@ namespace OnlineEditorsExample
                     + "webeditor.ashx";
             mailmergeUrl.Query = "type=csv";
 
+            var DirectMailMergeUrl = new UriBuilder(_Default.GetServerUrl(false));
+            DirectMailMergeUrl.Path =
+                    HttpRuntime.AppDomainAppVirtualPath
+                    + (HttpRuntime.AppDomainAppVirtualPath.EndsWith("/") ? "" : "/")
+                    + "webeditor.ashx";
+            DirectMailMergeUrl.Query = "type=csv";
+
+            // create a mail merge config
             Dictionary<string, object> mailMergeConfig = new Dictionary<string, object>
                 {
                     { "fileType", "csv" },
                     { "url", mailmergeUrl.ToString() }
                 };
 
-            if (JwtManager.Enabled)
+            if (IsEnabledDirectUrl())
             {
-                var mailmergeToken = JwtManager.Encode(mailMergeConfig);
-                mailMergeConfig.Add("token", mailmergeToken);
+                mailMergeConfig.Add("directUrl", DirectMailMergeUrl.ToString());
+            }
+
+            if (JwtManager.Enabled)  // if the secret key to generate token exists
+            {
+                var mailmergeToken = JwtManager.Encode(mailMergeConfig);  // encode mailMergeConfig into the token
+                mailMergeConfig.Add("token", mailmergeToken);  // and add it to the mail merge config
             }
 
             return mailMergeConfig;
         }
 
+        // get image url for templates
+        private string GetTemplateImageUrl (string ext)
+        {
+            var path = new UriBuilder(_Default.GetServerUrl(true)) // templates image url in the "From Template" section
+            {
+                Path = HttpRuntime.AppDomainAppVirtualPath
+                + (HttpRuntime.AppDomainAppVirtualPath.EndsWith("/") ? "" : "/")
+                + "App_Themes\\images\\"
+            };
+            switch (ext)
+            {
+                case ".docx":
+                    return path + "file_docx.svg"; // for word document type
+                case ".xlsx":
+                    return path + "file_xlsx.svg"; // .xlsx for cell document type
+                case ".pptx":
+                    return path + "file_pptx.svg"; // .pptx for slide document type
+                default:
+                    return path + "file_docx.svg"; // the default value
+            }
+        }
+
+        // create the public url
         private string MakePublicUrl(string fullPath)
         {
-            var root = HttpRuntime.AppDomainAppPath + WebConfigurationManager.AppSettings["storage-path"];
+            var root = Path.IsPathRooted(WebConfigurationManager.AppSettings["storage-path"]) ? WebConfigurationManager.AppSettings["storage-path"] 
+                : HttpRuntime.AppDomainAppPath + WebConfigurationManager.AppSettings["storage-path"];
             return _Default.GetServerUrl(true) + fullPath.Substring(root.Length).Replace(Path.DirectorySeparatorChar, '/');
         }
 
+
+        // create the public history url
+        private string MakePublicHistoryUrl(string filename, string version, string file, Boolean isServer = true)
+        {
+            var userAddress = isServer ? "&userAddress=" + HttpUtility.UrlEncode(_Default.CurUserHostAddress(HttpContext.Current.Request.UserHostAddress)) : "";
+            var fileUrl = new UriBuilder(_Default.GetServerUrl(isServer));
+            fileUrl.Path = HttpRuntime.AppDomainAppVirtualPath
+                + (HttpRuntime.AppDomainAppVirtualPath.EndsWith("/") ? "" : "/")
+                + "webeditor.ashx";
+            fileUrl.Query = "type=downloadhistory&fileName=" + HttpUtility.UrlEncode(filename)
+                + "&ver=" + version + "&file=" + file
+                + userAddress;
+            return fileUrl.ToString();
+        }
+
+        // create demo document
         private static void Try(string type, string sample, HttpRequest request)
         {
             string ext;
             switch (type)
             {
                 case "word":
-                    ext = ".docx";
+                    ext = ".docx";  // .docx for word document type
                     break;
                 case "cell":
-                    ext = ".xlsx";
+                    ext = ".xlsx";  // .xlsx for cell document type
                     break;
                 case "slide":
-                    ext = ".pptx";
+                    ext = ".pptx";  // .pptx for slide document type
+                    break;
+                case "docxf":
+                    ext = ".docxf";
                     break;
                 default:
                     return;
             }
-            var demoName = (string.IsNullOrEmpty(sample) ? "new" : "sample") + ext;
-            var demoPath = "assets\\" + (string.IsNullOrEmpty(sample) ? "new\\" : "sample\\");
+            var demoName = (string.IsNullOrEmpty(sample) ? "new" : "sample") + ext;  // create demo document name with the necessary extension
+            var demoPath = "assets\\" + (string.IsNullOrEmpty(sample) ? "new\\" : "sample\\");  // and put this file into the assets directory
 
-            FileName = _Default.GetCorrectName(demoName);
+            FileName = _Default.GetCorrectName(demoName);  // get file name with an index if such a file name already exists
 
             var filePath = _Default.StoragePath(FileName, null);
-            File.Copy(HttpRuntime.AppDomainAppPath + demoPath + demoName, filePath);
+            File.Copy(HttpRuntime.AppDomainAppPath + demoPath + demoName, filePath);  // copy this file to the storage directory
 
-            CreateMeta(FileName, request.Cookies.GetOrDefault("uid", "uid-1"), request.Cookies.GetOrDefault("uname", "John Smith"), null);
+            // create a json file with file meta data
+            var id = request.Cookies.GetOrDefault("uid", null);
+            var user = Users.getUser(id);  // get the user
+            CreateMeta(FileName, user.id, user.name, null);
         }
 
+        // create a json file with file meta data
         public static void CreateMeta(string fileName, string uid, string uname, string userAddress)
         {
             var histDir = _Default.HistoryDir(_Default.StoragePath(fileName, userAddress)); 
             Directory.CreateDirectory(histDir);
+            // create the meta data object and write the information into the createdInfo.json file
             File.WriteAllText(Path.Combine(histDir, "createdInfo.json"), new JavaScriptSerializer().Serialize(new Dictionary<string, object> {
                 { "created", DateTime.Now.ToString("yyyy'-'MM'-'dd HH':'mm':'ss") },
                 { "id", uid },
                 { "name", uname }
             }));
         }
+
+        // get direct url flag
+        private static bool IsEnabledDirectUrl()
+        {
+            string isEnabledDirectUrl = HttpUtility.ParseQueryString(HttpContext.Current.Request.Url.Query).Get("directUrl");
+            return isEnabledDirectUrl != null ? Convert.ToBoolean(isEnabledDirectUrl) : false;
+        }
     }
 }