Как настроить онлайн многоязычный журнал с Sulu

Ранее мы продемонстрировали правильный способ начать работу с Sulu CMS, настроив установку Hello World на машину Vagrant. Простые вещи, но могут быть хитрыми.

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

На этот раз мы рассмотрим базовую терминологию Sulu, объясним, как контент формируется, создается, хранится и кэшируется, а также рассмотрим создание простого онлайн-журнала с разными языками (языками).

Рекомендуем прочитать, прежде чем продолжить:

• Настройка изолированных сред разработки для PHP — 5 минут чтения
• Начало работы с Sulu на Vagrant the Right Way — 10 минут чтения

Страницы и шаблоны страниц

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

Шаблон страницы состоит из двух частей: шаблона ветки и конфигурации XML. Часть Twig отвечает за визуализацию содержимого подблоков страницы, например:

{% extends "master.html.twig" %} {% block meta %} {% autoescape false %} {{ sulu_seo(extension.seo, content, urls, shadowBaseLocale) }} {% endautoescape %} {% endblock %} {% block content %} <h1 property="title">{{ content.title }}</h1> <div property="article"> {{ content.article|raw }} </div> {% endblock %} 

Это полное содержимое шаблона ветки по умолчанию, поставляемого с sulu-minimal , которое можно найти в app/Resources/Views/Templates/default.html.twig . Он расширяет мастер-макет, определяет некоторые блоки и отображает их содержимое.

Конфигурация XML, с другой стороны, немного сложнее (как и большинство вещей с XML):

 ... <key>default</key> <view>templates/default</view> <controller>SuluWebsiteBundle:Default:index</controller> <cacheLifetime>2400</cacheLifetime> <meta> <title lang="en">Default</title> <title lang="de">Standard</title> </meta> <properties> <section name="highlight"> <properties> <property name="title" type="text_line" mandatory="true"> <meta> <title lang="en">Title</title> <title lang="de">Titel</title> </meta> <params> <param name="headline" value="true"/> </params> <tag name="sulu.rlp.part"/> </property> ... по ... <key>default</key> <view>templates/default</view> <controller>SuluWebsiteBundle:Default:index</controller> <cacheLifetime>2400</cacheLifetime> <meta> <title lang="en">Default</title> <title lang="de">Standard</title> </meta> <properties> <section name="highlight"> <properties> <property name="title" type="text_line" mandatory="true"> <meta> <title lang="en">Title</title> <title lang="de">Titel</title> </meta> <params> <param name="headline" value="true"/> </params> <tag name="sulu.rlp.part"/> </property> ... по ... <key>default</key> <view>templates/default</view> <controller>SuluWebsiteBundle:Default:index</controller> <cacheLifetime>2400</cacheLifetime> <meta> <title lang="en">Default</title> <title lang="de">Standard</title> </meta> <properties> <section name="highlight"> <properties> <property name="title" type="text_line" mandatory="true"> <meta> <title lang="en">Title</title> <title lang="de">Titel</title> </meta> <params> <param name="headline" value="true"/> </params> <tag name="sulu.rlp.part"/> </property> ... По ... <key>default</key> <view>templates/default</view> <controller>SuluWebsiteBundle:Default:index</controller> <cacheLifetime>2400</cacheLifetime> <meta> <title lang="en">Default</title> <title lang="de">Standard</title> </meta> <properties> <section name="highlight"> <properties> <property name="title" type="text_line" mandatory="true"> <meta> <title lang="en">Title</title> <title lang="de">Titel</title> </meta> <params> <param name="headline" value="true"/> </params> <tag name="sulu.rlp.part"/> </property> ... 

Если вы новичок в Сулу, ничего из этого не будет иметь смысла — но мы доберемся. На данный момент мы вводим концепции. Основные выводы из приведенного выше фрагмента XML:

• key — это уникальный фрагмент шаблона и его запись в меню выбора шаблона администратора (оно должно совпадать с именем файла XML, без расширения).
• view — то, где его коллега twig может быть найден. Шаблон появится в меню, только если у него есть и XML, и соответствующий файл Twig!
• контроллер — это место, где выполняется его логика. Позже мы более подробно рассмотрим контроллеры, но в целом вы можете оставить это значение по умолчанию для простого контента.
• Метаданные — это то, как шаблон будет отображаться в меню выбора шаблона администратора, в зависимости от языка, выбранного в пользовательском интерфейсе:
  
• Свойства — это различные элементы страницы — в этом случае поле для ввода заголовка и нередактируемое поле URL

Вы определяете новые типы страниц (шаблоны), определяя новые комбинации свойств в этом XML-файле, а затем выводите их в соответствующий файл ветки.

В качестве эксперимента попробуйте использовать меню в интерфейсе администратора, чтобы переключить домашнюю страницу на шаблон по умолчанию, а затем в master.html.twig макета master.html.twig (одна папка выше) добавить бессмысленную информацию в HTML. Не стесняйтесь также заполнять свойство article в пользовательском интерфейсе.

 ... <form action="{{ path('sulu_search.website_search') }}" method="GET"> <input name="q" type="text" placeholder="Search" /> <input type="submit" value="Go" /> </form> Lalala <section id="content" vocab="http://schema.org/" typeof="Content"> {% block content %}{% endblock %} </section> ... 

