Skip to content

Updated weee module readme file #31415

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
113 changes: 93 additions & 20 deletions app/code/Magento/Weee/README.md
Original file line number Diff line number Diff line change
@@ -1,26 +1,99 @@
# Overview
The Magento_Weee module enables the application of fees/fixed product taxes (FPT) on certain types of products, usually related to electronic devices and recycling.
Fixed product taxes can be used to setup a WEEE tax that is a fixed amount, rather than a percentage of the product price. FPT can be configured to be displayed at various places in Magento. Rules, amounts, and display options can be configured in the backend. This module extends the existing functionality of Magento_Tax.
# Magento_Weee module

The Magento_Weee module includes the following:
The **Magento_Weee** module enables the application of fees/fixed product taxes (FPT) on certain types of products, usually related to electronic devices and recycling.

* ability to add different number of fixed product taxes to product. They are treated as a product attribute;
* configuration of where WEEE appears (on category, product, sales, invoice, or credit memo pages) and whether FPT should be taxed;
* a new line item in the totals section.
Fixed product taxes can be used to setup a WEEE tax that is a fixed amount, rather than a percentage of the product price. FPT can be configured to be displayed at various places in Magento. Rules, amounts, and display options can be configured in the backend.

# System requirements
The Magento_Weee module does not have any specific system requirements.
This module extends the existing functionality of **Magento_Tax**.

## Install
Magento_Weee module can be installed automatically (using native Magento install mechanism) without any additional actions
The **Magento_Weee** module includes the following:

## Uninstall
Magento installation with existing products with FPT:
* Disable FPT on the backend
* Remove all products with FPT
* Remove all FPT attributes from attribute sets
* Delete all FPT attributes
* Remove module directory from the code base
- Ability to add different number of fixed product taxes to product. They are treated as a product attribute.
- Configuration of where WEEE appears (on category, product, sales, invoice, or credit memo pages) and whether FPT should be taxed.
- A new line item in the totals section.

New Magento installation:
* Can be removed without additional actions
## Installation details

The **Magento_Weee** module can be installed automatically (using native Magento install mechanism) without any additional actions.

Before installing this module, note that the **Magento_Weee** is dependent on the following modules:

- Magento_Catalog
- Magento_Checkout
- Magento_Customer
- Magento_Quote
- Magento_Sales
- Magento_Store
- Magento_Tax

Please find here [how to enable or disable modules in Magento 2](https://devdocs.magento.com/guides/v2.4/install-gde/install/cli/install-cli-subcommands-enable.html).

## Structure

`Pricing/` - directory that contain tax adjustment.

For information about a typical file structure of a module in Magento 2, see [Module file structure](http://devdocs.magento.com/guides/v2.4/extension-dev-guide/build/module-file-structure.html#module-file-structure).

## Extensibility

Extension developers can interact with the **Magento_Weee** module. For more information about the Magento extension mechanism, see [Magento plug-ins](http://devdocs.magento.com/guides/v2.4/extension-dev-guide/plugins.html).

[The Magento dependency injection mechanism](http://devdocs.magento.com/guides/v2.4/extension-dev-guide/depend-inj.html) enables you to override the functionality of the **Magento_Weee** module.

### Layouts

This module introduces the following layouts and layout handles in the directories:

- `view/adminhtml/layout`:
- `catalog_product_form`
- `sales_creditmemo_item_price`
- `sales_invoice_item_price`
- `sales_order_create_item_price`
- `sales_order_creditmemo_new`
- `sales_order_creditmemo_updateqty`
- `sales_order_creditmemo_view`
- `sales_order_invoice_new`
- `sales_order_invoice_updateqty`
- `sales_order_invoice_view`
- `sales_order_item_price`
- `sales_order_view`

- `view/base/layout`:
- `catalog_product_prices`

- `view/frantend/layout`:
- `checkout_cart_index`
- `checkout_index_index`
- `checkout_item_price_renderers`
- `default`
- `sales_email_item_price`
- `sales_email_order_creditmemo_items`
- `sales_email_order_invoice_items`
- `sales_email_order_items`
- `sales_guest_creditmemo`
- `sales_guest_invoice`
- `sales_guest_print`
- `sales_guest_printcreditmemo`
- `sales_guest_printinvoice`
- `sales_guest_view`
- `sales_order_creditmemo`
- `sales_order_invoice`
- `sales_order_item_price`
- `sales_order_print`
- `sales_order_printcreditmemo`
- `sales_order_printinvoice`
- `sales_order_view`

For more information about a layout in Magento 2, see the [Layout documentation](http://devdocs.magento.com/guides/v2.4/frontend-dev-guide/layouts/layout-overview.html).

### UI components

You can extend a customer form and widgets using the configuration files located in the directories

- `view/adminhtml/ui_component`:
- `product_attribute_add_form`
- `view/frontend/ui_component`:
- `widget_recently_compared`
- `widget_recently_viewed`

For information about a UI component in Magento 2, see [Overview of UI components](http://devdocs.magento.com/guides/v2.4/ui_comp_guide/bk-ui_comps.html).