Landing Page Framework

Простой PHP-фреймворк для создания одиночных страниц

Версия 16.0 (30-03-2014)

Скачать Landing Page Framework

Возможности LPF

Не требует базы данных
Поддержка ЧПУ
Произвольная вложенность страниц
Гибкая настройка
Настоящая компиляция LESS/CSS
Поддержка BBCode
Поддержка HAML
Поддержка Markdown
Авторасстановка HTML-тегов
Работа с любым CSS-framework'ом
Поддержка jQuery и любого js-фреймворка

Используйте ...

для Landing pages ЂЂЂ целевые/продающиеся страницы сайта;
для сайтов, состоящих из небольшого количества страниц;
для демо-примеров, где требуется «чистый» html/css/js-код;
для изучения HTML, PHP, CSS, Less, BBCode, Haml и Markdown;
для исследования любых CSS/JS-фреймворков;
для обучения верстке сайтов;
и т.д.

Быстрый старт

Скачайте zip-архив.
Создайте на сервере каталог landing
Загрузите файлы на сервер
Наберите в браузере http://сайт/landing

Преимущества Landing Page Framework

Высочайшая скорость работы. Небольшой размер.
Минимальная нагрузка на сервер. Без MySQL.
Простота освоения. Гибкость. Настраиваемость.
Открытость. Бесплатность.

Страницы (page)

Все страницы сайта хранятся в каталоге pages. Каждая страница располагается в своём подкаталоге. Имя каталога совпадает с именем страницы. Например, страница contact будет располагаться в pages/contact/.

Каждая страница использует два файла: text.php и variables.php. Файл text.php содержит текст (с html) страницы. Файл variables.php содержит переменные, которыми можно управлять страницей. Скажем здесь указываются title и meta-данные. (Пример см. в home)

Поскольку text.php исполняемый, то можно смело использовать любой PHP-код.

Результат вывода страниц кешируется в каталоге /cache/. Убедитесь, что этот каталог имеет разрешения на запись (обычно права 777).

Подстраницы

При желании можно использовать подстраницы. Они располагаются в подкаталоге основной страницы. Уровень вложенности страниц может быть произвольным. Путь к таким страницам совпадает с подкаталогами. Например: страница http://site.com/contact/about будет размещаться в /pages/contact/about/.

Для подстраниц действуют теже правила и возможности, что и для основных страниц.

CSS/LESS

В «Landing Page Framework» используется компилятор LESS, поэтому результирующий css-файл стилей формируется автоматически как css/style.css. Вам не следует его использовать.

Исходные стили располагаются в каталоге css-less. Основной файл style.less. В нем удобно выполнять подключение остальных стилей с помощью @import. Файл app.less можно использовать для прочих стилей сайта.

Структура LESS-файлов может быть произвольной.

JS. jQuery

В комплекте «Landing Page Framework» включена библиотека jQuery, а также ряд других js-файлов. Файлы скриптов располагаются в каталоге js.

В каталоге js/autoload можно размещать js-файлы, которые будут автоматически загружаться в секцию HEAD.

Если вы сделаете файл js/my.js, то он автоматически подключится в конце секции BODY.

BBCode

Поддержка BBCode возможна на уровне каждой страницы. Для этого в файле variables.php укажите:

$VAR['bbcode'] = true;

После этого вы можете использовать на странице BBCode.

HAML

Для использования HAML, размещайте текст в файле text.haml. При этом text.php будет проигнорирован.

Результат компиляции HAML-файла кешируется в каталоге engine/haml/haml/haml-cache/ в виде html-файлов. Убедитесь, что этот каталог имеет разрешения на запись (обычно права 777).

Markdown

Поддержка Markdown возможна на уровне каждой страницы. Для этого в файле variables.php укажите:

$VAR['markdown'] = true;

После этого вы можете использовать на странице обычный синтаксис Markdown или расширенный. Также вы можете воспользоваться online-MD-редактором StackEdit.

Авторасстановка HTML-тегов

В text.php можно разрешить автоматическую расстановку тегов. Для этого в файле variables.php укажите:

$VAR['autotag'] = true;

В таком режиме будут автоматически расставлены теги абзаца P по переносам строк (Enter). Этот режим можно использовать совместно с BBCode (и Markdown). Если требуется разместить код, который не следует обрабатывать, используйте спецкод [html]:

[html]
... код без обработки ...
[/html]

Также в этом режиме происходит автоматическая конвертация содержимого PRE в html-спецсимволы.

Обработка содержимого PRE

В этом режиме LPF будет автоматически преобразовывать содержимое PRE в html-спецсимволы. Для этого следует в variables.php задать:

$VAR['autopre'] = true;

Страницы без вывода в браузер или произвольный вывод

Для любой страницы можно задать произвольный вывод в «обход» корневого index.php. Например необходимо организовать приём POST/AJAX-запросов, в котором нужен доступ к функциям LPF. Для этого в variables.php нужно задать подключаемый файл:

$VAR['no_output_only_file'] = 'post.php';

При обращении к этой странице произойдет загрузка функций LPF и подключение файла страницы post.php без какого либо вывода в браузер. Вся дальнейшая логика работы страницы определяется в указанном post.php.

Прочие настройки

Как отключить автоматическую загрузку JS

В variables.php укажите:

$VAR['nojs'] = true;

Как отключить автоматическое выполнение LESS и CSS

В variables.php укажите:

$VAR['nocss'] = true;

Как отключить кеширование вывода страницы

В variables.php укажите:

$VAR['nocache'] = true;

Как указать css-класс для BODY

В variables.php укажите:

$VAR['body_class'] = 'mypage';

где «mypage» ЂЂЂ требуемый css-класс.

Как поменять каталог (в /pages/) главной страницы

По умолчанию для главной используется каталог home. Для его смены создайте php-файл engine/config.php, где укажите:

define("HOME_PAGE", "mysite");

где «mysite» ЂЂЂ каталог в pages.

Если сайт расположен в корне домена

Фреймворк расчитан на расположение в каталоге landing. Чтобы его сменить, следует в .htaccess изменить:

...
RewriteBase /
RewriteCond $1 !^(index\.php|robots\.txt|favicon\.ico)
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ /index.php?page=$1 [QSA] 
...

Если не работает ЧПУ: Если ЧПУ не работает, то проверьте подключение в Apache модуля mod_rewrite.

Используйте robots.txt: В комплекте готовый robots.txt, в котором следует только указать адрес сайта в параметре host.

Как поменять файл текста страницы

Стандартно для текста используется text.php. Для его смены создайте файл init.php в каталоге страницы, где укажите:

$MSO['_page_file'] = 'mytext.php';

Примеры использования CSS-фреймворков

«Landing Page Framework» позволяет использовать любой css-фреймворк. CSS-стили размещайте в каталоге css-less, а подключение css-файлов в style.less.

Для примера вы можете скачать архив using-css-frameworks.zip, где реализовано подключение:

bootstrap
foundation
kickstart
pure
uikit

В каждом каталоге «use_...» используются разные фреймворки. Загрузите файлы выбранного css-фреймворка поверх файлов «Landing Page Framework» и в браузере наберите http://сайт/ФРЕЙМВОРК.

Примечание. Поскольку результирущий css/style.css и исходный css-less/style.less будут меняться в разных css-фреймворках, то загружать файлы лучше на чистый «Landing Page Framework».

Произвольный CSS-фреймворк на уровне страницы

При желании можно использовать css-фреймворк (или любые css-стили, js-код, шрифты и изображения) в каждой странице отдельно. В этом случае следует отключить автоматическую загрузку css и js в файле variables.php:

$VAR['nocss'] = true;
$VAR['nojs'] = true;

А в файле head.php выполнить подключения вручную. Например:

echo mso_load_script(BASEURL . 'js/jquery.min.js');
echo mso_load_script(CURRENT_PAGE_URL . 'js/bootstrap.min.js');
echo mso_load_css(CURRENT_PAGE_URL . 'css/bootstrap.min.css');

В качестве примера вы можете скачать архив sample-pages.zip, который следует распаковать в каталог pages.

Рабочие примеры (демо-страницы css-фреймворков):

Специальные файлы страницы

Используйте эти файлы при необходимости.

head.php подключается в секцию HEAD.
header.php подключается в начале секции BODY.
footer.php подключается в конце секции BODY.
init.php подключается при инициализации LPF.

LPF подключит их автоматически.

