Drupal

Glavne funkcionalnosti

• Uređivanje i pregledanje tekstualnih dokumenata, tabela, prezentacija i PDF obrazaca.
• Ko-uređivanje dokumenata u realnom vremenu: dva režima ko-uređivanja (Brzi i Strogi), režim Praćenja promena, komentari i ugrađeni chat.
• 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.
• Pregled datoteka na javnim stranicama.

Podržani formati

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

Zahtevi

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

  Potrebna vam je instanca ONLYOFFICE Docs koja je dostupna i povezana kako sa Drupal, tako i sa bilo kojim krajnjim klijentima. Mora biti u mogućnosti da POST-uje direktno na Drupal.

  Molimo vas da se obratite zvaničnoj stranici sa dokumentacijom za više informacija o instalaciji ONLYOFFICE Docs.
• Drupal osnovni modul 10 ili noviji.
• firebase/php-jwt: 6.0.0 ili noviji.
• ONLYOFFICE Konektor za Drupal

Instalacija putem korisničkog interfejsa Drupala

1. Na stranici projekta Admin alatne trake na drupal.org, skrolujte do sekcije Releases na dnu stranice. Kliknite na link View all releases.
2. Odaberite potrebnu verziju sa liste.
3. Kopirajte adresu linka tar.gz. U zavisnosti od vašeg uređaja i pretraživača, to možete uraditi desnim klikom i odabirom Copy link address.
4. U administrativnom meniju Manage, idite na Extend (admin/modules). Pojaviće se stranica Extend.
5. Kliknite na dugme Add new module. Pojaviće se stranica Add new module.
   
6. Zalepite kopirani link za preuzimanje u polje Add from a URL.
   
7. Kliknite na Install da biste otpremili i raspakovali novi modul na serveru. Datoteke se preuzimaju u direktorijum modula.
8. Da biste primenili podešavanja lokalizacije, pokrenite sledeće komande:

   drush locale-check

   drush locale-update

Instalacija putem Composer-a

Unesite sledeću komandu u korenu vašeg Drupal sajta:

composer require onlyoffice/onlyoffice-drupal

Ako je direktorijum za instalaciju web/modules/contrib/drupal, pokrenite sledeće komande da biste primenili podešavanja lokalizacije:

drush locale-check

drush locale-update

Omogućavanje ONLYOFFICE integracionog modula putem korisničkog interfejsa Drupala

1. Otvorite stranicu Extend (admin/modules) putem administrativnog menija Manage.
2. Pronađite ONLYOFFICE Connector module i označite odgovarajuće polje.
   
3. Kliknite na Install da biste omogućili modul.

Omogućavanje ONLYOFFICE integracionog modula putem komandne linije

1. Pokrenite sledeću Drush komandu, navodeći ime projekta kao parametar:

   drush pm:enable onlyoffice

2. Pratite uputstva čarobnjaka.

Kako funkcioniše

Interakcija korisnika i dokumenta se odvija i na strani klijenta i na strani servera.

Glavni pojmovi korišćeni u ovoj dokumentaciji objašnjeni su u nastavku.

Strana klijenta uključuje:

• Menadžer dokumenata - lista dokumenata prikazana u pretraživaču korisnika gde korisnik može odabrati potreban dokument i izvršiti određene akcije sa njim (u zavisnosti od dodeljenih prava, korisnik može otvoriti dokument za pregled ili uređivanje, deliti dokument sa drugim korisnicima).
• Editor dokumenata - interfejs za pregled i uređivanje dokumenata sa svim poznatim funkcijama za uređivanje dokumenata, korišćen kao posrednik između korisnika i servisa za uređivanje dokumenata.

Strana servera uključuje:

