LogoLogo
WebsiteGuide & TutorialBlogBook a Demo
2.0.0
2.0.0
  • Getting Started
  • Widget
    • Overview
    • Installation
    • Customization
      • Settings
        • Greeting
        • Greeting Introduction
        • Conversation button
        • Conversation list title
        • Launcher Text
        • Widget Appearance
      • Methods
        • Widget visibility
        • Widget window state
        • Set Customer Info
        • Get Customer info
      • Events/Callbacks
        • reloadUI
        • onChatMaximize
        • onChatMinimize
        • onChatInitiated/Started
        • onChatClosed
        • onAgentAssign
        • onAgentStateChange (Available/Unavailable)
      • Link resources
        • Share channel link
  • SDK
    • [Under Development] Overview
    • [Under Development] iOS
      • [Under Development] iOS Setup Guide
        • [Under Development] Getting Started
        • [Under Development] Integration Guide (Core)
        • [Under Development] Integration Guide (Lite)
      • [Under Development] Initialization
      • [Under Development] Theme Setting
      • [Under Development] Acquire Delegates for iOS
      • [Under Development] Widget customization
      • [Under Development] React Native
    • [Under Development] Android
      • [Under Development] Android Setup Guide
        • [Under Development] Getting Started
        • [Under Development] Integration Guide (Core)
        • [Under Development] Integration Guide (Lite)
      • [Under Development] Acquire SDK APIs
      • [Under Development] Acquire Delegates for Android
      • [Under Development] React Native
  • Webhooks
    • Introduction
    • Getting Started
    • Securing Webhook
    • Webhook Events
  • REST APIs
    • Introduction
      • Request Types, Permissions, Errors, & Limits
    • Authorization
    • Conversation
      • Cases
        • Messages
          • Retrieve a list of messages
          • Retrieve a message
          • Send a message
          • Update message
          • Delete Message
        • Case List
        • Single Case
        • Create
        • Close Case
        • Reopen Case
        • Invite Agent
      • Snooze
        • [Under Construction] Delete Snooze
        • Create Snooze
      • Notes
        • List all notes
        • Retrieve a note
        • Create
        • Add note message
        • Delete note
        • Retrieve note messages
    • Contact
      • List all contacts
      • Retrieve a contact
      • Add contact
      • Block Contact
      • Merge contact
      • Update contact
      • Delete contact
    • Company
      • List all companies
      • Retrieve a company
      • Add company
      • Update company
      • Delete company
    • Phone
      • Call in queue
      • Ringing
      • Answered
      • Call end
    • Chatbot
      • Conversational Bot
        • Groups
          • Get Default Group
          • List
          • Add
          • Delete
          • Copy
        • Question And Answer
          • List
          • Get
          • Add
          • Update
          • Delete
          • Publish
          • Bulk Action
          • Push QnA To Suggestions
          • Import QnA
      • Sequence Bot
        • Sequence List
        • Get Single Sequence
        • Add
        • Update
        • Delete
        • Bulk Action
        • Copy Existing Sequence
        • Branch
          • Get Single Branch
          • Add
          • Update
          • Delete
          • Set as Parent Branch
      • Bot resources
      • Webhooks in chatbot
    • Analytics
      • Custom Reporting
      • General Analytics
      • Chat
        • Overview
        • Tags
        • Visitor Information
          • Visitor Analytics
          • Visitor Source Overview
        • Video Analytics
      • Cobrowse
      • Chatbot
        • Sequence Bot
        • Conversational Bot
      • Knowledge Base
      • Email
      • VoIP - Call SMS
      • Agent Performance
    • [Under Construction] Custom Cards
      • Timeline-cards
        • Create Interaction Card
        • Update Interaction Card
        • List all Cards
        • Retrieve a card
        • Delete card
      • Exclusive cards
        • Create general card
        • Create app card - from other system
        • Delete card
    • Knowledge Base
      • Groups
        • Add
        • Update
        • Get
        • Get Single
        • Delete
      • Articles
        • Add Article
        • Update Article
        • Delete Article
        • Get Articles
        • Get Single Article
      • Category
        • Add Category
        • Update Category
        • Delete Category
        • Get Category
    • Settings
      • Account Settings
        • Users
          • List
          • Get Single
          • Add
          • Update
          • Delete
        • Roles
          • List
          • Get Single Role
          • Add
          • Update
          • Delete
        • Departments
          • List
          • Get
          • Add
          • Update
          • Delete
        • Custom Attributes
          • List of custom attributes
          • Get a custom Attribute
          • Add a custom attribute
          • Update a custom attribute
          • Delete a custom attribute
      • Conversation Settings
        • Shortcuts
          • List Groups
          • Get
          • Add
          • Update
          • Delete
        • Tags
          • List All Tags
          • Get Single Tag
          • Add New Tag
          • Update Tag
          • Delete Tag
        • Feedback
          • List of all feedback
          • Get single feedback
          • Add feedback
          • Update Feedback
          • Delete feedback
      • Security
        • Block Visitor
          • List
          • Get
          • Add
          • Delete
        • Audit Logs
          • Audit Log
          • Audit Log Users
