如何成为OpenCart专家?[关闭]


98

似乎他们没有任何文档,除了在他们的官方论坛上有一些api调用之外。我有Zend框架和CodeIgniter框架的经验。OpenCart的任何高手都可以向我推荐学习它的最佳方法,并在最短的时间内进行掌握吗?我必须尽快做一个大项目。


请参阅docs.opencart.com,以及Qphoria框架概述。还可以浏览OpenCart论坛>支持上的主题。希望将来我们会在Area51.stackexchange.com/proposals/77558/opencart上
Pacerier

这确实是一个重要的问题,有时克服SO标准确实很有帮助...
KAD 2015年

1
非常感谢这个问题,对我有很大帮助
Bipul Roy

@BipulRoy我很高兴!似乎这是一个很受欢迎的问题!
CodeCrack

Answers:


311

OpenCart 1.5.X开发人员入门快速入门指南

本指南是为已经熟悉PHP,OOP和MVC架构的开发人员编写的

在下面的内容中,您将看到购物车目录侧的示例。除了在相关部分中提到的视图外,管理方在功能上是相同的


了解图书馆

所有库功能都可以通过使用,,模型和视图通过Controller访问$this->library_name。所有这些都可以在/system/library/文件夹中找到。例如,要访问当前购物车的产品,您将需要使用Cart类,该类/system/library/cart.php可以使用来访问$this->cart->getProducts()

常用物品

  • customer.php -客户相关功能
  • user.php -管理员用户相关功能
  • cart.php -购物车相关功能
  • config.php -所有设置都从这里加载
  • url.php -URL生成功能

了解路线参数

OpenCart的框架依靠route=aaa/bbb/ccc查询字符串参数中的来知道要加载的内容,并且是查找需要为每个页面编辑的文件的基础功能。实际上,大多数路由仅使用aaa/bbb,应该将其视为两个部分,但是其中一些包含三个部分aaa/bbb/ccc。第一部分aaa通常与通用文件夹(如控制器或模板文件夹)中的文件夹有关。第二部分通常与文件名有关,没有相关.php.tpl扩展名。第三部分在下面的“了解控制器”部分中进行了说明


了解语言

语言存储在子/catalog/language/文件夹的your-language文件夹中。其中,跨页面使用的常规文本值存储在your-language.php文件夹内的文件中,因此对于目录侧的英语,您可以在中找到这些值catalog/language/english/english.php。对于特定的页面文本,您将需要该页面的文本route(通常是这种情况,但并非总是如此,因为您可以指定所需的任何语言文件)。例如,搜索页面具有路线product/search,因此该页面的特定于语言的文本可以在中找到catalog/language/english/product/search.php(请注意,文件名和子文件夹与路径匹配,后跟.php

要在控制器中加载语言,请使用

$this->language->load('product/search');

然后,您可以使用语言库功能get来检索特定的语言文本,例如

$some_variable = $this->language->get('heading_title');

语言变量是使用特殊变量在语言文件中分配的,该特殊变量$_是键和文本值的数组。在您中,/catalog/language/english/product/search.php您应该找到类似的内容

$_['heading_title']     = 'Search';

全局语言文件english/english.php中的值将自动加载,并且无需使用该$this->language->load方法即可使用


了解控制器

控制器是基于加载的route,很容易理解。控制器位于/catalog/controller/文件夹中。从上一个示例继续,“搜索控制器”页面/product/search.php位于此文件夹中。再次注意,使用了跟随的路线.php

打开控制器文件,您将看到Pascal Case类名扩展了Controller名为的类ControllerProductSearch。这再次是特定于路由的,Controller其后是子文件夹名称和文件名,而后缀大写。实际不需要大写,但为了易于阅读,建议使用大写。值得注意的是,类名除了字母和数字外,不从子文件夹和文件名中获取任何值。下划线被删除。

在类中是方法。声明的类中的方法public可通过路由访问- private不能。默认情况下,使用标准的两部分路由(aaa/bbb上述),将index()调用默认方法。如果使用了路线的第三部分(ccc上方),则将改为运行此方法。例如,account/return/insert将加载/catalog/controller/account/return.php文件和类,并尝试调用该insert方法


了解模型

OpenCart中的模型位于/catalog/model/文件夹中,并且根据功能(而非路由)进行分组,因此您需要通过以下方式将其加载到控制器中

$this->load->model('xxx/yyy');

这会将文件加载到xxx名为的子文件夹中yyy.php。然后可以通过对象使用它

$this->model_xxx_yyy

与控制器一样,您只能调用其public方法。例如,要调整图像大小,可以使用tool/image模型并按resize如下所示调用其方法

$this->load->model('tool/image');
$this->model_tool_image->resize('image.png', 300, 200);

从控制器了解视图中的变量分配

为了将值从控制器传递到视图,您只需要将数据分配给$this->data变量,该变量实际上是键=>值对的数组。举个例子

$this->data['example_var'] = 123;

如果您熟悉将每个键转换为变量的extract()方法,则在视图中访问它应该有点容易理解。所以example_var密钥将变成$example_var并且可以在视图中按原样访问。


了解主题

主题仅在目录侧可用,并且基本上是模板,样式表和主题图像的文件夹。主题文件夹放置在/catalog/view/theme/文件夹中,后跟主题名称。文件夹名称并不重要,但default文件夹除外

管理员端使用/admin/view/template/(跳过/theme/theme-name/由于不允许不同的主题从路径中)

模板文件位于template主题文件夹内的文件夹中。如果没有任何模板可用于当前选定的主题,则使用默认文件夹的模板作为后备。这意味着可以使用很少的文件来创建主题,并且仍然可以正常使用。它还可以减少代码重复和升级时的问题


了解视图(模板)

与语言和模型一样,视图文件通常与路径相关,尽管不一定必须如此。/catalog/view/theme/your-theme/template/除非不存在,否则通常会在目录侧找到模板,在这种情况下,将使用默认主题的模板。对于上面的搜索页面示例,文件为product/search.tpl。对于三部分的路线,通常aaa/bbb_ccc.tpl没有硬性规定。在管理员中,大多数页面都遵循此规则,除了页面列表项(例如产品列表页)位于页面中catalog/product_list.tpl以及产品编辑表单位于其中catalog/product_form.tpl。同样,这些没有设置,但是是默认购物车的标准。

模板文件实际上只是另一个php文件,但具有.tpl扩展名,并且实际上在控制器文件中运行,因此,您可以在控制器中进行编码的所有内容都可以在模板文件中运行(尽管除非绝对建议,否则不建议这样做)必要)


