Manual do K2 para Joomla!

Transcrição

1 Manual do K2 para Joomla!

2 Apresentação Versão Release 09/10/10. Colaborador: Júlio Coutinho webmaster@joomlabrasilia.org Colaborador: seu nome seu Twitter: seu twitter Este manual é um documento colaborativo criado a partir da demanda gerada por vários usuários das Comunidades SGC Joomla e Joomla Brasil do Orkut. Após assistir a excelente oficina ministrada pelo Ronildo e Daniel no Joomla! Day Brasil 2010, percebi que o K2 era muito mais do que eu havia explanado em um tutorial criado a algum tempo no Joomla! Brasília e resolvi estudar a fundo o componente. A melhor forma que encontrei foi apresentar um case e durante este case, testar as funcionalidades e descrever a utilização da ferramenta. Confesso que fiquei espantado com a potência da ferramenta. Todos estão convidados a participar da melhoria deste manual enviando suas ementas para o webmaster@joomlabrasilia.org cada ementa pertinente será adicionada ao manual, gerando uma nova versão, com os créditos devidamente colocados. Aguardo colaboração de todos que usam o K2 para melhorarmos o Manual. Bora colaborar galera? "Conhecimento sem compartilhamento não serve para nada!"

3 Case Colunistas O Case Iremos desenvolver um projeto voltado a colunistas que desejem postar tutoriais Joomla, divididos dentro de uma categoria pai e várias sub-categorias. As categorias Teremos 01 (uma) categoria pai e 03 (três) categorias filhos a saber: 1. Categoria Tutoriais Joomla...Webdesign e Joomla...Segurança e Joomla...Joomla for Dummies 2. Categoria Livros Os Colunistas Cada sub-categoria possuirá 01 (um) ou mais colunistas com os seguintes campos: 1. nome 2. curriculum 3. contato twitter Os Livros A categoria livros contará com indicações de bons livros que irão ajudá-lo(a) a tornar-se um profissional de sucesso. Publicação O projeto será publicado na Internet para servir de fonte de estudo por parte dos usuários interessados.

4 O que é K2 K2 é um poderoso e popular componente para gerenciamente de conteúdo no Joomla! com características de CCK-like desenvolvido pelo JoomlaWorks, fabricantes de várias extensões Joomla!, desde Ele fornece várias formas de integrar o conteúdo do website Joomla (pense em artigos com campos adicionais para as imagens do artigo, vídeos, galerias de imagens e anexos), o nível de subcategorias, tags, comentários, um sistema de aumentar o formulário de item de base com os campos adicionais (semelhante a CCK para aqueles familiarizados com Drupal), uma API e plugin poderoso para estender item, categoria e as formas de usuário, ACL, edição frontend, sub-modelos e muito mais! Usando o K2, você pode transformar seu website Joomla! para um site de notícias / revistas com autores de blogs, catálogos de produtos, a carteira de trabalho, conhecimentos, download / gestão de documentos, listagem de diretórios, listagem de eventos e muito mais, tudo isso empacotado em um único componente! K2 é extensível a outros itens de campos, você pode facilmente criar tipos de conteúdos específicos da categoria, por exemplo, artigo, post, a página do produto e listagem do diretório. K2 agrega comentários, integração com twitter, fotos e vídeos, opção de anexar arquivos, opção de personalizar o perfil do usuário, enfim um framework completo, dentro do Joomla! K2 possui vários addons para seu projeto e nem todos são gratuitos. Porém, devido ao baixo custo e as possibilidades de implementação no projeto, recomendo que você adquira cada uma delas e repasse o valor ao cliente. Nunca, jamais, sob hipótese alguma, use addons, extensões ou templates piratas.