Powered by GitBook
On this page
  • Theme Settings
  • Introduction
  • Theme Settings
  1. SDK
  2. [Under Development] iOS

[Under Development] Theme Setting

Our SDK is currently under review. Check back later for updates.

Theme Settings

Using UIAppearance

UIAppearance customizations are applied to AcquireIOSupport SDK by default. However if there is a conflicting property, then the value in ThemeOptions key in AcquireIOConfig will take precedence.

For example: If the app uses UIAppearance to change the color of Navigation Bar title and also specifies a color for the same property in the AcquireIOConfig ThemeOptions - NSDictionary, then the value in dictionary will be used.

In order to use the UIAppearance value, the app must leave the corresponding entry in the ThemeOptions blank.

Introduction

Head over to Theming if you want to customize your SDK integration's typeface, colors or fonts. It can be achieved via simple key-value pairs in option dictionary.

Configuration

Theme customization can be configured via AcquireIOConfig class:

let options = [String : Any]()
let config = AcquireIOConfig.config
config.setDict(options)

//Pass `config` to- setAccount: withOptions:config

Set Dictionary options in format of key-value. Color code will be hex value of color, start from #. You can remove and leave blank for default theme effect.

Sample format for setting Config options:

let themeDict = [
                  "ACQUIREIO_GLOBAL": [
                      "THEME_COLOR":"#ff87b8"
                  ],
                  "ACQUIREIO_NAVIGATION_BAR": [
                      "BAR_STYLE": "UIBarStyleBlack",
                      "BAR_TINTCOLOR": "#ff87b8",
                      "TINT_COLOR": "#FFFFFF"
                  ],
                  "ACQUIREIO_BADGE_VIEW": [
                      "BACKGROUND_COLOR": "#ff0000",
                      "BORDER_COLOR": "#FE0319",
                      "TEXT_COLOR": "#ff0000"
                  ],
                  
                  "ACQUIREIO_SYSTEM_BUTTON": [
                      "BACKGROUND_COLOR": "#ff0000",
                      "BUTTON_INSET_BOTTOM": NSNumber(value: 100),
                      "BUTTON_INSET_RIGHT": NSNumber(value: 90)
                  ]
                ]

 let option = [ ...
                "ThemeOptions": themeDict
              ]

Config Options

