Pređi na glavni sadržaj

Drupal

O integraciji ONLYOFFICE-a i Drupal-a​

Drupal je sistem za upravljanje sadržajem otvorenog koda koji se koristi za izradu veb-sajtova i API-ja. ONLYOFFICE nudi zvanični modul za integraciju ONLYOFFICE Docs sa Drupal-om i uređivanje kancelarijskih dokumenata u vašoj Drupal biblioteci medija. ONLYOFFICE integracioni modul možete preuzeti sa zvaničnog Drupal sajta izborom potrebne verzije, dodati ga pomoću Composer-a ili pogledati GitHub stranicu. Modul se distribuira pod licencom GNU General Public License v.2.0.

note

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

Glavne funkcije​

  • Uređivanje i pregled tekstualnih dokumenata, tabela, prezentacija i PDF obrazaca.
  • 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.
  • 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.

Povezivanje ONLYOFFICE Docs sa Drupal-om​

Zahtevi​

Instaliranje ONLYOFFICE integracionog modula za Drupal​

Postoje dva načina za instaliranje ONLYOFFICE integracionog modula za Drupal: preko Drupal korisničkog interfejsa ili pomoću Composer-a.

Instaliranje preko Drupal korisničkog interfejsa​

  1. Na stranici projekta Admin toolbar na drupal.org pomerite se do odeljka Releases pri dnu stranice. Kliknite na vezu View all releases.

  2. Izaberite potrebnu verziju sa liste.

  3. Kopirajte adresu tar.gz veze. U zavisnosti od vašeg uređaja i pregledača, to možete učiniti desnim klikom i izborom opcije 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.

    ONLYOFFICE Drupal

  6. Nalepite kopiranu vezu za preuzimanje u polje Add from a URL.

    ONLYOFFICE Drupal

  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
note

Novi moduli se više ne mogu otpremati preko Drupal veb-interfejsa. Pogledajte sledeća uputstva za otpremanje modula u Drupal.

Instaliranje pomoću Composer-a​

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

composer require onlyoffice/onlyoffice-drupal

Ako je instalacioni direktorijum 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 za Drupal​

Postoje dva načina za omogućavanje ONLYOFFICE integracionog modula za Drupal: pomoću Drupal korisničkog interfejsa ili preko komandne linije.

Omogućavanje ONLYOFFICE integracionog modula preko Drupal korisničkog interfejsa​

  1. Otvorite stranicu Extend (admin/modules) preko administrativnog menija Manage.

  2. Pronađite ONLYOFFICE Connector module i označite odgovarajuće polje.

    ONLYOFFICE Drupal

  3. Kliknite na Install da biste omogućili modul.

Omogućavanje ONLYOFFICE integracionog modula preko komandne linije​

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

    drush pm:enable onlyoffice

  2. Pratite uputstva čarobnjaka.

Konfigurisanje ONLYOFFICE integracionog modula za Drupal​

U Drupal-u otvorite stranicu ~/config/system/onlyoffice-settings sa administrativnim podešavanjima za odeljak ONLYOFFICE. Alternativno, pratite ove korake:

  1. Otvorite stranicu Extend (admin/modules) preko administrativnog menija Manage.

  2. Kliknite na strelicu u opisu ONLYOFFICE Connector module da biste otvorili padajuću listu.

  3. Izaberite opciju Configure.

  4. Unesite adresu u polje Document Editing Service address da biste povezali ONLYOFFICE Document Server:

    https://documentserver/

ONLYOFFICE Drupal

Gde je documentserver naziv servera na kome je instaliran ONLYOFFICE Document Server. Adresa mora biti dostupna iz korisničkog pregledača i sa Drupal servera. Adresa Drupal servera takođe mora biti dostupna iz ONLYOFFICE Document Server radi ispravnog rada.

Da bi se ograničio pristup ONLYOFFICE Document Server i radi bezbednosti i integriteta podataka, koristi se šifrovani potpis. Navedite Secret key u administrativnoj konfiguraciji Drupal-a. U konfiguracionoj datoteci ONLYOFFICE Document Server navedite isti tajni ključ i omogućite validaciju.

Kako funkcioniše​

Interakcija 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 korisničkom pregledaču, u kojoj korisnik može izabrati potreban dokument i izvršiti neke radnje nad njim (u zavisnosti od dodeljenih prava, korisnik može otvoriti dokument radi pregleda ili uređivanja, te ga podeliti sa drugim korisnicima).
  • Uređivač dokumenata - interfejs za pregled i uređivanje dokumenata sa svim najpoznatijim dostupnim funkcijama uređivanja, koji se koristi kao posrednik između korisnika i servisa za uređivanje dokumenata.

Strana servera obuhvata:

  • Servis za skladištenje dokumenata - serverski servis koji čuva 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 njima.
  • 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 nad dokumentima - serverski servis koji omogućava izvršavanje dodatnih komandi sa servisom za uređivanje dokumenata.
  • Servis za konverziju dokumenata - serverski servis koji omogućava konverziju 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 izradu dokumenata - serverski servis koji omogućava jednostavnu izradu dokumenta bez potrebe da se zapravo pokreće uređivač za obradu dokumenata.

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

Omogućavanje JWT-a za integraciju ONLYOFFICE-a i Drupal-a​

JWT, ili JSON Web Token, je niska koja se šalje od klijenta ka serveru u okviru HTTP zahteva radi provere autentičnosti klijenta. JWT se čuva samo na strani klijenta, pa je prenos između strana zaštićen i digitalno potpisan.

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

ONLYOFFICE Docs validira token. Podaci iz payload-a smatraju se važećim 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 vodič za bezbednost API-ja.

