woocommerce/plugins/woocommerce-admin/README.md

# WooCommerce Admin

This is a feature plugin for a modern, javascript-driven WooCommerce Admin experience.

## Prerequisites

[Gutenberg](https://wordpress.org/plugins/gutenberg/) and [WooCommerce](https://wordpress.org/plugins/woocommerce/) should be installed prior to activating the WooCommerce Admin feature plugin. You also need v3 of the WooCommerce REST API via [wc-api-dev](https://github.com/woocommerce/wc-api-dev/) or [the feature branch](https://github.com/woocommerce/woocommerce/tree/feature/rest-api-v3).

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 with `npm install`. Now you can build the files using one of these commands:

 - `npm run build` : Build a production version
 - `npm start` : Build a development version, watch files for changes

There are also some helper scripts:

 - `npm run lint` : Run eslint over the javascript files
 - `npm run i18n` : Create a PHP file with the strings from the javascript files, [used to get around lack of JS support in WordPress.org](https://github.com/WordPress/packages/tree/master/packages/i18n#build).
Update woo-dash naming to new wc-admin name (https://github.com/woocommerce/woocommerce-admin/pull/183) 2018-07-10 12:48:06 +00:00			`# WooCommerce Admin`
Add an admin page, build a simple component + filters 2018-04-17 23:51:48 +00:00
Update woo-dash naming to new wc-admin name (https://github.com/woocommerce/woocommerce-admin/pull/183) 2018-07-10 12:48:06 +00:00			`This is a feature plugin for a modern, javascript-driven WooCommerce Admin experience.`
Add an admin page, build a simple component + filters 2018-04-17 23:51:48 +00:00
Add Gutenberg & WooCommerce prereq to the README (https://github.com/woocommerce/woocommerce-admin/pull/1) * Add Gutenberg prereq to the README I installed `woo-dash` without Gutenberg installed and ended up getting a fatal error. We should probably fix that as well/handle that better, but if we are going to rely on Gutenberg for the feature plugin we should mention it in the README. * Add mention of WooCommerce as a prereq 2018-05-02 18:28:59 +00:00			`## Prerequisites`

Update woo-dash naming to new wc-admin name (https://github.com/woocommerce/woocommerce-admin/pull/183) 2018-07-10 12:48:06 +00:00			`[Gutenberg](https://wordpress.org/plugins/gutenberg/) and [WooCommerce](https://wordpress.org/plugins/woocommerce/) should be installed prior to activating the WooCommerce Admin feature plugin. You also need v3 of the WooCommerce REST API via [wc-api-dev](https://github.com/woocommerce/wc-api-dev/) or [the feature branch](https://github.com/woocommerce/woocommerce/tree/feature/rest-api-v3).`
Add Gutenberg & WooCommerce prereq to the README (https://github.com/woocommerce/woocommerce-admin/pull/1) * Add Gutenberg prereq to the README I installed `woo-dash` without Gutenberg installed and ended up getting a fatal error. We should probably fix that as well/handle that better, but if we are going to rely on Gutenberg for the feature plugin we should mention it in the README. * Add mention of WooCommerce as a prereq 2018-05-02 18:28:59 +00:00
Fix React warnings for nested components/className (https://github.com/woocommerce/woocommerce-admin/pull/83) * Fix class/className warning * Fix nested `a` warning * Add note about SCRIPT_DEBUG 2018-05-23 18:01:41 +00:00			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.

Add an admin page, build a simple component + filters 2018-04-17 23:51:48 +00:00			`## Development`

			After cloning the repo, install dependencies with `npm install`. Now you can build the files using one of these commands:

			- `npm run build` : Build a production version
Build Tools: Add precommit/prepush scripts, install if outdated (https://github.com/woocommerce/woocommerce-admin/pull/34) * Add helper scripts from calypso * Add the pre-push hook to protect master * Add required packages * Update README * Remove unused package 2018-05-10 19:17:28 +00:00			- `npm start` : Build a development version, watch files for changes
Add an admin page, build a simple component + filters 2018-04-17 23:51:48 +00:00
			`There are also some helper scripts:`

			- `npm run lint` : Run eslint over the javascript files
			- `npm run i18n` : Create a PHP file with the strings from the javascript files, [used to get around lack of JS support in WordPress.org](https://github.com/WordPress/packages/tree/master/packages/i18n#build).