Merge branch 'master' into release/v6.0.0

# Conflicts:
#	LICENSE.txt

3rd-Party.txt

@@ -28,3 +28,17 @@ Steve Matteson
 
 License:        Apache License, version 2.0
 
+
+6. requests - Requests is an elegant and simple HTTP library for Python
+
+License:        Apache License, version 2.0
+
+
+7. pyjwt - JSON Web Token implementation in Python
+
+License:        MIT
+
+
+8. django - Django is a high-level Python Web framework that encourages rapid development and clean, pragmatic design
+
+License:        BSD

LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   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.

Readme.md

@@ -1,5 +1,5 @@
 
-[![License](https://img.shields.io/badge/License-MIT-green.svg?style=flat)](https://opensource.org/licenses/MIT) ![Release](https://img.shields.io/badge/Release-v4.1.2-blue.svg?style=flat)
+[![License](https://img.shields.io/badge/License-MIT-green.svg?style=flat)](https://opensource.org/licenses/MIT) ![Release](https://img.shields.io/badge/Release-v6.0.0-blue.svg?style=flat)
 
 ## Document Server integration example
 
@@ -15,6 +15,34 @@ You should change `http://documentserver` to your server address in these files:
 
 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")
 
+## API methods for test examples
+
+The methods described below are available for all of the test examples.
+
+### POST `/upload`
+
+|                        |                                                              |
+| ---------------------- | ------------------------------------------------------------ |
+| **Summary**            | Upload file to test example via request                      |
+| **URL**                | /upload                                                      |
+| **Method**             | POST                                                         |
+| **Request<br>Headers** | `Content-Type: multipart/form-data`                          |
+| **Request<br>Body**    | `uploadedFile=@<filepath>`<br> `filepath` - file for uploading<br />Multipart body with the file binary contents |
+| **Response**           | **Code:** 200 OK <br />**Content on success:**<br /> `{ "filename": <filename>}`<br />**Content on error:**<br /> `{ "error": "Uploaded file not found"}` <br /> Or <br /> `{ "error": "File size is incorrect"}` |
+| **Sample**             | `curl -X POST -F uploadedFile=@filename.docx http://localhost/upload` |
+
+
+### DELETE `/file`
+
+|                    |                                                              |
+| ------------------ | ------------------------------------------------------------ |
+| **Summary**        | Delete one file or all files                     
+| **URL**            | /file                                                        |
+| **Method**         | DELETE                                                       |
+| ****URL Params**** | **Optional:**<br /> `filename=[string]` - file for deleting. <br /> *WARNING! Without this parameter, all files will be deleted* |
+| **Response**       | **Code:** 200 OK <br /> **Success:**<br /> `{"success":true}` |
+| **Sample**         | **Delete one file:**<br />`curl -X DELETE http://localhost/file?filename=filename.docx`<br />**Delete all files:**<br />`curl -X DELETE http://localhost/file`<br /> |
+
 ## Project Information
 
 Official website: [https://www.onlyoffice.com](https://www.onlyoffice.com/?utm_source=github&utm_medium=cpc&utm_campaign=GitHubIntegrationEx)

build/msbuild/zip.proj

@@ -16,6 +16,8 @@
     <DirPHP>$(RootDir)web\documentserver-example\php\</DirPHP>
     <NameRuby>$(To)Ruby Example</NameRuby>
     <DirRuby>$(RootDir)web\documentserver-example\ruby\</DirRuby>
+    <NamePython>$(To)Python Example</NamePython>
+    <DirPython>$(RootDir)web\documentserver-example\python\</DirPython>
   </PropertyGroup>
 
   <Target Name="Build">
@@ -56,6 +58,12 @@
     </ItemGroup>
     <Copy SourceFiles="@(ZipFilesRuby)" DestinationFiles="@(ZipFilesRuby->'$(NameRuby)\%(RecursiveDir)%(Filename)%(Extension)')" />
     <Zip Files="$(NameRuby)" WorkingDirectory="$(To)" ZipFileName="$(NameRuby).zip" />
+
+    <ItemGroup>
+      <ZipFilesPython Include="$(DirPython)**" />
+    </ItemGroup>
+    <Copy SourceFiles="@(ZipFilesPython)" DestinationFiles="@(ZipFilesPython->'$(NamePython)\%(RecursiveDir)%(Filename)%(Extension)')" />
+    <Zip Files="$(NamePython)" WorkingDirectory="$(To)" ZipFileName="$(NamePython).zip" />
   </Target>
 
 </Project>

licences/3rd-Party.txt

@@ -25,3 +25,18 @@ License:        MIT
 5. Prime JWT - Prime JWT is intended to be fast and easy to use. Prime JWT has a single external dependency on Jackson.
 
 License:        Apache-2.0
+
+
+6. requests - Requests is an elegant and simple HTTP library for Python
+
+License:        Apache License, version 2.0
+
+
+7. pyjwt - JSON Web Token implementation in Python
+
+License:        MIT
+
+
+8. django - Django is a high-level Python Web framework that encourages rapid development and clean, pragmatic design
+
+License:        BSD

licences/django.license

@@ -0,0 +1,27 @@
+Copyright (c) Django Software Foundation and individual contributors.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+    1. Redistributions of source code must retain the above copyright notice,
+       this list of conditions and the following disclaimer.
+
+    2. Redistributions in binary form must reproduce the above copyright
+       notice, this list of conditions and the following disclaimer in the
+       documentation and/or other materials provided with the distribution.
+
+    3. Neither the name of Django nor the names of its contributors may be used
+       to endorse or promote products derived from this software without
+       specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

licences/pyjwt.license

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2019 ONLYOFFICE
+Copyright (c) 2015 José Padilla
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

licences/requests.license

@@ -0,0 +1,13 @@
+Copyright 2019 Kenneth Reitz
+
+   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
+
+       https://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.

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

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

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

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

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

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

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

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

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

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

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

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

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

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *
@@ -52,7 +52,7 @@ namespace OnlineEditorsExampleMVC.Controllers
         public ActionResult Sample(string fileExt, bool? sample)
         {
             var fileName = DocManagerHelper.CreateDemo(fileExt, sample ?? false);
-            DocManagerHelper.CreateMeta(fileName, Request.Cookies["uid"]?.Value, Request.Cookies["uname"]?.Value);
+            DocManagerHelper.CreateMeta(fileName, Request.Cookies.GetOrDefault("uid", ""), Request.Cookies.GetOrDefault("uname", ""));
             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 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

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

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

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

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

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

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

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

@@ -0,0 +1,21 @@
+using System.Web;
+
+namespace OnlineEditorsExampleMVC.Helpers
+{
+    public static class Utils
+    {
+        public static string GetOrDefault(this HttpRequest request, string header, string def)
+        {
+            var value = request[header];
+            if (value != null) return value;
+            return def;
+        }
+
+        public static string GetOrDefault(this HttpCookieCollection cookies, string cookie, string def)
+        {
+            var cook = cookies[cookie];
+            if (cook != null && !string.IsNullOrEmpty(cook.Value)) return cook.Value;
+            return def;
+        }
+    }
+}

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

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2019 ONLYOFFICE
+Copyright (c) 2020 ONLYOFFICE
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

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

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *
@@ -64,12 +64,17 @@ namespace OnlineEditorsExampleMVC.Models
 
         public string GetDocConfig(HttpRequest request, UrlHelper url)
         {
+            var jss = new JavaScriptSerializer();
+
             var ext = Path.GetExtension(FileName);
             var editorsMode = Mode ?? "edit";
 
             var canEdit = DocManagerHelper.EditedExts.Contains(ext);
             var mode = canEdit && editorsMode != "view" ? "edit" : "view";
 
+            var actionLink = request.GetOrDefault("actionLink", null);
+            var actionData = string.IsNullOrEmpty(actionLink) ? null : jss.DeserializeObject(actionLink);
+
             var config = new Dictionary<string, object>
                 {
                     { "type", Type ?? "desktop" },
@@ -105,14 +110,15 @@ namespace OnlineEditorsExampleMVC.Models
                     {
                         "editorConfig", new Dictionary<string, object>
                             {
+                                { "actionLink", actionData },
                                 { "mode", mode },
-                                { "lang", request.Cookies["ulang"]?.Value ?? "en" },
+                                { "lang", request.Cookies.GetOrDefault("ulang", "en") },
                                 { "callbackUrl", CallbackUrl },
                                 {
                                     "user", new Dictionary<string, object>
                                         {
-                                            { "id", request.Cookies["uid"]?.Value ?? "uid-1" },
-                                            { "name", request.Cookies["uname"]?.Value ?? "John Smith" }
+                                            { "id", request.Cookies.GetOrDefault("uid", "uid-1") },
+                                            { "name", request.Cookies.GetOrDefault("uname", "John Smith") }
                                         }
                                 },
                                 {
@@ -147,7 +153,7 @@ namespace OnlineEditorsExampleMVC.Models
                 config.Add("token", token);
             }
 
-            return new JavaScriptSerializer().Serialize(config);
+            return jss.Serialize(config);
         }
 
         public void GetHistory(out string history, out string historyData)

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

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

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

@@ -137,6 +137,7 @@
     <Compile Include="Helpers\DocManagerHelper.cs" />
     <Compile Include="Helpers\DocumentConverter.cs" />
     <Compile Include="Helpers\JwtManager.cs" />
+    <Compile Include="Helpers\Utils.cs" />
     <Compile Include="Models\FileModel.cs" />
     <Compile Include="Models\FileUtility.cs" />
     <Compile Include="Properties\AssemblyInfo.cs" />

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 2019")]
+[assembly: AssemblyCopyright("Ascensio System SIA 2020")]
 [assembly: AssemblyTrademark("")]
 [assembly: AssemblyCulture("")]
 

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

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

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

@@ -1,6 +1,6 @@
 <!--*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *
@@ -83,6 +83,28 @@
             location.reload(true);
         };
 
+        var replaceActionLink = function(href, linkParam) {
+            var link;
+            var actionIndex = href.indexOf("&actionLink=");
+            if (actionIndex != -1) {
+                var endIndex = href.indexOf("&", actionIndex + "&actionLink=".length);
+                if (endIndex != -1) {
+                    link = href.substring(0, actionIndex) + href.substring(endIndex) + "&actionLink=" + encodeURIComponent(linkParam);
+                } else {
+                    link = href.substring(0, actionIndex) + "&actionLink=" + encodeURIComponent(linkParam);
+                }
+            } else {
+                link = href + "&actionLink=" + encodeURIComponent(linkParam);
+            }
+            return link;
+        }
+
+        var onMakeActionLink = function (event) {
+            var actionData = event.data;
+            var linkParam = JSON.stringify(actionData);
+            docEditor.setActionLink(replaceActionLink(location.href, linkParam));
+        };
+
         var config = <%= Model.GetDocConfig(Request, Url) %>;
 
         config.width = "100%";
@@ -94,6 +116,7 @@
             'onRequestEditRights': onRequestEditRights,
             'onError': onError,
             'onOutdatedVersion': onOutdatedVersion,
+            "onMakeActionLink": onMakeActionLink,
         };
 
         <% string hist, histData; %>

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

@@ -1,6 +1,6 @@
 <!--*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *
@@ -59,7 +59,7 @@
                     <td width="30%" valign="middle">
                         <span class="select-user">Username:</span>
                         <select class="select-user" id="user">
-                            <option value="uid-1">Jonn Smith</option>
+                            <option value="uid-1">John Smith</option>
                             <option value="uid-2">Mark Pottato</option>
                             <option value="uid-3">Hamish Mitchell</option>
                         </select>

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

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *
@@ -95,7 +95,7 @@ namespace OnlineEditorsExampleMVC
 
                 var savedFileName = DocManagerHelper.StoragePath(fileName);
                 httpPostedFile.SaveAs(savedFileName);
-                DocManagerHelper.CreateMeta(fileName, context.Request.Cookies["uid"]?.Value, context.Request.Cookies["uname"]?.Value);
+                DocManagerHelper.CreateMeta(fileName, context.Request.Cookies.GetOrDefault("uid", ""), context.Request.Cookies.GetOrDefault("uname", ""));
 
                 context.Response.Write("{ \"filename\": \"" + fileName + "\"}");
             }
@@ -151,7 +151,7 @@ namespace OnlineEditorsExampleMVC
 
                     Remove(fileName);
                     fileName = correctName;
-                    DocManagerHelper.CreateMeta(fileName, context.Request.Cookies["uid"]?.Value, context.Request.Cookies["uname"]?.Value);
+                    DocManagerHelper.CreateMeta(fileName, context.Request.Cookies.GetOrDefault("uid", ""), context.Request.Cookies.GetOrDefault("uname", ""));
                 }
 
                 context.Response.Write("{ \"filename\" : \"" + fileName + "\"}");

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

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

web/documentserver-example/csharp/Default.aspx

@@ -54,7 +54,7 @@
                         <td width="30%" valign="middle">
                             <span class="select-user">Username:</span>
                             <select class="select-user" id="user">
-                                <option value="uid-1">Jonn Smith</option>
+                                <option value="uid-1">John Smith</option>
                                 <option value="uid-2">Mark Pottato</option>
                                 <option value="uid-3">Hamish Mitchell</option>
                             </select>

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

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *
@@ -241,8 +241,8 @@ namespace OnlineEditorsExample
             Directory.CreateDirectory(histDir);
             File.WriteAllText(Path.Combine(histDir, "createdInfo.json"), new JavaScriptSerializer().Serialize(new Dictionary<string, object> {
                 { "created", DateTime.Now.ToString() },
-                { "id", context.Request.Cookies["uid"]?.Value ?? "uid-1" },
-                { "name", context.Request.Cookies["uname"]?.Value ?? "John Smith" }
+                { "id", context.Request.Cookies.GetOrDefault("uid", "uid-1") },
+                { "name", context.Request.Cookies.GetOrDefault("uname", "John Smith") }
             }));
 
             return _fileName;
@@ -288,8 +288,8 @@ namespace OnlineEditorsExample
                 Directory.CreateDirectory(histDir);
                 File.WriteAllText(Path.Combine(histDir, "createdInfo.json"), new JavaScriptSerializer().Serialize(new Dictionary<string, object> {
                     { "created", DateTime.Now.ToString() },
-                    { "id", request.Cookies["uid"]?.Value ?? "uid-1" },
-                    { "name", request.Cookies["uname"]?.Value ?? "John Smith" }
+                    { "id", request.Cookies.GetOrDefault("uid", "uid-1") },
+                    { "name", request.Cookies.GetOrDefault("uname", "John Smith") }
                 }));
             }
             catch (Exception)
@@ -354,8 +354,8 @@ namespace OnlineEditorsExample
                 Directory.CreateDirectory(histDir);
                 File.WriteAllText(Path.Combine(histDir, "createdInfo.json"), new JavaScriptSerializer().Serialize(new Dictionary<string, object> {
                     { "created", DateTime.Now.ToString() },
-                    { "id", context.Request.Cookies["uid"]?.Value ?? "uid-1" },
-                    { "name", context.Request.Cookies["uname"]?.Value ?? "John Smith" }
+                    { "id", context.Request.Cookies.GetOrDefault("uid", "uid-1") },
+                    { "name", context.Request.Cookies.GetOrDefault("uname", "John Smith") }
                 }));
             }
 

web/documentserver-example/csharp/DocEditor.aspx

@@ -64,7 +64,7 @@
         };
 
         var onRequestEditRights = function () {
-            location.href = location.href.replace(RegExp("action=view\&?", "i"), "");
+            location.href = location.href.replace(RegExp("editorsMode=view\&?", "i"), "");
         };
 
         var onError = function (event) {
@@ -76,6 +76,28 @@
             location.reload(true);
         };
 
+        var replaceActionLink = function(href, linkParam) {
+            var link;
+            var actionIndex = href.indexOf("&actionLink=");
+            if (actionIndex != -1) {
+                var endIndex = href.indexOf("&", actionIndex + "&actionLink=".length);
+                if (endIndex != -1) {
+                    link = href.substring(0, actionIndex) + href.substring(endIndex) + "&actionLink=" + encodeURIComponent(linkParam);
+                } else {
+                    link = href.substring(0, actionIndex) + "&actionLink=" + encodeURIComponent(linkParam);
+                }
+            } else {
+                link = href + "&actionLink=" + encodeURIComponent(linkParam);
+            }
+            return link;
+        }
+
+        var onMakeActionLink = function (event) {
+            var actionData = event.data;
+            var linkParam = JSON.stringify(actionData);
+            docEditor.setActionLink(replaceActionLink(location.href, linkParam));
+        };
+
         var config = <%= DocConfig %>;
 
         config.width = "100%";
@@ -87,6 +109,7 @@
             'onRequestEditRights': onRequestEditRights,
             'onError': onError,
             'onOutdatedVersion': onOutdatedVersion,
+            'onMakeActionLink': onMakeActionLink,
         };
 
         <% if (!string.IsNullOrEmpty(History) && !string.IsNullOrEmpty(HistoryData))

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

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *
@@ -101,14 +101,19 @@ namespace OnlineEditorsExample
 
             var ext = Path.GetExtension(FileName);
 
-            var editorsMode = Request["editorsMode"] ?? "edit";
+            var editorsMode = Request.GetOrDefault("editorsMode", "edit");
 
             var canEdit = _Default.EditedExts.Contains(ext);
             var mode = canEdit && editorsMode != "view" ? "edit" : "view";
 
+            var jss = new JavaScriptSerializer();
+
+            var actionLink = Request.GetOrDefault("actionLink", null);
+            var actionData = string.IsNullOrEmpty(actionLink) ? null : jss.DeserializeObject(actionLink);
+
             var config = new Dictionary<string, object>
                 {
-                    { "type", Request["editorsType"] ?? "desktop" },
+                    { "type", Request.GetOrDefault("editorsType", "desktop") },
                     { "documentType", _Default.DocumentType(FileName) },
                     {
                         "document", new Dictionary<string, object>
@@ -141,14 +146,15 @@ namespace OnlineEditorsExample
                     {
                         "editorConfig", new Dictionary<string, object>
                             {
+                                { "actionLink", actionData },
                                 { "mode", mode },
-                                { "lang", Request.Cookies["ulang"]?.Value ?? "en" },
+                                { "lang", Request.Cookies.GetOrDefault("ulang", "en") },
                                 { "callbackUrl", CallbackUrl },
                                 {
                                     "user", new Dictionary<string, object>
                                         {
-                                            { "id", Request.Cookies["uid"]?.Value ?? "uid-1" },
-                                            { "name", Request.Cookies["uname"]?.Value ?? "John Smith" }
+                                            { "id", Request.Cookies.GetOrDefault("uid", "uid-1") },
+                                            { "name", Request.Cookies.GetOrDefault("uname", "John Smith") }
                                         }
                                 },
                                 {
@@ -183,13 +189,13 @@ namespace OnlineEditorsExample
                 config.Add("token", token);
             }
 
-            var jss = new JavaScriptSerializer();
-
             DocConfig = jss.Serialize(config);
 
             try
             {
-                GetHistory(out var hist, out var histData);
+                Dictionary<string, object> hist;
+                Dictionary<string, object> histData;
+                GetHistory(out hist, out histData);
                 if (hist != null && histData != null)
                 {
                     History = jss.Serialize(hist);
@@ -305,8 +311,8 @@ namespace OnlineEditorsExample
             Directory.CreateDirectory(histDir);
             File.WriteAllText(Path.Combine(histDir, "createdInfo.json"), new JavaScriptSerializer().Serialize(new Dictionary<string, object> {
                 { "created", DateTime.Now.ToString() },
-                { "id", request.Cookies["uid"]?.Value ?? "uid-1" },
-                { "name", request.Cookies["uname"]?.Value ?? "John Smith" }
+                { "id", request.Cookies.GetOrDefault("uid", "uid-1") },
+                { "name", request.Cookies.GetOrDefault("uname", "John Smith") }
             }));
         }
     }

web/documentserver-example/csharp/DocumentConverter.cs

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

web/documentserver-example/csharp/JwtManager.cs

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

web/documentserver-example/csharp/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2019 ONLYOFFICE
+Copyright (c) 2020 ONLYOFFICE
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

web/documentserver-example/csharp/OnlineEditorsExample.csproj

@@ -92,6 +92,7 @@
     <Compile Include="Default.aspx.designer.cs">
       <DependentUpon>Default.aspx</DependentUpon>
     </Compile>
+    <Compile Include="Utils.cs" />
     <Compile Include="WebEditor.ashx.cs">
       <DependentUpon>WebEditor.ashx</DependentUpon>
     </Compile>

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

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

web/documentserver-example/csharp/Utils.cs

@@ -0,0 +1,21 @@
+using System.Web;
+
+namespace OnlineEditorsExample
+{
+    public static class Utils
+    {
+        public static string GetOrDefault(this HttpRequest request, string header, string def)
+        {
+            var value = request[header];
+            if (value != null) return value;
+            return def;
+        }
+
+        public static string GetOrDefault(this HttpCookieCollection cookies, string cookie, string def)
+        {
+            var cook = cookies[cookie];
+            if (cook != null && !string.IsNullOrEmpty(cook.Value)) return cook.Value;
+            return def;
+        }
+    }
+}

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

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

web/documentserver-example/csharp/script/jscript.js

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

web/documentserver-example/java/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2019 ONLYOFFICE
+Copyright (c) 2020 ONLYOFFICE
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

web/documentserver-example/java/src/main/java/controllers/EditorServlet.java

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *
@@ -69,7 +69,7 @@ public class EditorServlet extends HttpServlet
             }
         }
 
-        FileModel file = new FileModel(fileName, cm.getCookie("ulang"), cm.getCookie("uid"), cm.getCookie("uname"));
+        FileModel file = new FileModel(fileName, cm.getCookie("ulang"), cm.getCookie("uid"), cm.getCookie("uname"), request.getParameter("actionLink"));
         file.changeType(request.getParameter("mode"), request.getParameter("type"));
 
         if (DocumentManager.TokenEnabled())

web/documentserver-example/java/src/main/java/controllers/GlobalServletContextListener.java

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

web/documentserver-example/java/src/main/java/controllers/IndexServlet.java

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

web/documentserver-example/java/src/main/java/entities/FileModel.java

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *
@@ -38,6 +38,7 @@ import helpers.DocumentManager;
 import helpers.ServiceConverter;
 import helpers.FileUtility;
 import com.google.gson.Gson;
+import com.google.gson.reflect.TypeToken;
 
 import org.json.simple.JSONArray;
 import org.json.simple.JSONObject;
@@ -52,7 +53,7 @@ public class FileModel
     public EditorConfig editorConfig;
     public String token;
 
-    public FileModel(String fileName, String lang, String uid, String uname)
+    public FileModel(String fileName, String lang, String uid, String uname, String actionData)
     {
         if (fileName == null) fileName = "";
         fileName = fileName.trim();
@@ -65,7 +66,7 @@ public class FileModel
         document.fileType = FileUtility.GetFileExtension(fileName).replace(".", "");
         document.key = ServiceConverter.GenerateRevisionId(DocumentManager.CurUserHostAddress(null) + "/" + fileName + "/" + Long.toString(new File(DocumentManager.StoragePath(fileName, null)).lastModified()));
 
-        editorConfig = new EditorConfig();
+        editorConfig = new EditorConfig(actionData);
         editorConfig.callbackUrl = DocumentManager.GetCallback(fileName);
         if (lang != null) editorConfig.lang = lang;
 
@@ -227,6 +228,7 @@ public class FileModel
 
     public class EditorConfig
     {
+        public HashMap<String, Object> actionLink = null;
         public String mode = "edit";
         public String callbackUrl;
         public String lang = "en";
@@ -234,8 +236,12 @@ public class FileModel
         public Customization customization;
         public Embedded embedded;
 
-        public EditorConfig()
+        public EditorConfig(String actionData)
         {
+            if (actionData != null) {
+                Gson gson = new Gson();
+                actionLink = gson.fromJson(actionData, new TypeToken<HashMap<String, Object>>() { }.getType());
+            }
             user = new User();
             customization = new Customization();
         }

web/documentserver-example/java/src/main/java/entities/FileType.java

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

web/documentserver-example/java/src/main/java/helpers/ConfigManager.java

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

web/documentserver-example/java/src/main/java/helpers/DocumentManager.java

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

web/documentserver-example/java/src/main/java/helpers/FileUtility.java

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

web/documentserver-example/java/src/main/java/helpers/ServiceConverter.java

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

web/documentserver-example/java/src/main/webapp/css/editor.css

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

web/documentserver-example/java/src/main/webapp/css/stylesheet.css

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

web/documentserver-example/java/src/main/webapp/editor.jsp

@@ -1,6 +1,6 @@
 <!--*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *
@@ -73,6 +73,28 @@
             location.reload(true);
         };
 
+        var replaceActionLink = function(href, linkParam) {
+            var link;
+            var actionIndex = href.indexOf("&actionLink=");
+            if (actionIndex != -1) {
+                var endIndex = href.indexOf("&", actionIndex + "&actionLink=".length);
+                if (endIndex != -1) {
+                    link = href.substring(0, actionIndex) + href.substring(endIndex) + "&actionLink=" + encodeURIComponent(linkParam);
+                } else {
+                    link = href.substring(0, actionIndex) + "&actionLink=" + encodeURIComponent(linkParam);
+                }
+            } else {
+                link = href + "&actionLink=" + encodeURIComponent(linkParam);
+            }
+            return link;
+        }
+
+        var onMakeActionLink = function (event) {
+            var actionData = event.data;
+            var linkParam = JSON.stringify(actionData);
+            docEditor.setActionLink(replaceActionLink(location.href, linkParam));
+        };
+
         var config = JSON.parse('<%= FileModel.Serialize(Model) %>');
         config.width = "100%";
         config.height = "100%";
@@ -82,6 +104,7 @@
             'onRequestEditRights': onRequestEditRights,
             "onError": onError,
             "onOutdatedVersion": onOutdatedVersion,
+            "onMakeActionLink": onMakeActionLink,
         };
 
         <%

web/documentserver-example/java/src/main/webapp/index.jsp

@@ -1,6 +1,6 @@
 <!--*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *
@@ -58,7 +58,7 @@
                         <td width="30%" valign="middle">
                             <span class="select-user">Username:</span>
                             <select class="select-user" id="user">
-                                <option value="uid-1">Jonn Smith</option>
+                                <option value="uid-1">John Smith</option>
                                 <option value="uid-2">Mark Pottato</option>
                                 <option value="uid-3">Hamish Mitchell</option>
                             </select>

web/documentserver-example/java/src/main/webapp/scripts/jscript.js

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

web/documentserver-example/js/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2019 ONLYOFFICE
+Copyright (c) 2020 ONLYOFFICE
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

web/documentserver-example/js/OnlineEditorsExampleJS.html

@@ -1,6 +1,6 @@
 <!--*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

web/documentserver-example/js/init.js

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

web/documentserver-example/js/stylesheet.css

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

web/documentserver-example/nodejs/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2019 ONLYOFFICE
+Copyright (c) 2020 ONLYOFFICE
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

web/documentserver-example/nodejs/app.js

@@ -1,7 +1,7 @@
 "use strict";
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *
@@ -202,7 +202,7 @@ app.post("/upload", function (req, res) {
                 res.write("{ \"filename\": \"" + file.name + "\"}");
 
                 const userid = req.query.userid ? req.query.userid : "uid-1";
-                const name = req.query.name ? req.query.name : "Jonn Smith";
+                const name = req.query.name ? req.query.name : "John Smith";
 
                 docManager.saveFileData(file.name, userid, name);
             }
@@ -521,7 +521,8 @@ app.get("/editor", function (req, res) {
         var historyData = [];
         var lang = docManager.getLang();
         var userid = req.query.userid ? req.query.userid : "uid-1";
-        var name = req.query.name ? req.query.name : "Jonn Smith";
+        var name = req.query.name ? req.query.name : "John Smith";
+        var actionData = req.query.action ? req.query.action : "null";
 
         if (fileExt != null) {
             var fileName = docManager.createDemo((req.query.sample ? "sample." : "new.") + fileExt, userid, name);
@@ -631,7 +632,8 @@ app.get("/editor", function (req, res) {
                 userid: userid,
                 name: name,
                 fileChoiceUrl: fileChoiceUrl,
-                plugins: JSON.stringify(plugins)
+                plugins: JSON.stringify(plugins),
+                actionData: actionData
             },
             history: history,
             historyData: historyData

web/documentserver-example/nodejs/helpers/cacheManager.js

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

web/documentserver-example/nodejs/helpers/docManager.js

@@ -1,7 +1,7 @@
 "use strict";
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

web/documentserver-example/nodejs/helpers/documentService.js

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

web/documentserver-example/nodejs/helpers/fileUtility.js

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

web/documentserver-example/nodejs/helpers/guidManager.js

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

web/documentserver-example/nodejs/public/javascripts/jscript.js

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

web/documentserver-example/nodejs/public/stylesheets/editor.css

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

web/documentserver-example/nodejs/public/stylesheets/stylesheet.css

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

web/documentserver-example/nodejs/run-develop.py

@@ -0,0 +1,19 @@
+#!/usr/bin/env python
+import sys
+sys.path.append('../../../../build_tools/scripts')
+import os
+import base
+
+def install_module():
+  base.print_info('Install')
+  base.cmd('npm', ['install'])
+
+def run_integration_example():
+  install_module()
+  base.set_env('NODE_CONFIG_DIR', './config')
+  base.print_info('run integration example')
+  base.run_nodejs(['bin/www'])
+
+base.set_env('NODE_ENV', 'development-' + base.host_platform())
+
+run_integration_example()

web/documentserver-example/nodejs/run-mac.command

@@ -1,18 +0,0 @@
-#!/bin/bash
-
-BASEDIR="$(cd "$(dirname "$0")" && pwd)"
-
-cd $BASEDIR
-
-echo "----------------------------------------"
-echo "Install nodejs modules "
-echo "----------------------------------------"
-
-npm install
-
-
-echo "----------------------------------------"
-echo "Run server  "
-echo "----------------------------------------"
-
-export NODE_CONFIG_DIR=$BASEDIR/config && export NODE_ENV=development-mac && node bin/www

web/documentserver-example/nodejs/run.bat

@@ -1,15 +0,0 @@
-ECHO OFF
-
-ECHO.
-ECHO ----------------------------------------
-ECHO Install node.js modules 
-ECHO ----------------------------------------
-call npm install
-
-ECHO.
-ECHO ----------------------------------------
-ECHO Run server 
-ECHO ----------------------------------------
-SET NODE_CONFIG_DIR=%~dp0\config
-SET NODE_ENV=development-windows
-start /min /b node bin/www

web/documentserver-example/nodejs/views/config.ejs

@@ -23,6 +23,7 @@
     }
 },
 "editorConfig": {
+    "actionLink": <%- editor.actionData %>,
     "mode": "<%- editor.mode %>",
     "lang": "<%- editor.lang %>",
     "callbackUrl": "<%- editor.callbackUrl %>",

web/documentserver-example/nodejs/views/editor.ejs

@@ -1,6 +1,6 @@
 <!--*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *
@@ -96,6 +96,28 @@
             location.reload(true);
         };
 
+        var replaceActionLink = function(href, linkParam) {
+            var link;
+            var actionIndex = href.indexOf("&action=");
+            if (actionIndex != -1) {
+                var endIndex = href.indexOf("&", actionIndex + "&action=".length);
+                if (endIndex != -1) {
+                    link = href.substring(0, actionIndex) + href.substring(endIndex) + "&action=" + encodeURIComponent(linkParam);
+                } else {
+                    link = href.substring(0, actionIndex) + "&action=" + encodeURIComponent(linkParam);
+                }
+            } else {
+                link = href + "&action=" + encodeURIComponent(linkParam);
+            }
+            return link;
+        }
+
+        var onMakeActionLink = function (event) {
+            var actionData = event.data;
+            var linkParam = JSON.stringify(actionData);
+            docEditor.setActionLink(replaceActionLink(location.href, linkParam));
+        };
+
         var connectEditor = function () {
 
             docEditor = new DocsAPI.DocEditor("iframeEditor", {<% include config %>,
@@ -108,6 +130,7 @@
                         "onRequestHistoryData": onRequestHistoryData,
                         "onRequestHistoryClose": onRequestHistoryClose,
                         "onOutdatedVersion": onOutdatedVersion,
+                        "onMakeActionLink": onMakeActionLink,
                     }
             });
 

web/documentserver-example/nodejs/views/index.ejs

@@ -1,6 +1,6 @@
 <!--*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *
@@ -53,7 +53,7 @@
                 <td valign="middle" width="30%">
                     <span class="select-user">Username:</span>
                     <select class="select-user" id="user">
-                        <option value="uid-1">Jonn Smith</option>
+                        <option value="uid-1">John Smith</option>
                         <option value="uid-2">Mark Pottato</option>
                         <option value="uid-3">Hamish Mitchell</option>
                     </select>
@@ -86,7 +86,7 @@
                         <option value="vi">Vietnamese</option>
                     </select>
                 </td>
-                <td valign="middle" width="70%">Choose the language for ONLYOFFICE&trade; editors interface.</td>
+                <td valign="middle" width="70%">Choose the language for ONLYOFFICE editors interface.</td>
             </tr>
         </table>
         <br />
@@ -263,7 +263,7 @@
 
     <span id="loadScripts" data-docs="<%= preloaderUrl %>"></span>
 
-    <footer>&copy; Ascensio Systems SIA 2019. All rights reserved.</footer>
+    <footer>&copy; Ascensio Systems SIA 2020. All rights reserved.</footer>
 
     <script type="text/javascript" src="javascripts/jquery-1.8.2.js"></script>
     <script type="text/javascript" src="javascripts/jquery-ui.js"></script>

web/documentserver-example/php/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2019 ONLYOFFICE
+Copyright (c) 2020 ONLYOFFICE
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

web/documentserver-example/php/ajax.php

@@ -1,7 +1,7 @@
 <?php
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

web/documentserver-example/php/common.php

@@ -1,7 +1,7 @@
 <?php
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *
@@ -291,7 +291,7 @@ function createMeta($fileName, $uid = "0") {
     $name = "";
     switch ($uid) {
         case 0:
-            $name = "Jonn Smith";
+            $name = "John Smith";
             break;
         case 1:
             $name = "Mark Pottato";

web/documentserver-example/php/css/stylesheet.css

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

web/documentserver-example/php/doceditor.php

@@ -1,7 +1,7 @@
 <?php
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *
@@ -63,7 +63,7 @@
     $uname = "";
     switch ($uid) {
         case 0:
-            $uname = "Jonn Smith";
+            $uname = "John Smith";
             break;
         case 1:
             $uname = "Mark Pottato";
@@ -100,6 +100,7 @@
             ]
         ],
         "editorConfig" => [
+            "actionLink" => empty($_GET["actionLink"]) ? null : json_decode($_GET["actionLink"]),
             "mode" => $mode,
             "lang" => empty($_COOKIE["ulang"]) ? "en" : $_COOKIE["ulang"],
             "callbackUrl" => getCallbackUrl($filename),
@@ -295,6 +296,28 @@
             location.reload(true);
         };
 
+        var replaceActionLink = function(href, linkParam) {
+            var link;
+            var actionIndex = href.indexOf("&actionLink=");
+            if (actionIndex != -1) {
+                var endIndex = href.indexOf("&", actionIndex + "&actionLink=".length);
+                if (endIndex != -1) {
+                    link = href.substring(0, actionIndex) + href.substring(endIndex) + "&actionLink=" + encodeURIComponent(linkParam);
+                } else {
+                    link = href.substring(0, actionIndex) + "&actionLink=" + encodeURIComponent(linkParam);
+                }
+            } else {
+                link = href + "&actionLink=" + encodeURIComponent(linkParam);
+            }
+            return link;
+        }
+
+        var onMakeActionLink = function (event) {
+            var actionData = event.data;
+            var linkParam = JSON.stringify(actionData);
+            docEditor.setActionLink(replaceActionLink(location.href, linkParam));
+        };
+
         var сonnectEditor = function () {
 
             <?php
@@ -314,6 +337,7 @@
                 'onRequestEditRights': onRequestEditRights,
                 'onError': onError,
                 'onOutdatedVersion': onOutdatedVersion,
+                'onMakeActionLink': onMakeActionLink,
             };
 
             <?php

web/documentserver-example/php/functions.php

@@ -1,7 +1,7 @@
 <?php
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

web/documentserver-example/php/index.php

@@ -1,7 +1,7 @@
 <?php
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *
@@ -84,7 +84,7 @@
                     <td valign="middle" width="30%">
                         <span class="select-user">Username:</span>
                         <select class="select-user" id="user">
-                            <option value="0">Jonn Smith</option>
+                            <option value="0">John Smith</option>
                             <option value="1">Mark Pottato</option>
                             <option value="2">Hamish Mitchell</option>
                         </select>

web/documentserver-example/php/js/jscript.js

@@ -1,6 +1,6 @@
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

web/documentserver-example/php/jwtmanager.php

@@ -1,7 +1,7 @@
 <?php
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

web/documentserver-example/php/webeditor-ajax.php

@@ -1,7 +1,7 @@
 <?php
 /*
  *
- * (c) Copyright Ascensio System SIA 2019
+ * (c) Copyright Ascensio System SIA 2020
  *
  * The MIT License (MIT)
  *

web/documentserver-example/python/config.py

@@ -0,0 +1,55 @@
+import os
+
+FILE_SIZE_MAX = 5242880
+STORAGE_PATH = 'app_data'
+
+DOC_SERV_VIEWED = [".pdf", ".djvu", ".xps"]
+DOC_SERV_EDITED = [".docx", ".xlsx", ".csv", ".pptx", ".txt"]
+DOC_SERV_CONVERT = [
+    ".docm", ".doc", ".dotx", ".dotm", ".dot", ".odt",
+    ".fodt", ".ott", ".xlsm", ".xls", ".xltx", ".xltm",
+    ".xlt", ".ods", ".fods", ".ots", ".pptm", ".ppt",
+    ".ppsx", ".ppsm", ".pps", ".potx", ".potm", ".pot",
+    ".odp", ".fodp", ".otp", ".rtf", ".mht", ".html", ".htm", ".epub"
+]
+
+DOC_SERV_TIMEOUT = 120000
+
+DOC_SERV_CONVERTER_URL = 'https://documentserver/ConvertService.ashx'
+DOC_SERV_API_URL = 'https://documentserver/web-apps/apps/api/documents/api.js'
+DOC_SERV_PRELOADER_URL = 'https://documentserver/web-apps/apps/api/documents/cache-scripts.html'
+
+EXAMPLE_DOMAIN = 'https://exampleserver/'
+
+DOC_SERV_JWT_SECRET = ''
+
+
+EXT_SPREADSHEET = [
+    ".xls", ".xlsx", ".xlsm",
+    ".xlt", ".xltx", ".xltm",
+    ".ods", ".fods", ".ots", ".csv"
+]
+
+EXT_PRESENTATION = [
+    ".pps", ".ppsx", ".ppsm",
+    ".ppt", ".pptx", ".pptm",
+    ".pot", ".potx", ".potm",
+    ".odp", ".fodp", ".otp"
+]
+
+EXT_DOCUMENT = [
+    ".doc", ".docx", ".docm",
+    ".dot", ".dotx", ".dotm",
+    ".odt", ".fodt", ".ott", ".rtf", ".txt",
+    ".html", ".htm", ".mht",
+    ".pdf", ".djvu", ".fb2", ".epub", ".xps"
+]
+
+
+if os.environ.get("EXAMPLE_DOMAIN"):
+    EXAMPLE_DOMAIN = os.environ.get("EXAMPLE_DOMAIN")
+if os.environ.get("DOC_SERV"):
+    base = os.environ.get("DOC_SERV").rstrip('/')
+    DOC_SERV_CONVERTER_URL = base + '/ConvertService.ashx'
+    DOC_SERV_API_URL = base + '/web-apps/apps/api/documents/api.js'
+    DOC_SERV_PRELOADER_URL = base + '/web-apps/apps/api/documents/cache-scripts.html'

web/documentserver-example/python/manage.py

@@ -0,0 +1,21 @@
+#!/usr/bin/env python
+"""Django's command-line utility for administrative tasks."""
+import os
+import sys
+
+
+def main():
+    os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'src.settings')
+    try:
+        from django.core.management import execute_from_command_line
+    except ImportError as exc:
+        raise ImportError(
+            "Couldn't import Django. Are you sure it's installed and "
+            "available on your PYTHONPATH environment variable? Did you "
+            "forget to activate a virtual environment?"
+        ) from exc
+    execute_from_command_line(sys.argv)
+
+
+if __name__ == '__main__':
+    main()

web/documentserver-example/python/readme.md

@@ -0,0 +1,18 @@
+## Requirements
+
+Example is written for Python 3.6+
+
+You should also install following dependencies:
+```
+pip install Django==2.2.6
+pip install requests==2.22.0
+pip install pyjwt==1.7.1
+```
+
+## Configuration
+
+Configuration located inside `config.py`
+
+## Launch
+
+`python manage.py runserver 0.0.0.0:8000`

web/documentserver-example/python/src/settings.py

@@ -0,0 +1,99 @@
+"""
+Django settings for example project.
+
+Generated by 'django-admin startproject' using Django 2.2.6.
+
+For more information on this file, see
+https://docs.djangoproject.com/en/2.2/topics/settings/
+
+For the full list of settings and their values, see
+https://docs.djangoproject.com/en/2.2/ref/settings/
+"""
+
+import os
+import config
+
+# Build paths inside the project like this: os.path.join(BASE_DIR, ...)
+BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+
+
+# Quick-start development settings - unsuitable for production
+# See https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/
+
+# SECURITY WARNING: keep the secret key used in production secret!
+SECRET_KEY = '7a5qnm_bv)iskjhx%4cbwwdmjev03%zewm=3@4s*uz)el#ds5o'
+
+# SECURITY WARNING: don't run with debug turned on in production!
+DEBUG = True
+
+ALLOWED_HOSTS = [
+    '*'
+]
+
+
+# Application definition
+
+INSTALLED_APPS = [
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+]
+
+MIDDLEWARE = [
+    'src.utils.historyManager.CorsHeaderMiddleware',
+    'django.middleware.security.SecurityMiddleware',
+    'django.contrib.sessions.middleware.SessionMiddleware',
+    'django.middleware.common.CommonMiddleware',
+    'django.middleware.clickjacking.XFrameOptionsMiddleware',
+]
+
+ROOT_URLCONF = 'src.urls'
+
+TEMPLATES = [
+    {
+        'BACKEND': 'django.template.backends.django.DjangoTemplates',
+        'DIRS': [ 'templates' ],
+        'APP_DIRS': True,
+        'OPTIONS': {
+            'context_processors': [
+                'django.template.context_processors.debug',
+                'django.template.context_processors.request',
+            ],
+        },
+    },
+]
+
+WSGI_APPLICATION = 'src.wsgi.application'
+
+
+# Database
+# https://docs.djangoproject.com/en/2.2/ref/settings/#databases
+
+DATABASES = {}
+
+
+# Password validation
+# https://docs.djangoproject.com/en/2.2/ref/settings/#auth-password-validators
+
+AUTH_PASSWORD_VALIDATORS = []
+
+
+# Internationalization
+# https://docs.djangoproject.com/en/2.2/topics/i18n/
+
+LANGUAGE_CODE = 'en-us'
+
+TIME_ZONE = 'UTC'
+
+USE_I18N = True
+
+USE_L10N = True
+
+USE_TZ = True
+
+
+# Static files (CSS, JavaScript, Images)
+# https://docs.djangoproject.com/en/2.2/howto/static-files/
+
+STATIC_ROOT = ''
+STATIC_URL = '/static/'
+STATICFILES_DIRS = ( os.path.join('static'), os.path.join(config.STORAGE_PATH) )

web/documentserver-example/python/src/urls.py

@@ -0,0 +1,42 @@
+"""
+
+ (c) Copyright Ascensio System SIA 2020
+ *
+ The MIT License (MIT)
+
+ 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.
+
+"""
+
+from django.urls import path
+
+from src.views import index, actions
+from django.contrib.staticfiles.urls import staticfiles_urlpatterns
+
+urlpatterns = [
+    path('', index.default),
+    path('upload', actions.upload),
+    path('convert', actions.convert),
+    path('create', actions.createNew),
+    path('edit', actions.edit),
+    path('track', actions.track),
+    path('remove', actions.remove)
+]
+
+urlpatterns += staticfiles_urlpatterns()

web/documentserver-example/python/src/utils/docManager.py

@@ -0,0 +1,185 @@
+"""
+
+ (c) Copyright Ascensio System SIA 2020
+ *
+ The MIT License (MIT)
+
+ 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.
+
+"""
+
+
+import config
+import os
+import shutil
+import io
+import re
+import requests
+
+from src import settings
+from . import fileUtils, historyManager
+
+LANGUAGES = {
+    'en': 'English',
+    'bg': 'Bulgarian',
+    'zh': 'Chinese',
+    'cs': 'Czech',
+    'nl': 'Dutch',
+    'fr': 'French',
+    'de': 'German',
+    'hu': 'Hungarian',
+    'it': 'Italian',
+    'ja': 'Japanese',
+    'ko': 'Korean',
+    'lv': 'Latvian',
+    'pl': 'Polish',
+    'pt': 'Portuguese',
+    'ru': 'Russian',
+    'sk': 'Slovak',
+    'sl': 'Slovenian',
+    'es': 'Spanish',
+    'tr': 'Turkish',
+    'uk': 'Ukrainian',
+    'vi': 'Vietnamese'
+}
+
+def isCanView(ext):
+    return ext in config.DOC_SERV_VIEWED
+
+def isCanEdit(ext):
+    return ext in config.DOC_SERV_EDITED
+
+def isCanConvert(ext):
+    return ext in config.DOC_SERV_CONVERT
+
+def isSupportedExt(ext):
+    return isCanView(ext) | isCanEdit(ext) | isCanConvert(ext)
+
+def getInternalExtension(fileType):
+    mapping = {
+        'text': '.docx',
+        'spreadsheet': '.xlsx',
+        'presentation': '.pptx'
+    }
+
+    return mapping.get(fileType, '.docx')
+
+def getCorrectName(filename, req):
+    basename = fileUtils.getFileNameWithoutExt(filename)
+    ext = fileUtils.getFileExt(filename)
+    name = f'{basename}{ext}'
+
+    i = 1
+    while os.path.exists(getStoragePath(name, req)):
+        name = f'{basename} ({i}){ext}'
+        i += 1
+
+    return name
+
+def getFileUri(filename, req):
+    host = config.EXAMPLE_DOMAIN.rstrip('/')
+    curAdr = req.META['REMOTE_ADDR']
+    return f'{host}{settings.STATIC_URL}{curAdr}/{filename}'
+
+def getCallbackUrl(filename, req):
+    host = config.EXAMPLE_DOMAIN
+    curAdr = req.META['REMOTE_ADDR']
+    return f'{host}track?filename={filename}&userAddress={curAdr}'
+
+def getRootFolder(req):
+    if isinstance(req, str):
+        curAdr = req
+    else:
+        curAdr = req.META['REMOTE_ADDR']
+
+    directory = os.path.join(config.STORAGE_PATH, curAdr)
+
+    if not os.path.exists(directory):
+        os.makedirs(directory)
+
+    return directory
+
+def getStoragePath(filename, req):
+    directory = getRootFolder(req)
+
+    return os.path.join(directory, filename)
+
+def getStoredFiles(req):
+    directory = getRootFolder(req)
+
+    files = os.listdir(directory)
+    files.sort(key=lambda x: os.path.getmtime(os.path.join(directory, x)), reverse=True)
+
+    fileInfos = []
+
+    for f in files:
+        if os.path.isfile(os.path.join(directory, f)):
+            fileInfos.append({ 'type': fileUtils.getFileType(f), 'title': f, 'url': getFileUri(f, req) })
+
+    return fileInfos
+
+def createFile(stream, path, req = None, meta = False):
+    bufSize = 8196
+    with io.open(path, 'wb') as out:
+        read = stream.read(bufSize)
+
+        while len(read) > 0:
+            out.write(read)
+            read = stream.read(bufSize)
+
+    if meta:
+        historyManager.createMeta(path, req)
+    return
+
+def saveFileFromUri(uri, path, req = None, meta = False):
+    resp = requests.get(uri, stream=True)
+    createFile(resp.raw, path, req, meta)
+    return
+
+def createSample(fileType, sample, req):
+    ext = getInternalExtension(fileType)
+
+    if not sample:
+        sample = 'false'
+
+    sampleName = 'sample' if sample == 'true' else 'new'
+
+    filename = getCorrectName(f'{sampleName}{ext}', req)
+    path = getStoragePath(filename, req)
+
+    with io.open(os.path.join('samples', f'{sampleName}{ext}'), 'rb') as stream:
+        createFile(stream, path, req, True)
+    return filename
+
+def removeFile(filename, req):
+    path = getStoragePath(filename, req)
+    if os.path.exists(path):
+        os.remove(path)
+    histDir = historyManager.getHistoryDir(path)
+    if os.path.exists(histDir):
+        shutil.rmtree(histDir)
+
+def generateFileKey(filename, req):
+    path = getStoragePath(filename, req)
+    uri = getFileUri(filename, req)
+    stat = os.stat(path)
+
+    h = str(hash(f'{uri}_{stat.st_mtime_ns}'))
+    replaced = re.sub(r'[^0-9-.a-zA-Z_=]', '_', h)
+    return replaced[:20]

web/documentserver-example/python/src/utils/fileUtils.py

@@ -0,0 +1,52 @@
+"""
+
+ (c) Copyright Ascensio System SIA 2020
+ *
+ The MIT License (MIT)
+
+ 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.
+
+"""
+
+import config
+
+def getFileName(str):
+    ind = str.rfind('/')
+    return str[ind+1:]
+
+def getFileNameWithoutExt(str):
+    fn = getFileName(str)
+    ind = fn.rfind('.')
+    return fn[:ind]
+
+def getFileExt(str):
+    fn = getFileName(str)
+    ind = fn.rfind('.')
+    return fn[ind:].lower()
+
+def getFileType(str):
+    ext = getFileExt(str)
+    if ext in config.EXT_DOCUMENT:
+        return 'text'
+    if ext in config.EXT_SPREADSHEET:
+        return 'spreadsheet'
+    if ext in config.EXT_PRESENTATION:
+        return 'presentation'
+
+    return 'text'