Appearance
Plugins
Plugins add to Qorekit: new field types, functions for formulas, and more as Qorekit grows. They are managed in Administration › Plugins, by super admins only.
A plugin runs with Qorekit's own rights
A plugin's code runs on your server with full access to Qorekit and its database. Install plugins only from people you trust.
Installing a plugin
Click Upload a plugin and choose the plugin's zip file. The plugin is installed but off: click Turn on to use it. Turning it on checks that it starts, prepares its tables, and starts it with every page from then on. Reload the page for its parts of the interface (an editor for its field type, say) to appear.
Plugins can also be copied over FTP: each plugin is a folder in the plugins folder of Qorekit, named after the plugin's id (plugins/acme/rating for acme/rating). A plugin copied there shows in the list, off.
Uploading needs PHP's zip extension and a plugins folder the web server may write to; the page says when either is missing.
Plugins whose id starts with qorekit/, such as Qorekit Pro, are Qorekit's own: their zips are signed by Qorekit, and Qorekit installs one only when the signature holds and no file was changed. Qorekit Pro has a page of its own.
Some plugins add pages to Administration, under Configuration; and some tell administrators, at the top of every page, when something needs doing, such as a licence to add.
Updating a plugin
Upload the new version's zip. It replaces the installed copy; a plugin that was on stays on, and the new version's database changes are made.
Turning a plugin off, and deleting it
Turn off stops a plugin from the next page on. Fields of a type it gave keep their values but are not shown or changed until it is on again.
A plugin that is off can be deleted. Delete removes its files and keeps its tables, for when it is installed again; Delete with its data removes its tables and the files it kept too, once its id is typed.
When a plugin fails
A plugin that fails while starting is turned off by Qorekit at once, so the site keeps working. Its place in the list says what went wrong; fix the plugin or ask its author, then turn it on again.
Safe mode
If a plugin breaks the site so badly that Administration does not open, start Qorekit in safe mode, with every plugin off: create an empty file named safe-mode in Qorekit's storage folder (with your panel's file manager or FTP), or set QOREKIT_SAFE_MODE=true in .env. Turn the faulty plugin off or delete it, then remove the file or the setting.
Writing plugins
See writing plugins. The example plugin in examples/plugins/rating adds a star rating field.