Генерация скриптов и файлов

Набор и вложенность исходников отражает архитектуру проекта, при генерации собирается задуманный разработчиком набор файлов генерируемого веб-ресурса. После генерации собранный веб-ресурс «живет» своей жизнью, независимой от генератора.

Vcorp Generator может находиться по любому URL веб-ресурса, это настраивается разработчиком и никак не влияет на работоспособность. Более того, может быть сколько угодно копий движка на одном сайте по разным URL - для разработки любого числа тестовых сайтов (при генерации относительные внутренние URL и ссылки преобразуются в реальные, согласно указанной в vpb_config.php корневой директории для генерации).

Для разработки тестового сайта (или копии сайта) можно создать любую директорию (например mysite.ru/test/), установить туда копию движка, при необходимости провести импорт исходников, и сгенерировать новый сайт с корнем mysite.ru/test/ - при генерации все внутренние ссылки автоматически преобразуются к нужному виду.

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

Движок определяет неправильные внутренние ссылки, незакрытые html-теги ссылок, неправильные id динамических ссылок, неправильные или дублирующиеся URL страниц, неправильное вложение исходных элементов, может корректировать и пропускает при генерации неправильные вложения.

Vcorp Generator имеет расширяемый со стороны php-кода набор дополнительных операций.
В общедоступной версии генератора реализована генерация карты сайта sitemap.xml.

Все сгенерированные php - скрипты имеют набор runtime - переменных, например, номер исходного элемента в админке, путь от корня сервера, текущий URL скрипта...

В веб-интерфейсе (админке) движка, первые 6 колонок (0 - 5) исходников называются «страницы» (page). Они предназначены для сборки и генерации конечных скриптов или других текстовых файлов, путем сборки из исходных текстов включаемых элементов (шаблонов, блоков, текстов).

В окне информации для «страниц» задается относительный URL от корня генерируемого веб-ресурса (корень сайта - это значение переменной $pb_path_site файла vpb_config.php).

Если URL оканчивается на «.php» ( или «/» - при $pb_main_file='index.php'; ), то генерируемый файл считается скриптом и в него добавляются runtime - переменные.

В окне информации для каждого генерируемого скрипта можно задать title, keywords, description, приоритет при включении в sitemap.xml, авто-проверку на уникальность title и авто-проверку исходного кода на правильность ссылок и включаемых элементов.

Внимание! Если в исходном коде «страницы» стоит вызов системного зарезервированного шаблона {*tpl0*}, то заданные в окне информации title, keywords, description, при генерации, вставляются в виде мета-тегов, в указанное шаблоном место. Туда же ( вместо {*tpl0*} ) автоматически вставляется мета-тег <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>

Аналогично, в местах включений шаблонов, блоков, текстов, вставляется их содержимое. Конечный файл или скрипт собирается из вставленных исходников «справа налево», то есть сначала включается содержимое текстов, потом блоков, потом шаблонов. При изменении исходников необходима новая генерация, чтобы изменились создаваемые конечные файлы.
Подробнее см. Правила включения исходных текстов друг в друга.

Для навигации по всем страницам этого раздела сайта используйте пиктограмму меню или ссылку Навигация в верхней строке навигации.

Создаваемые директории и файлы

Генерация всегда происходит относительно «корня генерации» (значения переменной $pb_path_site - строка 28 файла vpb_config.php).

Если указанный в окне информации URL содержит один или более разделительных или конечных слешей «/», например, «/sections/section1/item1»,
то будет создана(ы) директория «... /sections/section1/», а в ней файл «item1»

Если указан URL с завершающим слешем «/», например, «/sections/section1/item1/»,
то будет создана директория «... /sections/section1/item1/», а в ней файл «index.php»
( вместо «index.php» можно указать другое название файла, но по умолчанию $pb_main_file='index.php'; ).

При генерации файла index.php, удаляется рядом лежащий файл index.html (по умолчанию). Для изменения такого поведения нужно изменить или закомментировать строку 188 файла vpb_gen.php (для версии 00.80). Это сделано для возможности реализации ресурса с повышенной нагрузочной способностью.

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

Внимание! Директории и файлы, созданные по старым URL (которые больше не нужны), придётся удалять вручную, потому что движок Vcorp Generator принципиально не участвует в работе любых скриптов веб-ресурса, а только работает с исходниками и проводит генерацию/перезапись файлов по указанным URL.

СЕО-замечание: после такой смены URL, не забудьте добавить 301-е редиректы в .htaccess на новые URL, иначе поисковики будут считать новый URL как новую страницу с дублирующим контентом.