Как не хакать сторонние классы

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

Что же делать?
Все просто — нужно расширить сторонний класс своими методами. По сути, это очень похоже на «классные процессоры», только без процессоров и использовать можно везде — это стандартная возможность ООП.

Принцип

Смысл в том, что нам нужно создать свой собственный класс, который будет наследовать исходный класс и заменять его методы.
Для примера заменим некоторые методы miniShop. Создаем файл /core/components/minishop/model/minishopext.class.php:

<?php

//загружаем код класса miniShop
require_once 'minishop.class.php';

// extends - это и есть расширение/наследование
class miniShopExt extends miniShop {
    // Тут мы инициализируем родительский класс
    function __construct(modX &$modx,array $config = array()) {
    	return parent::__construct($modx, $config);
    }
    
    // Если назвать метод, как в родительском класе - это будет замена
    // Если нет - добавление нового метода
    function addToCart($id, $num = 1, $data = array()) {
        // Копируем сюда исходный метод и меняем в нем, что нам нужно
    }
    function remFromCart($key) {
        // И тут. Можно хоть весь класс переписать заново.
    }
    function newMethod() {
        // А это новый метод, пишем тут свой код
    }

Мы подключили родительский класс, но не инициализировали. Запускать его мы будем через свой новый класс — miniShopExt.

Значит, нам нужен теперь сниппет, для запуска нового класса. Можно просто переименовать сниппет miniShop в miniShopExt, или скопировать.
Теперь меняем в новом сниппете инициализацию класса с miniShop на miniShopExt:

if (!isset($modx->miniShop) || !is_object($modx->miniShop)) {
  $modx->miniShop = $modx->getService('minishopext','miniShopExt', $modx->getOption('core_path').'components/minishop/model/minishop/', $scriptProperties);
  if (!($modx->miniShop instanceof miniShopExt)) return '';
}

Видите, мы запускаем класс miniShopExt из файла minishopext(.class.php) и сохраняем его в переменную $modx->miniShop, чтобы не переписывать весь сниппет.

miniShopExt унаследовал все методы от miniShop, кроме тех, которые прописаны в нем самом. Теперь нужно только заменить вызов сниппета [[!miniShop]] в корзине на [[!miniShopExt]].

Заключение

Вот таким способом мы можем изменять любой сторонний класс как нам нужно. Самое главное — мы не лезем в чужой код и не теряем будущие обновления.

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