Manual

Drupal é uma ferramenta incrível. É possível fazer desde sites enormes, com comércio eletrônico, até pequenos blogs. Mas para desvendá-lo por completo, talvez seja preciso de uma ajudinha extra.

Este manual é feito pelos membros do site, usuários novatos ou experientes administradores do Drupal, tradutores e até desenvolvedores de módulos. Qualquer um que seja cadastrado no Drupal-br.org pode editar este manual. Se você deseja colaborar, faça o login ou cadastre-se e comece agora mesmo.

Antes de começar

Participar da comunidade Drupal Brasil é um direito de todos. Para tanto, existe o manual, indexado abaixo, e os fóruns. Nos fóruns algumas regras devem ser observadas e seguidas para melhor funcionamento, aproveitamento e respeito aos colegas que ajudam respondendo suas perguntas.

Não deixe de ler esse guia de como fazer perguntas no Drupal Brasil e seja bem vindo!

Cada página deste manual pode ser usada de acordo com a licença Attribution-Noncommercial-Share Alike 2.5.

Sobre o Drupal

O Drupal é uma plataforma de site dinâmica que permite a usuários individuais ou comunidades publicar, gerenciar e organizar uma grande variedade de conteúdo. O Drupal integra muitos dos recursos populares de sistemas gerenciadores de conteúdo, blogs, ferramentas colaborativas e software de comunidades baseada em discussões em um único pacote fácil de usar. Como um projeto de código aberto mantido e desenvolvido por uma comunidade, o Drupal é livre e grátis para download e uso. Se você gostar do que aprender aqui, por favor trabalhe conosco para expandir e refinar o Drupal para servir às suas necessidades.

Uma grande variedade configurações de sites

Habilitando e configurando módulos distintos, um administrador pode desenvolver um site único, que pode ser usado para uma combinação de gestão de conhecimento, publicação na web ou interação de comunidades. Para que você entenda melhor essas muitas possibilidades, a seguinte lista de funções foi organizada com características comuns da web:

Para uma lista de recursos mais detalhada, dê uma olhada na nossa lista de recursos. Para exemplos de possíveis implementações de veja os sites no estudos de caso com Drupal ou visite alguns dos muitos sites que usam o Drupal.

Requisitos básicos para instalação e configuração inicial

A plataforma básica do drupal, módulos adicionas e muitos temas estão livrementes disponíveis para download sob a GNU GPL. O Drupal, escrito em PHP e usando tanto MySQL quanto PostgreSQL como banco de dados no backend, pode rodar em muitas plataformas, incluíndo os servidores Web, Apache ou IIS da Microsoft. Informações mais completas e instruções específicas sobre os requisitos de sistema, instalação e configuração estão disponíveis no guia do administrador.

A comunidade Drupal: desenvolvimento e suporte

Como um setor de comunicação e espaço para gerenciamento do projeto, o drupal.org inclui membros que usam o Drupal como uma solução para site pessoal; profissionais de TI implementando o Drupal para clientes; e programadores, escritores e outros, contribuindo para o crescimento do Drupal como um projeto de código aberto. Membros trabalham juntos para manter um desenvolvimento extensivo e suporte no site:

Saiba mais

Veja os links abaixo e outras seções do Manual do Drupal, e muitas discussões nos fóruns para mais informações.

Missão

Construindo sobre padrões e tecnologias de código aberto, o Drupal suporta e aprimora o potencial da Internet como um meio onde indivíduos diversos e geograficamente separados podem, coletivamente, produzir, discutir e compartilhar informações e idéias. Com um interesse central e foco em comunidades e colaboração, a flexiblidade do Drupal permite a produção colaborativa de sistemas de informação e comunidades.

Princípios

  • Modular e extensível. O Drupal tem por objetivo prover um núcleo leve e poderoso que suporte ser extendido através de módulos personalizados.
  • Qualidade de codificação. Alta qualidade, elegância e código documentado é uma prioridade sobre funcionalidades desordenadas.
  • Baseado em padrões. O Drupal suporta padrões consolidados e emergentes. Padrões específicos incluem XHTML e CSS.
  • Demanda de poucos recursos Para garantir excelente performance, o Drupal preza pelo código resumido(por exemplo, minimizando o uso de consultas a bancos). O Drupal também deve requerer o mínimo de software no lado do servidor, fazendo uso dos largamente utilizados. Especificamente, o Drupal deve funcionar corretamente em um servidor com Apache, PHP e tanto MySQL como PostgreSQL.
  • Código aberto O Drupal é baseado na filosofia de colaboração de sotware livre através do código aberto, bem como é liberado sob a licensa GPL. O Drupal em si é código aberto e construído e suportado sob outros projetos de código aberto. Especificamente o Drupal é codificado na liguagem de código aberto PHP e tem como formato primário de fonte de dados os bancos de dados de código aberto MySQL e PostgreSQL.
  • Facilidade de uso. O Drupal tem por objetivo uma alta qualidade da usabilidade para desenvolvedores, administradores e usuários.
  • Colaboração. O desenvolvimento do Drupal se baseia no compartilhamento de informação de forma aberta.

Alvos da usabilidade

Para os desenvolvedores o Drupal objetiva um sistema de desenvolvimento que seja:

  • Bem equipado com um sistema de "ganchos" que permita entendimento instantâneo para abranger a maioria dos objetivos de codificação previstos que involvam interações com os elementos do núcleo

Para os administradores o Drupal objetiva produzir soluções que sejam:

  • Facil de instalar e configurar, de forma que seja mínimo o conhecimento técnico específico.
  • Intuitivo e auto-explicativo, de forma que os administradores possam facilmente encontrar as opções de configuração que precisam.
  • Altamente configurável, de forma que os administradores possam exibir a interface que eles desejam.

Para os usuários, todos os elementos da interface de usuário devem ser:

  • Intuitivo e auto-explicativo de forma que os usuários, com o mínimo de experiência prévia, possam facilmente descobrir, navegar e usar as funcionalidades
  • Organizado de tal forma que os usuários não tenha dificuldades de identificar o essêncial do não essêncial.

Druplicon (o logo)

Depois que o drupal foi criado, uma questão óbvia foi a escolha e criação de um logo. Claro que deveria ser algo relacionado a uma gota... ou água.

A idéia inicial era simples: uma gota num círculo. Ficou caracterizado como um "O" em uma "gota" liquefeita.

Quando a comunidade cresceu, a idéia veio como de uma gota com rosto. Steven Wittens (UnConeD) criou uma gota 3D, mas a idéia não foi muito longe porque 3D é complicado de imprimir, difícil de editar, etc.

Quando a questão do logo voltou a tona novamente, Kristjan Jansen (Kika) veio com a idéia de colocar duas gotas lado-a-lado para formar o símbolo do infinito. Quando colocado dentro de um círculo preenchido lembraria um rosto. Depois de algum trabalho de Steven Wittens, o Druplicon foi criado: uma gota estilizada com olhos infinitos, um nariz arredondado e um sorriso travesso.

Essa é a 'história' por trás do logo... Eu gosto da idéia de que os olhos infinitos simbolizam as infinitas possibilidades que o Drupal oferece.

Veja mais versões do logo na seção de marketing

História

Em 2000, conexões permanentes com a internet eram raras entre os estudantes da Universidade da Antuérpia, então Dries Buytaert e Hans Snijder configuraram uma pequena rede sem fio entre seus quartos, para compartilhar a conexão do modem ADSL de Hans entre oito estudantes. Ao passo que essa situação era um luxo para a época, faltava algo. Não haviam meios de discutir ou compartilhar coisas simples.

Isso inspirou Dries a trabalhar em um pequeno site de notícias com um quadro de avisos, permitindo o grupo de amigos a deixar, uns para os outros, notas sobre o estado da rede, para anunciar onde eles iriam jantar, ou para compartilhar outras coisas sem importância.

O software não teve um nome até o dia em que Dries terminou a graduação. O grupo decidiu então por online o site para que eles pudessem manter contato, e compartilhar seus interessantes achados além de narrar pedaços da sua vida pessoal. Enquanto procuravam por um nome, Dries registrou o domínio 'drop.org' depois de digitar errôneamente o domínio 'dorp.org' na tentativa de verificar se esse domínio estava disponível. Dorp é uma palavra germânica para 'vila', considerado um nome apropriado para uma pequena comunidade.

Uma vez na Web, o público do drop.org mudou após os membros começarem a conversar sobre novas tecnologias para web como moderaçao, divulgação de feeds, pontuação para artigos e autenticação distribuída. O Drop.org lentamente se tornou em um ambiente de experimentação pessoal, guiado pela discussão e fluxo de idéias. As discussões sobre essas tecnologias web foram implantadas e testadas no drop.org como novas adições ao software que rodava no site.

So depois, em Janeiro de 2001, Dries decidiu lançar o software por trás do drop.org como o "Drupal". O fator motivador era possibilitar outros usuários a extender a plataforma de experimentação, de forma que mais pessoas pudessem explorar os novos caminhos para o desenvolvimento. O nome Drupal, pronunciado "droo-puhl", é derivada da forma inglesa da pronúncia da palavra germânica "druppel" que significa "drop"(gota em português).

Para saber mais sobre a história do Drupal, veja também os vídeos do DrupalIcon 2006 em Vancouver

Sobre o Drupal Brasil

O Drupal Brasil é o site da comunidade brasileira de usuários de Drupal. Ele foi criado em 11 de janeiro de 2005 por Rafael Silva para ser um site ajuda e divulgação do Drupal no Brasil.

O Drupal Brasil começou como todo site, pequeno, devagar e com poucos usuários. No começo éramos apenas um pequeno fórum, meio sem forma e sem foco. Com a ajuda de diversos usuários fomos tomando forma. Muitos usuários que participaram ativamente do inicio do site já não são mais usuários ativos, e muitos outros agora fazem parte da comunidade.

De lá para cá o Drupal cresceu e mudou bastante e o mesmo aconteceu com o Drupal Brasil. Hoje somos uma das maiores fontes de conteúdo sobre Drupal em língua portuguesa, se não a maior.

O foco principal do Drupal Brasil é dar suporte aos desenvolvedores e usuários falantes da língua portuguesa. O nosso foco principal não é desenvolver novos temas, ou mesmo módulos (ainda que eventualmente o façamos) mas sim ajudar usuários a fazer isso. Existimos para ser uma fonte de suporte e um repositório de conhecimento em português.

A comunidade é formada por uma grande variedade de usuários. Somos analistas de sistemas, donos de lojas, designers, arquitetos, artistas e uma grande infinidade de profissões. Essa diversidade traz algumas complicações, mas ao mesmo tempo traz muitas outras vantagens. Tentamos lidar com essas diferenças e ajudar a todos.

O Drupal Brasil é mantido por voluntários, e como tal, todo trabalho aqui é feito no tempo vago (ou dedicado para isso) por seus usuários. Essa é uma característica muito comum em comunidades de software livre (que é uma das características do Drupal).

Atualmente somos um conjunto de 6 moderadores que ajudam a manter as coisas organizadas. Não há restrição para que outros moderadores sejam adicionados a esse time, mas como em toda comunidade de software livre esse processo se dá por mérito, onde o trabalho realizado na comunidade é que baliza a pessoa para ser convidada a esse grupo. Abaixo segue a lista (em ordem alfabética) de moderadores, caso você precise da ajuda de algum deles:

Guia do usuário

Projetado para usuários de sites que usam Drupal, esse guia não-técnico oferece uma opção de início rápido, instruções e sugestões.

Conceitos básicos

O que é um "gerenciador de conteúdo"?

