Moodle

O integraciji ONLYOFFICE i Moodle

ONLYOFFICE nudi zvanični konektor za integraciju ONLYOFFICE Docs sa Moodle i uređivanje kancelarijskih dokumenata priloženih uz stranice kursa. ONLYOFFICE konektor možete preuzeti iz Moodle biblioteke dodataka ili sa GitHub stranice.

note

Da biste saznali više o tome kako funkcioniše ONLYOFFICE konektor za Moodle, posetite našu API dokumentaciju.

Takođe možete instalirati Moodle Assign Submission ONLYOFFICE Integration plugin. Ovaj dodatak je ekstenzija glavnog Moodle dodatka i omogućava korisnicima da dodaju prilagođeni podnesak tipa ONLYOFFICE dokument u .pdf formatu.

Glavne funkcije

• Uređivanje i pregledanje tekstualnih dokumenata, tabela, prezentacija i obrazaca.

  note

  Da biste saznali više o obrascima, pročitajte odgovarajuće članke o kreiranju i popunjavanju 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 osiguranje vašeg saobraćaja tako da niko, osim korisnika sa odgovarajućim pravima, ne može pristupiti vašim dokumentima.

Podržani formati

• Za pregledanje i uređivanje: DOCX, XLSX, PPTX, PDF
• Samo za pregledanje: TXT, CSV
• Za popunjavanje obrazaca: PDF

Šta je novo u verziji 6.1.0

Dodato

• Dugme Check Connection u podešavanjima za testiranje povezanosti sa serverom dokumenata
• Validacija administratorskih podešavanja za polja vezana za server dokumenata
• Dodati novi jezički šabloni: ca, cs, da, hu, id, ro, sq, ur

Izmenjeno

• Logika validacije administratorskih podešavanja sada proverava samo ispravnost unosa
• Uklonjene završne kose crte iz URL-ova podešavanja nakon ažuriranja
• Ispravljeno neuspešno preimenovanje datoteke
• Ispravljeno otpremanje nepodržane datoteke
• Ispravljene prepreke za odobrenje: kolizije imenskih prostora, upotreba superglobala
• Ispravljeno pogrešno onemogućavanje verifikacije sertifikata u curl zahtevima

Kompletan dnevnik promena je dostupan ovde.

Povezivanje ONLYOFFICE Docs sa Moodle

Zahtevi

• ONLYOFFICE Docs (Document Server) 6.1.0 ili noviji (server ili cloud verzija)

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

  note

  Molimo vas da se obratite zvaničnoj stranici dokumentacije za više informacija o instalaciji ONLYOFFICE Docs.

• Moodle v4.9 ili noviji

• ONLYOFFICE Connector v4.4.0 se koristi za Moodle v4.3.0; v4.3.0 se koristi za Moodle v4 < 4.3.0; v4.2.0 se koristi za Moodle v3.9-3.11

note

ONLYOFFICE Docs i Moodle mogu biti instalirani ili na različitim računarima, ili na istoj mašini. U slučaju da odaberete ovu poslednju opciju, biće potrebno da podesite prilagođeni port za ONLYOFFICE Docs, jer po defaultu i ONLYOFFICE Docs i Moodle rade na portu 80. Pogledajte odgovarajuća uputstva za Docker, Ubuntu, CentOS ili Windows.

Instalacija ONLYOFFICE konektora za Moodle

ONLYOFFICE dodatak za Moodle je modul aktivnosti.

Instalacija ONLYOFFICE konektora pomoću Moodle biblioteke dodataka

1. Prijavite se kao administrator na vašu Moodle instancu i idite na Administracija sajta → Dodaci → Instaliraj dodatke.

   note

   Ako ne možete da pronađete ovu lokaciju, instalacija dodataka je onemogućena na vašem sajtu.

2. Kliknite na dugme Instaliraj dodatke iz Moodle direktorijuma dodataka.

3. Izaberite vašu trenutnu Moodle verziju.

4. Potražite dodatak ONLYOFFICE dokument.

5. Kliknite na dugme Instaliraj, zatim kliknite na Nastavi.

6. Potvrdite zahtev za instalaciju.

7. Proverite izveštaj o validaciji dodatka.

   Važno

   Pravilno izaberite vašu Moodle verziju. Ako greškom preuzmete i instalirate pogrešnu verziju dodatka za vaš Moodle server, to može dovesti do ozbiljnih problema, čak i do zamrzavanja Moodle sajta.

Instalacija ONLYOFFICE konektora pomoću GitHub .ZIP arhive

1. Preuzmite konektor sa GitHub stranice.

2. Prijavite se kao administrator na vašu Moodle instancu, idite u odeljak Administracija sajta, prebacite se na karticu Dodaci i kliknite na link Instaliraj dodatke.

