Getting Started

Creating custom product types in Bagisto allows you to define specialized product behaviors that perfectly match your business needs. Whether you need subscription products, rental items, digital services, or complex product variations, custom product types provide the flexibility to create exactly what your store requires.

For our tutorial, we'll create a Subscription Product type that demonstrates all the essential concepts you need to build any type of custom product solution.

What You'll Learn

By the end of this guide, you'll be able to:

• Understand Bagisto's product type architecture
• Create custom product types step by step
• Configure product type properties and behaviors
• Implement custom business logic for specialized products

Understanding Bagisto Product Type Architecture

Bagisto's product system is built around a flexible type-based architecture that separates product behavior from data storage:

Core Components

Component	Purpose	Location
Product Types Configuration	Defines product type properties	Config/product-types.php
Product Type Classes	Contains business logic for product behavior	Type/ClassName.php
AbstractType Base Class	Provides core functionality	Extended by custom classes
Service Provider	Registers product type	Providers/ServiceProvider.php

Key Features

• Flexible Product Behavior: Custom logic for pricing, inventory, cart operations
• Type-specific Validation: Different validation rules per product type
• Custom Attributes: Type-specific product attributes and fields
• Admin Integration: Seamless integration with product creation interface

Development Workflow

The typical workflow for creating a custom product type follows these steps:

1. Create Your Product Type

Build a complete working product type with all essential components.

📖 Create Your First Product Type →

This section shows you how to build a complete working product type, then the remaining sections help you understand how to customize each component.

2. Understand Product Type Configuration

Learn how product type configuration works and how to customize product type properties.

📖 Next: Understanding Product Type Configuration

3. Understand AbstractType Methods

Master the key methods available for implementing custom product behavior and business logic.

📖 Next: Understanding AbstractType Class

4. Build Complete Implementation

See how to put it all together in a production-ready subscription product type.

📖 Next: Building Your Subscription Product Type

You'll have a complete working product type after step 1, and steps 2-4 help you understand how to customize and extend it.

Prerequisites

Before you begin, ensure you have:

• Bagisto Installation: A working Bagisto development environment
• PHP Knowledge: Familiarity with PHP 8.2+ and Laravel concepts
• Package Development: Basic understanding of Laravel service providers (Package Development Guide)
• Development Tools: Composer, Git, and a code editor

Quick Start Path

New to Bagisto? Start with the step-by-step creation guide for your first product type.

Want to understand everything? Follow the complete manual setup to learn every component in detail.

What You'll Build

Throughout this guide, you'll create a Subscription Product type that includes:

Core Features

• ✅ Basic Product Behavior: Subscription-specific logic and validation
• ✅ Inventory Management: Service-based products without traditional stock
• ✅ Admin Configuration: Complete settings interface in Bagisto admin
• ✅ Cart Integration: Subscription-specific cart preparation

Architecture Overview

Subscription Product Type Package
├── src/
│   ├── Type/
│   │   └── Subscription.php              # Product type logic
│   ├── Config/
│   │   └── product_types.php             # Product type definition
│   └── Providers/
│       └── ServiceProvider.php           # Package registration
├── composer.json                         # Package metadata
└── README.md                             # Documentation

Development Time Estimate

• Basic Implementation: 1-2 hours (manual setup)
• Custom Logic: 2-3 hours (business logic + validation)
• Testing & Polish: 1-2 hours (admin testing, cart validation)

Built-in Product Types Reference

Understanding Bagisto's built-in product types helps you decide what to customize:

Simple Products

• Use Case: Basic products with straightforward pricing and inventory
• Features: Standard pricing, inventory tracking, simple cart behavior

Configurable Products

• Use Case: Products with variations (size, color, etc.)
• Features: Variant management, attribute-based pricing

Virtual Products

• Use Case: Non-physical products or services
• Features: No shipping required, downloadable content

Grouped Products

• Use Case: Related products sold together
• Features: Bundle pricing, component selection

When to Create Custom Product Types

Consider creating a custom product type when:

• ✅ Unique Behavior: Your products need behavior not covered by built-in types
• ✅ Special Pricing: Complex pricing models or calculations
• ✅ Custom Attributes: Type-specific fields and validation rules
• ✅ Business Rules: Specific business logic for product handling

Ready to Start?

Choose your learning path and begin building your custom product type:

🚀 Create Your First Product Type →

This section covers the manual setup approach, helping you understand the foundations while building a working subscription product type.