Chamilo

ONLYOFFICE ve Chamilo entegrasyonu hakkında

ONLYOFFICE, ONLYOFFICE Docs'u Chamilo ile entegre etmek ve ofis belgelerini belge kitaplığında düzenlemek için resmi bir bağlayıcı sunar. ONLYOFFICE bağlayıcısını GitHub sayfasından indirebilirsiniz.

not

Chamilo için ONLYOFFICE bağlayıcısının nasıl çalıştığı hakkında daha fazla bilgi için API belgeleri sayfasını ziyaret edin.

Ana özellikler

• Metin belgelerini, e-tabloları, sunumları ve PDF formlarını düzenleme ve görüntüleme.
• Belgeleri gerçek zamanlı olarak birlikte düzenleme: iki ortak düzenleme modu (Hızlı ve Katı), Değişiklikleri izle modu, yorumlar ve yerleşik sohbet.
• Trafiğinizi korumak için JWT desteği: belgelerinize yalnızca uygun haklara sahip kullanıcılar erişebilir.

Desteklenen biçimler

• Düzenleme için: DOCX, XLSX, PPTX, PPSX, PDF formu
• Yalnızca görüntüleme için: PDF, DJVU, TXT, CSV, ODT, ODS, ODP, DOC, XLS, PPT, PPS, EPUB, RTF, HTML, HTM, MHT, XPS

1.5.0 sürümündeki yenilikler

Eklenenler

• Öğrenme yolu desteği

Değişenler

• Küçük düzeltmeler

Değişikliklerin tam listesine buradan ulaşabilirsiniz.

ONLYOFFICE Docs'u Chamilo'ya bağlama

Gereksinimler

• ONLYOFFICE Document Server v6.2 (sunucu veya bulut sürümü) veya üzeri

  Hem Chamilo'dan hem de tüm son istemcilerden çözümlenebilen ve erişilebilen bir ONLYOFFICE Docs örneğine ihtiyacınız vardır. Örneğin doğrudan Chamilo'ya POST isteği gönderebilmesi gerekir.

  not

  ONLYOFFICE Docs'un kurulumu hakkında daha fazla bilgi için resmi belgeler sayfasına bakın.

• Chamilo v1.11.16 veya üzeri

not

ONLYOFFICE Docs ve Chamilo farklı bilgisayarlara veya aynı makineye kurulabilir. İkinci seçeneği seçerseniz ONLYOFFICE Docs için özel bir bağlantı noktası ayarlayın; çünkü varsayılan olarak hem ONLYOFFICE Docs hem de Chamilo 80 numaralı bağlantı noktasında çalışır. İlgili talimatlar için Docker, Ubuntu, CentOS veya Windows sayfalarına bakın.

Chamilo için ONLYOFFICE bağlayıcısını kurma

Chamilo v1.11.16 sürümünden itibaren ONLYOFFICE bağlayıcısı önceden kuruludur. Etkinleştirmek için şu adımları izleyin:

1. Chamilo Administration sayfasına gidin ve Portal bloğundaki Plugins bölümünü seçin.
2. Eklenti listesinde ONLYOFFICE eklentisini seçin ve Enable the selected plugins düğmesine tıklayın.

not

Chamilo sürümünüz 1.11.16'dan düşükse ONLYOFFICE bağlayıcısını kurmak için şu talimatları izleyin:

1. Bağlayıcıyı GitHub sayfasından indirin.
2. Chamilo Administration sayfasına gidin, Plugins bölümünü seçin ve Upload plugin düğmesine tıklayın.
3. onlyoffice.zip dosyasını yükleyin. Eklenti listesi görüntülenir.
4. Terminalde Chamilo kök klasöründen composer install komutunu çalıştırın.
5. Eklenti listesine dönün, ONLYOFFICE eklentisini seçin ve Enable düğmesine tıklayın.

Chamilo için ONLYOFFICE bağlayıcısını güncelleme

Bağlayıcıyı en son sürüme güncellemek için önceden kurulu varsayılan eklenti klasörünü yeni derlenen eklentiyle değiştirmeniz gerekir.

Adım 1: Bağlayıcının yeni sürümünü içeren klasörü hazırlayın.

• GitHub sayfasından indirebilir ve arşivi açabilirsiniz:

  cd /tmp && wget https://github.com/ONLYOFFICE/onlyoffice-chamilo/releases/download/vX.X.X/onlyoffice.zip

  Burada vX.X.X gerekli bağlayıcı sürümüdür.

  unzip onlyoffice.zip

