opencartbrasil/opencartbrasil

Projeto OpenCart Brasil

v1.3.1 2019-04-16 14:27 UTC

README

OpenCart Brasil

68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f646f776e6c6f6164732f6f70656e6361727462726173696c2f6f70656e6361727462726173696c2f746f74616c2e737667 Última versão Compatibilidade Licença

Apresentação

O projeto OpenCart Brasil é um fork do OpenCart 3, que tem o objetivo de oferecer uma versão do OpenCart otimizada, atualizada e segura, com foco especial no mercado brasileiro, sempre compatível com a última versão estável do OpenCart, e mantendo a licença GPLv3 para garantir que o projeto OpenCart Brasil é livre e sempre será.

Aqui você poderá analisar o código, relatar erros e enviar correções ou melhorias para o projeto.

Recomendamos que todos os desenvolvedores sigam este repositório para receberem atualizações sobre o projeto.

Imagens

Início da instalação:

68747470733a2f2f7777772e6f70656e6361727462726173696c2e636f6d2e62722f696d6167652f636174616c6f672f74657374652d64726976652f696e7374616c6c2e706e67

Página principal da loja:

68747470733a2f2f7777772e6f70656e6361727462726173696c2e636f6d2e62722f696d6167652f636174616c6f672f74657374652d64726976652f66726f6e742d332e302e322e302e706e67

Painel de controle administrativo:

68747470733a2f2f7777772e6f70656e6361727462726173696c2e636f6d2e62722f696d6167652f636174616c6f672f74657374652d64726976652f6261636b2d332e302e322e302e706e67

Diferenciais

  • Suporte para tarefas agendadas.
  • Sistema de afiliados 100% funcional.
  • Campos SKU nas opções dos produtos.
  • Atualização automática do OpenCart Brasil.
  • Melhorias no gerenciamento de sessões do PHP.
  • Melhorias no processo de download e instalação.
  • Melhorias na criptografia das senhas dos clientes.
  • Correção de bugs, melhorias e otimizações no código.
  • O processo de instalação ocorre em português do Brasil.
  • Ferramenta de instalação por linha de comando em português do Brasil.
  • Após a instalação, a loja já estará em português do Brasil com a moeda Real.
  • Todos os dados de demonstração e dados auxiliares já estão em português do Brasil.

Changelog

Para analisar todas as correções, modificações e melhorias realizadas no projeto OpenCart Brasil a cada versão lançada clique aqui.

Roteiro

Tarefas concluídas:

  • Loja 100% traduzida.
  • Atualização automática.
  • Instalação 100% traduzida.
  • Suporte para tarefas agendadas.
  • Campo SKU nas opções dos produtos.
  • Correção nas estátisticas.
  • Correção nos arquivos config.
  • Correção na API do catálogo.
  • Correção na edição de pedidos.
  • Correção no sistema de pontos.
  • Correção no programa de afiliados.
  • Correção no Google Merchant Center.
  • Correção nas campanhas de marketing.
  • Correção no formulário de contato.
  • Correção no formulário de produtos.
  • Correção na biblioteca do carrinho.
  • Correção no envio de e-mail por SMTP.
  • Correção das falhas ao finalizar o pedido.
  • Melhorias nos produtos por downloads.
  • Melhorias no gerenciamento de sessão.
  • Melhorias no startup e framework do core.
  • Melhorias na tradução e no layout de e-mail.
  • Melhorias na comunicação com o banco de dados.
  • Melhorias na criptografia das senhas dos clientes.
  • Melhorias na redefinição de senha do cliente na loja.

Tarefas em andamento:

Próximas tarefas:

  • API REST para inclusão de produtos, clientes, pedidos, etc.
  • Webhook que enviará notificações para aplicações externas.

Requisitos

⚠ Aviso:

Se o seu serviço de hospedagem não lhe oferece versões atualizadas dos softwares citados abaixo, troque de serviço de hospedagem, pois sua loja não pode ficar exposta por causa das falhas de segurança existentes em softwares antigos.

Se você é o profissional que administra os servidores que armazenam os arquivos e dados da loja, não utilize os softwares descritos abaixo em versões antigas. Utilize as versões mínimas recomendadas, sendo o ideal utilizar as versões mais recentes não só por questões de desempenho, mas principalmente por questão de segurança.

Servidores web compatíveis:

  • Apache 2.4 ou superior.
  • Nginx 1.14 ou superior.

OpenSSL:

  • 1.0.1c ou superior.

cURL:

  • 7.34.0 ou superior.

Bancos de dados compatíveis:

  • MySQL 5.5 ou superior (Recomendado 5.7).
  • MariaDB 5.5 ou superior (Recomendado 10.3).

Versões do PHP compatíveis:

  • 5.6 ou superior (recomendado 7.3).

Configurações mínimas necessárias no PHP:

Diretiva Valor
register_globals Off
magic_quotes_gpc Off
safe_mode Off
file_uploads On
allow_url_fopen On
open_basedir none
default_charset UTF-8
max_execution_time 360
upload_max_filesize 100M
post_max_size 100M
memory_limit 128M
session.auto_start Off
session.use_only_cookies On
session.use_trans_sid Off
session.cookie_httponly On
session.gc_maxlifetime 3600

Configurações mínimas recomendadas no MySQL/MariaDB:

Variável Valor Descrição
wait_timeout 30 30 segundos
interactive_timeout 30 30 segundos
max_allowed_packet 16777216 16M

