Sulu Category Extra Bundle Laravel Package

Product Decisions This Supports

• Feature Expansion: Enables adding custom metadata to Sulu CMS categories without requiring schema migrations for new tables, reducing database complexity.
• Roadmap Flexibility: Supports future-proofing category management by allowing dynamic field additions via XML configuration (e.g., A/B testing flags, SEO metadata, or localization tags).
• Build vs. Buy: Avoids reinventing a custom solution for category extensions, leveraging a lightweight, pre-built bundle with Sulu’s ecosystem compatibility.
• Use Cases:
  • Content Personalization: Store theme/color preferences per category (e.g., theme: "blue").
  • SEO Optimization: Add schema markup or canonical URL fields directly in the admin UI.
  • Multi-Language Workflows: Extend categories with language-specific metadata without duplicating tables.
  • Analytics Tracking: Attach UTM parameters or event tags to categories for reporting.

When to Consider This Package

• Adopt if:
  • Your Sulu CMS project requires ad-hoc category attributes (e.g., custom fields for marketing, analytics, or design).
  • You want to avoid database migrations for simple JSON-based extensions.
  • Your team is comfortable with Sulu’s form XML configuration (low-code customization).
  • You’re using Sulu CMS 3.0+ and PHP 8.2+.
• Look elsewhere if:
  • You need structured relational data (use Doctrine entities/tables instead).
  • Your fields require complex validation beyond Sulu’s form types (e.g., multi-step workflows).
  • You’re on an older Sulu version (<3.0) or PHP <8.2.
  • You prefer no-code solutions (e.g., Sulu’s built-in fields or third-party plugins with GUI editors).

How to Pitch It (Stakeholders)

For Executives: "This bundle lets us add custom fields to Sulu categories—like themes, SEO tags, or analytics IDs—without touching the database schema. It’s a 10-minute setup (XML config + migration) that unlocks flexibility for content teams to manage metadata directly in the admin panel. Think of it as ‘sticky notes’ for categories, but structured and version-controlled."

For Engineering: *"A lightweight, dependency-free way to extend Sulu categories with JSON fields. Uses Sulu’s existing form system (XML-based), so no new APIs or ORM layers. Ideal for:

• Non-breaking changes: No schema migrations.
• Team autonomy: Content teams configure fields via XML (no dev cycles).
• Performance: Single JSON column avoids N+1 queries. Tradeoff: Fields are denormalized (JSON), so avoid complex queries or joins. Perfect for metadata, not transactional data."*

For Content Teams: "Need to add extra info to categories (like ‘promo color’ or ‘target audience’) without asking devs? This adds a simple ‘Additional Data’ tab where you can define custom fields—like a form builder—right in Sulu. Changes deploy instantly, no database updates."