Skip to content

Latest commit

 

History

History
1754 lines (1059 loc) · 49.1 KB

Customization.md

File metadata and controls

1754 lines (1059 loc) · 49.1 KB
Raw

Engage Digital Messaging Customization

Engage Digital Messaging is customizable either from Android resource folder (XML) or programmatically

This file shows a list of attributes you can override in order to customize the threads list and the chat.

Attributes < string />

Notification Channel Name

Name of the notification Channel (android_version >= 26).

Xml attribute name: dimelo_notification_channel_name

Programmatically: None

Default: Application name

Attributes < bool />

Toolbar Title display

Specify if the title of the toolbar must be displayed (ChatActivity only).

Xml attribute name: dimelo_toolbar_display_title

Programmatically: None

Attributes < drawable />

videoCallRequestButtonImage

A drawable used to represent the button to request a video call.

Xml attribute name: None

Programmatically: use Customization.setVideoCallRequestButtonImage method

scrollToBottomImage

A drawable used to represent the button to scroll to the bottom of the conversation.

Xml attribute name: None

Programmatically: use Customization.setScrollToBottomImage method

createNewThreadImage

A drawable for the create new conversation button.

Xml attribute name: None

Programmatically: use Customization.setCreateNewThreadImage method

backToAllChatsImage

A drawable to replace the arrow displayed next to the "Back to all chats" text displayed in the header.

Xml attribute name: None

Programmatically: use Customization.setBackToAllChatsImage method

lockedThreadImage

A drawable to indicate that the thread is locked in the threads list view.

Xml attribute name: None

Programmatically: use Customization.setLockedThreadImage method

Toolbar Navigation Icon drawable

Specify a drawable to use for the navigation icon of the toolbar (ChatActivity only).

Xml attribute name: dimelo_navigation_icon

Programmatically: None

Toolbar Background drawable

Specify a drawable to use for the toolbar (ChatActivity only). The drawable can be tinted with dimelo_toolbar_background_drawable_tint.

Xml attribute name: dimelo_toolbar_background_drawable

Programmatically: None

Open gallery drawable icon

Specify a drawable to use for the open gallery icon.

Programmatically: use Customization.setOpenGalleryIcon method

webViewCloseButtonIcon

Drawable used to represent the webView "close" button that is displayed in the header.

Programmatically: use Customization.setWebViewCloseButtonIcon method

webViewPreviousButtonIcon

Drawable used to represent the webView "previous" button that is displayed in the header.

Programmatically: use Customization.setWebViewPreviousButtonIcon method

webViewNextButtonIcon

Drawable used to represent the webView "next" button that is displayed in the header.

Programmatically: use Customization.setWebViewNextButtonIcon method

Attributes < color />

closedThreadMessageTextColor

Color applied to the message that is displayed when the thread is closed.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_closed_thread_message_text_color

Programmatically: set Customization.closedThreadMessageTextColor property.

videoCallRequestButtonTintColor

Color applied to the video call request button.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_video_call_request_button_tint_color

Programmatically: set Customization.videoCallRequestButtonTintColor property.

scrollToBottomBackgroundColor

Color applied to the background of the button to scroll to the bottom of the conversation.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_down_scroll_background_color

Programmatically: set Customization.scrollToBottomBackgroundColor property.

scrollToBottomImageColor

Color applied to the button to scroll to the bottom of the conversation.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_scroll_down_image_color

Programmatically: set Customization.scrollToBottomImageColor property.

deletedMessageBackgroundColor

Color applied to the background of a message that was deleted by its author.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_deleted_message_background_color

Programmatically: set Customization.deletedMessageBackgroundColor property.

deletedMessageTextColor

Color applied to the text of a message that was deleted by its author.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_deleted_message_text_color

Programmatically: set Customization.deletedMessageTextColor property.

selectedMessageCellBackgroundColor

Color applied to the background of a selected message's cell.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_selected_message_cell_background_color

Programmatically: set Customization.selectedMessageCellBackgroundColor property.

