Tutoriais de extensões para usar com Joomla 1.5 parte 01

DOCman - Gerenciando downloads

Esta é a primeira entre uma série de tutoriais que pretendo fazer sobre extensões para Joomla 1.5

Pretendo fazer tutoriais sobre as mais populares, dentre várias das diversas áreas disponíveis.

Boa leitura

Apresentação

DOCman, vincula arquivos com uma descrição e uma licença e você pode dizer quais grupos de usuários poderão fazer o download dos mesmos. O caminho dos arquivos não são revelados, há também há vários templates para modificação e documentação online atualizada.

Nele você pode fazer várias coisas como: Dar aos arquivos "privacidade", com direitos de acesso dos grupos. Pode configurar grupos de usuários para controlar o acesso. Agrupar documentos em categorias e subcategorias. Guardar os arquivos em servidores remotos ou no seu. Visualização de estatísticas de download. Um sistema de busca próprio, onde os arquivos podem ser

procurados por nome ou descrição. Tem um plugin que você pode procurar dentro do sistema do Joomla!

Introdução

Para concluir este tutorial, eu não espero que você seja um expert em Joomla, mas eu espero que você saiba como instalar extensões no Joomla, enviar arquivos, publicar e despublicar conteúdos, habilitar e desabilitar módulos e plugins, criar itens de menu (link do site). Espero que você tenha permissão de escrita de arquivos no seu site e que você tenha também, acesso à área administrativa do mesmo, além de conhecimento básico de internet,. Se você não atende à algum(ns) destes requisitos, sugiro que você primeiro siga meu tutorial em

http://www.slideshare.net/JenniferPayne/aprenda-joomla-15-fcil e faça pesquisas complementares no google sobre o que tiver dificuldade.

Habilidades Necessárias

Primeiro de tudo, o DOCman foi escrito para Joomla 1.0, e está disponível para 1.5 sob o modo legacy. Legacy (legado) é como uma herança deixada para o 1.5 da versão 1.0

Seu funcionamento não é garantido, mas eu ainda não tive problemas com o DOCman.

Vamos ativar o modo Legacy

Utilizando o modo legacy

Ele vem desabilitado por padrão no Joomla 1.5. Vamos ativá-lo:◦Clique em extensions -> Plugin Manager

◦Procure o plugin System-Legacy

Plugin Legacy

Habilite-o clicando no botão vermelho ou marcando o check box à sua esquerda e clicando em “enable” na parte superior à direita da área administrativa

Plugin Legacy

Pode ser encontrado no endereço abaixo: http://extensions.joomla.org/extensions/82/details Instale Você verá uma página como essa

Download do DOCman

Clique em “Add Sample Data”

Instalando dados de exemplo

Uma página parecida com a “home” (Control panel) da área administrativa, não acha?

Estes links estão todos na área do DOCman, em “components”-> “DOCman”

Home: O painél de controle que você viu no slide anterior. Files: Onde você dispões os arquivos que irá oferecer para download. Documents: Você cria uma descrição que você vincula ao arquivo, quem

pode acessá-lo e definir licença de download, Categories: Administração de categorias para vincular os arquivos,

assim como você faz com artigos. Groups: Crie e administre grupos de usuários. Licenses: Administre e defina os termos de licença. Você pode gerenciar

quantas licenças quiser. Statistics: Estatísticas sobre o download dos seus arquivos (quantas

vezes foi “downloadeado”) Download Logs: Você pode “downloadear” os arquivos de log. Configuration: Configurações básicas. Themes: Você pode gerenciar temas para o DOCman. Você pode baixar

novos temas do site do DOCman e utilizar no front-end (procure no Google, o oráculo da vida moderna)

Credits: Quem modificou e o que, no DOCman, desde que foi lançado.

Explorando o DOCman

General -> Caminho ABSOLUTO da pasta (diretório) onde os arquivos serão salvos◦Ex: www.meusite.com/www/dmdocument

Conhecendo as configurações - General

Conhecendo as configurações – Front-End

Section is down? – Se marcado “sim”, impede usuários comuns de visualizar os downloads, útil em fase de teste ou manutenção. Embora, mesmo marcada em “sim”, usuários especiais sempre visualizarão os arquivos.

Extensions for viewing - Extensões permitidas para visualização, utilize o sinal “|”para separar extensões.

Number of documents per page - Números de documentos por página…

Default listing order - Ordenação padrão, pode ordenar por nome, data ou número de cliques

