OpenCart para Desenvolvedores

Visão geral

OpenCart é uma plataforma open-source de comércio eletrônico para comerciantes on-line. O OpenCart construído em um framework PHP que pode ser explorado para desenvolver aplicações e adaptações dinâmicas, conforme a necessidade da loja do seu cliente.

Estrutura em Módulos

O OpenCart possui seu código organizado em módulos individuais, onde seus arquivos são agrupados por suas funcionalidades. Para cada módulo existe uma pasta específica.

Instalação do módulo Bling

https://github.com/henriquebling/opencart-bling-ws/tree/master/Plugin%20Opencart%20-%20Bling

Versão 1.5

Para instalar o módulo Bling na versão 1.5 do Opencart, deve-se começar pelo diretório "Plugin Loja", e ir incluindo os arquivos contidos neste na pasta raiz da sua loja, contudo deve-se sempre obedecer a estrutura composta nestes, ou seja,  no diretório "Plugin Loja" esta contido o arquivo "rest_api.php" seguindo a sequencia de diretorios "admin/controller/feed/rest_api.php" é nessa ordem que ele deverá ser incluido no servidor da sua loja. Após ter sido feito esse processo para todos os aquivos do diretório "Plugin Loja", avançamos para o próximo, "Complemento Bling". Neste devemos seguir a mesma regra do passo anterior, seguindo exatamente cada diretório necessário para os arquivos. Abaixo segue algumas considerações para este processo:

ATENÇÃO

• Dentro do diretorio "/catalog/model/" há 2 diretórios (account e catalog), eles referenciam as vendas e produtos respectivamente;
• Os arquivos contidos dentro do diretório "/catalog/model/account/" e "/catalog/model/catalog/" NÃO DEVEM ser substituidos pelos que estão no servidor da sua loja, é necessário abrir os mesmos e copiar o conteudo dos mesmos ao final do arquivo original, antes da última "}";

Versões 2.0, 2.1 e 2.2

Para instalar o módulo Bling nas versões 2.0,2.1 ou 2.2 do Opencart, deve-se começar pelo diretório "Plugin Loja", e ir incluindo os arquivos contidos neste na pasta raiz da sua loja, contudo deve-se sempre obedecer a estrutura composta nestes, ou seja,  no diretório "Plugin Loja" esta contido o arquivo "rest_api.php" seguindo a sequencia de diretorios "admin/controller/feed/rest_api.php" é nessa ordem que ele deverá ser incluido no servidor da sua loja. Após ter sido feito esse processo para todos os aquivos do diretório "Plugin Loja", avançamos para o próximo, "Complemento Bling". Neste devemos seguir a mesma regra do passo anterior, seguindo exatamente cada diretório necessário para os arquivos. Abaixo segue algumas considerações para este processo:

ATENÇÃO

• Dentro do diretorio "/catalog/model/" há 2 diretórios (account e catalog), eles referenciam as vendas e produtos respectivamente;
• Os arquivos contidos dentro do diretório "/catalog/model/account/" e "/catalog/model/catalog/" NÃO DEVEM ser substituidos pelos que estão no servidor da sua loja, é necessário abrir os mesmos e copiar o conteudo dos mesmos ao final do arquivo original, antes da última "}";

Versões  2.3, 3.0 e 3.1

Para instalar o módulo Bling nas versões 2,3, 3.0 e 3.1 do Opencart, só há um diretório a ser instalado o "Complemento Bling". Assim deve-se ir incluindo os arquivos contidos neste diretório na pasta raiz da sua loja, contudo deve-se sempre obedecer a estrutura composta nestes, ou seja,  no diretório "Complemento Bling" esta contido o arquivo "rest_api.php" seguindo a sequencia de diretorios "catalog/controller/feed/rest_api.php" é nessa ordem que ele deverá ser incluido no servidor da sua loja. Abaixo segue algumas considerações para este processo:

ATENÇÃO

•  No seu servidor, dentro de "/catalog/controller/" é necessário criar a pasta "feed" para que assim possa ser incluido o arquivo rest_api.php;
• Dentro do diretorio "/catalog/model/" há 2 diretórios (account e catalog), eles referenciam as vendas e produtos respectivamente;
• Os arquivos contidos dentro do diretório "/catalog/model/account/" e "/catalog/model/catalog/" NÃO DEVEM ser substituidos pelos que estão no servidor da sua loja, é necessário abrir os mesmos e copiar o conteudo dos mesmos ao final do arquivo original, antes da última "}";
• A Secret Key desta versão esta definida como "bling123", caso você queira altera-lá, deve-se acessar o arquivo "rest_api.php" dentro do diretório "/catalog/controller/feed/rest_api.php";

Criação de atributos Personalizados

Na plataforma OpenCart é possível criar atributos específicos para o produto. Para efetuar essas alterações é necessário que esse processo seja feito no arquivo catalog -> controller -> feed -> rest_api.php e no arquivo catalog -> model -> catalog ->  oreder.php/product.php.

OBS: As alterações devem ser refletidas em todas as outras funções referentes a order/product do arquivo rest_api , além disso esses campos são usados somente para importação de dados (Loja->Bling).

Esses atributos podem ser dos seguintes tipos:

Exemplo de Uso