videoCallRequestedStatusMessageTextColor

Color applied to the status message text when a video call is requested.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_video_call_requested_status_message_text_color

Programmatically: set Customization.videoCallRequestedStatusMessageTextColor property.

threadsListCompanyMessageBackgroundColor

Background color of the company message displayed in the threads list.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_threads_list_company_message_background_color

Programmatically: set Customization.threadsListCompanyMessageBackgroundColor property.

threadsListCompanyMessageTitleTextColor

Text color applied to the title of the company message that is displayed in the threads list.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_threads_list_company_message_title_text_color

Programmatically: set Customization.threadsListCompanyMessageTitleTextColor property.

threadsListCompanyMessageSubtitleTextColor

Text color applied to the subtitle of the company message that is displayed in the threads list.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_threads_list_company_message_subtitle_text_color

Programmatically: set Customization.threadsListCompanyMessageSubtitleTextColor property.

webViewProgressBarColor

Color applied to the horizontal and the circular progress bar that is displayed in the webView when the page is loading or when internet is down.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_web_view_progress_bar_color

Programmatically: set Customization.webViewProgressBarColor property.

webViewTitleTextColor

Color applied to the webView title.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_web_view_title_text_color

Programmatically: set Customization.webViewTitleTextColor property.

webViewNextPreviousButtonIconDisabledColor

Color applied to the disabled webView "previous" and "next" image.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_web_view_next_previous_button_icon_disabled_color

Programmatically: set Customization.webViewNextPreviousButtonIconDisabledColor property.

webViewNextPreviousButtonIconEnabledColor

Color applied to the enabled webView "previous" and "next" image.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_web_view_next_previous_button_icon_enabled_color

Programmatically: set Customization.webViewNextPreviousButtonIconEnabledColor property.

webViewHeaderBackgroundColor

Color applied to the webView header background.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_web_view_Header_background_color

Programmatically: set Customization.webViewHeaderBackgroundColor property.

webViewBodyBackgroundColor

Color applied to the webView body background.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_web_view_body_background_color

Programmatically: set Customization.webViewBodyBackgroundColor property.

badgeTextColor

Text color for the badge text view.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_badge_text_color

Programmatically: set Customization.badgeTextColor property.

badgeBackgroundColor

Background color for the badge text view.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_badge_background_color

Programmatically: set Customization.badgeBackgroundColor property.

createNewThreadImageColor

Color for the create new thread image.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_create_new_thread_image_color

Programmatically: set Customization.createNewThreadImageColor property.

threadsListSeparatorColor

Color for the threads list separator.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_threads_list_separator_color

Programmatically: set Customization.threadsListSeparatorColor property.

lockedThreadImageTintColor

Tint color for the locked thread image in the threads list view.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_locked_thread_image_tint_color

Programmatically: set Customization.lockedThreadImageTintColor property.

threadsListRefreshControlTintColors

Tint colors array for the threads list refresh control.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: None

Programmatically: set Customization.threadsListRefreshControlTintColors property.

createNewThreadBackgroundColor

Background color for the create new conversation button.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_create_new_thread_background_color

Programmatically: set Customization.createNewThreadBackgroundColor property.

threadsListBackgroundColorSelection

Background color for the threads list selected item.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_threads_list_background_color_selection

Programmatically: set Customization.threadsListBackgroundColorSelection property.

threadsListAgentNameTextColor

Text color for the agent name displayed in the threads list.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_threads_list_agent_name_text_color

Programmatically: set Customization.threadsListAgentNameTextColor property.

threadsListMessageTextColor

Text color for the message displayed in the threads list.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_threads_list_message_text_color

Programmatically: set Customization.threadsListMessageTextColor property.

threadsListDateTextColor

Text color for the date displayed in the threads list.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_threads_list_date_text_color

Programmatically: set Customization.threadsListDateTextColor property.

fragmentHeaderColor

Color for the fragment header.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_fragment_header_color

Programmatically: set Customization.fragmentHeaderColor property.

Toolbar Background drawable tint

