Messaging UI Setting - Migrating from MesiboUiDefaults to MesiboUiConfig

The settings of the messaging UI moved from one large class, MesiboUiDefaults, to MesiboUiConfig, a configuration of small groups (see Messaging UI Settings).

MesiboUI.getUiDefaults() is replaced by MesiboUI.getConfig() from API version v2.15.0. The names are the same on Android and iOS. Inside a group, the group’s name is left out of the setting’s name, for example showMuteInProfileView is now profileViewer.showMute.

// before
MesiboUiDefaults defs = MesiboUI.getUiDefaults();
defs.emptyUserListMessage = "No messages yet";
defs.showAddressInProfileView = true;

// now
MesiboUiConfig config = MesiboUI.getConfig();
config.userList.emptyMessage = "No messages yet";
config.profileViewer.showAddress = true;

The tables below list each old name and its new one; (new) marks settings that did not exist before.

theme — colors and pictures

MesiboUiDefaultsMesiboUiConfig
toolbarColortheme.toolbarColor
toolbarTextColortheme.toolbarTextColor
toolbarIconColortheme.toolbarIconColor
accentColortheme.accentColor
contactPlaceHoldertheme.contactPlaceHolder
useLetterTitleImagetheme.useLetterAvatars
letterTileColorstheme.letterAvatarColors

common — texts and settings used on several screens

MesiboUiDefaultsMesiboUiConfig
yes, no, ok, cancelcommon.yes, .no, .ok, .cancel
deleteTitlecommon.deleteTitle
today, yesterdaycommon.today, .yesterday
showMonthFirstcommon.showMonthFirst
youTitlecommon.youTitle
unknownTitlecommon.unknownTitle
userOnlineIndicationTitlecommon.onlineTitle
typingIndicationTitlecommon.typingTitle
lastSeenTitlecommon.lastSeenTitle
joinedIndicationTitlecommon.joinedTitle

userList — the chat list

MesiboUiDefaultsMesiboUiConfig
messageListTitleuserList.title
userListBackgroundColoruserList.backgroundColor
enableSearch, searchModeuserList.searchMode (SEARCH_NONE, MESIBO_SEARCH_NONE on iOS, replaces enableSearch)
searchHintuserList.searchHint
enableBackButtonuserList.showBackButton
showOnlineIndicatoruserList.showOnlineIndicator
showTimestampForClearedChatsuserList.showTimestampForClearedChats
showProfilePopupuserList.showProfilePopup
messageButtonTitle, infoButtonTitleuserList.popupMessageTitle, .popupInfoTitle
onlineIndicationTitleuserList.connectedTitle
connectingIndicationTitleuserList.connectingTitle
offlineIndicationTitleuserList.offlineTitle
noNetworkIndicationTitleuserList.noNetworkTitle
suspendIndicationTitleuserList.suspendedTitle
emptyUserListMessageuserList.emptyMessage
emptySearchListMessageuserList.emptySearchMessage
allUsersTitle (search section)userList.searchChatsTitle
messagesTitle (search section)userList.searchMessagesTitle
deleteChatsTitleuserList.deleteChatsTitle
clearMessagesTitleuserList.clearChatsTitle
clearMessageModeuserList.clearMessageMode (also used by the profile screen)
showArchivedChatsuserList.showArchived
unarchiveOnNewMessageuserList.unarchiveOnNewMessage
(new)userList.enableSwipeActions (default on: swiping a chat archives, deletes, mutes or marks it read / unread)
archivedTitle, archiveTitle, unarchiveTitleuserList.archivedTitle, .archiveTitle, .unarchiveTitle
emptyArchivedMessageuserList.emptyArchivedMessage
showChatFilters, chatFiltersuserList.showFilters, .filters
filterAllTitle … filterGroupsTitleuserList.filterAllTitle … .filterGroupsTitle (and the new .filterOnlineTitle)
emptyFilterMessageuserList.emptyFilterMessage
favoriteTitle, unfavoriteTitleuserList.favoriteTitle, .unfavoriteTitle

contacts — pickers: new chat, forward, group members