Da biste zaštitili dokumente pomoću JWT-a u Drupal-u, otvorite stranicu ~/config/system/onlyoffice-settings sa administrativnim podešavanjima za odeljak ONLYOFFICE. Alternativno, pratite ove korake:

  1. Otvorite stranicu Extend (admin/modules) preko administrativnog menija Manage.

  2. Kliknite na strelicu u opisu ONLYOFFICE Connector module da biste otvorili padajuću listu.

  3. Izaberite opciju Configure.

  4. Unesite tajni ključ u polje Secret key.

    ONLYOFFICE Drupal

  5. U konfiguracionoj datoteci ONLYOFFICE Document Server navedite isti tajni ključ i omogućite validaciju.

Početak korišćenja ONLYOFFICE Docs unutar Drupal-a​

Da biste uređivali kancelarijske dokumente u Drupal-u pomoću ONLYOFFICE Docs, otpremite datoteke u Drupal.

Otpremanje datoteka u Drupal​

  1. Idite na Manage > Content.
  2. Kliknite na dugme Add content.
  3. Kliknite na potreban tip sadržaja.
  4. Unesite naslov, jezik i telo teksta i podesite format teksta.
  5. U polju Add a new file kliknite na dugme Browse i izaberite datoteku sa čvrstog diska vašeg računara.
  6. Označite ili poništite polje Published u zavisnosti od vaših želja.
  7. Kliknite na dugme Save.

Pregled, uređivanje i upravljanje datotekama u Drupal-u​

  1. Idite na Manage > Content.

  2. Pređite na karticu Media na vrhu ekrana.

  3. Pronađite potrebnu datoteku na listi ili koristite polje za pretragu na vrhu.

  4. Kliknite na strelicu u koloni Operations da biste izabrali da li želite da Edit svojstva datoteke, Edit in ONLYOFFICE ili da Delete datoteku.

    ONLYOFFICE Drupal

Dodavanje datoteka u objave​

Prilikom kreiranja objave možete dodati novi ONLYOFFICE element.

  1. Idite na Structure > Content types > kliknite na Manage fields pored potrebnog polja sadržaja. Na otvorenoj stranici kliknite na Add field. Dodajte novo polje: General, Number, Reference ili Text. Podesite oznaku i sačuvajte.

    ONLYOFFICE Drupal

  2. Za dodato polje File navedite ekstenzije datoteka. Idite na Structure > Content types > Manage fields ili ostanite na otvorenoj stranici. U polju Allowed file extensions navedite formate datoteka koji će biti prikazani u uređivačima (docx, xlsx, pptx).

    ONLYOFFICE Drupal

  3. Za dodato polje Media kliknite na polje za potvrdu Document.

    ONLYOFFICE Drupal

  4. Idite na Structure > Media types > Document > otvorite padajuću listu i izaberite opciju Manage display.

    ONLYOFFICE Drupal

  5. Za polje Document navedite format ONLYOFFICE Preview. Klikom na simbol zupčanika možete navesti dimenzije ugrađenog prozora uređivača.

    ONLYOFFICE Drupal

    Kada završite sa prethodnim podešavanjima, možete kreirati objave na kartici Content. Kliknite na dugme Add content i izaberite kreirani sadržaj.

    ONLYOFFICE Drupal

Zatim:

  1. Navedite naslov i izaberite datoteku (ako sadržaj ima polja File).
  2. Za odeljak Media navedite naziv prethodno otpremljene datoteke.
  3. Posetioci vašeg sajta takođe će moći da vide kreiranu stranicu (People > Permissions > View published content).

Rad sa PDF obrascima​

Kreiranje/otpremanje PDF obrasca​

  1. Idite na Manage → Content → ONLYOFFICE form.
  2. Kliknite na dugme Create&Upload.
  3. Izaberite opciju Blank iz padajućeg menija Create form from i unesite naziv datoteke u odgovarajuće polje da biste kreirali novu datoteku.
  4. Da biste otpremili postojeću PDF datoteku, izaberite opciju Upload iz padajućeg menija Create form from.
  5. Datoteka je sada dostupna na stranici PDF Forms.

Objavljivanje PDF obrasca​

Prethodna konfiguracija

  1. Idite na Manage → Structure → Content type.
  2. Izaberite opciju Manage fields pored potrebnog tipa sadržaja.
  3. Kliknite na dugme Create a new field u gornjem levom uglu novootvorene stranice Manage fields.
  4. Izaberite opciju ONLYOFFICE form.
  5. Unesite potreban naziv u polje Label.
  6. Tipu sadržaja koji ste prethodno izabrali u koraku 2 sada je dodeljen tip ONLYOFFICE form.

Objavljivanje

  1. Idite na Manage → Content → Content.
  2. Kliknite na dugme Add content u gornjem levom uglu.
  3. Izaberite tip sadržaja kojem ste prethodno dodelili tip ONLYOFFICE form.
  4. Unesite naziv kreiranog obrasca u polje ONLYOFFICE form. Ako ne postoji prethodno kreiran obrazac, kliknite na dugme Create new ONLYOFFICE form.
  5. Kliknite na dugme Save da biste kreirali stranicu obrasca u Drupal-u.

Popunjavanje PDF obrasca​

  1. Popunite polje obrasca.
  2. Kliknite na dugme Complete&Submit 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, pogledajte sledeće uputstvo.

Rad sa popunjenim obrascima​

  1. Idite na Manage → Content → ONLYOFFICE form → Submitted forms.
  2. Svi popunjeni obrasci grupisani su prema nazivu šablona. Kliknite na naziv šablona da biste videli sve povezane obrasce.
  3. Možete pregledati, preuzeti ili obrisati bilo koji od obrazaca.
note

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