Along with Theme settings, SDK supports following optional customization options.

 let option = [
                "ThemeOptions": themeDict,
                "ShowVideoButton": true,
                "ShowAudioButton": true,
                "ShowChatButton": true,            
                "isHideNewChat": false,
                "SessionConnectAndStartAuto": true,
                "disableAttachment": false,
                "ShowThreadList": true,
                "ButtonImageName": "chat.png",
                "ShowLocalNotificationInApp": true,
                "DisableNetworkMessage": false ] as [String : Any]
  • ShowVideoButton : To show video call button in top bar of visitor's main chat messages screen. Default value is set to true.

  • ShowAudioButton : To show audio call button in top bar of visitor's main chat messages screen. Default value is set to true.

  • ShowChatButton : To hide support system button on bottom right of screen , set to false and it will hide the button but chat functionality will not be affected by this option. Default value set to true.

  • isHideNewChat : if set to true, user won't be able to start new chat with agents. if set to false, user can start new chat with agents. Default value set to false.

  • SessionConnectAndStartAuto : Session will be automatically connected to server and start, no need to invoke any additional method for start session. If you set false, then you must call AcquireIO.support.startSession() method to start new connection with server. Default value is set to true.

  • disableAttachment : To disable uploading attachment to agents. Default value is set to false.

  • ShowThreadList : To show list of sessions/threads. Default value is set to true.

  • ButtonImageName : To set an Image for AcquireIOsupport chat system button. Custom Image should be put in main bundle of app. Image size 30x30 px, 60x60 px for @2x.

  • ShowLocalNotificationInApp : To allow SDK to show in-app notification when app state is Active. Default value is true.

  • DisableNetworkMessage : To disable showing “Please Check Internet Connection” message when there is no internet connectivity. Default value is set to false, which mean SDK will show this message if not specified in config options.

Theme Settings

To skin your app, make sure you add AcquireIOConfig ThemeOptions key.

  • Colors are specified in hexadecimal format, e.g. #FFFFFF is White. # is required before code.

  • Font names should be specified by their family name & style. For example, CaviareDreams-Bold refers to Caviare Dreams family of bold style. See using custom fonts section below for more details.

Global Attribute

These attributes control the looks of in-app support over many screens.

Property

Description

THEME_COLOR

Applies theme color to whole support SDK according to your app theme. Default theme color is #3A6

FONT_NAME

Global font face - applies to texts for sections list, Chat list, Offline form and all. Default font is system font with size according to requirements

BOLD_FONT_NAME

Applies to headers on chat screen and title of pages. Default font is system bold font with size according to requirement

Navigation Bar

Property

Description

BAR_STYLE

Use UIBarStyleBlack or UIBarStyleDefault. Default bar style is UIBarStyleDefault

BAR_TINTCOLOR

The tint color to apply to the navigation bar background. This color is not made translucent by default unless you set the isTranslucent property to true. Default BAR_TINTCOLOR is #FFFFFF

TINT_COLOR

The tint color is navigation title and back and other bar button items color. Default color is #000000

System Button Attributes

These attributes applies on default bottom right support button.

Property

Description

BACKGROUND_COLOR

Applies to background color of button. Default theme color is THEME_COLOR

BUTTON_INSET_BOTTOM

Inset button from bottom in NSNumber. default bottom inset is 0.

BUTTON_INSET_RIGHT

Inset button from right in NSNumber. default right inset is 0.

System Badge Button Attributes

These attributes applies on default bottom right support button notification badge.

Property

Description

BACKGROUND_COLOR

Applies to background color of button badge. Default color is red

BORDER_COLOR

Applies border to the badge button

TEXT_COLOR

Button badge color. Default color is #ffffff.

Using Custom Fonts

Step 1. Add the font to your project. Edit your app's plist file and add a key "Fonts provided by application" to it. Under the key, list out file names of all the fonts you want to use in your app and in support. If you've already listed such fonts, skip this step.

Step 2. Copy the font's full name. To do this, select the font in Finder and hit COMMAND ⌘+I (Get Info).

Step 3. Paste the font name into

Set AcquireIOConfig with @"ThemeOptions" -> @"ACQUIREIO_GLOBAL" ->@"FONT_NAME"" , wherever necessary

Previous[Under Development] InitializationNext[Under Development] Acquire Delegates for iOS

Last updated 3 years ago

Add Custom Fonts
Get full Name of the font
Add custom font in your themeOptions