O Drupal é um "sistema de gerenciamento de conteúdo". Isso significa que ele é um sistema para gerenciar conteúdo de sites, como artigos, fotos, ou arquivos. O Drupal é um sistema "dinâmico" e não "estático. Ao invés de ter arquivos gerados anteriormente(estáticos), o conteúdo como os textos das páginas são gravados em um banco de dados. Quando os visitantes pedem uma página, um script roda no servidor, pesquisando no banco de dados e imprimindo o conteúdo em um modelo. (Algumas vezes, para ganhar tempo e recursos, esses scripts estão rodando um pouco adiantado e as paginas resultantes são gravadas em cache ou no servidor ao invés de serem geradas no momento em que o visitante requisita).

Então, para criar ou editar páginas, você, como um usuário não tem que escrever páginas para internet. Você não precisa saber HTML (a linguagem na qual a internet é escrita). Ao invés, tudo o que você irá precisar fazer, normalmente é:

  • se registrar como um usuário do Drupal
  • se conectar (digite o nome de usuário e senha que você obteve se registrando), e
  • digite o conteúdo (artigos, etc) nos formuários apropriados e envie.

Esse guia do usuário irá explicar todos os passos e outras informações de apoio.

Das variações e dos módulos

O Drupal não é um único tipo de site, mas vários.

  • O Drupal é altamente configurável, então o administrador de um site pode ligar e desligar diferentes recursos e fazer várias configurações que mudam a aparência e a funcionalidade de um site.
  • O Drupal tem um sistema de privilégios que faz com que sejapossível criar diferente tipos de usuarios. Por exemplo, membros, equipe, parceiros, etc onde cada um pode ver um tipo diferente de coisa no site.
  • O Drupal é projetado para ser facilmente extendido atráves de "módulos" - blocos de código que provêm funcionalidade extra ou aprimoramentos. Alguns módulos vêm com toda instalação do Drupal (módulos "padrão), enquanto outros podem ser baixados individualmente atráves do site do Drupal e instalados separadamente (módulos "contribuídos").
  • O visual básico do Drupal pode ser alterado atráves de diferentes "temas". Tal qual os módulos eles podem ser padrões ou contribuídos.

Tudo isso significa que o que você pode ver em um site feito com o Drupal, e tudo o que você pode fazer alí, depende do que o(s) administradore(s) escolheram apresentar. Então nós não podemos lhe dar aqui um gua definitivo! Ao invés, esse guia de usuário irá introduzri alguns das mais comuns opções e funcionalidades. Para mais informações focadas, você pode ver o guia do administrador e os fórums do Drupal.

Blocks

Blocks são lugares no Drupal onde é possível adicionar conteúdos, quando criamos um novo menu ou um conteúdo especifico, esse conteúdo não é exibido automaticamente no site, precisamos definir uma região onde essas informações serão exibidas.

Os Blocks são definidos por temas, geralmente são disponibilizadas 5 posições para inserção dos Blocks, são elas: left sidebar, right sidebar, content, header e footer.

Definido um conteúdo em um Block

1. Navegue para Administer > Site building > Blocks
2. Procure pelo conteúdo que você deseja
3. Escolha na combo a posição do conteúdo left sidebar, right sidebar, content, header ou footer.
4. Clique no botão Save blocks

Core Drupal

O Core do Drupal é responsável por fornecer funcionalidades básicas que serão utilizadas para apoiar outras funcionalidades do sistema. Uma framework leve faz o núcleo do Drupal funcionar e interagir com os outros itens.

O núcleo do Drupal possui o código que permite iniciar um pedido e as seguintes funcionalidades:

* Biblioteca de funções comuns;
* Login;
* Gestão de temas;
* Localização;
* URL Aliasing;
* Gerenciador de sessão;
* Gerenciador de usuário;
* Gerenciador básico de conteúdo.

Essas são as funcionalidades do núcleo do Drupal, podemos estender o poder do Drupal com a inserção de diversos outros módulos. Esses módulos trabalharão em conjunto com o Core, gerando mais poder e funcionalidade para o Drupal.

Hooks (Ganchos)

Permite que os módulos interajam com o núcleo do Drupal.

O módulo de sistema do Drupal é baseado no conceito de “hooks”. Hook é uma função PHP, por exemplo nomeada foo_bar(), onde “foo” é o nome do módulo (sendo o nome do arquivo foo.module) e “bar” é o nome do hook. Cada hook tem um tipo definido de parâmetros e tipos de resultado específicos.

A ideia principal dos hooks é permitir que os módulos do sistema interajam entre si.

Layout de Arquivos e Diretórios do Drupal

O sistema de arquivos e diretórios do Drupal é composto da seguinte forma:

FILES não existe por padrão na instalação do Drupal, mas se for necessário inserir logo personalizada, habilitar a inserção de avatars pelos usuários ou upload de algum tipo de arquivo, será necessário criar esse diretório com as permissões de escrita e leitura.

INCLUDES contém as bibliotecas e funções que o Drupal usa.

MISC guarda os arquivos JavaScript, ícones e imagens da instalação padrão do Drupal.

MODULES contém o núcleo dos módulos, cada módulo está no seu próprio diretório. É recomendável não mexer nos arquivos desses diretórios, os módulos adicionais são inseridos no diretório SITES na raiz.

PROFILES contém diferentes perfils de instalação para o site.

SCRIPTS contém scripts para checar sintaxe, limpeza de código e manipulação em casos especiais com o cron. Esses arquivos não são usados durante o ciclo de requisições da vida do Drupal, são usados no shell e scripts utilitários Perl.

SITES contém as modificações feitas no Drupal em formulários de configuração, módulos e temas. Quando você adiciona módulos no Drupal do repositório de contribuições ou escreve o seu próprio módulo, eles vão para SITES/ALL/MODULES. Todos esses sustentos de modificações no Drupal vão para dentro de um único diretório.

THEMES contém os arquivos de tema do Drupal.

O que é um node?

Uma das coisas mais importantes para quem está entrando no mundo do Drupal é se adaptar aos novos conceitos gerados por ele, tais como taxonomia e node.

Mas afinal, o que é node?

Node é uma palavra que teve origem na segunda metade do século XVI (1565–75; < L nōdus knot), de origem inglesa, significa basicamente nó. Isso mesmo, um nó.

Nó no sentido de ser um ponto único, porém, acessível de vários outros lugares, como os nós da malha de uma rede. Não confundir com "nó", no sentido figurado de problema, coisa de difícil solução... @:)

