Админка opencart: основные разделы и их предназначения

Понимание языков

  • Все языки хранятся в папке (или) в подпапке с названием языка.
  • Языков может быть несколько, каждый отдельный язык храниться в отдельной подпапке.

Содержимое подпапок состоит из:

  1. Языкового массива, который доступен на любой странице (в любом route) (обычно это файл с названием языка, например en.php)
  2. Папок отдельных страниц — для отдельных страниц, зачастую, используется отдельный текст, папки называются аналогично route, файлы — аналогично названиям контроллеров, которые подключают язык с конкретной папки;
  3. Иконки языка (имеет то-же название, что и языковой массив, с расширением png).

Объяснение:

Страница товара имеет маршрут , по этому текст для этой страницы будет находиться в файле,  (обратите внимание как имя файла и подпапка соответствуют маршруту, понимая маршруты будет гораздо проще работать с OpenCart)

Мы разобрались с тем, где находятся языковые файлы, осталось понять как с ними работать:

  • Вся работа с языковыми файлами происходит в контроллере.
  • Для загрузки языка следует использовать метод load() из класса language 
  • После чего, для извлечения текста из массива по ключу можно использовать метод get() 

Значение переменной  назначается в языковом файле, о котором мы говорили выше. В этом файле должен храниться ассоциативныймассив , в котором должен быть доступентекст с ключем text_instock

Если соответствующего ключа не будет в языковых файлах, функция get() вернет передаваемую строку (text_instock).

Таким образом, если в файле  есть строка

Это значит, что переменная $var из нашего примера имеет значение «In Stock», если нет — значение «text_instock»

Также в контроллере доступны общие языковые переменные, для получения которые нет необходимости в их подключении (не нужно использовать метод load, загрузка происходит автоматически).

Uploading OpenCart

At this step you should have a web server established and the OpenCart archive extracted. We will now use File Transfer Protocol (FTP) client to upload these uncompressed files to a web server.

Installing and configuring the FTP client

We recommend using Filezilla as your FTP client. Filezilla is a free FTP client that will transfer the OpenCart files to any web server specified. The FileZilla client (not the server) can be downloaded from http://filezilla-project.org/ and installed onto a computer.

When you open Filezilla you should see your computer’s file directory on the left side. The next step is to locate where you saved the uncompressed OpenCart archive and click on the «upload» folder, and the files should appear below it. The directory needs to be left open as we continue. The right hand side is blank at the moment because the target website hasn’t been connected to. When connected it will display the file directory of the web server.

Before we continue, we need to make sure that you have the following information about your website:

  • the host name
  • username
  • password

This information can be obtained by contacting your hosting provider.

Connecting to the Site Manager

Under the “File” menu, “Site Manager” should be opened in Filezilla. A window will pop up with the General tab open. You should fill in the information gathered above regarding hosting information, and press “Connect”. The right “Remote Site” side will now display the file directory of your website.

Uploading OpenCart’s files

If you haven’t already located the OpenCart upload folder on the left side, you need to do so now and keep it open. In the Remote Site directory (right side), you need to open the folder that the OpenCart shop will be located in. The location of shop varies based on whether the you want the shop to be seen on the main page, a sub-folder, a subdomain, etc. If you want to make OpenCart the main page, you would need to upload files to the root folder of their website.

Be aware that some hosting services require public files to be upload to a public directory, such as public_html, if they are to be visible on the website. You should check with your hosting provider to see where you can upload public files.

Once the location of the OpenCart shop has been determined, all the content within the “upload” folder on the computer’s (left) side of Filezilla must be selected, right-clicked, and uploaded. Uploading all the files might take a few minutes on the FTP client.

If you want the shop to be on the main page, for example www.shopnow.com, you must upload the contents of the “upload” folder, but not the “upload” folder itself. Including the “upload” folder will create a sub-folder, making the shop available only on www.shopnow.com/upload.

