Back-End

7 dez, 2009

Como instalar e configurar o TinyMCE no Drupal

Publicidade

Hoje veremos como instalar e usar o editor WYSIWYG TinyMCE no Drupal. O TinyMCE é um editor online designado WYSIWYG (What You See Is What You Get), em português “O que você vê é o que você tem”. Com ele é possível editar conteúdo online sem precisar saber HTML,
mas com formatação rica. Ele foi criado pela empresa Moxiecode, e pode
ser baixado livremente no site da empresa em: http://tinymce.moxiecode.com/. Ele funciona independente do Drupal, mas aqui veremos como integrá-lo ao Drupal.

Atualmente existe um módulo para o Drupal que habilita o uso do
TinyMCE para edição de conteúdo. Esse módulo está disponível em: http://drupal.org/project/tinymce

Como diz na página do módulo, ele não instala o TinyMCE em si. É preciso que você baixe, além do módulo para o Drupal, o TinyMCE. Assim, o primeiro passo para a instalação do TinyMCE é ir até a
página do módulo e baixá-lo. Em seguida, vá até a página do TinyMCE e
baixe-o também.
Nesse ponto é importante observar, na página do módulo, qual versão do
TinyMCE ele suporta. No momento em que eu escrevo este tutorial, a
versão suportada é a 2.1.2. Assim, quando for baixar, procure essa
versão.

Com os dois produtos baixados, você deve descompactar o módulo na pasta modules da sua instalação do Drupal. Isso fará com que o módulo esteja disponível para o Drupal. Isso, por si só, não faz com que o TinyMCE esteja funcional. É
necessário também descompactar o TinyMCE na pasta do módulo tinymce.
Assim, a estrutura de diretórios deve ficar semelhante a esta:

Antes

Depois

Isso feito, podemos habilitar o módulo para o nosso site.

Para tanto logue-se como administrador no seu site. Acesse Administrar -> Construção do site -> Módulos e habilite o módulo TinyMCE.

Pronto, o módulo está instalado.

Nesse ponto você não verá o editor ainda pois, no caso do TinyMCE,
você precisa configurar um perfil de usuário que terá acesso a esse
editor. Isso é feito assim para evitar que usuários, sem os privilégios
necessários, acessem o TinyMCE.

Então você deve criar um perfil (não iremos cobrir esse
procedimento) e ir até Administrar -> Gerenciamento de usuários
-> Controle de acesso e dê a permissão “access tinymce” para esse perfil. Obviamente que se o seu usuário pode fazer outras coisas, você deve dar as permissões necessárias.

Isso habilitará o usuário a acessar o TinyMCE, mas precisamos
configurar como o editor será exibido para o usuário. Ao contrário de
outros módulos para o Drupal (como o FCKEditor), o nível de
personalização do TinyMCE é muito grande.

Vamos configurar o TinyMCE. Para isso acesse o seu site e vá em: Administrar -> Configuração do site -> TinyMCE settings

A primeira vez que você acessa essa página lhe será mostrado um
aviso de que ainda não há um perfil, e lhe será dada a oportunidade de
criar um.
Clicando nesse link, você será levado a uma tela onde pode configurar cada parâmetro do TinyMCE.

Vamos dar uma breve olhada nessas opções.

Vamos por partes.

Basic setup

Você vai dar um nome para esse perfil.

Nesse ponto você pode configurar qual perfil de usuário pode
acessar esse conjunto de opções do TinyMCE (pode ser mais de um perfil).

É possível configurar outros itens relacionados ao o usuário.

Visibilidade

Você escolhe em quais páginas o TinyMCE vai ser usado. Ele vem, por
padrão, para ser usado em páginas de conteúdo, comentários e perfil do
usuário.

Buttons and plugins

Como o nome diz, você pode configurar os botões e os plugins de que fará uso.

Editor appearance

Configura as opções de visualização (posicionamento e alinhamento) do editor na tela.

Editor appearance

Aqui você configura como o editor irá tratar o código gerado ou
colado. Você pode habilitar a limpeza e formatação do código, o que é
uma boa opção.

CSS

Por último, é possível configurar os estilos do Editor. Isso impacta
diretamente em como o editor é exibido. Recomendo escolher para o
parâmetro “Editor CSS”, a opção “tinyMCE default”. Isso evita conflitos
entre o CSS do seu site e o Editor.

Pronto. Ao salvar essa tela, o TinyMCE estará configurado para o seu site.

Uma nota importante. Se você tentar acessar, com o primeiro usuário
que você criou para o site, em alguma tela onde o editor deveria aparecer,
ele não aparecerá. Isso acontece porque você precisa atribuir a esse
usuário o mesmo perfil para o qual você configurou o TinyMCE. Isso
feito, estará disponível também para esse usuário.

Dúvidas, sugestões e comentários, por favor deixe abaixo.

*

Publicado originalmente em Drupal Brasil, por Rafael Ferreira da Silva.