842e9e4d6f
* Only build pushes to master branch. * Fix branch detection in CI. * Remove string interpolation from Travis branch name check. |
||
|---|---|---|
| .. | ||
| .github | ||
| bin | ||
| client | ||
| config | ||
| docs | ||
| images | ||
| includes | ||
| languages | ||
| packages | ||
| src | ||
| tests | ||
| .browserslistrc | ||
| .distignore | ||
| .editorconfig | ||
| .eslintignore | ||
| .eslintrc | ||
| .gitignore | ||
| .nvmrc | ||
| .stylelintrc.json | ||
| .travis.yml | ||
| CONTRIBUTING.md | ||
| Gruntfile.js | ||
| LICENSE.md | ||
| README.md | ||
| babel.config.js | ||
| composer.json | ||
| composer.lock | ||
| lerna.json | ||
| license.txt | ||
| package-lock.json | ||
| package.json | ||
| phpcs.xml.dist | ||
| phpunit.xml.dist | ||
| postcss.config.js | ||
| readme.txt | ||
| renovate.json | ||
| uninstall.php | ||
| webpack.config.js | ||
| woocommerce-admin.php | ||
README.md
WooCommerce Admin
This is a feature plugin for a modern, javascript-driven WooCommerce Admin experience.
⚠️ This project is in active development, and is not ready for general use. You can follow the features in development by looking at the project's issues. We do not recommend running this on production sites.
Prerequisites
WordPress 5.2 or greater and WooCommerce 3.6.0 or greater should be installed prior to activating the WooCommerce Admin feature plugin.
For better debugging, it's also recommended you add define( 'SCRIPT_DEBUG', true ); to your wp-config. This will load the unminified version of all libraries, and specifically the development build of React.
Development
After cloning the repo, install dependencies:
npm installto install JavaScript dependencies.composer installto gather PHP dependencies.
Now you can build the files using one of these commands:
npm run build: Build a production versionnpm run dev: Build a development versionnpm start: Build a development version, watch files for changesnpm run build:release: Build a WordPress plugin ZIP file (woocommerce-admin.zipwill be created in the repository root)
There are also some helper scripts:
npm run lint: Run eslint over the javascript filesnpm run i18n: A multi-step process, used to create a pot file from both the JS and PHP gettext calls. First it runsi18n:js, which creates a temporary.potfile from the JS files. Next it runsi18n:php, which converts that.potfile to a PHP file. Lastly, it runsi18n:pot, which creates the final.potfile from all the PHP files in the plugin (including the generated one with the JS strings).npm test: Run the JS test suite
To debug synced lookup information in the database, you can bypass the action scheduler and immediately sync order and customer information by using the woocommerce_disable_order_scheduling hook.
add_filter( 'woocommerce_disable_order_scheduling', '__return_true' );
Privacy
If you have enabled WooCommerce usage tracking ( option woocommerce_allow_tracking ) then, in addition to the tracking described in https://woocommerce.com/usage-tracking/, this plugin also sends information about the actions that site administrators perform to Automattic - see https://automattic.com/privacy/#information-we-collect-automatically for more information.
Contributing
There are many ways to contribute – reporting bugs, adding translations, feature suggestions and fixing bugs. For full details, please see CONTRIBUTING.md