3. Otpremite datoteku moodle-mod_onlyofficeeditor-x.x.x.zip preko birača datoteka ili je prevucite u odgovarajuće polje i kliknite na dugme Instaliraj dodatak iz ZIP datoteke.

   

4. Proverite izveštaj o validaciji dodatka i kliknite na Nastavi.

   Ako ciljni direktorijum nije upisiv, videćete poruku upozorenja, npr. [Error] Write access check [/var/www/html/moodle/mod]. U tom slučaju možete ga privremeno učiniti upisivim pomoću sledeće komande:

   sudo chmod -R 777 /var/www/html/moodle

   Nakon toga ponovite Korak 3.

   Nakon instalacije dodatka potrebno je da vratite dozvole tako da direktorijum više nije upisiv. Koristite sledeću komandu:

   sudo chmod -R 0755 /var/www/html/moodle

5. Kliknite na Nastavi na stranici Informacije o trenutnom izdanju → Provere servera.

6. Kliknite na Ažuriraj Moodle bazu podataka sada na stranici Provera dodataka.

   

7. Kliknite na Nastavi na stranici Ažuriranje na novu verziju.

Instalacija Moodle Assign Submission ONLYOFFICE Integration dodatka

note

Imajte na umu: Moodle Assign Submission ONLYOFFICE Integration dodatak zahteva da je instaliran glavni ONLYOFFICE dodatak.

1. Prijavite se kao administrator na vašu Moodle instancu i idite na Administracija sajta > Dodaci > Instaliraj dodatke.

   note

   Ako ne možete da pronađete ovu lokaciju, instalacija dodataka je onemogućena na vašem sajtu.

2. Kliknite na dugme Instaliraj dodatke iz Moodle direktorijuma dodataka.

3. Izaberite vašu trenutnu Moodle verziju.

4. Potražite dodatak ONLYOFFICE Assign Submission.

5. Kliknite na dugme Instaliraj, zatim kliknite na Nastavi.

6. Potvrdite zahtev za instalaciju.

7. Proverite izveštaj o validaciji dodatka.

   Važno

   Pravilno izaberite vašu Moodle verziju. Ako greškom preuzmete i instalirate pogrešnu verziju dodatka za vaš Moodle server, to može dovesti do ozbiljnih problema, čak i do zamrzavanja Moodle sajta.

Alternativno, možete preuzeti dodatak sa GitHub stranice i instalirati ga iz ZIP datoteke.

Konfigurisanje ONLYOFFICE konektora za Moodle

Kada se dodatak instalira, otvoriće se stranica sa podešavanjima dodatka. Alternativno, stavku menija ONLYOFFICE dokument možete pronaći na stranici Pregled dodataka i kliknuti na Podešavanja. Na stranici Podešavanja možete konfigurisati sledeće parametre:

• U polje Adresa Document Editing Service unesite adresu koja se koristi za pristup Document Editing Service iz Moodle-a. Ovo polje je obavezno.

  note

  Adresa ONLYOFFICE Docs mora biti dostupna sa Moodle-a, kao i adresa Moodle-a mora biti dostupna sa ONLYOFFICE Docs.

• Onemogući verifikaciju sertifikata (nesigurno) — označite ovo polje da biste isključili verifikaciju sertifikata. Verifikacija je podrazumevano omogućena. Ova postavka će uticati na sigurnost vašeg sajta; koristite je samo pri pristupu Document Server-u sa samopotpisanim sertifikatom.

• Opciono, navedite tajnu koja se koristi za potpisivanje podataka u polju Document Server Secret. Tajni ključ se koristi za validaciju JSON web tokena prilikom zahteva ka Document Server-u. Da biste saznali više, pogledajte API dokumentaciju o konfigurisanju JWT na strani ONLYOFFICE Docs.

  note

  Počevši od ONLYOFFICE Docs v7.2, JWT je podrazumevano omogućen i tajni ključ se automatski generiše. Potrebno je da ga omogućite i na strani Moodle: pronađite svoj tajni ključ u konfiguracionoj datoteci ONLYOFFICE Docs, a zatim navedite isti tajni ključ u postavkama konektora. Za više detalja, pogledajte odeljak Omogućavanje JWT za integraciju ONLYOFFICE i Moodle u ovom članku.

• Authorization header (Zaglavlje za autorizaciju) (ostavite prazno da biste koristili podrazumevano zaglavlje) — JWT zaglavlje za autorizaciju koje se koristi u ONLYOFFICE je Authorization. Ako je ovo zaglavlje u sukobu sa vašom konfiguracijom, možete ga promeniti u prilagođeno.

• Adresa ONLYOFFICE Docs za interne zahteve sa servera (podrazumevano prazno) — navedite adresu koja se koristi za pristup Document Editing Service sa Moodle servera.