MesiboUiDefaultsMesiboUiConfig
userListTitlecontacts.title
forwardTitlecontacts.forwardTitle
selectGroupContactsTitlecontacts.selectMembersTitle
createGroupTitle, createGroupSubtitlecontacts.createGroupTitle, .createGroupSubtitle
showRecentInForwardcontacts.showRecentInForward
recentUsersTitle, allUsersTitlecontacts.recentTitle, .allTitle
emptyContactsMessagecontacts.emptyMessage
showEnterAddresscontacts.showEnterAddress
enterAddressTitle … enterAddressInvalid, enterAddressFiltercontacts.enterAddressTitle … (same names)
enterAddressKeyboard (iOS) / enterAddressInputType (Android)contacts.enterAddressKeyboard (iOS) / contacts.enterAddressInputType (Android)

messages — the chat screen

MesiboUiDefaultsMesiboUiConfig
(new)messages.defaultMessage — a MesiboMessage whose options every message sent from the UI starts with (MesiboMessage setDefaults); a chat’s own defaults (e.g. disappearing messages) are used instead when set
enableForward, enableEdit, enableReply, enableSwipeToReplymessages.enableForward, .enableEdit, .enableReply, .enableSwipeToReply
showRichMessageButtonsmessages.showAttachments
attachments, getAttachmentmessages.attachments, -getAttachment:
showRecentPhotosmessages.showRecentPhotos
showMissedCallsmessages.showMissedCalls
showUnreadDividermessages.showUnreadDivider
forceScrollToLatestmessages.forceScrollToLatest
convertSmileyToEmojimessages.convertSmileyToEmoji
largeEmojimessages.largeEmoji
showBubbleTailmessages.showBubbleTail
messageSpacing, messageGroupSpacingmessages.spacing, .groupSpacing
reactionsmessages.reactions
imageMaxDimensionmessages.imageMaxDimension
signedFilesmessages.signedFiles
e2eeIndicatormessages.showEncryptionIndicator
messagingBackgroundmessages.background
messagingBackgroundColormessages.backgroundColor
showWallpaperPatternmessages.showWallpaperPattern
messageBackgroundColorForMe / ForPeermessages.myBubbleColor, .peerBubbleColor
(new)messages.myTextColor, .peerTextColor (the text in the bubbles)
(new)messages.textSize (TEXTSIZE_SMALL, _MEDIUM (default), _LARGE, EXTRALARGE; MESIBO_TEXTSIZE… on iOS)
(new)messages.wallpaperPath (a photo as the chat wallpaper, e.g. chosen in Customize)
headerTitlemessages.headerTitle
messageHintmessages.inputHint
editTitlemessages.editTitle
forwardedTitle, editedTitle, deletedMessageTitlemessages.forwardedTitle, .editedTitle, .deletedTitle
missedVoiceCallTitle, missedVideoCallTitlemessages.missedVoiceCallTitle, .missedVideoCallTitle
photoTitle … locationTitlemessages.photoTitle … .locationTitle (also the chat list’s last message)
messageFailedTitle, messageInvalidRecipientTitle, messageNotMemberTitle, messageBlockedTitlemessages.failedTitle, .failedInvalidRecipientTitle, .failedNotMemberTitle, .failedBlockedTitle
deleteMessagesTitle, deleteForEveryoneTitle, deleteForMeTitlemessages.deleteMessagesTitle, .deleteForEveryoneTitle, .deleteForMeTitle
copiedTitlemessages.copiedTitle
messageAlertOnScrolledViewmessages.newMessagesTitle
unreadMessageTitle, unreadMessagesTitlemessages.unreadMessageTitle, .unreadMessagesTitle
sendLimitReachedTitle, sendLimitReachedmessages.sendLimitTitle, .sendLimitMessage
blockedMessagemessages.blockedMessage
notGroupMemberMessagemessages.notMemberMessage
invalidGroupTitle, invalidGroupMessagemessages.invalidGroupTitle, .invalidGroupMessage
recordHint, recordCancel, micPermissionDeniedmessages.recordHint, .recordCancelTitle, .micPermissionMessage
(new)messages.showDisappearingIcon (default on: a timer by the time; a tap on a text shows the time left), .disappearingImage (Android: .disappearingImageResource), .disappearsInTitle

location — sending a location (Android today; iOS uses MediaPicker’s location picker)

