README

🔥 安装与使用

依赖项

Woody依赖于WordPress社区的两个付费插件。要使用Woody，您必须绝对购买并安装

• Polylang PRO 版本 2.9.0
• ACF PRO (高级自定义字段 PRO) 版本 5.9.1

这些插件必须上传到web/app/plugins目录。

警告：如果您使用Woody PRO版本，可以通过“composer”安装这些依赖项，但这并不意味着您不需要购买这两个插件。

配置

在“config/sites”中为您的每个网站创建一个配置文件。
我的第一个项目名为“mywebsite”，因此我创建了文件"config/sites/mywebsite/.env"。
其中一些设置需要从Raccourci代理处获取，请联系support@woody-wordpress.com
以下是可用的设置

DB_NAME='wp_mywebsite'
DB_USER='wp_mywebsite'
DB_PASSWORD='mypassword'
DB_HOST='127.0.0.1:3306'

# Use MEMCACHED_SERVERS or MEMCACHED_HOST/MEMCACHED_PORT
MEMCACHED_SERVERS='127.0.0.1:11211;127.0.0.1:11212'
MEMCACHED_HOST='localhost'
MEMCACHED_PORT='11211'

MONGO_SERVERS='localhost:27017'

WP_ENV='dev'
WP_MEMORY_LIMIT='256M'
WP_MAX_MEMORY_LIMIT='256M'
WP_POST_REVISIONS='3'
WP_HOME='https://www.mywebsite.com'
WP_GIT_REPOSITORY='git@github.com:organization/mywebsite.git'
FORCE_SSL_ADMIN='false'
EMPTY_TRASH_DAYS='30'

AUTH_KEY=''
SECURE_AUTH_KEY=''
LOGGED_IN_KEY=''
NONCE_KEY=''
AUTH_SALT=''
SECURE_AUTH_SALT=''
LOGGED_IN_SALT=''
NONCE_SALT=''

WOODY_MAINTENANCE='false'
WOODY_MAINTENANCE_ADMIN='false'
WOODY_ACCESS_STAGING='false'
WOODY_ACCESS_LOCKED='false'

WOODY_ACF_GOOGLE_MAPS_KEY=''
WOODY_ACF_PRO_KEY='You must purchase an ACF license'
WOODY_ADMIN_EMAIL=''
WOODY_ADMIN_NAME=''
WOODY_API_LOGIN='Provided by Raccourci Agency'
WOODY_API_PASSWORD='Provided by Raccourci Agency'
WOODY_CLOUDFLARE_ENABLE='false'
WOODY_CLOUDFLARE_TOKEN=''
WOODY_CLOUDFLARE_URL=''
WOODY_CLOUDFLARE_ZONE=''
WOODY_DEEPL_KEY=''
WOODY_DEEPL_DOMAIN=''
WOODY_GOOGLE_MAPS_API_KEY='Provided by Raccourci Agency'
WOODY_GOOGLE_MAPS_API_KEY_PROD='Provided by Raccourci Agency'
WOODY_GTM=''
WOODY_IGN_MAPS_API_KEY='Provided by Raccourci Agency'
WOODY_IGN_MAPS_API_KEY_PROD='Provided by Raccourci Agency'
WOODY_IMAGE_WEBP_ENABLE='false'
WOODY_LATITUDE='46.1482363'
WOODY_LONGITUDE='-1.1750544'
WOODY_OPTIONS='Provided by Raccourci Agency'
WOODY_PERMALINK_STRUCTURE='/%postname%/'
WOODY_SMTP_HOSTNAME='Provided by Raccourci Agency'
WOODY_SMTP_PORT='587'
WOODY_SMTP_SECURE='tls'
WOODY_SMTP_SENDER='Provided by Raccourci Agency'
WOODY_SMTP_SENDER_NAME='Provided by Raccourci Agency'
WOODY_SMTP_USERNAME='Provided by Raccourci Agency'
WOODY_SMTP_PASSWORD='Provided by Raccourci Agency'
WOODY_SSO_ADD_URL_TOKEN='Provided by Raccourci Agency'
WOODY_SSO_CLIENT_ID='Provided by Raccourci Agency'
WOODY_SSO_CLIENT_SECRET='Provided by Raccourci Agency'
WOODY_SSO_SECRET_URL='https://connect.studio.raccourci.fr'
WOODY_TIMEZONE='Europe/Paris'
WOODY_TOURISTIC_MAPS_API_KEY='Provided by Raccourci Agency'
WOODY_TOURISTIC_MAPS_API_KEY_PROD='Provided by Raccourci Agency'
WOODY_TWIG_CACHE_DISABLE='false'
WOODY_VARNISH_CACHING_COOKIE=''
WOODY_VARNISH_CACHING_DEBUG='true'
WOODY_VARNISH_CACHING_ENABLE='false'
WOODY_VARNISH_CACHING_IPS='127.0.0.1:80'
WOODY_VARNISH_CACHING_TTL='2592000'
WOODY_VARNISH_CACHING_TTL_FOCUSRANDOM='86400'
WOODY_VARNISH_CACHING_TTL_FOCUSSHEET='43200'
WOODY_VARNISH_CACHING_TTL_LIVEPAGE='900'
WOODY_VARNISH_CACHING_TTL_WEATHERPAGE='21600'
WOODY_VARNISH_CACHING_TTL_HAWWWAI_SHEET='2592000'
WOODY_VARNISH_CACHING_TTL_HAWWWAI_PLAYLIST='43200'

