Giter Club home page Giter Club logo

devnet.kentico.com's Introduction

Submit a New Kentico EMS Extension to DevNet

Build Status Live Stack Overflow

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.

How to qualify

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

Registering extensions

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.

Example configuration

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).
author2 string Name of the author and/or company (max. 40 characters).
sourceUrl string URL to access the extension (must use secure HTTPS).
version3 string Latest version of the extension (must follow the semantic versioning).
kenticoVersions4 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 extesnions developed by Kentico.

2 If you want your submissions to count towards the Kentico Partners program, you need to provide the company name.

3 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.

4 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. Use 12.0.29 for Kentico 12 Service pack.

Extension Ideas/Suggestions

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.

Updating extensions

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.

Analytics

devnet.kentico.com's People

Contributors

3dn-services avatar alexeyxp avatar arjanvhugten avatar chetanmistry avatar clcrutch avatar cmeeg avatar diger74 avatar dilip-sipl avatar drilic avatar dusekdan avatar giorgioluk avatar hades200082 avatar inalgiev avatar jkerbaugh avatar kenticodevtrev avatar kpacheco-wakefly avatar ladislavmargai avatar liamgold avatar marcel-rbro avatar mattnield avatar petrsvihlik avatar qubadigitaluk avatar sensorpro avatar silvertech avatar simply007 avatar swapna-rbt avatar taylorjrsmith avatar timlemke avatar vaclavk2 avatar vasu-rbt avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.