Entretanto, particularmente, prefiro manter a expressão original em inglês, node, ao invés de nó, mas, podemos utilizar tanto uma quanto a outra (dispensando a tradução corretíssima de nodo do latim nodus como sinônimo de nódulo, mais utilizado em termos anatômicos.

Pois bem, para o Drupal, node é uma unidade mínima de conteúdo tal como uma página, uma notícia, um comentário dentro de cada uma dessas páginas ou ainda, se você já tiver mexido com CCK ou tiver instalado algum outro módulo que permita que sejam criados nodes de diferentes tipos, um node pode ser uma pequena unidade única de informação tal como uma imagem, um vídeo, um link ou ainda um trecho de código CSS, HTML ou PHP.

Resumindo, no Drupal, node é uma unidade mínima de conteúdo.

Cada vez que inserimos um conteúdo em um sítio elaborado com Drupal, (seja ele de qualquer tipo), o sistema gera um node, e este recebe um número único e exclusivo, chamado de (Nid, ou Node ID ou número do node), que permite que cada node seja diferenciado dos demais, mesmo que eles pertençam ao mesmo tipo de conteúdo.

A um node podemos ainda realizar diferentes tarefas, dependendo das configurações de seu sistema, tais como:

  • anexar um arquivo a ele;
  • criar comentários associados a ele, além de ter todas as configurações que serão aplicadas somente ao node em questão;
  • setar o status de publicado, não publicado, destacado no alto da página ou ainda criar uma revisão;
  • criar conteúdo com suporte multi-idioma
  • se o módulo de eventos estiver instalado e ativo, é possível inserir este node em um calendário;
  • entre muitas outras coisas, dependendo dos módulos instalados e das configurações iniciais do tipo de conteúdo

Enfim, este conceito básico do Drupal serve para quase qualquer conversa sobre o sistema, já que tudo é baseado no node. Vejamos por exemplo a Comunidade oficial do Drupal, sempre que precisamos procurar algo, somos referenciados ao conteúdo através de um número, que é o número do node.

Espero ter deixado um pouco claro este conceito e comentários são sempre bem-vindos visando enriquecer, cada vez mais, a comunidade brasileira de Drupal!

Taxono o quê?

Taxonomia!

Do Grego verbo τασσεῖν ou tassein = "para classificar" e νόμος ou nomos = lei, ciência, administrar.

Como minha formação acadêmica é na área das ciências biológicas (Biologia Marinha) e também como atuei na área de taxonomia sistemática, estava acostumado com o termo taxonomia, pois biologia sem classificação não funciona. Precisamos identificar e classificar os animais, plantas, pedras, fungos, etc...

Mas só serve para a Biologia?

Não. Ela serve para classificarmos qualquer coisa!

O ser humano tem uma necessidade de organização. Nosso cérebro funciona assim e isso nos ajuda a sermos mais, digamos, práticos e eficientes... E porque não dizer felizes.

Salvo os paranóicos de plantão, que ordenam as camisetas, meias e cuecas em escala de cor descrescente, das mais escuras para as mais claras...

Esses não sabem aproveitar a taxonomia para serem mais felizes e precisam visitar um psicólogo! @:P

Brincadeira!

Bem, o Drupal, semântico como ele, decidiu e arriscou ao utilizar uma palavra difícil, pouco usual, para nomear um de seus mais poderosos e importantes recursos: A TAXONOMIA!

Para o Drupal a taxonomia é separada em vocabulários. Isso permite que possamos ter várias classificações diferentes para o mesmo tipo de conteúdo ou node.

Para exemplificar, vamos tentar classificar frutas.

Digamos que já tenhamos criado um tipo de conteúdo (opa, coisas novas aqui... Em breve um texto explicando o que é Tipo de Conteúdo e como funcionam) chamado "fruta", que insere um node desse tipo no sistema.

Como sabemos existem centenas (senão milhares) de tipos de frutas diferentes e cada um de nós tem as suas preferências, mas é inievitável nosso contato com elas!

Podemos começar com a irresistível banana e ir até as "frutas básicas" como maçã, mamão e pera, sem deixar de mencionar as exóticas Kiwi e melancias quadradas japonesas! Melancias quadradas!!! Onde vamos parar? @:|

Porém, nossos nodes são criados no sistema e ficam espalhados, ao "léu" e sem nenhuma forma de ordenação. Agora é a exata que precisamos usar a Taxonomia.

Vamos classificar essas frutas já!!!

No Drupal podemos criar vários vocabulários (nome dado ao conjunto de termos que irá classificar um conjunto de nodes). Estes vocabulários podem abrigar vários termos.

Termos são as palavras que classificam o conteúdo.

Por exemplo, podemos querer classificar as frutas pelo seu tipo de sementes.

Criamos um vocabulário chamado Semente e colocamos as seguintes opções: Interna e Externa.

Para criar um novo vocabulário, fazemos:

  1. Após estar logado como usuário com permissões de criar vocabulários, visitar: /admin/content/taxonomy/add/vocabulary
  2. Digitar um nome para o vocabulário;
  3. Inserir uma descrição (no nosso caso: Classificação da semente em interna/externa);
  4. Texto de ajuda (para instruir o usuário que criará o node como proceder para selecionar os termos;
  5. Selecionar o(s) tipo(s) de conteúdo que serão classificados por este vocabulário;
  6. Selecionar o tipo de vocabulário a ser utilizado:
    1. Tags (Os termos são inseridos na hora de criar o node. O sistema faz uma verificação via Ajax nos termos já inseridos e sugere termos próximos conforme se digita);
    2. Seleção Múltipla (Oferece uma lista de termos pré-definidos que podem ser selecionados. A diferença desse para as tags é que este não permite a criação de novos termos, apenas permite escolher um (ou mais do que um) dos termos já existentes;
    3. Requerido (Torna obrigatório o preenchimento do campo taxonomia no ato da criação do node);
  7. Selecionar o peso, que é a ordem em que os vocabulários aparecerão na hora de criar os nodes, isso se houver mais do que um vocabulário ativado para o tipo de conteúdo.

NOTA: Caso nenhum dos dois primeiros itens for selecionado o vocabulário entra com o seu funcionamento padrão que é mostrar uma lista de termos onde pode ser escolhido apenas 1.

Lembrem-se, nosso vocabulário fictício é um vocabulário normal (não permitimos a criação de novos termos e não podem ser selecionados mútiplos termos), portanto, adicionamos os termos Semente externa e Semente interna neste vocabulário e aí podemos classificar nossas frutas!

Ok, mas como inserimos novos termos em um vocabulário?

Para criar um novo termo, temos que:

  1. Após estar logado como usuário com permissões de criar vocabulários, visitar: /admin/content/taxonomy/1/add/term (onde 1 é o VID - vocabulary ID ou o ID do vocabulário);
  2. Digitar o nome do termo;
  3. Digitar uma descrição para o termo (serve para tentar melhorar a escolha, evitando dúvidas na hora de escolher);

Caso seu termo não tenha nem sinônimos nem seja um "subtermo" (termo ligado diretamente a outro termo, como por exemplo: Casca > mole ou dura), é só clicar em Salvar.

Porém, vamos detalhar um pouco melhor estas opções:

Superiores: Caso o termo criado seja um subtermo. Em qual item principal ele se encaixa?
Termos relacionados: Serve para colocar termos parecidos juntos. Usa o padrão de seleção "AND" (Termo X E Termo Y).
Sinônimos: Serve para colocar termos parecidos, juntos. Usa o padrão de seleção "OR" (Termo X OU Termo Y).
Peso: Determina a ordem em que os termos serão exibidos.

Agora que já sabemos criar um vocabulário, selecionar o tipo de comportamento dele e já criamos os termos, vamos Voltar às nossas futas, e começar a classificá-las sem parar! Vamos começar com a classificação das frutas em relação às suas sementes.

Podemos então editar, por exemplo, o node "cajú" e no espaço reservado para o vocabulário irá aparecer uma caixa de seleção: Semente externa, Semente interna. Basta selecionar Semente externa e pronto, a classificação começou. @:)

Agora você não vai resistir e não vai conseguir deixar de usar mais e mais vocabulários para classificar suas frutas.

E as possibilidades são "infinitas" para as classificações...

Podemos classificar, por exemplo, as frutas baseadas pelo seu sabor: amargas, doces, salgadas ou ainda ácidas/azedas.

Note que neste caso podemos usar a Opção avançada sinônimo para unir as frutas de sabor os sabores ácido e azedo em um só grupo. Isso significa que, para gerar uma listagem de nodes com estes termos (ácidos ou azedos), TANTO FAZ selecionar um ou o outro, já que são sinônimos.

Quer ir mais longe?

Podemos classificar ainda:

  • Vocabulário para classificar as frutas em relação ao seu formato;
  • Vocabulário para classificar as frutas em relação ao local de origem;
  • Vocabulário para classificar as frutas em relação ao tipo de local de crescimento;
  • .
  • .
  • .

Classifique seus nodes e torne seu website mais organizado!

Não se esqueça de que há vocabulários que podem ser utilizados para vários tipos de conteúdo. Portanto, digamos que além das frutas comecemos a criar nodes do tipo "Legumes" e ainda "Verduras". O vocabulário sabores, por exemplo, poderá ser utilizado para ambos!

Planeje-se e organize seus nodes!

Registrando e conectando

A seguir...

Alterando suas configurações de conta

A seguir...

Dica: sobre permissões em nodes

Olá pessoal,

Estava eu tentando dar permissões de edição de nodes (conteúdo do site) para um novo grupo de usuários, ou papel de usuários (admin/user/roles).

Após fazer os devidos ajustes em Permissões (admin/user/permissions) descobri que os usuários não podiam fazer alterações em alguns nodes...

Depois de muito quebrar a cabeça tive a brilhante idéia de visitar os filtros para publicação de conteúdos, ou formatos de entrada (admin/settings/filters)e vi que o filtro Full HTML (que havia sido criado antes do papel de usuários em questão) não tinha nenhum papel de usuários associado a ele. Foi só configurar isso e pronto!

Espero que isso seja de ajuda para alguém mais. De qualquer maneira fica registrado para consultas futuras (inclusive as minhas, hehehe)

;-)

Criando conteúdo novo

A seguir...

Editando e removendo conteúdo

A seguir...

Guia de melhores práticas do Drupal - Parte I

Esse é o primeiro de uma série sobre melhores práticas do Drupal originalmente enviados no meu site

Início

Geralmente quando vamos desenvolver com base em algum framework ou CMS já existente, existe algum manual ou recomendações de melhores práticas para esse desenvolvimento. Com o Drupal não é diferente. Existe um guia de melhores práticas no site do Drupal, e ele vai servir de base para esse texto.

Planeje antes de começar!

Quando vamos desenvolver algum projeto, seja um site, seja a construção de uma casa, antes, precisamos planejar. Sem planejamento, muitas vezes, acabamos deixando passar algo e na hora de implementar, dá aquela dor de cabeça.

É na hora do planejamento que vemos se aquela funcionalidade vai conflitar com outra, ou se aquele item que consideramos visualmente bonito vai caber dentro do contexto. Gaste um bom tempo (mas não todo o tempo) planejando o que você vai fazer.

O Drupal possui uma gama enorme de módulos que podem ser combinados para fazer o seu trabalho mais fácil, então veja se você não está reinventando a roda, e pense em usar alguns desses módulos também.

Esteja pronto para mudanças

O Drupal, bem como boa parte dos projetos Open Source, é muito dinâmico e de tempos em tempos há novas atualizações. Algumas são atualizações de segurança, outras nova versões com várias novas funcionalidades.

Temos sempre a mania de querer o mais novo e com os mais lindos recursos na hora que eles saem. Esteja pronto para mudanças, mas seja moderado ao fazê-las. Como o Drupal tem muitos módulos de terceiros que, eventualmente, você vai acabar usando esteja certo de que eles já são compativeis com a versão mais nova do Drupal, antes de decidir atualizar o Drupal do seu site.

Um site que esteja maduro e bem construído, não precisará de novas atualizações quando elas saem. Mas esteja pronto para a evolução. Um prazo que se recomenda para fazer essa atualização é de 12 a 24 meses.

Um ponto importante são as atualizações de segurança. Essas devem ser aplicadas sempre que saírem(desde que sejam indicadas para o seu caso, é bom lembrar), pois não impactam (geralmente) no funcionamento, mas na segurança.

Se envolva com a comunidade

O Drupal é um software Open Source e que trabalha com o modelo de comunidade. Quando você usa o Drupal você se torna parte da comunidade. Você pode ser um membro atuante ou não, isso vai depender do seu perfil e interesse. No entanto, a recomendação é que você esteja sempre em contato com a comunidade.

Um dos princípios do Software Livre é a possibilidade de retornar algo que você melhorou. Isso é importante para o projeto, uma vez que você pode ajudá-lo a se tornar mais forte e pode ser importante pra você, dependendo do seu interesse na comunidade. Se você fez algo que pode ser devolvido à comunidade, devolva! O Drupal e os módulos de terceiros que você está usando, foram devolvidos para a comunidade em algum tempo, então que tal fazer o mesmo?

Ser um membro ativo também nos possibilita estar à par do estado do projeto e como ele irá evoluir. Isso também nos ajuda a nos planejar para as atualizações que virão. Em alguns casos você inclusive pode participar dessa decisão.

Faça backups

Uma coisa que muita gente esquece, mas que é fundamental: backup! Vez ou outra enfrentamos problemas que podem acabar afetando o nosso site e/ou sistema. Pode ser um problema físico em um dos servidores, uma empresa que deixa de prestar serviços e vários outros problemas. Ter um backup é de suma importância.

Ter um backup não significa, no entanto, que o mesmo esteja funcionando. Teste, de tempos em tempos, os seus backups. Veja se tudo está sendo feito da forma correta. Se em um momento você precisar restaurar um backup e ele não estiver funcionando, será o mesmo que nunca ter feito um.

Teste seu código

O Drupal é uma ferramenta extremamente flexivel, e assim você pode fazer muitas coisas com ela. Mas, no calor do desenvolvimento, às vezes deixamos passar alguma coisa, que pode estragar o nosso trabalho.

Teste exaustivamente o seu código. Seja um módulo, um bloco, um tema. Teste tudo muito bem antes de aplicar a mudança. Testes são muito importantes.

Um ponto que merece maior destaque são os blocos do Drupal. Se um bloco estiver com erro, o site inteiro pode parar de funcionar. Uma forma simples de testar o código antes de colá-lo para funcionar dentro de um bloco, é criar uma página, definir o "Formato de entrada" como sendo PHP e alí testar o seu código. Se tudo der certo, então você poderá usá-lo no seu bloco.

Fim da parte I

Chegamos ao fim dessa primeira parte. Em breve vou postar aqui uma nova parte desse artigo, falando mais sobre outras boas práticas para o desenvolvimento com o Drupal.

Se você quiser ir se adiantando, basta dar uma olhada na página do manual que estou me baseando.

Até breve!

Guia de melhores práticas do Drupal - Parte II

Esse artigo é a continuação de um outro, escrito há alguns dias atrás.

Recomendo que você leia também o primeiro artigo, uma vez que eles se complementam.

Então vamos lá!

Não modifique o core do Drupal

Essa é uma recomendação muito comum mas geralmente não é ouvida pelos novatos.

Como o Drupal é um projeto mantido por uma comunidade muito ativa, sempre há alterações e correções no seu código base. Ao alterar o core do Drupal você pode acabar tornando sua instalação insegura. Além disso você irá tornar, automaticamente, seu código incopatível com os novos releases do Drupal, o que, automaticamente irá fazer com que você fique sem poder atualizar quando sair uma correção.

Suponhamos que você criou um projeto, alterou o core do Drupal mas agora outra pessoa vai dar manutenção nesse projeto. Se você, por acaso, esqueceu de avisar das alterações, isso pode tornar a manutenção muito penosa.

Uma excessão é quando você está corrigindo um bug, ou fazendo uma melhoria, e espera devolver isso para a comunidade. Obviamente você terá que rastrear e ver se o patch que você enviou será incorporado ao próximo release do Drupal. Se isso não acontecer você terá que manter isso de qualquer forma. Por isso nunca é recomendável se fazer esse tipo de alteração em sites que irão para produção.

Segurança

Segurança é importante. Quando você vai manter um site no ar, é importantíssimo se manter atualizado. O Drupal dispõe de uma newsletter onde todo aviso de correções de segurança são enviados. Quem mantém um site com Drupal deve estar atento a essa lista, de preferência assinando a newsletter ou sempre atento à divulgação na página de avisos de segurança.

Testes

Antes de colocar um projeto online, é de suma importância fazer testes. Os testes ajudam a encontrar problemas e evitam colocar um site com falhas críticas online.

Existem várias ferramentas que podem ser usadas para criar um ambiente local para testes. O XAMMP e o MAMP são as ferramentas mais comuns.

Toda vez que você for instalar um módulo novo, fazer atualizações e/ou correções no seu site, procure fazê-lo localmente. Baixe uma versão igual a que está no seu servidor de produção, e faça os testes. Se tudo correr sem problemas é sinal de que você pode por no ar.

Alguns pontos importantes a serem observados:

  • Nunca desenvolva ou teste no ambiente de produção. O Drupal é fácil de instalar localmente, não compensa o risco;
  • Teste os seus backups com regularidade em um ambiente diferente. Isso assegura que seus backups estão funcionando e você não é pego de surpresa sem saber como restaurar um backup.
  • Teste toda atualização localmente. Evite por seu site em risco.

Gestão de arquivos e pastas

O Drupal contém vários arquivos e pastas sob uma determinada estrutura. Essa estrutura existe para facilitar o nosso entendimento e trabalho.

Ao criar um site simples (não-multisite) você deve criar uma estrutura dentro da pasta sites/all para os seus módulos e temas. Essa estrutura visa facilitar a atualização futura do seu site, uma vez que você só precisará fazer backup do que estiver dentro da pasta sites (e, obviamente, do banco de dados). Essa estrutura é composta de duas pastas: modules e themes. Asssim, a estrutura final ficaria: sites/all/modules e sites/all/themes.

Em sites múltiplos (multisites) você deve posicionar os módulos e temas específicos dentro da pasta de cada site. Assim, se você tem um site chamado www.example.com você irá criar: sites/www.example.com/modules e sites/www.example.com/themes

Se você desejar pode renomear o arquivo update.php no entanto, ele já contém proteções para evitar abuso. Também, se você quiser, poderá remover o arquivo install.php uma vez que ele só é necessário na instalação do site.

É uma boa prática deixar o arquivo CHANGELOG.txt (ainda que com outro nome), para que você se lembre qual versão está aquele site (ou conjunto de sites). Quem administra muitos sites pode acabar se esquecendo e não fazendo a atualização.

Por último, ao construir um tema ou módulo, evite espaços nos nomes. Isso pode causar problemas em sistemas opreracionais não-windows.

Conclusão

Com esses dois pequenos artigos espero ter mostrado os benefícios de se trabalhar de acordo com as melhores práticas.

Essas melhores práticas vêm de testes e experiências de usuários, e existem para fazer sua vida mais fácil. Tente se guiar por elas, e certamente seu trabalho, e dor de cabeça, será menor.

Abraço

Configuração e personalização

Página sobre Configuração e personalização e suas filhas

Introdução

O Drupal é um sistema de gerenciamento de conteúdo em plataforma web. Texto, imagens e outros tipos de conteúdo são armazenados em um banco de dados, dinamicamente recuperados e formatados, e apresentados a um usuário em resposta a um pedido enviado via um navegador para a web. Os detalhes de como tudo isso acontece -- e como você, o administrador de um site baseado no Drupal, pode controlar como a informação é armazenada, recuperada e apresentada ao usuário -- é o tema deste manual.

Terminologia

O Drupal usa certos termos para significar coisas específicas. Os elementos fundamentais do Drupal estão definidos abaixo.

Bloco

Blocos são os adendos de conteúdo ou navegação localizados nos lados esquerdo ou direito de uma página quando você a visualiza em seu navegador. Blocos não são objetos, são apenas uma maneira de posicionar informações dentro de uma página. O visual dos blocos pode ser controlado por cada tema ao se definir o método block($subject, $content, $region = "main").
Configurando e mantendo blocos

Caixas

A caixa é um contâiner para o conteúdo nas páginas do Drupal. Cada caixa tem um título e algum conteúdo. O visual das caixas pode ser controlado por cada tema ao se definir o método box($subject, $content, $region = "main").

Engine

Uma engine é tipo especial de tema que movimenta a geração de marcação HTML para os arquivos de template (usando qualquer sistema de templates). Também diz ao seletor de temas que templates foram definidos. Engines de temas adicionais estão disponíveis na área de downloads de engines (xtemplate é atualmente a engine incluída no núcleo do Drupal).

Filtro

Framework para manipular a filtragem de conteúdo.

Módulo

Um módulo é um código que extende o Drupal para prover funcionalidades específicas. Alguns módulos são parte do núcleo do sistema do Drupal (por exemplo os módulos taxonomy e blog) e alguns outros não (por exemplo os módulos weblinks e image). Módulos do núcleo são aqueles incluídos no pacote principal de download do Drupal. Módulos que foram disponibilizados como contribuição estão disponíveis para download separadamente na seção de download de módulos. Certifique-se de que a versão do módulo que você deseja usar é compatível com sua versão do Drupal. A seção de lançamentos lista os módulos por versão do Drupal.

Objeto (ou Node)

O conceito de objetos no Drupal é provavelmente o mais difícil de se entender, mas ele é realmente muito simples. Praticamente todo tipo de conteúdo no Drupal é guardado como um objeto. Quando as pessoas se referem a um "objeto", elas querem dizer qualquer tipo de conteúdo dentro do Drupal: pode ser uma enquete, uma história, uma página de livro, uma imagem, etc.

Permissões

Controles de permissões para acesso à criação de conteúdo, modificações e administração do site. Administradores delegam permissões aos papéis de usuários, e então delegam esses papéis aos próprios usuários. O primeiro usuário de um site feito no Drupal automaticamente recebe todas as permissões, independentemente de a quais papéis aquele usuário está designado.

Papéis de usuários

Papéis de usuários são grupos com certas permissões que podem ser aplicadas a usuários individuais. Usuários podem pertencer a mais de um papel. Dois papéis de usuário, usuário autenticado (aqueles usuários que se registram para uma conta) e usuários anônimos (aqueles que não têm uma conta ou não se identificaram junto ao sistema) são os papéis disponíveis como padrão em instalações novas do Drupal, mas podem ser configurados e o primeiro usuário pode criar papéis adicionais.

Estilo

Um arquivo (ou arquivos) CSS que substituem o CSS padrão de um tema ou de uma engine. aparece na lista de seleção de temas com a mesma precedência que temas e templates.

Taxonomia

Taxonomia é literalmente a "ciência da classificação". O Drupal usa taxonomias para descrever seu sistema de categorias, que você pode usar para classificar e organizar o conteúdo do seu sítio. No Drupal uma taxonomia é um conjunto de categorias. A documentação possui mais informações sobre o sistema de taxonomia do Drupal.

Template

É um arquivo fácil de ser lido por quem escreve documentos HTML. É, basicamente, um arquivo HTML com códigos especiais que são substituídos pelos valores providos por uma engine.

Tema

É um arquivo em PHP com funções que transformam argumentos em código HTML. Os módulos do Drupal definem funções que podem ser sobrescritas por um arquivo de tema. Existem temas extras que podem ser baixados na área de downloads do Drupal.

Desenvolvimento e suporte

Como um centro de comunicação e espaço para gerência de projeto, o drupal.org(e o drupal-br.org) inclui membros que usam o Drupal como solução para site pessoal; profissionais de tecnologia que implementam o Drupal para clientes; e programadores, escritores e outros, contribuindo para o crescimento do projeto Drupal. Os membros trabalham em conjunto para manter o desenvolvimento e o suporte:

Saiba mais
Veja os links abaixo, outras seções do Manual do Drupal, e várias discussões nos fóruns para mais informação.

Indexação

Estou com um problema de indexação.

Quando eu mando indexar parece não rodar o cron.php, pois ele não dá erro e não indexa nada.

O que pode ser?

Estou copiando o que tem no meu cron.php (em negrito), pois não entendi nada e não sei se ele tem erro.

<?php
// $Id: cron.php,v 1.34 2005/12/31 14:18:22 dries Exp $

/**
* @file
* Handles incoming requests to fire off regularly-scheduled tasks (cron jobs).
*/

include_once './includes/bootstrap.inc';
drupal_bootstrap(DRUPAL_BOOTSTRAP_FULL);

// If not in 'safe mode', increase the maximum execution time:
if (!ini_get('safe_mode')) {
set_time_limit(240);
}

// Check if the last cron run completed
if (variable_get('cron_busy', false)) {
watchdog('cron', t('Last cron run did not complete.'), WATCHDOG_WARNING);
}
else {
variable_set('cron_busy', true);
}

// Iterate through the modules calling their cron handlers (if any):
module_invoke_all('cron');

// Clean up
variable_set('cron_busy', false);
variable_set('cron_last', time());
watchdog('cron', t('Cron run completed'));

O estranho é que ele não fecha o php.

Cordialmente,
Newton Pantozzi.

Instalação

O Drupal precisa de um servidor Web (Apache, IIS, Lighty), da linguagem PHP e do banco de dados MySQL. As únicas coisas que podem variar são: se você vai colocar no seu computador, para testar (chamado de computador local), ou se vai colocar num site de hospedagem de sites (computador remoto) e qual o sistema operacional da máquina.

Local rodando Windows

Se você usa Windows, baixe o XAMPP (ou melhor, a versão XAMPP lite). Ele vem com o Apache, o PHP e o MySQL nas versões mais novas. Ele pode vir como um exe ou um zip e é moleza instalar: copie tudo no "C:". tem de ser no "C:"! depois vá no c:\xampplite\htdocs e copie o drupal inteiro lá.
Agora inicie o Apache e o MySQL (c:\xampplite\xampp-control.exe) e no seu navegador e digite "localhost\drupal". "localhost" é o endereço do seu próprio computador. pronto! brinque bastante!

Local rodando Linux

A maioria das distribuições Linux tem no seu repositório o MySQL, o Apache e o PHP. Então você deve instalá-los primeiro. No diretório "/var/www", copie o drupal inteiro. Agora seu site pode ser acessado em "localhost\drupal". "localhost" é o endereço do seu próprio computador. pronto! brinque bastante!

Você pode ver um vídeo da instalação e importação do idioma português do Brasil aqui

Instalação ilustrada em localhost

Sabendo das necessidades para instalação e com o computador preparado, segue um manual passo a passo ilustrado, para os iniciantes. Aqui vamos instalar o Drupal 5.3 em localhost utilizando Xampp 1.6.4 para Windows.

Primeiro, com o Xampp e os serviços ativados, crie um banco de dados chamado "drupal" pelo phpMyAdmin, acessando pelo seu navegador http://localhost/phpmyadmin/

Note que você precisa de um usuário habilitado com todas as permissões de acesso ao banco de dados. No decorrer da instalação do Drupal utilizaremos usuário com senha.

.

.

Criado o banco de dados, baixe o arquivo do Drupal 5.3 em www.drupal.org/drupal-5.3 e salve em um lugar de fácil acesso, no seu computador.

.

.

Crie uma pasta "meusite" dentro da pasta "htdocs" onde se encontra seu Xampp. Ex: C:\\xampp\htdocs\meusite

Acesse o local onde salvou o arquivo drupal-5.3.tar.gz e o extraia para a pasta "meusite" que você acabou de criar. Você precisa de um programa compatível com o tipo de extensão do arquivo, como o ZipGenius, usado na ilustração.

.

.

.

Feito isso, vamos iniciar a instalação do Drupal, acessando pelo navegador http://localhost/meusite/drupal-5.3/

Note que na extração do arquivo, foi criada automaticamente uma pasta "drupal-5.3" contendo todos os arquivos necessários, dentro da sua pasta "meusite".

.

.

De acordo a figura acima, mostrada em seu navegador, você deve informar:

. Database type: mysql
. Database name: drupal (este é o banco de dados que você criou, inicialmente)
. Database username: root (caso use outro nome de usuário para conexão com o banco de dados, informe o que você usa)
. Database password: (a senha do usuário que faz conexão com o banco de dados. lembre-se que é muito importante utilizar usuário com senha)

Clique em "Save configuration" e... pronto! Agora clique em "your new site" para começar a configurar o seu site Drupal.

.

.

A primeira página do seu site, que se encontra sem nenhuma configuração, será mostrada assim:

.

.

Para garantir a utilidade deste manual, vamos continuar mostrando os primeiros passos que devem ser seguidos após a instalação que neste momento já está concluída.

Antes de começar a configurar o site, você deve criar um primeiro usuário. Este usuário será o administrador geral e terá acesso a todas as funcionalidades e configurações do site. Como descrito página, clique em "create the first account".

.

.

Informe um nome de usuário, um endereço de e-mail e clique em "create new account" para continuar.

.

.

O Drupal lhe dará as boas vindas e também uma senha, mostrando a página para edição da sua conta. Sugiro que altere já a senha emitida pelo Drupal para a sua preferida, facilitando os próximos acessos. Ao final da página há um botão "Submit" para você salvar a nova senha informada.

.

.

Agora a conta do administrador já está definida:

.

.

No menu lateral esquerdo, clique em "Administer". O Drupal deve retornar um aviso de erro, dizendo que "One or more problems were detected with your Drupal installation. Check the status report for more information", destacado em vermelho. Clique no link "status report", mostrado neste aviso.

.

.

Os erros mostrados são o trabalho do cron (que nunca foi rodado) e o sistema de arquivos. Primeiro, defina o sistema de arquivos clicando em "file system settings page".

.

.

Note que uma pasta "files" será automaticamente criada, definindo a configuração.

.

.

Clique novamente em "Administer", no menu lateral esquerdo e note que o mesmo aviso aparece, igualmente quando clicou pela primeira vez. Clique novamente em "status report", exibido no aviso. Desta vez, mostrará somente o erro do cron.

.

.

Clique em "run cron manually". Pronto. O relatório de estado não mostra mais nenhum erro.

.

.

Agora, vamos traduzir o Drupal para o português. Depois disso, qualquer trabalho vai ficar bem mais fácil. Antes, é preciso baixar o pacote de tradução para o português do Brasil em http://drupal.org/project/pt-br

Note que vamos baixar a versão compatível com nossa instalação do Drupal, a versão 5.x. No momento da criação deste manual, a versão do pacote está como 5.x-2.00 e o arquivo baixado está nomeado como pt-br-5.x-2.00.tar.gz

Depois de baixar, extraia o arquivo para um local de fácil acesso, no seu computador. Será criada uma pasta "pt-br" contendo os seguintes arquivos:

installer.po
LICENSE.txt
pt-br.po
README.txt

Ok. Agora clique em "Administer -> Modules" e habilite o módulo "Locale", marcando a caixa de seleção e clicando em "Save configuration", ao final da página.

.

.

Com o módulo habilitado, clique em "Administer -> Localization".

.

.

A figura acima é parte da página de configuração dos idiomas. Clique em "Import". Para o campo "Language file", busque o arquivo "pt-br.po" e para o campo "Import into" escolha "Portuguese, Brazil (Português)" e clique no botão "Import".

.

.

Para finalizar, defina "Enable" e "Default" para a opção pt-br e clique no botão "Save configuration".

.

.

Pronto! Seu site Drupal está instalado e funcionando sem erros e completamente em português! De agora pra frente, é com você...

.

.

Espero que este manual seja útil, principalmente para quem está iniciando no Drupal.

Search Uploaded Files

Adiciona a habilidade de fazer pesquisas nos nomes dos arquivos e/ou nas descrições.

http://drupal.org/project/search_uploads

Manual Drupal 6

Você pode encontrar um texto sobre o que é o Drupal em http://drupal-br.org/drupal

O Drupal é uma poderosa ferramenta de gestão de conteúdo (CMS).

CMS - Content Management System (Sistemas Gerenciadores de Conteúdo)

Existe uma gama de vantagens que um sistema de gerenciamento de conteúdo oferece, entre elas:

Sistemas avançados de CMS possuem muitos recursos adicionais, como workflow (fluxo de tarefas), que permite que conteúdos sejam adicionados ao sistema, porém ainda não disponíveis aos usuários finais, até a aprovação final de um editor–chefe.

Conteúdos também podem ter data e hora de início e fim de publicação.

Em termos simples, um CMS permite que a empresa tenha total autonomia sobre o conteúdo e evolução da sua presença na internet e dispense a assistência de terceiros ou empresas especializadas para manutenções de rotina. Nem mesmo é preciso um funcionário dedicado (o famoso webmaster), pois cada membro da equipe poderá gerenciar o seu próprio conteúdo, diluindo os custos com recursos humanos.

adaptado do site http://webinsider.uol.com.br

Esse manual cobre o básico da instalação e o básico da administração do site

Administrando o site

Quando a instalação for bem sucedida, você será redirecionado para a página inicial do site e estará logado como administrador.

1. Deixando o site em português

Embora ela esteja em inglês, as traduções para português estão instaladas, mas não ativadas, siga os seguintes passos (caso você ainda não tenha feito, baixe a tradução do português em http://drupal.org/node/300563 descompacte o arquivo na pasta C:/Xampp/htdocs/drupal-6.x. depois vá em Administer --> Site building --> Modules e ative o modulo LOCALE.

Clique em Administer --> Language e clique em Add Language, procure Portugues do Brazil na lista e clique em Add Language. As traduções serão importadas do arquivo que você baixou no capítulo de instalação

Uma vez de volta a lista, marque como Default o item Portuguese,Brazil  e clique em Save Configuration. Você irá notar que alguns itens no menu de navegação foram traduzidos. Apague o idioma que está com o Nome em Inglês e o Nome Nativo em branco

Agora vá para Administer --> Construção do Site --> Translate Interface e clique em IMPORTAR

em Arquivo de Tradução, clique em Importar, procure o arquivo pt-br.po, verifique se está para Português Brasileiro e clique em IMPORTAR

Esse arquivo traduz o menu lateral do administrador e alguns textos do seu site.

Clique no ícone do seu site (Drupal 6.x) para voltar a página incial

2. Sua Página Inical

Dê uma olhada em sua página incial, ela traz 4 passos para começar a utilizar seu site rapidamente. Essa página continuará como sua index até que você promova algum conteúdo a página inicial ou mude as configurações para promover uma outra página (explicado mais adiante)

Até esse momento, você tem apenas 1 conta de super-usuário que dá permissão total ao site, é recomendável criar mais usuários para testar seu site (explicado mais a frente)

Clique em Adminsiter

3. O Painel de Administração (Administer)

Essa é a página de administração do seu site e você entrará nela frequentemente. Por padrão, essa página é dividida em 5 grupos. Essa lista pode aumentar dependendo dos módulos que você instala

  1. Construção do site - Controla a aparência e a estrutura do seu site, menus e módulos. Nessa seção que você instala novos módulos.
  2. Gestão do Conteúdo - Administra o conteúdo do seu site, todos os conteúdos ou formas de lidar com ele estarão nesse menu
  3. Configuração do site - o funcionamento, regras, datas e horas,  informações do site e o funcionamento dos módulos são configurados nessa área.
  4. Gerenciamento de Usuários - Nessa seção você cria contas de usuários e define suas permissões, além de organizá-los em grupos ou papeis (ROLES), entre outras configurações.
  5. Relatórios - uma série de relatórios úteis sobre seu site, como as páginas mais acessadas por exemplo, são encontradas nessa área.

No topo da página você encontrará o link BY MODULE, esse link re-organizará o painel do administrador mostrando os itens por módulo instalado. volte para BY TASK para a visualização padrão. Quando você se sentir familiarizado com o Drupal ou depois de ter instalado muitos módulos, você pode preferir trabalhar com BY MODULE, mas isso dependerá de você.

4. O núcleo do site (CRON)

Uma mensagem em vermelho alertará "Um ou mais problemas foram encontrados com sua instalação no drupal" e " Run has not run...."

clique no link Relatório de Status (status report), você verá ícones e cores em verde (OK), amarelo (requerem atenção) e vermelho (críticos). Onde está escrito Cron maintenance tasks, clique em run cron manually para executar o arquivo cron.

Rodar o arquivo cron executa as tarefas básicas de performance do site, como indexar o site todo e  ajuda a manter o site "saudável"

Os próximos capítulos abordarão cada um dos 5 itens do painel de administração

5. Arquivo Pt-br.po consolidado
Acesse o link: http://drupal.org/node/300563

Configuração do Site

Nessa seção estarão disponíveis links para configurar a maioria dos módulos que você baixar e ativar, por exemplo, ao ativar o módulo "upload" uma nova seção chamada "envio de arquivos" será adicionada nesse painel de Configuração do Site.

Muitos desses links são auto-explicativos, no entanto, alguns links merecem uma atenção detalhada

  • Ações - um menu com mais opções além das opções padrão como publicar e despublicar um conteúdo
  • Configuração da busca - ativa o bloco "localizar" do tema, configura opções para indexação do site (Requer módulo Search)
  • Data e hora - ajusta a exibição da data e hora,  por exemplo, do padrão americano 08/23/2008 para o brasileiro 23/08/208
  • Desempenho - configura opções como cache entre outros.
  • Envio de arquivos - define como os arquivos serão anexados ao conteúdo (Requer módulo Upload)
  • Formatos de Entrada - Opção que controla o tipo de formatação padrão do site e as outras formatações disponíveis
  • Informações do site - informações padrão do site, slogan, etc
  • Informe de erros - como o drupal lida com erros
  • Loggins e Alertas - Configurações de logs e alertas de módulo
  • Línguas - nessa seção você pode gerenciar os diversos tipos de idioma do seu site, definindo qual é o padrão do site e como o navegador irá se comportar em relação a lingua do visitante (Requer módulo Locale)
  • Manutenção do site - tira o site do ar para manutenção ou o coloca on-line, você irá trabalhar nessa seção quando for colocar seu site no ar, por exemplo
  • Sistema de arquivos - define onde salvar os arquivos enviados, por exemplo, via upload
  • Tema da administração - define se o administrador terá um tema diferente do tema padrão do site
  • Toolkits de imagens - determina configurações básicas para imagens
  • URL limpas - ou seja, URLs sem o ?q=

 

Input Format

Você verá 2 opções nessa tela

Filtered HTML = permite que apenas formatações básicas como <a> <em> <strong> <cite> <code> <ul> <ol> <li> <dl> <dt> <dd> sejam aceitas quando o usuário digitar tags HTML em seus formulários, URLs viram links automaticamente. Enfim, é o mais seguro para seu site, caso você não deseje que visitantes façam a festa em seu site, postando comentários coloridos e etc.

FULL HTML = essa opção permite toda e qualquer tipo de formatação HTML. O visitante ou membro de seu site pode muito bem abrir uma tag <table> e montá-la em seu post.

PHP Code = você tem que ativar o módulo PHP Filter para ter essa opção disponível. Essa opção só deve ser usada pelo membro #1 (super admin), permite que você injete código PHP na sua página, o que pode, se você não souber o que está fazendo, avacalhar seu site como um todo.

Criando um novo formato

supondo que você queira digitar código Javascript no post, os módulos acima podem não rodá-los apropriadamente, então, você deve criar um novo formato e não marcar nenhuma opção onde está escrito Filtros. Dê um nome do tipo "scripts" para você lembrar que esse formato foi feito para rodar seus códigos javascript

Qual é a finalidade de ter mais de um input format?

Quando você estiver trabalhando com módulos como CCK ou FCKeditor por exemplo, esses módulos dependem de uma correta configuração dessa seção para funcionarem corretamente, por exemplo, o CCK permite que campos criados sejam "travados" para um dos formatos de entrada existentes e o FCKeditor funciona melhor com FULL HTML ativado.

Construção do site

Vamos começar a alterar a estrutura do site, clique em Administrar --> Construção do Site

Você verá 5 opções por padrão, mas podem surgir outras caso novos módulos sejam instalados

  • Blocos - controla a posição dos elementos visuais do site. por exemplo, neste site, o título "Quem Está online" do lado esquerdo é um bloco. a seção Manuais, do lado direito é outro bloco e assim por diante
  • Menus - ao entrar nessa seção você verá 3 links já pré-configurados: Navigation, Primary e Secondary. Os links de Navigation representam o menu do usuário logado no site, Primary costumam ser os do topo e Secondary, geralmente, logo abaixo do primary. Você pode criar seus próprios menus também. (Requer módulo Menu)
  • Módulos - a seção onde você pode adicionar novos recursos ao seu site e ativar ou desativar os recursos do site.
  • Temas - nessa seção você muda a cara do site do azul padrão para uma outra cor ou formato, você também pode baixar mais temas no site do drupal.
  • Traduzir Interface - você mesmo pode traduzir os itens do seu site e praticar inglês, francês, espanhol, etc.(Requer módulo Locale)

Continue a leitura para explorar cada seção

Blocos

Vamos começar a alterar a estrutura do site, clique em Administrar --> Construção do Site

Você verá 5 opções por padrão, mas podem surgir outras, caso novos módulos sejam instalados

  • Blocos - controla a posição dos elementos visuais do site. por exemplo, neste site, o título "Quem Está online" do lado esquerdo é um bloco. A seção Manuais, do lado direito é outro bloco e assim por diante
  • Menus - ao entrar nessa seção você verá 3 links já pré-configurados: Navigation, Primary e Secondary. Os links de Navigation representam o menu do usuário logado no site, Primary costumam ser os do topo e Secondary, geralmente, logo abaixo do primary. Você pode criar seus próprios menus também. (Requer módulo Menu)
  • Módulos - a seção onde você pode adicionar novos recursos ao seu site e ativar ou desativar os recursos do site.
  • Temas - nessa seção você muda a cara do site do azul padrão para uma outra cor ou formato, você também pode baixar mais temas no site do drupal.
  • Traduzir Interface - você mesmo pode traduzir os itens do seu site e praticar inglês, francês, espanhol, etc.(Requer módulo Locale)

Continue a leitura para explorar cada seção

Menus

O Drupal traz 3 menus configurados por padrão: Navigation (para usuários do site), Primary e Secondary Links.

  • Navigation = traz links para a administração, e links úteis como procurar ou ver os usuários do site,
  • Primary = inicialmente vazio, essa seção é útil para links de destaque do site, geralmente chamativos.
  • Secondary = também vazio, um submenu com opções "secundárias".

Criar um novo Menu

Em menu, clique em criar novo menu, digite um nome sem caracteres especiais, um título - nesse título pode espaços, acentos, etc - e uma descrição.

Ao terminar de criar o menu você verá um aviso do tipo "Não há itens de menu ainda." (There are no menu items yet.) pois o menu está vazio. Seu novo menu também virou um bloco (visite a seção bloco para conferir)

Criar itens do Menu

clique em qualquer item de menu e clique em NOVO ITEM. Digite o endereço da página (algo do tipo node/4  onde 4 aponta para a quarta página ou node criado por você), o Título, descrição, escolha Ativar ou não, Expandir ou não e o Parentesco (Parent Item).

sobre menus expandidos e parentesco: olhe para o bloco a direita desse site chamado Manuais... em Manual Drupal 6 você verá uma "seta para baixo" e subitens... em teoria é como se o menu "Manual Drupal 6" estivesse com a caixa EXPANDIDO ativada. Os itens "Instalando o Drupal" e "Administrando o site" são parentes de "Manual Drupal 6"... se você alterar o parentesco, os itens mudam de lugar indo de um menu para outro.

Apagar um menu

em Editar Menu escolha Apagar, mas cuidado, os lnks desse menu também serão apagados mas não os nodes (conteúdos) criados

Observações

Dependendo do tema, não haverá espaço para colocar Primarys links ou apenas para Primary e não para Secondary.

Outro problema comum é que por mais que você deixe um menu expansivel, você não vê os filhos ao passar o mouse por cima em um tema que não permita isso. Você pode solucionar isso baixando um módulo chamado NICE MENU que traz um css de menu.

Módulos

Módulos são plugins que extendem as funcionalidades do Drupal. Para ativar um módulo, clique nas checkbox da lista.

Ao ativar um módulo, você cria novas permissões para usuários (explicado em gerencimaneto de usuário), geralmente, módulos trazem novos blocos e um link em Configuração do Site para você customizar o funcionamento do módulo, alguns criam novas opções em 1 dos 5 menus do administrador

.

É recomendado que você aprenda os módulos que já estão ativados primeiro, depois experimente ativar os outros módulos para ver o que acontece e por último decida baixar módulos do site do drupal. Seguindo essa ordem, você se familirariza com o site como um todo.

Instalando módulos

Baixe um módulo do site do Drupal

No geral para a maioria dos módulos basta descompactar os arquivos na pasta htdocs/drupal-6.x/modules. Ir para a página Administrar --> Construção do Site --> Módulos e ativar os itens do novo módulo.

Se você for usar um recurso chamado multisite (vários sites com 1 instalação do Drupal apenas) descompacte os arquivos em htdocs/drupal-6.x/sites/all/modules (crie a pasta)

Após instalar, procure pelo seu módulo nos blocos, Configuração do Site e Permissões de Usuários para aprender como usá-lo.

Desinstalando módulos

Basta desmarcar o módulo que não quer mais, no entanto, clique em UNISTALL para ver a lista de módulos que tem que ser desinstalados para ter certeza que você pode remover o módulo sem problema (incluindo deletá-lo do diretório)

Temas

O Drupal já traz 6 temas prontos para você testar seu site e você também pode procurar por mais temas no site http://drupal.org O Tema Garland está marcado como Padrão e está ativado. Selecionem um outro tema qualquer, clique em padrão, clique em Salvar Configurações e veja seu site mudando de aparência.

Cada tema marcado como padrão você acaba ativando-o e ele fica disponível no menu Configurar. Clique nesse menu

A primeira opção que aparece é OPÇÕES GLOBAIS, que afetam todos os temas do site como um todo.  Se a logo estiver desmarcada das opções globais, não importa se ela estiver marcada nos outros temas (os nomes dos temas ativados ficam ao lado do link OPÇÕES GLOBAIS).

Nessa tela também você escolhe a logomarca do seu site, o ícone, define se vai aparecer o nome do usuário que postou conteúdo (submitted by Username), slogan entre outras

Alguns itens estão desativados: User picture e search = para ativar esses itens você deve ativar o módulo Search e para ativar as imagens dos usuários, você deve ir em Gerenciamento de usuários --> Opções dos usuários e ativar assinatura e foto.

Ao clicar no nome do tema, você verá que alguns temas permitem configurar o esquema de cores que ele possui, etc.

Existe também uma lista de temas criados pelo usuário no site do drupal, para instalá-los, basta descompactar o arquivo na pasta themes ou na pasta sites/all/themes (para multisites)

Traduzir Interface

Para que esse recurso seja ativado, o módulo LOCALE tem que estar ativado, nós o "ativamos" quando instalamos o Drupal em Português no início do capítulo.

Esse recurso é muito simples e permite que strings ou frases sejam traduzidas para outros idiomas, incluindo português e que outras línguas sejam adicionadas ao site para criar um site multi-idiomas por exemplo.

Em visão geral você pode ver o andamento da tradução e quantas strings faltam para "terminar de traduzir" o site. Uma regra prática, traduza apenas aquilo que seu visitante vai ver.

Traduzindo strings

clique em Buscar, digite, por exemplo

Limit search to

do jeito que está com maiúsculas e minúsculas, irá aparecer pt-br indicando que não há tradução para esse idioma, clique em editar e digite

Limitar buscas a

e clique em Salvar Traduções

repare que o texto das opções abaixo foi traduzido.

Importando ou Exportando Traduções

ao clicar em Importar, você pode pegar arquivos de traduções que outros usuários ou enviar o seu para eles como você fez quando baixou o arquivo pt-br.po na instalação

Gerenciamento de usuários

Nessa seção você irá gerenciar os usuários de seu site, criar perfis para seus usuários preencherem,  ativar assinatura e suporte a fotos dos usuários, criar regras de registro de usuário, e definir o workflow ajustando papéis e atribuindo permissões no seu site

  • Opções de usuário = Configurar o comportamento padrão das contas de usuários, incluindo pedidos de registro, emails e imagens.
  • Papéis (roles) = Listar, criar ou editar papéis de usuário. útil para distribuir tarefas entre os integrantes do seu site tais como revisor, moderador de forum, etc.
  • Perfis = Criar campos personalizados para o perfil dos usuários no estilo data de aniversário, telefone, etc. Requer módulo Profile ativado.
  • Permissões = Determine o acesso aos recursos selecionando permissões para papéis.
  • Regras de acesso = Listar e criar regras para desativar certos nomes de usuário, emails, ou endereços IP.
  • Usuários = Listar, criar e editar usuários.

Uma opção que deveria estar nessa lista: "Como faço para banir um usuário?"

Você deve visitar a seção Relatórios --> Visitantes mais ativos e clicar em " banir" o IP ou a conta do visitante problemático

Opções de usuário

Nessa seção você define como será o processo de cadastramento no seu site, se apenas o administrador pode criar contas (útil para sites fechados) ou se os visitantes podem criar com ou sem moderação.

Você também personaliza todos os 7 e-mails automáticos enviados pelo seu site, é bom colocar uns textos em português para facilitar a vida de seus visitantes, e também define se as assinaturas e fotos estarão liberadas.

Quando você ativar as imagens do usuário, ele será salvo dentro da pasta sites/default/files/ no subdiretório que você escolher (o padrão é "pictures") a menos que você tenha alterado o diretório padrão em Configuração do Site --> Sistemas de Arquivos

Fazendo a imagem do membro aparecer no post

Você deve visitar a seção "Construção do Site --> Temas --> Configurar" e em Opções Globais, ative os itens Fotos dos usuários nos posts e Fotos dos usuários nos comentários. Faça o mesmo no tema que está configurado como padrão (o nome do tema deve estar ao lado de Opções globais).

Escolha quais tipos de nodes a imagem irá aparecer juntamente com as informações dos usuários na caixa de seleção ao lado chamada "Exibir informações do post em" essa informação não tem no drupal, mas a imagem só vai aparecer onde essa opção estiver marcada. ex: se estiver marcado story vão aparecer a imagem e a data do post, se page não estiver marcado, não aparece nem a imagem e nem as informações do post.

Papéis e Permissões

´

Para um melhor entendimento dessa seção, é bom ter uma idéia bem defininda dos objetivos do seu site e da sua equipe que vai trabalhar no site depois que ele estiver pronto. Como papéis e permissões são interligados, serão tratados juntos nesse capítulo.

Considere os seguintes questionamentos:

Se você for um exército de um homem só do tipo "eu faço tudo", os dois papéis que vem configurado por padrão bastam e pouca configuração terá que ser feita. Provavelmente seu site será do tipo - site pessoal.

Se você for fazer um blog ou algum tipo de site onde os visitantes vão poder fazer comentários, você irá alterar algumas configurações no papel dos usuários autenticados. útil pra blogs ou pra colher feedbacks de algum projeto que você estiver fazendo, por exemplo.

Agora se você for desenvolver um site colaborativo, com uma equipe de pessoas atuando é interessante distribuir funções para cada usuário de acordo com o objetivo do site.

Workflow

Um dos melhores sistemas de workflow, em teoria, existente é o do Plone, ele traz um conceito de distribuição de papéis por Visitante, membro, revisor e administrador.

Supondo um site editorial jornalistico simples onde os visitantes (leitores) poderão enviar comentários ou se cadastrar para participar do forum por exemplo. Repórteres enviarão "stories" mas não podem alterar o status para publicado, ficando a cargo de um outro papel chamado "jornalista" a opção para publicar o artigo enviado. Por fim, um papel chamado administrador que teria todas as permissões marcadas.

De acordo com a idéia ou tema do site, você irá configurar as permissões marcando e desmarcando opções para cada papél. A combinação dessas marcações (e também das configurações dos modulos) resulta em um workflow.

Outros módulos dependem de um conceito bem estruturado do site que você está desenvolvendo para você utilizar a ferramenta da melhor maneira possível.

Permissões

Na grande maioria dos módulos, o que você marcar para "usuários autenticados" se propaga para os outros papéis que você criar, exemplo, se você quer que todos os papéis que você criou (ex: reporter, jornalista, editor, membro, etc) possam votar nas enquetes, basta marcar "votar nas enquetes" apenas na coluna do usuário autenticado que ele propaga para os outros papéis.

no módulo FCKeditor, por exemplo, trabalha diferente, ele exibe a ferramenta apenas para o papel que você marcou. Isto é, se você tiver marcado apenas usuários autenticados, os demais papéis não vão usar a ferramenta

Uma boa maneira de praticar permissões é baixando 3 navegadores: Firefox, Safari e Opera, criando 3 contas uma para cada papél criado e ir marcando e desmarcando caixinhas para ver o que acontece. O bom é que você acaba vendo como seu site vai ficar nos outros navegadores enquanto simula 4 visitantes no seu site, um em cada navegador e um em cada papél. (se for o caso)

Gestão do Conteúdo

Para esse capítulo, ative os módulos

  • Blog
  • Book
  • Fórum
  • Poll (enquete)

 Nessa seção, você gerenciará todo quanto é tipo de conteúdo que tem no site. Na verdade, você irá gerenciar os Nodes do site

O que é Node?

Node é um nome genérico para todo e qualquer tipo de conteúdo que você cria, por exemplo, ao criar uma página, você criou um Node; ao criar uma enquete, você criou um node e assim por diante.

Cada Node tem um número 1, 2, 3, etc que o identifica no banco de dados, um Node então é um registro em uma tabela SQL que é "montada" quando você digita node/6 por exemplo

Na prática, Node é um conteúdo qualquer de qualquer tipo

A Tela de Organizar conteúdo

Você verá 8 sub-seções nessa área. Basicamente qualquer assunto ligado a Node, vc deve procurar primeiro aqui

  • Comentários - Lista todos os comentários enviados por usuários do seu site, visitantes e comentários pendentes de aprovação (Requer módulo Comment)
  • Configuração do post - controla o tamanho da visualização do post nas paginas de chamada (TEASER)
  • Conteúdo - Lista todos os Nodes do site e permite que você os controle mais facilmente
  • Fórum - controla o fórum e o organiza (Requer módulo Forum)
  • Livros - administra os livros do site (Requer módulo Book)
  • Publicação em RSS - administra o RSS
  • Taxonomia - Classifica, categoriza e organiza os nodes criados. Extremamente útil (Requer módulo Taxonomy)
  • Tipos de conteúdo - gerencia como os conteúdos são criados e suas regras para criação de Livros (book), Blogs, Páginas, Notícias (story), Enquetes (poll), e outros que você criar

 

Comentários

Dependendo das permissões que você der para usuários autenticados e anônimos, certos recursos estarão disponíveis ou não a seus visitantes e membros do site.

Comentários Publicados

Mostra todos os comentários publicados em seu site e permite que você cancele sua publicação (mandando de volta a fila de moderação) ou apague-os

Fila de Moderação

Nessa seção você localiza os comentários enviados pelos usuários e que estão pendentes de aprovação

Boa parte da estrutura de interatividade do drupal (forum e respostas, blogs e comentários, etc) é baseada em comentários. Sempre tenha em mente o que você quer no seu site.

Algumas perguntas úteis:

Visitantes vão poder ver os comentários? vão poder comentar? se sim, quais tipos de conteúdo vão poder comentar (blog, enquete, etc)? os comentários terão que ser aprovados ou serão publicados direto? os visitantes devem se identificar quando postarem alguma coisa, ou é opcional, ou não precisa? e os usuários autenticados do site, que permissões terão?

Configurar Comentários

para "configurar" os comentários você precisará ler 2 capítulos

  • Tipos de Conteúdo
  • Permissões

Basicamente você terá que editar, um a um, os tipos de conteúdo para liberar comentários e definir nas permissões o que cada grupo de usuários poderá fazer

Bem que o Drupal poderia ter reunido essas perguntas em um item só

Configurações do Post

Esse menu define padrões para todos os tipos de conteúdo que você tem no site, bem como quantos itens terão na página inicial, teaser e o tamanho do teaser

O que é Teaser (chamada)?

Teaser é um resumo do post, se, por exemplo, você postar o hino nacional brasileiro o Teaser será algo do tipo:

Ouviram do Ipiranga as margens plácidas...

Leia mais

O teaser é gerado automaticamente quando você cria um node, entretanto, você pode definir a regitão que você quer exibir manualmente durante a criação do post, marcando a opção "split summary at cursor" (dividir chamada no cursor)

Tamanho da Chamada

Você pode definir o tamanho dessa chamada (Teaser) no menu logo em seguida, se você deixar como Ilimitado, todo o conteúdo do post será exibido e não haverá Teaser. Isso pode gerar certa confusão quando houverem 10 nodes na página inicial e todos eles configurados para exibir todo o conteúdo.

Visualizar post

Se você marcar como obrigatório, você só poderá salvar o node após clicar em Visualizar post, esse recurso é útil para trabalhos colaborativos onde é bom revisar o que você digitou antes de enviar.

Conteúdo

nessa seção você administra todos os conteúdos do site e tem uma visão geral do status de cada um deles bem como a lingua a qual eles estão.

Filtrar conteúdo

Imagine que você possua mais de 300 nodes criados, como recuperar um grupo de story, não publicadas e em inglês?

  • em status é escolha não publicado e clique em Filtro
  • em type, escolha story e clique em Refinar. Um grupo de nodes filtrados aparece na tela logo abaixo
  • em language, escolha inglês e clique em Refinar.

Cada vez que você Refina um filtro, você adiciona um "parâmetro" na busca, o comando Desfazer retira 1 parâmetro e o Restaurar retira todos.

Update options (Opções de atualização)

nessa tela você pode promover 5 nodes de uma vez, por exemplo, para a página inicial ao invés de ter q editar um a um. Apenas selecione-os e em Update Options escolha Promover para a página Inicial.

obs: Destacar e Remover Stickness (remover destaque)

Se 5 nodes, no exemplo anterior, tivessem sido promovidos a página inicial, como deixar 1 deles no topo (em destaque)?, simples, escolha aquele que você quer que seja o primeiro e em Update options escolha Destacar.

 

Publicação em RSS

Essa seção controla o RSS do seu site

O que é um RSS?

Segundo o site da UFMG - http://www.ufmg.br/online/web/arquivos/003127.shtml

RSS é a sigla em inglês para Rich Site Summary ou Really Simple Syndication, ou seja, uma forma simplificada de apresentar o conteúdo de um site. Um documento RSS é feito na linguagem XML e geralmente exibe o grande volume de informações existente em uma página na internet de forma resumida. Pela característica de alimentar de notícias, os documentos RSS também são chamados de Feeds.

Os sites que disponibilizam o RSS exibem um link ou uma imagem alaranjada para identifiar o serviço, como temos nesta seção de notícias do site da UFMG (Ícone do RSS). Clicando sobre o link somos direcionados para a página codificada (contendo os links e resumo dos textos) que não é lida pelos navegadores comuns, e sim por agregadores de noticias.

Os agregadores de notícias são sistemas que lêem os documentos RSS e os exibem amigavelmente. Existem alguns programas que, após serem instalados no seu computador, podem ser alimentados com os links RSS. Outros sistemas, mais práticos, são páginas na internet, e basta acessar o endereço da página para alimentar o sistema com os seus RSS preferidos.

Nesse menu você determina quantos itens haverão por feed e como será esse feed

Taxonomia

Embora o termo "taxonomia" remeta as aulinhas de biologia sua definição é bem parecida.

Taxonomia é uma maneira de organizar e catalogar (categorizar) conteúdos de seu site usando tags e termos.

O livro de receitas

A melhor maneira de aprender taxonomia é com exemplos, supondo que você está construindo um site de receitas e que até o momento tenha 8 páginas: 2 de receitas de salada, 2 com receitas de bifes, 1 com receita de massas e 3 com receitas de sobremesas.

Não seria melhor organizá-las para ficar mais fácil de encontrar e reunir esses conteúdos em palavras chaves? dessa forma, ao clicar em "saladas" por exemplo, será exibido as 2 páginas sobre saladas de seu site.

Vocabulários

Comece criando um vocabulário, clique em novo vocabulário e digite Receitas. Um vocabulário agrupa um conjuntos de termos ou tags. Em descrição digite "Livro de Receitas", deixe o texto de ajuda em branco e em Tipos de conteúdo, marque Página. deixe as outras 3 caixas desmarcadas. Clique em salvar.

De volta a tela clique em Adicionar termos na linha de Receitas e adicione 4 termos: Saladas, Bifes, Massas, Sobremesas.

No menu acima, clique em listar e você verá os termos criados. Agora quando você for criar uma página, vai aparecer uma caixa de opções contendo os 4 termos que você criou. Após criar a página, você verá o termo no canto da página indicando um vínculo

você verá, caso tenha ativado o módulo Fórum, que há uma taxonomia para o forum com termos listados para ele também.

Tipos de Conteúdo

Nessa seção você administra os diversos tipos de conteúdo do seu site.

Cada node, como visto anteriormente, é um tipo de conteúdo gerado, por exemplo, ao criar uma página, você gerou um node do tipo page, ao criar uma enquete, você gerou um node do tipo poll e assim por diante

Por que criar tipos diferentes de conteúdo?

depende muito do objetivo do seu site, se você vai querer que os membros do seu site sejam capazes de criar páginas, mas não editar as que já existem seria recomendado criar um tipo de conteúdo chamado "informativo" e deixar os membros do site com permissão para editá-los, deixando apenas você com as permissões para editar as páginas do site.

Cada tipo de conteúdo criado gera um novo conjunto de permissões para criar, editar e deletar esse tipo de conteúdo em Administrar --> Gerenciamento de Usuários --> Permissões na seção "módulo node", algo do tipo edit any, edit own, delete any, etc...

Criando tipos de conteúdo

Clique em novo tipo de conteúdo, digite um nome, um tipo (um nome para a web com _ e - ) e uma descrição, defina as opções para envio, workflow (fluxo de trabalho) e comentários

Como faço para adicionar mais campos do tipo lista, drop and down ou um novo textfield?

você deve utilizar o módulo CCK - Content Construction Kit (que será detalhado na seção Módulos - Avançado desse manual)

O que é workflow?

Podemos definir workflow como: "Qualquer tarefa executada em série ou em paralelo por dois ou mais membros de um grupo de trabalho (workgroup) visando um objetivo comum".

Ao desmarcar a caixa "publicado" por exemplo, o usuário que criar esse tipo de conteúdo ficará pendente de revisão ou seja, estará aguardando alguem ir lá e clicar em "publicar"

Ao marcar "criar nova revisão" você cria versões diferentes do mesmo node, ou seja, cada vez que esse conteúdo for aberto para edição e depois for salvo, a versão "anterior" será salva e ficará registrada no item revisões.

Excluindo tipos de conteúdo

Supondo que você tenha um tipo de conteúdo chamado "rodapé" que vai controlar os textos que aparecem no rodapé com 4 nodes criados, ao excluir esse tipo de conteúdo, os nodes ficarão "sem tipo" e podem não ser exibidos da maneira correta no seu site.

esses "nodes sem tipo" serão encontrados em Gestão do Conteúdo --> Conteúdo

Blogs

Um post de blog é um tipo de conteúdo gerado para reunir postagens pessoais dos membros do site, seu formato é muito parecido com uma página ou notícia (story), mas a diferença é que ele adicona uma opção chamada "Blog - Ver posts recentes" no perfil de cada usuário, adiciona uma tag no estilo taxonomia chamada "blog do usuário" que ao ser clicada, organiza todas as postagens desse usuário em uma lista ordenada.

Books

Sinônimos de Book incluem: Wiki, wikipedia, livros, manuais, e qualquer outra coisa que lembre manuais de instruções.

Nessa tela são exibidos todos os books criados por você e os membros do site, você pode, com um simples arrastar, alterar a ordem dos capítulos ou mover capítulos de lugar.

Editando a ordem das páginas do livro

Para isso, escolha um livro criado por você e clique em Edit Order and Titles.

Será exibida uma lista dos capitulos do livro escolhido, ao alterar a estrutura de suas subpáginas arrastando-as de lugar, você muda o menu de navegação do livro:

Configurações

Nesse item você pode definir o que poderá ser promovido a livro, exemplo, uma certa discussão no forum rendeu muitos comentários, porque não adicioná-la no livro do site?

Para isso, marque a opção Forum topic em Allowed book outline types e clique em Salvar configurações. Repare que a opção Book já está escolhida por padrão.

Na opção Default child page type toda vez que você for criar uma sub-página de um livro ela será do tipo escolhido (também marcado book por padrão)

Agora você pode, por exemplo, criar um capítulo chamado FAQ (Perguntas Frequentes) e "mover" os tópicos para lá.

Criando uma página de livro

Em sua tela de navegação, clique em Criar Conteúdo e escolha Página de Livro

de acordo com a definição

Uma página de livro é uma página de conteúdo, organizado em uma coleção de entradas relacionadas coletivamente conhecido como um livro. Uma página de livro exibe automaticamente links para páginas adjacentes, proporcionando um simples sistema de navegação por organizar e rever os conteúdos estruturados.

Dê um título e digite o conteúdo da página nessa tela usando as ferramentas disponíveis como negrito, itálico etc.

Deixe o botão "Mostrar resumo na visão total" marcado para o Drupal gerar um resumo automático da página do livro

Em Linha do livro escolha para qual livro você vai adicionar essa página ou criar um novo livro.

Em Informações da Revisão, deixe um texto explicando as mudanças que você fez para que outros possam continuar ou editar seu trabalho.

Anexe um arquivo na página se for necessário, observe as extensões permitidas e clique em Salvar

Promovendo outros tipos de conteúdo a página de livro.

Os tipos de conteúdo que podem virar livro, configurado mais acima, terão uma opção chamada Outilne (Esboço ou Linha do Livro), essa tela é muito parecida com a tela de criar página do livro, e nessa opção você define para qual livro vai enviar o conteúdo selecionado.

O conteúdo escolhido é "replicado" no livro, ou seja, qualquer mudança feita no forum, por exemplo, aparece no livro.

 ao clicar em linha de livro (Esboço ou Outilne) você pode remover o conteúdo do livro e ele não é apagado do site, apenas removido do livro.

Usuários com a permissão administer book outlines podem adicionar qualquer tipo de conteúdo ao livro

Enquetes

Uma enquete, é composta de uma pergunta seguida de um conjunto de possíveis respostas, você pode definir quantas opções para voto estarão disponíveis, bem como a duração da enquete e se ela estará ativa ou fechada.

Notícia (story)

Uma notícia se comporta de maneira similar a uma página, vêm com a opção "promovido a página inicial" marcada como padrão, no entanto, se você desmarcar essa opção, ela se torna um tipo de conteúdo similar a uma página.

Uma notícia também exibe informações de criação do tipo

sex, 08/08/2008 - 15:48 — autor

essa informação pode ser desativada em Construção do Site --> Tema --> Configurar desmarcando a opção correspondente no "Exibir informações do post em"

Instalando o Drupal

O Ideal seria você ter um servidor HTTP funcionando em sua máquina, mas uma boa alternativa é você instalar o Drupal com o Xampp.

Instalando Drupal 6.x com Xampp

Esse tutorial deve ser útil também para a instalação das versões anteriores do Drupal.

1. Preparando o cenário

Para todos os efeitos, vamos considerar que não hajam servidores em sua máquina e que o IIS não esteja ativado.

1.1 Baixando o servidor Xampp

Vá até o site http://www.apachefriends.org/pt_br/xampp-windows.html#2287 e baixe o Instalador do Xampp. Ele irá instalar-se na pasta C:/xampp e irá criar um atalho no menu iniciar. Logo em seguida, ative seu servidor em C:/Xampp/XampControl.exe clicando em Start para Apache e Mysql.

Abra o navegador e digite http://localhost ,escolha o idioma Português Brasil e na tela de Congratulações, clique em Status e veja o que está ativado, não se preocupe com o SMTP e FTP desativados por enquanto, clique também em Art Flash e veja se a animação roda, se ela funcionar significa que seu servidor está operacional.

1.2 Criando um banco de dados

ainda em http://localhost clique em ferramentas --> PhpMyAdmin e onde está escrito Criar novo banco de dados digite um nome qualquer, por exemplo, drupal. O cenário está pronto para a instalação!

2. Instalação

Entre no site http://drupal.org/ e clique em Download Drupal 6.x descompacte o arquivo na pasta C:/Xampp/htdocs (está pasta armazena os sites locais que vc estiver desenvolvendo)

2.1. Instalando em português

vá em http://drupal.org/project/Translations e procure por Portuguese Brasil e descompacte o arquivo na pasta C:/Xampp/htdocs/drupal-6.x

2.2 Preparando o arquivo settings.php

após ter descompactado o arquivo, verifique se este possui o arquivo settings.php, caso não possua, vá até a pasta C:\xampp\htdocs\drupal-6.x\sites\default, faça uma cópia do arquivo default.settings.php e cole no mesmo lugar mas com o nome settings.php

Você deverá ter apenas 2 arquivos nessa pasta: default.settings.php e settings.php

volte ao navegador e digite http://localhost/drupal-6.x para começar a instalação (se vc descompactou o arquivo com outro nome, digite http://localhost/nome_do_arquivo_descompactado)

2.3 Instalando pelo navegador

Clique em Install Drupal em Portuguese, Brazil (Português)

2.4 Configurando a database

Deixe a opção mysqli  marcada. Lembra que criamos um banco de dados no passo 1.2 ? então, digite, em DATABASE NAME o nome do banco de dados criado, no exemplo foi drupal. em DATABASE USERNAME digite ROOT e clique em SAVE AND CONTINUE.

2.5 Configurando o site

O Site irá começar a instalação e irá pedir configurações como nome do site (SITE NAME) e-mail do site (SITE EMAIL ADDRESS) conta do administrador usuário #1 (ADMINISTRATOR ACCOUNT) e configurações do servidor (SERVER SETTINGS) deixe a opção update marcado para ser avisado quando houverem atualizações de módulos. uma mensagem de erro dirá que não foi possível enviar o email Ignore-a (pois nenhum serivdor de SMTP foi criado no passo 1.1) e clique em YOUR NEW SITE

3. E agora...?

Continue lendo o livro para a seção Administrando seu site

Módulos extras

Mauais e traduções de módulos extras

Sobre a documentação

Toda documentação do Drupal Brasil é feita por voluntários e em alguns casos é tradução do manual oficial do Drupal.

Muitas pessoas têm colaborado com a criação de conteúdo mas sempre há espaço para novas contribuições. Se você tem conhecimento das funcionalidades do Drupal e não há nenhuma documentação sobre isso, sinta-se à vontade para contribuir.

Tradução

O Drupal pode ser baixado gratuitamente no site oficial. Mas ele vem todo em inglês.

Mas existe um jeito de traduzir todo o Drupal para o Português. Você só poderar traduzir o Drupal depois de instalá-lo.

Primeiramente, baixe a Tradução para o Português do Brasil. é um arquivo com a extensão .PO. Agora vamos colocar esta tradução dentro do Drupal: vá em Administer > Site configuration > Localization. No alto, clique em Import. Em Language file, coloque o arquivo da tradução; em Import into escolha o Portuguese Brazil e clique em Submit. Pronto, seu site agora estará todo traduzido!

É importante dizer que esta tradução só se refere ao núcleo do Drupal. As traduções dos inúmeros módulos adicionais devem ser adquiridas separadamente.

Devolvendo a tradução de módulos extras

Essa página trata de como devolver a tradução que você fez de um módulo de terceiros.

Traduzindo um módulo extra

Um módulo extra é um módulo que não vem com o core do Drupal. Esses módulos podem ser obtidos visitando-se a página http://drupal.org/project/Modules. Existem centenas de módulos, com variadas funcionalidades e usos.

Alguns módulos já vêm com um arquivo modelo para a tradução (arquivo .pot, em formato gettext) dentro de uma pasta chamada "po". Copie esse arquivo com o nome pt-br.po nessa pasta e proceda a tradução normalmente. Para traduzir esse módulo, você deve seguir os passos descritos no Guia para tradução.

Após a tradução

Você traduziu um módulo e agora quer aplicá-lo no seu site certo? Para isso, repita o procedimento de importação de tradução que você realizou no momento de traduzir seu site para português do Brasil. Para referência veja o tópico Tradução ou o screencast de instalação do Drupal que também cobre esse assunto.

Devolvendo para a comunidade

Após a tradução recomendamos que você devolva o que produziu para a comunidade, pois com isso outras pessoas podem utilizar essa tradução em seus projetos.

O melhor jeito de devolver a tradução é enviando o arquivo que você traduziu para o mantenedor do módulo. Para isso, você deve ir até a página do módulo no Drupal.org e clicar no link "Request new feature", descrevendo o trabalho que você fez, explicando que o arquivo anexo é a tradução para português do Brasil daquele módulo.
É provável que o mantenedor do módulo se pronuncie à respeito, informando se o arquivo foi aceito ou reijetado (e nesse caso uma justificativa).

Projetos para tradução

Pessoal,

Algumas pessoas estão precisando cadastrar/enviar projetos para tradução no nosso servidor de traduções e não estão conseguindo.

Entrei em contato com o Bruno Massa e ele me explicou que a situação atual do módulo de tradução (do qual ele é criador, mas não mais o mantenedor) está um pouco complicada.

Assim, quem tiver arquivos de tradução ou desejar ter algum projeto disponível para tradução no nosso servidor, envie uma resposta a esse tópico com o nome do módulo e URL do mesmo. Ex.: E-commerce, http://drupal.org/project/ecommerce

Hoje, a meu pedido, foram adicionados os projetos Audio e Privatemsg para tradução (esse último já fiz uma tradução preliminar).

Abraços a todos!

Ps.: Esse post ficará fixo na página inicial alguns dias depois devo movê-lo para um local mais pertinente.