Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/greenpeace/planet4-gpch-plugin-blocks/archive/refs/heads/master.zipOn Packagist as greenpeace/planet4-gpch-plugin-blocks:
composer require greenpeace/planet4-gpch-plugin-blocksContent Blocks, specific to the GPCH installation of Planet4.
Install
Install dependencies:
npm install --save-dev
composer install --ignore-platform-reqs
Coding Standards
Any new code added is required to implement Wordpress coding standards
Javascript: Use JSHint
Set JSHint to use .jshintrc provided in this repository.
Example for PHPStorm:
- Settings -> Languages & Frameworks -> Javascript -> Code Quality Tools -> JSHint
- ☑ Enable
- ☑ Use config files
- Location: ☑ Default
Build
Make sure your files are formatted correctly:
npm run format
Make sure your files pass ESLint with the provided config:
npm run lint:js
Build files for production:
npm run build
Build styles:
sass assets/css/source/style.scss assets/css/style.css --style=compressed
Autoloader
To generate autoload files, run
composer dump-autoload
Translations
- Generate .pot files: Use wp-cli or PoEdit. PoEdit is the preferred option as it reads strings from all files including Twig templates.
- Create the .po and .mo files for each language using Poedit
- Transform the po files into additional JSON for use with Javascript.
Example: wp i18n make-json planet4-gpch-plugin-blocks-de_CH.po --no-purge
Then rename the files to use the handle instead of the auto generated md5 string in the filename.