Enter the playground! Discover how to use the Settings API to customize your app :)

Written by Dumè Siacci on Wednesday 8 January 2014

Today, we're going to have a look to some deep features that you can use to customize your app a lot more! It can be a little technical to manage, but that's worth it.

You may have noticed a section of the backoffice called Settings API. Trust me, that's where the best features are hidden ;)

Looking for a complete guide? Check out the tutorial "How to make an app "!

What's the Settings API exactly?

The Settings API allows you to access several settings that are not available in the GoodBarber backend.

You can access the Settings API in the Design > Developer menu. It's an option, billed 4€/month or 40€/year (or $ depending on your country). Of course, you can test the option for free during 15 days before purchasing it.

The full documentation of the attributes that can be modified using the Settings API is available in the Help Center > Developers > JSON Formats menu.

Here are some examples of modifications that can be done using the Settings API.

All the examples below are made on a single section: if you want to apply the modifications to several sections, you need to repeat the operation on each section.

Enable the "Save to library" option in Photo sections

This features allows your users to save a picture from a Photo section into their phone's library, with a long tap on the picture in the detail page of the section.

To enable this option, you need to set the sections/[]/saveImgEnabled to 1 in the Settings API. If the attribute doesn't exist, you need to add it.

Change the detail page display in Article and Video sections

You can modify the layout of the detail page in the Article or the Video section by modifying the sections/[]/detail/htmlTemplate attribute. If it doesn't exist, the default setting will be used. Add a new attribute to override the default setting.

This attribute works with tokens (available tokens are listed below).

Example: if you want to remove the author's name into the detail page, you need to be sure that the [AUTHOR] token is removed from the htmlTemplate.

Template for Article sections:

Template for Video sections:

Modify the tokens used in list of articles or videos

If you want to display another information, as subtitles, into the lists of content (by default it's "Author on Date"), you can modify the sections/[]/infosContentType attribute.

As usual, it works with tokens.

Example: in this video, I remove the author's name, and I choose to use another date formatting.