The first page under the “Customers” menu gives you a list of all the registered users on your shop.
During the installation of Shopper, one of the first things required is to inherit to our model User the features of the model User that is in Shopper.
Fields
The model used is App\Models\User which extends the \Shopper\Framework\Models\User\User model.
During the installation of Shopper, the name column of the users table is removed and replaced by 2 new fields which are first_name and last_name.
| Name | Type | Required | Notes |
|---|
id | autoinc | | auto |
first_name | string | no | Nullable |
last_name | string | yes | |
email | string | yes | Unique |
password | string | no | Nullable |
email_verified_at | timestamp | no | Nullable |
gender | enum | yes | values ['male', 'female'] |
phone_number | string | no | Nullable |
birth_date | date | no | Nullable |
avatar_type | string | no | default ui-avatars |
avatar_location | string | no | Nullable, picture filename |
timezone | string | no | Nullable |
opt_in | boolean | no | default false, this field is for mailing subcription |
last_login_at | timestamp | no | Nullable |
last_login_ip | string | no | Nullable |
Components
The components used to manage customers are found in the component configuration file config/shopper/components.php.
use Shopper\Framework\Http\Livewire;
return [
'livewire' => [
'modals.delete-customer' => Livewire\Modals\DeleteCustomer::class,
'customers.addresses' => Livewire\Customers\Addresses::class,
'customers.browse' => Livewire\Customers\Browse::class,
'customers.create' => Livewire\Customers\Create::class,
'customers.orders' => Livewire\Customers\Orders::class,
'customers.profile' => Livewire\Customers\Profile::class,
'customers.show' => Livewire\Customers\Show::class,
'tables.customers-table' => Livewire\Tables\CustomersTable::class,
];
];
Manage Customers
When a new customer places an order with your store, their name and information are automatically added to your customer list. A customer profile is created when a customer interacts with your store.
Alternatively, you can add a customer to your store manually.
Create customer
From your Shopper admin, go to Customers and click on “Add customer” button.
When creating a customer manually, you should also fill in an address that will be used when he places an order in your store.
Optional: If the customer has agreed to receive marketing emails, and you have entered an email address, then in the Customer overview section, check Customer agreed to receive marketing emails.
And you can also check the Send customer credentials checkbox to sent an email to the customer with their login information.
The Livewire component used to create a client is Shopper\Framework\Http\Livewire\Customers\Create
$customer = (new UserRepository())->create([
'last_name' => $this->last_name,
'first_name' => $this->first_name,
'email' => $this->email,
'password' => Hash::make($this->password),
'phone_number' => $this->phone_number,
'email_verified_at' => now()->toDateTimeString(),
'opt_in' => $this->opt_in,
]);
$customer->assignRole(config('shopper.system.users.default_role'));
The clients that are displayed in the listing page are those that have the user profile which is the default role associated with all clients.
- Customer information, first and last name, e-mail address, picture, birth date, gender.
- Registered Addresses
- Orders Summary of purchases already made by the customer. Amount spent, payment type, order status. For more information on each order, click on the order number.
Each of its pages are accessible via Livewire components, and are fully customizable to your needs. So don’t hesitate to modify them.
