在 OpenCart 中设计个性化支付选项：第 3 部分

在 OpenCart 中设计个性化支付选项：第 3 部分

1. 添加新的支付选项

1.1 准备工作

在添加新的支付选项之前，我们需要做一些准备工作。

首先，我们需要了解 OpenCart 的系统框架，以便我们可以正确地调用代码。

其次，我们需要确定我们要添加的支付选项的类型。在本文中，我们将添加一种名为“自定义支付”的类型。

最后，我们需要准备与新支付选项相关的图标和说明文本。

1.2 编写代码

一旦准备工作完成，我们就可以开始编写代码了。

首先，我们需要添加一个新的支付选项模板。在 OpenCart 中，每个支付选项都有一个独特的代码模板，它控制着支付选项的外观和功能。

以下是添加新的自定义支付选项模板的代码：

// 在 catalog/view/theme/your_theme/template/payment 目录下创建一个名为 custom_payment.tpl 的文件
<div class="payment-custom">
  <div class="payment-custom-radio">
    <input type="radio" name="payment_method" value="custom_payment">
  </div>
  <div class="payment-custom-text">
    <p><strong>Custom Payment</strong></p>
    <p>Make a custom payment.</p>
  </div>
</div>

该模板包含一个单选按钮和一个文本区域。当用户选择此选项时，将显示选项的文本区域中的文本。

接下来，我们需要更新选择支付方式页面的控制器。这将允许用户选择自定义支付选项。

以下是更新控制器的代码：

// 在 catalog/controller/checkout/payment.php 文件中复制以下代码
class ControllerCheckoutPayment extends Controller {
  public function index() {
    // Add your custom payment method to the list of payment methods
    $data['payment_methods'][] = array(
      'code'       => 'custom_payment',
      'title'      => 'Custom Payment',
      'terms'      => '',
      'sort_order' => $this->config->get('custom_payment_sort_order')
    );
    
    // Load language file for your custom payment method
    $this->language->load('payment/custom_payment');
    // Continue with the rest of the payment controller code here
  }
}

此代码将更新选择支付方式页面的控制器，以添加您的新支付选项。您需要向 $data['payment_methods'] 数组中添加一个新条目，其中包括支付选项的代码、标题、条件、排序顺序等信息。

2. 配置新的支付选项

2.1 准备工作

现在我们已经添加了新的支付选项模板并更新了选择支付方式页面的控制器，我们需要配置新的支付选项以确保它正常工作。

为此，我们需要在控制面板中添加一个新的支付选项设置页面。

2.2 编写代码

以下是添加支付选项设置页面的代码：

// 在 admin/controller/extension/payment 目录下创建一个名为 custom_payment.php 的文件
class ControllerExtensionPaymentCustomPayment extends Controller {
  private $error = array();
  public function index() {
    // Load language file for your custom payment method
    $this->language->load('payment/custom_payment');
    // Set the title of the payment method page
    $this->document->setTitle($this->language->get('heading_title'));
    // Load model for your custom payment method
    $this->load->model('extension/payment/custom_payment');
    // Save payment method settings if the user has submitted the form
    if (($this->request->server['REQUEST_METHOD'] == 'POST') && $this->validate()) {
      $this->model_extension_payment_custom_payment->setSettings($this->request->post);
      $this->session->data['success'] = $this->language->get('text_success');
      $this->response->redirect($this->url->link('extension/payment/custom_payment', 'token=' . $this->session->data['token'], true));
    }
    // Retrieve payment method settings
    $data['settings'] = $this->model_extension_payment_custom_payment->getSettings();
    // Display payment method settings page
    $data['heading_title'] = $this->language->get('heading_title');
    $data['text_enabled'] = $this->language->get('text_enabled');
    $data['text_disabled'] = $this->language->get('text_disabled');
    $data['entry_status'] = $this->language->get('entry_status');
    $data['entry_sort_order'] = $this->language->get('entry_sort_order');
    $data['button_save'] = $this->language->get('button_save');
    $data['button_cancel'] = $this->language->get('button_cancel');
    // Error messages
    if (isset($this->error['warning'])) {
        $data['error_warning'] = $this->error['warning'];
    } else {
        $data['error_warning'] = '';
    }
    $data['breadcrumbs'] = array();
    $data['breadcrumbs'][] = array(
      'text' => $this->language->get('text_home'),
      'href' => $this->url->link('common/dashboard', 'token=' . $this->session->data['token'], true)
    );
    $data['breadcrumbs'][] = array(
      'text' => $this->language->get('text_extension'),
      'href' => $this->url->link('extension/extension', 'token=' . $this->session->data['token'] . '&type=payment', true)
    );
    $data['breadcrumbs'][] = array(
      'text' => $this->language->get('heading_title'),
      'href' => $this->url->link('extension/payment/custom_payment', 'token=' . $this->session->data['token'], true)
    );
    // Save message
    if (isset($this->session->data['success'])) {
        $data['success'] = $this->session->data['success'];
        unset($this->session->data['success']);
    } else {
        $data['success'] = '';
    }
    // Action URLs
    $data['action'] = $this->url->link('extension/payment/custom_payment', 'token=' . $this->session->data['token'], true);
    $data['cancel'] = $this->url->link('extension/extension', 'token=' . $this->session->data['token'] . '&type=payment', true);
    // Page view
    $this->response->setOutput($this->load->view('extension/payment/custom_payment', $data));
  }
  protected function validate() {
    // Check if the user has permission to modify payment method settings
    if (!$this->user->hasPermission('modify', 'extension/payment/custom_payment')) {
      $this->error['warning'] = $this->language->get('error_permission');
    }
    // Add additional validation rules here
    return !$this->error;
  }
}

该代码将添加一个名为“custom_payment”的新支付选项设置页面。在该页面上，用户将能够配置新的自定义支付选项，例如启用或禁用它，设置它的排序顺序等。

3. 整合新的支付选项

3.1 准备工作

现在我们已经添加了新的支付选项，但它还没有完全整合到 OpenCart 中。

例如，它不会出现在订单支付页面上，用户不能使用它来付款。

3.2 编写代码

以下是将新支付选项整合到订单支付页面的代码：

// 在 catalog/controller/checkout/confirm.php 文件中的 confirm() 方法中添加以下代码
if ($this->session->data['payment_method']['code'] == 'custom_payment') {
    $this->load->language('payment/custom_payment');
    $comment = $this->language->get('text_custom_payment') . "\n\n";
    $comment .= $this->session->data['custom_payment_comment'];
    $this->model_checkout_order->addOrderHistory($this->session->data['order_id'], $this->config->get('custom_payment_order_status_id'), $comment, true);
}

此代码将在订单支付页面中添加一个特定的代码块，以允许用户使用自定义支付选项。

4. 结论

现在，我们已经成功添加了一个新的支付选项，并将其完全整合到 OpenCart 中。

通过搜索和理解 OpenCart 的系统框架，我们可以编写自定义代码来实现我们的需求。