Specify a tint for the drawable used as a background for the toolbar (ChatActivity only).

Xml attribute name: dimelo_toolbar_background_drawable_tint

Programmatically: None

Toolbar Background color

Background color of toolbar (ChatActivity only).

Xml attribute name: dimelo_toolbar_background_color

Programmatically: None

InputBar background color

Background color for the input bar.

Color must be in hex format, e.g. #007AFF. Xml attribute name: dimelo_inputbar_background_color

Programmatically: set Customization.inputbarBackgroundColor property

webViewCloseButtonIconColor

Color applied to the webView "close" image.

If not specified, white color is applied

Color must be in hex format, e.g. #007AFF

Xml attribute name: rc_web_view_close_button_icon_color

Programmatically: set Customization.webViewCloseButtonIconColor property.

Open gallery icon color

Define the icon color of the open gallery button.

If not specified, white color is applied

Color must be in hex format, e.g. #007AFF

Xml attribute name: rc_open_gallery_icon_color

Programmatically: set Customization.openGalleryIconColor property.

Open gallery background color

Define the background color of the open gallery button.

If not specified, #4481EB color is applied

Color must be in hex format, e.g. #007AFF

Xml attribute name: rc_open_gallery_background_color

Programmatically: set Customization.openGalleryBackgroundColor property.

Send Button enabled color

Define the color of the send button when a message can be sent.

If not specified, main theme color is applied

Color must be in hex format, e.g. #007AFF

Xml attribute name: dimelo_send_button_enabled_color

Programmatically: use Customization.setSendButtonEnabledColor method

Send Button disabled color

Define the color the send button when no text is written and no attachment is selected.

Color must be in hex format, e.g. #007AFF

Xml attribute name: dimelo_send_button_disabled_color

Programmatically: use Customization.setSendButtonDisabledColor method

Bottom sheet enabled state icons color

Define the color of the icons placed in the bottom sheet when they are enabled.

If not specified, main theme color is applied.

Color must be in hex format, e.g. #007AFF

Xml attribute name: dimelo_bottom_sheet_icons_enabled_color

Programmatically: use Customization.setBottomSheetIconsEnabledColor method

attachment Icon Button

Specify a drawable to use for the attachment icon.

Programmatically: use Customization.setAttachmentIcon method

document Icon Button

Specify a drawable to use for the document icon.

Programmatically: use Customization.setAttachmentDocumentIcon method

Bottom sheet disabled state icons color

Define the color of the icons placed in the bottom sheet when they are disabled.

Color must be in hex format, e.g. #007AFF

Xml attribute name: dimelo_bottom_sheet_icons_disabled_color

Programmatically: use Customization.setBottomSheetIconsDisabledColor method

Bottom sheet disabled state icons color

Define the color of the icons placed in the bottom sheet when they are disabled.

Color must be in hex format, e.g. #007AFF

Xml attribute name: dimelo_bottom_sheet_icons_disabled_color

Programmatically: use Customization.setBottomSheetIconsDisabledColor method

ActionBar background color

ActionBar color (ChatActivity only).

Color must be in hex format, e.g. #007AFF.

Xml attribute name: dimelo_toolbar_background_color

Programmatically: None

chat background color

Background color of the chat.

Color must be in hex format, e.g. #007AFF.

Xml attribute name: dimelo_background_color

Programmatically: set Customization.backgroundColor property

user message TextColor

Foreground color for user's message text.

Color must be in hex format, e.g. #007AFF.

Xml attribute name: dimelo_user_message_text_color

Programmatically: set Customization.userMessageTextColor property

agent message TextColor

Foreground color for agent's message text.

Color must be in hex format, e.g. #007AFF.

Xml attribute name: dimelo_agent_message_text_color

Programmatically: set Customization.agentMessageTextColor property

system message TextColor

Foreground color for system's message text.

Color must be in hex format, e.g. #007AFF.

Xml attribute name: dimelo_system_message_text_color

Programmatically: set Customization.systemMessageTextColor property

error icon color

Define the color of the error icon when the message is not sent.