• Alternatif olarak bağlayıcıyı derleyebilirsiniz:

  1. Aşağıdaki komutu çalıştırarak bu deponun son sürümünü alın:

     git clone https://github.com/ONLYOFFICE/onlyoffice-chamilo
     cd onlyoffice-chamilo

  2. Alt modülü alın:

     git submodule update --init --recursive

  3. Eklenti bağımlılıklarını alın:

     composer install

  4. Tüm dosyaları toplayın:

     mkdir /tmp/onlyoffice-deploy
     mkdir /tmp/onlyoffice-deploy/onlyoffice
     cp -r ./ /tmp/onlyoffice-deploy/onlyoffice
     cd /tmp/onlyoffice-deploy/onlyoffice
     rm -rf ./.git*
     rm -rf */.git*

Adım 2: Eski bağlayıcı klasörünü kaldırın.

1. Terminali kök klasörde açın.

2. Aşağıdaki komutla klasörü kaldırın:

   rm -rf /var/www/html/chamilo-x.x.x/plugin/onlyoffice

   Burada chamilo-x.x.x Chamilo sürümünüzdür.

Adım 3: Yeni bağlayıcı klasörünü chamilo-x.x.x/plugin/ dizinine taşıyın.

1. Terminali kök klasörde açın.

2. Aşağıdaki komutlarla klasörü taşıyın:

   cp -r /tmp/onlyoffice-deploy/onlyoffice /var/www/html/chamilo-x.x.x/plugin/

   Burada chamilo-x.x.x Chamilo sürümünüzdür.

Chamilo için ONLYOFFICE bağlayıcısını yapılandırma

Plugins sayfasında ONLYOFFICE öğesini bulun ve Configure düğmesine tıklayın. Aşağıdaki parametreleri yapılandırabileceğiniz Settings sayfası açılır:

• Document Editing Service address alanına Chamilo'dan Belge Düzenleme Hizmeti'ne erişmek için kullanılan adresi girin.

  Önemli

  ONLYOFFICE Docs adresi Chamilo'dan erişilebilir olmalıdır, aynı şekilde Chamilo adresi de ONLYOFFICE Docs'tan erişilebilir olmalıdır.

• Secret Key alanında verileri imzalamak için kullanılan gizli anahtarı belirtin.

  not

  ONLYOFFICE Docs v7.2 sürümünden itibaren JWT varsayılan olarak etkindir ve gizli anahtar otomatik olarak oluşturulur. JWT'yi Chamilo tarafında da etkinleştirmeniz gerekir: gizli anahtarınızı ONLYOFFICE Docs yapılandırma dosyasında bulun, ardından aynı gizli anahtarı bağlayıcı ayarlarında belirtin. Daha fazla bilgi için bu makalenin ONLYOFFICE ve Chamilo entegrasyonu için JWT'yi etkinleştirme bölümüne bakın.

Nasıl çalışır

ONLYOFFICE entegrasyonu burada açıklanan API'yi izler.

1. Yeni bir dosya oluşturmak için öğretmen gerekli klasörü açar ve ONLYOFFICE Create new simgesine tıklar.

2. Kullanıcı, dosya adını ve biçimini (metin belgesi, e-tablo veya sunum) girmesi gereken dosya oluşturma sayfasına yönlendirilir. Tarayıcı /plugin/onlyoffice/create.php yöntemini çağırır. Bu yöntem, kurs klasörüne boş bir dosyanın kopyasını ekler.

3. Mevcut bir dosyayı açmak için kullanıcı Open with ONLYOFFICE simgesini seçer.

4. İstek /plugin/onlyoffice/editor.php?docId="document identificator" adresine gönderilir. Sunucu isteği işler ve aşağıdaki özelliklere sahip düzenleyici başlatma yapılandırmasını oluşturur:

   • url - ONLYOFFICE Docs'un belgeyi indirmek için kullandığı URL;
   • callbackUrl - ONLYOFFICE Docs'un belge düzenleme durumunu bildirmek için kullandığı URL;
   • documentServerUrl - istemcinin ONLYOFFICE Docs'a yanıt vermek için kullanması gereken URL (yönetim ayarları sayfasında belirlenebilir);
   • key - ONLYOFFICE Docs'a belgeyi yeniden indirip indirmeyeceğini bildiren etag.

5. Sunucu, düzenleyiciyi açmak için bir betik içeren bir sayfa döndürür.

6. Tarayıcı bu sayfayı açar ve düzenleyiciyi yükler.

