mozgbrasil/magento-boxpacker-php55

Módulo de Gerenciamento de Embalagem/Caixa requerido para funcionamento dos métodos de entrega

Monday, September 4, 2017
by mozgbrasil
Repository
1 Watchers
0 Stars
96 Installations

HTML
4 Dependents
0 Suggesters
0 Forks
0 Open issues
5 Versions
1 % Grown

The README.md

valid XHTML , _(*1)

Mozg\BoxPacker

Sinopse

Módulo requerido para funcionamento dos demais módulos de entrega, _(*2)

Motivação

Atender o mercado de módulos para Magento oferecendo um excelente suporte, _(*3)

Característica técnica

Se trata do ambiente para definição das dimensões de cada uma de suas Embalagem/Caixa, _(*4)

No sistema de Gerenciamento de Embalagem/Caixa foram pré-cadastrados registros para as seguintes embalagens no formato Caixa, vinculadas ao devido método de entrega, _(*5)

https://www.correios.com.br/para-voce/envio/embalagens-para-envios, _(*6)

http://www.jadlog.com.br/tamanhos.html, _(*7)

Como a Jamef não disponibiliza em seu site uma tabela semelhante as demais transportadora foi criado apenas um registro genérico vinculado a todos os métodos de entrega, _(*8)

No backend do Magento acesse o menu: MOZG -> Gerenciar Embalagem/Caixa -> cadastre as devidas embalagens que pode ser usado em sua loja, _(*9)

Dessa forma o módulo deve escolher a embalagem que deve adequar os devidos produtos no processo de compra, _(*10)

Como só tem 1 registro associado a Jamef que seria o registro, _(*11)

"Caixa de Encomenda Genérica: Tipo 1, Dimensões (LxCxA): 14 x 18 x 9 cm, PesoMax: 10 kg, Preço: R$ 3,50", _(*12)

Pode ser exibido o retorno, _(*13)

"Dimensões (LxCxA): 49 x 49 x 8 cm | Peso = 9.9 kg não há embalagem associada a essa modalidade de frete ou embalagem compatível para atender as dimensões / peso desse produto", _(*14)

Para ser processado essa consulta do valor de frete você deve cadastrar uma embalagem para atender essa dimensão e a mesma deve atender qualquer produto com dimensões abaixo dessa embalagem, _(*15)

Então se cadastramos uma embalagem com dimensões "(LxCxA): 50 x 50 x 10 cm" essa embalagem deve atender esse produto e pode ser distribuído nessa mesma embalagem diversos outros produtos, _(*16)

Instalação - Atualização - Desinstalação - Desativação

--, _(*17)

Este módulo destina-se a ser instalado usando o Composer, _(*18)

Execute o seguinte comando no terminal, para visualizar a existencia do Composer e sua versão, _(*19)

composer --version

Caso não tenha o Composer em seu ambiente, sugiro ler o seguinte artigo Clique aqui, _(*20)

--, _(*21)

É necessário que o servidor tenha o suporte a extensão ionCube PHP Loader, _(*22)

Para visualizar se essa extensão está ativa em seu servidor, _(*23)

Certique se da presença do arquivo phpinfo.php na raiz do seu projeto, _(*24)

<?php phpinfo(); ?>

Caso não exista o arquivo phpinfo.php na raiz do projeto Magento, crie o mesmo adicionado o conteúdo acima, _(*25)

Acesse o arquivo pelo browser, _(*26)

Em seguida pesquise pelo termo "ionCube PHP Loader", _(*27)

Caso o seu servidor não tenha o suporte a extensão, Clique aqui, _(*28)

Em "Loader Downloads API", efetue download do pacote compatível com o seu servidor, _(*29)

Descompacte o pacote e faça upload do arquivo "loader-wizard.php" para seu servidor, onde será demonstrado o passo a passo para a ativação da extensão, _(*30)

Clique aqui para ver os processos executados, _(*31)

--, _(*32)

Para utilizar o(s) módulo(s) da MOZG é necessário aceitar o Acordo de licença do usuário final, _(*33)

--, _(*34)

Sugiro manter um ambiente de testes para efeito de testes e somente após os devidos testes aplicar os devidos procedimento no ambiente de produção, _(*35)

--, _(*36)

Sugiro efetuar backup da plataforma Magento e do banco de dados, _(*37)

--, _(*38)

Antes de efetuar qualquer atualização no Magento sempre mantenha o Compiler e o Cache desativado, _(*39)

--, _(*40)

Certique se da presença do arquivo composer.json na raiz do seu projeto Magento e que o mesmo tenha os parâmetros semelhantes ao modelo JSON abaixo, _(*41)

{
  "minimum-stability": "dev",
  "prefer-stable": true,
  "license": [
    "proprietary"
  ],
  "repositories": [
    {
      "type": "composer",
      "url": "https?://packages.firegento.com"
    }
  ],
  "extra": {
    "magento-root-dir": "./",
    "magento-deploystrategy": "copy",
    "magento-force": true
  }
}

