Введение в Kirby CMS

 ---- Twitter: myusername 

Теперь вы можете print это в своих шаблонах или фрагментах, используя магический метод переменной $site . Чтобы поместить его в нижний колонтитул, откройте site/snippets/footer.php и добавьте следующее:

 <a href="http://twitter.com/<?php print $site->twitter() ?>">Twitter</a> 

Создание простого блога

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

Создайте папку с именем content/04-blog и в ней файл с именем blog.txt :

 Title: Blog ---- 

В этой папке создайте группу сообщений в блоге (используя тот же формат, что и существующие страницы), например

 content/04-blog/01-first-post/first-post.txt content/04-blog/02-first-post/second-post.txt content/04-blog/03-first-post/third-post.txt 

Теперь создайте шаблон для блога:

 // site/templates/blog.php <?php snippet('header') ?> <?php snippet('menu') ?> <section class="content"> <h1><?php echo html($page->title()) ?></h1> <?php foreach ($pages->findOpen()->children()->visible()->flip() as $post): ?> <article> <h2><a href="<?php print $post->url() ?>"><?php echo html($post->title()) ?></a></h2> <p><?php print excerpt($post->text()) ?></p> <p><a href="<?php print $post->url() ?>">Read more &raquo;</a></p> </article> <?php endforeach ?> </section> <?php snippet('footer') ?> 

Обратите внимание, как мы вызываем flip() чтобы изменить порядок страниц, все из которых являются дочерними элементами текущей страницы, то есть страниц в папке content/04-blog .

В этом шаблоне также представлена ​​функция url() , которая возвращает URL-адрес рассматриваемой страницы, и excerpt() , который возвращает сводку текстового содержимого. Чтобы изменить количество возвращаемых символов, просто укажите его в качестве второго параметра:

 print excerpt($post->text(), 250); // prints the first 250 characters 

Kirbytext

Фактическое содержание в Kirby написано в «Kirbytext». Он хранится как текстовое свойство в файле YAML и по сути является расширением Markdown, но с некоторыми дополнительными макросами.

Это лучше всего иллюстрируется на примере:

Файл: page.txt :

 Title: About ---- Somefield: Something ---- Body: This is some sample content. It's based on Markdown, so we can use **bold** or *emphasis*, and [write links](http://getkirby.com). Kirbytext also has macros, that look a little like this: (youtube: http://www.youtube.com/watch?v=ZZ5LpwO-An4 width: 300 height: 200) 

Специфичный для Kirby макрос / тег здесь предназначен для встраивания видео с YouTube, но вы можете расширить Kirbytext, чтобы написать свой собственный. Для этого начните с создания файла с именем kirbytext.extended.php на site/plugins :

 class kirbytextExtended extends kirbytext { function __construct($text, $markdown=true) { parent::__construct($text, $markdown); } } 

Теперь в конструкторе вы можете определить новые теги, а также новые атрибуты. Предположим, мы хотим добавить поддержку Gravatar:

  // define custom tags $this->addTags('gravatar'); // define custom attributes $this->addAttributes('size'); 

После того, как вы определили новый тег с помощью addTags() , вы просто реализуете метод с тем же именем, который будет вызываться для визуализации тега:

 /** * Render the gravatar tag, eg (gravatar: [email protected]) */ function gravatar($params) { $email = $params['gravatar']; $size = (isset($params['size'])) ? $params['size'] : 50; $url = sprintf('http://www.gravatar.com/avatar/%s?size=%d', md5($email), $size); return sprintf('<img src="%s" width="%d" height="%d" />', $url, $size, $size); } 

 (gravatar: [email protected] size: 64) 

 cp -R kirbycms-panel/ /var/www/yoursite/site/panel 

 cp -R /var/www/yoursite/panel/defaults /var/www/yoursite/panel 

 // site/panel/accounts/john.php <?php if(!defined('KIRBY')) exit ?> username: john password: 5baa61e4c9b93f3f0682250b6cf8331b7ee68fd8 encrypt: sha1 language: en