README

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

Website    Documentation    Releases    Community

Sponsors

Bedrock is an open source project and completely free to use. If you've benefited from our projects and would like to support our future endeavors, please consider sponsoring Roots.

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😱

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

​Twig.

​Timber.

​Bedrock.

​Wordpress API.

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

Пакет на packagist.