了解数据库对象

查询使用

$result = $this->db->query("SELECT * FROM `" . DB_PREFIX . "table`");

DB_PREFIX 顾名思义,是一个包含数据库前缀(如果存在)的常量

$result将返回一个SELECT查询对象,其中包含一些属性

$result->row 如果一个或多个作为关联数组返回,则包含第一行的数据

$result->rows 包含行结果数组,非常适合使用foreach进行循环

$result->num_rows 包含返回的结果数

$this->db对象还有一些其他方法

$this->db->escape()在传递的值上使用mysql_real_escape_string()

$this->db->countAffected 返回受的影响的行数 UPDATE查询依此类推

$this->db->getLastId()使用mysql_insert_id()返回最后一个自动增量ID


了解保留变量

Opencart的已预定义变量使用代替标准的$_GET$_POST$_SESSION$_COOKIE$_FILES$_REQUEST$_SERVER

$_SESSION使用$this->session->data其中data是模拟数组的关联数组进行编辑$_SESSION

其他所有对象都可以使用进行访问$this->request并已被“清除”以符合启用/禁用的魔术引号,因此

$_GET 变成 $this->request->get

$_POST 变成 $this->request->post

$_COOKIE 变成 $this->request->cookie

$_FILES 变成 $this->request->files

$_REQUEST 变成 $this->request->request

$_SERVER 变成 $this->request->server


摘要

尽管以上内容并非针对开发人员的防弹指南,但希望它将为入门者提供一个良好的起点。


3
谢谢!你从哪儿来的?
CodeCrack 2012年

64
我写的。我想这需要写作和适应queston
周杰伦吉尔福特

2
非常好。比大多数指南提供更多信息。您是否有进阶机会?
CodeCrack 2012年

3
应该赋予社区Wiki状态
Stann0rz

1
@UltimateKing-该指南已经为您提供了足够的信息,可帮助您开始制作自己的Mod。网上也有专门针对模块开发的教程
Jay Gilford

36

全局库方法:基本的opencart库功能及其功能,大多数这些都可以从目录或admin文件夹(控制器,模型,视图)中的任何位置调用

CACHE
$this->cache->delete($key) - Deletes cache [product, category, country, zone, language, currency,
manufacturer]

