01/03/2023
Hi everybody, I am Cuong, Welcome back to my Magento 2 tutorial video series.
In the previous lessons, I showed you:
1. How to login as a customer in Magento 2, if you don't watch this video yet, you can watch it here http://bit.ly/3SF9OiX
2. How to lock a customer account in Magento 2, if you don't watch this video yet, you can watch it here http://bit.ly/3KO0EPm
Let's continue those series, today, I am going to show everybody a best practice, How to update a customer password from the backend in Magento 2.
As we know, Magento supports a feature that allows the administrator to reset a password for a particular customer from the backend by clicking on the "Reset Password" text link. Then Magento will require the users to generate a new password by accessing the link sent in their email.
However, a problem can arise if your customer wants you to send them a particular password for their account, or the customer account email temporarily can’t get emails. So how the customer can log into their customer account?
In this tutorial video, I am going to show you the best codes to change a customer password from the backend in Magento 2.
By default, Magento doesn't allow us to change the customer password directly on the customer form.
So what will we do in this practice?
1. We will create a new module called PHPCuong_CustomerPassword
2. We will add a new customer attribute called "New Password". This customer attribute only can be used from the adminhtml_customer form.
3. We will display this new customer attribute to the customer form on the backend, when the administrator sets the new customer password to this field and press the save button, it will update the customer password and the customer can use that password then.
Okay, let's go.
Let's do this practice, you need to follow the steps by step:
Step 1: Declaring a new module called PHPCuong_CustomerPassword
- Create the namespace PHPCuong in the path app\code.
- Create the module named CustomerPassword in the path app\code\PHPCuong.
- Create the file named registration.php in the path app\code\PHPCuong\CustomerPassword
- Create the file named module.xml in the path app\code\PHPCuong\CustomerPassword\etc
End of step #1, I have been completed codes to create a new module called PHPCuong_CustomerPassword.
Step 2: Adding a new customer attribute called "New Password"
- Create the new file named InstallData.php in the path app\code\PHPCuong\CustomerPassword\Setup
namespace PHPCuong\CustomerPassword\Setup;
use Magento\Framework\Setup\InstallDataInterface;
use Magento\Framework\Setup\ModuleContextInterface;
use Magento\Framework\Setup\ModuleDataSetupInterface;
use Magento\Customer\Setup\CustomerSetupFactory;
use Magento\Eav\Model\Entity\Attribute\SetFactory as AttributeSetFactory;
/**
* Install Data
*/
class InstallData implements InstallDataInterface
{
/**
* CustomerSetupFactory
*/
private $customerSetupFactory;
/**
* AttributeSetFactory
*/
private $attributeSetFactory;
/**
* CustomerSetupFactory $customerSetupFactory
* AttributeSetFactory $attributeSetFactory
*/
public function __construct(
CustomerSetupFactory $customerSetupFactory,
AttributeSetFactory $attributeSetFactory
) {
$this->customerSetupFactory = $customerSetupFactory;
$this->attributeSetFactory = $attributeSetFactory;
}
/**
* {}
* (PHPMD.ExcessiveMethodLength)
*/
public function install(ModuleDataSetupInterface $setup, ModuleContextInterface $context)
{
/** CustomerSetup $customerSetup */
$customerSetup = $this->customerSetupFactory->create(['setup' => $setup]);
$customerEntity = $customerSetup->getEavConfig()->getEntityType(\Magento\Customer\Model\Customer::ENTITY);
$attributeSetId = $customerEntity->getDefaultAttributeSetId();
/** $attributeSet AttributeSet */
$attributeSet = $this->attributeSetFactory->create();
$attributeGroupId = $attributeSet->getDefaultGroupId($attributeSetId);
if (!$customerSetup->getAttributeId(\Magento\Customer\Model\Customer::ENTITY, 'phpcuong_customer_password')) {
$customerSetup->addAttribute(\Magento\Customer\Model\Customer::ENTITY, 'phpcuong_customer_password', [
'type' => 'varchar',
'label' => 'New Password',
'input' => 'text',
'frontend' => '',
'backend' => 'PHPCuong\CustomerPassword\Model\Attribute\Backend\Password',
'required' => false,
'visible' => true,
'user_defined' => true,
'sort_order' => 85,
'position' => 85,
'system' => 0,
'is_used_in_grid' => false,
'is_visible_in_grid' => false,
'is_html_allowed_on_front' => false,
'visible_on_front' => false
]);
$attribute = $customerSetup->getEavConfig()->getAttribute(
\Magento\Customer\Model\Customer::ENTITY, 'phpcuong_customer_password'
)->addData(
[
'attribute_set_id' => $attributeSetId,
'attribute_group_id' => $attributeGroupId,
'used_in_forms' => [
'adminhtml_customer'
]
]
);
$attribute->save();
}
}
}
- Create the new file named Password.php in the path app\code\PHPCuong\CustomerPassword\Model\Attribute\Backend
namespace PHPCuong\CustomerPassword\Model\Attribute\Backend;
use Magento\Framework\Exception\LocalizedException;
/**
* Customer password attribute backend
*/
class Password extends \Magento\Eav\Model\Entity\Attribute\Backend\AbstractBackend
{
/**
* Min password length
*/
const MIN_PASSWORD_LENGTH = 6;
/**
* Magento string lib
*
* \Magento\Framework\Stdlib\StringUtils
*/
protected $string;
/**
* \Magento\Framework\Stdlib\StringUtils $string
*/
public function __construct(\Magento\Framework\Stdlib\StringUtils $string)
{
$this->string = $string;
}
/**
* Special processing before attribute save:
* a) check some rules for password
* b) transform temporary attribute 'phpcuong_customer_password' into real attribute 'password_hash'
*
* \Magento\Framework\DataObject $object
* void
* \Magento\Framework\Exception\LocalizedException
*/
public function beforeSave($object)
{
$password = $object->getPhpcuongCustomerPassword();
$length = $this->string->strlen($password);
if ($length > 0) {
if ($length < self::MIN_PASSWORD_LENGTH) {
throw new LocalizedException(
__('Please enter a password with at least %1 characters.', self::MIN_PASSWORD_LENGTH)
);
}
if (trim($password) !== $password) {
throw new LocalizedException(__('The password can not begin or end with a space.'));
}
$object->setPasswordHash($object->hashPassword($password));
//$object->setPasswordRandom($password);
}
}
/**
* After attribute saved method
* Set the value to NULL
*
* \Magento\Framework\DataObject $object
* void
* (PHPMD.UnusedFormalParameter)
*
*/
public function afterSave($object)
{
if ($object->getPhpcuongCustomerPassword()) {
$object->setPhpcuongCustomerPassword(NULL);
$this->getAttribute()->getEntity()->saveAttribute($object, $this->getAttribute()->getAttributeCode());
}
}
}
Step 3: Displaying the customer password field to the customer form on the backend.
- Create the new file named customer_form.xml in the path app\code\PHPCuong\CustomerPassword\view\adminhtml\ui_component
PHPCuong_CustomerPassword/form/element/password
true
text
input
- Create the new file named password.html in the path app\code\PHPCuong\CustomerPassword\view\adminhtml\web\template\form\element
Step 4: Test and See the results
- Run the following command line: php bin/magento setup:upgrade
I used --keep-generated to not delete the folders in the generated, pub/static, var/view_preprocessed
- Go to the backend, try to edit a customer and update the customer password field and save.
- Go to the frontend, try to log into the customer account with the password just changed.
Yeah, it works perfectly.
We can hide the password by changing this
Thank you for watching my video. If you have any questions about this practice please feel free to leave a comment below.
Don't forget to like, comment, share and subscribe to my channel for getting the latest video.
Please do not hesitate to contact me if you need me to join your Magento project. My rate is $25/hour in Magento 1 and $30/hour in Magento 2.
