Are you developing an open-source project or an extension related to Kentico and want to share it with the developer's community? Submit a Pull Request and share it on the DevNet marketplace!
Visit devnet.kentico.com/marketplace to see all available extensions.
To register your project on DevNet, it needs to satisfy the following requirements. The project needs to:
- be related to any of the Kentico EMS products
- be compatible with the latest major version of the related product
- utilize the open-source approach
- have satisfactory documentation
- contain a README file with:
- a clear description of the project
- download & installation instructions
- (a link to) contribution guidelines
- (a link to) license information
- compatibility information
- information about how the project is supported in case users have questions or find a bug
- (optional, but recommended) a screenshot/gif of the extension
- follow naming conventions for Kentico objects (if applicable)
- follow best practices for customization (if applicable)
- (recommended) be hosted on GitHub
These requirements are automatically checked via GitHub action duirng the pull request pipeline.
If your extension meets the above-mentioned criteria, you can create a pull request in this repository. Projects are located in the extensions.json
file. To add your project, create a new entry in the JSON object.
You can propose changes to a file directly in your browser without having to clone the repository, doing the changes locally, and committing.
The extensions.json
file contains details about available extensions. Add a new entry to submit an extension:
[
...
{
"name": "Video widget",
"description": "Widget allowing to select and render a YouTube video on site.",
"thumbnailUrl": "https://raw.githubusercontent.com/Kentico/devnet.kentico.com/master/marketplace/assets/kentico-icon.png",
"author": "Kentico",
"sourceUrl": "https://github.com/Kentico/ems-mvc-components/tree/master/Kentico.Widget.Video#video-widget",
"version": "1.0.0-beta1",
"kenticoVersions": [
"12.0.31"
],
"category": "mvc widget",
"tags": [
"mvc",
"youtube",
"video",
"inline-editor"
]
}
]
Property | Type | Description |
---|---|---|
name | string | Name of the extension (max. 40 characters). |
description | string | Description of the extension (max. 160 characters). |
thumbnailUrl1 | string | Url to the thumbnail image describing the extension, or the author (must be jpg/jpeg/png with 100x100px resolution and accessed using secure HTTPS). |
author | string | Name of the author and/or company (max. 40 characters). |
sourceUrl | string | URL to access the extension (must use secure HTTPS). |
version2 | string | Latest version of the extension (must follow the semantic versioning). |
kenticoVersions3 | array of strings | supported Kentico versions (version entries must follow the semantic versioning). |
category | string | Category of the extension. Use one of the following: module , webpart , website template , utility , mvc widget , mvc section , mvc form component , mvc inline editor , mvc personalization condition type , integration , other . |
tags | array of strings | List of tags you want to apply to the extension. |
1 You can store the icon in the /marketplace/assets folder as a part of the pull request and use URL format as showcased in the example configuration. Kentico icon is reserved for extensions developed by Kentico.
2 It is recommended to start your version numbering from
1.0.0
, but there are no limitations other than the versioning needs to follow the semantic versioning. Specified extension version needs to be compatible with the latest specified Kentico version.
3 The version of the Kentico EMS with which the extension is compatible. The array is used to keep track of what Kentico versions were supported in previous extension releases. The latest Kentico version needs to be bound with the
version
property. A recommended approach is to keep a table mapping the extension version to Kentico EMS version in the readme file of the project. Use12.0.29
for Kentico 12 Service pack.
Let the community know what would be valuable for you! Maybe your desired piece of functionality is already out there.
If you have an idea for the MVC widget, MVC inline editor, MVC from component, or any other extension for Kentico EMS, feel free to submit a feature request issue, describe your extension and label it by extension-idea
.
If you release a new version of the extension, submit a pull request with an updated entry in the extensions.json
file and provide a link to the older version in the readme file of the project. We recommend incrementing the major version in version
when the major version of kenticoVersion
is incremented.