Back to packageRELEASE DETAILS

1.6.1

npm

@0x6368656174/wp-builder

WordPress CLI for fast build modern site

Published29 Jan 2019

Direct dependencies44

Transitive dependenciesNot calculated

README

Current package documentation

@0x6368656174/wpbuild

Утилита командной строки для продуктивной работы с WordPress при помощи интеграции с WebPack.

Зачем нужен данная утилита

Утилита пытается решить следующие проблемы разработки на WordPress:

Разделение кода и представления, при помощи twig-шаблонов, в виде интеграции с Timber;
Модульности JavaScript-кода, при помощи Babel и WebPack;
Модульности CSS-кода, при помощи Sass/Scss и использовании БЭМ-методологии;
Использование пакных менеджеров, при помощи интеграции с npm и Composer;
Быстрый старт и развертывание проекта;
Использование литеров, для автоматического контроля и исправления стиля написания кода;
Сборка проекта из исходников и его распространение, для возможности интеграции проекта с CI.

Установка

Для установки, необходимо выполнить команду:

# npm install -g @0x6368656174/wp-builder

Использование

Инициализация нового проекта

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

# wpbuild init

Структура нового проекта

composer/ - каталог со скриптами composer. По-умолчанию, там создается скрипт, который следит за тем, чтоб добавление и обновление пакетов через composer не затирало основные параметры dist/wp-config.php.
dist/ - каталог с результатом сборки проекта.
dist/vendors/ - каталог с установленными пакетами пакетного менеджера composer. После инициализации проекта в него будет автоматически установлено расширение для использования twig-шаблонов WordPress - Timber.
dist/wp-content/ - стандартная папка wp-content из поставки WordPress. Она вынесена отдельно, чтоб она не затиралась, в случае обновления WordPress через composer. В dist/wp-content/название_темы/ будет автоматически собираться тема проекта.
dist/.htaccess - файл конфигурации веб-сервера Apache, для работы WordPress из подкаталога wordpress.
dist/wordpress/ - каталог автоматической установки WordPress из composer.
dist/index.php - переделанный стандартный index.php WordPress для работы его из подкаталога wordpress.
dist/wp-config.php - стандартный файл с настройками WordPress. Параметры DB_NAME, DB_USER, DB_PASSWORD, DB_HOST и WP_DEBUG не будут перезатераться при обновлении WordPress через composer.
node_modules/ - каталог с установленными пакетами пакетного менеджера npm.
src/название_темы/ - каталог с исходниками темы.
.editorconfig - файл описания стиля кода для IDE.
.eslintrc - файл конфигурации линтера JavaScript - ESLint.
.gitignore - файл описания игнорируемых файлов системой контроля версии git.
.lintstagedrc - файл описания автоматического применения литеров, при создании коммита в git.
.php_cs.dist - файл конфигурации линтера PHP - PHP-CS-Fixer.
.prettierrc - файл конфигурации утилиты автоматического форматирования кода Prettier.
.stylelintrc - файл конфигурации линтера CSS/Sass/Scss - StyleLint.
composer.json - стандартный файл описания проекта пакетного менеджера composer.
composer.lock - служебный файл пакетного менеджера composer.
wpbuild.json - файл конфигурации проекта. Описание конфигурации смотри ниже.
package.json - стандартный файл описания проекта пакетного менеджера npm.
tsconfig.json - файл конфигурации TypeScript.
tslint.json - файл конфигурации линтера TypeScript - TSLint.

Утилита позволяет разбить проект WordPress (тему), на независимы модули, компонтенты (бллоки), каждый из которых содержит в себе отдельные реализации на PHP, HTML (twig) CSS (так же поддерживаются Sass и Scss), и JavaScript (так же поддерживается TypeScript). Релизации внутри модуля могут быть автономными, а могу быть связаны со смежными модулями. Для CSS части связь реализуется только в вариантах написанных на Sass/Scss, при помощи @import диррективы. Для JavaScript части связь реализуется при помощи ES-модулей.

Утилита собирает все модули в готовый проект, при этом все CSS-части компилируются в несколько оптимизированных CSS-файлов, а JS-части компилируются при помощи Babel или TypeScript в ES6, и собираются в отдельные JS-модули при помощи WebPack.

Принципы организации файлов с исходниками темы

Все файлы с исходниками принято располагать в папке src/название_темы/.

Файлы PHP рекомендуется размещать внутри вложенных папок сгруппированных по назначению. Например, файлы описывающие пользовательские мето-боксы можно разместить в папке src/название_темы/MetaBox. Утилита автоматически настраивает RSR-4 автолоад файлов PHP по их пространству имен. Она создает пространство имен вида название_темы в CamelCase стиле (например для темы test-theme утилита создаст пространство имен TestTheme) и прописывает PSR-4 автолоад для поиска пространства имен темы в папке src/название_темы/. Поэтому для PHP-файлов можно задать пространство имен (nampespace) и потом автоматически их подключать при помощи PSR-4 автолоада. Например для файла описывющего пользовательский мето-бокс для главной страницы Front темы test-theme можно задать пространтсво имен namespaces TestTheme\MetaBox и потом использовать его при помощи PSR-4 автолоада use TestTheme\MetaBox\Front. Важно соблюдать правила именования PSR-4, т.е. название папки должно совпадать с названием пространства имен, а название класса с названием файла.

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 44

