В данной статье мы разберемся как работает система событий в Opencart 2.x, и как ее использовать при написании своих модулей.

Данная система позволяет писать код, который будет выполняться при определенных событиях, происходящих в OpenCart. Такими событиями могут быть:

• создание учетной записи (регистрация);
• оформление заказа;
• редактирование адресов пользователя;

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

Как работают события Opencart 2.x

Для использования системы событий достаточно выполнить два действия:

1. регистрация обработчика событий;
2. реализация обработчика событий;

Обработчики событий — просто методы, определенные в файлах контроллера. Вы можете использовать один файл для всех ваших методов или вы можете создать отдельный контроллер для ваших обработчиков событий.

Для регистрации обработчики событий необходимо использовать модель extension/event (для OpenCart 2.0.1+) или модель tool/event (для OpenCart 2.0.0.0).

В модели extension/event есть 2 метода:

1. addEvent($code, $trigger, $action);
2. deleteEvent($code).

Не сложно догадаться, что функция addEvent() используется для регистрации обработчиков событий, а deleteEvent() используется для отмены регистрации. Это позволяет зарегистрировать свои обработчики событий в методе install() контроллера вашего модуля в admin разделе, а также удалить их, когда ваш модуль удаляется, для чего используется метод uninstall() этого же файла контроллера.

Аргумент $code — используется для группы обработчиков событий. Здесь вы указываете название вашего модуля.

Аргумент $trigger  -название события, на которые вы хотели бы установить обработчик. Список всех доступных триггеров, можно найти здесь: https://github.com/opencart/opencart/wiki/Events-(script-notifications).

Аргумент $action путь к вашей функции обработчика. Указывается в виде стандартного адреса к контроллеру. Например: module/mymodule/on_install.

Пример событий Opencart 2.x

В данном примере предполагается, что мы работаем с OpenCart 2.0.1+. Теперь давайте предположим, что мы создаем модуль под названием «My Module». Файл-контроллер администратора для модуля будет admin/controller/module/mymodule.php. Файл-контроллер каталога для модуля будет catalog/controller/module/mymodule.php.

Модуль будет реализовывать 2 простые функции:

1. отправку сообщения электронной почты администратору, когда удаляется магазин (мультимагазин);
2. отправку сообщения электронной почты администратору при регистрации клиента.

Триггеры, которые мы будем использовать в pre.admin.store.delete и post.customer.add.

Для начала, мы зарегистрируем наши обработчики событий в методе install() нашего модуля:

public function install() {
    $this->load->model('extension/event');
    $this->model_extension_event->addEvent('mymodule', 'pre.admin.store.delete', 'module/mymodule/on_store_delete');
    $this->model_extension_event->addEvent('mymodule', 'post.customer.add', 'module/mymodule/on_customer_add');
}

Мы также должны позаботиться о процессе удаления, и удалить обработчики событий в случае удаления модуля:

public function uninstall() {
    $this->load->model('extension/event');
    $this->model_extension_event->deleteEvent('mymodule');
}

Далее, мы должны реализовать обработчики событий. События, название которых начинается с pre, вызываются перед выполнением действия, а события, название которых начинаются с post — после завершения действия.

Если нам необходимо включить домен магазина в наше сообщение, выбираем событие «pre» вместо «post», т.к. при использовании post.admin.store.delete мы не сможем получить домен магазина.

Событие pre.admin.store.delete генерируется в админке, так что его обработчик должен быть реализован в файле контроллера администратора для нашего модуля. Мы хотим, чтобы наш обработчик событий уведомлял администратора об удалении магазина, и наш обработчик будет выглядеть примерно так:

public function on_store_delete($store_id) {
    $this->load->model('setting/store');
    $store_info = $this->model_setting_store->getStore($store_id);
    $admin_mail = $this->config->get('config_email');
    mail($admin_mail, "A store has been deleted", "The store " . $store_info['url'] . " was deleted.");
}

Все, что осталось сделать, это реализовать обработчик для события post.customer.add. Мы будем делать это в каталоге контроллера нашего модуля. Метод будет уведомлять администратора, когда регистрируется новый клиент и будет выглядеть примерно так:

public function on_customer_add($customer_id) {
    $this->load->model('account/customer');
    $customer_info = $this->model_account_customer->getCustomer($customer_id);
    $admin_mail = $this->config->get('config_email');
    mail($admin_mail, "New Customer", "A new customer has just registered with the following e-mail: " . $customer_info['email']);
}

Внимание: в примере используется функция mail() для отправки электронной почты для простоты. В реальной ситуации для этого необходимо использовать класс OpenCart.

Окончательные версии наших файлов выглядит следующим образом:
admin/controller/module/mymodule.php

<?php class ControllerModuleMyModule extends Controller { public function install() { $this->load->model('extension/event');
        $this->model_extension_event->addEvent('mymodule', 'pre.admin.store.delete', 'module/mymodule/on_store_delete');
        $this->model_extension_event->addEvent('mymodule', 'post.customer.add', 'module/mymodule/on_customer_add');
    }
    
    public function uninstall() {
        $this->load->model('extension/event');
        $this->model_extension_event->deleteEvent('mymodule');
    }
    
    public function on_store_delete($store_id) {
        $this->load->model('setting/store');
        $store_info = $this->model_setting_store->getStore($store_id);
        $admin_mail = $this->config->get('config_email');
        mail($admin_mail, "A store has been deleted", "The store " . $store_info['url'] . " was deleted.");
    }
}

catalog/controller/module/mymodule.php

<?php class ControllerModuleMyModule extends Controller { public function on_customer_add($customer_id) { $this->load->model('account/customer');
        $customer_info = $this->model_account_customer->getCustomer($customer_id);
        $admin_mail = $this->config->get('config_email');
        mail($admin_mail, "New Customer", "A new customer has just registered with the following e-mail: " . $customer_info['email']);
    }
}

Дополнительно

Помимо стандартного использования, система событий может быть использована для создания кросс-модульной интеграции. Используя объект Event ($this->event), вы можете вызвать любое событие в любой точке, а также чтобы вызвать свои собственные события.

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

Класс событий определяется в файле system/engine/event.php, так что вы можете взглянуть на нее для дальнейшего использования.

Заключение

Освоение системы событий в OpenCart выгодно во многих отношениях! И я рекомендую использовать события вместо системы модификации vQmod или OCMOD везде, где это возможно. Это позволит сократить количество глюков и несовместимостей модулей и дополнений других разработчиков с вашими. Также это позволяет создавать и использовать межмодульные связи, так что вы можете сделать несколько модулей, работающих вместе красиво и элегантно.

Данный плагин очень удобный и имеет достаточно настроек, но к сожалению, в нем отсутствует опция блокирования всего контента страницы/статьи, о чем и пойдет речь.

OnePress Social Locker — это один из популярных бесплатных (если не единственный бесплатный) социальных локеров контента для WordPress. Он позволяет блокировать определенный контент на странице при помощи shortcode (шорткодов/тегов, см. изображение). Вы можете создать несколько типов блокировки (текст, оформление блокирующего блока) и использовать для разных кусков контента. Например:

1. Чтобы скачать с сайта — создадим блокировщик с текстом «Ссылка скрыта, подпишитесь на группу чтобы скачать» и ссылка на группу;
2. Чтобы просмотреть отдельную часть статьи — создадим блокировщик с текстом «Контент защищен, поставьте лайк чтобы увидеть» и кнопочки для лайков;

Также, плагин позволяет автоматически закрыть нужный контент в уже существующих записях: вы можете закрыть весь контент или только часть статьи, используя следующие правила:

• количество абзацев после которых дальнейший контент будет заблокирован;
• скрывать контент после тега «Далее» (<!— more —>);

и еще множество других. Но! Если мы скроем контент таким образом, то при необходимости убрать блокировку необходимо будет перелопатить потом вручную все записи, удаляя шорткод. Чтобы не прибегать к такому неудобному способу, было разработано следующее решение: заменить в файле single.php стандартный вывод контента на следующий код:

	 	 
$content = get_the_content();
$content = apply_filters('the_content', $content);
echo do_shortcode('[sociallocker]'.$content.'[/sociallocker]');

