Skip to main content

White Label Theme Editor

Amanda Cross
Updated

Ringba's white-label theme editor lets you control the look and feel of your partners' experience when they sign in to your Ringba account. You can use this tool to create a custom-branded portal to completely immerse clients in your brand. While editing your theme, you can preview changes throughout the entire platform in real-time.

Prerequisites

You must set up a friendly URL or custom domain to use your white-label theme. The design you create through this editor appears to users who log in through your friendly URL or custom domain.

If you haven't already set up one of these options, see one of these articles:

Using the White-Label Theme Editor

You configure your white-label theme on the Settings > White Label Settings screen. Click the Launch Theme Editor button to access the theme editor tools.

white_label_settings.png

A panel of tools appears at the bottom of the screen:

white_label_theme_tools.png

Click each button to open another panel where you can change the colors and labels on the indicated parts of the user interface.

While the theme editor is open, you can navigate your Ringba account to see how your settings affect the user experience. Some of the panels include links to preview external pages. For example, from the External Pages panel, you can preview the login, join invitation, and forgot password pages in a new browser tab.

external_pages_customization_tool.png 

To save your progress without activating the experience for your partners, click Save. Click Save and Publish to activate the theme you designed on your white-labeled portal.

Note: Your custom theme is not used in your admin account (when you sign in via the app.ringba.com subdomain). It only appears when accessing your white-labelled portal via the friendly URL or custom domain.

Theme Editor Options

The white-label theme editor tools provide everything you need to fully customize your theme.

  • Dark/Light Switch: Toggle between the dark and light versions of the theme.
  • General: Customize the background color, font color, and link font color used across most of the portal.
  • Header: Customize colors for the header background, link font, live call counter, and completed call counter.
  • Sidebar: Customize colors for the sidebar background and font, highlighted menu item background and font, and submenu background and font.
  • Widget Panel: Customize colors for the background, header background, and header title. The colors you set here affect the body of the pages.
  • External Pages: Customize colors and titles for the Login, Join Invite and Forgot Password pages.
  • Open Registration: Customize colors and titles for your publisher registration and buyer registration pages, if you use them.
  • Reset Password: Customize the background color of the Reset Password page.
  • Upload Logo: Click to upload your company logo. Dimensions must be less than 350 x 350 pixels with max file size of 80 KB.
  • Upload Favicon: Click to upload your company favicon. The file must be a PNG, GIF or ICO image. The dimensions must be 64 x 64 pixels with a max file size of 60 KB.

Once you have set all the colors and titles the way you want them, you can use the buttons on the right side of the panel:

  • Save: Save your current portal theme options.
  • Save and Publish: Save your current portal theme options and publish them to your portal. Users signing in through your friendly URL or custom domain will see the portal with your settings.
  • Reset: Reset the portal theme settings to your last saved options or back to the default Ringba theme.
  • Close: Exit the theme editor.

Live Preview White-Label Theme

To preview your white-label theme in real-time, simply navigate to any screen in the application while the theme editor is still open. You will see how your theme looks on different parts of the portal.

You can minimize the theme editor panel while navigating the application by clicking Minimize (the down arrow icon).

Tip: The dashboard, reporting screen, and call flow canvas are great places to see your white-label theme in action!

Save and Publish White-Label Theme

When you are satisfied with your white-label theme options, you can push it live by clicking Save and Publish. This updates and activates the design when partners sign in using the friendly URL or custom domain.

Important: The white-label portal may take up to 30 minutes to reflect your changes. You may not be able to publish any more changes until the update is complete.

Once complete, you can view the theme in action by logging in via your friendly URL or custom domain.

Related to

Related articles