Color must be in hex format, e.g. #007AFF

Xml attribute name: dimelo_error_icon_color

Programmatically: use Customization.errorIconColor method

navigation bar title color

Text color for navigation bar title.

Color must be in hex format, e.g. #007AFF.

Xml attribute name: dimelo_navigation_bar_title_color

Programmatically: set Customization.navigationBarTitleColor property

navigation bar back item tint color

Tint color for navigation bar back item.

Color must be in hex format, e.g. #007AFF.

Xml attribute name: rc_navigation_bar_back_item_tint_color

Programmatically: set Customization.navigationBarBackItemTintColor property

navigation bar item tint color (share icon)

Tint color for navigation bar item.

Color must be in hex format, e.g. #007AFF.

Xml attribute name: dimelo_navigation_bar_item_tint_color

Programmatically: set Customization.navigationBarItemTintColor property

Notes

  • For the back item tint color customization, you can use this code into your application (it will be applied for all activities)

    Drawable backItem = getResources().getDrawable(R.drawable.abc_ic_ab_back_mtrl_am_alpha);
backItem.setColorFilter(your_color, PorterDuff.Mode.SRC_IN);
getSupportActionBar().setHomeAsUpIndicator(backItem);

  • You can directly apply a custom theme if it's supported without using Customization.navigationBarItemTintColor and Customization.navigationBarTitleColor

  1. Add this code to your custom theme in themes.xml

    your_navigation_bar_item_tint_color @style/toolbar.titleTextStyle your_navigation_bar_Title_color

    <style name="toolbar.titleTextStyle" parent="@style/Widget.AppCompat.Toolbar" />

  2. Apply your custom theme to the activity in AndroidManifest.xml

    • For ChatActivity

      <activity android:name="com.dimelo.dimelosdk.main.ChatActivity"
             tools:replace="android:theme"
             android:theme="@style/your_theme">
</activity>

    • For AttachmentActivity

      <activity android:name="com.dimelo.dimelosdk.main.AttachmentActivity"
             tools:replace="android:theme"
             android:theme="@style/your_theme">
</activity>
    • You should use tools:replace="android:theme" to replace the default Dimelo theme

user message BackgroundColor

Background color for user message bubbles.

Color must be in hex format, e.g. #007AFF.

Xml attribute name: dimelo_user_bubble_color

Programmatically: set this property by calling Customization.setUserMessageBubbleDrawable method.

welcomeMessageTextColor

Text color for welcome message.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_welcome_message_text_color

Programmatically: set Customization.welcomeMessageTextColor property.

agentTimeColor

Text color for the agent time text view.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_agent_time_color

Programmatically: set Customization.agentTimeColor property.

hourTimeTextColor

Text color for the hour text view.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_hour_time_text_color

Programmatically: set Customization.hourTimeTextColor property.

agentTemplateBorderColor

Border color for agent structured message bubbles.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_agent_template_border_color

Programmatically: set Customization.agentTemplateBorderColor property.

agentTemplateWithImageBodyBackgroundColor

Background color for agent structured message. Only applies when there is an image, otherwise, please see agentStructuredMessageBodyBackgroundColor.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_agent_template_with_image_body_background_color

Programmatically: set Customization.agentTemplateWithImageBodyBackgroundColor property.

agentStructuredMessageBodyBackgroundColor

Background color for body agent structured message view. Only applies when there is no image, otherwise, please see agentTemplateWithImageBodyBackgroundColor.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_agent_structured_message_body_background_color

Programmatically: set Customization.agentStructuredMessageBodyBackgroundColor property.

agent message BackgroundColor

Background color for agent message bubbles.

Color must be in hex format, e.g. #007AFF.

Xml attribute name: dimelo_agent_bubble_color

Programmatically: set this property by calling Customization.setAgentMessageBubbleDrawable method.

system message BackgroundColor

Background color for system message bubbles.

Color must be in hex format, e.g. #007AFF.

Xml attribute name: dimelo_system_bubble_color