Таким образом весь контент нашей статьи будет обернут в shortcode блокировщика и его можно будет, спустя некоторое время, безболезненно и быстро убрать, при этом не редактируя все записи на вашем сайте.

Таким образом, разработчик не может установить модификации на Opencart 2 используя стандартный Extension Installer. Но для решения этой проблемы существует решение, достаточно простое и красивое. Достаточно лишь модифицировать несколько строк кода!

Итак, для изменения алгоритма работы установщика дополнений в Opencart 2.x необходимо модифицировать файл admin/controller/extension/installer.php

Далее необходимо найти строку, где указан шаг с использование FTP соединения для копирования файлов дополнения на сервер (~133 line):

'url'  => str_replace('&', '&', $this->url->link('extension/installer/ftp', 'token=' . $this->session->data['token'], 'SSL')),

Как видим в троке идет обращение к функции FTP, соответственно, для обхода данного шага нам необходимо изменить имя вызываемой функции на имя нашей функции, которую мы добавим в файл далее. Для этого заменим вышеупомянутую строку на следующую:

'url'  => str_replace('&', '&', $this->url->link('extension/installer/localcopy', 'token=' . $this->session->data['token'], 'SSL')),

После этого нам необходимо добавить собственно саму функцию localcopy(), код которой расположен ниже, в любое удобное место, например, перед строкой (~535 line):

