Download the PHP package plotdesk/plugin-sdk without Composer
On this page you can find all versions of the php package plotdesk/plugin-sdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download plotdesk/plugin-sdk
More information about plotdesk/plugin-sdk
Files in plotdesk/plugin-sdk
Package plugin-sdk
Short Description SDK for developing plotdesk plugins
License proprietary
Informations about the package plugin-sdk
plotdesk Plugin SDK
Official SDK for developing plotdesk plugins. Provides base classes, type stubs for IDE autocompletion, and a scaffolding CLI to create new plugin projects.
Reference Implementation
Before building your own plugin, study the official example plugin which demonstrates every feature this SDK supports:
https://github.com/plotdesk/plotdesk-example-plugin
It is a production-ready reference implementation with multiple apps, custom pages, custom chat interfaces, rich payload components, event listeners, scheduled tasks, full EN/DE translations and perfect light/dark mode support. Whenever you are unsure how something should be structured, this repository is the canonical source of truth.
Quick Start
This generates a complete plugin structure with:
plugin.jsonmanifest- App class with example AI function
- Service provider
- Routes, translations, migrations directories
- Cursor rules for AI-assisted development
- Proper
.gitignore(vendor/ and dist/ are committed!)
What Plugins Can Do
- AI Functions: Register apps with custom tool calls for the AI
- Custom Pages: Own Inertia pages with pre-built Vue components
- Custom Group Interfaces: New "View Mode" types in Group Settings
- Navigation: Menu items in the sidebar
- Permissions: Custom global and group-level permissions
- Routes: Web and API endpoints under
/plugins/{id}/ - Chat Payloads: Rich UI components in chat messages
- Database: Own tables with migrations
- AI Access: Direct AI calls via
PluginAi::call()or full chat viaPluginChat::run() - Events: React to chat.created, message.sent, user.joined_team, and more
- Queue Jobs, Scheduled Tasks, Broadcasting, Notifications, Mail, Cache
Plugin Structure
AI Function Example
Direct AI Access
Custom Group Interface
The component is loaded from dist/interfaces/Dashboard.js and receives group, chat, and interfaceSettings as props.
Important Conventions
- Table prefix: All database tables must use the plugin ID as prefix (e.g.,
my_plugin_contacts) - App ID prefix: App IDs must start with the plugin ID
- vendor/ committed: The plugin ships its own dependencies (no
composer installon the server) - dist/ committed: Pre-built frontend assets are committed (no
yarn buildon the server) - Permissions namespaced: Use unique names like
view_my_dashboard, notview_dashboard
IDE Support
The SDK includes type stubs for all plotdesk classes (ChatMessage, Team, User, Group, StorageService, BasicApp, etc.). Your IDE will provide full autocompletion for plotdesk APIs.
The generated .cursor/rules/plotdesk-plugin.mdc file provides comprehensive AI assistance rules for Cursor IDE, documenting all available APIs, patterns, and conventions.
Installation on plotdesk
Plugins are installed via the Plugin Management UI in plotdesk (Platform Admin > Plugins). The admin connects GitHub, selects the plugin repository, and installs it with one click. Auto-updates are supported via GitHub webhooks.
Requirements
- PHP 8.2+
- plotdesk 4.50+