Programmatically: set this property by calling Customization.setSystemMessageBubbleDrawable method.

user attachment bubbles BackgroundColor

Background color for user attachment bubbles.

Color must be in hex format, e.g. #007AFF.

Xml attribute name: dimelo_user_attachment_bubble_color

Programmatically: set this property by calling Customization.setUserAttachmentBubbleDrawable method.

agent attachment bubbles BackgroundColor

Background color for agent attachment bubbles.

Color must be in hex format, e.g. #007AFF.

Xml attribute name: dimelo_agent_attachment_bubble_color

Programmatically: set this property by calling Customization.setAgentAttachmentBubbleDrawable method.

agentStructuredMessageUrlMarginTop

Margin top for structured message url text view.

Xml attribute name: dimen/rc_agent_structured_message_url_margin_top

Programmatically: set Customization.agentStructuredMessageUrlMarginTop property.

agentStructuredMessageSubtitleMarginTop

Margin top for structured message subtitle text view.

Xml attribute name: dimen/rc_agent_structured_message_subtitle_margin_top

Programmatically: set Customization.agentStructuredMessageSubtitleMarginTop property.

agentStructuredMessageTitleColor

Foreground color for agent's structured message title text.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_agent_structured_message_title_color

Programmatically: set Customization.agentStructuredMessageTitleColor property.

agentStructuredMessageSubtitleColor

Foreground color for agent's structured message subtitle text.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_agent_structured_message_subtitle_color

Programmatically: set Customization.agentStructuredMessageSubtitleColor property.

agentStructuredMessageUrlColor

Foreground color for agent's structured message url text.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_agent_structured_message_url_color

Programmatically: set Customization.agentStructuredMessageUrlColor property.

agentStructuredMessageItemColor

Foreground color for agent's structured message item text.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_agent_structured_message_item_color

Programmatically: set Customization.agentStructuredMessageItemColor property.

agentStructuredMessageItemTappedColor

Foreground color for agent's structured message tapped item text.

Color must be in hex format, e.g. 007AFF or #007AFF.

Programmatically: set Customization.agentStructuredMessageItemTappedColor property.

agentStructuredMessageItemBackgroundColor

Background color for agent's structured message item text.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_agent_structured_message_item_background_color

Programmatically: set Customization.agentStructuredMessageItemBackgroundColor property.

agentStructuredMessageItemTappedBackgroundColor

Background color for agent's structured message tapped item.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_agent_structured_message_item_tapped_background_color

Programmatically: set Customization.agentStructuredMessageItemTappedBackgroundColor property.

quickRepliesBorderWidth

Border width for quick replies.

Xml attribute name: dimen/rc_quick_replies_border_width

Programmatically: set Customization.quickRepliesBorderWidth property.

quickRepliesHorizontalSpacing

Horizontal spacing for quick replies.

Xml attribute name: dimen/rc_quick_replies_horizontal_spacing

Programmatically: set Customization.quickRepliesHorizontalSpacing property.

quickRepliesVerticalSpacing

Vertical spacing for quick replies.

Xml attribute name: dimen/rc_quick_replies_vertical_spacing

Programmatically: set Customization.quickRepliesVerticalSpacing property.

quickRepliesBorderColor

Border color for quick replies.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_quick_replies_border_color

Programmatically: set Customization.quickRepliesBorderColor property.

quickRepliesTappedBorderColor

Border color for tapped quick replies.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_quick_replies_tapped_border_color

Programmatically: set Customization.quickRepliesTappedBorderColor property.

quickRepliesTextColor

Text color for quick replies.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_quick_replies_text_color

Programmatically: set Customization.quickRepliesTextColor property.

quickRepliesTappedTextColor

Text color for tapped quick replies.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_quick_replies_tapped_text_color

Programmatically: set Customization.quickRepliesTappedTextColor property.

quickRepliesBackgroundColor

Background color for quick replies.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_quick_replies_background_color

Programmatically: set Customization.quickRepliesBackgroundColor property.

quickRepliesTappedBackgroundColor

