Laravel Addon CMS

Laravel Addon CMS তৈরির মূল কারণ ছিল একই Feature বারবার Copy করার Long-term Cost। Blog, Newsletter, Contact Form বা Analytics শুরুতে Reusable মনে হলেও Client Project-এর ভেতরে ঢোকার পর ধীরে ধীরে Core Code-এর অংশ হয়ে যায়।

এই CMS একটি স্পষ্ট Ownership Boundary তৈরি করে। Core Admin Shell, Setting, Media, SEO, Installer, Theme Content এবং Package Lifecycle Handle করে। ভবিষ্যতের Feature সম্পর্কে Core-এর জানার প্রয়োজন নেই; প্রতিটি Feature নিজের Package, Provider, Route এবং Migration নিয়ে Addon হিসেবে থাকে।

Repository Open-source রাখার উদ্দেশ্যও একই: Laravel Developer যেন Code পড়তে, Modify করতে এবং পরিচিত Framework Convention ব্যবহার করে System Extend করতে পারেন। এটি কোনো Closed SaaS Product নয়; এটি একটি Practical এবং Extensible Foundation।

Database ঠিক করে Application কী Load করবে

Application Boot হওয়ার সময় addons এবং themes Table আছে কি না Check করে। Install Complete থাকলে addons Table থেকে Active Record নিয়ে app/Addons/{AddonName}/{AddonName}ServiceProvider Register করা হয়। একইভাবে active_theme Setting থেকে app/Themes/{ThemeName}/{ThemeName}ServiceProvider Load হয়।

এই Design-এর ফলে Addon Activate করতে Config File Change করতে হয় না এবং Theme Switch করতে নতুন Deploy লাগে না। Admin State Change হলে Route, View Namespace, Sidebar Item, Page এবং Section Configuration-ও Change হয়।

ThemeContent Database-এ Section Content রাখে এবং Runtime-এ Cache করা হয়। Admin Customizer Section Class-এর Field Definition থেকে Form তৈরি করে। Public Page-এর x-section-loader Active Page Section-এর Blade View Load করে; সেই View-এর x-ui Component Saved Content Render করে এবং Editing Hook বজায় রাখে।

একটি Addon হলো Application-এর ভেতরে Self-contained Laravel Feature Package

Addon সাধারণত Service Provider, Activator, composer.json Metadata, Route, Controller, Model, Migration, View এবং Asset নিয়ে গঠিত। cmsaddoncommands Package এই Repetitive Structure Scaffold করে।

1# Addon-এর Initial Structure তৈরি2php artisan make:addon Blog3 4# Model, Migration ও Controller তৈরি5php artisan addon:model Blog Post -m6php artisan addon:controller Blog PostController7php artisan addon:migration Blog create_posts_table8 9# শুধু Blog Addon-এর Migration Run বা Rollback10php artisan addon:migrate Blog11php artisan addon:migrate:rollback Blog

Route, View এবং Admin Menu Register করা

1<?php2 3namespace App\Addons\Blog;4 5use App\Lib\Sidenav;6use Illuminate\Support\ServiceProvider;7 8class BlogServiceProvider extends ServiceProvider9{10    public function boot(): void11    {12        $this->loadRoutesFrom(__DIR__.'/routes/cms_blog.php');13        $this->loadViewsFrom(__DIR__.'/views', 'Blog');14 15        Sidenav::add(16            'Content',17            'Blog posts',18            'admin.blog.index',19            'ph ph-article'20        );21    }22}

• Addon Nickname, Folder এবং Service Provider Prefix একই রাখুন।
• Database Change Addon Migration Directory-তে রাখুন, যাতে Activation ও Deletion Reversible থাকে।
• অন্য Addon বা Active Theme-এর File সরাসরি ব্যবহার না করে নিজস্ব View Namespace ব্যবহার করুন।
• Distribution-এর আগে required_addons এবং required_system_version সঠিকভাবে Declare করুন।
• Migration দিয়ে করা যায় না এমন Lifecycle Work-এর জন্যই Activator Hook ব্যবহার করুন।

Theme Page, Section এবং Presentation-এর Owner

Theme-এর Service Provider Route ও Theme Namespace-এর View Load করে। theme_configuration Callback-এর ভেতরে প্রতিটি Section Class Register করা হয় এবং register_pages দিয়ে Customizer-এর জন্য Public Page Declare করা হয়।