• Servis za skladištenje dokumenata - serverski servis koji skladišti sve dokumente dostupne korisnicima sa odgovarajućim pravima pristupa. On obezbeđuje ID-ove dokumenata i linkove ka tim dokumentima menadžeru dokumenata koji korisnik vidi u pretraživaču.
• Servis za uređivanje dokumenata - serverski servis koji omogućava pregled i uređivanje dokumenata (u slučaju da korisnik ima odgovarajuća prava za to). Interfejs editora dokumenata se koristi za pristup svim funkcijama servisa za uređivanje dokumenata.
• Servis za komande dokumenata - serverski servis koji omogućava izvršavanje dodatnih komandi sa servisom za uređivanje dokumenata.
• Servis za konverziju dokumenata - serverski servis koji omogućava konvertovanje fajlova dokumenata u odgovarajući Office Open XML format (docx za tekstualne dokumente, xlsx za tabele i pptx za prezentacije) za njihovo uređivanje ili preuzimanje.
• Servis za kreiranje dokumenata - serverski servis koji omogućava lako kreiranje dokumenta bez potrebe za pokretanjem editora za obradu dokumenata.

Napominjemo da ONLYOFFICE Document Server uključuje editor dokumenata, servis za uređivanje dokumenata, servis za komande dokumenata, servis za konverziju dokumenata i servis za kreiranje dokumenata. Menadžer dokumenata i servis za skladištenje dokumenata su ili uključeni u Community Server ili ih moraju implementirati softverski integratori koji koriste ONLYOFFICE Document Server na svom serveru.

Omogućavanje JWT za integraciju ONLYOFFICE i Drupala

JWT, ili JSON Web Token, je string koji se šalje sa klijenta na server unutar HTTP zahteva kako bi se potvrdila autentičnost 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 korišćenjem JWT (JSON Web Tokens) standarda. Tokeni su potpisani ključem servera, tako da klijent može da proveri da li je token legitiman.

ONLYOFFICE Docs validira token. Podaci iz payload-a se smatraju validnim i koriste se umesto odgovarajućih podataka iz glavnih parametara. Ako je token nevažeći, komanda se ne izvršava. Da biste saznali više, pročitajte API Security vodič.

Da biste zaštitili svoje dokumente sa JWT u Drupalu, otvorite stranicu ~/config/system/onlyoffice-settings sa administrativnim podešavanjima za ONLYOFFICE sekciju. Alternativno, pratite ove korake:

1. Otvorite stranicu Proširenja (admin/modules) putem administrativnog menija Upravljanje.
2. Kliknite na strelicu u opisu ONLYOFFICE Connector modula da otvorite padajuću listu.
3. Izaberite opciju Konfiguriši.
4. Unesite tajni ključ u polje Tajni ključ.
   
5. U konfiguracionom fajlu Document Server-a, navedite isti tajni ključ i omogućite validaciju.

Otpremanje fajlova u Drupal

1. Idite na Upravljanje > Sadržaj.
2. Kliknite na dugme Dodaj sadržaj.
3. Kliknite na željeni tip sadržaja.
4. Unesite naslov, jezik i telo, i podesite format teksta.
5. U polju Dodaj novi fajl, kliknite na dugme Pregledaj i izaberite fajl sa vašeg hard diska.
6. Označite ili poništite polje Objavljeno u zavisnosti od vaših preferencija.
7. Kliknite na dugme Sačuvaj.

Pregled, uređivanje i upravljanje fajlovima u Drupalu

1. Idite na Upravljanje > Sadržaj.
2. Prebacite se na karticu Mediji na vrhu ekrana.
3. Pronađite potreban fajl na listi ili koristite polje za pretragu na vrhu.
4. Kliknite na strelicu u koloni Operacije da biste izabrali da li želite da Uredite svojstva fajla, Uredite u ONLYOFFICE ili Obrišete fajl.
   

Dodavanje fajlova u postove

Prilikom kreiranja posta, možete dodati novi ONLYOFFICE element.

1. Idite na Struktura > Tipovi sadržaja > kliknite na Upravljanje poljima pored potrebnog polja sadržaja. Na otvorenoj stranici, kliknite na Dodaj polje. Dodajte novo polje: Opšte, Broj, Referenca ili Tekst. Postavite oznaku i sačuvajte.
   
