Changes between Version 5 and Version 6 of WF/Downloaddearquivos


Ignore:
Timestamp:
08/14/07 13:56:52 (17 years ago)
Author:
viani
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • WF/Downloaddearquivos

    v5 v6  
     1= DOWNLOAD DE ARQUIVOS = 
     2 
    13== Plugin: wf_download_link == 
     4 
    25'''Descrição:''' Este plugin tem por finalidade criar links para downloads de arquivos. Estes links não apontam para o arquivo que será baixado e sim para uma página que irá enviar o arquivo (útil para arquivos que estão no banco de dados). 
    3  
    4  
    56 
    67'''Parâmetros:''' 
    … …  
    1213  getParams : parâmetro(s) que identifica(m) o(s) download(s). 
    1314 
    14  
    15  
    1615'''Parâmetro obrigatório''': getParams 
    17  
    18  
    1916 
    2017'''Valor padrão''': 
    2118 
    2219  text : "download" 
     20 
    2321  base_url : $_SERVER!['REQUEST_URI'] 
    2422 
    2523  Qualquer outro parâmetro passado será incorporado na tag do link gerado. 
    2624 
    27  
    28   '''Exemplos de utilização:''' 
     25'''Exemplos de utilização:''' 
    2926 
    3027Supondo que o código esteja localizado na URL: ```http://localhost/expresso/index.php?atividade=99``` 
    3128 
     29{{{ 
    3230 
    33   ```{wf_download_link getParams="id_arquivo=1"}``` 
     31{wf_download_link getParams="id_arquivo=1"} 
    3432 
    3533irá produzir: 
    3634 
    37   ```<a href="/expresso/index.php?atividade=99&download_mode=true&id_arquivo=1">download</a>``` 
     35<a href="/expresso/index.php?atividade=99&download_mode=true&id_arquivo=1">download</a> 
    3836 
    3937 
    40  
    41   ```{wf_download_link getParams="id_arquivo=1" text="clique aqui" class="download_css"}``` 
     38{wf_download_link getParams="id_arquivo=1" text="clique aqui" class="download_css"} 
    4239 
    4340irá produzir: 
    4441 
    45   ```<a href="/expresso/index.php?atividade=99&download_mode=true&id_arquivo=1" class="download_css">clique aqui</a>``` 
     42<a href="/expresso/index.php?atividade=99&download_mode=true&id_arquivo=1" class="download_css">clique aqui</a> 
    4643 
    4744 
    48  
    49   ```{wf_download_link getParams="id_arquivo=1&usuario=2"}``` 
     45{wf_download_link getParams="id_arquivo=1&usuario=2"} 
    5046 
    5147irá produzir: 
    5248 
    53   ```<a href="/expresso/index.php?atividade=99&download_mode=true&id_arquivo=1&usuario=2">download</a>``` 
     49<a href="/expresso/index.php?atividade=99&download_mode=true&id_arquivo=1&usuario=2">download</a> 
    5450 
    5551 
    56  
    57   ```{wf_download_link base_url="http://www.outrosite.com/index.php" getParams="id_arquivo=1"}``` 
     52{wf_download_link base_url="http://www.outrosite.com/index.php" getParams="id_arquivo=1"} 
    5853 
    5954irá produzir: 
    6055 
    61   ```<a href="http://www.outrosite.com/index.php?download_mode=true&id_arquivo=1>download</a>``` 
     56<a href="http://www.outrosite.com/index.php?download_mode=true&id_arquivo=1>download</a> 
    6257 
    63  
     58}}} 
    6459 
    6560---- 
    … …  
    6964'''Descrição:''' Esta função gerencia o envio de arquivos solicitados em uma atividade. Esta função deve ser utilizada no arquivo (PHP) que receberá os requests do link gerado com o plugin acima. 
    7065 
    71  
    72  
    7366'''Parâmetros''': 
    7467 
    75   request: variável (estilo array) que será monitorada para verificar a solicitação de um download. Normalmente utiliza-se as variáveis {{$_GET}} ou {{$_POST}}. 
     68  request: variável (estilo array) que será monitorada para verificar a solicitação de um download. Normalmente utiliza-se as variáveis $_GET  ou $_POST . 
    7669 
    7770  callback: o nome de uma função (em string) que será chamada para selecionar o arquivo requisitado. 
    78  
    79  
    8071 
    8172'''Notas sobre a função callback:''' 
    … …  
    9788}}} 
    9889 
    99  
    100  
    10190'''Exemplo completo de utilização (juntamente com o plugin):''' 
    10291 
    10392No arquivo de template (.TPL): 
    10493 
    105  
    106  
    107 ```{wf_download_link getParams="id_arquivo=1&tipo=2"}``` 
    108  
    109  
     94{wf_download_link getParams="id_arquivo=1&tipo=2"} 
    11095 
    11196No arquivo de código (.PHP): 
    … …  
    115100function downloadArquivo($params) 
    116101{ 
    117  
    118102        if ($params['id_arquivo'] == 1) 
    119103        { 
    … …  
    122106                if ($params['tipo'] == 2) 
    123107                { 
    124  
    125108                        $saida['filename'] = "arquivo.txt"; 
    126109                        $saida['content'] = "Conteúdo do tipo 2"; 
    … …  
    128111                        return $saida; 
    129112                } 
    130  
    131113                 
    132114                if ($params['tipo'] == 5) 
    … …  
    138120 
    139121                } 
    140  
    141122                 
    142123                return null; 
    143  
    144124        } 
    145125        else 
    … …  
    149129} 
    150130 
    151  
    152  
    153131wf_handle_download($_GET, "downloadArquivo"); 
    154132 
    … …  
    157135}}} 
    158136 
    159  
    160  
    161137Obs: o parâmetro request pode ser qualquer variável do tipo array associativa (e não somente $_GET e $_POST). Mas, para isso, é necessário que nesta variável esteja definido o elemento "download_mode" com valor "true" (este último sem aspas) quando for requisitado um download.