Программа минимум для Symphony CMS

Привет, Харачеловек.

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

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

Покрываемые вопросы

• URL. Два в одном.
• Необходимость сделать нормальный preview какой-либо статьи.
• Свой title и meta-description для каждой страницы.
• Сокращенные URL для статических страниц.
• Global Data Sources.

URL. Два в одном

Основная проблема URL Param`ов Symphony заключается в том, что обычным способом невозможно сделать одновременно Дата Сорс (DS) для списка статьей и для самой статьи.
Предположим, что есть список статей, которые разбиты по страницам. В стандартном варианте URL для постраничной навигации будет выглядеть так: /articles/<page_number>, а для статьи: /article/my-cool-article.
Данный метод не очень хорош для SEO хотя бы тем, что на одинаковые, по сути, разделы ведут две разные ссылки.
Решение данной проблемы, как оказалось, довольно тривиально.
Как известно каждый DS – это отдельный php файл. Исходя из этого, нужно:

1. провести небольшую манипуляцию внутри функции grab. Перед

   1. $result = new XMLElement($this->dsParamROOTELEMENT);

   вставить следующий код:
   

   1. if (isset($this->_env['env']['url']['action'])) {
   2.   $action = $this->_env['env']['url']['action']; //Действие. Page || Article
   3.  
   4.   if (is_numeric($action)) { //Если страница
   5.     $this->dsParamFILTERS = array('45' => 'yes'); //id чекбокса Published
   6.     $this->dsParamSTARTPAGE = $action;
   7.   } else { //Если страница конкретной статьи
   8.     $this->dsParamINCLUDEDELEMENTS[] = 'meta-title'; //Дополнительно выводимые поля для SEO.
   9.     $this->dsParamINCLUDEDELEMENTS[] = 'meta-description';
   10.     $this->dsParamFILTERS = array(
   11.       '45' => 'yes', //id чекбокса Published
   12.       '65' => $action, //собственно url handle (my-cool-article)
   13.     );
   14.   }                            
   15. }

2. откорректировать XSL соответственно для вывода либо списка статьей, либо статью:

   1. <xsl:template match="articles">
   2.   <xsl:for-each select="entry">
   3.     <xsl:choose>
   4.       <xsl:when test=" $action != '' and string(number($action)) = 'NaN' ">
   5.         <h1><xsl:value-of select="title/." /></h1>
   6.         <xsl:apply-templates select="body/* | body/text()" mode="html" />
   7.       </xsl:when>      
   8.  
   9.       <xsl:otherwise>                  
   10.         <h2><a href="{$root}/{$current-page}/{filename/@handle}"><strong><xsl:value-of select="title/." /></strong></a></h2>           
   11.         <xsl:call-template name="truncate">
   12.           <xsl:with-param name="node" select="brief-description" />
   13.           <xsl:with-param name="limit" select="'500'" />
   14.         </xsl:call-template>           
   15.       </xsl:otherwise>                                 
   16.     </xsl:choose>
   17.   </xsl:for-each>
   18. </xsl:template>

Необходимость сделать нормальный preview какой-либо статьи

Если ты обратил внимание, то в в кусочке XSLT кода мелькнул вызов темплейта, под названием «truncate».
На самом деле, сделать привью кусочка текста можно и без дополнительных темплейтов, достаточно только разобраться, как работает функция position () и дальше уже экспериментировать с ней.
Использование функции position () доставляет определенные неудобства. К счастью Symphony CMS имеет достаточный набор разных XLST утилит, среди которых есть и HTML Truncate Advanced, благодаря которой обрезание куска HTML кода становится проще простого.

Свой title и meta-description для каждой страницы

Хочу опять обратить твое, хабрачеловек, внимание на php код, который был в самом начале. Ты мог заметить дополнительно выводимые поля meta-title и meta-description.
Так вот, при открытии определенной статьи дополнительно в XML Output Symphony будут выводится два этих поля.
Все, что тебе нужно это, опять же, немного поковырять page-title.xsl и сделать примерно такую маленькую хитрость:

1. <xsl:template name="page-title">
2.   <xsl:value-of select="$website-name"/>
3.   <xsl:text> &#8212; </xsl:text>
4.   <xsl:choose>
5.     <xsl:when test="data/*/entry/meta-title/. != '' ">
6.       <xsl:value-of select="data/*/entry/meta-title/." />
7.     </xsl:when>
8.  
9.     <xsl:otherwise>
10.       <xsl:value-of select="$page-title"/>
11.     </xsl:otherwise>
12.   </xsl:choose>
13. </xsl:template>

Сокращенные URL для статических страниц

Бывает, иногда, что стандартный подход Symphony к выводу URL`ов не всегда подходит.
Предположим, что у нас есть просто какие-то статические страницы, например, example.com/static/contact. Согласись, /static/ ну никак не вписывается в картину красивых и четких URL`ов.
Мне, например, необходимо, что бы конкретная страница находилась по адресу http://example.com/contact.
Опять же, на помощь приходит extension Root Page Params, установив и настроив который, получится именно необходимый результат.

Global Data Sources

Вообще, Data Source в Symphony, это своего рода WHERE для определенной таблицы данных. DS, как и любой WHERE позволяет выбрать определенные данные по каким-либо критериям.
На любом сайте, я уверен, найдутся такие данные, которые должны быть на каждой странице, единственный нюанс — данные должны быть редактируемыми.
Конечно, можно выбирать каждую страницу Symphony и в ручную отмечать какие дополнительные DS выводить, но это приводит к, своего рода, хаосу, когда где-то что-то какое-то количество раз отмечено. Это все нужно помнить, не забыть добавить на новую страницу и т.п.
Опять же, на помощь приходит extension Global Resource Loader, позволяющий в одном удобном месте собрать все необходимые DS.

Заключение

Часть статьи получилась в виде описания дополнений к Symphony, часть — освоенная на личном опыте и потраченном времени.
По-моему, для создания полноценного сайта эти дополнения необходимы. Именно по этому я решил поделиться с любым, кто разрабатывает или планирует разрабатывать сайт на основе Symphony CMS.
Если хотя бы одному человеку, прочитавшему эту статью, пригодится мой опыт, то я смело могу считать свою миссию выполненной.

За сим откланиваюсь.
Спасибо.