Caso não exista o arquivo composer.json na raiz do projeto Magento, crie o mesmo adicionado o conteúdo acima, _(*42)

Para instalar o módulo execute o comando a seguir no terminal do seu servidor no diretório do seu projeto

composer require mozgbrasil/magento-boxpacker-php55:dev-master

Você pode verificar se o módulo está instalado, indo ao backend em:, _(*43)

STORES -> Configuration -> ADVANCED/Advanced -> Disable Modules Output

--, _(*44)

Para atualizar o módulo execute o comando a seguir no terminal do seu servidor no diretório do seu projeto

Antes de efetuar qualquer processo que envolva atualização no Magento é recomendado manter o Compiler e Cache desativado, _(*45)

composer clear-cache && composer update

Na ocorrência de erro, renomeie a pasta /vendor/mozgbrasil e execute novamente, _(*46)

Para checar a data do módulo execute o seguinte comando, _(*47)

grep -ri --include=*.json 'time": "' ./vendor/mozgbrasil

--, _(*48)

Para desinstalar o módulo execute o comando a seguir no terminal do seu servidor no diretório do seu projeto

composer remove mozgbrasil/magento-boxpacker-php55 && composer clear-cache && composer update

--, _(*49)

Para desativar o módulo

Antes de efetuar qualquer processo que envolva atualização sobre o Magento é necessário manter o Compiler e Cache desativado, _(*50)
Caso queira desativar os módulos da MOZG renomeie a seguinte pasta app/code/local/Mozg, _(*51)

A desativação do módulo pode ser usado para detectar se determinada ocorrência tem relação com o módulo, _(*52)

Como configurar o método

Você terá os campos a seguir, _(*53)

• Ativar

Para "ativar" ou "desativar" o uso do registro, _(*54)

• Descrição

Indentificação da embalagem, _(*55)

• Largura exterior

Largura exterior em centímetros, _(*56)

Para a medida de 1 milímetro, informe ".01" onde deve ser convertido pelo Magento para "0.0100", _(*57)

Para a medida de 1 centimetro, informe "1" onde deve ser convertido pelo Magento para "1.0000", _(*58)

Para a medida de 1 metro, informe "100" onde deve ser convertido pelo Magento para "100.0000", _(*59)

• Comprimento exterior

Comprimento exterior em centímetros, _(*60)

• Altura exterior

Altura exterior em centímetros, _(*61)

• Largura Interior

Largura interna em centímetros, _(*62)

• Comprimento Interior

Comprimento interno em centímetros, _(*63)

• Altura Interior

Altura interior em centímetros, _(*64)

• Peso da embalagem vazia

Peso da embalagem vazia em Kilos, _(*65)

Para um peso de 8 gramas, informe ".008" onde deve ser convertido pelo Magento para "0.0080", _(*66)

Para um peso de 80 gramas, informe ".08" onde deve ser convertido pelo Magento para "0.0800", _(*67)

Para um peso de 800 gramas, informe ".8" onde deve ser convertido pelo Magento para "0.8000", _(*68)

Para um peso de 1 kilo, informe "1" onde deve ser convertido pelo Magento para "1.0000", _(*69)

• Peso máximo

Peso máximo suportado pela embalagem, _(*70)

• Preço

Preço da embalagem, _(*71)

• Comentário

Comentário, _(*72)

• Método de entrega

Selecione o método de entrega que está relacionado a embalagem, a não seleção deve atender todos os métodos de entrega, _(*73)

Perguntas mais frequentes "FAQ"

Quais os atributos criados que devem ser usado pelos método de entrega?

No processo de instalação do módulo é criado os seguintes atributos de Produto:, _(*74)

ship_separately = Embalar o produto separadamente
ship_width = Largura da embalagem do produto (cm)
ship_length = Comprimento da embalagem do produto (cm)
ship_height = Altura da embalagem do produto (cm), _(*75)

SELECT * FROM `eav_attribute` WHERE `attribute_code` like 'ship_%'

Os atributos relativo a "Comprimento, Largura, Altura" são parâmetros necessários para acomodação dos itens nas embalagens, podendo ser utilizado para envio ao WebService e também ao calculo do peso cúbico, portanto sugiro editar cada produto informando suas medidas, _(*76)

Sobre a utilização de atributo existente

Em nossos métodos de entrega é possivel definir o nome do atributo relativo a dimensão do produto, _(*77)

No uso do módulo Pedroteixeira_Correios, _(*78)

Vemos que os atributos relativos a dimensão estão nomeados como "volume_comprimento, volume_altura, volume_largura" aceitando somente números inteiros, _(*79)

https://github.com/pedro-teixeira/correios/blob/master/app/code/community/PedroTeixeira/Correios/sql/pedroteixeira_correios_setup/install-4.0.0.php#L28, _(*80)