Plone

O integraciji ONLYOFFICE i Plone

ONLYOFFICE nudi zvanični konektor za integraciju ONLYOFFICE Docs sa Plone kako biste mogli da uređujete dokumente unutar sistema za upravljanje sadržajem. Možete preuzeti ONLYOFFICE konektor sa PyPi.org i sa ONLYOFFICE GitHub stranice. Konektor se distribuira pod licencom Apache-2.0.

note

Da biste saznali više o konektoru za integraciju ONLYOFFICE i Plone i kako funkcioniše u detalje, posetite našu API dokumentaciju.

Glavne funkcije

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

Podržani formati

• Za uređivanje: DOCX, XLSX, PPTX, PDF
• Za pregled: DJVU, DOC, DOCM, DOCX, DOT, DOTM, DOTX, EPUB, FB2, FODT, HTML, MHT, ODT, OTT, OXPS, PDF, RTF, TXT, XPS, XML, CSV, FODS, ODS, OTS, XLS, XLSB, XLSM, XLSX, XLT, XLTM, XLTX, FODP, ODP, OTP, POT, POTM, POTX, PPS, PPSM, PPSX, PPT, PPTM, PPTX
• Za konverziju (preuzmi kao): DOC, DOCM, DOCX, DOT, DOTM, DOTX, EPUB, FB2, FODT, HTML, MHT, ODT, OTT, OXPS, PDF, RTF, XPS, XML, FODS, ODS, OTS, XLS, XLSB, XLSM, XLSX, XLT, XLTM, XLTX, FODP, ODP, OTP, POT, POTM, POTX, PPS, PPSM, PPSX, PPT, PPTM, PPTX
• Za konverziju u Office Open XML: DOC, DOCM, DOT, DOTM, DOTX, EPUB, FB2, FODT, HTML, MHT, ODT, OTT, OXPS, PDF, RTF, XPS, XML, FODS, ODS, OTS, XLS, XLSB, XLSM, XLT, XLTM, XLTX, FODP, ODP, OTP, POT, POTM, POTX, PPS, PPSM, PPSX, PPT, PPTM

Šta je novo u verziji 4.1.0

Dodato

• Podrška za PDF obrasce koji se mogu popunjavati.
• Prazni šabloni datoteka za 21 dodatni jezik: arapski (ar-SA), katalonski (ca-ES), danski (da-DK), baskijski (eu-ES), finski (fi-FI), galicijski (gl-ES), hebrejski (he-IL), mađarski (hu-HU), jermenski (hy-AM), indonežanski (id-ID), malajski (ms-MY), norveški bokmal (nb-NO), rumunski (ro-RO), sinhaleški (si-LK), slovenački (sl-SI), albanski (sq-AL), srpski ćirilica (sr-Cyrl-RS), srpski latinica (sr-Latn-RS), turski (tr-TR), urdu (ur-PK) i tradicionalni kineski (zh-TW).
• Podrška za Plone 6.1.
• Poboljšano podešavanje trajanja JWT-a.
• Ažuriran URL demo ONLYOFFICE Document Server-a.

Povezivanje ONLYOFFICE Docs sa Plone

Zahtevi

• ONLYOFFICE Document Server v6.1 (server ili cloud verzija) ili noviji

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

  note

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

• Python 3.4 i noviji

• ONLYOFFICE integracioni dodatak 3.0.1 ili noviji za Plone

Instalacija ONLYOFFICE integracionog dodatka za Plone

note

Ako imate instaliranu prethodnu verziju dodatka (ranije verzije dodatka sa prethodnim imenom onlyoffice.connector), uklonite je pre instalacije nove verzije. Ako želite da instalirate raniju verziju, koristite onlyoffice.connector umesto onlyoffice.plone prilikom praćenja uputstava za instalaciju.

ONLYOFFICE integracija za Plone se distribuira kao standardni Plone dodatak. Preporučeni metod instalacije je putem Buildout.