首先，通过Composer包管理器安装Woody Core（版本2）

composer self-update --2
composer install

运行此命令安装您的网站

woody deploy:core
woody deploy:site -s mywebsite

要从头开始重新安装您的网站

警告：在运行此命令之前，必须清空其数据库

woody deploy:core
woody deploy:site -s mywebsite -o force

执行命令但不需要gulp编译

woody deploy:site -s mywebsite -o no-gulp

可以通过这样做来组合命令

woody deploy:site -s mywebsite -o force,no-gulp

以下是可用的排序选项列表

• 强制
• 速度
• 无gulp
• 无缓存
• 无twig
• 无varnish
• 无cdn
• 无安装
• 无updb
• 无acf
• 无warm
• 无sso

这两个命令产生相同的结果。“速度”是所有这些选项的快捷方式

woody deploy:site -s mywebsite -o speed
woody deploy:site -s mywebsite -o no-install,no-updb,no-acf,no-gulp,no-warm,no-varnish,no-cdn,no-sso

📥 更新

如果您想更改依赖项，您必须事先安装此命令

composer update --prefer-source

否则定期使用此命令自行更新

composer update

🏄 Sass & Gulp

运行以下命令以启动您的文件“watch”。

cd /gulp
yarn watch --site mywebsite

以下命令用于触发生产环境中资源的构建。

cd /gulp
yarn build --site mywebsite

🚧 调试PHP

还有“rcd”函数，它允许您创建自己的“print_r”。

您可以添加两个可选参数

rcd($val, $exit = false, $pre = true);

示例

$array = ['color' => 'red'];
rcd($array, true);

💊 使用WP-CLI

激活插件

WP_SITE_KEY=mywebsite wp plugin activate hello

从API导入所有目标SIT（旅游信息系统）记录（目前最多10000个）

WP_SITE_KEY=mywebsite wp woody:hawwwai warm_cache
WP_SITE_KEY=mywebsite wp woody:process async_start

从目标中删除所有SIT记录

WP_SITE_KEY=mywebsite wp woody:hawwwai delete_cache

重新生成所有SIT记录的规范

WP_SITE_KEY=mywebsite wp woody:hawwwai update_canonicals
WP_SITE_KEY=mywebsite wp woody:hawwwai rsdu

更新核心翻译

WP_SITE_KEY={{sitekey}} wp language core update

更新插件翻译（例如fr_FR）

WP_SITE_KEY={{sitekey}} wp language plugin update --all fr_FR

或

WP_SITE_KEY={{sitekey}} wp language plugin update {{plugin-name}} fr_FR

♻️ 推荐的VSCode扩展

• Git Graph
• Git Blame
• BABA-Git Flow
• EditorConfig for VS Code
• Beautify
• PHP-CS-Fixer
• PHP 扩展包
• Sass
• TODO Highlighter
• Todo Tree
• 尾随空格
• Twig
• TWIG包
• 括号配对着色器
• Composer
• ACF片段
• 更改字符串大小写
• Dash
• 项目管理器
• Wordpress片段

安装php-cs-fixer并配置VSCode扩展以在“OnSave”模式下启动

wget https://cs.symfony.com/download/php-cs-fixer-v3.phar -O php-cs-fixer
sudo chmod a+x php-cs-fixer
sudo mv php-cs-fixer /usr/local/bin/php-cs-fixer

🤘 贡献者

感谢所有为Woody Core做出贡献的人！

对于未来的贡献者，请阅读我们的贡献者行为准则

封面照片由John Lee在Unsplash拍摄

🔖 许可证

Woody Core是开源软件，遵循GPL2许可证。

👑 赞助

Woody是一个由布列塔尼地区旅游委员会和eBreizh Connexion共同资助的数字生态系统。