Background color for tapped quick replies.

Color must be in hex format, e.g. 007AFF or #007AFF.

Xml attribute name: rc_quick_replies_tapped_background_color

Programmatically: set Customization.quickRepliesTappedBackgroundColor property.

date TextColor

Text color for the date label.

Color must be in hex format, e.g. #007AFF.

Xml attribute name: dimelo_date_color

Programmatically: set Customization.dateTextColor property.

agentStructuredMessageTitleFont

Font for agent's structured message title.

Programmatically: set Customization.agentStructuredMessageTitleFont property

Xml attribute name: None

agentStructuredMessageSubTitleFont

Font for agent's structured message subtitle.

Programmatically: set Customization.agentStructuredMessageSubTitleFont property

Xml attribute name: None

agentStructuredMessageUrlFont

Font for agent's structured message url.

Programmatically: set Customization.agentStructuredMessageUrlFont property

Xml attribute name: None

agentStructuredMessageItemFont

Font for agent's structured message item.

Programmatically: set Customization.agentStructuredMessageItemFont property

Xml attribute name: None

agentTimeFont

Font for the agent time text view.

Programmatically: set Customization.agentTimeFont property

Xml attribute name: None

hourTimeFont

Font for the hour text view.

Programmatically: set Customization.hourTimeFont property

Xml attribute name: None

webViewTitleFont

Font applied to the webView title.

Programmatically: set Customization.webViewTitleFont property

Xml attribute name: None

videoCallRequestedStatusMessageTextFont

Font applied to the status message when a video call is requested.

Programmatically: set Customization.videoCallRequestedStatusMessageTextFont property

Xml attribute name: None

deletedMessageTextFont

Font applied to to a message that was deleted by its author.

Programmatically: set Customization.deletedMessageTextFont property

Xml attribute name: None

agent Name color

Text color for agent's name.

Color must be in hex format, e.g. #007AFF.

Xml attribute name: dimelo_agent_name_color

Programmatically: set Customization.agentNameColor property

Attributes < dimen />

User Bubble padding

Padding of the user's message bubble.

Xml attributes name:

  • dimelo_user_message_bubble_left_padding

  • dimelo_user_message_bubble_right_padding

  • dimelo_user_message_bubble_top_padding

  • dimelo_user_message_bubble_bottom_padding

Programmatically: set Customization.userMessageBubblePadding property

Agent Bubble padding

Padding of the agent's message bubble.

Xml attributes name:

  • dimelo_agent_message_bubble_left_padding

  • dimelo_agent_message_bubble_right_padding

  • dimelo_agent_message_bubble_top_padding

  • dimelo_agent_message_bubble_bottom_padding

Programmatically: set Customization.agentMessageBubblePadding property

System Bubble padding

Padding of the system's message bubble.

Xml attributes name:

  • dimelo_system_message_bubble_left_padding

  • dimelo_system_message_bubble_right_padding

  • dimelo_system_message_bubble_top_padding

  • dimelo_system_message_bubble_bottom_padding

Programmatically: set Customization.systemMessageBubblePadding property

User Attachment Bubble padding

Padding of the user's attachment bubble.

Xml attributes name:

  • dimelo_user_attachment_bubble_left_padding

  • dimelo_user_attachment_bubble_right_padding

  • dimelo_user_attachment_bubble_top_padding

  • dimelo_user_attachment_bubble_bottom_padding

Programmatically: set Customization.userAttachmentBubblePadding property

Agent Attachment Bubble padding

Padding of the agent's attachment bubble.

Xml attributes name:

  • dimelo_agent_attachment_bubble_left_padding

  • dimelo_agent_attachment_bubble_right_padding

  • dimelo_agent_attachment_bubble_top_padding

  • dimelo_agent_attachment_bubble_bottom_padding

Programmatically: set Customization.agentAttachmentBubblePadding property

System Attachment Bubble padding

Padding of the system's attachment bubble.