5 Por quê usar K2? Por quê eu usaria o K2? Há um grande número de razões, você fala com alguém que usa ou desenvolve para K2 e você terá mais razões, nesta lista estão alguns dos pontos que eu encontrei. 1. Categorias aninhadas Joomla! 1.5 não permite a criação de subcategorias ou categorias aninhadas. Com o K2 é possível extender o CMS criando categorias aninhadas. 2. Micro Templates para K2 Cada categoria pode ser atribuída a seu próprio template K2, possibilitando renderizar páginas em layouts diferentes para outras categorias, ideal para websites multi-funcionais. 3. Uso de TAGS Com K2 você pode adicionar tags com itens que podem ser ligados para formar um catálogo de informações. 4. Flexibilidade no Design Uma vasta gama de elementos pode ser ativado / desativado por item ou categoria e, quando utilizado em conjunto com os micro templates do K2 você pode produzir desenhos exclusivos para seu website. 5. Extensão de Controle do Usuário Nativamente o K2 possui uma potente ACL, que permite dentre outras coisas a contribuição de artigos via frontend do seu site sem ter ser necessário o acesso via backend, além de controlar quem tem acesso ao conteúdo, através da criação de grupos com as suas próprias restrições. 6. Apoio O K2 possui um grupo ativo de seguidores para criar uma comunidade de apoio mútuo para oferecer ajuda, conselhos e experiências reais. 7. Extensão gratuita K2 é livre e gratuito e você dificilmente achará outra assim, sendo obrigado(a) a pagar alguns dólares por uma extensão similar ao K2.

6 O quê é preciso para rodar o K2? Para o perfeito funcionamento do K2 basta usar o Joomla! 1.5.x. Independente de usar K2 e por questões de segurança recomendo: 1) CMS Joomla! 1.5.x (sempre a última versão) 2) SGB MySql (sempre a última versão) 3) Web Server Apache (sempre a última versão) 4) PHP (sempre a última versão)

7 Obtendo o K2 Como obter o K2? Para baixar o K2 você deve visitar o website oficial do Projeto: Instalando o K2 no Joomla A instalação do componente é simples bastando acessar o Menu Superior -> Extensões -> Instalar/Desinstalar no backend do seu website Joomla. Traduzindo o Componente Após a instalação iremos aplicar o pacote de tradução do componente para o português do Brasil e para tal, baixe o pacote de tradução direto de nosso website se desejar pois já está adaptado ao encoding UTF-8. Para traduzir faça: 1) Baixe o pacote pt-br; 2) Descompacte na sua máquina; 3) Copie (ctrl+c) o arquivo pt-br.com_k2; e 4) Cole (ctrl+v) no diretório /administrator/language/pt-br. (*) o seu website deve ter sido traduzido para o português do Brasil antes.

8 Entendendo o K2 Antes de explorar o Painel de Controle do K2, vamos entender o componente K2 é um poderoso componente que incrementa a forma como o Joomla gerencia os conteúdos. É interessante que você instale o K2 antes de qualquer componente e siga no desenvolvimento do projeto. Via de regra, o K2 irá implementar a maioria das necessidades do seu projeto. Observe a imagem abaixo, que retrata a estrutura do K2. Esta imagem foi retirada do website do desenvolvedor. O Joomla não permite subcategorias e fica claro que com o K2 podemos ter várias categorias aninhadas.

9 O caminho lógico para criar e exibir o seu conteúdo no K2 seria: Criar categorias Instalação de campos com grupos Extra Campos de configuração extra Criar itens K2 Criar link Menu As etapas 2 e 3 podem ser ignoradas se você só quer testar o K2. Ela vai lhe poupar tempo, a longo prazo, mas você sempre pode criar os campos extras depois.

10 Painel de Controle Painel de Controle do K2 Barra de Ferramentas Importar conteúdo do Joomla Ao clicar neste botão, todo o conteúdo do Joomla será importado para o K2 e pode parecer estranho, mas é isso mesmo. Preferências A primeira coisa a definir são as preferências Globais, que irão gerenciar todo o funcionamento do K2. As opções são muitas indo desde a apresentação do nome do autor no frontend do website até a replicação de seus artigos em sua conta do twitter, assim distribuídos.