public function clear() {

Размещаем код функции localcopy() и установщик расширений OpenCart 2.x будет работать без настроек FTP!

public function localcopy() {
	$this->load->language('extension/installer');
	$json = array();

	if (!$this->user->hasPermission('modify', 'extension/installer')) {
		$json['error'] = $this->language->get('error_permission');
	}

	$directory = DIR_UPLOAD . str_replace(array('../', '..\\', '..'), '', $this->request->post['path']) . '/upload/';
	if (!is_dir($directory)) {
		$json['error'] = $this->language->get('error_directory');
	}

	if (!$json) {
	// Get a list of files ready to upload
	$files = array();
	$path = array($directory . '*');

		while (count($path) != 0) {
			$next = array_shift($path);
			foreach (glob($next) as $file) {
				if (is_dir($file)) {
					$path[] = $file . '/*';
				}
				$files[] = $file;
			}
		}

	$root = dirname(DIR_APPLICATION).'/';

		foreach ($files as $file) {
		// Upload everything in the upload directory
		$destination = $root.substr($file, strlen($directory));

			if (is_dir($file)) {
			$list = glob(rtrim($destination, '/').'/*');

				if (!file_exists($destination)) {
					if (!mkdir($destination)) {
						$json['error'] = sprintf($this->language->get('error_ftp_directory'), $destination);
					}
				}
			}

			if (is_file($file)) {
				if (!copy($file, $destination)) {
					$json['error'] = sprintf($this->language->get('error_ftp_file'), $file);
				}
			}
		}
	}

	$this->response->addHeader('Content-Type: application/json');
	$this->response->setOutput(json_encode($json));
}

Надеюсь данная статья была полезной и вы нашли ответ, который искали. Ставте like, подписывайтесь, впереди еще много интересного!

В данном посте мы рассмотрим установщик расширений, принцип его работы, затронем тему vQmod в OpenCart 2.x, а также рассмотрим новые возможности, предоставляемые OpenCart 2.

Установщик расширений OpenCart 2.x

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

Для начала рассмотрим из чего состоит сам архив модуля .ocmod:

1. новые файлы (файлы модуля) — файлы для загрузки (которые не затирают основные файлы движка), находящиеся в папке upload;
2. файл install.sql для добавления таблиц в базу данных (если необходимо);
3. файл install.xml в котором хранятся инструкции по модификации основных файлов CMS Opencart (основан на принципе xml-файлов vQmod);
4. файл install.php который содержит код, который будет выполнен во время установки.

Как видно на скриншоте выше, структура папок в папке upload полностью повторяет стандартную структуру папок Opencart. В этих папках расположены файлы, которые будут скопированы на сервер при установке расширения.

Установка расширения происходит в несколько этапов:

1. загрузка и распаковка (в случае если это архив) файлов на сервер во временную папку system/upload/;
2. если это просто .XML файл, то его содержимое будет записано в таблицу oc_modification и на этом установка закончена, а если же это архив с файлами (как в примере), то он будет разархивирован во временное хранилище;
3. проверка доступа к FTP (доступ к FTP настраивается в настройках магазина);
4. загрузка файлов из папки upload модуля;
5. выполнение запросов из .SQL файла (обновление базы данных);
6. внесение правок в существующие файлы из .XML файла (см. п.2);
7. выполнение кода из .PHP файла (спасибо, Андрей Брус);
8. проверка какие файлы будут модифицированы в ходе установки, для того чтобы выдать вам их список в окне и ожидание подтверждения об установке.

В конечном итоге мы получаем скопированные новые файлы в папках нашей CMS, XML файл со сценарием (инструкциями) модификации в базе данных, и кеш этих самых модификаций в папке system/modification.

В целом система достаточно интересная и удобная для конечного пользователя, но не для разработчика. Почему? Потому что чтобы править модификации (инструкции к изменению файлов) необходимо править базу данных. При использовании классического vQmod для OpenCart для этого было достаточно править файл.

Кроме очевидного минуса с точки зрения удобства модификации инструкций, присутствует определенный плюс в данном методе хранения модификаций для файлов — более защищенное хранилище. Так как в базу данных мало кто имеет доступ, а на FTP могут иметь доступ многие (например для загрузки картинок на сервер), то данный метод может иметь преимущество, однако не стоит забывать что и на FTP можно дать доступ к определенной папке. (:

Для себя я сделал вывод, что данная система интересная, новая, удобная, но не для разработчика (: Будем следить дальше за развитием OpenCart 2, и за развитием модификаций и расширений для этой платформы.

Установка vQmod на OpenCart 2.x

Многие разработчики спрашивали, возможно ли использование vQmod как на предыдущих версиях OpenCart, и мой опыт говорит о том что можно! Просто установите его как обычно и пользуйтесь на здоровье. Если возникли проблемы, или вы располагаете иной информацией — пишите в комментариях.

OpenCart triggers

Работая над одним из проектов, я обнаружил в коде интересную строку:

$this->event->trigger('pre.admin.attribute.add', $data);

UPD: чатайте полный обзор в статье система событий в Opencart 2.x: как использовать event

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

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

$this->event->register('post.admin.attribute.add', 'checkout/order/send_email');

Однако больше информации внятной найти не удалось, если вы нашли что-то интересное или сами разобрались — пишите, дополним статью.

Подведем итог

В целом система развивается, обростая новыми и новыми функциями и фишками, оценить которые однозначно и объективно достаточно сложно. С моим мнением вы ознакомились, а ваше мнение буду рад прочитать в комментариях.

Надеюсь, очередной небольшой экскурс по новым фукнциям OpenCart 2.x был вам полезен и вы подчерпнули много новой и полезой для себя информации. Спасибо за внимание.

UPD: ознакомьтесь с системой событий и триггеров ($this->event) в новой статье система событий в Opencart 2.x: как использовать event

Однако, необходимо было решить задачу, и я нашел решение. Что ж, давайте вместе разберемся с данной проблемой.

В процессе написания плагинов и модулей для Opencart, в контроллере можно получить доступ к настройкам самого магазина, или же отдельных модулей, однако каково было мое удивление, когда при разработке модуля SEO URL для многоязычного интернет магазина, при обращении к массиву конфигурации $this->config->get(‘config_language’) я получал текущий язык, который выбрал пользователь.

То есть в данном массиве хранится код языка, на котором пользователь просматривает интернет магазин, и отнюдь не язык по-умолчанию: если по-молчанию стоит русский язык, а пользователь зашел и выбрал английский, то значение переменной $this->config->get(‘config_language’) будет «en».

Дело в том, что в файле index.php, где формируются все основные конфигурационные массивы и данные в данную переменную записывается значение текущего языка! Вот строки файла index.php, в которых видно, как в переменную заносится значение текущего языка:

if (isset($session->data['language']) && array_key_exists($session->data['language'], $languages) && $languages[$session->data['language']]['status']) {
$code = $session->data['language'];
} elseif (isset($request->cookie['language']) && array_key_exists($request->cookie['language'], $languages) && $languages[$request->cookie['language']]['status']) {
$code = $request->cookie['language'];
} elseif ($detect) {
$code = $detect;
} else {
$code = $config->get('config_language');
}

if (!isset($session->data['language']) || $session->data['language'] != $code) {
$session->data['language'] = $code;
}

if (!isset($request->cookie['language']) || $request->cookie['language'] != $code) {
setcookie('language', $code, time() + 60 * 60 * 24 * 30, '/', $request->server['HTTP_HOST']);
}

$config->set('config_language_id', $languages[$code]['language_id']);
$config->set('config_language', $languages[$code]['code']);

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

$this->load->model('setting/setting');
$store_settings_config = $this->model_setting_setting->getSetting("config", $this->config->get('config_store_id'));

echo $store_settings_config['config_language']; // Вот тут наш язык по-умолчанию

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

Данный пост размещаю тут больше, пожалуй, для себя, на будущее, однако если вы это читаете и вам помогло мое решение, не поленитесь и поставьте лайк, напишите комментарий. Заранее спасибо. Если возникли вопросы или предложения — пишите, обсудим.

Данная небольшая заметка поможет вам с легкостью устранить данную ошибку.Для того чтобы предотвратить показ выключенных записей блога Pav Blog News под Opencart, достаточно лишь открыть контроллер, расположенный по адресу:

catalog/model/pavblog/blog.php

Найти в этом файле строку с текстом:

if( isset($data['not_in']) && $data['not_in'] ){

И перед этой строкой разместить следующую строку:

$sql .= ' AND status=1 ';

Я честно говоря был в замешательстве, когда обнаружил данную оплошность разработчиков, однако данный недочет имеет место быть, и я счел полезным вам о нем сообщить, и предоставить быстрое решение этой простой проблемы.

Одними из популярных мест для размещения рекламных блоков является шапка сайта (начало статьи, страницы), но разместить там код рекламного баннера достаточно просто, а как разместить код того же Google Adsense в тексте записи сайта на WordPress без плагинов?

Итак, для того чтобы разместить код рекламного блока Google Adsense или других рекламных площадок, вам необходимо будет отредактировать файл functions.php в папке с вашей темой.

Добавим в код вашего файла (можно в конец файла) следующую функцию:

function prefix_insert_after_paragraph( $insertion, $paragraph_id, $content ) {
	$closing_p = '</p>';
	$paragraphs = explode( $closing_p, $content ); // разбиваем текст статьи по параграфам
	foreach ($paragraphs as $index => $paragraph) { // пробегаемся по параграфам
		if ( trim( $paragraph ) ) {
			$paragraphs[$index] .= $closing_p; // добавляем вырезанные на 3 строке закрывающие теги параграфа
		}
		if ( $paragraph_id == $index + 1 ) { // если номер текущего параграфа = номеру требуемого - добавляем код блока
			$paragraphs[$index] .= $insertion;
		}
	}

	return implode( '', $paragraphs ); // совмещаем все параграфы вместе и отдаем
}

Данная функция позволяет разбивать текст ($content) ваших записей/постов блога на блоки по параграфам и вставляет после определенного номера ($paragraph_id) параграфа код, передаваемый в функцию в переменной $insertion.

Далее нам необходимо вызвать эту функцию при обращении к нашей записи. Для этого нам необходимо добавить строку с добавлением фильтра и функцию:

add_filter( 'the_content', 'prefix_insert_post_ads' ); // Добавляем обработку текста статьи
function prefix_insert_post_ads( $content ) { // В функцию передаем текст статьи
	$ad_code = 'Тут код вашего рекламного блока'; // Указываем код рекламного блока для вставки
	if ( is_single() && ! is_admin() ) { // вызываем функцию для одиночной записи и не вызываем функцию если мы в администраторской панели
		return prefix_insert_after_paragraph( $ad_code, 2, $content ); // Если были соблюдены все правила возвращаем обработанный функцией исходный код статьи уже с кодом рекламного блока
		// передаются параметры: код рекламного блока, номер параграфа, после которого будет блок размещен, контент
	}
	return $content; // в противном случае возвращаем просто текст статьи
}

Вы можете настроить данный скрипт так как вам угодно, например вы можете скомпоновать все действия в одну функцию (мне кажется так будет удобнее и корректнее, зачем плодить функции?) таким образом:

add_filter( 'the_content', 'prefix_insert_post_ads' );
function prefix_insert_post_ads( $content ) {
	$ad_code = 'Тут код вашего рекламного блока';
	if ( is_single() && ! is_admin() ) {
		$closing_p = '</p>';
		$paragraphs = explode( $closing_p, $content );
		foreach ($paragraphs as $index => $paragraph) {
			if ( trim( $paragraph ) ) {
				$paragraphs[$index] .= $closing_p;
			}
			if ( X == ($index + 1) ) { // X = номер параграфа
				$paragraphs[$index] .= $ad_code;
			}
		}
		return implode( '', $paragraphs ); // совмещаем все параграфы вместе и отдаем
	}
	return $content;
}

Если вы хотите добавить несколько рекламных баннеров в текст вашей статьи, то вам необходимо добавить просто еще одно условие, например такое:

add_filter( 'the_content', 'prefix_insert_post_ads' );
function prefix_insert_post_ads( $content ) {
	$ad_code = 'Тут код вашего рекламного блока';
	/* Добавляем второй рекламный блок */
	$ad_code = 'Тут код вашего второго рекламного блока';
	/* Добавили второй рекламный блок */
	if ( is_single() && ! is_admin() ) {
		$closing_p = '</p>';
		$paragraphs = explode( $closing_p, $content );
		foreach ($paragraphs as $index => $paragraph) {
			if ( trim( $paragraph ) ) {
				$paragraphs[$index] .= $closing_p;
			}
			if ( X == ($index + 1) ) { // X = номер параграфа
				$paragraphs[$index] .= $ad_code;
			}
			/* Добавляем второе условие */
			if ( X2 == ($index + 1) ) { // X2 = номер второго параграфа
				$paragraphs[$index] .= $another_ad_code;
			}
			/* Добавили второе условие */
		}
		return implode( '', $paragraphs ); // совмещаем все параграфы вместе и отдаем
	}
	return $content;
}

А если вы хотите добавить рекламный блок в конец записи на сайте на WordPress, то просто добавьте условие:

add_filter( 'the_content', 'prefix_insert_post_ads' );
function prefix_insert_post_ads( $content ) {
	$ad_code = 'Тут код вашего рекламного блока';
	if ( is_single() && ! is_admin() ) {
		$closing_p = '</p>';
		$paragraphs = explode( $closing_p, $content );
		$count_p = count($paragraphs);
		foreach ($paragraphs as $index => $paragraph) {
			if ( trim( $paragraph ) ) {
				$paragraphs[$index] .= $closing_p;
			}
			if ( $count_p == ($index + 1) ) {
				$paragraphs[$index] .= $ad_code;
			}
		}
		return implode( '', $paragraphs );
	}
	return $content;
}

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

Для решения данной проблемы необходимо создать новое расположение. Сделать это очень просто следуя инструкции.

1. Создать файл шаблона для вашей позиции (расположения). Для этого можете скопировать любой уже имеющийся шаблон и переименовать его согласно желаемому названию, например content_category_filter.tpl.

2. Создать контроллер для вашей позиции. Опять таки можете скопировать любой уже имеющийся контроллер, однако тут придется его отредактировать. В первую очередь необходимо изменить класс в нашем случае на ControllerCommonContentCategoryFilter. Далее найти строку вида:

if ($module['layout_id'] == $layout_id && $module['position'] == 'content_top' && $module['status']) {

Как видите в данной строке отсеиваются включенные модули которые определены к выводу в верхней части страницы, на что указывает content_top, соответственно заменяем на content_category_filter и получаем следующий вид строки:

if ($module['layout_id'] == $layout_id && $module['position'] == 'content_category_filter' && $module['status']) {

Далее также заменяем имя шаблона для вывода в строках 69-72, указывая на шаблон, созданный в п.1. Получаем вот такой кусок кода:

if (file_exists(DIR_TEMPLATE . $this->config->get('config_template') . '/template/common/content_category_filter.tpl')) {
$this->template = $this->config->get('config_template') . '/template/common/content_category_filter.tpl';
} else {
$this->template = 'default/template/common/content_category_filter.tpl';}

3. Теперь необходимо подключить нашу позицию для вывода на страницы, где будут выводиться модули, находящиеся в этой позиции. Для этого откройте контроллер любой страницы, например категорий (category.php) и найдите строки:

$this->children = array(
'common/column_left',
'common/column_right',
'common/content_top',
'common/content_bottom',
'common/footer',
'common/header'
);

Сюда нам необходимо добавить подключение нашей позиции. Просто впишите ее в массив. Обратите внимание: если вы подключите ее последним элементом (добавите в конец массива, после common/header), то скрипты и стили не будут подключены! Рекомендуется подключать свою позицию исключительно перед footer и header! Например:

$this->children = array(
'common/column_left',
'common/column_right',
'common/content_top',
'common/content_bottom',
'common/content_category_filter',
'common/footer',
'common/header'
);

4. Подключив позицию в контроллере нам необходимо вывести ее в шаблоне. Сделать это достаточно просто, вписав в нужное место в шаблоне страницы название переменной позиции, например:

<?php echo $content_category_filter; ?>

5. Теперь перейдем к административной части. Чтобы мы могли указать нашу позицию какому-нибудь модулю нам необходимо открыть файл (администраторского) шаблона данного модуля, например admin/view/template/module/category.tpl и найти строки, содержащие выпадающий список позиций. Для этого просто ищите по документу строку [position] или content_bottom.

В стандартных шаблонах данная переменная встречается 2 раза:

1. При выводе уже имеющихся модулей в html;
2. При добавлении нового модуля в JavaScript.

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

<?php if ($module['position'] == 'content_category_filter') { ?>
<option value="content_category_filter" selected="selected">content_category_filter</option>
<?php } else { ?>
<option value="content_category_filter">content_category_filter</option>
<?php } ?>

Тоже самое необходимо проделать и с JS частью, например:

html += '      <option value="content_category_filter">content_category_filter</option>';

После этого при редактировании модуля вам будет доступна новая позиция.

Позиция создана, модуль выведен. Действия 3 и 4 необходимо проделать со всеми страницами, на которых вам необходимо вывести позицию. Все файлы вы можете найти с помощью поиска по содержимому файлов если искать например content_top или content_bottom — это нативные (стандартные) позиции. Также действие 5 необходимо повторить для каждого из модулей отдельно.

Для чего он нужен? Ну например чтобы передавать данные о пользователе (IP, браузер и т.п.), данные о странице откуда отправили форму, или откуда перешли чтобы отправить форму (какая страница поспособствовала переходу в раздел контактов) и еще куча возможных применений!

Все это вы можете себе позволить, написав просто обработку нового shortcode (тега, шорт кода) в шаблоне контактной формы. По-умолчанию существуют такие теги как text, email, textarea, которые также сопровождаются параметрами: обязательное или не обязательное поле и многое другое.

Теперь мы создадим новый тег hidden и в шаблоне добавим его как обычный тег с именем [hidden inputName]. Само имя тега inputName мы внесем в тело нашего сообщения. И остается только в файле functions.php прописать следующий код для обработки shortcode‘а:

// Register new shortcode for getting pages where contact form was send
function hidden($tag) {
    if ( ! is_array( $tag ) )
        return '';

if($tag['name'] == "referer"){
    $pageURL = 'http';
    if ($_SERVER["HTTPS"] == "on") {
        $pageURL .= "s";
    }
    $pageURL .= "://";
    if ($_SERVER["SERVER_PORT"] != "80") {
        $pageURL .= $_SERVER["SERVER_NAME"].":".$_SERVER["SERVER_PORT"].$_SERVER["REQUEST_URI"];
    } else {
        $pageURL .= $_SERVER["SERVER_NAME"].$_SERVER["REQUEST_URI"];
    }
    $html = '<input type="'.$tag['basetype'].'" name="' . $tag['name'] . '" value="'.$pageURL.'" />';
}else{
    $html = '<input type="'.$tag['basetype'].'" name="' . $tag['name'] . '" value="" />';
}
    return $html;
}
if(function_exists("wpcf7_add_shortcode")){
    wpcf7_add_shortcode('hidden', 'hidden', true);
}

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

На этом вроде все, если возникают вопросы — пишите в раздел вопросов и ответов, пишите комментарии, ставьте лайки!
Удачного коддинга!

Каждая социальная сеть (ФейсБук и ВКонтакте, например) предоставляет возможность использовать виджет комментариев для вашего ресурса, который дает возможность пользователям этой социальной сети оставить комментарий, и вы не будете волноваться на счет спама, роботов и прочих неприятностей, связанных с открытыми комментариями к вашей странице.

Но ведь если существует минимум две социальные глобальные сети, то необходимо учитывать пользователей обеих! Использовать один? Теряем пользователей второй сети. Использовать два виджета комментариев? Не рационально и неудобно. Что же делать?

На этот вопрос уже нашли ответы разработчики таких систем как:

• Disqus.com
• IntenseDebate.com
• Cackle.ru
• HyperComments.com

Я решил использовать именно HyperComments, т.к. список сетей, поддерживаемых сервисом более подходит для моей аудитории и он более гибок в настройках. Но столкнулся с вопросом, что этот виджет прикрепляется ко всем типам записей (custom post type).

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

В итоге, мной было придумано решение, которое уникально и подойдет для любого сайта, и я думаю для любой версии плагина HyperComments и не снесется при обновлении.

Собственно решение заключается в удалении фильтра для «the_content» и переопределение функции в файле вашей темы functions.php. Код, который необходимо скопировать себе в файл выглядит так:

remove_filter( 'the_content', 'hc_the_content_filter', 50 );
add_filter('the_content', 'hc_the_content_filter_custom_posts_type', 50);
function hc_the_content_filter_custom_posts_type( $content )
{
    global $post;
    global $is_append;
    global $user;

    $parse = parse_url($post->guid);
    if(get_option('hc_root')){
        $url = str_replace('https://','',str_replace('http://','',str_replace('www.','',$post->guid)));
    }else{
        $url = str_replace('https://','',str_replace('http://','',str_replace('www.','',str_replace($parse['host'], get_option('home'), $post->guid))));
    }
    if(get_option('hc_title_widget')){
        if($post->comment_status == 'open'){
            if ( !is_singular()){
                $content = sprintf(
                    '%s<div class="hc_content_comments" data-xid="'.$url.'"></div>',
                  $content
                );
            }
        }
    }

    if(is_singular()){
        // Nikita_Sp hack for DW Q&A comments work
        if($post->comment_status == 'open' && $post->post_type != 'custom-post-type' && $post->post_type != 'your-second-post-custom-type'){
            $is_append = true;
            $widget = hc_get_comment_widget(
                get_option('hc_wid'),
                hc_get_language(),
                $url,
                hc_get_auth(),
                get_option('hc_append'),
                get_option('hc_word_limit'),
                get_option('hc_realtime'),
                get_option('hc_comments_level'),
                get_option('hc_css')
            );
            $content = $content.$widget;
        }
    }
    return $content;
}

Сама функция является оригиналом фильтра для контента записи из плагина HyperComments, ну а дополнительное условие включено под соответствующим комментарием.

На этом все. Удачной социальной интеграции, если есть вопросы — пишите в комментарии или в соответствующий раздел Вопросов и ответов.
Не забываем ставить «лайк» и рассказывать друзьям! Спасибо!