Strapi

O integraciji ONLYOFFICE-a i Strapi-ja

Strapi je sistem za upravljanje sadržajem otvorenog koda koji se koristi za izradu API-ja. ONLYOFFICE nudi zvanični konektor za integraciju ONLYOFFICE Docs sa Strapi-jem i uređivanje kancelarijskih dokumenata u vašoj Strapi medijskoj biblioteci. ONLYOFFICE integracioni dodatak možete preuzeti iz npm biblioteke ili sa GitHub stranice. Konektor se distribuira pod licencom Apache-2.0.

note

Da biste saznali više o tome kako funkcioniše ONLYOFFICE konektor za Strapi, posetite našu stranicu API dokumentacije.

Glavne funkcije

• Uređivanje i pregled tekstualnih dokumenata, tabela i prezentacija.
• Zajedničko uređivanje dokumenata u realnom vremenu: dva režima zajedničkog uređivanja (Brzi i Strogi), režim Praćenje promena, komentari i ugrađeni čet.
• JWT podrška za zaštitu vašeg saobraćaja tako da niko ne može pristupiti vašim dokumentima, osim korisnika sa odgovarajućim pravima.

Podržani formati

• Za pregled i uređivanje: DOCX, XLSX, PPTX
• Samo za pregled: DOC, DOCX, DOCM, DOT, DOTX, DOTM, ODT, FODT, OTT, RTF, TXT, HTML, HTM, MHT, XML, PDF, DJVU, FB2, EPUB, XPS, XLS, XLSX, XLSM, XLT, XLTX, XLTM, ODS, FODS, OTS, CSV, PPS, PPSX, PPSM, PPT, PPTX, PPTM, POT, POTX, POTM, ODP, FODP, OTP

Šta je novo u verziji 2.0.1

Promenjeno

• Ažurirane zavisnosti pogona

Kompletan dnevnik promena dostupan je ovde.

Povezivanje ONLYOFFICE Docs sa Strapi-jem

Zahtevi

• ONLYOFFICE Document Server v7.1 (serverska ili cloud verzija) ili novija

  Potrebna vam je instanca ONLYOFFICE Docs koja je razrešiva i dostupna i sa Strapi-ja i sa svih krajnjih klijenata. Mora moći direktno da šalje POST zahteve Strapi-ju.

  note

  Pogledajte zvaničnu stranicu dokumentacije da biste saznali više o instalaciji ONLYOFFICE Docs.

• Strapi v4.2.0 ili noviji

• ONLYOFFICE konektor v1.1.0 za Strapi

Instaliranje ONLYOFFICE integracionog dodatka za Strapi

1. Da biste omogućili umetanje okvira sa uređivačem i učitavanje api.js, zamenite liniju strapi::security u datoteci strapi/config/middlewares.js sledećom konfiguracijom:

   {
     name: "strapi::security",
     config: {
       contentSecurityPolicy: {
         useDefaults: true,
         directives: {
           "script-src": ["'self'", "https:", "http:"],
           "frame-src": ["'self'", "https:", "http:"],
         },
       },
     }
   },

   Ako takva konfiguracija već postoji, samo treba da dodate directives.

2. Instalirajte dodatak u svoj Strapi projekat:

   npm install onlyoffice-strapi --save

3. Ponovo izgradite i ponovo pokrenite Strapi kako biste ONLYOFFICE dodatak uključili u administratorski interfejs. Pokrenite:

   # using yarn
   yarn build
   yarn develop
   
   # using npm
   npm run build
   npm run develop

   Sada je ONLYOFFICE integracioni dodatak za Strapi instaliran i spreman za konfiguraciju. Dodatku možete pristupiti putem levog panela u sekciji Plugins pod imenom ONLYOFFICE.

   

Konfigurisanje ONLYOFFICE integracionog dodatka za Strapi

Da biste konfigurisali ONLYOFFICE integracioni dodatak u Strapi-ju:

1. Otvorite sekciju Settings u levom panelu.

2. U sekciji Global settings kliknite na stavku menija ONLYOFFICE.

3. Na stranici sa podešavanjima ONLYOFFICE unesite Document server address, tj. URL instaliranog ONLYOFFICE Docs.

   note

   Adresa ONLYOFFICE Docs mora biti dostupna sa Strapi-ja, kao što i adresa Strapi-ja mora biti dostupna sa ONLYOFFICE Docs.

Kako funkcioniše

Interakcija između korisnika i dokumenta odvija se i na strani klijenta i na strani servera.

U nastavku su objašnjeni glavni pojmovi koji se koriste u ovoj dokumentaciji.

Strana klijenta obuhvata:

• Menadžer dokumenata - lista dokumenata prikazana u korisnikovom pregledaču u kojoj korisnik može da izabere potreban dokument i da izvrši neke radnje sa njim (u zavisnosti od dodeljenih prava, korisnik može da otvori dokument radi pregleda ili uređivanja i da ga deli sa drugim korisnicima).
• Uređivač dokumenata - interfejs za pregled i uređivanje dokumenata sa svim najpoznatijim funkcijama uređivanja, koji služi kao posrednik između korisnika i servisa za uređivanje dokumenata.

Strana servera obuhvata:

• Servis za skladištenje dokumenata - serverski servis koji skladišti sve dokumente dostupne korisnicima sa odgovarajućim pravima pristupa. On menadžeru dokumenata, koji korisnik vidi u pregledaču, obezbeđuje ID-ove dokumenata i veze ka tim dokumentima.
• Servis za uređivanje dokumenata - serverski servis koji omogućava pregled i uređivanje dokumenata (ako korisnik ima odgovarajuća prava za to). Interfejs uređivača dokumenata koristi se za pristup svim funkcijama servisa za uređivanje dokumenata.
• Servis za komande dokumenata - serverski servis koji omogućava izvršavanje dodatnih komandi pomoću servisa za uređivanje dokumenata.
• Servis za konverziju dokumenata - serverski servis koji omogućava konvertovanje datoteke dokumenta u odgovarajući Office Open XML format (docx za tekstualne dokumente, xlsx za tabele i pptx za prezentacije) radi uređivanja ili preuzimanja.
• Servis za izgradnju dokumenata - serverski servis koji omogućava lako građenje dokumenta bez potrebe da se zaista pokreće uređivač dokumenata.

Imajte na umu da ONLYOFFICE Document Server obuhvata uređivač dokumenata, servis za uređivanje dokumenata, servis za komande dokumenata, servis za konverziju dokumenata i servis za izgradnju dokumenata. Menadžer dokumenata i servis za skladištenje dokumenata ili su uključeni u Community Server ili ih moraju implementirati integratori softvera koji koriste ONLYOFFICE Document Server na sopstvenom serveru.

Omogućavanje JWT-a za integraciju ONLYOFFICE-a i Strapi-ja

JWT ili JSON Web Token je niz znakova koji klijent šalje serveru unutar HTTP zahteva radi provere autentičnosti klijenta. JWT se čuva samo na strani klijenta, tako da je prenos između strana zaštićen i digitalno potpisan.

Token se generiše pomoću JWT standarda (JSON Web Tokens). Tokeni su potpisani ključem servera, tako da klijent može da proveri da li je token legitiman.

ONLYOFFICE Docs proverava token. Podaci iz sadržaja (payload) smatraju se važećim i koriste se umesto odgovarajućih podataka iz glavnih parametara. Ako token nije važeći, komanda se ne izvršava. Da biste saznali više, pročitajte vodič o API bezbednosti.

Da biste zaštitili svoje dokumente pomoću JWT-a,

1. Otvorite sekciju Settings u levom panelu.

2. U sekciji Global settings kliknite na stavku menija ONLYOFFICE.

3. Na stranici sa podešavanjima ONLYOFFICE unesite tajni ključ u polje Document server JWT secret key. Više informacija možete pronaći ovde.

   

   Sada kada je ONLYOFFICE integracioni dodatak konfigurisan, možete početi da ga koristite.

Početak korišćenja ONLYOFFICE Docs unutar Strapi-ja

Da biste korisnicima omogućili da kancelarijske dokumente iz Strapi-ja uređuju u uređivačima ONLYOFFICE Docs i da izmene sačuvaju nazad u Strapi, otpremite datoteke i podesite odgovarajuća prava pristupa.

Otpremanje datoteka u Strapi

1. U sekciji Plugins u levom panelu otvorite stranicu Media Library.

2. Kliknite na dugme Add new assets u gornjem desnom uglu.

   

3. Otvoriće se prozor Add new assets. Izaberite da li želite da otpremite datoteku sa računara ili sa URL-a klikom na odgovarajuću karticu u gornjem panelu.

   

Pregled, uređivanje i upravljanje datotekama u Strapi-ju

Da biste pregledali, uređivali i zajednički uređivali dokumente dodate u Strapi Media Library,

1. U sekciji Plugins u levom panelu otvorite stranicu sa datotekama ONLYOFFICE unutar Strapi-ja.

2. Da biste datoteku otvorili u ONLYOFFICE uređivaču, kliknite na naziv datoteke ili kliknite na dugme Edit in ONLYOFFICE sa desne strane.

   

Da biste datoteke sačuvali u traženom formatu direktno u uređivaču,

1. Idite na karticu Datoteka.
2. Kliknite na opciju Preuzmi kao... i izaberite traženi format.

Da biste datoteke označili kao omiljene direktno u uređivaču, kliknite na ikonu Označi kao omiljeno na gornjoj traci sa alatkama.

Da biste se vratili na listu datoteka,

1. Idite na karticu Datoteka.
2. Kliknite na opciju Otvori lokaciju datoteke u meniju sa desne strane.

Prava pristupa

Da biste upravljali pravima pristupa datotekama dodatim u Strapi Media Library:

1. Idite na karticu Settings koja se nalazi u sekciji General na levom panelu.
2. U sekciji Administration panel idite na karticu Roles.
3. Uredite ulogu klikom na ikonu Edit sa desne strane naziva uloge.

Da biste korisnicima omogućili da uređuju datoteke, podesite prava pristupa Update + Delete za traženu korisničku ulogu.

Da biste korisnicima omogućili da datoteke samo pregledaju, podesite pravo pristupa Access the Media Library za traženu korisničku ulogu.

note

Da biste saznali više o najčešćim problemima i načinima njihovog rešavanja, posetite naš vodič za rešavanje problema.