now (Android)new
mapTileUrl, mapStaticUrl, mapAttribution, mapZoomlocation.mapTileUrl, .mapStaticUrl, .mapAttribution, .mapZoom
searchLocationHint, sendCurrentLocationlocation.searchHint, .sendCurrentTitle
locationPermissionDenied, locationUnavailablelocation.permissionMessage, .unavailableMessage

Message info (new)

MesiboUiConfig
messages.enableMessageInfo, .messageInfoTitleMessage info in a chat’s long press bar, and its title
messages.readByTitle, .deliveredToTitle, .notDeliveredTitle, .readTitle, .deliveredTitleThe texts of the message info screen

profileViewer — a user’s or group’s profile

MesiboUiDefaultsMesiboUiConfig
showAddressInProfileView, showLastSeenInProfileView, showAboutInProfileView, showMediaInProfileView, showGroupMembersInProfileViewprofileViewer.showAddress, .showLastSeen, .showAbout, .showMedia, .showMembers
showMuteInProfileView, showBlockMessagesInProfileView, showBlockCallsInProfileView, showClearChatInProfileViewprofileViewer.showMute, .showBlockMessages, .showBlockCalls, .showClearChat
showFavoriteInProfileView, showReadReceiptsInProfileView, showDisappearingInProfileViewprofileViewer.showFavorite, .showReadReceipts, .showDisappearing
mediaTitle, groupMembersTitleprofileViewer.mediaTitle, .membersTitle
muteTitle, blockMessagesTitle, blockCallsTitle, clearChatTitleprofileViewer.muteTitle, .blockMessagesTitle, .blockCallsTitle, .clearChatTitle
clearMessagesTitle (its confirmation)profileViewer.clearChatConfirmTitle
favoriteTitle, readReceiptsTitleprofileViewer.favoriteTitle, .readReceiptsTitle
(new)profileViewer.showMessageButton, .messageButtonTitle (the Message button under the name), .encryptionTitle (the more menu’s Encryption)
(new)profileViewer.blockNoCallsTitle, .blockVideoCallsTitle, .blockAllCallsTitle (the choices of Block calls: off, video calls only, all calls)

profileEditor — the user’s own profile

MesiboUiDefaultsMesiboUiConfig
editProfileTitle, newProfileTitle, newProfileTextprofileEditor.title, .newProfileTitle, .newProfileMessage
nameTitle, nameHint, nameRequiredprofileEditor.nameTitle, .nameHint, .nameRequiredMessage
statusTitle, statusHint, addressTitleprofileEditor.statusTitle, .statusHint, .addressTitle
profilePhotoTitle, viewPhotoTitle, removePhotoTitle, takePhotoTitle, choosePhotoTitleprofileEditor.photoTitle, .viewPhotoTitle, .removePhotoTitle, .takePhotoTitle, .choosePhotoTitle
saveButtonTitle, nextButtonTitleprofileEditor.saveTitle, .nextTitle
maxNameLength, maxStatusLengthprofileEditor.maxNameLength, .maxStatusLength
profileImageMaxDimensionprofileEditor.imageMaxDimension (also group pictures)
(new)profileViewer.photosTitle, .videosTitle, .documentsTitle, .linksTitle, and .noPhotosTitle … .noLinksTitle (the media screen’s tabs, and when one is empty)
(new)profileEditor.maxPhotos (default 8, also groups; 1: a single photo), .photosTitle, .addPhotosTitle, .makeMainPhotoTitle

groups — creating and editing groups, members

MesiboUiDefaultsMesiboUiConfig
groupNameHint, groupNameTooShort, groupCreateFailedgroups.nameHint, .nameRequiredMessage, .createFailedMessage
modifyGroupTitlegroups.editTitle
addMembersTitle, leaveGroupTitle, deleteGroupTitlegroups.addMembersTitle, .leaveTitle, .deleteTitle
makeAdminTitle, removeAdminTitle, removeMemberTitle, messageMemberTitle, adminTitlegroups.makeAdminTitle, .removeAdminTitle, .removeMemberTitle, .messageMemberTitle, .adminTitle

disappearing — the disappearing messages screen