E-mail Group Users? – se marcado “sim” mostra links em cada documento de um grupo, para que possam comunicar-se por e-mail para discutir sobre aquele documento.

Conhecendo as configurações – Front-End

Icon Size – Tamanho do ícone para download. Trim Whitespace – Corta espaço e linhas em branco da saída

do tema, tornando o código mais leve e limpo. Days for new – Por quantos dias um arquivo é considerado

novo Downloads to be hot – Quantos downloads são necessários

para o arquivo ser considerado “Hot”, popular. Se o valor padrão foi 0, não haverá marcação de hot para os arquivos.

Display Licenses? – Mostrar licenças dos arquivos? Process Content Mambots? - Colocar conteúdos de Mambots

através das tags {coloque as tags aqui}, não funciona com todos os mambots. Sugiro que deixe marcado em não (padrão), desde que esse conceito de mambots foi excluído da versão 1.5

Conhecendo as configurações – Front-End

Conhecendo as configurações – Permissions

Guests – Permissões aos visitantes (usuários não-logados).◦ No access – Documentos não são visíveis◦ Browse only – Documentos visíveis, porém não acessíveis.◦ Browse, download and view – Navegar, acessar e visualizar arquivos.

Upload – Indica qual usuário/grupo pode fazer upload de arquivos. Modos http, link e transferência permitidos.

Aprove - Indica qual usuário/grupo pode aprovar/desaprovar um arquivo Publish - Indica qual usuário/grupo pode publicar/despublicar um

arquivo View - Indica qual usuário/grupo pode visualizar e fazer download de

arquivos. Override View –> Creator/Maintainer – Indica quem pode mudar a

visualização dos arquivos, criadores, responsáveis pela manutenção, ambos ou nenhum. Note que um administrador sempre pode mudar esta opção.

Maintain - Indica qual usuário/grupo são considerados responsáveis pela manutenção

Conhecendo as configurações – Permissions

Override Maintain -> Creator/maintainer – Indica quem pode modificar alguém para ser um maintainer, administradores sempre poderão selecionar um maintainer.

Allow individual user permissions – Quando você seleciona “no”, você poderá dar permissões à grupos, mas não à um usuário individualmente. Suas permissões existentes permanecerão, mas ao editar um documento vinculado à um usuário único, você deverá escolher um grupo de usuários no lugar. Selecione não para melhorar performance e memória para base de dados grandes.

Creators – Permissões dadas aos criadores de arquivos. ◦ No access – Arquivos invisíveis◦ Download only – Pode baixar o arquivo◦ Download and Edit – Baixar e editar o arquivo

Conhecendo as configurações – Permissions

Conhecendo as configurações – Upload

Upload – tipos de envio de arquivos◦ Upload a file from computer – Enviar arquivo diretamente da sua máquina◦ Link a file from another server – Vincula um arquivo de outro servidor para o seu◦ Transfer a file from another server to this server – faz o download de um arquivo

em outro servidor para o servidor em que está trabalhando Dica: Segure Ctrl (windows e linux) ou command (mac) para selecionar mais de uma

opção. Max. filesize allowed when uploading – Tamanho máximo de arquivo,

use K/M/G como referência. Não afeta os uploads do back-end do Joomla. Também há um valor no config do php upload_max_filesize que está configurado para 32M

Overwrite files? – Sobrescreve arquivos com mesmo nome Extensions allowed – Extensões permitidas, separadas por “|” sem as

aspas, usuários do backend poderão enviar qualquer tipo de arquivo. User can upload all file types? - Se os usuários registrados puderem

enviar arquivos e esta opção for marcado “sim”, restrições sobre arquivos permitidos será ignorada.

Conhecendo as configurações – Upload

Lowercase names? - Se marcada sim, nomes de arquivos que contém letra maiúscula será convertida para minúscula.

Filenames with blanks: Nomes de arquivos com espaço podem:◦ Allow Blanks – Permite os espaços.◦ Reject – Rejeita o arquivo.◦ Convert to underscore – Converte os espaços para underscore (_)◦ Convert to dash – Converte os espaços para hífen (-)◦ Remove Blanks – Remove os espaços.

Reject filenames: Rejeita arquivos que são importantes para o sistema. Por padrão, arquivos do tipo .htaccess são rejeitados.◦ Dica: Rejeite também $|?|*|& pois é uma abertura de segurança,