11 1) Configurações de CSS - habilitar ou desabilitar a opção de css do K2 2) Configurações de imagem - definir como o K2 irá se comportar em relação as imagens 3) Disposição e opções de exibição de páginas para o usuário (autor) - definir como o K2 irá se comportar em relação aos usuários com permissão de enviar artigos 4) Opções de Layout & listagem de exibição de Busca, Tag & Data - definir como o K2 irá implementar as tags de busca 5) Comentários - definir se será permitido comentários nos artigos publicados 6) Definições Social - traçe sua estratégia de marketing social 7) Configurações de Feed RSS - defina a configuração de seus feeds 8) Configurações para limpeza do conteúdo - defina como o K2 irá proceder na limpeza de conteúdo publicado 9) Campos de configurações extras - defina a altura e largura dos campos de configurações extra 10) Editando o Frontend - defina as opções de edição via frontend 11) Configurações avançadas - várias configurações avançadas 12) Configurações de Desempenho - defina configurações para melhorar o desempenho do K2 13) Configurações de SEO - defina as suas configurações de SEO. Você pode perceber que são muitas as opções de configuração e as mesmas dependerão do escopo do seu projeto. Faça testes e busque o seu melhor ajuste visando o seu público-alvo e seu projeto.

12 Categorias Gerenciamento de Categorias no K2 Se você estiver criando um novo site com o K2, o primeiro passo é criar a categoria e para tal você pode navegar pelo menu superior do componente -> Categorias ou clicar no ícone Categorias do Painel de Controle e depois no Novo na barra de ferramentas do Gerenciador de Categorias. Interessante observar o ícone Savar e Novo, que salva a categoria e abre a edição para a criação de uma nova. Existem vários parâmetros para as categorias e vamos explorar os mais importantes. * Título: Ajuda a identificar a categoria para o armazenamento de itens. * Título Alias: Isso pode ser deixado em branco, uma vez que será preenchido automaticamente ao salvar ou definir como necessário. * Categoria Pai: Se você estiver criando uma sub-categoria, então você pode especificar qual a categoria pai para criá-la dentro e herdar os parâmetros * Herdar Parâmetros: Há um monte de definições para as categorias, use esta opção para herdar de outra categoria. Isso é ótimo para usar em sub categorias, porque você só precisa configurar um deles, então, todo o resto irá herdar a partir dela. * Grupos de campo extra associados: Você pode selecionar, se houver, qual EFG você gostaria de usar. Se você estiver criando um catálogo, por exemplo, seria interessante criar Grupos e campos extras e desta forma seriam

13 importados. * Pubslihed: Auto-explicativo. * Nível de Acesso: Quem pode ver a categoria. Com as constantes, você pode clicar em Aplicar ou OK e agora terá criado sua primeira categoria. K2 tem uma série de opções de categorias e estes são tratados com maior profundidade no capítulo da categoria. lista de categorias Depois de ter produzido algumas categorias, então você olha um pouco como o below.area imagem. Depois de criar as categorias e subcategorias de nosso projeto, temos a imagem abaixo onde: (*) Tutoriais Joomla - é a categoria pai do nosso projeto Webdesign e Joomla - categoria para publicação de artigos referentes a webdesign e joomla Segurança e Joomla - categoria para publicação de artigos relacionados a segurança e joomla Joomla! for Dummies - categoria para publicação de artigos básicos relacionados a joomla

14 Grupos e campos extras de grupos Gerenciar/Criar Grupos de campos extras Para criar o Grupo Colunistas siga pelo menu superior Grupos de campos extras ou no ícone Preencha o nome do Grupo e clique em Salvar Agora, vamos acessar as categorias criadas e associar o Grupo Colunistas às mesmas. Volte aos Grupos e campos extras e perceberá que as categorias foram associadas

15 Campos extras Gerenciar/Criar Campos extras Agora iremos criar os campos extras para nossos grupos. Acesse o menu superior Campos extras ou clique no ícone Campos extras e depois em novo Nome - o nome do campo Publicado - dispensa comentários Grupo - escolha o grupo ou crie um novo Tipo - selecione o tipo do campo de formulário para o novo campo. Ficou confuso? Um pouquinho de html vai bem. Valor padrão - escolha o valor padrão do campo (*) campos criados em nosso Grupo (*) fica registrado aqui uma preocupação relativa a segurança: Quando criamos os campos estamos criando campos em um form, sem a opção de limitar o tamanho máximo e tipo de caracter permitido. Isto é preocupante e já entrei em contato com o desenvolvedor para saber o que ele pensa.