2. Za dodato polje Fajl, navedite ekstenzije fajlova. Idite na Struktura > Tipovi sadržaja > Upravljanje poljima, ili ostanite na otvorenoj stranici. U polju Dozvoljene ekstenzije fajlova, navedite formate fajlova koji će biti prikazani u editorima (docx, xlsx, pptx).
   
3. Za dodato polje Mediji, označite polje Dokument.
   
4. Idite na Struktura > Tipovi medija > Dokument > otvorite padajuću listu i izaberite opciju Upravljanje prikazom.
   
5. Za polje Dokument, navedite format ONLYOFFICE Pregled. Klikom na simbol zupčanika, možete odrediti dimenzije ugrađenog prozora editora.
   

   Kada završite sa podešavanjima, možete kreirati postove na kartici Sadržaj. Kliknite na dugme Dodaj sadržaj i izaberite kreirani sadržaj.

   ``````html
   

1. Odredite naslov i izaberite datoteku (ako sadržaj sadrži polja Datoteka).
2. Za sekciju Mediji, navedite ime prethodno otpremljene datoteke.
3. Posetioci vašeg sajta će takođe moći da pregledaju kreiranu stranicu (Osobe > Dozvole > Pogledaj objavljeni sadržaj).

Rad sa PDF obrascima

Kreiranje/otpremanje PDF obrasca

1. Idite na Upravljanje → Sadržaj → ONLYOFFICE obrazac.
2. Kliknite na dugme Kreiraj i otpremi.
3. Izaberite opciju Prazan iz padajućeg menija Kreiraj obrazac iz i unesite ime datoteke u odgovarajuće polje da biste kreirali novu datoteku.
4. Da biste otpremili postojeći PDF fajl, izaberite opciju Otpremi iz padajućeg menija Kreiraj obrazac iz.
5. Datoteka je sada dostupna na stranici PDF Obrasci.

Objavljivanje PDF obrasca

Pre-konfiguracija

1. Idite na Upravljanje → Struktura → Tip sadržaja.
2. Izaberite opciju Upravljanje poljima pored željenog tipa sadržaja.
3. Kliknite na dugme Kreiraj novo polje u gornjem levom uglu novo otvorene stranice Upravljanje poljima.
4. Izaberite opciju ONLYOFFICE obrazac.
5. Unesite potrebno ime u polje Oznaka.
6. Tip sadržaja koji ste prethodno izabrali u koraku 2 sada ima dodeljen ONLYOFFICE tip obrasca.

Objavljivanje

1. Idite na Upravljanje → Sadržaj → Sadržaj.
2. Kliknite na dugme Dodaj sadržaj u gornjem levom uglu.
3. Izaberite tip sadržaja kojem ste prethodno dodelili tip ONLYOFFICE obrazac.
4. Unesite ime kreiranog obrasca u polje ONLYOFFICE obrazac. Ako nema prethodno kreiranog obrasca, kliknite na dugme Kreiraj novi ONLYOFFICE obrazac.
5. Kliknite na dugme Sačuvaj da biste kreirali stranicu obrasca u Drupalu.

Popunjavanje PDF obrasca

1. Popunite polje obrasca.
2. Kliknite na dugme Završi i pošalji na gornjoj traci sa alatkama.
3. Možete preuzeti kopiju popunjenog obrasca. Kliknite na dugme ⋮ u gornjem desnom uglu i izaberite da li želite da ga preuzmete kao .docx ili .pdf datoteku.

Da biste saznali više o popunjavanju obrazaca, molimo vas da pogledate sledeći vodič.

Rad sa popunjenim obrascima

1. Idite na Upravljanje → Sadržaj → ONLYOFFICE obrazac → Podneti obrasci.
2. Svi popunjeni obrasci su grupisani po imenu šablona. Kliknite na ime šablona da biste videli sve povezane obrasce.
3. Možete pregledati, preuzeti ili obrisati bilo koji od obrazaca.