1. Dodajte dodatak u Buildout.

   Otvorite buildout.cfg datoteku vaše Plone instance i dodajte onlyoffice.plone u eggs sekciju:

   [buildout]
   ...
   eggs =
       onlyoffice.plone

2. Pokrenite Buildout.

   Primenite promene pokretanjem buildout iz komandne linije kao korisnik koji nije superkorisnik:

   sudo -u plone_buildout /plone/zinstance/bin/buildout

3. Ponovo pokrenite Plone instancu.

   Ponovo pokrenite vašu Plone instancu da biste učitali novo instalirani dodatak:

   sudo /plone/zinstance/bin/instance restart

4. Omogućite dodatak u Plone.

   Otvorite vašu Plone stranicu u pretraživaču, prijavite se kao administrator i omogućite dodatak:

   • Idite na sekciju Site Setup > Add-ons.
   • Pronađite onlyoffice.plone među dostupnim dodacima.
   • Pritisnite dugme Install da biste ga omogućili.

Konfigurisanje ONLYOFFICE integracionog dodatka za Plone

Da biste konfigurisali dodatak:

1. Idite na Site Setup.

2. Pomaknite se na sekciju Add-ons Configuration.

3. Pritisnite dugme ONLYOFFICE Configuration.

4. U polju Document Editing service, navedite URL adresu gde se nalazi ONLYOFFICE Docs.

   note

   Adresa ONLYOFFICE Docs mora biti dostupna iz Plone, kao što i adresa Plone mora biti dostupna iz ONLYOFFICE Docs.

5. U polju Secret key, navedite tajni ključ koji se koristi za potpisivanje podataka.

   note

   Počevši od ONLYOFFICE Docs v7.2, JWT je omogućen po defaultu i tajni ključ se automatski generiše. Potrebno je da ga omogućite i na strani Plone: pronađite svoj tajni ključ u ONLYOFFICE Docs konfiguracionom fajlu, a zatim navedite isti tajni ključ u podešavanjima konektora. Za više detalja pogledajte sekciju Omogućavanje JWT za integraciju ONLYOFFICE i Plone u ovom članku.

6. U polju Server address for internal requests from the Document Editing Service, navedite adresu koja se koristi za pristup Plone iz Document Editing Service.

7. U polju Document Editing Service address for internal requests from the server, navedite adresu koja se koristi za pristup Document Editing Service iz Plone.

Razvoj Plone ONLYOFFICE dodatka

1. Klonirajte repozitorijum i promenite direktorijum:

   git clone --branch deploy git@github.com:ONLYOFFICE/onlyoffice-plone.git
   cd onlyoffice-plone

2. Kreirajte virtualenv u paketu.

3. Instalirajte zahteve pomoću pip-a.

4. Pokrenite buildout:

   virtualenv .
   ./bin/pip install -r requirements.txt
   ./bin/buildout

5. Pokrenite Plone u prednjem planu:

   ./bin/instance fg

Ako imate funkcionalnu Plone instancu, možete instalirati dodatak dodavanjem projektnih datoteka u src direktorijum:

1. U src direktorijumu, kreirajte onlyoffice.plone direktorijum.

2. Stavite vaše projektne datoteke dobijene putem Git-a u onlyoffice.plone direktorijum.

3. Uredite buildout.cfg datoteku:

   [buildout]
   ...
   eggs =
       onlyoffice.plone
   develop =
       src/onlyoffice.plone

4. Ponovo pokrenite buildout da bi promene stupile na snagu:

   ./bin/buildout

5. Zatim pokrenite ili ponovo pokrenite vašu Plone instancu.

Plone je zasnovan na Zope serveru i neće raditi kao root korisnik. Ako nameravate da ga pokrenete kao root korisnik, morate obezbediti effective-user direktivu. Da biste to učinili, dodajte liniju effective-user < username > u ./parts/instance/etc/zope.conf.

Ažuriranje Plone ONLYOFFICE integracionog dodatka

