Download the PHP package lliure/picup without Composer
On this page you can find all versions of the php package lliure/picup. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package picup
Trabalhando com Pic-up
Utilização básica
No arquivo referente ao layout, deve se utilizar os comandos javaScript para instanciar o pic-up
É obrigatório definir o name para seu uso. Automaticamente será definido o enctype do seu formulário.
Após submeter o formulário, inicie a classe para realizar o upload
Cortando imagens
Caso queria fazer um corte, poderá usar o metodo cut() da seguinte forma.
simplificando ficaria assim:
caso queria fazer mais de um corte:
O método cut() recebe 4 argumentos, sendo
- @param $widthFinal
- @param $heightFinal
- @param string $type
- c = Corte, corta a imagem centralizada no tamanho escolhido
- o = Objetiva, redimencina para o tamanho final (adciona tranparencia para completar a medida menor, e converte para png)
- p = Proporcional, mantendo a medida maior da imagem igual a medida menor da thumb
- r = Relativo, a medida que estiver faltando é redimencionada para o valor relativo a original
- x [Padrão] = maXimo, corta pelo tamanho escolhido sem alterar as proporções originais
- @param string $posfix
-
@param string|boolean $renderOut
- Nesse campo pode ser configurado o tipo do arquivo a ser salvo
Exemplo: $picup->cut(200, 200, null, '__thumb', 'webp');
Exemplo 2: $picup->cut(400, 400, 'o');
Método toWebp()
Método alias do cut, fazendo uma preconfiguração de corte de 500x500 em modo "p" e convertendo para webp
- @param $w
- @param $h
Método upload()
O método upload trabalha com dois argumentos sendo
- @param $folder
- @param null $files
Onde $folder, é o caminho onde será feito o upload, $files é o array contendo as imagens, esse parametro pode ser null assim utilizando os arquivos originais
Trabalhando com modificações no padrão
Aqui veremos algumas modificações no padrão normal da execução do pic-up
Perceba que temos novos parametros na utilização do pic-up, buttonText, addFunction, deleteImg e content.
buttonText, é o texto usado no botão de seleção das imagens
addFunction, é a função que gera a visualização basica das imagens, tanto já carregadas quando enviadas, é obrigatório o uso de dois argumentos em usa criação no exempo a cima tempos img e opt, o seu return sera exibido na tela para cada imagem carregada ou enviada.
deleteImg, é a função que realiza a visualização da deleção de uma imagem carregada ou enviada no caso, está ocultando seu conteudo, é importe que não seja removido o contet da imagem, pois isso implicara em problemas na execução, é necessario a utilização de um argumento, no exemplo content
content, é um objeto que monta as imagens carregadas, são necessários duas chaves para cada laço id e img, paramos além desse poderão ser utilizados na função addFunction que terão entrada pelo segundo argumento, como no exemplo opt.label
Tratando inputs adicionais
Todo input adicionar deverá passar pelo metodo filterInput() para um pré tratamento, como no exemplo tempo o input label
Fazendo dessa forma o retorno na variavel $_POST['label'] seguindo o exemplo assima será:
Sendo que em new => array() temos os labels das novas imagens, e em original => array() as carregadas
Apagando imagens carregadas
O pic-up retorna após o submit as imagens que foram marcadas para serem apagadas, elas são retornadas na variavel $_POST['picup-delete-content'], que terá um array com o id passado e um boleam 0 para não apagar e 1 para apagar