CART
$this->cart->getProducts() Gets all products currently in the cart including options, discounted prices, etc.
$this->cart->add( $product_id, $qty = 1, $options = array()) - Allows you to add a product to the cart
$this->cart->remove( $key ) - Allows you to remove a product from the cart
$this->cart->clear() - Allows you to remove all products from the cart
$this->cart->getWeight() - Sum of the weight of all products in the cart that have require shipping set to Yes
$this->cart->getSubTotal() - returns the subtotal of all products added together before tax
$this->cart->getTotal() - returns the total of all products added together after tax
$this->cart->countProducts() - returns the count of all product in the cart
$this->cart->hasProducts() - returns true if there is at least one item in the cart
$this->cart->hasStock() - returns false if there is at least one item in the cart that is out of stock
$this->cart->hasShipping() - returns true if there is at least one item in the cart that requires shipping
$this->cart->hasDownload() - returns true if there is at least one item in the cart that has a download
associated

CONFIG
$this->config->get($key) - returns setting value by keyname based on application (catalog or admin)
$this->config->set($key, $value) - set the value to override the setting value. DOES NOT SAVE TO DATABASE

CURRENCY
$this->currency->set($currency) - set or override the currency code to be used in the session
$this->currency->format($number, $currency = '', $value = '', $format = TRUE) - format the currency
$this->currency->convert($value, $from, $to) - convert a value from one currency to another. Currencies must
exist
$this->currency->getId() - get the database entry id for the current currency (1, 2, 3, 4)
$this->currency->getCode() - get the 3-letter iso code for the current currency (USD, EUR, GBP, AUD, etc)
$this->currency->getValue($currency) - get the current exchange rate from the database for the specified
currency.
$this->currency->has(currency) - Check if a currency exists in the opencart currency list

CUSTOMER
$this->customer->login($email, $password) - Log a customer in
$this->customer->logout() - Log a customer out
$this->customer->isLogged() - check if customer is logged in
$this->customer->getId() - get the database entry id for the current customer (integer)
$this->customer->getFirstName() - get customer first name
$this->customer->getLastName() - get customer last name
$this->customer->getEmail() - get customer email
$this->customer->getTelephone() - get customer telephone number
$this->customer->getFax() - get customer fax number
$this->customer->getNewsletter() - get customer newsletter status
$this->customer->getCustomerGroupId() - get customer group id
$this->customer->getAddressId() - get customer default address id (maps to the address database field)

DATABASE
$this->db->query($sql) - Execute the specified sql statement. Returns row data and rowcount.
$this->db->escape($value) - Escape/clean data before entering it into database
$this->db->countAffected($sql) - Returns count of affected rows from most recent query execution
$this->db->getLastId($sql) - Returns last auto-increment id from more recent query execution 4

DOCUMENT (*Called from controller only before renderer)
$this->document->setTitle($title) - Set page title
$this->document->getTitle()- Get page title
$this->document->setDescription($description) - Set meta description
$this->document->getDescription()- Get meta description
$this->document->setKeywords()- Set meta keywords
$this->document->getKeywords()- Get meta keywords
$this->document->setBase($base) - Set page base
$this->document->getBase() - Get page base
$this->document->setCharset($charset) - Set page charset
$this->document->getCharset() - Get page charset
$this->document->setLanguage($language) - Set page language
$this->document->getLanguage()- Get page language
$this->document->setDirection($direction) - Set page direction (rtl/ltr)
$this->document->getDirection()- Get page direction (rtl/ltr)
$this->document->addLink( $href, $rel )  Add dynamic <link> tag
$this->document->getLinks()- Get page link tags
$this->document->addStyle( $href, $rel = 'stylesheet', $media = 'screen' )  Add dynamic style
$this->document->getStyles()- Get page styles
$this->document->addScript( $script ) - Add dynamic script
$this->document->getScripts()- Get page scripts
$this->document->addBreadcrumb($text, $href, $separator = ' &gt; ')  Add breadcrumb
$this->document->getBreadcrumbs()- Get Breadcrumbs

ENCRYPT
$this->encryption->encrypt($value) - Encrypt data based on key in admin settings
$this->encryption->decrypt($value) - Decrypt data based on key in admin settings

IMAGE
$this->image->resize($width = 0, $height = 0)

JSON
$this->json->encode( $data )
$this->json->decode( $data , $assoc = FALSE)

LANGUAGE
$this->language->load($filename);

LENGTH
$this->length->convert($value, $from, $to) - convert a length to another. units must exist
$this->length->format($value, $unit, $decimal_point = '.', $thousand_point = ',') - format the length to use
unit