Native requirements

44 direct targetsNot calculated transitive count

Package / target	Requirement	Relationship
@babel/core Environment { "local_name": "@babel/core", "alias": false, "peer_metadata": null }	`^7.2.2`	runtime
@babel/plugin-transform-runtime Environment { "local_name": "@babel/plugin-transform-runtime", "alias": false, "peer_metadata": null }	`^7.2.0`	runtime
@babel/preset-env Environment { "local_name": "@babel/preset-env", "alias": false, "peer_metadata": null }	`^7.3.1`	runtime
@babel/runtime Environment { "local_name": "@babel/runtime", "alias": false, "peer_metadata": null }	`^7.3.1`	runtime
autoprefixer Environment { "local_name": "autoprefixer", "alias": false, "peer_metadata": null }	`^9.4.6`	runtime
babel-loader Environment { "local_name": "babel-loader", "alias": false, "peer_metadata": null }	`^8.0.5`	runtime
blessed Environment { "local_name": "blessed", "alias": false, "peer_metadata": null }	`^0.1.81`	runtime
camelcase Environment { "local_name": "camelcase", "alias": false, "peer_metadata": null }	`^5.0.0`	runtime
clean-webpack-plugin Environment { "local_name": "clean-webpack-plugin", "alias": false, "peer_metadata": null }	`^1.0.1`	runtime
copy-webpack-plugin Environment { "local_name": "copy-webpack-plugin", "alias": false, "peer_metadata": null }	`^4.6.0`	runtime
css-loader Environment { "local_name": "css-loader", "alias": false, "peer_metadata": null }	`^2.1.0`	runtime
cssnano Environment { "local_name": "cssnano", "alias": false, "peer_metadata": null }	`^4.1.8`	runtime
eslint Environment { "local_name": "eslint", "alias": false, "peer_metadata": null }	`^5.12.1`	runtime
eslint-config-google Environment { "local_name": "eslint-config-google", "alias": false, "peer_metadata": null }	`^0.11.0`	runtime
extract-text-webpack-plugin Environment { "local_name": "extract-text-webpack-plugin", "alias": false, "peer_metadata": null }	`^4.0.0-beta.0`	runtime
file-loader Environment { "local_name": "file-loader", "alias": false, "peer_metadata": null }	`^3.0.1`	runtime
git-rev-sync Environment { "local_name": "git-rev-sync", "alias": false, "peer_metadata": null }	`^1.12.0`	runtime
glob Environment { "local_name": "glob", "alias": false, "peer_metadata": null }	`^7.1.3`	runtime
html-loader Environment { "local_name": "html-loader", "alias": false, "peer_metadata": null }	`^0.5.5`	runtime
loader-utils Environment { "local_name": "loader-utils", "alias": false, "peer_metadata": null }	`^1.2.3`	runtime
lodash Environment { "local_name": "lodash", "alias": false, "peer_metadata": null }	`^4.17.11`	runtime
mini-css-extract-plugin Environment { "local_name": "mini-css-extract-plugin", "alias": false, "peer_metadata": null }	`^0.5.0`	runtime
mkdirp Environment { "local_name": "mkdirp", "alias": false, "peer_metadata": null }	`^0.5.1`	runtime
node-sass Environment { "local_name": "node-sass", "alias": false, "peer_metadata": null }	`^4.11.0`	runtime
postcss-loader Environment { "local_name": "postcss-loader", "alias": false, "peer_metadata": null }	`^3.0.0`	runtime
postcss-preset-env Environment { "local_name": "postcss-preset-env", "alias": false, "peer_metadata": null }	`^6.5.0`	runtime
prettier Environment { "local_name": "prettier", "alias": false, "peer_metadata": null }	`^1.16.1`	runtime
resolve-url-loader Environment { "local_name": "resolve-url-loader", "alias": false, "peer_metadata": null }	`^3.0.0`	runtime
sass-loader Environment { "local_name": "sass-loader", "alias": false, "peer_metadata": null }	`^7.1.0`	runtime
simple-get Environment { "local_name": "simple-get", "alias": false, "peer_metadata": null }	`^3.0.3`	runtime
style-loader Environment { "local_name": "style-loader", "alias": false, "peer_metadata": null }	`^0.23.1`	runtime
stylelint Environment { "local_name": "stylelint", "alias": false, "peer_metadata": null }	`^9.10.1`	runtime
stylelint-config-sass-guidelines Environment { "local_name": "stylelint-config-sass-guidelines", "alias": false, "peer_metadata": null }	`^5.3.0`	runtime
stylelint-order Environment { "local_name": "stylelint-order", "alias": false, "peer_metadata": null }	`^2.0.0`	runtime
stylelint-scss Environment { "local_name": "stylelint-scss", "alias": false, "peer_metadata": null }	`^3.5.1`	runtime
ts-loader Environment { "local_name": "ts-loader", "alias": false, "peer_metadata": null }	`^5.3.3`	runtime
tslint Environment { "local_name": "tslint", "alias": false, "peer_metadata": null }	`^5.12.1`	runtime
typescript Environment { "local_name": "typescript", "alias": false, "peer_metadata": null }	`^3.2.4`	runtime
url-loader Environment { "local_name": "url-loader", "alias": false, "peer_metadata": null }	`^1.1.2`	runtime
webpack Environment { "local_name": "webpack", "alias": false, "peer_metadata": null }	`^4.29.0`	runtime
webpack-dev-server Environment { "local_name": "webpack-dev-server", "alias": false, "peer_metadata": null }	`^3.1.14`	runtime
webpack-notifier Environment { "local_name": "webpack-notifier", "alias": false, "peer_metadata": null }	`^1.7.0`	runtime
write-file-webpack-plugin Environment { "local_name": "write-file-webpack-plugin", "alias": false, "peer_metadata": null }	`^4.5.0`	runtime
yargs Environment { "local_name": "yargs", "alias": false, "peer_metadata": null }	`^12.0.5`	runtime

