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.

  Consulte a página de documentação oficial para saber mais sobre a instalação do ONLYOFFICE Docs.
• WordPress v. 5.7 ou superior
• ONLYOFFICE Connector 2.2.0 for WordPress

Instalando e configurando o pacote de módulo ONLYOFFICE e WordPress

Para começar a usar o ONLYOFFICE Docs com o WordPress, siga estes passos:

1. Baixe o plugin compactado.
2. Navegue até a seção Plugins no painel administrativo do seu WordPress..
3. Clique em Adicionar Novo no topo da página.
4. Clique em Enviar Plugin no topo da página.
5. Clique em Escolher Arquivo e selecione o plugin compactado baixado.
6. Assim que o plugin estiver instalado, clique em Ativar.

Se preferir, você pode clonar o branch master (e então ativar o plugin do painel administrativo do WordPress também):

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

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.
     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.
     A partir do ONLYOFFICE Docs v7.2, o JWT está habilitado por padrão e a chave secreta é gerada automaticamente. Você precisa habilitá-la 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.
     

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 gerenciamento 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 construção de documentos - - o serviço do servidor que permite construir um documento facilmente sem a necessidade de executar realmente um editor de processamento de documentos.

Por favor, note que o ONLYOFFICE Document Server inclui o editor de documentos, serviço de edição de documentos , serviço de comando de documentos, serviço de conversão de documentos e serviço de construçã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 documentos de acesso não autorizado, os editores ONLYOFFICE usam o JSON Web Token (JWT). O token é adicionado na 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 JSON web token e validar o token mediante 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 e 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 ONLYOFFICE Docs usando o comando docker exec -it <containerID> bash e abra /etc/onlyoffice/documentserver/local.json

     Se preferir, 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 ter essa aparência:

   {"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 de 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 com 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 você fizer alterações, salve-as e reinicie os serviços para que as mudanças 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.