• Adresa servera za interne zahteve iz ONLYOFFICE Docs (podrazumevano prazno) — navedite adresu koja se koristi za pristup Moodle serveru iz Document Editing Service.

Podešavanja prilagođavanja urednika

• Omogući Force Save — kada je ova opcija onemogućena, vaše izmene se automatski čuvaju u kešu urednika. Kada je ova opcija omogućena, sve izmene dokumenta se šalju direktno u skladište kada kliknete na dugme Sačuvaj.
• Prikaži dugme menija za Čet — ova opcija se koristi za prikaz ili skrivanje dugmeta menija za Čet.
• Prikaži dugme menija za Pomoć — ova opcija se koristi za prikaz ili skrivanje dugmeta menija za Pomoć.
• Prikaži zaglavlje kompaktnije — ova opcija se koristi za prikaz dodatnih dugmadi za akcije ili u gornjem delu zaglavlja prozora urednika pored logotipa, ili na traci sa alatkama.
• Prikaži dugme menija za Povratne informacije — ova opcija se koristi za prikaz ili skrivanje dugmeta menija za Povratne informacije i podršku.
• Prikaži alatnu traku u monohromatskom formatu — ova opcija se koristi za prikaz trake sa alatkama urednika u monohromatskom formatu.

Sigurnost

• Omogući dodatke — ova opcija se koristi za omogućavanje/onemogućavanje kartice Dodaci u interfejsu urednika.
• Pokreni makroe dokumenta — ova opcija se koristi za omogućavanje/onemogućavanje automatskog pokretanja svih makroa unutar dokumenta. Makroe uvek možete pokrenuti ručno.

Kada ste spremni, kliknite na Sačuvaj promene.

note

Imajte na umu: Moodle Assign Submission ONLYOFFICE Integration dodatak ne zahteva dodatna podešavanja; sva podešavanja se konfigurišu iz glavnog dodatka.

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 pregledaču korisnika, gde korisnik može da izabere potreban dokument i izvrši neke radnje sa njim (u zavisnosti od dodeljenih prava, korisnik može da otvori dokument radi pregleda ili uređivanja, ili da ga deli sa drugim korisnicima).
• Urednik dokumenata — interfejs za pregled i uređivanje dokumenata sa svim najpoznatijim funkcijama uređivanja dokumenata, 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 obezbeđuje ID-ove dokumenata i linkove ka tim dokumentima menadžeru dokumenata koji korisnik vidi u pregledaču.
• Servis za uređivanje dokumenata — serverski servis koji omogućava korisnicima da pregledaju i uređuju dokumente (ako korisnik ima odgovarajuća prava za to). Interfejs urednika dokumenata koristi se za pristup svim funkcijama servisa za uređivanje dokumenata.
• Servis za komande dokumenata — serverski servis koji omogućava korisnicima da izvršavaju dodatne komande pomoću servisa za uređivanje dokumenata.
• Servis za konverziju dokumenata — serverski servis koji omogućava korisnicima da konvertuju datoteku 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 urednik za obradu dokumenata.

Imajte na umu da ONLYOFFICE Document Server obuhvata urednik 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 su ili uključeni u Community Server, ili ih moraju implementirati integratori softvera koji koriste ONLYOFFICE Document Server na sopstvenom serveru.

Omogućavanje JWT za integraciju ONLYOFFICE i Moodle

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

Počevši od verzije v7.2 ONLYOFFICE Docs, JWT je podrazumevano omogućen i tajni ključ se automatski generiše. Potrebno je da pronađete vaš tajni ključ u konfiguracionoj datoteci ONLYOFFICE Docs, a zatim navedete isti tajni ključ u podešavanjima konektora.

Korak 1: Pronađite vaš tajni ključ u konfiguracionoj datoteci ONLYOFFICE Docs

1. Otvorite datoteku local.json pomoću bilo kog dostupnog tekstualnog urednika.

   • 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

   Datoteka local.json treba 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 generisani tajni ključ je naveden u tri sekcije. Možete zameniti podrazumevanu vrednost tajnog ključa vašim sopstvenim tajnim ključem. Tajni ključ mora biti isti u sve 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 servise kako bi promene u konfiguraciji stupile na snagu.

   • Za Linux:

     sudo supervisorctl restart all

   • Za Docker:

     docker exec <containerID> supervisorctl restart all

     ili restartujte ceo kontejner:

     docker restart <containerID>

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

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

Počnite koristiti ONLYOFFICE Docs unutar Moodle-a

Dodavanje ONLYOFFICE aktivnosti

Da biste kreirali novu ONLYOFFICE aktivnost:

1. Otvorite odeljak Moji kursevi i pređite na potreban kurs.

2. Aktivirajte Režim uređivanja pomoću prekidača u gornjem desnom uglu.

