Переопределение в шаблоне

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

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

Внимание! Все файлы тем по умолчанию наследуются от темы default. Например, если вы используете тему uikit, то она унаследует все не переопределённые файлы из темы default.

Создание переопределения макетов

Подготовка переопределения шаблона

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

Создайте общую папку для переопределений с названием html по следующему пути:
/templates/mytemplate/html/

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

Создайте папку для переопределений NorrCompetiton с названием com_competition по следующему пути:
/templates/mytemplate/html/com_competition/

Эта папка будет содержать папки тем, которые вы хотите переопределить или использовать.

Переопределение тем по умолчанию

Предположим, что вы используете тему default и хотите её переопределить.

Создайте папку переопределения темы по следующему пути:
/templates/mytemplate/html/com_competition/default/

Если вы хотите создать переопределение макета вывода для
/components/com_competition/themes/default/competitions.php

то вам необходимо скопировать этот файл по следующему пути:
/templates/mytemplate/html/com_competition/default/competitions.php

Тоже самое относится к любому PHP файлу внутри темы, которую вы хотите переопределить.

Создание переопределений CSS

Переопределение темы

Создание переопределений CSS файлов темы практически идентично переопределению макетов.

Если вы хотите создать переопределение CSS для файла style.css темы default, который расположен в
/components/com_competition/themes/default/css/

то вам необходимо скопировать этот файл по следующему пути:
/templates/mytemplate/html/com_competition/default/css/style.css

Переопределение медиа

Переопределения медиа немного отличаются. Это общие ассеты компонента, которые расположены в папке /media/com_competition/.

Если вы хотите переопределить файл cropper.css, который находится в /media/com_competition/css/, то вам необходимо скопировать этот файл по следующему пути:
/templates/mytemplate/css/com_competition/cropper.css

Создание собственной темы

Переопределение тем по умолчанию, это конечно хорошо, но давайте представим, что у вас есть шаблон Joomla, который использует свой фреймворк и темы по умолчанию вам не подходят. Тогда вы можете создать свою собственную тему и использовать её в NorrCompetiton. Предположим, что вы хотите создать тему под названием custom:

  • Подготовьте переопределение шаблона
  • Скопируйте папку темы default из /components/com_competition/themes/default/ в: /templates/mytemplate/html/com_competition/
  • Переименуйте папку default в custom. У вас должен получиться следующий путь: /templates/mytemplate/html/com_competition/custom/
  • Выберите вашу тему в настройках компонента: Настройки -> Вкладка Общие -> Тема

Вот и все. Теперь у вас есть полный контроль над выходными данным компонента.