After Filezilla finishes uploading the files to the location specified, you should see the same files on both the left side(computer) and on the right side (the website); as seen in the screenshot below:

The Filezilla window should look similar to the above image (minus some directory details). This means that the OpenCart files were successfully transferred the target site. The site now contains the files necessary to setup an OpenCart shop.

Система

Наверное, самый важный пункт меню – это «Система». Здесь собраны все важные настройки ядра магазина. В пункте настроек во вкладке общие вам необходимо ввести название магазина, владельца, адрес магазина, контактные данные. Затем, в следующей вкладке, указать заголовок главной страницы, мета-описание для нее и выбрать шаблон магазина, которых может быть установлено несколько.

Во вкладке «Локализация» нужно установить страну и регион, язык сайта и валюту по умолчанию, а также указать единицы измерения, которые будут использоваться на сайте магазина.

Следующая вкладка «Опции». Сюда входят настройки, которые разбиты по категориям. Каждый пункт настроек имеет пояснение и предупреждения для неопытных пользователей.

Затем идет вкладка «Изображения». Она отвечает за настройки размеров изображений на странице каталога, а также служит для загрузки логотипа и иконки favicon. Вкладки, следующие далее, служат для настройки сервера и работы по ftp, а также электронной почты.

Пункт меню «Дизайн» служи для управления схемами страниц, то есть их внешним видом и баннерами. Добавить баннер очень просто, достаточно только загрузить изображение самого баннера и установить на него ссылку – баннер готов к размещению.

Ниже можно добавлять пользователей на сайт. Эти пользователи будут иметь доступ к администраторской части, но только с теми ограничениями, которые вы для них поставите. Этот пункт существует для того, чтобы например, если у вас есть контент-менеджер, который просто добавляет товары или статьи на сайт, то не давать ему полный доступ к сайту, а ограничить его только необходимыми привилегиями.

Очень важный пункт «Локализация». В данном пункте добавляются такие важные элементы как валюта, языки, страны, регионы, налоги, единицы измерения и др. В данном пункте меню все эти данные просто добавляются на магазин, чтобы потом, в настройках магазина или настройках продаж можно было использовать те или иные страны, языки или валюты. Например, если вы доставляете товар по всем странам СНГ, то необходимо внести этот список стран в пункте «Страны».

Журнал ошибок – это обычный файл, в котором хранятся данные о возникающих ошибках. Этот журнал полезен для разработчиков.

«Бэкап/Восстановление». Этот пункт служит, чтобы делать резервные копии своего магазина, и чтобы в случае ошибок можно было вернуть все в рабочее состояние. Рекомендуется делать резервное копирование перед каждой установкой нового модуля, чтобы избежать непредвиденных ситуаций. В следующих статьях я покажу как это делать.

Basic directory structure

The basic file structure for your module will be divided into two sections, the admin and the catalog folders. The contents of each folder will follow the MVC-L framework respectively, with the difference that the admin will deal solely with backend functionality, and the catalog with frontend functionality. Users of your module will interact and configure its settings in the administration side of the store. Therefore, the files in the admin folder will handle any changes to its settings, the way the module is displayed in the administration, install/uninstalling the module, etc. Likewise, the way the module is displayed and how it works in the front end of the store will be handled by the files in the catalog folder.

The image above displays a skeleton of the directory structure that your module should follow. A good way to get started with your module is to duplicate the folder structure and create the files above. What will go in those files is determined by what your module is trying to accomplish, but the basic functionality is detailed in the sections below.

Модели

Что касается моделей в OpenCart — все их файлы находятся в папках  (), но в отличии от контроллеров, которые группируются на основе маршрута — файлы моделей группируются на основе функции, за которую они отвечаю

  • Подключить модель можно с помощью кода
    $this->load->model(‘folder/file’);
  • Код выше подключит модель к текущему контроллеру, а методы модели станут доступными в объекте
    $this->model_folder_file
  • Вызывать можно только публичные методы модели.

6.1 SQL запросы в моделях OpenCart

