{"id":22048258,"url":"https://github.com/onlyoffice/onlyoffice-drupal","last_synced_at":"2025-05-08T22:31:35.531Z","repository":{"id":36959854,"uuid":"463168253","full_name":"ONLYOFFICE/onlyoffice-drupal","owner":"ONLYOFFICE","description":"The app which enables the users to edit office documents from Drupal using ONLYOFFICE Document Server, allows multiple users to collaborate in real time and to save back those changes to Drupal","archived":false,"fork":false,"pushed_at":"2025-04-14T22:23:28.000Z","size":596,"stargazers_count":4,"open_issues_count":1,"forks_count":5,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-04-14T23:28:21.789Z","etag":null,"topics":["drupal","integration","onlyoffice"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ONLYOFFICE.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-02-24T13:57:13.000Z","updated_at":"2025-04-04T03:34:05.000Z","dependencies_parsed_at":"2024-12-25T11:23:28.427Z","dependency_job_id":"f223a7e8-975b-4df9-b1a0-bb05cfc9af95","html_url":"https://github.com/ONLYOFFICE/onlyoffice-drupal","commit_stats":{"total_commits":136,"total_committers":6,"mean_commits":"22.666666666666668","dds":"0.24264705882352944","last_synced_commit":"0da2a8f542db10d689be4bb0d8f9085ac73a0148"},"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ONLYOFFICE%2Fonlyoffice-drupal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ONLYOFFICE%2Fonlyoffice-drupal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ONLYOFFICE%2Fonlyoffice-drupal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ONLYOFFICE%2Fonlyoffice-drupal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ONLYOFFICE","download_url":"https://codeload.github.com/ONLYOFFICE/onlyoffice-drupal/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253157841,"owners_count":21863181,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["drupal","integration","onlyoffice"],"created_at":"2024-11-30T14:09:34.554Z","updated_at":"2025-05-08T22:31:35.507Z","avatar_url":"https://github.com/ONLYOFFICE.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ONLYOFFICE Connector module for Drupal\n\nContents of this file\n---------------------\n\n * Introduction\n * Requirements\n * Installation\n * Configuration\n * Usage\n * Installing ONLYOFFICE Docs\n * Known issues\n \n## Introduction\n\nThe ONLYOFFICE module enables users to edit files in the Media module from [Drupal](https://www.drupal.org) using ONLYOFFICE Docs packaged as Document Server - [Community or Enterprise Edition](#installing-onlyoffice-docs).\n\nThe module allows to:\n\n* Edit text documents, spreadsheets, and presentations.\n* Preview files on public pages.\n* Collaborate on documents using two co-editing modes (real-time and \nparagraph-locking).\n\nSupported formats:\n\n* For editing: DOCX, XLSX, PPTX.\n* For viewing only: DJVU, DOC, DOCM, DOT, DOTM, DOTX, EPUB, FB2, FODT, HTML, \nMHT, ODT, OTT, OXPS, PDF, RTF, TXT, XPS, XML, CSV, FODS, ODS, OTS, XLS, \nXLSM, XLT, XLTM, XLTX, FODP, ODP, OTP, POT, POTM, POTX, PPS, PPSM, PPSX,\nPPT, PPTM.\n\n * For a full description of the module, visit the project page:\n   https://www.drupal.org/project/onlyoffice\n\n * To submit bug reports and feature suggestions, or track changes:\n   https://www.drupal.org/project/issues/onlyoffice .\n   Alternatively, you can contact ONLYOFFICE team on [forum.onlyoffice.com](https://forum.onlyoffice.com/).\n\n## Requirements\n\nThis module requires no modules outside of Drupal core.\n\n## Installation\n\n**Step 1: Add the module**\n\nFirst way: Add a module using [Drupal's User Interface (easy)](https://www.drupal.org/docs/extending-drupal/installing-modules#s-add-a-module-using-drupals-user-interface-easy).\n\n1. On the Admin toolbar project page on drupal.org \n(https://www.drupal.org/project), scroll to the Downloads section \nat the bottom of the page.\n2. Copy the address of the tar.gz link. Depending on your device and \nbrowser, you might do this by right clicking and selecting Copy link address.\n3. In the Manage administrative menu, navigate to Extend (admin/modules).\nThe Extend page appears.\n4. Click Install new module. The Install new module page appears.\n5. In the field Install from a URL, paste the copied download link.\n6. Click Install to upload and unpack the new module on the server. \nThe files are being downloaded to the modules directory.\n\nSecond way: Add a module with [Composer](https://www.drupal.org/docs/extending-drupal/installing-modules#s-add-a-module-with-composer).\n\nEnter the following command at the root of your site:\n\n```\ncomposer require onlyoffice/onlyoffice-drupal\n```\n\n**Step 2: Enable the module**\n\nFirst way: Using the Drupal User Interface (easy).\n1. Navigate to the Extend page (admin/modules) via the Manage \nadministrative menu.\n2. Locate the ONLYOFFICE Connector module and check the box.\n3. Click Install to enable.\n\nSecond way: Using the command line (advanced, but very efficient).\n1. Run the following Drush command, giving the project name as a parameter:\n\n```\ndrush pm:enable onlyoffice\n```\n2. Follow the instructions on the screen.\n\n## Configuration\n\nIn Drupal, open the `~/config/system/onlyoffice-settings` page with \nadministrative settings for **ONLYOFFICE** section.\nEnter the address to connect ONLYOFFICE Document Server:\n\n```\nhttps://\u003cdocumentserver\u003e/\n```\n\nWhere **documentserver** is the name of the server with the ONLYOFFICE \nDocument Server installed.\nThe address must be accessible for the user browser and from the Drupal server.\nThe Drupal server address must also be accessible from ONLYOFFICE \nDocument Server for correct work.\n\nStarting from version 7.2, JWT is enabled by default and the secret key is\ngenerated automatically to restrict the access to ONLYOFFICE Docs and for \nsecurity reasons and data integrity.\nSpecify your own **Secret key** in the Drupal administrative configuration. \nIn the ONLYOFFICE Docs [config file](https://api.onlyoffice.com/editors/signature/), specify the same secret key and enable the validation.\n\n## Usage\n\n**Edit files already uploaded to Drupal**\n\nAll office files added to Media can be opened for editing. In the last\ntable column, call the drop-down list and select the Edit in ONLYOFFICE action. \nThe editor opens in the same tab. Users with Administrator rights are able \nto co-edit files using ONLYOFFICE Docs. All changes are saved in the same file.\n\n**Create new posts**\n\nWhen creating a post, you can add the new ONLYOFFICE element.\n\n1. Go to Structure -\u003e Content types -\u003e Manage fields. On the opened page, click\n*Add field*. Add a new field: File or Media. Set the label and save.\n\n2. For the added File field, specify the file extensions. Go to Structure -\u003e\nContent types -\u003e Manage fields. In the *Allowed file extensions* field, specify\nthe file formats that will be shown in the editors (docx,xlsx,pptx).\n\n   For the added Media field, click the Document checkbox.\n\n3. Go to Structure -\u003e Media types -\u003e Document -\u003e Manage display.\n\n   For the Document field, specify the *ONLYOFFICE Preview* format. By clicking \non the gear symbol, you can specify the dimensions of the embedded editor \nwindow.\n\nWhen you are done with the pre-settings, you can create posts on the Content \ntab. Click on the *Add Content* button and select the created content. \n\nSpecify title and select a file (if the content contains File fields).\n\nFor Media section, specify the name of the previously uploaded file.\n\nYour site visitors will also be able to view the created page\n(People -\u003e Permissions -\u003e View published content).\n\n## Installing ONLYOFFICE Docs\n\nYou will need an instance of ONLYOFFICE Docs (Document Server) that \nis resolvable and connectable both from Drupal and any end clients. \nONLYOFFICE Document Server must also be able to POST to Drupal directly.\n\nYou can install free Community version of ONLYOFFICE Docs or scalable\nEnterprise Edition.\n\nTo install free Community version, use [Docker](https://github.com/onlyoffice/Docker-DocumentServer) (recommended) or follow [these instructions](https://helpcenter.onlyoffice.com/installation/docs-community-install-ubuntu.aspx) for Debian, Ubuntu, or derivatives.\n\nTo install Enterprise Edition, follow the instructions [here](https://helpcenter.onlyoffice.com/installation/docs-enterprise-index.aspx).\n\n**ONLYOFFICE Docs** packaged as Document Server: \n\n* Community Edition (`onlyoffice-documentserver` package)\n* Enterprise Edition (`onlyoffice-documentserver-ee` package)\n\nThe table below will help you make the right choice.\n\n| Pricing and licensing | Community Edition | Enterprise Edition |\n| ------------- | ------------- | ------------- |\n| | [Get it now](https://www.onlyoffice.com/download-docs.aspx?utm_source=github\u0026utm_medium=cpc\u0026utm_campaign=GitHubDrupal#docs-community)  | [Start Free Trial](https://www.onlyoffice.com/download-docs.aspx?utm_source=github\u0026utm_medium=cpc\u0026utm_campaign=GitHubDrupal#docs-enterprise)  |\n| Cost  | FREE  | [Go to the pricing page](https://www.onlyoffice.com/docs-enterprise-prices.aspx?utm_source=github\u0026utm_medium=cpc\u0026utm_campaign=GitHubDrupal)  |\n| Simultaneous connections | up to 20 maximum  | As in chosen pricing plan |\n| Number of users | up to 20 recommended | As in chosen pricing plan |\n| License | GNU AGPL v.3 | Proprietary |\n| **Support** | **Community Edition** | **Enterprise Edition** |\n| Documentation | [Help Center](https://helpcenter.onlyoffice.com/installation/docs-community-index.aspx) | [Help Center](https://helpcenter.onlyoffice.com/installation/docs-enterprise-index.aspx) |\n| Standard support | [GitHub](https://github.com/ONLYOFFICE/DocumentServer/issues) or paid | One year support included |\n| Premium support | [Contact us](mailto:sales@onlyoffice.com) | [Contact us](mailto:sales@onlyoffice.com) |\n| **Services** | **Community Edition** | **Enterprise Edition** |\n| Conversion Service                | + | + |\n| Document Builder Service          | + | + |\n| **Interface** | **Community Edition** | **Enterprise Edition** |\n| Tabbed interface                       | + | + |\n| Dark theme                             | + | + |\n| 125%, 150%, 175%, 200% scaling         | + | + |\n| White Label                            | - | - |\n| Integrated test example (node.js)      | + | + |\n| Mobile web editors                     | - | +* |\n| **Plugins \u0026 Macros** | **Community Edition** | **Enterprise Edition** |\n| Plugins                           | + | + |\n| Macros                            | + | + |\n| **Collaborative capabilities** | **Community Edition** | **Enterprise Edition** |\n| Two co-editing modes              | + | + |\n| Comments                          | + | + |\n| Built-in chat                     | + | + |\n| Review and tracking changes       | + | + |\n| Display modes of tracking changes | + | + |\n| Version history                   | + | + |\n| **Document Editor features** | **Community Edition** | **Enterprise Edition** |\n| Font and paragraph formatting   | + | + |\n| Object insertion                | + | + |\n| Adding Content control          | + | + | \n| Editing Content control         | + | + | \n| Layout tools                    | + | + |\n| Table of contents               | + | + |\n| Navigation panel                | + | + |\n| Mail Merge                      | + | + |\n| Comparing Documents             | + | + |\n| **Spreadsheet Editor features** | **Community Edition** | **Enterprise Edition** |\n| Font and paragraph formatting   | + | + |\n| Object insertion                | + | + |\n| Functions, formulas, equations  | + | + |\n| Table templates                 | + | + |\n| Pivot tables                    | + | + |\n| Data validation           | + | + |\n| Conditional formatting          | + | + |\n| Sparklines                   | + | + |\n| Sheet Views                     | + | + |\n| **Presentation Editor features** | **Community Edition** | **Enterprise Edition** |\n| Font and paragraph formatting   | + | + |\n| Object insertion                | + | + |\n| Transitions                     | + | + |\n| Presenter mode                  | + | + |\n| Notes                           | + | + |\n| **Form creator features** | **Community Edition** | **Enterprise Edition** |\n| Adding form fields           | + | + |\n| Form preview                    | + | + |\n| Saving as PDF                   | + | + |\n| | [Get it now](https://www.onlyoffice.com/download-docs.aspx?utm_source=github\u0026utm_medium=cpc\u0026utm_campaign=GitHubDrupal#docs-community)  | [Start Free Trial](https://www.onlyoffice.com/download-docs.aspx?utm_source=github\u0026utm_medium=cpc\u0026utm_campaign=GitHubDrupal#docs-enterprise)  |\n\n\\* If supported by DMS.\n\n## Known issues\n\n**Setting HTTPS via proxy** ([callback URL 308 error](https://www.drupal.org/project/onlyoffice/issues/3361341))\n\nDrupal is designed in such a way that if you configure HTTPS via proxy, Drupal will still replace links with *http*. Therefore, links to `callback` and `fileUrl` are sent to the config in the http format. As a result, ONLYOFFICE Document Server receives the *308 Permanent Redirect* response to the callback request. \n\nTo fix it, adjust the Drupal settings in your `settings.php` file:\n\n```\n$settings['reverse_proxy'] = TRUE;\n$settings['reverse_proxy_addresses'] = array($_SERVER['REMOTE_ADDR']);\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fonlyoffice%2Fonlyoffice-drupal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fonlyoffice%2Fonlyoffice-drupal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fonlyoffice%2Fonlyoffice-drupal/lists"}