Xml attributes name:

  • dimelo_system_attachment_bubble_left_padding

  • dimelo_system_attachment_bubble_right_padding

  • dimelo_system_attachment_bubble_top_padding

  • dimelo_system_attachment_bubble_bottom_padding

Programmatically: set Customization.systemAttachmentBubblePadding property

agentStructuredMessageBodyPadding

Padding of the agent structured message bubbles.

Xml attributes name:

  • rc_agent_structured_message_body_left_padding

  • rc_agent_structured_message_body_right_padding

  • rc_agent_structured_message_body_top_padding

  • rc_agent_structured_message_body_bottom_padding

Programmatically: set Customization.agentStructuredMessageBodyPadding property

agentStructuredMessageItemPadding

Padding of the agent structured message item.

Xml attributes name:

  • rc_agent_structured_message_item_left_padding

  • rc_agent_structured_message_item_right_padding

  • rc_agent_structured_message_item_top_padding

  • rc_agent_structured_message_item_bottom_padding

Programmatically: set Customization.agentStructuredMessageItemPadding property

quickRepliesItemPadding

Padding of the quick replies item.

Xml attributes name:

  • rc_quick_replies_item_left_padding

  • rc_quick_replies_item_right_padding

  • rc_quick_replies_item_top_padding

  • rc_quick_replies_item_bottom_padding

Programmatically: set Customization.quickRepliesItemPadding property

agentTimePadding

Padding for agent time text view.

Xml attributes name:

  • rc_agent_time_left_padding

  • rc_agent_time_right_padding

  • rc_agent_time_top_padding

  • rc_agent_time_bottom_padding

Programmatically: set Customization.agentTimePadding property

Date Format

dateFormatter

Date format for the date label (should be a SimpleDateFormat).

Programmatically: set Customization.dateFormatter property

Xml attribute name: None

Note: This is an example on how to initialize Customization.dateFormatter:

SimpleDateFormat dateFormatter = new SimpleDateFormat("dd-MM-yyyy");
RcFragment.Customization customisation = RcFragment.getCustomization();
customisation.dateFormatter = dateFormatter;

Typeface

closedThreadMessageTextFont

Font applied to the message that is displayed when the thread is closed.

Programmatically: set Customization.closedThreadMessageTextFont property

threadsListCompanyMessageTitleFont

Font used for the company message title that is displayed in the threads list.

Programmatically: set Customization.threadsListCompanyMessageTitleFont property

Xml attribute name: None

threadsListCompanyMessageSubtitleFont

Font used for the company message subtitle that is displayed in the threads list.

Programmatically: set Customization.threadsListCompanyMessageSubtitleFont property

Xml attribute name: None

badgeFont

Badge text font.

Programmatically: set Customization.badgeFont property

Xml attribute name: None

backToAllChatsFont

Font for the backToAllChats text view (in the header fragment).

Programmatically: set Customization.backToAllChatsFont property

Xml attribute name: None

threadsListAgentNameFont

Font for the agent name displayed in the threads list.

Programmatically: set Customization.threadsListAgentNameFont property

Xml attribute name: None

threadsListMessageFont

Font for the message displayed in the threads list.

Programmatically: set Customization.threadsListMessageFont property

Xml attribute name: None

threadsListDateFont

Font for the date displayed in the threads list.

Programmatically: set Customization.threadsListDateFont property

Xml attribute name: None

navigationBarTitleFont

Font for the navigation bar title (minimum android SDK version equal to 18 when using Dimelo as Fragment, otherwise we use the default font).

Programmatically: set Customization.navigationBarTitleFont property

Xml attribute name: None

messageFont

Font for user and agent messages.

Programmatically: set Customization.messageFont property

Xml attribute name: None

systemMessageFont

Font for system messages.

Programmatically: set Customization.systemMessageFont property

Xml attribute name: None

dateFont

Font for the date label.

Programmatically: set Customization.dateFont property

Xml attribute name: None

agentNameFont

Font for agent's name.

Programmatically: set Customization.agentNameFont property

Xml attribute name: None

Text Size

closedThreadMessageTextSize

Text size applied to the message that is displayed when the thread is closed.

