Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Panel
bgColor#F0F0F0

On this page:

Table of Contents


Info

Summary: This section provides information about sharing a custom extension with the wider CAST user community.

...

Click New Publication to upload your .nupkg file. If your extension conforms to the required norms it will be accepted and you then need to verify the details:

Image Removed

  • The information displayed is taken from the plugin.nuspec file (see Extension description file). Some fields are read-only, others can be modified directly. Please verify the details are correct and then scroll to bottom and:
    1. Tick the "terms and conditions" check box (marked as 1 in the image below)
    2. click to Submit (marked as 2 in the image below) to confirm the upload:
Info

Note:

  • that if any of the read-only fields are incorrect, you need to click the Cancel button to abort the upload, modify the plugin.nuspec file, recreate the .nupkg archive file and then re-upload the extension.
  • please see Configuring an icon for your extension for more information about filling in the Icon URL field.

Image Removed

:

Image Added

Once the extension has been successfully uploaded, a user with Moderation rights will need to validate the extension before it can be downloaded for use by others.

...

Image Removed

Info
Note that you can see all extensions that you have uploaded but that have not yet been validated: please see View unlisted extensions in Manage uploaded extensions.

...

You can share your extension by uploading it to the CAST Extend website using a command line utility called NuGet.exe - you can download this utility free of charge from https://dist.nuget.org/index.html. CAST recommends using a batch script to run the upload - this script should be run from outside the folder containing your extension. An example is shown below - please adapt this to your environment:

Code Block
languagetextthemeDJango
nuget.exe push com.castsoftware.uc.nameoftheextension.nupkg <apikey> -Source https://extendextendng.castsoftware.com/V2/api/V2/package


OptionDescription
nuget.exeFull path to the nuget.exe utility
pushUpload the extension

com.castsoftware.uc.nameoftheextension.nupkg

Full path to the extension in .nupkg format
<apikey>
Your unique API Key. This key uniquely identifies you as a registered user on the CAST Extend website. You can find your API
Key in your account profile. See CAST Extend website
key in you user profile in the CAST Extend website:

Image Added

-SourceThe URL of the CAST Extend website: https://extendextendng.castsoftware.com/V2/api/V2/package


Info
Note that you can view the nuget.exe push command line parameter documentation here: https://docs.nuget.org/ndocs/tools/nuget.exe-cli-reference#push

Running the batch should result in a successful upload as follows:

Code Block
languagetext
themeDJango
Pushing com.castsoftware.uc.angularjs.1.1.0.nupkg to 'https://extendextendng.castsoftware.com/V2/api/v2'...
  PUT https://extendextendng.castsoftware.com/V2/api/v2
  OK https://extendextendng.castsoftware.com/V2/api/v2 4371ms
Your package was pushed.

Once the extension has been successfully uploaded, a user with Moderation rights will need to validate the extension before it can be downloaded for use by others.

Info
Note that you can see all extensions that you have uploaded but that have not yet been validated: please see View unlisted extensions in Manage uploaded extensions.

...