Kickstarter¶

The fastest way to start your TYPO3 RestApi project¶

The backend-module of nnrestapi offers “Kickstarter” templates, which you can customize and download with a single click.

The idea was to create a helper similar to the TYPO3 “Extension Builder”: You can define the vendor- and extension-name, click “export” to download the customized extension and then install it as a starting point for your own TYPO3 Restful Api extension development.

Creating own kickstarter templates¶

You can add your own “Kickstarter”-templates to the backend module. It would be great to add as many examples and templates as possible in the future, e.g. for a frontend in VueJS, React or Angular.

So: Please, please… if you are developing an application that connects to the TYPO3 Rest Api and are using technologies like Swift, Kotlin, VueJS, React, Angular or other frameworks: Consider sharing your knowledge and contribute a “Kickstarter”-template for the community to reduce development time and get started faster.

Creating your own kickstarter-templates is extremely simple:

Build something

Create a web app, app, plugin, extension, pwa or whatever - in the language and framework you prefer working in. Make it connect to the TYPO3 Rest Api.

Make your code customizable

If necessary, replace keywords like the vendor name, extension name etc. with the following placeholders. The kickstarter will automatically replace the placeholders with the custom variable set kickstarter form of the backend module:

You can use the placeholders in the code and your filenames:

placeholder	example	description
[#ext-ucc#]	MyExtension	The UpperCamelCase version von the extension name
[#ext-lower#]	my_extension	The lower_underscore version of the extension name
[#vendor-ucc#]	Company	The UpperCamelCase version of the vendor name
[#vendor-lower#]	company	The lower_underscore version of the vendor name

You can use these placeholders in your PHP, JavaScript or any other code – and even the filename.

Let’s imagine, the user enters Acme as a vendor-name and Foobar as extension-name. If the user exports an kickstarter-template and your PHP code looks like this:

<?php

namespace [#vendor-ucc#]\[#ext-ucc#]\Domain\Model;

class Thing extends \[#vendor-ucc#]\[#ext-ucc#]\AbstractSomeThing
{
    ...
}

Then he will get this result in the downloaded zip-file:

<?php

namespace Acme\Foobar\Domain\Model;

class Thing extends \Acme\Foobar\AbstractSomeThing
{
    ...
}

If you don’t want to modify your code, but still want certain parts of the code to be customizable, you can also define a list of replacements in the TypoScript settings. Here is an example for the “VeryBasic” kickstarter template:

plugin.tx_nnrestapi.settings.kickstarts {
    verybasic {
        ...
        replace {
            nng/apitest = [#vendor-lower#]/[#ext-lower#]
            Nng\\Apitest\\ = [#vendor-ucc#]\\[#ext-ucc#]\\
            Nng\Apitest\ = [#vendor-ucc#]\[#ext-ucc#]\
            # Special characters in the key can be encoded with \x-syntax and the hexcode
            \x22apitest\x22 = "[#ext-lower#]"
        }
    }
}

ZIP it

Create a zip-archive of your project that has all folders and files needed to get started. Don’t include libraries that get loaded during the installation-process, e.g. the node_modules folder if you are working in VueJS.

Register your kickstarter template

To make the template available in the backend module, register the path to your zip or folder.

Note: The zip must be somewhere inside the an extension folder - or the fileadmin.

plugin.tx_nnrestapi.settings.kickstarts {
    mytemplate {
        title = The title
        icon = fas fa-box
        description = The description goes here
        path = EXT:yourext/Resources/Private/Kickstarts/yourpackage.zip
        replace {
            some_custom_placeholder = [#vendor-lower#]_[#ext-lower#]_sometext
        }
    }
}