Realblog_XH облегчает представление блога на вашем веб-сайте CMSimple_XH. Он предлагает основные функции ведения блога, такие как отображение хронологического обзора сообщений, необязательный ежегодный архив, автоматическая запланированная публикация и архивирование сообщений, поиск содержимого, подача RSS и очень упрощенная категоризация. Отдельно написанные тизеры поддерживаются. Тизеры и статьи могут содержать произвольные сценарии CMSimple_XH. Каждый пост в блоге может быть сделан индивидуально комментируемым, для чего требуется совместимый плагин комментариев.
Для многоязычных сайтов каждый язык будет иметь свой собственный блог; кроме этого, Realblog_XH не имеет многоязычных возможностей.
Пожалуйста, прочитайте эту документацию, прежде чем возникнут какие-либо проблемы!
Realblog_XH пока не может быть протестирован в различных средах. Это так называемая бета-версия. Используйте с осторожностью!
Realblog_XH - это плагин для CMSimple_XH. Требуется CMSimple_XH ≥ 1.6 и PHP ≥ 5.3.0 с расширением sqlite3.
Установка выполняется как и для многих других плагинов CMSimple_XH. Смотрите CMSimple_XH wiki для получения более подробной информации.
Настройка плагина выполняется так же, как и для многих других плагинов CMSimple_XH в серверной части сайта. Выберите «Realblog» из «Плагины».
Вы можете изменить настройки Realblog_XH по умолчанию в разделе «Параметры». Подсказки для параметров будут отображаться при наведении курсора мыши на значок справки.
Локализация производится в разделе «Язык». Вы можете перевести строки символов на свой язык (если нет доступных языковых файлов) или настроить их в соответствии с вашими потребностями.
Внешний вид Realblog_XH можно настроить в разделе «Таблица стилей» - "Stylesheet". Внешний вид Realblog_XH можно настроить в разделе «Таблица стилей». Вы также можете заменить иконки, используемые в администрации плагина; в папке images/ имеются альтернативные наборы иконок.
Чтобы отобразить блог на странице CMSimple_XH, напишите:
{{{Realblog_blog();}}}
Чтобы также отобразить форму поиска, напишите:
{{{Realblog_blog(true);}}}
Чтобы отобразить список самых последних статей на каждой странице, вставьте в подходящее место в шаблоне:
<?php echo Realblog_link('BLOG_URL')?>
BLOG_URL должен быть заменен URL главной страницы блога. Подробнее см. Описание настроек страницы RSS.
Чтобы также показать тизеры этих статей, напишите:
<?php echo Realblog_link('BLOG_URL', true)?>
Чтобы отобразить список самых популярных статей на каждой странице, вставьте в соответствующее место в шаблоне:
<?php echo Realblog_mostPopular('BLOG_URL')?>
Что касается BLOG_URL, см. Примечание выше.
Локализация производится в разделе «Язык». Вы можете перевести строки символов на свой язык (если нет доступных языковых файлов) или настроить их в соответствии с вашими потребностями.
Внешний вид Realblog_XH можно настроить в разделе «Таблица стилей». Вы также можете заменить иконки, используемые в администрации плагина; в папке images/ имеются альтернативные наборы иконок.
В основном плагине adminstration вы можете управлять сообщениями в блоге. Вы можете создавать, редактировать и удалять сообщения, изменять их статус и т.д. Администрация должна быть достаточно понятной.
В разделе «Обмен данными» вы можете экспортировать статьи в файл CSV, а также импортировать статьи из файла CSV. Предполагается, что файл CSV находится рядом с соответствующим файлом базы данных и называется «realblog.csv». Обратите внимание, что файл CSV на самом деле разделен табуляцией, но не имеет тот же формат, что и старый "realblog.txt", поэтому не пытайтесь импортировать старые данные через импорт CSV. Также обратите внимание, что импорт перезапишет все существующие статьи в базе данных. Настоятельно рекомендуется сделать резервную копию файла базы данных перед импортом из CSV!
Если вы хотите использовать функцию экспорта/импорта для редактирования статей в автономном режиме, убедитесь, что после экспорта и перед импортом в базу данных не вносятся никакие изменения. В противном случае эти изменения будут перезаписаны при повторном импорте статей. Также не изменяйте никакие идентификаторы (первый столбец), потому что они используются для ссылки на просмотры страниц. Это хорошо, чтобы удалить строки, но если вы хотите вставить строки, сделайте это в конце файла с последовательно увеличивающимися идентификаторами.
Realblog_XH в настоящее время имеет только очень базовую поддержку категорий. Чтобы определить категории, к которым принадлежит сообщение, введите разделенный запятыми без пробелов список названий категорий в соответствующем поле формы статьи:
Категория 1,Категория 2,Категория 3
Моллюски,Рыбы костистые,Рыбы хрящевые,Морские млекопитающие
Обратите внимание, что вы можете определить столько категорий, сколько хотите. Сохранённые категории можно добавлять из специальной вкладки.
Посетители не могут фильтровать статьи по категориям, но вы можете подготовить отдельные страницы CMSimple_XH для каждой категории заранее и отобразить соответствующие сообщения на этих страницах, передав второй аргумент в Realblog_blog ():
{{{Realblog_blog(false, 'Категория 1');}}}
Такой вызов означает отфильтровать все статьи блога, кроме статей, имеющих признак "Категория 1".
Чтобы отобразить архив блога на странице CMSimple_XH, напишите:
{{{Realblog_archive();}}}
Чтобы также отобразить форму поиска в архиве, напишите:
{{{Realblog_archive(true);}}}
Обратите внимание, что архив блога не должен находиться на одной странице с реальным блогом.
Если включен в конфигурации, Realblog_XH автоматически предлагает RSS-канал с опубликованными сообщениями в блоге. При желании вы можете отобразить значок канала RSS, который ссылается на канал в шаблоне:
<?php echo Realblog_feedLink();?>
В эту функцию также можно передать один параметр, который указывает значение целевого атрибута гиперссылки. Это можно использовать для открытия канала в новом окне/вкладке:
<?php echo Realblog_feedLink('_blank');?>
Помимо некоторых настроек, связанных с фидом в конфигурации, есть некоторые настройки в языковом файле в разделе «RSS». Наиболее важным является «page», где вы должны ввести URL-адрес страницы, на которой отображается основной блог. Лучше всего перейти на эту страницу и скопировать и вставить все после вопросительного знака, но не включая первый амперсанд (&), если он есть, из адресной строки браузера.
Чтобы добавить возможность комментирования в свой блог, вы должны установить совместимый плагин комментариев и ввести его имя в конфигурации Realblog_XH.
Примечание для разработчиков: чтобы быть совместимым с Realblog_XH, вы должны написать класс с именем %YOURPLUGIN%\RealblogBridge который реализует интерфейс Realblog\CommentsBridge, который определен и задокументирован в плагинах plugins/realblog/classes/CommentsBridge.php. Убедитесь, что этот класс и его зависимости загружены, когда это необходимо для Realblog_XH; автозагрузка рекомендуется.
Realblog_XH в основном обратно совместим с Realblog 2.8, поэтому вы можете повторно использовать его файлы данных (realblog.txt) и использовать его вызовы плагинов. Однако старые вызовы плагинов устарели и могут быть удалены в будущем.
Файлы RSS-каналов (realblog_rss_feed.xml)— больше не используются - каналы создаются динамически. Вы должны удалить старые файлы, чтобы читатели новостей не могли захватить старое содержимое
Realblog_XH распространяется по лицензии GPLv3.
© 2006-2010 Jan Kanters
© 2010-2014 Gert Ebersbach
© 2014-2017 Christoph M. Becker
Russian translation © 2012 Lybomyr Kydray
Russian translation help © 2020 Eugene Tugolukov
Slovak translation © 2014 Dr. Martin Sereday
Dutch translation © 2015 Emile Bastings
Realblog_XH - это fork Realblog 2.8, разработанный Gert Ebersbach. Realblog (который ранее назывался Realblog_XH) основан на Advancednews 1.0.5 Яна Кантерса. Большое спасибо за то, что сделали эти популярные и полезные плагины доступными под GPL.
Realblog_XH использует jscalendar разработанный Mihai Bazon. Большое спасибо разработчику за публикацию этого компонента под LGPL.
Значок плагина разработан Alessandro Rei. Большое спасибо за публикацию иконки под GPL.
Значок новостного канала разработан Anomie. Большое спасибо за выпуск его под лицензией GPL.
Этот плагин использует иконки материалов от Google и бесплатные иконки приложений от Aha-Soft. Большое спасибо за то, что сделали эти иконки свободно доступными.
Большое спасибо сообществу на CMSimple_XH forum за советы, предложения и тестирование. В частности, я хочу поблагодарить frase за множество хороших предложений и за то, что он подтолкнул меня к разработке этого плагина.
И последнее, но не менее важное - большое спасибо: Peter Harteg, отцу-основателю CMSimple, и всех разработчиков CMSimple_XH без которых эта удивительная CMS не могла бы существоввать.