MesiboUiDefaultsMesiboUiConfig
disappearingDurations, disappearingDurationTitlesdisappearing.durations, .durationTitles
showDisappearingTimerStartdisappearing.showTimerStart
disappearingTitle, disappearingHelp, disappearingOffTitledisappearing.title, .helpMessage, .offTitle
disappearingDurationTitle, disappearingTimerStartTitledisappearing.durationTitle, .timerStartTitle
disappearingWhenSentTitle … WhenReadTitledisappearing.whenSentTitle, .whenDeliveredTitle, .whenReadTitle

encryption — the end-to-end encryption screen

MesiboUiDefaultsMesiboUiConfig
e2eeTitleencryption.title
e2eeActive, e2eeInactive, e2eeIdentityChangedencryption.activeMessage, .inactiveMessage, .identityChangedMessage
e2eeVerifyTitle, e2eeVerifyHelp, e2eeResetTitleencryption.verifyTitle, .verifyMessage, .resetTitle
(new)encryption.failedMessage, .identityFailedMessage, .suspiciousMessage (the other states of a chat)
(new)encryption.enableTitle, .infoMessage (the app’s screen: the switch and what encryption does)
(new)encryption.mitmTitle, .mitmMessage, .peerMitmMessage (man-in-the-middle protection)
(new)encryption.certificateTitle, .certificateOwnTitle, .certificateGeneratedTitle, .importCertificateTitle, .exportCertificateTitle, .restartMessage, .importFailedMessage, .peerCertificateTitle
(new)encryption.allChatsPasswordTitle, .passwordTitle, .passwordMessage, .setTitle, .notSetTitle, .noneTitle, .removeTitle, .saveTitle

mediaPicker — new: picking photos, videos and files (from MesiboMediaPickerOptions / MediaPicker)

MediaPickerMesiboUiConfig
mUseBuiltInGallery, mGalleryFullScreen, mGalleryButtonmediaPicker.useBuiltInGallery, .galleryFullScreen, .galleryButton
mUseBuiltInCameramediaPicker.useBuiltInCamera
mToolbarColor, mAccentColortaken from theme

messageIcons — new: the icons by the time of a message

BeforeNow
(new)messageIcons.pendingColor, .sentColor, .deliveredColor, .readColor, .failedColor, .starColor, .sensitiveColor, .timerColor (the eye a muted red)
(new)messageIcons.pendingImage, .sentImage, .deliveredImage, .readImage, .failedImage, .starImage (Android: …ImageResource)

sensitivity — new: sensitive messages

A message’s sensitivity is a number set by the sender (MesiboMessage setSensitivity). Each setting is a threshold: it applies to messages whose sensitivity is at least that; 0 turns it off, so nothing changes until the app sets them.

settingdefaultat or above the threshold
tapToView0covered (pictures blurred, text hidden) until tapped; your own sent ones only with coverSent
coverSentfalseyour own sent messages are covered too, as received ones (tapToView); not a threshold
coverAgain0uncovered ones are covered again when the chat is opened again
hidePreview0the chat list, replies and quotes show title instead of the content
noForward0Forward dimmed; a tap shows noForwardMessage
noCopy0Copy dimmed; a tap shows noCopyMessage
noScreenshot0Android: screenshots and screen recording blocked while the chat is open. iOS: the chat is covered while recorded or shared and in the app switcher (iOS does not let apps block screenshots)
showIcon1an eye icon by the time
title, tapTitle“Sensitive message”, “Tap to view”the cover and previews
image (Android: imageResource)built inthe eye icon

Notifications are built by the app: check the message’s sensitivity there too.

imageEditor — new: the photo editor before sending

MediaPickerMesiboUiConfig
mFiltersEnabled + mLooksEnabledimageEditor.showLooks
mCropEnabledimageEditor.showCrop
mAnnotationEnabled + mCanvasEnabled, mTextEnabled, mStickersEnabled, mDrawEnabledimageEditor.showCanvas, .showText, .showStickers, .showDraw
mStickersimageEditor.stickers
mSharpenOnResizeimageEditor.sharpenOnResize
(new)messages.imageSizes, .imageSizeTitles (the picture sizes to pick from on the send screen; default 1600 “Standard” and 4096 “HD”)
(crop ratios: built in)imageEditor.cropRatios — the ratio buttons (default Free, 1:1, 4:3, 3:2, 16:9)

MesiboUI applies mediaPicker, imageEditor and theme to MediaPicker each time it opens the picker or the editor; apps don’t call MediaPicker for these.