Como instalar e configurar o TinyMCE no Drupal

Nesse tutorial 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 é possivel 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 o mesmo não instala o TinyMCE em sí, então é 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 esse 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 essa:

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 (esse tutorial não irá 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 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 o 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 plugins 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 exitor é 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, 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.