Так, как модель отвечает за получение данных — все SQL запросы следует прописывать именно в ней.

Я предполагаю что у читателя уже есть представление о SQL запросах, по этому опишу особенности OpenCart по части работы с ними:

Все SQL запросы выполняются с помощью библиотеки db и ее метода query
$this->db->query($sql_query); 

Внутри SQL запроса, зачастую, можно увидеть константу DB_PREFIX, которая содержит префикс базы данных (префикс задается при установке)

Вот пример запроса в OpenCart:

$query = $this->db->query("SELECT DISTINCT * FROM " . DB_PREFIX . "currency WHERE code = '" . $this->db->escape($currency) . "'");

Метод escape — это обертка для функции mysql_real_escape_string(), которая экранирует специальные символы в строках

После выполения запроса, переменная $query будет содержать объект SELECT запроса, в котором

 содержит данные первой строки

 содержит массив результатов строки, подходящий дляforeach

 вернет количество результатов, которые входя в выборку

После выполнения запроса можно использовать метод, который вернет идентификатор вставленной строки (для INSERT)

Продажи

Третья вкладка – «Продажи». Данный пункт отвечает, соответственно, за все, что связано с продажами. А это: заказы, возвраты платежей, покупатели и клиенты, купоны, сертификаты, партнерские программы и почтовые рекламные рассылки.

Итак, переходим к пункту «Заказы». Здесь собраны все заказы, поступившие в ваш магазин. Чтобы быстро ориентироваться по их списку, предусмотрены фильтры по имени покупателя, номеру заказа, его статусу, общей сумме, а также дате оформления и изменения заказа.

«Возвраты» – пункт аналогичный пункту с заказами, с тем лишь отличием, что здесь собраны только возвращенные заказы.

В пункте меню «Покупатели» хранится информация обо всех клиентах магазина, которые зарегистрировались и согласились оставить у вас свои данные. Информацию о них можно редактировать и удалять. Также есть возможность группировать клиентов, по какому-либо признаку, например по подписке на почтовые рассылки или по половому признаку. Это очень удобно, так как вы сможете информировать только определенную целевую аудиторию о той или иной акции либо распродаже.

Ну и еще один важный пункт, связанный с клиентами – это «Черный список IP». Сюда вы можете помещать IP-адреса тех клиентов, которые, например, совершили какие-то мошеннические действия по отношению к вашему магазину. Черный список полностью запрещает злоумышленнику, имеющему данный IP-адрес, посещение вашего магазина.

Есть в Opencart и возможность предоставления партнерских программ. Суть заключается в том, что вы даете своему партнеру определенный процент с заказа покупателя, которого он привел на сайт магазина. Такая программа хорошо работает как дополнительная реклама вашего бизнеса.

Пункт «Купоны» служит для создания купонов на скидку. Вы можете создать купоны на определенный товар или группу товаров. Все купоны, созданные вами, хранятся в панели администратора, вы в любое время можете их удалить или же отредактировать. Также при создании купона вы задаете дату начала и окончания действия купона. Так что следить за ним вам не придется.

Также в Openсart существуют подарочные сертификаты, которые очень похожи на купоны. Отличие заключается в том, что сертификаты можно использовать лишь один раз и одним клиентом. В случае же, если клиент попытается ввести код сертификата повторно – он получит уведомление о том, что такой сертификат уже был использован.

Вступление

В статье описаны базовые принципы работы OpenCart с моими заметками по их работе. Не пытайтесь заучить содержимое статьи, это не инструкция. Цель этой статьи — дать базовые знания для людей, которые интересуются этой системой управления сайтом (CMS).

Знаю, зачастую люди пытаются собирать сайты на ней самостоятельно, без базовых знаний программирования, но Вам необходимо знать PHP и понимать объектно ориентированное программирование для понимания этой статьи.

После ее прочтения вы получите достаточно теоретических знаний для того, чтобы начать разрабатывать свои собственные дополнения и шаблоны для CMS OpenCart, а также комфортно себя чувствовать при разработке сайтов на ней.

