Creating Adobe Launch Extension : Global Configuration

In order to create the extension there are (usually) 2 things that you would like to setup in order to make the information working properly.

The 2 elements are the Extension JSON file that is in the root of your extension folder and the HTML layout of your Extension. We will review those 2 elements and how they are playing a part on the creation.

Extension.json

The Extension JSON file is the configuration file that tells the Launch system how this extension is being built. It will contain all of the information required for the extension to work.

You can modify this configuration file yourself and add (or remove) any information that you wish. It should have been pre-filled with the information that you have entered when using the scaffold module. (see the related article)

Based on that file, the Launch engine will define what type of module is contained in your extension and if there has been any update between 2 upload of your extension. You can also define the name of your extension name there. The name that you have used during the scaffold can be changed as long as you never imported your extension. After that, it would create a new extension.

Here is the global file configuration

Notice the displayName and the current name, they are different, as your name should not have any space. I also pre-fixed the name of my extension with “mycompany”. It is recommended to proceed so, as each name in the Launch extension catalog has to be unique, even for privately released extension. Therefore, in order to be on the safe side, using your company name should make sure that no one is already using your name.

The following elements are the one defining the modules you would like to include.
In my case it normally looks like :

The only difference comes when you want to include more than one option in your module type.
In my following example, I will create 2 Data Elements, therefore, it will look like this :

More information about this manifest :
https://developer.adobelaunch.com/extensions/reference/extension-manifest/

Extension HTML

On top of this extension manifest, that you will need to configure. You have the possibility to give user some level of customization on your extension. This is done in the Extension Configuration HTML file.

It is usually where the user can set its account id or to provide any sort of information that is required for your extension to work.
It can also be that your user doesn’t have any information to provide. It is not mandatory to have a configuration view.

In my extension example below, I would set some basic information that I want my user to define.

I hope that this article helped you to understand how to globally configured the extension.

In this series of articles, you may want to look at these articles :

ArticleContent
Introdcution to Adobe Launch & Extension Creation This posts covers the basic of what you need to know in order to start with this series of articles.
Architecture and dependencies within modules This posts covers the architectures and how the different modules are linked between each others
Global Extension Configuration This article explains how to set up your configuration HTML file. It is the core configuration module of your extension.
Event type module This article will show you how to build an event module. Every module will have a configuration part (HTML) and wrapper(JS).
Condition module
This article will show you how to build a condition module.
Action module This post will be related to the action module and how to build it. We will also see how you can actually import some cool feature of the launch library.
Data Element moduleThis article will be developing the possibilities of the Data Element module
Shared moduleThis article will focus on the shared functionality that you can write and share with other extension developpers to used. We will also used a feature shared from Adobe Analytics to show you how to use it.
Other featuresThe other features that are related to Launch Extension. I will cover additional (and important) information there.
Testing your extensionHow do I debug my Extension ?
Releasing and updating your ExtensionHow do I publish my Extension into Launch ? And after, how do you update it ?

Leave a Reply

Your email address will not be published. Required fields are marked *