Publishing an extension

How to publish your extension into TER

We have some questions for you

First of all ask yourself some questions before publishing or even putting some effort in coding:

  • What additional benefit does your extension have for the TYPO3 community?
  • Does your extension key describe the extension? See the extension key requirements.
  • Are there any extensions in the TER yet which have the same functionalities?
    • If yes, why do we need your one? Wouldn't it be an option to contribute to other extensions?
  • Did you read and understand the TYPO3 Extension Security Policy?
  • Does your extension include or need external libraries? Watch for the license. More information about right licensing you can find here.
  • Do you have a public repository on e.g. GitHub or Bitbucket?
  • Do you have the resources to maintain this extension?
    • This means that you should
      • support users and integrators using your extension
      • review and test contributions
      • test your extension for new TYPO3 releases
      • provide and update a documentation for your extension

Use semantic versions!

We would like you to stick to semantic versions.

Given a version number MAJOR.MINOR.PATCH, increment the:

  1. MAJOR version when you make incompatible API changes (known as "breaking changes"), 
  2. MINOR version when you add functionality in a backwards-compatible manner, and
  3. PATCH version when you make backwards-compatible bug fixes.

Additional labels for pre-release and build metadata are available as extensions to the MAJOR.MINOR.PATCH format.

More you can see at https://semver.org. 

Feedback wanted!

Before you publish an extension you should be aware of what happens after it. Users and integrators will give you feedback (contributions, questions, bug reports). In this case you should have

  1. A possibility to get in contact with you (link to an issue tracker like forge, GitHub, etc.)
  2. A possibility to look into the code (link to a public repository)

You can edit these options in the extension key management (after login)

How to publish an extension

Now we come to the process of publishing. You have two possibilites to release an extension:

  1. By using the web form (click on "Publish" next to your extension key in the extension key management).
  2. By using the SOAP interface using a tool like the TYPO3 Repository Client (Documentation) or the TER client (Documentation)