README

初始化新项目

composer create-project studiometa/wordpress-project www.fqdn.com

安装

根据.env.example文件创建和配置.env文件。根据.htaccess.example文件创建和配置.htaccess文件。

安装必要的依赖项

# Installer les dépendances Composer avec PHP 7.3
php7.3 $(which composer) install

# Installer les dépendances NPM avec Node 16
nvm use 16
npm install

使用wp-cli完成安装。如果您使用ddev，请使用前缀：ddev wp，否则从vendor目录运行命令：/vendor/bin/wp

/vendor/bin/wp 

# Créer la base de donnée (non nécessaire si vous utilisez ddev)
/vendor/bin/wp db create 

# Installer WordPress 
/vendor/bin/wp core install --url="{URL_DU_SITE}" --title="{TITLE_DU_SITE}" --admin_user="{ADMIN_USER}" --admin_email="{ADMIN_EMAIL}"

# Installer la langue FR
/vendor/bin/wp language core install fr_FR

# Activer la langue FR
/vendor/bin/wp site switch-language

# Activer les plugins WordPress
/vendor/bin/wp plugin activate classic-editor advanced-custom-fields-pro seo-by-rank-math

开发

可用命令

NPM

命令	描述
`npm run dev`	启动SCSS和JS主题文件编译服务器。
`npm run build`	构建主题的SCSS、JS和Vue文件。
`npm run lint`	使用ESLint、Stylelint和Prettier检查主题的SCSS、JS、Vue和Twig文件。
`npm run lint:scripts`	使用ESLint和Prettier检查主题的JS和Vue文件。
`npm run lint:styles`	使用Stylelint和Prettier检查主题的SCSS和Vue文件。
`npm run lint:templates`	使用Prettier检查主题的Twig文件。
`npm run fix`	使用ESLint、Stylelint和Prettier格式化主题的SCSS、JS、Vue和Twig文件。
`npm run fix:scipts`	使用ESLint和Prettier格式化主题的JS和Vue文件。
`npm run fix:styles`	使用Stylelint和Prettier格式化主题的SCSS和Vue文件。
`npm run fix:templates`	使用Prettier格式化主题的Twig文件。

Composer

命令	描述
`composer phpcs`	检查主题和自定义插件中的PHP文件。
`composer phpstan`	静态分析主题和自定义插件中的PHP文件。

WP CLI

WPCLI（非详尽列表）的实用命令https://wp-cli.org/fr/

如果wp cli已安装在您的机器上并配置在您的$PATH中，请使用以下命令，否则使用./vendor/bin/wp

命令	描述
`wp user create <USER_LOGIN> <USER_EMAIL> --role=<ROLE_NAME> --user_pass=<PASSWORD>`	创建用户
`wp transient delete --all`	删除数据库中的所有transients
`wp post delete $(wp post list --post_type='revision' --format=ids) --force`	删除所有修订版本
`wp plugin activate`	激活插件
`wp plugin deactivate`	停用插件
`wp 搜索替换 'http://old-domain.com/' 'http://new-domain.com/' --precise --recurse-objects --all-tables-with-prefix`	替换所有URL以迁移数据库。⚠ 在运行此命令之前请进行备份，添加参数 `–dry-run` 以执行命令但不进行更改
`wp language core install fr_FR && wp language core activate fr_FR`	安装新的后台语言（将 `fr_FR` 替换为所需的语言）

添加插件和mu-plugin

要添加第三方插件和mu-plugin，请使用Composer并通过 wpackagist.org 获取帮助。例如，要添加插件 Classic Editor，您可以按照以下步骤操作

composer require wpackagist/classic-editor

默认情况下，Git会忽略位于 web/wp-content 子目录中的所有内容，以避免跟踪使用Composer安装的第三方包。要将您的自定义插件和主题添加到Git存储库中，您必须在 .gitignore 文件中添加规则

!/web/wp-content/mu-plugins/my-mu-plugin.php
!/web/wp-content/plugins/my-plugin/

附加功能

按环境禁用插件

MU插件 Studiometa plugin disabler 允许根据环境强制禁用插件。查看readme 获取更多信息。

studiometa / wordpress-project

维护者

详细信息