Server : Apache System : Linux server2.corals.io 4.18.0-348.2.1.el8_5.x86_64 #1 SMP Mon Nov 15 09:17:08 EST 2021 x86_64 User : corals ( 1002) PHP Version : 7.4.33 Disable Function : exec,passthru,shell_exec,system Directory :  /home/corals/cartforge.co/vendor/magento/module-gift-message/

Upload File : current_dir [ Writeable ] document_root [ Writeable ]

# Magento_GiftMessage module

This module allows to add a message to order or to each ordered item either on frontend or backend.

## Installation

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

- `Magento_Catalog`
- `Magento_Sales`
- `Magento_Quote`

Before disabling or uninstalling this module, note that the Magento_GiftMessageGraphQl module depends on this module

The Magento_GiftMessage module creates the `gift_message` table in the database.

This module modifies the following tables in the database:

- `quote` - adds column `gift_message_id`
- `quote_address` - adds column `gift_message_id`
- `quote_item` - adds column `gift_message_id`
- `quote_address_item` - adds column `gift_message_id`
- `sales_order` - adds column `gift_message_id`
- `sales_order_item` - adds columns `gift_message_id` and `gift_message_available`

For information about a module installation in Magento 2, see [Enable or disable modules](https://devdocs.magento.com/guides/v2.4/install-gde/install/cli/install-cli-subcommands-enable.html).

## Extensibility

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

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

A lot of functionality in the module is on JavaScript, use [mixins](https://devdocs.magento.com/guides/v2.4/javascript-dev-guide/javascript/js_mixins.html) to extend it.

### Events

The module dispatches the following events:
- `gift_options_prepare_items` event in the `\Magento\GiftMessage\Block\Message\Inline::getItems` method. Parameters:
    - `items` is a entityItems (`array` type)

- `gift_options_prepare` event in the `\Magento\GiftMessage\Block\Message\Inline::isMessagesOrderAvailable` method. Parameters:
    - `entity` is an entity object

For information about an event in Magento 2, see [Events and observers](http://devdocs.magento.com/guides/v2.4/extension-dev-guide/events-and-observers.html#events).

### Layout

This module introduces the following layouts in the `view/frontend/layout` and `view/adminhtml/layout` directories:
- `view/adminhtml/layout`:
    - `sales_order_create_index`
    - `sales_order_create_load_block_data`
    - `sales_order_create_load_block_items`
    - `sales_order_view`
- `view/frontend/layout`:
    - `checkout_cart_index`
    - `checkout_cart_item_renderers`

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

### Public APIs

#### Data

- `Magento\GiftMessage\Api\Data\MessageInterface`
    - gift message data

#### Cart

- `\Magento\GiftMessage\Api\CartRepositoryInterface`
    - get the gift message by cart ID for specified shopping cart
    - set the gift message for an entire shopping cart
    
- `\Magento\GiftMessage\Api\GuestCartRepositoryInterface`
    - get the gift message by cart ID for specified shopping cart
    - set the gift message for an entire shopping cart
    
#### Cart Item

- `\Magento\GiftMessage\Api\GuestItemRepositoryInterface`
    - get the gift message for a specified item in a specified shopping cart
    - set the gift message for a specified item in a specified shopping cart

- `\Magento\GiftMessage\Api\ItemRepositoryInterface`
    - get the gift message for a specified item in a specified shopping cart
    - set the gift message for a specified item in a specified shopping cart
    
#### Order

- `\Magento\GiftMessage\Api\OrderItemRepositoryInterface`
    - get the gift message for a specified order
    - set the gift message for an entire order

#### Order Item

- `\Magento\GiftMessage\Api\OrderItemRepositoryInterface`
    - get the gift message for a specified item in a specified order
    - set the gift message for a specified item in a specified order
    
For information about a public API in Magento 2, see [Public interfaces & APIs](http://devdocs.magento.com/guides/v2.4/extension-dev-guide/api-concepts.html).

## Additional information

[Learn more about Gift Options and Gift Message](https://docs.magento.com/user-guide/sales/gift-options.html).