Plugin Development

plugin.json Manifest Reference

The plugin.json file located in your plugin root directory defines metadata, dependencies, and entrypoints for AIPostify core and the Marketplace.

⚠️ Note on Compatibility Naming Inconsistency

In earlier core builds, some plugins referenced requires_aipostify while others referenced min_aipostify_version. The canonical standard supported by the Marketplace validator is min_aipostify_version.

💡 Database Migrations Directory: If your plugin creates custom database tables, place your migration files inside a migrations/ directory alongside plugin.json. Learn more in the Database Migrations documentation.

Full Example

{
    "name": "Postify Announcements",
    "slug": "postify-announcements",
    "version": "1.0.0",
    "description": "Create and display site-wide banner announcements and news posts.",
    "author": "AIPostify Core Team",
    "author_url": "https://aipostify.com",
    "main_class": "PostifyAnnouncements",
    "min_aipostify_version": "1.0.0",
    "license": "GPL-2.0-or-later",
    "tags": ["announcements", "banner", "alerts"]
}

Field Reference

Field	Type	Required	Description
`name`	string	Yes	Display name of the plugin
`slug`	string	Yes	Unique identifier matching directory name
`version`	string	Yes	SemVer string (e.g. 1.0.0)
`description`	string	Yes	Short plugin summary
`main_class`	string	Yes	Main class name extending `BasePlugin`
`min_aipostify_version`	string	Yes	Minimum required core version
`author`	string	No	Author or company name
`author_url`	string	No	Author website URL
`license`	string	No	SPDX license identifier (e.g. MIT, GPL-2.0)
`tags`	array	No	Array of category tags