para as chamadas “injeções de código” (para aprofundar-se sobre isto) pesquise no google.

Conhecendo as configurações – Upload

Conhecendo as configurações – Security

Anti-leech system? – Previne que outras pessoas possam criar links para os seus arquivos sem sua autorização. (Impede que alguém utilize seu repositório de forma inapropriada)

Allowed hosts – Listas de hosts que podem criar links para seus arquivos, também separados pela barra vertical “|”

Log views? – Salva informações sobre o IP que visualizou um arquivo. Pode incrementar muito o seu banco de dados. Cuidado.

Hide remote links – Esconde a localização real do arquivo no detalhe do arquivo. Usuários com permissão de edição ainda podem ver o endereço. Note que isto não é proteção completa e há outras formas do usuário saber onde estão estes arquivos.

Conhecendo as configurações – Security

No menu que deseja criar o link para o DOCman, escolha o tipo “DOCman”, obviamente e quando aparecer as configurações do link, preencha-as atentando para o parâmetro básico

Se você digitar um número correspondente à uma categoria, a mesma será a categoria de arquivos que será mostrada ao clicar. Para mostrar todas as categorias, basta deixar em branco, como na imagem acima

Criando um link no seu menu

Ao clicar para fazer o download do arquivo, você verá a licença do mesmo (caso esteja ativado nas suas configurações)

Pré-visualizando

Você pode enviar arquivos tanto pelo front-end, como pelo back-end. Caso seu site ainda não tenha um módulo de login no frontend, favor crie um. Logue como o admin e clique no seu link tipo DOCman Clique em “Submit File”, mas antes repare nas outras opções relacionadas ao

arquivo que está aparente...

Preparando arquivos

1. Escolha o tipo de upload, para treinar, escolha a opção “Submit file from your computer”

2. Escolha o arquivo, clique em “Upload”3. Neste terceiro passo, configure informações

sobre o arquivo. Na aba license, defina o tipo de licença do arquivo e se a mesma será mostrada, dê uma descrição para a licença (opcional), na aba Details, defina o CRC Checksum e o MD5 Checksum do arquivo (procure no google se não sabe o que significa).

Passos

Na aba Permissions◦ Viewers - escolha quem poderá visualizar o arquivo◦ Maintainer – Quem será responsável por ele◦ Description – Descrição sobre a permissão (opcional)

Aba Document◦ Title – Título para o arquivo◦ Category – Categoria onde ele será exibido◦ Date – Recebe por padrão a data atual, pode ser modificada◦ Thumbnail – Imagem miniatura referente ao arquivo◦ File – O arquivo que você enviou◦ Homepage – Auto explanatório. Fique certo de colocar o◦ “ http:// ” antes da URL

Aproved – Aprovado Description – Descrição do arquivo

Passos

O DOCman é bem simples de utilizar e eficiente. Eu diria até que auto-explicável a maior parte do tempo.

Vá em Components -> DOCman, no back-end e crie categorias, arquivos, adicione grupos de usuários, publique, despublique, brinque com acessos, enfim, passe algum tempo brincando com o DOCman!

Espero que tenham gostado. Eu apreciaria Se vocês fossem neste post do meu blog http://jennifer-payne.blogspot.com/2009/05/tutorial-docman-area-de-downloads.html e em comentários, pedissem um tutorial sobre outra extensão (darei preferência as marcadas com as tags populares) no site do Joomla.

Considerações

Hoje você aprendeu um pouco sobre esta extensão para Joomla! 1.5, há muitas extensões para ser utilizadas em conjunto com ela. Entre em

http://extensions.joomla.org/extensions/extension-specific/docman-extensions e procure sobre ela.

É um prazer contribuir para a vida de cada um que conseguiu chegar no final deste material, oferecendo conhecimento, algo tão importante.

Caso você encontre algum erro neste meu material, favor entra em contato.

No próximo slide, meus contatos

The End

Jennifer Paynenennypayne@gmail.com

Entrem no grupo de joomla em que eu faço parte da administração

brasjoomla@googlegroups.com

Este grupo é composto por pessoas dinâmicas e gentis que sempre se esforçam para ajudar. Caso você tenha dúvidas ou quer se aprofundar em Joomla!, faça parte! Faremos o possível para ajudar.

Para mais tutoriais e artigos sobre Joomla, acesse meu blog: http://jennifer-payne.blogspot.com

Obrigada!

Sobre mim