User Interface
Reference
- Activity
- Addresses
- Calls
- Chat
- Custom Field Groups
- Custom Fields
- Customers
- Deals
- Deliveries
- Email Marketing
- Files
- Invoices
- Labels
- Lead Sources
- Leads
- Lunches
- Meetings
- Notes
- Orders
- Organisations
- People
- Permissions
- Pipelines
- Product Attributes
- Product Categories
- Products
- Purchase Orders
- Quotes
- Roles
- SMS Marketing
- Tasks
- Tax Rates
- Teams
- Users
Customers
Overview
Customers (internally called "Clients") represent the polymorphic bridge between a Person or Organisation and their role as a customer. This allows both people and organisations to be treated uniformly as customers throughout the system — on Leads, Deals, Orders, etc.
Model: VentureDrake\LaravelCrm\Models\Client
Table: {prefix}clients (default: crm_clients)
Attributes
| Attribute | Type | Description |
|---|---|---|
external_id |
string |
UUID used in URLs (auto-generated) |
clientable_type |
string |
Polymorphic type (Person or Organisation) |
clientable_id |
integer |
Polymorphic ID |
Computed Attributes
name
Returns the name of the underlying person or organisation.
$client->name; // "John Smith" or "Acme Corp"
Relationships
| Method | Type | Related Model | Description |
|---|---|---|---|
clientable() |
morphTo |
Person|Organisation |
The underlying entity |
Polymorphic Usage
A Person or Organisation becomes a customer via their client() relationship:
// Create a client from a person
$client = $person->client()->create();
// Create a client from an organisation
$client = $organisation->client()->create();
// Access the underlying entity
$client->clientable; // Returns Person or Organisation instance
Searching & Filtering
Searchable by the underlying person or organisation names.
Traits
| Trait | Description |
|---|---|
SoftDeletes |
Soft delete support |
LaravelEncryptableTrait |
Field-level encryption |
BelongsToTeams |
Multi-tenant team scoping |
HasCrmFields |
Custom field support |
SearchFilters |
Search and filter capabilities |
Sortable |
Column sorting |
HasCrmActivities |
Activity timeline tracking |
HasCrmUserRelations |
Standard user tracking relations |