Table of Contents

Blesta supports the ability for resellers to customize data specific to their users' installations through the use of a special configuration file. This allows resellers the ability to brand the experience for their customers, as well as provide additional information (through RSS/Atom Feeds) targeted for those users.

Reseller configurations are only available to Value Added Resellers, whose license keys begin with var-.

How It Works

After a user installs Blesta they enter their license key. If the license key begins with var-, the installation makes a request to our license server to fetch a config file specific to the reseller that issued the license. If the config file exists, the installation will process the config.

Configuration Capabilities

Configuration files have the ability to:

  1. Install and set custom staff and client themes.
  2. Set feed URLs for RSS/Atom feeds used by the Feed Reader.
  3. Install Plugins, Modules, and Gateways.

Submitting a Configuration

To submit your reseller configuration file email sales and include it as an attachment. We'll review the file to ensure proper formatting and add it our license server.

Configuration Format

The reseller configuration file is a JSON encoded file containing a set of key/value pairs. Below is an example file.

Example Config
{
    "themes": [
        {
            "name": "VAR Theme Name",
            "logo_url": "//www.site.com/assets/logo.png",
            "type": "admin",
            "colors": {
                "theme_header_bg_color_top": "0074b2",
                "theme_header_bg_color_bottom": "6dafd3",
                "theme_header_text_color": "e4e4e4",
                "theme_navigation_background_color_top": "5a5d63",
                "theme_navigation_background_color_bottom": "42444a",
                "theme_navigation_text_color": "afafaf",
                "theme_navigation_text_hover_color": "ffffff",
                "theme_subnavigation_bg_color_top": "222326",
                "theme_subnavigation_bg_color_bottom": "333439",
                "theme_subnavigation_text_color": "afafaf",
                "theme_subnavigation_text_active_color": "d8d8d8",
                "theme_widget_heading_bg_color_top": "6dafd3",
                "theme_widget_heading_bg_color_bottom": "0074b2",
                "theme_widget_icon_heading_bg_color_top": "137eb8",
                "theme_widget_icon_heading_bg_color_bottom": "56a4cc",
                "theme_box_text_color": "ffffff",
                "theme_text_shadow": "779999",
                "theme_actions_text_color": "0075b2",
                "theme_highlight_bg_color": "ecf7ff"
            }
        },
        {
            "name": "VAR Theme Name",
            "logo_url": "//www.site.com/assets/logo.png",
            "type": "client",
            "colors": {
                "theme_header_bg_color_top": "0074b2",
                "theme_header_bg_color_bottom": "6fb1d4",
                "theme_page_title_background_color_top": "222326",
                "theme_page_title_background_color_bottom": "34353a",
                "theme_page_title_text_color": "ffffff",
                "theme_page_title_button_background_color_top": "1d1e20",
                "theme_page_title_button_background_color_bottom": "2b2c30",
                "theme_navigation_background_color_top": "222326",
                "theme_navigation_background_color_bottom": "34353a",
                "theme_navigation_text_color": "b7b7b7",
                "theme_navigation_text_active_color": "ffffff",
                "theme_page_background_color": "f8f8f8",
                "theme_link_color": "0074b2",
                "theme_link_settings_color": "8cc24a"
            }
        }
    ],
    "feeds": ["http://www.url1.com", "https://www.url2.com"],
    "plugins": ["shared_login"],
    "modules": ["cpanel","enom"],
    "gateways": ["paypal_payments_standard"]
}
OptionDescription
themes

An array of theme objects.

OptionDescription
nameThe theme name.
logo_url

The URL to the logo.

Use HTTPS or protocol-relative URLS to ensure compatibility with both HTTP and HTTPS.

type
  • admin If this is an admin theme
  • client If this is a client theme
colors

A theme color object.

Admin themes (specify for 'admin' type only)

OptionDescription
theme_header_bg_color_top 
theme_header_bg_color_bottom 
theme_header_text_color 
theme_navigation_background_color_top 
theme_navigation_background_color_bottom 
theme_navigation_text_color 
theme_navigation_text_hover_color 
theme_subnavigation_bg_color_top 
theme_subnavigation_bg_color_bottom 
theme_subnavigation_text_color 
theme_subnavigation_text_active_color 
theme_widget_heading_bg_color_top 
theme_widget_heading_bg_color_bottom 
theme_widget_icon_heading_bg_color_top 
theme_widget_icon_heading_bg_color_bottom 
theme_box_text_color 
theme_text_shadow 
theme_actions_text_color 
theme_highlight_bg_color 

Client themes (specify for 'client' type only)

OptionDescription
theme_header_bg_color_top 
theme_header_bg_color_bottom 
theme_page_title_background_color_top 
theme_page_title_background_color_bottom 
theme_page_title_text_color 
theme_page_title_button_background_color_top 
theme_page_title_button_background_color_bottom 
theme_navigation_background_color_top 
theme_navigation_background_color_bottom 
theme_navigation_text_color 
theme_navigation_text_active_color 
theme_page_background_color 
theme_link_color 
theme_link_settings_color 
feedsAn array of feed URLs. The Feed Reader will automatically pick up on these feeds and display them to the user in the Staff interface.
pluginsAn array of plugins to install. Only plugins shipped with Blesta may be installed. Supply the directory name of the plugin to install.
modulesAn array of modules to install. Only modules shipped with Blesta may be installed. Supply the directory name of the module to install.
gatewaysAn array of gateways to install. Only gateways shipped with Blesta may be installed. Supply the directory name of the gateway to install.
  • No labels