1. Ako ste naveli tačnu verziju dodatka u vašem buildout.cfg fajlu (takozvano pinovanje, što je preporučena praksa), kao što je onlyoffice.plone = 1.0.0, ažurirajte ovu referencu da vodi do novije verzije. Ako verzija dodatka nije navedena, najnovija verzija će biti automatski učitana:

   [versions]
   ...
   onlyoffice.plone = 1.0.1

2. Pokrenite bin/buildout. Sačekajte dok se nova verzija ne preuzme i instalira.

3. Vaš sajt može izgledati iskrivljeno ili čak postati nedostupan dok ne završite sledeći korak.

4. Idite na ekran Add-on (dodajte /prefs_install_products_form na URL vašeg sajta) i na listi Upgrades izaberite onlyoffice.plone i kliknite Upgrade onlyoffice.plone.

Kako funkcioniše

ONLYOFFICE integracija prati API dokumentovan ovde.

1. Korisnik navigira do dokumenta unutar Plone i bira akciju ONLYOFFICE Edit.
2. Plone priprema JSON objekat za Document Server sa sledećim svojstvima:
   • url: URL koji ONLYOFFICE Docs koristi za preuzimanje dokumenta;
   • callbackUrl: URL koji ONLYOFFICE Docs obaveštava o statusu uređivanja dokumenta;
   • key: UUID+Modified Timestamp koji upućuje ONLYOFFICE Docs da li da ponovo preuzme dokument ili ne;
   • title: naslov dokumenta (ime).
3. Plone konstruira stranicu iz .pt šablona, popunjavajući sve te vrednosti kako bi klijent pretraživač mogao da učita editor.
4. Klijent pretraživač šalje zahtev JavaScript biblioteci iz ONLYOFFICE Docs i šalje ONLYOFFICE Docs konfiguraciju DocEditor-a sa gore navedenim svojstvima.
5. Zatim ONLYOFFICE Docs preuzima dokument iz Plone i korisnik počinje da uređuje.
6. ONLYOFFICE Docs šalje POST zahtev na callbackUrl da obavesti Plone da korisnik uređuje dokument.
7. Kada svi korisnici i klijent pretraživači završe sa uređivanjem, zatvaraju prozor za uređivanje.
8. Nakon 10 sekundi neaktivnosti, ONLYOFFICE Docs šalje POST na callbackUrl obaveštavajući Plone da su klijenti završili sa uređivanjem dokumenta i zatvorili ga.
9. Plone preuzima novu verziju dokumenta, zamenjujući staru.

Omogućavanje JWT za integraciju ONLYOFFICE i Plone

Da bi zaštitili dokumente od neovlašćenog pristupa, ONLYOFFICE editori koriste JSON Web Token (JWT). Token se dodaje u konfiguraciju kada se Document Editor inicijalizuje i tokom razmene komandi između unutrašnjih ONLYOFFICE Docs usluga. Tajni ključ se koristi za potpisivanje JSON web tokena i validaciju tokena prilikom zahteva ka ONLYOFFICE Docs.

Počevši od ONLYOFFICE Docs v7.2, JWT je omogućen po defaultu i tajni ključ se automatski generiše. Potrebno je da pronađete svoj tajni ključ u ONLYOFFICE Docs konfiguracionom fajlu, a zatim navedete isti tajni ključ u podešavanjima konektora.

Korak 1: Pronađite svoj tajni ključ u ONLYOFFICE Docs konfiguracionom fajlu

1. Otvorite fajl local.json sa bilo kojim dostupnim tekst editorom.

   • Za Linux - /etc/onlyoffice/documentserver/local.json

   • Za Windows - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json

   • Za Docker – uđite u ONLYOFFICE Docs kontejner koristeći komandu docker exec -it <containerID> bash i otvorite /etc/onlyoffice/documentserver/local.json

     Alternativno, možete koristiti sledeću komandu da pronađete podrazumevani tajni ključ bez otvaranja local.json:

     sudo docker exec <containerID> /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'

   Fajl local.json bi trebalo da izgleda ovako:

   {
     "services": {
       "CoAuthoring": {
         "token": {
           "enable": {
             "request": {
               "inbox": true,
               "outbox": true
             },
             "browser": true
           }
         },
         "secret": {
           "inbox": {
             "string": "yoursecret"
           },
           "outbox": {
             "string": "yoursecret"
           },
           "session": {
             "string": "yoursecret"
           }
         }
       }
     }
   }

