Getting started Umbraco v10 & Enterspeed
The easiest way to get started with Umbraco and Enterspeed is using the pre-built Umbraco integration.
GitHub: Enterspeed Source Umbraco CMS
This integration takes care of calling the Enterspeed Ingest API when changes occur in Umbraco. For a full overview of what Umbraco entities are sent to Enterspeed, please see Umbraco entities.
Prerequisite: Umbraco 10.0 or above.
The fastest way to get up and running, is to install the Enterspeed Umbraco integration with NuGet.
When the installation above has been completed two new dashboards have been added to your Umbraco solution.
- Content: To seed and check errors when data is ingested
- Settings: To configure Enterspeed in Umbraco
Before Umbraco starts sending data to Enterspeed you will need to add a little piece of configuration.
Luckily this can easily be done within Umbraco itself or via appsettings.json.
Source API key and Ingest endpoint
Firstly go to Settings and then select the Enterspeed Settings dashboard in your Umbraco backoffice.
You should see something like this:
The Enterspeed endpoint is the ingest endpoint, that Umbraco will use to send content to Enterspeed.
Unless you have gotten a specific Enterspeed endpoint to call, please use: https://api.enterspeed.com
The Media domain is to tell the Enterspeed integration where you have your media placed, e.g. if you have a CDN.
If you leave it empty, it will just use your current Umbraco installation domain.
Before you can insert an API key, you must have created a Source within the Enterspeed Management.
The API key looks something like this: source-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. When you have gotten it, insert it in the Api key input field.
Preview API key
Optional API key serves the purpose of ingesting draft and unpublished content to the secondary (preview) source. Can be leveraged for your content editors to preview content, similarly to the in-built 'Save & Preview' functionality in Umbraco.
Before you can insert a Preview API key, you must have created a Source within the Enterspeed Management.
Enterspeeds connector will automatically push data to relevant primary or secondary sources based on actions performed in Umbraco backoffice, such as - Unpublish, trash, save, publish, etc.
When you have inserted the Enterspeed endpoint and the API key(-s) click on Test connection and make sure that you get a successful response. When you do go ahead and Save the configuration.
For appsettings.json or environment-specific settings file, please use the following appSettings:
Processed Umbraco entities
Here is an overview of what is processed and send to Enterspeed and what is not.
- Published content
- Draft content (unpublished content/saved content)
Not processed entities