Programmatically: set Customization.closedThreadMessageTextSize property

Xml attribute name: dimen/rc_closed_thread_message_text_size

videoCallRequestedStatusMessageTextSize

Text size used for the status message when a video call is requested.

Programmatically: set Customization.videoCallRequestedStatusMessageTextSize property

Xml attribute name: dimen/rc_video_call_requested_status_message_text_size

deletedMessageTextSize

Text size applied to a message that was deleted by its author.

Programmatically: set Customization.deletedMessageTextSize property

Xml attribute name: dimen/rc_deleted_message_text_size

threadsListCompanyMessageTitleTextSize

Text size used for the company message title that is displayed in the threads list.

Programmatically: set Customization.threadsListCompanyMessageTitleTextSize property

Xml attribute name: dimen/rc_threads_list_company_message_title_text_size

threadsListCompanyMessageSubtitleTextSize

Text size used for the company message subtitle that is displayed in the threads list.

Programmatically: set Customization.threadsListCompanyMessageSubtitleTextSize property

Xml attribute name: dimen/rc_threads_list_company_message_subtitle_text_size

webViewTitleTextSize

webView title text size.

Programmatically: set Customization.webViewTitleTextSize property

Xml attribute name: dimen/rc_web_view_title_text_size

badgeTextSize

Badge text size.

Programmatically: set Customization.badgeTextSize property

Xml attribute name: dimen/rc_badge_text_size

backToAllChatsTextSize

Back to all chats text size.

Programmatically: set Customization.backToAllChatsTextSize property

Xml attribute name: dimen/rc_back_to_all_chats_text_size

threadsListAgentNameTextSize

Text size for the agent name displayed in the threads list.

Programmatically: set Customization.threadsListAgentNameTextSize property

Xml attribute name: dimen/rc_threads_list_agent_name_text_size

threadsListMessageTextSize

Text size of the message displayed in the threads list.

Programmatically: set Customization.threadsListMessageTextSize property

Xml attribute name: dimen/rc_threads_list_message_text_size

threadsListDateTextSize

Text size of the date displayed in the threads list.

Programmatically: set Customization.threadsListDateTextSize property

Xml attribute name: dimen/rc_threads_list_date_text_size

messageTextSize

TextSize for user and agent messages.

Programmatically: set Customization.messageTextSize property

Xml attribute name: dimen/dimelo_message_text_size

systemMessageTextSize

TextSize for system messages.

Programmatically: set Customization.systemMessageTextSize property

Xml attribute name: dimen/dimelo_system_message_text_size

DateTextSize

TextSize for date label.

Programmatically: set Customization.dateTextSize property

Xml attribute name: dimen/dimelo_date_text_size

agentNameTextSize

TextSize for agent name label.

Programmatically: set Customization.agentNameTextSize property

Xml attribute name: dimen/dimelo_agent_name_text_size

messageFieldTextSize

TextSize for the message input.

Programmatically: set Customization.messageFieldTextSize property

Xml attribute name: dimen/dimelo_message_field_text_size

agentTimeTextSize

TextSize for agent time text view.

Programmatically: set Customization.agentTimeTextSize property

Xml attribute name: dimen/rc_agent_time_text_size

hourTimeTextSize

TextSize for the hour text view.

Programmatically: set Customization.hourTimeTextSize property

Xml attribute name: dimen/rc_hour_time_text_size

defaultSize

Set a global size to all the elements for which a text size can be set.

Programmatically: None.

Xml attribute name: dimen/dimelo_default_text_size

Boolean

showAgentAvatarImage

Show or hide the agent avatar image.

Must be a boolean, default is true.

Programmatically: set Customization.showAgentAvatarImage property.

Xml attribute name: None

showAgentAvatarImage=true:

showAgentAvatarImage=false:

showScrollToBottomButton

Flag to enable/disable the button to scroll to the bottom of the conversation.

Must be a boolean, default is false.

Programmatically: set Customization.showScrollToBottomButton property.

Xml attribute name: None