opencartbrasil/opencartbrasil

Projeto OpenCart Brasil

v1.1.2 2018-11-12 07:13 UTC

README

OpenCart Brasil

68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f646f776e6c6f6164732f6f70656e6361727462726173696c2f6f70656e6361727462726173696c2f746f74616c2e737667 Última versão Compatibilidade Licença

Apresentação

O projeto OpenCart Brasil é um fork do OpenCart, que tem como objetivo atender lojistas brasileiros sempre mantendo a compatibilidade com a última versão estável do OpenCart.

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 ficarem atualizados sobre o projeto.

Imagens

Início da instalação:

68747470733a2f2f7777772e6f70656e6361727462726173696c2e636f6d2e62722f696d6167652f636174616c6f672f74657374652d64726976652f696e7374616c6c2e706e67

Página principal da loja:

68747470733a2f2f7777772e6f70656e6361727462726173696c2e636f6d2e62722f696d6167652f636174616c6f672f74657374652d64726976652f66726f6e742d332e302e322e302e706e67

Painel de controle administrativo:

68747470733a2f2f7777772e6f70656e6361727462726173696c2e636f6d2e62722f696d6167652f636174616c6f672f74657374652d64726976652f6261636b2d332e302e322e302e706e67

Diferenciais

  • Atualização automática do OpenCart Brasil.
  • Melhorias no processo de download e instalação.
  • 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.

Roteiro

Tarefas concluídas:

  • Loja 100% traduzida.
  • Atualização automática.
  • Instalação 100% traduzida.
  • 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.

Tarefas em andamento:

  • Tema versão Brasil 100% customizado.

Próximas tarefas:

  • Cadastro de clientes padrão Brasil.
  • Opções relacionadas nos produtos.
  • Campo SKU nas opções dos produtos.
  • Extensões integradas com serviços brasileiros.
  • API para integração com sistemas externos como ERP, CRM, etc.

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 legadas. No mínimo utilize as versões mínimas recomendadas.

Servidores web compatíveis:

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

OpenSLL:

  • 1.0.1c ou superior.

cURL:

  • 7.34.0 ou superior.

Bancos de dados compatíveis:

  • MySQL 5.5 ou superior.
  • MariaDB 5.5 ou superior.

Versões do PHP compatíveis:

  • 5.6 ou superior.

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

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 do PHP será 7.1, pois o suporte para PHP até 7.0 encerrará em dezembro de 2018.

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.