README

WordPress boilerplate with Composer, easier configuration, and an improved folder structure

Website Documentation Releases Community

Overview

Bedrock is a WordPress boilerplate for developers that want to manage their projects with Git and Composer. Much of the philosophy behind Bedrock is inspired by the Twelve-Factor App methodology, including the WordPress specific version.

Better folder structure
Dependency management with Composer
Easy WordPress configuration with environment specific files
Environment variables with Dotenv
Autoloader for mu-plugins (use regular plugins as mu-plugins)
Enhanced security (separated web root and secure passwords with wp-password-bcrypt)

Getting Started

Предварительные требования:

Установленный PHP версии 8.2.
Установленный глобально composer.

Последовательность действий:

Создаем папку для проекта

Открываем ее в любом удобном терминале

Создаем проект командой:

composer create-project vyatka-it/vyatka-wp .

>Внимание! Точка в конце команду важна, так как нужно развернуть проект в корень папки.

Устанавливаем зависимости, для этого, в корне папки проекта запускаем команду:

composer install

Переходим в папку web/resources (здесь лежит gulp)

cd web/resources

Устанавливаем зависимости для сборщика gulp.

npm install

>После установки можно проверить и запустить из этой папки Gulp

Переходим в папку с темой web/app/themes/vyatka-it-wp-theme

cd ../app/themes/vyatka-it-wp-theme

и запускаем

composer install

Создаем базу данных для проекта любым удобным образом.

Возвращаемся в корень проекта создаем файл .env из файла .env.example путем копирования

cd ../../../../

cp .env.example .env

Открываем файл .env
Здесь нам понадобятся первые 5 строк:

DB_HOST='MySQL-8.2'
DB_NAME='database_name'
DB_USER='database_user'
DB_PASSWORD='database_password'
WP_HOME='https://example.com'

DB_HOST - указываем хост бд. Если используется open server, то нам достаточно прописать в качестве хоста DB_HOST='MySQL-{используемая версия}'
DB_NAME - необходимо указать имя бд, которую нам нужно предварительно создать.
WP_HOME - нужно прописать тот домен, который используется в .osp/project.ini. Например, по умолчанию, это

Финишная прямая

1) Заходим в админку сайта по адресу:

https://наш-домен/wp/wp-admin

2) Переходим в закладку плагины и активируем все плагины, кроме VyatkaIT Maintenance Mode и WebP Express

3) Переходим в Внешний вид -> Темы и активируем тему vyatka-it-wp-theme.

>Внимание! Если в проекте планируется использовать Woocommerce, то в первую очередь нужно установить и активировать плагин woocommerce на стандартной теме wordpress. И только после этого активировать кастомную тему. В противном случае, вероятнее всего, woocommerce активируется на английском языке и переключить его не получиться.

4) Переходим в страницы и создаем Главную страницу с уже существующим шаблоном Главная страница.

5) Переходим в Настройки –> Чтение и устанавливаем статическую страницу – Главная страница.

Поздравляю!

Сайт готов к разработке и к использованию git😱

Ссылки на технологии, использованные в сборке, там есть документация:

Репозиторий проекта(для Pull Request).

Пакет на packagist.