2. Vrednost true je navedena u tri sekcije. To znači da je validacija tokena omogućena.

   • services.CoAuthoring.token.enable.browser
   • services.CoAuthoring.token.enable.request.inbox
   • services.CoAuthoring.token.enable.request.outbox

3. Automatski generisan tajni ključ je naveden u tri sekcije. Možete zameniti podrazumevanu tajnu vrednost svojim tajnim ključem. Tajni ključ mora biti isti u tri sekcije.

   • services.CoAuthoring.secret.inbox.string
   • services.CoAuthoring.secret.outbox.string
   • services.CoAuthoring.secret.session.string

4. Ako napravite izmene, sačuvajte ih i restartujte usluge kako bi promene u konfiguraciji stupile na snagu.

   supervisorctl restart all

Korak 2: Navedite isti tajni ključ u podešavanjima konektora

U podešavanjima konektora, navedite isti tajni ključ u polju Secret key i sačuvajte podešavanja.

Povezivanje sa demo ONLYOFFICE Docs

Počevši od ONLYOFFICE konektor verzije 3.0.0, možete isprobati ONLYOFFICE online editore unutar Plone bez instalacije ONLYOFFICE Docs.

Da biste uključili vezu, kliknite na polje Connect to demo ONLYOFFICE Document Server i kliknite na dugme Save.

Važno

Ovo je javni test server koji će biti dostupan u periodu od 30 dana. Ne delite tamo svoje osetljive podatke.

Počnite koristiti ONLYOFFICE Docs unutar Plone

Da kreirate dokument:

1. Na kartici Contents, kliknite na opciju menija Create in ONLYOFFICE sa leve strane.

2. Izaberite potrebni tip fajla: Dokument, Tabelu ili Prezentaciju.

   

3. Novi dokument će biti otvoren za uređivanje.

Da uredite dokument:

1. Pronađite potreban dokument na kartici Sadržaj.

   

2. Kliknite na dokument.

3. Na otvorenoj stranici, kliknite na opciju menija ONLYOFFICE Edit da biste otvorili dokument za uređivanje i/ili pregled.

   

Da biste konvertovali dokument u Office Open XML format:

1. Pronađite potreban dokument na kartici Sadržaj.

2. Kliknite na dokument.

3. Na otvorenoj stranici, kliknite na opciju menija Konverzija u ONLYOFFICE.

   

   note

   Pogledajte kompletnu listu formata koji se mogu konvertovati u OOXML.

4. Kliknite na dugme Konvertuj.

   

Da biste kreirali PDF obrazac:

1. Na kartici Sadržaj, kliknite na opciju menija Kreiraj u ONLYOFFICE sa leve strane.
2. Izaberite opciju PDF obrazac.
3. Otvara se novi prazan PDF obrazac za uređivanje. Koristite karticu Forme da biste dodali tipove polja: tekstualna polja, kombinovana polja, padajuće liste, polja za potvrdu, radio dugmad, slike, polja za potpis, adrese e-pošte i druga.

Da biste popunili obrazac:

1. Pronađite potreban obrazac na kartici Sadržaj.

2. Kliknite na obrazac.

3. Na otvorenoj stranici, kliknite na opciju menija Popuni obrazac u ONLYOFFICE.

   

note

Da biste saznali više o obrascima, pročitajte odgovarajuće članke o kreiranju i popunjavanju obrazaca.

Da biste preuzeli dokument u drugom formatu:

1. Pronađite potreban dokument na kartici Sadržaj.

2. Kliknite na dokument.

3. Na otvorenoj stranici, kliknite na opciju menija Akcije i izaberite stavku menija Preuzmi kao.

   

4. Izaberite potreban format sa liste.

5. Kliknite na dugme Preuzmi.

   

note

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