Accessing the admin panel

To access the admin panel, type in location of the store into the web browser followed by «/admin». For example, if your store is located at «www.chocolatechip.com», your admin panel is located at «www.chocolatechip.com/admin». Even if the store is located in a sub-folder or on a sub-domain of their site, adding «/admin» to the end of the store’s path will lead you to the administration side.

If the name of the folder is changed by you during installation, the location of the admin panel is changed to that new name. For example, if the name of the admin folder is changed to admin1, the new location of the admin panel is at «www.chocolatchip.com/admin1».

Changing the name of the admin folder to another name is important for improving an online shop’s security. The config.php file needs to be edited to indicate the correct file path and location.

A username and password is created in Step 3 of the auto-installer during installation. This information can now be used to fill in the administrator login details.

After filling in the correct username and password, pressing the «Login» button will direct you to the OpenCart dashboard. When you first login to your shop, the dashboard will be blank (as seen below), because there isn’t any statistical data to be analyzed yet.

Downloading and unzipping OpenCart archive

The latest version of OpenCart (v.3.0.2.0) can be downloaded from the OpenCart website (recommended for end user) or directly from Github (recommended for web developer). The download page also offers access to previous versions of OpenCart. Under the Downloads column, locate 3.0.2.0 and press the «Download Now» link directly across from it under the Action column. This will download the compressed archive of that version of OpenCart in a zip file. For OpenCart version 3.0.2.0, a file named «3.0.2.0-compiled.zip» will be downloaded.

If you don’t have a program on your computer that can extract files from a zip file, WinRar can be downloaded for free. Unzipping the zip file will uncompress the OpenCart archive so the files can be accessed by a web server.

When opening the zip file, the following files will be visible:

  • «upload» folder
  • «license.txt» file
  • «readme.txt» file

The «upload» folder contains all the files needed to upload OpenCart to a web server. The «license.txt» file contains the license agreement regarding the use of OpenCart on your site. The «readme.text» file provides links to the current install and upgrade instructions on the OpenCart website. When you are ready, you can extract the files from the zip file to a location of your choice on your computer.

Представления

Представления очень сильно изменились с момента релиза OpenCart 3. Здесь я опишу о том, как они работали OpenCart 2 и OpenCart 1.5

Представления (view), как и контроллеры сгруппированы по папкам на основе маршрута (хотя здесь их группировка — не особо важна и несет больше эстетический смысл, так как они могут подключаться из любого контроллера).

Такие файлы находятся внутри папок тем и имеют расширение .tpl (.twig для OpenCart 3+)

Внутри этих файлов находиться html код, разбавленный выводом php переменных (что формируются и передаются в массиве $data в контроллере)

5.1 Как подключить вывод преставления (view) в контроллере

Для того, чтобы подключить view следует использовать библиотеку response совместно с библиотекой load

$this->response->setOutput($this->load->view('account/account', $data));

Метод view библиотеки load подключает файл представления (в него так-же передается массив с данными, которые можно использовать внутри)

Метод setOutput библиотеки response — непосредственно выводит содержимое подготавливает данные вывода (в нашем случае это html код).

5.2 Как работают темы (шаблоны) в OpenCart

Шаблон в OpenCart это файл, папка с файлами представлений, которая переопределяет стандартную тему OpenCart.

Список всех шаблонов можно увидеть в папке 

По умолчанию, OpenCart имеет один шаблон (default). Редактировать файлы этого шаблона — так себе идея. Дело в том, что стандартный шаблон реализует все функциональности, которые есть в OpenCart. Отредактировав стандартный шаблон часть функциональностей может быть утеряна.Кроме того — если в кастомном (который создаете Вы) шаблоне не будет файла view, который подключает контроллер для вывода —этот файл будет взят из default шаблона, таким образом Вам удасться избежать ошибок.

Entering the administration through the Dashboard