16 TAGS Gerenciar/Criar TAGS Uma tag é uma palavra-chave (relevante) ou termo associado com uma informação (ex: uma imagem, um artigo, um vídeo) que o descreve e permite uma classificação da informação baseada em palavras-chave. Tags são, usualmente, escolhidas informalmente e como escolha pessoal do autor ou criador do item de conteúdo - isto é, não é parte de um esquema formal de classificação. É um recurso encontrado em muitos sites de conteúdo colaborativo recentes e por essa razão, "tagging" associa-se com a onda Web 2.0. Fonte: wikipedia Para criarmos TAGS no K2 seguimos pelo menu superior TAGS ou clicamos no ícone Tags do Painel de Controle Observe as Tags que criamos para nosso projeto e perceba a sua relevância

17 Itens de conteúdo Criar/Editar ítem de conteúdo Chegou a hora da parte mais importante, criar conteúdo no k2 1) Configurações de cabeçalho Título - título do artigo Título curto - deixe em branco que o k2 completa Tags - digite o início da palavra e um combo será aberto com as tags cadastradas por você Publicado - dispensa comentários Isto é um destaque? - marque sim para apresentar na página inicial Categoria - selecione a categoria do artigo 2) Editor do artigo aba conteúdo Na aba conteúdo iremos digitar o texto relacionado ao artigo normalmente, com a opção de inserirmos uma imagem, quebrarmos o texto com o leia + e trocarmos o editor com o Toogle editor 3) Aba imagem

18 Na aba imagem temos a opção de inserir uma imagem de nossa máquina ou de um servidor remoto para publicarmos em nosso artigo 4) Aba Galeria de imagem Para utilizar esta funcionalidade você precisa adquirir o plugin Simple Image Gallery Pro. Olha lá, não vai usar um piratão! 5) Aba Vídeo Para embedar o vídeo, você precisará do plugin Allvideos. Ele é gratuito e basta baixar, instalar, publicar e usar.

19 Opções de gerenciamento do Vídeo. 6) Aba campos extras (*) Os campos que você criou aparecem para serem integrados ao artigo. 7) Aba Anexos Você pode anexar arquivos ao seu artigo.

20 (*) procure o arquivo em sua máquina e depois clique em salvar. 8) Opções de gerenciamento do ítem São vários os parâmetros para visualização e controle do ítem criado no k2 e vamos explorar os mais relevantes 1) Autor e status de publicação - analogicamente ao Joomla, você pode gerenciar quando o item será publicado e despublicado, seu nível de acesso e apelido do autor. 2) Informações de Metadata

21 Descrição - uma descrição curta para o artigo Keywords - muitos dizem que as palavras-chave são irrelevantes, porém tantos outros descordam. Então, eu uso e têm dado certo. Robôs - deixe em branco ou digite all (para todos os robôs); Noindex(para não ser indexado); Nofollow (para não alavancar os criadores de links para seu website) Autor - deixe em branco ou use o seu domínio (*) Uma boa dica para SEO é o livro GooleMarketing de Conrad Adolpho (*) Comigo têm dado muito certo usar as dicas dele, do blog do webmaster do google e da central do webmaster do Google (*) Duvida? Se liga no resultado! 4) Se quiser esconder os parâmetros basta clicar no

22 Itens de menu Gerenciar/Criar item de menu Para gerenciar/criar itens de menu devemos navegar pelo menu superior -> Menus -> Selecione o menu (Criei um chamado K2) -> e depois escolha K2 nas opções de itens de menu As opções são: (*) Item de menu para um item do K2 (*) Item de menu para Categorias do K2 (*) Item de menu para TAGS do K2 (*) Item de menu para uma página de um usuário em formato de blog (*) Item de menu para itens de um ou mais usuários ou categorias Vamos conhecer cada um deles separadamente.

23 Item de menu do tipo item K2 Item de menu do tipo item K2 Este tipo de item de menu cria um hiperlink para um determinado item do K2. Vamos criar o item de menu e publicar o módulo na posição left do template. Observe a imagem abaixo e vamos esclarecer cada parte apresentada.

24

25 1) Nós marcamos a matéria como destaque e por isso ela recebe a marca Featured 2) Quando estávamos criando o conteúdo nós escolhemos uma imagem que representasse o mesmo, ela fica em destaque nesta área do frontend 3) O conteúdo em si 4) Informações adicionais existentes nos campos extras 5) O avatar e nome do autor do conteúdo 6) O vídeo inserido junto com o artigo 7) A caixa de comentário para que o usuário possa comentar o artigo. (*) É importante frisar que todos os parâmetros são configurados em preferências. (*) Fiz um comentário para testar o funcionamento do componente

