Система тикетов

Шорт-коды для приложения blog

Давайте рассмотрим как работать шаблоном приложения blog и изучим какие шорт-коды есть в нём.

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

В приложении blog реализованы такие моменты как: главная страница, страница обратной связи, страница полной новости, вывод новостей с определённой категории с разными настройками, постраничная навигация. Отсутствует пока что поиск на сайте и комментирование новостей, но Вы можете подключить пока https://disqus.com/ которым пользуется большинство блогеров. В ближайшее время я сделаю функционал комментариев.

Разрабатывая систему, я взял за основу схему шаблонизатора, что бы вёрстка была чистой и без вставок php кода. Верстая и создавая сайты я сделал вывод для себя, что не удобно верстать сайт тому, кто не знает и не понимает язык php. Например в woordpress используется php в месте с html, что не очень хорошо воспринимается. Но я не хочу никого обидеть, ведь каждый работает так как ему нравится. И моя система будет кому-то по душе, а кому-то нет, это дело каждого.

[Шорт-коды]

Глобальные шорт-коды, которые будут использоваться во всех приложениях.

{DIR} - директория к папке с шаблоном приложения. Например: http://site.com/public/source/applications/blog/default

{HOME} - урл главной страницы приложения.

{SYSTEMS-SCRIPTS} - библиотека Ajax JQuery + systems.js который будет содержать собственную библиотеку плагинов для работы с сайтом.

[show = "home"]содержимое[/show] - содержимое между тегами будет показано только если пользователь находится на главной странице. Шорт-код может принимать три значения: home, category, page. Думаю по смыслу понятно, что home значит на главной, category на страницах категорий и т.д. Можно указать сразу несколько значений, например [show = "home, page"]содержимое[/show] - будет выводить содержимое только на главной странице и на странице новости, которое заканчивается окончанием .html

[not-show = "home"][/not-show] - противоположный смысл предыдущего шорт-кода.

[user = "admin, 5, guest"]содержимое[/user] - шорт код [user = ?] будет показывать содержимое только тем, кто перечислен в значении. В данном примере содержимое будет отображаться для администратора, для пользователя, который находится в группе №5 и для гостя, а для всех остальных содержимое не будет показано.

На данный момент администратору показывается содержимое всегда, даже если значение стоит только guest или номер группы.

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

[no-user = "admin"]содержимое[/no-user] - шорт код скроет содержимое, если Вы являетесь администратором. Значение так же может принимать несколько параметров.

Эти шорт-коды обрабатывают даже полученные данные из базы, будьте внимательны!

Шорт-коды приложения блог.

{content} - данный код выводит содержимое страницы, а именно несколько кратких новостей или полную новость, в общем отвечает за вывод контента.

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

{file = "header.tpl"} - подключает файл header.tpl из шаблона. В значении может быть указан любой другой файл находящийся в корне шаблона или в любой другой папке от корня шаблона приложения.

{menu = "name_menu"} - подключает меню созданное в приложении, а именно меню с названием name_menu. Значение может быть любым разумеется.

{news category = "7" template = "my_news.tpl" limit = "5"} - выведет новости из категории №7 (номер можно посмотреть в админке) используя шаблон my_news.tpl и выведет всего 5 последних новостей. Такие атрибуты как template и limit могут быть опущены. По умолчанию для template будет использоваться файл news_min.tpl, а для limit будет подставляться значение из настроек приложения.

Обязательные файлы шаблона: index.tpl, news_min.tpl, news_max.tpl, feedback.tpl

index.tpl - главный файл, к которому идёт запрос с глобальной системы.

news_min.tpl - отвечает за вывод краткой новости по умолчанию.

news_max.tpl - отвечает за вывод полной новости по умолчанию.

feedback.tpl - отвечает за вывод формы обратной связи.

Коды файла news_min.tpl и шаблонов для вывода новостей из других категорий.

{news_link} - выводит ссылку на полную новость.

{title} - заголовок новости.

{news_min} - краткое содержимое новости.

{date} - дата публикации новости.

{category_link} - ссылка на категорию новости.

{category_name} - название категории новости.

Коды файла news_max.tpl такие же, кроме одного.

{news_max} - полное содержимое новости.

Далее будет...




Скачать apps-system 1.0 apps-system on GitHub
Реклама от Google