Если вы щелкнете Save and Publish в верхнем левом углу и обновите домашнюю страницу, вы должны увидеть изменения.

 sudo add-apt-repository ppa:webupd8team/java sudo apt-get update sudo apt-get install oracle-java8-installer 

 sudo update-alternatives --config java 

 wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add - sudo apt-get install apt-transport-https echo "deb https://artifacts.elastic.co/packages/5.x/apt stable main" | sudo tee -a /etc/apt/sources.list.d/elastic-5.x.list sudo apt-get update && sudo apt-get install elasticsearch sudo service elasticsearch start 

 ... "sulu/sulu": "dev-develop as 1.6.0-RC1", "sulu/article-bundle": "dev-develop" ... ... "repositories": [ { "type": "vcs", "url": "https://github.com/sulu/SuluArticleBundle" }, { "type": "vcs", "url": "https://github.com/sulu/sulu" } ], ... ... "minimum-stability": "dev", "prefer-stable": true ... 

 composer require sulu/article-bundle 

 new Sulu\Bundle\ArticleBundle\SuluArticleBundle(), new ONGR\ElasticsearchBundle\ONGRElasticsearchBundle(), 

 sulu_route: mappings: Sulu\Bundle\ArticleBundle\Document\ArticleDocument: generator: schema options: route_schema: /articles/{object.getTitle()} sulu_core: content: structure: default_type: article: "article_default" article_page: "article_default" paths: article: path: "%kernel.root_dir%/Resources/templates/articles" type: "article" article_page: path: "%kernel.root_dir%/Resources/templates/articles" type: "article_page" ongr_elasticsearch: managers: default: index: index_name: su_articles mappings: - SuluArticleBundle live: index: index_name: su_articles_live mappings: - SuluArticleBundle sulu_article: documents: article: view: Sulu\Bundle\ArticleBundle\Document\ArticleViewDocument types: # Prototype name: translation_key: ~ # Display tab 'all' in list view display_tab_all: true 

 sulu_arictle_api: resource: "@SuluArticleBundle/Resources/config/routing_api.xml" type: rest prefix: /admin/api sulu_article: resource: "@SuluArticleBundle/Resources/config/routing.xml" prefix: /admin/articles 

 <?xml version="1.0" ?> <template xmlns="http://schemas.sulu.io/template/template" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xi="http://www.w3.org/2001/XInclude" xsi:schemaLocation="http://schemas.sulu.io/template/template http://schemas.sulu.io/template/template-1.0.xsd"> <key>article_default</key> <view>articles/article_default</view> <controller>SuluArticleBundle:WebsiteArticle:index</controller> <cacheLifetime>144000</cacheLifetime> <meta> <title lang="en">Default</title> <title lang="de">Standard</title> </meta> <tag name="sulu_article.type" type="article"/> <properties> <section name="highlight"> <properties> <property name="title" type="text_line" mandatory="true"> <meta> <title lang="en">Title</title> <title lang="de">Titel</title> </meta> <params> <param name="headline" value="true"/> </params> </property> <property name="routePath" type="route"> <meta> <title lang="en">Resourcelocator</title> <title lang="de">Adresse</title> </meta> </property> </properties> </section> <property name="article" type="text_editor"> <meta> <title lang="en">Article</title> <title lang="de">Artikel</title> </meta> </property> </properties> </template> 

 {% extends "master.html.twig" %} {% block content %} <h1 property="title">{{ content.title }}</h1> <div property="article"> {{ content.article|raw }} </div> {% endblock %} 

 php bin/console assets:install # this installs JS, CSS, etc for the UI. Defaults to hard copy, if you want symlinks use `--symlinks` php bin/console sulu:translate:export # creates translations php bin/console sulu:document:init # initializes some PHPCR nodes php bin/console ongr:es:index:create # initializaes the elasticsearch index 

 /articles/{object.getTitle()} 

 /blog/{object.getCreated().format('m')}/{object.getCreated().format('Y')}/{object.getTitle()} 

  <localizations> <localization language="en" default="true"/> <localization language="hr"/> </localizations> 

 php bin/adminconsole sulu:document:initialize 

 php bin/adminconsole doctrine:phpcr:nodes:update --query "SELECT * FROM [nt:base]" --apply-closure="foreach(\$node->getProperties('i18n:hr-*') as \$hrNode) {\$hrNode->remove();};" php bin/websiteconsole doctrine:phpcr:nodes:update --query "SELECT * FROM [nt:base]" --apply-closure="foreach(\$node->getProperties('i18n:hr-*') as \$hrNode) {\$hrNode->remove();};" php bin/adminconsole sulu:document:initialize 

  <div> {% for locale, url in urls %} {% set extra="/"~request.locale %} <a href="{{ sulu_content_path((url|replace({(extra): ""})?:'/'),request.webspaceKey,locale) }}">{{ locale }}</a> {% if not loop.last %}&nbsp;|&nbsp;{% endif %} {% endfor %} </div>