7. Tarayıcı ONLYOFFICE Docs'a istek gönderir ve belge yapılandırmasını ona iletir.

8. ONLYOFFICE Docs belgeyi yükler ve kullanıcı düzenlemeye başlar.

9. ONLYOFFICE Docs, bir kullanıcının belgeyi düzenlediğini Chamilo'ya bildirmek için callbackUrl adresine POST isteği gönderir.

10. Tüm kullanıcılar düzenlemeyi bitirdiğinde düzenleyici penceresini kapatır.

11. 10 saniye sonra ONLYOFFICE Docs, düzenleme oturumunun bittiğini bildirmek için callbackUrl adresine POST isteği gönderir ve belgenin yeni sürümünün bağlantısını iletir.

12. Chamilo belgenin yeni sürümünü yükler ve dosyanın üzerine yazar.

ONLYOFFICE ve Chamilo entegrasyonu için JWT'yi etkinleştirme

Belgeleri yetkisiz erişime karşı korumak için ONLYOFFICE düzenleyicileri JSON Web Token (JWT) kullanır. Token, Belge Düzenleyici başlatılırken yapılandırmaya ve ONLYOFFICE Docs'un iç hizmetleri arasındaki komut alışverişi sırasında eklenir. Gizli anahtar, JSON web token'ı imzalamak ve ONLYOFFICE Docs'a gelen istekte token'ı doğrulamak için kullanılır.

ONLYOFFICE Docs v7.2 sürümünden itibaren JWT varsayılan olarak etkindir ve gizli anahtar otomatik olarak oluşturulur. Gizli anahtarınızı ONLYOFFICE Docs yapılandırma dosyasında bulmanız, ardından aynı gizli anahtarı bağlayıcı ayarlarında belirtmeniz gerekir.

Adım 1: Gizli anahtarınızı ONLYOFFICE Docs yapılandırma dosyasında bulun

1. local.json dosyasını herhangi bir metin düzenleyiciyle açın.

   • Linux için - /etc/onlyoffice/documentserver/local.json

   • Windows için - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json

   • Docker için – docker exec -it <containerID> bash komutuyla ONLYOFFICE Docs kapsayıcısına girin ve /etc/onlyoffice/documentserver/local.json dosyasını açın

     Alternatif olarak, local.json dosyasını açmadan varsayılan gizli anahtarı bulmak için aşağıdaki komutu kullanabilirsiniz:

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

   local.json dosyası şöyle görünmelidir:

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

2. true değeri üç bölümde belirtilmiştir. Bu, token doğrulamasının etkin olduğu anlamına gelir.

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

3. Otomatik olarak oluşturulan gizli anahtar üç bölümde belirtilmiştir. Varsayılan gizli değeri kendi gizli anahtarınızla değiştirebilirsiniz. Gizli anahtar üç bölümde de aynı olmalıdır.

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

4. Değişiklik yaparsanız kaydedin ve yapılandırma değişikliklerinin geçerli olması için hizmetleri yeniden başlatın.

   supervisorctl restart all

Adım 2: Aynı gizli anahtarı bağlayıcı ayarlarında belirtin

Bağlayıcı ayarlarında Secret key alanına aynı gizli anahtarı girin ve ayarları kaydedin.

Chamilo için ONLYOFFICE bağlayıcısını devre dışı bırakma

ONLYOFFICE bağlayıcısını devre dışı bırakmanız gerekirse:

1. Plugins sayfasında ONLYOFFICE öğesini bulun ve Configure düğmesine tıklayın.
2. Enable bölümünde No onay kutusunu işaretleyin.

Chamilo içinde ONLYOFFICE Docs'u kullanmaya başlama

ONLYOFFICE Docs düzenleyicileriyle düzenlemek üzere bir belgeyi açmak için:

1. Gerekli dosyanın bulunduğu klasörü açın.
2. Dosyayı düzenleyicide düzenlemek üzere açmak için Edit in ONLYOFFICE simgesine tıklayın.

Belge ONLYOFFICE Docs düzenleyicisinde açılır.

Belgenin iznini salt okunur olarak değiştirmek için:

1. Gerekli belgeyi bulun.
2. Edit simgesine tıklayın.
3. Açılan sayfada Read only onay kutusunu işaretleyin.
4. Save document düğmesine tıklayın.

not

En sık karşılaşılan sorunlar ve çözüm yolları hakkında daha fazla bilgi için lütfen sorun giderme kılavuzumuzu inceleyin.