README

安装

composer require --dev wpdesk/wp-wpdesk-composer composer require --dev wpdesk/wp-plugin-flow ^2.0

用法

将以下内容添加到 composer.json 文件的 scripts 部分中

        "tests-unit": "docker-compose -f vendor/wpdesk/wp-wpdesk-composer/docker/docker-compose.yaml run wordpress phpunit --no-coverage -c /opt/project/phpunit-unit.xml",
        "tests-integration": "docker-compose -f vendor/wpdesk/wp-wpdesk-composer/docker/docker-compose.yaml run wordpress phpunit --no-coverage -c /opt/project/phpunit-integration.xml",
        "tests": [
            "@composer tests-unit",
            "@composer tests-integration"
        ]

在命令行中输入以下命令以运行脚本

1. 在插件文件中设置插件日期： composer set-plugin-date
2. 设置插件贡献者： composer set-contributors
3. 设置WordPress测试的版本号： composer replace-tested-up-wp
4. 设置WordPress至少需要的版本号： composer replace-requires-at-least-wp
5. 设置WooCommerce测试的版本号： composer replace-tested-up-wc
6. 设置WooCommerce至少需要的版本号： composer replace-requires-at-least-wc
7. 设置PHP至少需要的版本号： composer replace-requires-php
8. 运行命令 1-4： composer set-plugin-data
9. 运行单元测试： composer run-unit-tests 或 composer run-unit-tests fast
10. 运行集成测试： composer run-integration-tests 或 composer run-integration-tests
11. 生成 .pot 文件： composer generate-pot
12. 合并翻译： composer merge-translations
13. 压缩资源： composer minify-assets
14. 生成发布文件夹和压缩包： composer generate-plugin-release
15. 增加插件版本号

    composer increase-plugin-version
    composer increase-plugin-version --minor
    composer increase-plugin-version --major
    

翻译

语言命令的配置（ composer generate-pot，composer merge-translations）必须输入到 composer.json 文件的 extra 部分。

示例配置

	"extra" : {
		"text-domain": "flexible-shipping",
		"translations-folder": "lang",
		"po-files": {
			"pl_PL": "pl_PL.po"
		}
	}

text-domain：插件库文本域

translations-folder：存储翻译的文件夹

po-files：翻译文件

压缩

资源压缩的配置（ composer minify-assets）必须输入到 composer.json 文件的 extra 部分。

示例配置

	"extra": {
		"minify-assets" : {
			"js" : [
				"assets/js/admin.js",
				"assets/js/admin_order.js",
				"assets/js/admin_settings.js",
				"assets/js/checkout.js",
				"assets/js/i18n-support.js"
			],
			"css" : [
				"assets/css/admin.css",
				"assets/css/checkout.css"
			]
		}
	}

其他

要重新生成WooCommerce占位符，请在WooCommerce目录中使用../vendor/wpdesk/wp-wpdesk-composer/director/vendor/szepeviktor/phpstan-wordpress/stub-generators/wc-generate-stubs.sh。

Faker

Faker 可以伪造 vendor_prefixed 库中的库。Faker 可以更改文件内容、文件名和文件夹名。

必须在 composer.json 文件的 extra 部分中输入 Faker 的配置。

Faker 在前缀器之后运行。

示例配置

	"extra": {
		"fake-vendor-prefixed": {
			"path": "wpdesk",
			"fake-path": "octolize",
			"content": {
				"wpdesk": "octolize",
				"WPDesk": "Octolize"
			},
			"file-names": {
				"WPDesk": "Octolize",
				"wpdesk": "octolize"
			},
			"folder-names": {
				"wpdesk": "octolize",
				"WPDesk": "Octolize"
			}
		}
	}

path - vendor_prefixed 中的命名空间（子文件夹）

fake-path - 新的命名空间，可以为空

content - 要在内容中查找和替换的字符串数组

file-names - 要在文件名中查找和替换的字符串数组

folder-names - 要在文件夹名中查找和替换的字符串数组