Reseller Configuration

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.

Warning

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 Expand source

{
    "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"]
}

Option	Description
themes	An array of theme objects name The theme name. logo_url The URL to the logo type"admin" if this is an admin theme, "client" if this is a client theme. colors A theme color object (See table below for parameters)
feeds	An array of feed URLs. The Feed Reader will automatically pick up on these feeds and display them to the user in the Staff interface.
plugins	An array of plugins to install. Only plugins shipped with Blesta may be installed. Supply the directory name of the plugin to install.
modules	An array of modules to install. Only modules shipped with Blesta may be installed. Supply the directory name of the module to install.
gateways	An array of gateways to install. Only gateways shipped with Blesta may be installed. Supply the directory name of the gateway to install.

Admin Color Theme Object

Option	Description
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 Color Theme Object

Option	Description
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