...

...

...

Image Modified

Magento 2 Customer Attributes extends the list of built-in Magento customer attributes and customer address attributes, and further facilitates their meaningful utilization via various options for display as well as for integration with Aheadworks and native Magento modules. Alongside adding new attributes merchants are able to manage the existing ones to fully respond to their business needs.

Compatibility:

...

Magento Open Source 2.2.9 - 2.3.X

Product Page

Thank you for choosing Aheadworks!

Installing Customer Attributes

...

...

 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 -f bin/magento module:enable Aheadworks_CustomerAttributes

then:

php -f bin/magento setup:upgrade

after:

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

...

...

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

...

To install the extension:

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

...

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

composer require aheadworks/module-customer-attributes

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

composer require aheadworks/module-customer-attributes:<version>

...

4. Enable the extension:

php -f bin/magento module:enable <Module_Name>

Next, register the extension:

bin/magento setup:upgrade

Recompile your Magento store if you are in the Production mode:

bin/magento setup:di:compile

To verify that the extension is enabled, run this command:

bin/magento module:status

Clean store cache, by running the following command:

bin/magento cache:clean

Log out and Log in the backend again.

...

To upgrade the extension:

5. 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.

composer update aheadworks/module-customer-attributes

composer require aheadworks/module-customer-attributes:<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

Getting Around

M2 Customer Attributes Use

...

The extension does not have any particular settings for operation but for the configuration of customer attributes themselves. The frontend use of the created/edited attributes does not differ from utilization of any other common types of input fields, which are universally known. Therefore, the present manual focuses on the backend use of customer attributes and customer address attributes, with occasional examples of display on the storefront when need be.  

Customizing Attributes

Customer Attributes Grid

To get access to all customer attributes in the store please proceed to Customers > Customer Attributes. The page shows a grid of the following columns:

• ID - the identification number of the attribute;
• Attribute Code - the alphanumeric code of the attribute;
• Default Label - the descriptive label of the attribute;
• Input Type - the type of the input;
• Sort Order - the numeric value to sort the attribute against other attributes in the related form/view;
• Action - the dropdown box 'Select' with two options: Edit and Delete.

You can delete attributes individually with the help of the Select box or in bulk with the help of the Actions drop box field on the top left above the grid. Editing is only possible for each individual attribute.

Image Removed

Create / Edit Attributes

To create a new attribute click the Add New Attribute button on the top right of the page. The Edit Attribute page looks the same as the New Attribute page, but for the Attribute Code, Input Type and Values Required properties blocked.

The pages are split into four sections: Attribute Properties, Storefront Properties, Manage Labels and Manage Relations.

Configuring attribute properties

The Attribute Properties section contains essential parameters for customization of an attribute, mainly:

• Default Label - the descriptive label of the attribute;
• Attribute Code - the alphanumeric code of the attribute;
• Input Type - the type of the input value (Text field, text area, date, Yes/No, Multiple select, Dropdown, File, Image);
• Values Required - Yes/No alternatives (the attribute will be marked with an asterix (*) in the view);
• Add to Column Options in the Customers Grid - Yes/No alternatives;
• Use in Filter Options in the Customers Grid - Yes/No alternatives;
• Use in Search Options in the Customers Grid - Yes/No alternatives;
• Use in the Orders Grid - Yes/No alternatives;
• Show on the Order View Page -  Yes/No alternatives. 

Properties set-up depends on the business concept and application needs of each unique attribute, and therefore cannot be advised herein but for some sample use-cases.

Image Removed

Selecting an input type opens up extra properties for configuration of the attribute, for example:

• Text Area - Input Validation and Default Value;
• Text Field - Input Validation, Default Value and Input/Output filter;
• Date -  Input Validation and Default Value, Input/Output filter, Minimum Value, Maximum Value;
• Yes/No - Default Value;
• File Attachment - Maximum File Size and File Extensions;
• Image File - Maximum File Size, Maximum Image width and Maximum Image Hight.

Below is the description of the extra properties:

• Input Validation - validates the input value of the attribute against the following types: None, Alphanumeric, Alphanumeric With Spaces, Numeric Only, Alpha Only, URL, Email, Length Only;
• Input/Output filter - filters out html tags and html entities from the input value of the attribute against the following criteria: None, Strip HTML Tags, Escape HTML Entities;
• Default Value - the input value of the attribute by default as shown on the storefront;
• Minimum/Maximum text length - the numeric value correspondent to the required number of letters in the text;
• Minimum/Maximum Value - data values setting down the desired period for the attribute input;
• Maximum File Size - the maximum size of the file attribute in bytes;
• File Extensions - a list of common/custom file extensions separated with comma (,);
• Maximum Image Width/Height - the maximum values of the width/height of the image file attribute in pixels.  

Configuring storefront view properties

The Storefront Properties section contains three parameters for customization of the view of an attribute, mainly:

• Show on storefront - Yes/No alternative. 
• Sort Order - numeric value to set the placement of the attribute in the form/view with regard to other attributes on this form/view;
• Display on Forms - a list of forms to host the attribute: Customer Registration, Customer Account Edit and Admin Checkout.

Image Removed

You may be the only user of the newly-created/edited attributes, or you may let customers submit some more information about themselves too. In the former case, to create attributes for internal use ('secret' or 'hidden') select 'No' in Show on Storefront, otherwise opt for 'Yes'. This will make the attribute availalble on the storefront. 

Managing Labels / Options

The Manage Labels / Options section is divided into two parts: Options and Labels.

• Manage Labels prompts you to choose the store view and label the attribute. To add more views click the Add button below the correspondent field. To delete the entry click the bin icon next to the correspondent row.

• Manage Options suggests indicating further values for the attributes of the input types Dropdown, Multiple Select. This block will not be available should other input types be selected.

Image Removed

Managing Relations

The Manage Relations allows connecting the given attribute to the dependent ones, if any.

Image Removed

Make sure you have created dependent attributes first to see them in the Dependent Attribute field as alternatives for choice. The Option field shows the options for dropdown (Yes or No, in case of the Yes/No type) as indicated on the previous step.  

Customer Address Attributes Grid and Pages

To get access to all customer address attributes in the store please proceed to Customers > Customer Address Attributes. The reason behind the two groups of attributes available in the extension lies in the compliance with the native Mangento architecture of frontend forms and algorithms of collecting and storing relevant attributes which split the attributes this way. The Customer Attributes and Customer Address Attributes pages look the same. 

The Edit/New Address Attributes pages are similar to the described above pages for customer attributes with the only two differences:

• The properties Use in the Orders Grid and Show on the Order View Page for logical reasons are not available;
• The Display Forms property has two parameters for choice: Customer Address Registration and Customer Address Edit.

Image Removed

Attributes in Action

Display in the Customers and Orders Grid

Should due properties be set-up on New/Edit Attribute page the attributes will be available in the Customers and/or Orders grids. You will then be able to browse them in the grids and use as options for columns layout, filtering or search.

To get access to the information on all customers in the store please proceed to Customers > All Customers. In the example below you may see that the entries in the grid were filtered against the custom attribute Black Label, the values of which you may see/edit in the grid too.

Image Removed

Display on the Orders View Page

Should due properties be set-up on New/Edit Attribute page the attributes will be available in the Customers and/or Orders grids. You will then be able to browse and edit them, for example on the Admin Checkout Page.

To get access to the Orders View pages please proceed to Sales > Orders, pick up an order and click on the correspondent row for editing. In the example below you may see the Admin page for Order Address Information with two custom fields available PO Box and VAT Number.

Image Removed

Display in email templates

To display custom attribute in email template use following line:

{{layout handle="aw_customer_attributes_email" customer=$customer attribute_code="attribute_code"}}

where

$customer - customer object in email template, if available;
attribute_code - code of the custom attribute.

Integration with Customer Segmentation

Newly created attributes become available in scope of all store attributes for rule-making in the Customer Segmentation extension. In the example below you may see a rule for segmentation conditioned against the two custom attributes 'How did you hear about us?' and 'Social Media'. The rule segments customers who got to know the shop via Facebook.

Image Removed

Uninstalling M2 Customer Attributes

...

Manual Removal

...

1. Disable the module by executing the following commands:

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

...

2. Remove the extension files from the following folder:

app/code/Aheadworks/CustomerAttributes

...

Automatic Removal (via Composer)

...

1. Disable the module by executing the following commands:

php bin/magento module:uninstall Aheadworks_CustomerAttributes

...

Product Page

Thank you for choosing Aheadworks!