Distribution files

1 collected

Distribution 1

Source distribution

Source file

Checksums from source

{
  "integrity": "sha512-ynPJVH5BUuy9mRg/cPLMZ5LCJusWW4D4kpujsxGQTUGTgrPUUFDEy7K+ctLPrZiWHI8y3yOiiodKCMCmPytRcA==",
  "shasum": "02ebd9504a0b6e0be40c5e4645dc9e89c2d3752b",
  "tarball": "https://registry.npmjs.org/@0x6368656174/wp-builder/-/wp-builder-1.6.1.tgz",
  "fileCount": 52,
  "unpackedSize": 812820,
  "npm-signature": "-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJcT6nwCRA9TVsSAnZWagAAvAMQAJvv6wpVjVs4hlqKgwTg\nPj76haaLYaVhXDtOywMYHhIyRmk/JeybhuGHfyW8OFHb0X9dgvQuXJZOhMW8\nVR26OyoSb1la9ueTqKD7j7fJ5WZBdTS/jVpukhkSZdnHmXULRybKCr5aE5W5\ns1AQTSRD2KAMTle4KrBCTOhWQDhvIIY0fNUPWa1vot3LkWOH0k97Lf+0IGXP\nIFdAjftN+EPrzPw6d/HhiU0sjxBbeqs7CjiI05QllxKvFTM1/Rc7FitZtOgo\neReQIurwi8CrpobKWdyQsnuSG3xY91z9lOaqdojjbxHjbwpy18OPWcDlEi3Y\nKade1bOXiLNu+wpeERLrfPtsmG7shZQBZocOKNQek83Sh3JfpxzAfozHFuLB\nWtEx90NmoOS06vjaYpTlSMnE/wyf/lhYRraQcm0m0TOuur+CTNx5YEFORQTm\n966AoKoLNGEF6Yqz21ActYMgr4rWPHHj0v9O3RCVEDYP8dFsDrLRtLv5RqEw\n/3fonwW/qsrqo2doWlSPdUbT7l0nnOdKDIGgNotzFzw4Wx1pvw4+lc6qKJlN\n7xd4f/KEXbsoCcCgLDYgfpPkTBbnPOE1/Y4adF9fk7QfzZ/zaDmGf+cP3Pvx\nLEprsoMCYYGDgbZYKoPMq+94yOjern62GSuEivgt8tBg/EywbUlEwZq30ytT\nrleF\r\n=xARf\r\n-----END PGP SIGNATURE-----\r\n",
  "signatures": [
    {
      "keyid": "SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA",
      "sig": "MEQCIEjln+KYW+rb2NcCMSSOQs8ikPwUe5iiryMD6BnrxdRLAiArxmyIwkugRcGXdURh51mrExLeUjEiVj6fAPoyNC+JVg=="
    }
  ]
}

Repository

PENDING

0x6368656174/wb-builder

Shared repository data · GitHub

License detected in repository: Not collected

Repository

ACCESSIBLE

0x6368656174/wp-builder

Shared repository data · GitHub

License detected in repository: LGPL-3.0
License branch / ref: master
Last push: 29 Jan 2019
Archived: No
Contributor identities: — · partial collection

Public sponsor counts have not been collected. These signals belong to the repository owner.

Downloads & popularity

0count

Gauge · observed snapshots24 Oct 2026

10.50

24 Oct24 Oct

github · 1 observations shown. Missing days are unknown.

View observed values

Date / source period	Value	Observed at
2026-10-24	0	2026-10-24T12:18:04.8244482Z

Metadata history

Meaningful changes

Current collected state Current

Observed since 20 Oct, 22:38 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:5c274a5a4f110d6eddee0fdfdc4e079126d7b798cea970af04014a9e5e3b1d59

Other collected versions

1.6.028 Jan 1.5.028 Jan 1.4.028 Jan 1.3.229 Nov 1.3.128 Nov 1.3.028 Nov View all collected versions →