Pular para o conteúdo principal

Como conectar o ONLYOFFICE e o Apps ao WordPress

Sobre a integração entre ONLYOFFICE e WordPress​

O plugin de integração do ONLYOFFICE permite aos administradores do WordPress abrir documentos, planilhas e apresentações para edição colaborativa usando o ONLYOFFICE Docs. Nos posts publicados, os editores são visíveis a todos os visitantes do site WordPress (tanto autorizados quanto não autorizados) apenas no modo incorporado. Para mais informações, consulte a página do GitHub do conector ONLYOFFICE para WordPress. O plugin é distribuído sob a licença GPL-2.0.

observação

Para saber mais sobre como o conector ONLYOFFICE para WordPress funciona, visite a página da nossa documentação da API.

Principais recursos​

  • Criação, edição e visualização de documentos de texto, planilhas e apresentações.
  • Co-edição de documentos em tempo real: dois modos de co-edição (Rápido e Estrito), o modo Controlar Alterações, comentários e chat integrado.
  • Suporte JWT para proteger seu tráfego e garantir que ninguém tenha acesso aos seus documentos, exceto usuários com os devidos direitos.

Formatos suportados​

  • Para criação, edição e visualização: DOCX, PPTX, XLSX
  • Apenas para visualização: XLS, XLSX, XLSM, XLT, XLTX, XLTM, ODS, FODS, OTS, CSV, PPS, PPSX, PPSM, PPT, PPTX, PPTM, POT, POTX, POTM, ODP, FODP, OTP, DOC, DOCX, DOCM, DOT, DOTX, DOTM, ODT, FODT, OTT, RTF, TXT, HTML, HTM, MHT, XML, PDF, DJVU, FB2, EPUB, XPS, OXPS
  • Para preenchimento de formulários: PDF

Conectando o ONLYOFFICE Docs ao WordPress​

Requisitos​

  • ONLYOFFICE Document Server v6.1.0 (versão servidor ou cloud) ou posterior

    Você precisa de uma instância do ONLYOFFICE Docs que seja resolvível e conectável tanto do WordPress quanto de qualquer cliente final. Deve ser capaz de fazer POST diretamente para o WordPress.

    observação

    Consulte a página de documentação oficial para saber mais sobre a instalação do ONLYOFFICE Docs.

  • WordPress versão 5.7 ou superior

  • ONLYOFFICE Connector 2.3.0 for WordPress

Instalando o plugin ONLYOFFICE para WordPress​

Para começar a usar o ONLYOFFICE Docs com o WordPress, use um dos três métodos de instalação: por meio de um arquivo .zip, clonando o branch master ou usando o marketplace do WordPress:

  1. Usando o arquivo .zip:
    • Baixe o plugin compactado.
    • Navegue até a seção Plugins no painel administrativo do seu WordPress.
    • Vá para Plugins → Adicionar Novo.
    • Clique em Enviar Plugin.
    • Clique em Escolher Arquivo, selecione o arquivo ZIP baixado e envie-o.
    • Após a instalação, clique em Ativar.
  2. Clonando o branch master:

    • Clone o branch master:

      cd wp-content/plugins git clone https://github.com/ONLYOFFICE/onlyoffice-wordpress

    • Ative o plugin no painel administrativo do WordPress.

  3. Usando o marketplace do WordPress:
    • Instale o plugin a partir da página oficial no marketplace.
    • Após a instalação, clique em Ativar.

Configurando o ONLYOFFICE Docs no WordPress​

Depois de instalar o plugin, configure as definições de conexão:

  1. Vá para painel administrativo do WordPress → ONLYOFFICE → Configurações.
  2. Especifique a URL para as configurações do conector:

    • Endereço do Serviço de Edição de Documentos - especifique o endereço URL onde o Serviço de Edição de Documentos está instalado.

      observação

      O endereço do ONLYOFFICE Docs deve estar acessível a partir do WordPress, assim como o endereço do WordPress deve estar acessível a partir do ONLYOFFICE Docs.

    • Chave Secreta - especifique o segredo usado para assinar os dados.

      observação

      A partir do ONLYOFFICE Docs v7.2, o JWT está habilitado por padrão e a chave secreta é gerada automaticamente. Você precisa habilitá-lo no lado do WordPress também: encontre sua chave secreta no arquivo de configuração do ONLYOFFICE Docs, então especifique a mesma chave secreta nas configurações do conector. Para mais detalhes, veja a seção Habilitando JWT para a integração ONLYOFFICE e WordPress deste artigo.

    • Cabeçalho de autorização - (deixe em branco para usar o cabeçalho padrão) - o cabeçalho JWT de autorização usado no ONLYOFFICE é AuthorizationJwt. Caso esse cabeçalho entre em conflito com a sua configuração, você pode alterá-lo para um personalizado.

configurar

Como funciona​

A interação usuário-documento é feita tanto no lado do cliente quanto no lado do servidor.

Os principais conceitos usados ao longo da documentação atual são explicados abaixo.