The dashboard is the first thing you will see when entering OpenCart’s admin. The main function of the dashboard is to give the shop owner an overview of how the shop is performing. There are 3 sections of the dashboard that can help you understand the statistical data collected by your store:

  • Overview:

    There are four chart showing the status of your website. They are Total Orders, Total sales, Total Customers and People Online which help you to easier to know the analytics.

  • World Map:

    A world map to show where the orders from your website were coming from.

  • Sales Analytics:

    A graph is provided to track the chronological progress of the store relative to the amount of orders and customers over time. The x value is time; which can be hours, days, or months depending on the range selected. The y value displays the number of total orders(yellow) and total customers(blue).

  • Recent Activity:

    A section to check the recent activity from any customer from your store such as login, creating account or placing new orders.

  • Latest Orders:

    A list that displays the last orders and their details («Order ID», «Customer», «Status», «Date Added», «Total», and «Action»)

Above the dashboard in the top menu is the administration navigation. You can navigate between the «Catalog», «Extensions», «Sales», «System», «Reports», and «Help». These sections will be explained in further detail in the following sections of the User Guide.

Перемещение OpenCart 3 на другой сервер

Для того чтобы перенести OpenCart 3 на другой сервер, необходимо выполнить следующие действия.

1. Скопируйте все файлы OpenCart с существующего сервера на новый веб-сервер.1.1. Перенести директорию storage на новый сервер.2. Импортируйте базу данных OpenCart на новый сервер.3. Измените файлы  и . Данные файлы содержат пути к директориям OpenCart, а также данные доступа к базе данных.4. Установите права на директории согласно инструкции по установке.

Обратите внимание!

Если на новом сервере вам не известны новые пути, или вы не уверены в соответствии требований для установки, то вам необходимо на новом сервере сначала установить opencart 3 и после посмотреть на файлы

Экспорт и импорт базы данных лучше всего производить посредством средств предоставленным хостингом, например 

Описание админ-панели OpenCart

Итак, после установки CMS мы имеем две ссылки: на страницу магазина и администраторскую панель. Переходим по второй ссылке и попадаем в админ-панель. Кстати, данная ссылка имеет вид: http:// ваш-домен.ру/admin.

Чтобы войти в панель как администратор вам нужно указать логин и пароль, которые вы вводили при установке Opencart. Вводим и жмем кнопку «Войти». Мы попадаем в самое «сердце сайта».

В верхней части страницы вы увидите меню. При наведении курсора мыши на его пункты выкатываются соответствующие подпункты навигации по страницам настройки магазина. Ниже, в центральной части страницы, располагаются информативные блоки, которые содержат информацию о заказах, их количестве, сумме и т.д., а также статистические данные в виде диаграммы. К тому же, статистику можно просмотреть не только за все время существования магазина, а и за определенный период времени: 24 часа, неделю, месяц или последний год. В нижней части страницы расположился блок, в который попадают новые оформленные заказы.

Frontend module functionality

The frontend of your module follows the same pattern as the admin interface just described. What you will include in each of your frontend files will largely depend on what your module is supposed to do. A module can access any model files that already exist in OpenCart, you do not need to write your own database queries if the same query already exists. For example, the catalog/product model contains many useful queries for fetching products. Using these model functions should be preferred over reinventing the wheel.

A key difference in the frontend of your module, is that your view file will be in the catalog/view/theme/(themename)/template/module folder. This is a significantly deeper folder structure to the admin view file because of themes. An OpenCart store may have many different frontend themes available, but only one admin template. (themename)

On the frontend part of your module you will have access to the configuration options saved by your module, through both the controller’s config object, and the $settings variable passed to the module controller’s index function. You can control aspects of the frontend display on the basis of these settings.

Launch the auto-installer

With a new database freshly created, we are now ready to install OpenCart directly onto a website. You should open up a web browser and enter in the web address of where they uploaded OpenCart. If the «install» folder in «upload» was uploaded correctly, you should be automatically greeted by the following page:

