How to customize the ASAP SDK Help WIdget UI?

How to customize the ASAP SDK Help Widget UI?

The ASAP SDK allows you to customize the UI of the help widget as required.

Predefined themes

The SDK UI comes with two predefined themes: white and black. The following methods help you apply these themes.



If you want to change the theme, first include the following import statement, which imports the ZohoDeskPortalConfiguration.

Swift

  1. import ZohoDeskPortalConfiguration

Objective-C

  1. @import ZohoDeskPortalConfiguration;

Methods for applying the default theme (white)

Swift

  1. ZDPThemeManager.setTheme(type: .light)

Objective-C

  1. [ZDPThemeManager setThemeWithType:ZDPThemeTypeLight];

Methods for applying the black theme 

Swift

  1. ZDPThemeManager.setTheme(type: .dark)

Objective-C

  1. [ZDPThemeManager setThemeWithType:ZDPThemeTypeDark];
Versions of iOS 13 and up allow users to set dark or light themes throughout the system. You can set the system theme for iOS 13 and apply it to the ASAP Help Widget. The help widget will be in the same theme as the OS in such cases.

Swift

  1. ZDPThemeManager.setTheme(type: .system)

Objective-C

  1. [ZDPThemeManager setThemeWithType:ZDPThemeTypeSystem];
    •    ZDPThemeType.system is available only for iOS 13 and above.
    •    By default, the system theme will be applied for iOS 13 and above, and the light theme will be applied for earlier versions.

Customized themes 

You can also override the default dark and light themes to make the SDK look more like your application.



To update the default light theme:

Swift

  1. ZDPThemeManager.updateLightTheme(theme: <#ZDPThemeProtocol#>)

Objective-C

  1. [ZDPThemeManager updateLightThemeWithTheme:<#ZDPThemeProtocol#>];

To update the default dark theme:

Swift

  1. ZDPThemeManager.updateDarkTheme(theme: <#ZDPThemeProtocol#>)

Objective-C

  1. [ZDPThemeManager updateDarkThemeWithTheme:<#ZDPThemeProtocol#>];

Here, ZDPThemeProtocol contains the properties representing the most used colours across the SDK, such as primaryTextColor and navigationBarTextColor. All properties in the protocol are optional. You can create any class conforming to this protocol, implement one or more properties, and pass an object of that class to the updateLightTheme or updateDarkTheme method. The colours you set in the class will override the default theme.
Updating the SDK's theme is different from setting a theme type. Depending on the theme type you have set, the SDK will always be in a dark or light theme.

Using custom fonts 

The SDK UI offers a set of default fonts, but you can use fonts of your choice if you need to.

To be able to display custom fonts on the SDK UI, perform these steps:
    1.    Add the fonts to your project.
    2.    Edit the info.pilst Your app's list file should include the fonts provided by the application key.
    3.    Under this key, list the file names of all the fonts you want to use in the SDK UI.



After adding the fonts to your project, you can customize the SDK UI to display text in that font.

To display the custom font on your SDK UI, include the following method in your app code:

Swift

  1. ZDPortalConfiguration.customFontName = <#String#>

Objective-C

  1. ZDPortalConfiguration.customFontName = <#NSString#>;

The help widget displays the system font by default if you do not use a custom font. We have made the font sizes accessible since version 2.0. However, accessibility for custom fonts is supported only for iOS 11 and above.

    Zoho CRM Training Programs

    Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.

    Zoho CRM Training
      Redefine the way you work
      with Zoho Workplace

        Zoho DataPrep Personalized Demo

        If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.

        Zoho CRM Training

          Create, share, and deliver

          beautiful slides from anywhere.

          Get Started Now


            Zoho Sign now offers specialized one-on-one training for both administrators and developers.

            BOOK A SESSION











                                        You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.




                                            Manage your brands on social media

                                              Zoho Desk Resources

                                              • Desk Community Learning Series


                                              • Digest


                                              • Functions


                                              • Meetups


                                              • Kbase


                                              • Resources


                                              • Glossary


                                              • Desk Marketplace


                                              • MVP Corner


                                              • Word of the Day


                                                Zoho Marketing Automation

                                                  Zoho Sheet Resources

                                                   

                                                      Zoho Forms Resources


                                                        Secure your business
                                                        communication with Zoho Mail


                                                        Mail on the move with
                                                        Zoho Mail mobile application

                                                          Stay on top of your schedule
                                                          at all times


                                                          Carry your calendar with you
                                                          Anytime, anywhere




                                                                Zoho Sign Resources

                                                                  Sign, Paperless!

                                                                  Sign and send business documents on the go!

                                                                  Get Started Now




                                                                          Zoho TeamInbox Resources



                                                                                  Zoho DataPrep Resources



                                                                                    Zoho DataPrep Demo

                                                                                    Get a personalized demo or POC

                                                                                    REGISTER NOW


                                                                                      Design. Discuss. Deliver.

                                                                                      Create visually engaging stories with Zoho Show.

                                                                                      Get Started Now









                                                                                                          • Related Articles

                                                                                                          • How to customize the ASAP SDK Help Widget UI?

                                                                                                            The ASAP SDK allows you to customize the UI of the help widget as required. Predefined themes The SDK UI comes with two predefined themes: light and dark. Android iOS Setting up a theme type You can customize the theme type in the SDK help widget ...
                                                                                                          • How to customize the ASAP SDK Help Widget UI?

                                                                                                            The ASAP SDK allows you to customize the UI of the help widget as required. Predefined themes The SDK UI comes with two predefined themes: light and dark. Customized themes You can also override the default dark and light themes to make the SDK look ...
                                                                                                          • Introducing ASAP iOS SDK

                                                                                                            Equipping the Help Center services as widgets to deliver instant assistance to your customers The ASAP SDK for iOS provides easy access to help your iOS app's end users. Using this SDK, you can create and customize a help widget within your app and ...
                                                                                                          • How to change your language settings for ASAP Android SDK?

                                                                                                            The ASAP SDK supports 47 languages. You can set any language of your choice based on the geographical location of your app's end-users. Below are the 47 language codes that help you set the language for the ASAP help widget. Language Local Code ...
                                                                                                          • How to change your language settings for ASAP iOS SDK?

                                                                                                            The ASAP SDK supports 47 languages. You can set any language of your choice based on the geographical location of your app's end-users. Below are the 47 language codes that help you set the language for the ASAP help widget. Language Local Code ...
                                                                                                            Wherever you are is as good as
                                                                                                            your workplace

                                                                                                              Resources

                                                                                                              Videos

                                                                                                              Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                                                                                              eBooks

                                                                                                              Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                                                                                              Webinars

                                                                                                              Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                                                                                              CRM Tips

                                                                                                              Make the most of Zoho CRM with these useful tips.



                                                                                                                Zoho Show Resources