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
 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!
 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.
 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
 Ele vem desabilitado por padrão no Joomla 1.5.
Vamos ativá-lo:
◦ Clique em extensions -> Plugin Manager

◦ Procure o plugin System-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
 Pode ser encontrado no endereço abaixo:
 http://extensions.joomla.org/extensions/82/details
 Instale
 Você verá uma página como essa
 Clique em “Add Sample Data”
 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.
 General -> Caminho ABSOLUTO da pasta
(diretório) onde os arquivos serão salvos
◦ Ex: www.meusite.com/www/dmdocument
 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.
 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
 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
 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
 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.
 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.
 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.
 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
 Ao clicar para fazer o download do arquivo, você
verá a licença do mesmo (caso esteja ativado nas
suas configurações)
 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...
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).
 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
 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.
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

nennypayne@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!