How to create Custom Entities

Custom Entities allow editors to create and manage entities across multiple domains including Technology, Business, Entertainment, Politics, and Social Media. This guide explains how to create and manage Custom Entities in the CMS.

Accessing Custom Entities Management

1. Navigate to the left sidebar menu
2. Under "ENTITIES", click "Custom Entities"

Creating a New Entity

Step 1: Access Creation Form

1. Click the blue "Create new entity" button on the Custom Entities dashboard
2. You'll see the entity creation form

Step 2: Basic Configuration

1. Select a Domain:

   • Sport

   • Entertainment

   • Politics

   • Business

   • Technology

1. Choose an Entity Type:
   • Person
   • Organization
   • Place
   • Role

Step 3: Add additional roles if required

Step 4: Entity Details

Required information varies by entity type. Here's what you need for each:

Person Entity Fields

Required Fields:

• Translation language (default: Bulgarian)
• Name
• Short name
• Three letter code
• Slug

Optional Fields:

• Birth date
• Gender
• Birthplace
• Nationality
• Height (centimeters)
• Weight (kilograms)
• Website
• Email

Organization Entity Fields

Required Fields:

• Slug
• Country

Optional Fields:

• Parent Organization
• Parent Place
• Wiki Page link
• Founding date
• Website
• Email

Place Entity Fields

Required Fields:

• Slug

Optional Fields:

• Parent Place
• Wiki Pages
• Country
• Geolocation (latitude/longitude)
• Website
• Phone Number

Role Entity Fields

Required Fields:

• Slug
• Role Type

Step 4: Media Assets

For each entity, upload two types of images:

1. Display Asset: Main visual representation
2. Icon: Smaller visual identifier

Supported formats:

• .gif
• .jpeg
• .png
• .webp
• .svg

Maximum file size: 15 MB

Step 5: Social Media Information

Add social media links for any of the following platforms:

• Facebook
• YouTube
• Instagram
• WhatsApp
• TikTok
• X (formerly Twitter)
• LinkedIn
• Snapchat
• Telegram

Note: Social media links are not available for Role entity types.

Managing Existing Entities

Finding Entities

Use the filtering options on the dashboard:

1. Search bar: Search by entity name
2. Filter by Domain: Filter entities by domain
3. Filter by entity type: Filter by organization, place, person, or role

Editing and Deleting

Each entity in the list has two action buttons:

• Edit (pencil icon): Opens the entity in edit mode
• Delete (trash icon): Removes the entity after confirmation

Best Practices

1. Naming Conventions:
   • Use consistent naming formats
   • Keep names clear and descriptive
   • Use standard abbreviations for three-letter codes
2. Media Assets:
   • Use high-quality images
   • Maintain consistent aspect ratios
   • Ensure icons are clearly visible at small sizes
3. Information Quality:
   • Provide as much detailed information as possible
   • Keep information up to date
   • Double-check all entered data for accuracy
4. Organization:
   • Use appropriate domains and entity types
   • Maintain clear parent-child relationships
   • Keep related entities consistent

 

NEXT: How to use Custom Entities - Video