PHP Coupé

VISÃO GERAL

Esse módulo serve para criar links para download de arquivos, incluindo arquivos de texto, ou scripts PHP. Isso por que, ao invés de exibir o conteúdo de um arquivo de texto ou script no browser, ele - através da alteração de cabeçalho HTTP - força o download deste.

Outra vantagem de se utilizar esse módulo para gerar links de downloads é que, através do parâmetro use_db, os dados dos arquivos baixados (como versão, hora e ip) são armazenados em uma tabela para controle ou criação de um contador de downloads. O script, usado para criar a tabela que salva os dados, acompanha o módulo.

Caso não se queria registrar os downloads em banco de dados, basta setar como no o parâmentro use_db na chamada ao módulo.

Através do parâmentro show_size, o módulo se encarrega de obeter o tamanho do arquivo e exibi-lo ao lado do link.

MODOS DE EXECUÇÃO (MODES)

Esse módulo não possui modos de execução.

PARÂMETROS

• filename - nome do arquivo disponibilizado no servidor
• path - diretório onde o arquivo está armazenado no servidor (padrão 'assets/files/')
• description - exibe uma descrição para o arquivo (texto do link)
• version - indica a versao do arquivo disponibilizado
• show_version - exibir a versão do arquivo ao lado da descrição? (yes | no)
• show_size - exibir o tamanho do arquivo ao lado da descrição? (yes | no)
• use_db - deseja que o download seja registrado no banco de dados? (yes | no)

EXEMPLOS DE USO

[[download?filename=arquivoX.rar]] - Cria um link para download do arquivo arquivoX.rar. Como o parâmentro path não foi definido, por padrão o arquivo deve estar na pasta /assets/files. Como o parâmetro description não foi fornecido, o link gerado terá em seu texto o nome do arquivo.

[[download?filename=arquivoX.rar&description=Filme Arquivo X]] - Cria um link para download do arquivo arquivoX.rar mas agora, ao invés de utilizar o próprio nome do arquivo, utiliza no texto do link uma descrição melhor sobre o que é o arquivo.

[[download?filename=arquivoX.rar&path=/downloads/arquivos/]] - Cria um link para download do arquivo arquivoX.rar agora indicando uma outra pasta aonde o arquivo se encontra no servidor.

[[download?filename=arquivoX.rar&show_size=yes]] - Cria um link para download do arquivo arquivoX.rar exibindo o tamanho do arquivo através do parâmentro show_size com valor yes. Como se pode observar, o tamanho do arquivo não deve ser passado como parâmentro. O próprio módulo calcula o tamanho para poder exibi-lo.

[[download?filename=arquivoX.rar&version=0.1beta&show_version=yes]] - Cria um link para download exibindo ao lado a versão do arquivo disponibilizado. Se o parâmentro version for setado, mas o parâmentro show_version não for setado como yes, a versão NÃO será exibida no link, mas será salva no banco de dados como referência quando usuário fizer o download.

[[download?filename=arquivoX.rar&use_db=no]] - Configurando como no o parâmentro use_db, dizemos ao módulo para não salvar as informações de download no banco de dados. Lembrando que o script, usado para criar a tabela que salva os dados, acompanha o módulo.