Section Class-এর Static register Method Active $themeConfig Instance গ্রহণ করে। addSection-এ Section Metadata এবং addField-এ প্রতিটি Editable Field-এর Type, Key, Label ও Default Value দেওয়া হয়।

1<?php2 3namespace App\Themes\YourTheme\Lib;4 5class HeroSection6{7    public static function register($themeConfig): void8    {9        $themeConfig->addSection([10            'key' => 'hero_section',11            'pages' => ['home'],12            'position' => 1,13            'title' => 'Hero Section',14        ]);15 16        $themeConfig->addField('hero_section', [17            'type' => 'text',18            'key' => 'heading',19            'label' => 'Heading',20            'default' => 'Build something useful',21        ]);22 23        $themeConfig->addField('hero_section', [24            'type' => 'image',25            'key' => 'image',26            'label' => 'Hero Image',27            'size' => '1200x800',28            'accept' => '.png,.jpg,.jpeg,.webp',29            'default' => load_image(30                'app/Themes/YourTheme/assets/images/hero.jpg'31            ),32        ]);33    }34}

Blade View-এ CMS Component ব্যবহার

1<section class="hero-section">2    <div class="container">3        <div class="hero-content">4            <h1>5                <x-ui.text6                    section="hero_section"7                    key="heading"8                />9            </h1>10        </div>11 12        <x-ui.img13            class="img-fluid"14            section="hero_section"15            key="image"16            alt="Hero image"17        />18    </div>19</section>

x-ui.text, x-ui.img, x-ui.a এবং x-ui.repeater শুধু Output Component নয়। এগুলো Saved Theme Content Resolve করার পাশাপাশি Customizer-এর Editing Hook বজায় রাখে। তাই $content Array থেকে সরাসরি Value পড়া এই CMS-এর সঠিক Convention নয়।

• Service Provider Route, View, Page এবং Section Class Register করে।
• Lib Directory Admin Customizer-এর Editable Field Schema Define করে।
• views/sections-এ প্রতিটি Registered Section Key-এর Blade View থাকে।
• views/slices Repeater Item, যেমন Testimonial বা Service Card Render করে।
• config.json ও screenshot.png Admin Panel-এ Theme পরিচয় করায়।
• assets Directory Theme-এর CSS, JavaScript, Image এবং Font রাখে।

Laravel Developer-এর পরিচিত Convention ধরে রাখা হয়েছে

Service Provider, Route File, Blade View, Migration, Artisan Command এবং Composer Metadata ব্যবহার করাই এই Architecture-এর প্রধান সুবিধা। System Extend করতে Developer-কে আরেকটি Private Framework শিখতে হয় না।

Addon Activation-এর সময় নির্দিষ্ট Migration Path Run করা হয়। Deletion-এর সময় Migration Rollback, Activator Delete Hook, Addon Directory Removal এবং Database Record Cleanup হয়। এই Lifecycle সহজ হলেও Automated Test এবং Failure Recovery আরও শক্তিশালী করা দরকার।

Architecture-এর তুলনায় Interface এখনো কম Mature

Project-এর বর্তমান UI/UX সবচেয়ে Strong Part নয়। শুরুর দিকের বড় অংশ Addon Boundary, Theme Registration, Migration Lifecycle, Configurable Content এবং Laravel Developer-এর জন্য Code Readability তৈরিতে ব্যয় হয়েছে।

এই Priority System-কে Extensible করেছে, কিন্তু Admin Customizer, Media Manager, Addon Screen এবং Theme Control-এ আরও পরিষ্কার Interaction, Accessibility এবং Visual Polish দরকার। ভালো একটি Design Pass Architecture বদলাবে না; বরং Non-technical User-এর জন্য একই System আরও সহজ ও বিশ্বাসযোগ্য করবে।

কোন Contribution সবচেয়ে বেশি Value যোগ করবে

MIT License-এর এই Project-এ Contribution Welcome। Documentation, Hosting Instruction, UI Polish, Accessibility, Validation, Automated Test, নতুন Theme Section, Complete Theme এবং নির্দিষ্ট কাজের Addon—সবই Valuable Contribution।

বড় Rewrite-এর চেয়ে একটি নির্দিষ্ট Admin Workflow, একটি Test Gap, একটি Documentation Problem বা একটি Reusable Section নিয়ে ছোট Pull Request Review ও Maintain করা সহজ। এই ধরনের Contribution Extension Model-কে পরিষ্কার রাখে।