There are a number of terms, phrases, and concepts used all over Pokko. Hopefully, this article will help you understand their meaning.
Account
- An account is the top level of organisation when it comes to grouping projects.
- Typically a client would have one account with a number of projects associated with it.
- Billing and usage are managed and monitored at an account level.
Project
- A project is where environments and media libraries live.
Environment
- An environment is where you define data models, author content and handle your publishing workflow.
- There can be a number of environments in a project.
- In future, there will be tools for transitioning changes between environments.
Model
- A model is where you define the structure of your content.
- Models have fields that define attributes associated with your content.
Inheritance
- Models can inherit other models. When a model inherits another, it has the fields defined on itself as well as the models that it inherits.
- Read more about data model inheritance here.
Entry
- An entry is a piece of content, it follows the structure of the model that it is associated with.
Entry version
- Entries can have any number of versions.
- When creating a new version, all the content from the current version is copied.
- You can work on versions independently and publish them to various publish targets.
Media
- This is where all your media is stored. The media library can contain any type of file from images, videos to documents.
- Projects have one media library shared across all environments.
Publish target
- Entry versions are published to Publish targets.
- This is how you control what content is available where.
- The simplest example of this is to have a "Public" publish target.
- Additional targets can be included for things like preview environments.
- When content is published to a target it is available for querying on the API endpoint.
API token
- API tokens are used by integrations that query data from Pokko for consumption.
- Tokens are associated with publish targets and will only return content that has been published to that associated target.
Webhook
- A webhook is a process where Pokko will call an HTTP(s) endpoint defined by you.
- At present, webhooks can only be manually triggered in the Pokko UI.
- In future, you will be able to associate webhooks with events triggered by actions in Pokko such as publishing content.