LOG
$this->log->write($message) - Writes to the system error log

REQUEST
$this->request->clean($data) - Cleans the data coming in to prevent XSS
$this->request->get['x'] - Same as $_GET['x']
$this->request->post['x'] - Same as $_POST['x']

RESPONSE
$this->response->addHeader($header) - additional php header tags can be defined here
$this->response->redirect($url) - redirects to the url specified

TAX
$this->tax->setZone($country_id, $zone_id) - Set the country and zone id for taxing (integer)
$this->tax->calculate($value, $tax_class_id, $calculate = TRUE) - Calculate all taxes to be added to the total
$this->tax->getRate($tax_class_id) - Get the rates of a tax class id
$this->tax->getDescription($tax_class_id) - Get the description of a tax class id
$this->tax->has($tax_class_id) - Check if a tax class id exists in opencart

SESSION
$this->session->data['x'] - Same as $_SESSION['x']  

9

有一个OpenCart Wiki网站,其中包含面向初学者的文档。请按照下面提供的网址获取更多详细信息:

http://wiki.opencarthelp.com/doku.php?id=start
http://wiki.opencarthelp.com/doku.php?id=methods_reference

互联网档案链接

http://web.archive.org/web/20160305131349/http://wiki.opencarthelp.com/doku.php?id=start http://web.archive.org/web/20160305131349/http://wiki .opencarthelp.com / doku.php?id = methods_reference

例如,方法参考中包含以下详细信息:

  1. 客户登入
  2. 数据库访问
  3. 购物车处理
  4. 设定档
  5. 快取
  6. 货币处理

仍然有一些页面正在建设中,但这将有所帮助。

[更新]

截至2018年1月,opencarhelp.com域已关闭。


几个月后似乎仍然缺少很多信息。这个项目被放弃了吗?
Pacerier 2014年

@Pacerier,我不确定。
Dharmang 2014年

这是一个很棒的页面,即使打开的购物车Wiki引用了它,也可以在这里看到链接wiki.opencarthelp.com/doku.php?id=opencart_framework
Nassim

4

尽管已经多次回答了这个话题,但我还是想根据我的经验提供另一种掌握OpenCart的方法。

边干边学

通过使用少量文件从头开始创建自己的OpenCart框架,您可以了解所有内容的组合方式。我将为您模仿OpenCart的文件结构。

建立档案 index.php

<?php
// My simpleCart

1.注册表

Opencart使用注册表模式列出所有已加载类的实例。这是您的OpenCart应用程序的心脏。然后将注册表对象传递给每个类别,模型和库,以快速访问其他对象。

用路径创建文件 /system/engine/registry.php

<?php
// Registry class. 
class Registry
{
    private $data = array();

    public function set($key, $value){
        $this->data[$key] = $value;
    }

    public function get($key){
        return (isset($this->data[$key])) ? $this->data[$key] : false;
    }
}

在你的 index.php

<?php
// My simpleCart

//load dependency files
require_once('system/engine/registry.php');

//initialize registry
$registry = new Registry;

2.输出

现在让我们添加一个输出,它将是将来的HTML。毕竟,整个想法是将文本字符串发送到浏览器。

建立档案 system/library/response.php

<?php
class Response {
    private $output;

    public function getOutput() {
        return $this->output;
    }

    public function setOutput($output) {
        $this->output = $output;
    }

    public function output() {
        if ($this->output) {
            echo $this->output;
        }
    }
}

在你的 index.php

<?php
// My simpleCart

//load dependency files
require_once('system/engine/registry.php');
require_once('system/library/response.php');

//initialize registry
$registry = new Registry;

//initialize response
$response = new Response;
//add response object to the registry
$registry->set('response', $response);

//lets set an output as a test
$registry->get('response')->setOutput('Hello World');

//send the output to the client
$registry->get('response')->output();

注意,我仅以示例添加Hello world。我们将进一步删除它。刷新您的网站进行检查。浏览器应显示Hello World

3.控制器

将控制器视为页面。他们将定义将显示给客户端的内容:文本,html,json,下载或图像。现在,我们只需要一个发送文本的页面。

我们将为home页面创建一个控制器。

添加带有路径的文件 catalog/controller/common/home.php

<?php

class ControllerCommonHome{

    private $registry = array();

    public function __construct($registry){
        $this->registry = $registry;
    }

