My Cart 0

User Manual - Order Comments

 

 

Installing Magento 2 Order Comments extension

Command Line Installation

  1. Backup your web directory and store database
  2. Download the Order Comments installation package
  3. Upload contents of the Order Comments installation package to your store root directory
  4. In SSH console of your server navigate to your store root folder:
cd path_to_the_store_root_folder

run the following command: :

php bin/magento module:enable Aheadworks_OrderCommentTemplates

then:

php bin/magento setup:upgrade

after:

php bin/magento setup:static-content:deploy -f

    5. Flush store cache; log out from the backend and log in again

Make sure the installation is done from the FTP administrator account. Otherwise, set 775 permissions to the store root directory after the extension is deployed.

Composer Installation

If you are installing an extension from Aheadworks for the first time, you need to add our composer repository to your Magento store:

     1. Login to your ssh console and navigate to your store folder:

cd path_to_the_store_root_folder

Run the following command:

composer config repositories.aheadworks composer https://dist.aheadworks.com/

After the command was executed successfully, you can use the composer to install the extension.

To install the extension:

     2. Login to your ssh console and navigate to your store folder:

cd path_to_the_store_root_folder

     3. Run the following command to install the latest version of the extension:

composer require aheadworks/module-order-comment-templates

if you need to install a specific version, run this command:

composer require aheadworks/module-order-comment-templates:<version>

 

Specify the version of the extension in <version>

When prompted, enter Public Key (Username) and Private Key (Password):

Public Key (Username) and Private Key (Password) | Gift Cart for Magento 2

Both Public Key (Username) and Private Key (Password) can be found in My Projects and Licenses in your personal account on our site:

 To upgrade the extension: 

To update or upgrade an extension:

Download the updated extension file. Take note of the module-name and version. Export the contents to your Magento root.

If a composer package exists for the extension, run one of the following.

Update per module name:

composer update aheadworks/module-order-comment-templates

Updater per version:

composer require aheadworks/module-order-comment-templates:<version>

Run the following commands to upgrade, deploy, and clean the cache.

php bin/magento setup:upgrade --keep-generated
php bin/magento setup:static-content:deploy
php bin/magento cache:clean

 

Set up cron

If you have already configured cron jobs for your Magento installation then you can skip this step. Read the following instructions on setting cron job for your Magento store: Magento user guide.

Generally, it would be enough to run in SSH console of your server: 

crontab -e

And insert the following line:  

*/3 * * * * php -c <ini-file-path> <your Magento install dir>/bin/magento cron:run
*/3 * * * * php -c <ini-file-path> <your Magento install dir>/update/cron.php
*/3 * * * * php -c <ini-file-path> <your Magento install dir>/bin/magento setup:cron:run

Remember to confirm the Save request when exiting the installation.

 

 

Uninstalling Magento 2 Order Comments extension

Since Magento introduced declarative Database you need to be very carefull when uninstalling or disabling the module.

NOTE: Please be very careful when uninstalling/disabling this module. This module uses a declarative DB scheme. Once the module is uninstalled the DB tables will be lost.

Manual Removal

1. Disable the module by executing the following commands:

php bin/magento module:disable Aheadworks_OrderCommentTemplates
php bin/magento setup:upgrade

2. Remove the extension files from the following folder:

app/code/Aheadworks/OrderCommentTemplates

Automatic Removal (via Composer)

1. Disable the module by executing the following commands:

php bin/magento module:uninstall Aheadworks_OrderCommentTemplates

 

Extension Compatibility

Module Version Magento Version
As of version 1.0.0 2.4.6 - 2.4.8

The PHP version depends on your current Magento version. Please, refer to your Magento version release notes.

 

 

Introducing Magento 2 Order Comments

Extension Overview

The Magento 2 Order Comments extension streamlines customer notification by enabling quick, consistent, and trackable sales comments. Instead of typing messages manually for every order, invoice, shipment, or credit memo, admins can create reusable templates that are automatically filtered by store view and sales entity type. This ensures that only relevant comments appear, reducing human mistakes and speeding up workflows.

Key Features

  • Unlimited comment templates creation 
  • Store-view and  sales entities template filtering to show only relevant comment templates
  • Quick insertion of pre-build comments directly from the Sales Order page
  • Manual editing of comments for personalization

 

Using Magento 2 Order Comments extension

Extension Configuration

To enable the extension, go to Stores > Configuration > AHEADWORKS EXTENSIONS > Order Comments.

In the General Settings section set the Is Active option to Yes

General Settings | Order Comments for Magento 2

 

 

Creating Order Comment Templates

 

To create the Comment Template go to Sales > Order Comments by Aheadworks > Templates, and click the Create New Template button

Create New Template Button | Order Comments for Magento 2

On the New Template page set the following options:

  • Template Title – the internal name of the template. It will be displayed in the templates table and in the dropdown menu when selecting a comment template on the order page.
  • Shown in Stores – select the store view(s) where the template should be available. This ensures that only relevant templates appear for a specific store view.
  • Available on Types – select the sales entity types for which this template should be available (Order, Invoice, Shipment, Credit Memo). This prevents irrelevant templates from appearing in unrelated contexts.
  • Sort Order – define the position of the template in the dropdown list when selecting a comment template.
  • Comment – enter the comment text that will be inserted when the template is applied on the sales order (shipment, invoice, etc) page.

Create New Template Page | Order Comments for Magento 2

 

Once completed, click the Save button

 

 

Using Order Comment Templates

To use the order comment template go to Sales > Orders and open the required order (or invoice, shipment, etc.).

On the opened page, scroll down to the Order Total section. 

In the Comment Template dropdown, select the desired template. 

Comment Templates Dropdown | Order Comments for Magento 2

 

The selected template will automatically insert the pre-build comment in the Comment Text field. You may also manually edit this text if any personalization is required.

Comment Text Field | Order Comments for Magento 2

 

Editing Order Comment Templates

 

To edit an existing order comment template, go to Sales > Order Comments by Aheadworks > Templates. In the Order comment templates table, click Edit text-link next to the required template.

Edit text-link | Order Comments for Magento 2

On the Edit template page, update the necessary fields and click Save.

Edit the Order Comment | Order Comments for Magento 2

 

Report incorrect information

Still Have Questions?

Our customer care team is here for you!

Contact Us