Extensões básicas necessárias no PHP:

  • cURL
  • DOM
  • Fileinfo
  • GD
  • MySQLi
  • Mbstring
  • OpenSSL
  • ZLIB
  • ZIP
  • XML

⚠ Notas:

Não é compatível com sistema operacional Windows utilizando servidor web IIS.

Em breve a versão mínima aceita pelo OpenCart será o PHP 7.1 (recomendado PHP 7.3), pois o suporte para o PHP até as versões 7.0 encerraram em dezembro de 2018, ou seja, não faz sentido continuar o suporte para versões do PHP que os próprios desenvolvedores abandonaram, o que significa que essas versões não receberão correções de bugs e falhas.

Download

Através do site:

Faça o download da última versão estável através de nosso site clicando aqui.

Através do repositório:

Faça o download da última versão estável marcada como latest release clicando aqui.

Utilizando o composer:

composer create-project opencartbrasil/opencartbrasil nome_da_pasta

Utilizando o Git Bash:

git clone https://github.com/opencartbrasil/opencartbrasil.git

Instalação

⚠ Preparativos:

  1. Crie um banco de dados no MySQL para uso da loja.
  2. Crie um usuário no MySQL para uso da loja. Atenção: Em produção utilize um usuário exclusivo para a loja.
  3. Adicione no usuário as permissões de acesso ao banco de dados da loja.

Através do navegador (manual):

  1. Extraia o conteúdo do arquivo zip que você baixou, no servidor em que você irá instalar o OpenCart Brasil.
  2. Renomeie os arquivos config_dist.php e admin/config_dist.php para config.php.
  3. Em ambiente Linux, a permissão incial de todos os arquivos deve ser 644 e de todas as pastas 755.
  4. Através do navegador, acesse o domínio onde estão os arquivos do OpenCart Brasil para iniciar a instalação.
  5. Ao final da instalação a loja estará pronta para utilização.

Através da Interface CLI (automática):

Através da interface de linha de comandos, a loja pode ser instalada automaticamente.

  1. Extraia o conteúdo do arquivo zip que você baixou, no servidor em que você irá instalar o OpenCart Brasil.
  2. No diretório raiz onde estão os arquivos do OpenCart Brasil, execute a linha de comando para iniciar a instalação.
  3. Ao final da instalação a loja estará pronta para utilização.

Exemplo de instalação através da linha de comando no servidor local:

php install/cli_install.php install --db_hostname localhost --db_username root --db_password 123456 --db_database opencartbrasil --username admin --password 123456 --email usuario@dominio.com.br --http_server http://localhost/opencartbrasil/

Lista de parâmetros para instalação através da linha de comando:

Parâmetro Descrição Padrão Obrigatório
db_driver Driver para conexão com o banco de dados. mysqli Não
db_hostname Nome do servidor de banco de dados. localhost Não
db_username Usuário com permissão para o banco de dados. Sim
db_password Senha do usuário com permissão para o banco de dados. Sim
db_database Nome do banco de dados para instalar as tabelas da loja. Sim
db_port Porta para acesso ao banco de dados MySQL. 3306 Não
db_prefix Prefixo adicionado nas tabelas criadas no banco de dados. oc_ Não
username Usuário administrador da loja que será cadastrado durante a instalação. admin Não
password Senha do usuário administrador da loja. Sim
email E-mail do usuário administrador da loja. Sim
http_server Domínio da loja com uma / (barra) no final. Sim

Configurações adicionais

Caso utilize o servidor web Nginx:

Adicione no arquivo nginx.conf dentro do bloco "location / { }":

  location ~ (?i)((\.twig|\.tpl|\.ini|\.log|(?<!robots)\.txt)) { deny all; }

  rewrite ^/sitemap.xml$ /index.php?route=extension/feed/google_sitemap last;
  rewrite ^/googlebase.xml$ /index.php?route=extension/feed/google_base last;
  rewrite ^/system/storage/(.*) /index.php?route=error/not_found last;

  if (!-f $request_filename) { set $rule_0 1$rule_0; }
  if (!-d $request_filename){ set $rule_0 2$rule_0; }
  if ($uri !~ ".*.(ico|gif|jpg|jpeg|png|js|css)"){ set $rule_0 3$rule_0; }
  if ($rule_0 = "321"){ rewrite ^/([^?]*) /index.php?_route_=$1 last; }

Versionamento

Para o controle de versões utilizamos as especificações de Versionamento Semântico

Suporte

Este repositório não é adequado para fornecer suporte sobre a utilização do projeto OpenCart Brasil.

Só registre uma Issue para relatar erros no núcleo do projeto OpenCart Brasil.

Para suporte relacionado sobre a utilização do projeto OpenCart Brasil, utilize o nosso fórum:

https://forum.opencartbrasil.com.br/

Contribuindo

Se você encontrou um erro no núcleo do projeto OpenCart Brasil e deseja nos relatar, você deve registrar uma Issue.

Se você tem uma correção ou melhoria e deseja nos enviar, faça um fork e nos envie um Pull request para avaliarmos.

Vulnerabilidades

Se você descobrir uma vulnerabilidade de segurança no projeto OpenCart Brasil, envie um e-mail para dev@opencartbrasil.com.br. Todas as vulnerabilidades informadas serão imediatamente tratadas caso confirmadas.

Licença

O projeto OpenCart Brasil é um software de código aberto licenciado sob a GPL v3.