diff options
author | Frederic Guillot <fred@kanboard.net> | 2017-01-29 11:07:42 -0500 |
---|---|---|
committer | Frederic Guillot <fred@kanboard.net> | 2017-01-29 11:07:42 -0500 |
commit | 0371acff89b14b9bdcb03e72fd9637e26e6b517c (patch) | |
tree | f5878c9c07705379d137843cb8f92e3cdf7c20a8 /doc/plugin-metadata.markdown | |
parent | 3bf4789be255650b64f42231f41383cb13b65572 (diff) |
Move English documentation to folder en_US
Diffstat (limited to 'doc/plugin-metadata.markdown')
-rw-r--r-- | doc/plugin-metadata.markdown | 42 |
1 files changed, 0 insertions, 42 deletions
diff --git a/doc/plugin-metadata.markdown b/doc/plugin-metadata.markdown deleted file mode 100644 index 49da0ac1..00000000 --- a/doc/plugin-metadata.markdown +++ /dev/null @@ -1,42 +0,0 @@ -Metadata -======== - -You can attach metadata for each project, task, user or for the whole application. -Metadata are custom fields, it's a key/value table. - -For example your plugin can store external information for a task or new settings for a project. -Basically that allow you to extend the default fields without having to create new tables. - -Attach metadata to tasks and remove them ------------------------- - -```php - -// Return a dictionary of metadata (keys/values) for the $task_id -$this->taskMetadataModel->getAll($task_id); - -// Get a value only for a task -$this->taskMetadataModel->get($task_id, 'my_plugin_variable', 'default_value'); - -// Return true if the metadata my_plugin_variable exists -$this->taskMetadataModel->exists($task_id, 'my_plugin_variable'); - -// Create or update metadata for the task -$this->taskMetadataModel->save($task_id, ['my_plugin_variable' => 'something']); - -// Remove a metadata from a project -$this->projectMetadataModel->remove($project_id, my_plugin_variable); -``` - -Metadata types --------------- - -- TaskMetadata: `$this->taskMetadataModel` -- ProjectMetadata: `$this->projectMetadataModel` -- UserMetadata: `$this->userMetadataModel` -- Settings/Config: `$this->configModel` - -Notes ------ - -- Always prefix the metadata name with your plugin name |