Steve-Dee-Designs
/
woocommerce
mirror of https://github.com/woocommerce/woocommerce.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
woocommerce/plugins/woocommerce-admin/docs/features/feature-flags.md

50 lines
2.7 KiB
Markdown
Raw Normal View History

Add Feature Flags (https://github.com/woocommerce/woocommerce-admin/pull/1500) * First pass at adding feature flags. Accessible over PHP and JS. * Hook up dev config to test enviornments, hook up features to their flags. * Cleanup some code and add documentation. Remove beta config. * Handle PR Feedback: Add devdocs flag, remove categories flag, fix auto-generated PHP warning. * Add todo for beta phase. * Handle PR feedback: Simplify is_array check, update build command, simplify test mock, remove empty webpack line.
2019-02-12 20:02:02 +00:00
# Feature Flags
Remove "plugin" environment from admin feature plugin
2022-04-14 08:40:35 +00:00
Features inside the `woocommerce` repository can be in various states of completeness. To provide a way for improved control over how these features are released in these different environments, `woocommerce` has a system for feature flags.
Add Feature Flags (https://github.com/woocommerce/woocommerce-admin/pull/1500) * First pass at adding feature flags. Accessible over PHP and JS. * Hook up dev config to test enviornments, hook up features to their flags. * Cleanup some code and add documentation. Remove beta config. * Handle PR Feedback: Add devdocs flag, remove categories flag, fix auto-generated PHP warning. * Add todo for beta phase. * Handle PR feedback: Simplify is_array check, update build command, simplify test mock, remove empty webpack line.
2019-02-12 20:02:02 +00:00
We currently support the following environments:
| Environment | Description |
|-------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
Remove "plugin" environment from admin feature plugin
2022-04-14 08:40:35 +00:00
| development | Development - All features should be enabled in development. These flags are also used in both JS and PHP tests. Ran using `pnpm start`. | |
Update feature-flags.md
2022-04-14 09:15:12 +00:00
| core | Core - assets/files ready and stable enough. Ran using `pnpm build` & `pnpm pack`.
Add Feature Flags (https://github.com/woocommerce/woocommerce-admin/pull/1500) * First pass at adding feature flags. Accessible over PHP and JS. * Hook up dev config to test enviornments, hook up features to their flags. * Cleanup some code and add documentation. Remove beta config. * Handle PR Feedback: Add devdocs flag, remove categories flag, fix auto-generated PHP warning. * Add todo for beta phase. * Handle PR feedback: Simplify is_array check, update build command, simplify test mock, remove empty webpack line.
2019-02-12 20:02:02 +00:00
## Adding a new flag
Flags can be added to the files located in the `config/` directory. Make sure to add a flag for each environment and explicitly set the flag to false.
Please add new feature flags alphabetically so they are easy to find.
## Basic Use - Client
The `window.wcAdminFeatures` constant is a global variable containing the feature flags.
Instances of `window.wcAdminFeatures` are replaced during the webpack build process by using webpack's [define plugin](https://webpack.js.org/plugins/define-plugin/). Using `webpack` for this allows us to eliminate dead code when making minified/production builds (`plugin`, or `core` environments).
To check if a feature is enabled, you can simplify check the boolean value of a feature:
```
{ window.wcAdminFeatures[ 'activity-panels' ] && <ActivityPanel /> }
```
WC_Admin_Loader/PHP Refactor + Method to publish core ready features (https://github.com/woocommerce/woocommerce-admin/pull/1863) * Try: Setup plugin to publish core library on npm * Documentation clean up. * Handle PR Feedback: Fix notices from happening in WC Core from API usage, fix sidebar dashboard ordering in menu, remove preload function check since we are supporting WP 5+, add a filter for preloading data and move usage to respective feature code, move features to a specific folder for bundiling, fix script translations. * Fix code comment on analytics preload * Continue refactoring code, and make it possible to launch 'embedded' features via the process as well. * Fix note hook * Fix note load order * Address PR feedback: Fix class name, load leaderboard endpoint * Remove example code prior to merge
2019-04-11 18:31:31 +00:00
We also expose CSS classes on the `body` tag, so that you can target specific feature states when they are enabled:
Add Feature Flags (https://github.com/woocommerce/woocommerce-admin/pull/1500) * First pass at adding feature flags. Accessible over PHP and JS. * Hook up dev config to test enviornments, hook up features to their flags. * Cleanup some code and add documentation. Remove beta config. * Handle PR Feedback: Add devdocs flag, remove categories flag, fix auto-generated PHP warning. * Add todo for beta phase. * Handle PR feedback: Simplify is_array check, update build command, simplify test mock, remove empty webpack line.
2019-02-12 20:02:02 +00:00
```
WC_Admin_Loader/PHP Refactor + Method to publish core ready features (https://github.com/woocommerce/woocommerce-admin/pull/1863) * Try: Setup plugin to publish core library on npm * Documentation clean up. * Handle PR Feedback: Fix notices from happening in WC Core from API usage, fix sidebar dashboard ordering in menu, remove preload function check since we are supporting WP 5+, add a filter for preloading data and move usage to respective feature code, move features to a specific folder for bundiling, fix script translations. * Fix code comment on analytics preload * Continue refactoring code, and make it possible to launch 'embedded' features via the process as well. * Fix note hook * Fix note load order * Address PR feedback: Fix class name, load leaderboard endpoint * Remove example code prior to merge
2019-04-11 18:31:31 +00:00
<body class="wp-admin woocommerce-page woocommerce-feature-enabled-activity-panels ....">
Add Feature Flags (https://github.com/woocommerce/woocommerce-admin/pull/1500) * First pass at adding feature flags. Accessible over PHP and JS. * Hook up dev config to test enviornments, hook up features to their flags. * Cleanup some code and add documentation. Remove beta config. * Handle PR Feedback: Add devdocs flag, remove categories flag, fix auto-generated PHP warning. * Add todo for beta phase. * Handle PR feedback: Simplify is_array check, update build command, simplify test mock, remove empty webpack line.
2019-02-12 20:02:02 +00:00
```
## Basic Use - Server
Switch to pnpm (https://github.com/woocommerce/woocommerce-admin/pull/8349) * Add pnpm-workspace.yaml * Add missing dependencies & replace file: with workspace:* in package.json * Replace "npm" with "pnpm" * Replace "npx" with "pnpx" * Remove package-lock.json * Add pnpm setup action to github workflows * Update webpack babel exclude path * Upgrade woo e2e and fix e2e test command Update e2e.yml Use pnpm run e2e:docker-up in e2e.yml * Remove unused docker-compose.yaml * Replace lerna with pnpm commands Update publish commands * Exclude _locutus_shared_bc.js in babel.config.js * Add .npmrc to set enable-pre-post-scripts=true by default * Fix storybook babel config Update babel.config.js * Add changelog * Update pnpm-lock.yaml * Replace pnpx with pnpm exec * Update pnpm-lock.yaml * Remove js-tests/package-lock.json * Fix @woocommerce/tracks -> workspace:* * Update pnpm-lock.yaml * Add @woocommerce/experimental to onboarding/package.json * Add "@woocommerce/component" to onboarding/package.json * Update pnpm-lock.yaml * Use || instead of && for "test:watch" Co-authored-by: RJ <27843274+rjchow@users.noreply.github.com> * Fix packages/number "clean" command * Add root: true to .eslintrc.js to enforce it to use the root config file * Exclude packages/**/node_modules from babel transpiling * Fix js-tests build config Co-authored-by: RJ <27843274+rjchow@users.noreply.github.com>
2022-03-04 04:01:16 +00:00
Feature flags are also available via PHP. To ensure these are consistent with the built client assets, `includes/feature-config.php` is generated by the plugin build process or `pnpm start`. Do not edit `includes/feature-config.php` directly.
Add Feature Flags (https://github.com/woocommerce/woocommerce-admin/pull/1500) * First pass at adding feature flags. Accessible over PHP and JS. * Hook up dev config to test enviornments, hook up features to their flags. * Cleanup some code and add documentation. Remove beta config. * Handle PR Feedback: Add devdocs flag, remove categories flag, fix auto-generated PHP warning. * Add todo for beta phase. * Handle PR feedback: Simplify is_array check, update build command, simplify test mock, remove empty webpack line.
2019-02-12 20:02:02 +00:00
Fix use of feature checks and remove deprecated method calls (https://github.com/woocommerce/woocommerce-admin/pull/6687) * Update all references to of Loader::is_feature_enabled to use Feature class * Check if feature is enabled instead of existence in deprecated feature method * Add changelog entry
2021-03-26 17:00:05 +00:00
To check if a feature is enabled, you can use the `Automattic\WooCommerce\Admin\Features\Features::is_enabled()`:
Add Feature Flags (https://github.com/woocommerce/woocommerce-admin/pull/1500) * First pass at adding feature flags. Accessible over PHP and JS. * Hook up dev config to test enviornments, hook up features to their flags. * Cleanup some code and add documentation. Remove beta config. * Handle PR Feedback: Add devdocs flag, remove categories flag, fix auto-generated PHP warning. * Add todo for beta phase. * Handle PR feedback: Simplify is_array check, update build command, simplify test mock, remove empty webpack line.
2019-02-12 20:02:02 +00:00
```
Fix use of feature checks and remove deprecated method calls (https://github.com/woocommerce/woocommerce-admin/pull/6687) * Update all references to of Loader::is_feature_enabled to use Feature class * Check if feature is enabled instead of existence in deprecated feature method * Add changelog entry
2021-03-26 17:00:05 +00:00
if ( \Automattic\WooCommerce\Admin\Features\Features::is_enabled( 'activity-panels' ) ) {
Add Feature Flags (https://github.com/woocommerce/woocommerce-admin/pull/1500) * First pass at adding feature flags. Accessible over PHP and JS. * Hook up dev config to test enviornments, hook up features to their flags. * Cleanup some code and add documentation. Remove beta config. * Handle PR Feedback: Add devdocs flag, remove categories flag, fix auto-generated PHP warning. * Add todo for beta phase. * Handle PR feedback: Simplify is_array check, update build command, simplify test mock, remove empty webpack line.
2019-02-12 20:02:02 +00:00
add_action( 'admin_header', 'wc_admin_activity_panel' );
}
WC_Admin_Loader/PHP Refactor + Method to publish core ready features (https://github.com/woocommerce/woocommerce-admin/pull/1863) * Try: Setup plugin to publish core library on npm * Documentation clean up. * Handle PR Feedback: Fix notices from happening in WC Core from API usage, fix sidebar dashboard ordering in menu, remove preload function check since we are supporting WP 5+, add a filter for preloading data and move usage to respective feature code, move features to a specific folder for bundiling, fix script translations. * Fix code comment on analytics preload * Continue refactoring code, and make it possible to launch 'embedded' features via the process as well. * Fix note hook * Fix note load order * Address PR feedback: Fix class name, load leaderboard endpoint * Remove example code prior to merge
2019-04-11 18:31:31 +00:00
```
Components: fix README url
2019-04-28 20:13:52 +00:00
If you name a directory after the flag in `includes/` with a `class-wc-admin-FEATURE.php` file, this code will also automatically be loaded.