Documentação do Anexos

Versão 1.2 - Fevereiro 20, 2008

  1. Introdução
  2. Restrições de Envio
  3. Configurações
  4. Exibir nome de arquivos
  5. Estilizando a Lista de Anexos
  6. Ícones dos Tipos de Arquivos
  7. Avisos
  8. Atualizando
  9. Agradecimentos

Introdução

A extensão 'Anexos' para o Joomla! permite enviar arquivos e anexa-los ao conteúdo dos artigos. 'Anexos' inclui um plugin para mostrar os anexos e um componente para enviar e administrar os anexos. Há opções para controlar quem pode ver e quem pode baixar os anexos, juntamente com várias outras opções para aumentar a flexibilidade e recursos. Nota: todas as opções são controlado na administração do componente. Esta extesão funciona apenas com Joomla! 1.5 ou posterior.

Esta estensão pode ser traduzida e suporta as seguintes linguagens ( além do Português ):

Muito obrigadod aos tradutores! Se você possui interesse em traduzir a extensão para qualquer outra linguagem, entre em contato com o autor (veja como no final). [Voltar ao Início]

Restrições de Envio

Nem todos os tipos de arquivos podem ser enviados. A extensão 'Anexos' não permitirá envio de arquivos que não são autorizados pela Administração de Mídia do Joomla!. Para ver ( ou alterar ) quais tipos de arquivos são permitidos, vá até página das Configuração Global e clique na aba Sistema. Na área Configurações de Mídia, estão as opções para controlar quais extensões de arquivos e tipos mime são permitidos para envio. A extensão 'Anexos' respeita estas limitações. Contudo, as restrições em 'Extensões de Imagens Permitidas (Tipos de Arquivo)’ são ignoradas. [Voltar ao Início]

Configurações dos Anexos

Todas as configurações da extensão 'Anexos' são controlados pela administração do componente. Para acessar estas configurações, vá para área administrativa e selecione "Anexos de Artigos" no menu "Componente". Clique no botão "Parâmetros" no canto direito da barra de ferramentas e você verá uma séride de parâmetros para está extensão. Estes parâmetros incluem o seguinte:
[Voltar ao Inicio]

Mostrar nome de arquivo

Normalmente, quando um arquivo é enviado e listado na lista de anexos, o nome de arquivo completo é exibido como um link para baixar o anexo. Em alguns casos, o nome do arquivo pode ser muito grande para que isto funcione bem. No formulário de envio, há um outro campo chamado "Mostrar nome de arquivo" onde a pessoa que está enviando o arquivo pode inserir um nome alternativo ou uma legenda para ser exibida no lugar do nome do arquivo inteiro. Por exemplo, uma abreviação do nome do arquivo pode ser inserida neste campo. O campo poderá ser editado na parte administrativa do site quando o anexo está sendo editado. Nota: Há uma opção chamada "Tamanho Máximo do nome de arquivo" nas opções do plugin. Ele poderá ser usado para truncar automaticamente o nome do arquivo enviado para mostrar; o nome de arquivo truncado será inserido no campo "Mostar nome de arquivo". [Voltar ao Inicio]

Estilizando a Lista de Anexos

A lista de anexos exibida na página utiliza um 'div' que contem a tabela de anexos. A tabela está associada a algumas classes CSS que permitem ao desenvolvedor do site personalizar a aparência da tabela. Vá ao arquivo CSS na pasta do plugin anexos ( em plugins/content/attachments.css ) para alguns exemplos. Se você desejar alterar o estilo, considere copiar o estilo original e cola-lo ao final do arquivo, e então alterar o nome 'attachmentList' na seção copiada, para outro de sua escolha. Na Admintradação do componente Anexos, altere o parâmetro estilo da tabela de anexos do plugin para o novo nome da classe. Então modifique apropriadamente as definições da classe na seção copiada. Esta abordagem permitirá que você volte rapidamente ao estilo original alterando o parâmetro estilo da tabela de anexos do plugin de volta para o padrão ' attachmentList’. Isto também tem como vantagem que a seção modificada poderá ser copiada para um arquivo separado e reutilizada quando o Anexos for atualizado. Isto também pode ser feito via o comando CSS @import. [Voltar ao Início]

Ícones dos Tipos de Arquivos

A extensão 'Anexos' adiciona um ícone na lista de anexo, a frente de cada anexo. Se você desejar adicionar um novo tipo de ícone, siga os seguintes passos: (1) Adicione um ícone apropriado no diretório 'media/attachments/icons', se um ícone apropriado ainda não existir aqui; (2) Edite o arquivo 'component/com_attachments/file_types.php' e adicione uma linha apropriada no array estático $attachments_icon_from_file_extension associando a extensão do arquivo ao nome do ícone ( qualquer um no diretório media/attachments/icons ). Se isto não funcionar, você talvez precise adicionar uma linha apropriada no array $attachments_icon_from_mime_type. (3) Não se esqueça de fazer uma cópia dos ícones e do arquivo file_types.php atualizado em algum diretório fora dos diretórios do site, antes de fazer uma atualização para uma nova versão do Anexos. [Voltar ao Inicio]

Avisos

[Voltar ao Início]

Atualizando

Se você tiver anexos adionados e quiser preservalos após a atualização, siga os seguintes passos:
  1. Use o phpMyAdmin (ou qualquer outra ferramente de manipulação SQL) para salvar o conteudo da tabela jos_attachments (usando a opção 'Export', use inserções 'Complete' e não 'Extended' para dados)
  2. Desinstale o componente 'Anexos' . Se o Joomla! acusar que não pode deletar o arquivos de mídia, você terá de deletar o diretório /media/attachments manualmente.
  3. Desisntale o plugin 'Anexos’
  4. Agora instale a nova versão descompactando o arquivo da versão e instalando o novo plugin e componente.
  5. Habilite novamente o plugin 'Anexos’.
  6. Finalmente, use o phpMyAdmin para recarregar as informações dos anexos previamente salvas na nova tabela jos_attachments.
  7. Se você estiver atualizando de uma versão anterior a 1.0 para uma pós 1.0 e você tiver anexos antigos, você terá de inserir os valores apropriados para o novo campo 'icon_filename' se logando como administrador e inserindo a URL abaixo no navegador:
    /administrator/index.php?option=com_attachments&task=add_icon_filenames

Note que a desinstalação da extensão 'Anexos' não deletará arquivos enviados anteriormente, mas os removerá da tabela de anexos no bando de dados. Então ao reinstalar uma nova versão do 'Anexos’, você terá apenas de restaurar a tabela de anexos para restaurar os antigos anexos.

Se você decidir não restaurar o banco de dados dos anexos, não esqueça de excluir qualquer arquivo antigo enviado no subdiretório de anexos para eliminar complitos com os nomes de arquivos no futuro.

[Voltar ao Inicio]

Agradecimentos

Muito obrigado para os contribuidores e recursos abaixo [Voltar ao Inicio]
 
Por favor, reporte bugs e sugestões para jmcameron@jmcameron.net ( em inglês ).