Plugin development guide for Heratio

Announcement
425
Johan Pieterse
Nov 15, 2025 9:00 AM

For developers interested in building Heratio plugins, here are the key conventions:

  • Plugin naming: ahg[DescriptiveName]Plugin
  • Use Laravel Query Builder (not raw PDO)
  • Include install.sql in database/ folder
  • Use namespaced classes where possible
  • Support CSP nonces in all templates

Full documentation is being prepared. In the meantime, feel free to ask questions here.

8 Replies

David Park Nov 16, 2025 11:00 AM

This is very helpful. One question - for the database migrations, should we use Laravel migrations or stick with plain SQL install files?

Johan Pieterse Nov 16, 2025 2:30 PM

Currently we use plain SQL install files (database/install.sql). Laravel migrations are on the roadmap but the current Symfony 1.x integration makes this tricky. Stick with install.sql for now - it's cleaner and more portable.