This page is the installation page. The following steps will help you complete the installation process for OpenCart.

Step 2. Pre-Installation

This step checks to see if the web server has the technical requirements and correct permissions to setup OpenCart properly. If red marks are visible on #1 or #2, you need to make sure that these components are properly installed onto the web server. You should contact your hosting service if there are any issues with this. If there are red marks on #3 or #4, there might have been an issue with uploading the files using the FTP client. If everything is configured correctly and green marks are visible (as seen below), you may press «Continue».

As of version 2.3.0.2, the following files need to be renamed to continue to Step 3:

  •     config-dist.php to config.php
  •     admin/config-dist.php to config.php

Step 3. Configuration

You need to fill in the spaces below #1 by adding the database connection details (username/password, database name) established when you created the store’s database using MySQL Databases. Under #2, you should create a new username and password for administration access to the OpenCart shop. When finished, you may press «Continue».

Создание мультимагазина OpenCart 3

Opencart 3 позволяет создать мультимагазин. При таком режиме работы используя только одна БД и единая панель управления. Вы можете добавить неограниченное количество дополнительных магазинов, не выполняя повторной установки движка.

Для того чтобы добавить новый дополнительный магазин, необходимо выполнить следующие действия.

1. В панели управления хостингом создать поддомен и направить его на директорию основного магазина. (как привязать поддомен к директории, узнавайте в справке вашего хостера или у поддержки хостинга)

2. Меню — Система — Настройки и нажать Добавить , далее просто заполнить поля.

3. После добавления дополнительного магазина, вы получите возможность выбора дополнительного магазина, например, при добавлении товара выбирать принадлежность товара к магазину.

Вывод ошибок и просмотр их

Бывают случаи когда ваш магазин показывает просто белый лист и никаких ошибок, но нужный функционал работает не так как нужно. Для этого в OpenCart 3 и существует логи ошибок. Давайте разберемся.

1. По умолчанию все ошибки записываются в лог файл, находящийся в директории storage\logs
А так же ошибки можно увидеть в панеле администратора Меню — Система — Обслуживание — Журнал ошибок

2. После установки модификатора и обновлении его кеша, вы так же можете посмотреть на ошибки, а точнее на лог внесенных или нет изменений
в Меню — Модули / Расширения — Модификаторы вкладка Лог

3. Бывают случаи, особенно при разработке на OpenCart 3 , что мы например выводи неопределенную переменную в шаблон, но ошибки никакой не видим. Причиной этого явления является шаблонизатор TWIG который и скрывает ошибки.
Для их отображения необходимо внести некоторые изменения
после

if ($cache) {
$config = DIR_CACHE;
}

1
2
3

if($cache){

$config’cache’=DIR_CACHE;

}

Добавить

$config = true;

1 $config’strict_variables’=true;

Это позволит управлять из админки (если сделать интерфейс)4. И в заключении. Часто бывают ситуации, когда вы видите просто белый экран, вместо ошибок. Ничего страшного, необходимо просто включить их отображение на сервере. Скорей всего это какая либо ошибка, но вывод ошибок на экран у вас отключен

Кем отключен, не важно.
Наша цель — это увидеть эти ошибки вместо пустой страницы.1. Смотрим в Адмике Меню — Система — Настройки и на вкладке Сервер смотрим крыжики Показывать ошибки и выбираем Да2

Далее, если не помогло, то добавляем в файл .htaccess строчки3. Опять не помогло? Пишем хостеру и просим помощи включить показ ошибок… говорим что наверно хостинг виноват.Источник

Похожие материалы:

Подключение оплаты на сайт через liqpay.com. Оплата liqpay в Opencart

Ошибка 500 internal server error в магазине OpenCart. Решение ошибки 500

Файл .htaccess для магазина OpenCart 2+

Оцените статью
Рейтинг автора
5
Материал подготовил
Андрей Измаилов
Наш эксперт
Написано статей
116
Добавить комментарий