    public function index(){

        $output = 'Home Page';
        //using the registry to get the response object and set the Output
        $this->registry->get('response')->setOutput($output);
    }
}

并编辑您的 index.php

<?php
// My simpleCart

//load registry
require_once('system/engine/registry.php');
//load response
require_once('system/library/response.php');

//initialize registry
$registry = new Registry;

//initialize response
$response = new Response;
//add resoinse object to the registry
$registry->set('response', $response);

//load controller common/home
require_once('catalog/controller/common/home.php');
$controller = new ControllerCommonHome($registry);
$controller->index();

//send the output to the client
$registry->get('response')->output();

注意如何将传递$refistry给ControllerCommonHome,以便可以在控制器内部访问它。

4.路由器

我们不希望对控制器进行硬编码,对。我们将使用route网址中的参数来告诉购物车加载哪个控制器。

使用路径创建文件 system/library/request.php

<?php
class Request {
    public $get = array();

    //for now I just need the $_GET parameter
    public function __construct() {
        $this->get = $_GET;
    }
}

创建负责基于路由初始化Controller文件的Router类(换句话说:动态调用控制器)

<?php
class Router {
    private $registry;

    public function __construct($registry) {
        $this->registry = $registry;
    }

    public function dispatch($route) {
        require_once('catalog/controller/'.$route.'.php');
        $class = "Controller".str_replace('/', '', $route);
        $controller = new $class($this->registry);
        $controller->index();
    }
}

加载到您的 index.php

<?php
require_once('system/engine/registry.php');
require_once('system/engine/router.php');
require_once('system/library/response.php');
require_once('system/library/request.php');

$registry = new Registry;

$response = new Response;
$registry->set('response', $response);

$request = new Request;
$registry->set('request', $request);

//get the route from the url
if(isset($registry->get('request')->get['route'])){
    $route = $registry->get('request')->get['route'];
}else{
    $route = 'common/home';
}

//initiate the router and dispatch it base on the route
$router = new Router($registry);
$router->dispatch($route);


$registry->get('response')->output();

请注意,我是如何将所有内容加载到中$registry,然后将其传递到的$router,然后再将其传递到的$controller

这篇文章已经太长了,但是我希望它能对OpenCart中的MVC模式有一个基本的了解。

如果您希望我继续这篇文章,并告诉您其他事物(例如模型和视图)是如何工作的,请对该答案进行评分,以便我知道。

还要查看我的Youtube https://www.youtube.com/dreamvention和我的博客https://dreamvention.com/blog,我将在那里为您发布更多的提示和教程!


1

PHP是一种相当大的语言,具有5000多个内置函数,因此学习新平台的一种策略是确定它最常使用哪些功能,并花一些时间来很好地了解这些功能。

我已经在OpenCart源代码上运行了一些查询,最常用的10个函数是:

array()
count()
explode()
implode()
mktime()
delete()
time()
date()
sprintf()
list()

此处列出的所有52条代码以及您可以在任何代码库上用来识别常用功能的Linux bash命令:https : //www.antropy.co.uk/blog/efficiency-learning-for-new-opencart-developers/


1

这个youtube视频播放列表也可能有助于成为OpenCart开发人员Gurus:

OpenCart视频教程

  1. 简介和目录本视频介绍了该系列的简介
  2. OpenCart安装localhost该视频通过localhost中的OpenCart安装进行
  3. Opencart的文件和文件夹结构描述OpenCart的文件和文件夹结构
  4. 在OpenCart中创建数据库表架构它显示数据库表架构并显示如何在OpenCart中创建数据库表
  5. OpenCart库预定义对象的方法它描述了OpenCart库预定义对象的方法并显示在何处查找它们。
  6. OpenCart中的MVCL模式,代码流以及请求和响应它显示了OpenCart中的MVCL模式,代码流以及请求和响应。它们描述流程如下图所示: 用代码描述的MVCL

  7. 安装,配置和卸载Opencart模块它显示了三种上传模块,然后安装,配置和卸载OpenCart 3模块/扩展的方法。

  8. Opencart 3中的布局和位置它描述了OpenCart 3的布局和位置。它显示了如何显示不同页面的自定义布局,并给出了类别页面的示例。我们显示了不同类别的不同布局。

  9. Opencart的事件概述您将了解OpenCart中的事件,事件如何工作以及使事件如此有用的原因。

  10. 针对开发人员的Opencart API文档该视频将演示如何使用和制作自定义opencart API

看到这些视频后,您就可以开始编码了:)

By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.