26 Item de menu do tipo categorias K2 Item de menu do tipo categorias K2 Exibe uma lista de itens de uma ou mais categorias. 1) A categoria pai Tutoriais Joomla 2) As sub-categorias Webdesign e Joomla, a categoria filho Segurança e Joomla e a categoria filho Joomla for Dummies 3) O conteúdo em destaque que faz parte da sub-categoria Joomla for Dummies da categoria Tutoriais Joomla

27 Item de menu do tipo Tag Item de menu do tipo Tag Cria hiperlink para a Tag selecionada permitindo a filtragem da tag por categoria/ sub-categoria. Serão exibidos itens que possuam a TAG selecionada. (*) eu criei tags e relacionei a todas as categorias. Quanto mais tags você criar, melhor.

28 Item de menu do tipo página de usuário Blog Item de menu do tipo página de usuário Blog Cria um hiperlink para a página do usuário selecionado no formato de Blog. (*) só temos um usuário e ainda não incrementamos a página dele. Ao longo do manual, iremos melhorando até termos completado a página do nosso usuário.

29 Item de menu para itens e usuários adicionados Item de menu para últimos itens ou usuários Podemos criar itens de menu para os últimos itens e usuários inseridos no website. Por enquanto temos pouca coisa, mas ao longo do projeto a tendência é aumentar e melhorar a visualização. É importante observar os parâmetros que fazem parte deste tipo de item de menu. Teste, explore cada um deles e veja o que melhor se aplica ao seu case. Resultado final no frontend de nosso website.

30

31 Produtos em destaque Produtos em destaque Através do ícone produtos em destaque podemos acessar os itens que estão marcados como destaque em nosso projeto. Barra de Ferramentas (*) Toggle featured state - muda o status do destaque (*) Publicar - publica o item (*) Despublicar - despublica o item (*) Mover - move o item para outra categoria (*) Copiar - copia o item para outra categoria (*) Editar - edita o item selecionado (*) Novo - cria um novo item (*) Lixeira - envia o item para a lixeira (*) Preferências - configura a forma como o K2 irá se comportar globalmente

32 Itens na Lixeira Itens na Lixeira Você pode gerenciar os itens na lixeira através do ícone Itens na lixeira. As opções são: Restaurar ou Remover

33 Categorias na lixeira Categorias na lixeira Você pode gerenciar as categorias que foram movidas para lixeira clicando no ícone Categorias na lixeira. As opções são: Restaurar e Remover

34 Comentários Comentários Você pode acessar os comentários efetuados clicando no ícone Comentários Os comentários serão listados. (*) chama a atenção a falta do IP e seu possível banimento, recurso muito utilizado em componentes de comentários.

35 Editar imagens Edição de imagens Você pode editar imagens clicando no ícone Editar imagens do painel de controle (*) será aberto um painel para que você proceda a edição de qualquer imagem.

36 Módulo - Login K2 Módulo de Login K2 Quando instalamos o K2 ele instala vários módulos e plugins embarcados e vamos conhecer o Módulo de Login. Para tal acesse Extensões-> Administrar Módulos-> K2 Login e habilite o mesmo. Os parâmetros do módulo estão abaixo: (*) chamo atenção para a url de redirecionamento do Login e Logout. Após instalar o módulo e mudar posições temos o nosso projeto com a aparência abaixo:

37 (*) Eu registrei um usuário novo e dei a ele permissão para enviar, editar e publicar artigos. Vamos visualizar o menu apresentado para o usuário cout45 quando o mesmo loga no frontend do website. Vamos interagir com ele? 1) Minha página - mostra a página do usuário 2) Minha conta - mostra os dados do usuário, vamos editar para organizar as coisas. O resultado da alteração pode ser visualizado abaixo:

38 3) Moderar comentários dos meus itens

39 Módulo - K2 Comments Módulo K2 Comments O próximo módulo que abordaremos é o K2 Comments que também é instalado nativamente com o K2. Para publicá-lo siga Extensões -> Administrar Módulos -> K2 Comments Configure os parâmetros e publique o módulo. (*) é um módulo que dispensa comentários, basta você escolher os parâmetros adequados ao seu projeto e os comentários estarão listados.