O lado do cliente inclui:

  • Gerenciador de documentos - a lista dos documentos exibida no navegador do usuário onde o usuário pode selecionar o documento necessário e executar algumas ações com ele (dependendo dos direitos fornecidos, o usuário pode abrir o documento para visualizá-lo ou editá-lo, compartilhar o documento com outros usuários).
  • Editor de documentos - a interface de visualização e edição de documentos com todos os recursos de edição de documentos mais conhecidos disponíveis, usada como um meio entre o usuário e o serviço de edição de documentos.

O lado do servidor inclui:

  • Serviço de armazenamento de documentos - o serviço do servidor que armazena todos os documentos disponíveis aos usuários com os direitos de acesso apropriados. Ele fornece os IDs dos documentos e links para esses documentos ao gerenciador de documentos que o usuário vê no navegador.
  • Serviço de edição de documentos - o serviço do servidor que permite executar a visualização e edição de documentos (caso o usuário tenha os direitos apropriados para fazer isso). A interface do editor de documentos é usada para acessar todos os recursos do serviço de edição de documentos.
  • Serviço de comando de documentos - o serviço do servidor que permite executar comandos adicionais com o serviço de edição de documentos.
  • Serviço de conversão de documentos - o serviço do servidor que permite converter o arquivo de documento para o formato Office Open XML apropriado (docx para documentos de texto, xlsx para planilhas e pptx para apresentações) para sua edição ou download.
  • Serviço de criação de documentos - o serviço do servidor que permite criar um documento facilmente sem a necessidade de executar um editor de processamento de documentos.

Observe que o ONLYOFFICE Document Server inclui o editor de documentos, o serviço de edição de documentos, o serviço de comando de documentos, o serviço de conversão de documentos e o serviço de criação de documentos. O gerenciador de documentos e o serviço de armazenamento de documentos estão incluídos no Community Server ou devem ser implementados pelos integradores de software que usam o ONLYOFFICE Document Server em seu próprio servidor.

Habilitando JWT para a integração ONLYOFFICE e WordPress​

Para proteger os documentos contra acesso não autorizado, os editores do ONLYOFFICE usam o JSON Web Token (JWT). O token é adicionado à configuração quando o editor de documentos é inicializado e durante a troca de comandos entre os serviços internos do ONLYOFFICE Docs. A chave secreta é usada para assinar o token web JSON e validar o token na solicitação ao ONLYOFFICE Docs.

A partir do ONLYOFFICE Docs v7.2, o JWT está habilitado por padrão e a chave secreta é gerada automaticamente. Você precisa encontrar sua chave secreta no arquivo de configuração do ONLYOFFICE Docs, então especificar a mesma chave secreta nas configurações do conector.

Passo 1: Encontre sua chave secreta no arquivo de configuração do ONLYOFFICE Docs

  1. Abra o arquivo local.json com qualquer editor de texto disponível.

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

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

    • Para Docker – entre no contêiner do ONLYOFFICE Docs usando o comando docker exec -it <containerID> bash e abra /etc/onlyoffice/documentserver/local.json

      Como alternativa, você pode usar o seguinte comando para encontrar a chave secreta padrão sem abrir o local.json:

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

    O arquivo local.json deve ser parecido com este:

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

  2. O valor true é especificado em três seções. Isso significa que a validação do token está habilitada.

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

  3. A chave secreta gerada automaticamente é especificada em três seções. Você pode substituir o valor secreto padrão pela sua própria chave secreta. A chave secreta deve ser a mesma nas três seções.

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

  4. Se fizer alterações, salve-as e reinicie os serviços para que as alterações de configuração tenham efeito.

    supervisorctl restart all

Passo 2: Especifique a mesma chave secreta nas configurações do conector

Nas configurações do conector, especifique o mesmo segredo no campo Chave secreta e salve as configurações.

Começando a usar o ONLYOFFICE Docs no WordPress​

Visualizando documentos​

Para visualizar todos os documentos, vá para o painel administrativo do WordPress > ONLYOFFICE > Arquivos.

visualizar

Adicionando o bloco ONLYOFFICE​

Para adicionar o bloco ONLYOFFICE para uso futuro:

  1. Abra a janela Criar um post.
  2. Clique no ícone ONLYOFFICE no painel abaixo.

adicionar_bloco

Enviando e incorporando um arquivo​

Para enviar um arquivo para o bloco ONLYOFFICE e incorporá-lo em um novo post:

  1. Abra a janela Criar um post.

  2. Escolha o bloco ONLYOFFICE.

  3. Clique no botão Enviar para enviar um arquivo do seu computador para o bloco ONLYOFFICE
    ou
    Clique no botão Biblioteca de Mídia para selecionar um arquivo da sua biblioteca e enviá-lo para o bloco ONLYOFFICE.

    enviar

    incorporar

O documento será incorporado no post criado.

incorporado

observação

Para saber mais sobre os problemas mais comuns e as formas de resolvê-los, visite nosso guia de solução de problemas.