3. Kliknite na Dodaj aktivnost ili resurs.

4. Izaberite aktivnost ONLYOFFICE dokument u iskačućem prozoru.

   

5. Unesite naziv aktivnosti, kreirajte, otpremite ili prevucite potreban dokument sa vašeg računara i kliknite na dugme Sačuvaj i prikaži.

   

   Aktivnost može biti prazna .docx, .xlsx, .pptx ili .pdf datoteka.

Dokument će biti otvoren u uredniku ONLYOFFICE Docs.

Pregled i uređivanje datoteka

ONLYOFFICE aktivnosti biće označene ikonom na stranicama vašeg kursa. Da biste otvorili dokument u ONLYOFFICE Docs uredniku, samo kliknite na njegov naslov.

Da biste otvorili urednik u režimu celog ekrana, kliknite na dugme Otvori u celom ekranu u gornjem desnom uglu iznad prozora urednika.

Dodavanje podnesaka

note

Imajte na umu: Moodle Assign Submission ONLYOFFICE Integration dodatak je potreban za izradu naprednih digitalnih obrazaca za Moodle zadatke.

Da biste dodali prilagođeni podnesak tipa ONLYOFFICE dokument u .pdf formatu,

1. Otvorite odeljak Moji kursevi i pređite na potreban kurs.
2. Aktivirajte Režim uređivanja pomoću prekidača u gornjem desnom uglu.
3. Kliknite na Dodaj aktivnost ili resurs.
4. Izaberite aktivnost Zadatak u iskačućem prozoru.
5. Na kartici Tipovi podnesaka izaberite tip ONLYOFFICE dokument. Kada to uradite, kreator obrazaca (.pdf) postaće dostupan na stranici za kreiranje/uređivanje zadatka. Ovde možete kreirati obrazac koji će nakon čuvanja biti dostupan studentima za popunjavanje.
6. Kliknite na Sačuvaj i vrati se na kurs ili Sačuvaj i prikaži. Kreirani zadatak će se pojaviti u odeljku kursa.

Popunjavanje obrazaca

Da biste popunili obrazac,

1. Izaberite kreirani zadatak i kliknite na Dodaj podnesak.

   

2. Otvoriće se obrazac u .pdf formatu (za Docs v8.0 ili noviji. Za starije verzije koristi se .oform format). Svaki student dobija sopstvenu kopiju .pdf obrasca i radi na svom zadatku.

3. Popunite obrazac i kliknite na Sačuvaj izmene.

Nastavnik može pregledati sve zadatke klikom na dugme Pregledaj sve podneske.

Zaštita datoteka lozinkom

ONLYOFFICE datoteke se mogu zaštititi lozinkom radi sprečavanja neovlašćenog pristupa. Da biste to uradili,

1. Idite na karticu Fajl na gornjoj traci sa alatkama.

2. Izaberite opciju Zaštiti.

3. Kliknite na dugme Dodaj lozinku.

4. Postavite lozinku u polju Lozinka i ponovite je u polju Ponovi lozinku ispod, zatim kliknite na OK.

   Važno

   Lozinka ne može biti vraćena ako je izgubite ili zaboravite. Molimo vas da je čuvate na bezbednom mestu.

Da biste promenili lozinku,

1. Idite na karticu Fajl na gornjoj traci sa alatkama.
2. Izaberite opciju Zaštiti.
3. Kliknite na dugme Promeni lozinku.
4. Postavite lozinku u polju Lozinka i ponovite je u polju Ponovi lozinku ispod, zatim kliknite na OK.

Da biste obrisali lozinku,

1. Idite na karticu Fajl na gornjoj traci sa alatkama.
2. Izaberite opciju Zaštiti.
3. Kliknite na dugme Obriši lozinku.

Da biste onemogućili opciju zaštite,

1. Idite na stranicu za uređivanje aktivnosti.
2. Otvorite odeljak Dozvole dokumenta.
3. Označite polje Sakrij karticu zaštite.

Upravljanje dozvolama

Administratori/nastavnici mogu izabrati da li se dokumenti mogu preuzimati ili štampati iz ONLYOFFICE urednika. To se može uraditi u odeljku Dozvole dokumenta.

Da biste promenili dozvolu dokumenta na samo za čitanje:

1. Otvorite potreban ONLYOFFICE dokument.
2. Idite na Više > Dozvole.
3. Pronađite stavku Uredi ONLYOFFICE dokument aktivnost/Pogledaj ONLYOFFICE dokument aktivnost.
4. Dodajte potrebne uloge u odeljak Zabranjeno ili uklonite one iz odeljka Uloge sa dozvolom.

Da biste saznali kako da označite dokument kao omiljeni direktno u uredniku, pratite uputstva iz ovog članka.

note

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