Extensão de frete Jadlog - WooCommerce

Este plugin para WooCommerce disponibiliza opções de frete Jadlog no carrinho de compras e implementa integração com a API de solicitações de coleta.

Requisitos

PHP 7.3
MySQL 5.6
Wordpress 5.2 - 5.6
WooCommerce 3.9.3 - 4.9.1
Plugin Brazilian Market on WooCommerce 3.7

Instruções de instalação

Preparação

Instalar o Wordpress;
Instalar e ativar o plugin WooCommerce;
Opcional: instalar e ativar o plugin WooCommerce-Admin;
Instalar e ativar o plugin Brazilian Market on WooCommerce;

Instalação deste plugin

Na página de releases fazer download deste plugin no formato .zip
No painel de administração do Wordpress, faça upload do arquivo .zip em Plugins -> Adicionar novo -> Enviar plugin;
Configure o plugin em WooCommerce -> Configurações -> Aba Jadlog (será necessário fornecer dados do seu contrato com a Jadlog – entre em contato com o Depto. Comercial da Jadlog caso ainda não o tenha feito).

Manual de instalação e uso

Manual de Instalação e Utilização

Ambiente de desenvolvimento

O ambiente de desenvolvimento utiliza imagens Docker e ferramenta Docker Compose.

Após clonar este repositório, rode docker-compose up -d wordpress-dev para subir dois contêineres:

Wordpress (PHP + Apache + Wordpress)
MySQL

Acesse então http://localhost:8080/wp-admin para configurar o Wordpress e ativar os plugins WooCommerce, Brazilian Market on WooCommerce e WooCommerce Jadlog (já devem estar instalados).

Testes

Instale as bibliotecas:

$ docker-compose run --rm composer install

Para rodar todos os testes:

$ docker-compose run --rm codecept run

Para rodar um teste específico:

$ docker-compose run --rm codecept tests/wpunit/WooCommerce/Jadlog/Classes/EmbarcadorServiceTest.php

Para rodar com uma versão específica do Wordpress e/ou WooCommerce, use as variáveis de ambiente $WORDPRESS_VERSION e $WOOCOMMERCE_VERSION, respectivamente:

$ docker-compose rm -s wordpress-test #excluir o container para reconstruir o volume com a versão correta
$ WOOCOMMERCE_VERSION=4.8.0 docker-compose run --rm codecept

Os testes de aceitação rodam com selenium/chrome/webdriver no modo headless. Para rodar no modo visual, abra com VNC o endereço vnc://localhost:<porta vnc do container do chrome> e rode:

$ docker-compose run --rm -e HEADLESS= codecept run acceptance

Upgrade do banco de testes

Quando há atualizações do Wordpress ou WooCommerce, é exigido que o banco de dados também seja atualizado. Assim, é preciso atualizar o arquivo dump woocommerce-jadlog/tests/_data/wordpress_test.sql

Entrar num shell do conteiner wordpress-test:

    $ docker-compose exec wordpress-test bash

Instalar o wp-cli:

    $ curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
    $ chmod +x wp-cli.phar
    $ mv wp-cli.phar /usr/local/bin/wp

Atualizar o esquema do Wordpress:

    $ wp core update-db

Atualizar o esquema do WooCommerce:

    $ wp wc update

Fazer um dump do banco wordpress_test e atualizar o arquivo woocommerce-jadlog/tests/_data/wordpress_test.sql

Error monitoring

Este plugin pode se integrar ao serviço de monitoramento de erros Bugsnag.

Crie uma conta no Bugsnag;
No painel de administração do Wordpress, instale o plugin WordPress Error Monitoring by Bugsnag;
Configure o plugin, inserindo a Bugsnag API Key e os tipos de erros a reportar: Crashes, errors, warnings & info messages;
Agora todas os erros, avisos e mensagens do PHP e logs de erro gerados por este plugin serão enviados ao painel do Bugsnag.

Changelog

v0.5.1
- Alteração de URL's externas da API Jadlog para HTTPS
v0.5.0
- Adição de modalidade econômico
v0.4.0
- Suporte a zonas de entrega. Configuração obrigatória.
v0.3.0
- Suporta Wordpress 5.6 e WooCommerce 4.9
v0.2.1
- Correção de bug nos pedidos de coleta.
v0.2.0
- Modalidade Package.
v0.1.4
- Correção na integração com Brazilian Market on WooCommerce.
v0.1.3
- Correções de bugs.
v0.1.2
- WooCommerce 4.1.1;
- Integração com Bugsnag para monitoramento de erros.
v0.1.1
- Utilização da mesma chave do Embarcador para consulta de PUDOs.
v0.1.0
- Lançamento (versão beta).

Licença

GNU General Public License Version 3

Texto completo em LICENSE.txt.

Desenvolvimento

Jadlog - Uma empresa DPDgroup

Jadlog/woocommerce