40 Módulo - K2Contents Módulo K2 Contents Este módulo irá listar o conteúdo de acordo com as configurações dos parâmetros escolhidas por você. (*) criei uma nova posição no template para melhor visualização do módulo K2contents. Aos poucos o projeto vai tomando corpo, usando exclusivamente o Componente K2.

41

42 Módulo - K2 Tools Módulo K2 Tools O módulo K2 Tools é um dos mais interessantes e versáteis possibilitando uma gama de funcionalidades ao website. Vamos explorar uma a uma, disponibilizando em nosso projeto de estudo. Para habilitar o módulo siga pelo menu Extensões -> Administrar Módulos -> K2 Tools -> configure os parâmetros, publique e salve. (*) são vários os parâmetros possíveis e vamos explorar os que julgamos mais importantes. No combo de funcionalidades escolhemos qual será a apresentação do módulo, que pode variar de Arquivo até Tag Cloud. No projeto, nós usamos cada tipo possível, para visualizarmos o seu efeito em um projeto. Arquivo Vamos escolher esta opção, configurar e publicar

43 (*) Perceba que ele lista os nossos artigos de acordo com os parâmetros que escolhemos nas configurações específicas deste tipo. Lista de autores Vamos escolher esta opção, configurar e publicar. (*) Perceba que ele lista os autores de acordo com os parâmetros que você determina e permite segmentar o que deve aparecer em cada local. Blog-style Calendar (no options) Vamos escolher esta opção configurar e publicar para termos um calendário em nosso website. (*) ao clicar no dia ele retorna artigos que foram publicados naquele dia, ou seja, uma busca baseada na data de publicação do artigo. Breadcrumbs O caminho de migalhas é um recurso previsto nas webstandards, faz parte da usabilidade e é facilmente implementado pelo módulo K2 Tools. (*) perceba o caminho publicado. Estranhei não ter sido traduzido para o português a Você está aqui. Categories List (Menu) Nesta opção temos uma lista das categorias do K2 em formato de Menu. No exemplo, eu usei a classe _menu do template.

44 Search Box A velha caixa de busca tão presente e necessária em websites. Lembre-se de colocá-la a direita e acima. Category Select Box A ideia é a mesma, simplesmente apresentamos as categorias em uma combo box e ganhamos espaço. Tag Cloud Habilitando esta opção teremos nossa nuvem de TAGS. Abaixo temos o resultado parcial de nosso projeto com a simples utilzação de todas as opções deste módulo. (*) Eu não sei quanto a você, mas estou impressionado com o K2. (*) Para conseguir replicar o módulo, eu apenas usei a opção de copiar módulos do Joomla!

45

46 Usuários Gerenciamento de Usuários Com o K2 podemos gerenciar amplamento os usuários de nosso website. As opções são: 1) Importar usuários do Joomla para as tabelas do K2 2) Criar Grupos de Usuários 3) Disitribuir os usuários dentro dos Grupos Criados Grupos de Usuários Barra de Ferramentas (*) Remover - remove um grupo de usuários (*) Editar - edita um grupo de usuários (*) Novo - criar um novo Grupo (*) Preferências - preferências globais do K2 Grupo Colaboradores do Manual Na imagem abaixo criamos um novo Grupo no K2. Usuários Vamos analisar o gerenciamento de usuários agora. Barra de Ferramentas

47 (*) Importar usuários Joomla! - importa todos os usuários da tabela #_users para o K2 (*) Mover - move os usuários dentro dos grupos disponíveis (*) Remover - remove um usuário (*) Habilitar - habilitar um usuário (*) Desabilitar - desabilita um usuário (*) Editar - edita os dados do usuário (*) Resetar detalhes do usuário - reseta os dados do usuário (*) Preferências - preferências globais do K2 Na imagem abaixo mudamos o grupo de um usuário, do grupo padrão registered para o grupo Colaboradores do Manual.

48 Ajuda Ajuda Você pode encontrar ajuda a respeito do K2 de várias formas, através de documentos oficiais. Fórum/Comunidade e no Portal oficial do desenvolvedor.