PHP-константы

В text.php можно использовать некоторые предопределенные php-константы:

NR ЂЂЂ перенос строки
NT ЂЂЂ перенос + табулятор
BASEURL ЂЂЂ http-адрес сайта
BASEPATH ЂЂЂ путь к сайту на сервере
PAGES_DIR ЂЂЂ путь к каталогу /pages/ на сервере
PAGES_URL ЂЂЂ http-путь к каталогу /pages/ на сервере
SET_DIR ЂЂЂ путь к каталогу /set/ на сервере
SET_URL ЂЂЂ http-путь к каталогу /set/ на сервере
CURRENT_PAGE ЂЂЂ имя текущей page
CURRENT_PAGE_DIR ЂЂЂ путь на сервере к текущей page
CURRENT_PAGE_URL ЂЂЂ http-адрес к текущей page

Автоподключение JS-файлов

Автоподключение выполняется для всех js-файлов, размещенных в общем каталоге js/autoload/. Для того чтобы запретить автоподключение, нужно в variables.php указать:

$VAR['nojs'] = true;

Это отключит автозагрузку, включая jQuery.

Для автозагрузки js-файлов на уровне страницы, достаточно разместить их в аналогично, только в каталоге страницы js/autoload/. Чтобы запретить автоподключение нужно в variables.php указать:

$VAR['autoload_js_page'] = false;

Комбинируя эти два параметра, можно управлять автозагрузкой js-файлов.

Автоподключение CSS-файлов. Автокомпиляция LESS

Стандартно LPF настроен на автоматическую LESS-компиляцию файла css-less/style.less в css/style.css. Для того, чтобы отключить эту возможность в variables.php нужно указать:

$VAR['nocss'] = true;

Если требуется выполнить автозагрузку css-файлов, то их следует разместить в каталоге css/autoload/.

Аналогично можно использовать less-компиляцию для отдельных страниц. Для этого достаточно разместить исходный файл css-less/style.less в каталоге страницы. Результат будет там же в css/style.css. Для того, чтобы выполнить автозагрузку css-файлов, достаточно разместить их в каталоге страницы css/autoload/.

Для того, чтобы отключить автоподключение css-файлов следует в variables.php указать:

$VAR['autoload_css_page'] = false;

Связи между страницами / Общие блоки

Если на сайте несколько страниц, то удобно вынести общие блоки в отдельные php-файлы. Например счетчики, шапку и подвал сайта. Подключаемые файлы можно размещать в каталоге /set/ в подкаталоге «шаблона» (в примере ЂЂЂ «mysite»). Например:

/set/mysite/header.php
/set/mysite/footer.php
/set/mysite/counters.php

Подключение осуществляется в тексте записи. Например:

<?php require(SET_DIR . 'mysite/header.php') ?>

«SET»-каталог позволяет «Landing Page Framework» работать в качестве простой CMS, где используются произвольные php/html-шаблоны для разных сайтов.

Общие компоненты

Сложный php-код можно оформить в виде компонентов. Компоненты располагаются в каталоге /components/, каждый в своем подкаталоге. Вывод компонента осуществляется с помощью функции mso_component(). Например вывод компонента menu:

mso_component('menu', array( 
	'menu' => '/ | Главная ~ changelog | История изменений',
	'ul_class' => 'uk-breadcrumb',
	'selected' => 'selected'
));

Первым параметром функции указывается выводимый компонент, вторым ЂЂЂ его опции (они будут доступны в файле компонента как переменная $OPTIONS).

Компоненты позволяют упростить создание кода страниц за счет настраиваемости и переносимости.

Лицензия GNU GENERAL PUBLIC LICENSE - 2

«Landing Page Framework» можно использовать для любых проектов, включая коммерческие без ограничений и бесплатно, при условии сохранения копирайтов. Используемые библиотеки распространяются по их исходным лицензиям и условиям.

Donation возможен через Фонд развития MaxSite CMS.

Новости через твиттер @maxsite.

Автору бЂдет приятно, если вы расскажете о «Landing Page Framework» своим читаталям/посетителям (кнопка «Твитнуть»).

Отзывы о «Landing Page Framework»

LPF ЂЂЂ простой PHP-фреймворк для создания одиночных страниц

Скачать Landing Page Framework