To create a custom widget, log in to your Contentstack account, and perform the following steps:
- Go to your stack, navigate to the “Settings” gear icon, and select Extensions.
- On the Extensions page, click on the + Add Extension button, and select Create new. If you have not added any extensions in the stack yet, click on the create a new one link as shown below.
- In the Select Extension Type window, select Custom Widget.
- In the Create New Extension page, enter values in the fields as given below:
- Title: Provide a suitable title for your custom widget. This title will be visible as a widget name in the entry page.
- Hosting method: Select how you want to host the widget:
- External Hosting: Select this option for externally hosted widgets. You need to provide the URL in the External hosting URL field that appears below.
- Hosted on Contentstack: Select this option if you can write the code in the Extension source code field that appears below.
Additional Resource: If you want to try out sample code for widget in the Extension source code field, browse through the Text Intelligence repository available on GitHub.
- Config Parameter: If you have used any config parameters (such as access token) in the source code, specify the value of the parameters in this field.
- Scope: Select for which content types this widget will be available. You can choose either All Content Types or Specific Content Types.
- Finally, click on Save.
Test Custom Widget Extension
When you create your custom extension to integrate with Contentstack, you can follow the steps given below to test the extension and verify if the extension is working fine before releasing it.
To test the extension, first, clone the extension repo that you have built and install the dependencies. Then, edit the HTML, CSS, and JS files from the source folder.
To install the required dependencies, run the following commands in the root folder:
npm install gulp-cli -g npm install
To create a new build for the extension, run the following command (index.html):
To update/test the extension while developing, run the following command:
Now, create a server using the Lite Server npm module. Before that, install the Lite Server module by using the following command:
npm install -g lite-server
Then, run the lite-server — in the root folder as follows:
After running the above command, you will get the following screen:
Make note of the port no in Access URLs (the localhost URL):
Next, we need to install ngrok to build secure tunnels from a public endpoint (that is the internet) to a locally running server. Issue the following command to install ngrok:
npm install ngrok -g ngrok http <<port number>>
Once you run the above command, you will get a URL. Now create an extension by navigating to your stack and selecting Settings > + Add Extension > Create new.
On the Select Extensions Type screen, select Custom Widget and then add the required details on the Create New Extension screen.
In the Hosting method field, select External hosting and paste the above URL in it. Now save your extension and check the entry where you have added your extension.
You should see your updated changes.
Here are the links to the API requests related to this action: