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

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

Например VS code

code -r .env

Или nano.

nano .env

После внесения изменений сохранить CTRL+S и выход CTRL+X

Вносим в файл .env данные для подключения к базе данных и имя сайта

Добавляем в OpenServer домен с именем как в переменной WP_HOME, но путь указываем до папки web

Открываем сайт и прогружаем wordpress следуя визарду как обычно.

Заходим в админку сайта.

Переходим в закладку плагины и активируем все плагины.

Переходим в Внешний вид -> Темы и активируем тему.

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

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

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

Поздравляю!

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

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

​Twig.

​Timber.

​Bedrock.

​Wordpress API.

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

Пакет на packagist.