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.
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:
- Install and set custom staff and client themes.
- Set feed URLs for RSS/Atom feeds used by the Feed Reader.
- 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.
The reseller configuration file is a JSON encoded file containing a set of key/value pairs. Below is an example file.
{
"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. Expand theme object | Option | Description |
|---|
| 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. Expand admin color object Admin themes (specify for 'admin' type only)
| 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 | |
Expand client color object Client themes (specify for 'client' type only) | 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 | |
|
|
| 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. |