Кнопки социальных сетей в Joomla 2.5

Куда внедрять?
Какие и где взять?
  Блок Поделиться от Яндекса и панель от Pluso
  Плавающая вертикальная панель от Share42
Выборочное размещение

Как и обещал в одной из статей цикла "Миграция с Joomla 1.5 на Joomla 2.5", детально остановлюсь на вопросе интеграции социальных кнопок в сайт на Joomla 2.5.

Для Joomla 1.5 я использовал плагин социальных закладок RusButtons (немного подправив его). К сожалению, автор не переписал его под 2.5. Существующие решения в виде расширений Джумлы не удовлетворили, к тому же - где гарантия, что авторы будут их своевременно обновлять? Поэтому мой выбор - немного поработать ручками и вживить кнопочки в шаблон. Вариантов соцкнопок нашлось достаточно, но о них - в следующей статье. Здесь же будет описано, куда именно внедряются их скрипты.

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

Итак, давайте разберемся, в код каких файлов и в какое именно место вставляются скрипты панелей кнопок.

1. В тело статьи перед содержимым или после него.

В общем случае редактируется файл components \ com_content \ views \ article \ tmpl \ default.php. В следующем фрагменте кода этого файла наглядно демонстрируется, куда вставляется панель кнопок:

/* ------------ More code..... ----------- */
 
<?php
if (!empty($this->item->pagination) AND $this->item->pagination AND !$this->item->paginationposition AND !$this->item->paginationrelative):
    echo $this->item->pagination;
endif;
?>
 
 /* =====> !!! Перед содержимым - Вставляем сюда */
 
<?php echo $this->item->text; ?>
 
/* ------------ More code..... ----------- */
 
 /* =====> !!! После содержимого - Вставляем сюда */
 
<?php
if (!empty($this->item->pagination) AND $this->item->pagination AND $this->item->paginationposition AND $this->item->paginationrelative):
    echo $this->item->pagination;?>
<?php endif; ?>
 
<?php echo $this->item->event->afterDisplayContent; ?>
</div>
 
/* ------------ End of File ----------- */

Вышеописанное прекрасно работает в шаблонах, поставляемых с Джумлой по умолчанию - Beez2, Beez5, Atomic, а также во многих других. Однако есть множество шаблонов, где свой файл default.php перекрывает тот, который мы рассматривали выше. Например, мой шаблон, сделанный в Artisteer и являющийся активным на момент написания статьи. Покажу на его примере, куда внедрять код в этом случае.

Открываем на редактирование файл templates \ [my_template] \ html \ com_content \ article \ default.php.

/* ------------ More code..... ----------- */
 
if (!$article->introVisible)
    $content .= $article->event('afterDisplayTitle');
$content .= $article->event('beforeDisplayContent');
 
 /* =====> !!! Перед содержимым - Вставляем сюда */
 
if (strlen($article->toc))
    $content .= $article->toc($article->toc);
 
/* ------------ More code..... ----------- */
 
if (strlen($article->readmore))
    $content .= $article->readmore($article->readmore, $article->readmoreLink);
 
 /* =====> !!! После содержимого - Вставляем сюда */
 
if ('below full article' === $article->paginationPosition)
    $content .= $article->pagination();
 
$content .= $article->event('afterDisplayContent');
$params['content'] = $content;
 
// Render article
echo $article->article($params);
echo $component->endPageContainer();
 
/* ------------ End of File ----------- */

Надеюсь, принцип понятен и здесь. Единственное, что хочу уточнить - в этом случае весь скрипт страницы присваивается переменной $content. Поэтому код кнопок не вставляется как есть, а добавляется к значению этой переменной в строковом представлении, т. е. обрамленный одинарными или двойными кавычками:

$content .= 'Блок кода кнопок';

2. Интеграция в JComments.

Редактировать будем файл components \ com_jcomments \ tpl \ default \ tpl_index.php. Тут все просто:

      // include JComments JavaScript initialization
?>
 
 /* =====> !!! Вставляем сюда */
 
<script type="text/javascript">

Теперь, разобравшись, куда и в каком случае мы будем встраивать скрипты наших панелей, перейдем к теме, что именно встраивать. Об этом - в следующей статье.