# @burna/osjs-office-collabora

> Osjs office application working with collabora service

Latest version **1.1.11** (published 2021-11-10) · BSD-2-Clause license · 0 weekly downloads

## Install

```sh
npm install @burna/osjs-office-collabora
pnpm add @burna/osjs-office-collabora
yarn add @burna/osjs-office-collabora
bun add @burna/osjs-office-collabora
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.1.11 |
| Published | 2021-11-10 |
| First published | 2021-07-10 |
| Weekly downloads | 0 |
| License | BSD-2-Clause |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 13 |
| Unpacked size | 3.9 MB |
| Known vulnerabilities | 0 (+40 in 3 direct dependencies) |
| Install scripts | no |
| GitHub stars | 6 |
| Author | Mahsa Shadi |
| Maintainers | msjavan, seyedmiladhashemi, morteza.biabani, mahsashadi |
| Keywords | os.js, office, document, presentation, spreadsheet, collabora, collabora_online_development_edition(CODE) |

## Links

- npm: https://www.npmjs.com/package/@burna/osjs-office-collabora
- Repository: https://github.com/BurnaSmartLab/osjs-office-collabora
- Homepage: https://github.com/BurnaSmartLab/osjs-office-collabora/blob/master/README.md
- Issues: https://github.com/BurnaSmartLab/osjs-office-collabora/issues
- npm.io page: https://npm.io/package/@burna/osjs-office-collabora

## Dependencies (13)

- [http](https://npm.io/package/http.md) 0.0.1-security
- [axios](https://npm.io/package/axios.md) ^0.21.1
- [https](https://npm.io/package/https.md) ^1.0.0
- [react](https://npm.io/package/react.md) ^16.8.6
- [xpath](https://npm.io/package/xpath.md) 0.0.32
- [stream](https://npm.io/package/stream.md) 0.0.2
- [xmldom](https://npm.io/package/xmldom.md) ^0.6.0
- [react-dom](https://npm.io/package/react-dom.md) ^16.8.6
- [url-loader](https://npm.io/package/url-loader.md) ^4.1.1
- [body-parser](https://npm.io/package/body-parser.md) ^1.19.0
- [@fortawesome/react-fontawesome](https://npm.io/package/@fortawesome/react-fontawesome.md) ^0.1.14
- [@fortawesome/fontawesome-svg-core](https://npm.io/package/@fortawesome/fontawesome-svg-core.md) ^1.2.35
- [@fortawesome/free-solid-svg-icons](https://npm.io/package/@fortawesome/free-solid-svg-icons.md) ^5.15.3

## Alternatives

- [csv-to-markdown-table](https://npm.io/package/csv-to-markdown-table.md) — 47.0K weekly downloads
- [@sapphire/ratelimits](https://npm.io/package/@sapphire/ratelimits.md) — 4.4K weekly downloads
- [js-csvparser](https://npm.io/package/js-csvparser.md) — 2.0K weekly downloads
- [@adadapted/js-sdk](https://npm.io/package/@adadapted/js-sdk.md) — 251 weekly downloads
- [@grapecity/spread-sheets-sparklines](https://npm.io/package/@grapecity/spread-sheets-sparklines.md) — 103 weekly downloads

## Recent versions

- 1.1.11 (latest) — 2021-11-10
- 1.1.10 — 2021-11-09
- 1.1.8 — 2021-09-15
- 1.1.7 — 2021-08-15
- 1.1.6 — 2021-08-03
- 1.1.5 — 2021-07-17
- 1.1.4 — 2021-07-11
- 1.1.3 — 2021-07-11
- 1.1.2 — 2021-07-10
- 1.1.1 — 2021-07-10

## README

# OSjs Office Application

![hafez_office](https://user-images.githubusercontent.com/70196035/124575730-e418f680-de60-11eb-9cef-77ee5e274a03.png)

## Introduction

This is an application for OSjs which can open and make document, presentation and spreadsheet files, supporting a wide range of extensions, using [Collabora Online Development Edition (CODE)](https://www.collaboraoffice.com/code/) service. <br/>

## Package Installation by Cloning

1- Navigate to the following directory of OS.js project

```bash
cd src/packages
```

2- Clone hosting application in this directory

```bash
git clone https://github.com/BurnaSmartLab/osjs-office-collabora.git
```

3- Then navigate to cloned directory

```bash
cd osjs-office-collabora
```

4- Run following command in the current directory to install dependencies

```bash
npm install
```

5-Build office package in current directory

```bash
npm run build
```

6- Run following command in root directory of OSjs project

```bash
npm run package:discover
```

7- Run serve command in root directory of OSjs project

```bash
npm run serve

```

## Package Installation by by NPM Dependency Manager:

1- Execute the following command in OS.js root directory

```bash
npm install @burna/osjs-office-collabora
```

2- Run following command in root directory of OSjs project

```bash
npm run package:discover
```

## Usage:

Add following `office` and `express` config to `src/server/config.js` file of OSjs:

```js
// Replace 'http://localhost:12345' with your valid Collabora server address
    express:{
      maxBodySize:'1000000kb'
    },
    office: {
      collabora_online: 'http://localhost:12345'
    },
```

The office application is available in Office Menu of the OS.js :tada:

## Quick installation of CODE docker

1- Grab the Docker image

```bash
docker pull collabora/code
```

2- Start a new container, for example:

```bash
docker run -t -d -p 9980:9980 -e "extra_params=--o:ssl.enable=false" --privileged  --volume "/usr/share/fonts/truetype/:/opt/collaboraoffice6.4/share/fonts/truetype/local/:ro" -e "username=admin" -e "password=admin" --name collabora --cap-add MKNOD collabora/code
```

Here is the [step-by-step instructions](https://sdk.collaboraonline.com/docs/installation/CODE_Docker_image.html)

---
_Source: https://npm.io/package/@burna/osjs-office-collabora · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._