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
| MesiboUiDefaults | MesiboUiConfig |
|---|---|
| toolbarColor | theme.toolbarColor |
| toolbarTextColor | theme.toolbarTextColor |
| toolbarIconColor | theme.toolbarIconColor |
| accentColor | theme.accentColor |
| contactPlaceHolder | theme.contactPlaceHolder |
| useLetterTitleImage | theme.useLetterAvatars |
| letterTileColors | theme.letterAvatarColors |
common — texts and settings used on several screens
| MesiboUiDefaults | MesiboUiConfig |
|---|---|
| yes, no, ok, cancel | common.yes, .no, .ok, .cancel |
| deleteTitle | common.deleteTitle |
| today, yesterday | common.today, .yesterday |
| showMonthFirst | common.showMonthFirst |
| youTitle | common.youTitle |
| unknownTitle | common.unknownTitle |
| userOnlineIndicationTitle | common.onlineTitle |
| typingIndicationTitle | common.typingTitle |
| lastSeenTitle | common.lastSeenTitle |
| joinedIndicationTitle | common.joinedTitle |
userList — the chat list
| MesiboUiDefaults | MesiboUiConfig |
|---|---|
| messageListTitle | userList.title |
| userListBackgroundColor | userList.backgroundColor |
| enableSearch, searchMode | userList.searchMode (SEARCH_NONE, MESIBO_SEARCH_NONE on iOS, replaces enableSearch) |
| searchHint | userList.searchHint |
| enableBackButton | userList.showBackButton |
| showOnlineIndicator | userList.showOnlineIndicator |
| showTimestampForClearedChats | userList.showTimestampForClearedChats |
| showProfilePopup | userList.showProfilePopup |
| messageButtonTitle, infoButtonTitle | userList.popupMessageTitle, .popupInfoTitle |
| onlineIndicationTitle | userList.connectedTitle |
| connectingIndicationTitle | userList.connectingTitle |
| offlineIndicationTitle | userList.offlineTitle |
| noNetworkIndicationTitle | userList.noNetworkTitle |
| suspendIndicationTitle | userList.suspendedTitle |
| emptyUserListMessage | userList.emptyMessage |
| emptySearchListMessage | userList.emptySearchMessage |
| allUsersTitle (search section) | userList.searchChatsTitle |
| messagesTitle (search section) | userList.searchMessagesTitle |
| deleteChatsTitle | userList.deleteChatsTitle |
| clearMessagesTitle | userList.clearChatsTitle |
| clearMessageMode | userList.clearMessageMode (also used by the profile screen) |
| showArchivedChats | userList.showArchived |
| unarchiveOnNewMessage | userList.unarchiveOnNewMessage |
| (new) | userList.enableSwipeActions (default on: swiping a chat archives, deletes, mutes or marks it read / unread) |
| archivedTitle, archiveTitle, unarchiveTitle | userList.archivedTitle, .archiveTitle, .unarchiveTitle |
| emptyArchivedMessage | userList.emptyArchivedMessage |
| showChatFilters, chatFilters | userList.showFilters, .filters |
| filterAllTitle … filterGroupsTitle | userList.filterAllTitle … .filterGroupsTitle (and the new .filterOnlineTitle) |
| emptyFilterMessage | userList.emptyFilterMessage |
| favoriteTitle, unfavoriteTitle | userList.favoriteTitle, .unfavoriteTitle |
contacts — pickers: new chat, forward, group members
| MesiboUiDefaults | MesiboUiConfig |
|---|---|
| userListTitle | contacts.title |
| forwardTitle | contacts.forwardTitle |
| selectGroupContactsTitle | contacts.selectMembersTitle |
| createGroupTitle, createGroupSubtitle | contacts.createGroupTitle, .createGroupSubtitle |
| showRecentInForward | contacts.showRecentInForward |
| recentUsersTitle, allUsersTitle | contacts.recentTitle, .allTitle |
| emptyContactsMessage | contacts.emptyMessage |
| showEnterAddress | contacts.showEnterAddress |
| enterAddressTitle … enterAddressInvalid, enterAddressFilter | contacts.enterAddressTitle … (same names) |
| enterAddressKeyboard (iOS) / enterAddressInputType (Android) | contacts.enterAddressKeyboard (iOS) / contacts.enterAddressInputType (Android) |
messages — the chat screen
| MesiboUiDefaults | MesiboUiConfig |
|---|---|
| (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, enableSwipeToReply | messages.enableForward, .enableEdit, .enableReply, .enableSwipeToReply |
| showRichMessageButtons | messages.showAttachments |
| attachments, getAttachment | messages.attachments, -getAttachment: |
| showRecentPhotos | messages.showRecentPhotos |
| showMissedCalls | messages.showMissedCalls |
| showUnreadDivider | messages.showUnreadDivider |
| forceScrollToLatest | messages.forceScrollToLatest |
| convertSmileyToEmoji | messages.convertSmileyToEmoji |
| largeEmoji | messages.largeEmoji |
| showBubbleTail | messages.showBubbleTail |
| messageSpacing, messageGroupSpacing | messages.spacing, .groupSpacing |
| reactions | messages.reactions |
| imageMaxDimension | messages.imageMaxDimension |
| signedFiles | messages.signedFiles |
| e2eeIndicator | messages.showEncryptionIndicator |
| messagingBackground | messages.background |
| messagingBackgroundColor | messages.backgroundColor |
| showWallpaperPattern | messages.showWallpaperPattern |
| messageBackgroundColorForMe / ForPeer | messages.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) |
| headerTitle | messages.headerTitle |
| messageHint | messages.inputHint |
| editTitle | messages.editTitle |
| forwardedTitle, editedTitle, deletedMessageTitle | messages.forwardedTitle, .editedTitle, .deletedTitle |
| missedVoiceCallTitle, missedVideoCallTitle | messages.missedVoiceCallTitle, .missedVideoCallTitle |
| photoTitle … locationTitle | messages.photoTitle … .locationTitle (also the chat list’s last message) |
| messageFailedTitle, messageInvalidRecipientTitle, messageNotMemberTitle, messageBlockedTitle | messages.failedTitle, .failedInvalidRecipientTitle, .failedNotMemberTitle, .failedBlockedTitle |
| deleteMessagesTitle, deleteForEveryoneTitle, deleteForMeTitle | messages.deleteMessagesTitle, .deleteForEveryoneTitle, .deleteForMeTitle |
| copiedTitle | messages.copiedTitle |
| messageAlertOnScrolledView | messages.newMessagesTitle |
| unreadMessageTitle, unreadMessagesTitle | messages.unreadMessageTitle, .unreadMessagesTitle |
| sendLimitReachedTitle, sendLimitReached | messages.sendLimitTitle, .sendLimitMessage |
| blockedMessage | messages.blockedMessage |
| notGroupMemberMessage | messages.notMemberMessage |
| invalidGroupTitle, invalidGroupMessage | messages.invalidGroupTitle, .invalidGroupMessage |
| recordHint, recordCancel, micPermissionDenied | messages.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, mapZoom | location.mapTileUrl, .mapStaticUrl, .mapAttribution, .mapZoom |
| searchLocationHint, sendCurrentLocation | location.searchHint, .sendCurrentTitle |
| locationPermissionDenied, locationUnavailable | location.permissionMessage, .unavailableMessage |
Message info (new)
| MesiboUiConfig | |
|---|---|
| messages.enableMessageInfo, .messageInfoTitle | Message info in a chat’s long press bar, and its title |
| messages.readByTitle, .deliveredToTitle, .notDeliveredTitle, .readTitle, .deliveredTitle | The texts of the message info screen |
profileViewer — a user’s or group’s profile
| MesiboUiDefaults | MesiboUiConfig |
|---|---|
| showAddressInProfileView, showLastSeenInProfileView, showAboutInProfileView, showMediaInProfileView, showGroupMembersInProfileView | profileViewer.showAddress, .showLastSeen, .showAbout, .showMedia, .showMembers |
| showMuteInProfileView, showBlockMessagesInProfileView, showBlockCallsInProfileView, showClearChatInProfileView | profileViewer.showMute, .showBlockMessages, .showBlockCalls, .showClearChat |
| showFavoriteInProfileView, showReadReceiptsInProfileView, showDisappearingInProfileView | profileViewer.showFavorite, .showReadReceipts, .showDisappearing |
| mediaTitle, groupMembersTitle | profileViewer.mediaTitle, .membersTitle |
| muteTitle, blockMessagesTitle, blockCallsTitle, clearChatTitle | profileViewer.muteTitle, .blockMessagesTitle, .blockCallsTitle, .clearChatTitle |
| clearMessagesTitle (its confirmation) | profileViewer.clearChatConfirmTitle |
| favoriteTitle, readReceiptsTitle | profileViewer.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
| MesiboUiDefaults | MesiboUiConfig |
|---|---|
| editProfileTitle, newProfileTitle, newProfileText | profileEditor.title, .newProfileTitle, .newProfileMessage |
| nameTitle, nameHint, nameRequired | profileEditor.nameTitle, .nameHint, .nameRequiredMessage |
| statusTitle, statusHint, addressTitle | profileEditor.statusTitle, .statusHint, .addressTitle |
| profilePhotoTitle, viewPhotoTitle, removePhotoTitle, takePhotoTitle, choosePhotoTitle | profileEditor.photoTitle, .viewPhotoTitle, .removePhotoTitle, .takePhotoTitle, .choosePhotoTitle |
| saveButtonTitle, nextButtonTitle | profileEditor.saveTitle, .nextTitle |
| maxNameLength, maxStatusLength | profileEditor.maxNameLength, .maxStatusLength |
| profileImageMaxDimension | profileEditor.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
| MesiboUiDefaults | MesiboUiConfig |
|---|---|
| groupNameHint, groupNameTooShort, groupCreateFailed | groups.nameHint, .nameRequiredMessage, .createFailedMessage |
| modifyGroupTitle | groups.editTitle |
| addMembersTitle, leaveGroupTitle, deleteGroupTitle | groups.addMembersTitle, .leaveTitle, .deleteTitle |
| makeAdminTitle, removeAdminTitle, removeMemberTitle, messageMemberTitle, adminTitle | groups.makeAdminTitle, .removeAdminTitle, .removeMemberTitle, .messageMemberTitle, .adminTitle |
disappearing — the disappearing messages screen
| MesiboUiDefaults | MesiboUiConfig |
|---|---|
| disappearingDurations, disappearingDurationTitles | disappearing.durations, .durationTitles |
| showDisappearingTimerStart | disappearing.showTimerStart |
| disappearingTitle, disappearingHelp, disappearingOffTitle | disappearing.title, .helpMessage, .offTitle |
| disappearingDurationTitle, disappearingTimerStartTitle | disappearing.durationTitle, .timerStartTitle |
| disappearingWhenSentTitle … WhenReadTitle | disappearing.whenSentTitle, .whenDeliveredTitle, .whenReadTitle |
encryption — the end-to-end encryption screen
| MesiboUiDefaults | MesiboUiConfig |
|---|---|
| e2eeTitle | encryption.title |
| e2eeActive, e2eeInactive, e2eeIdentityChanged | encryption.activeMessage, .inactiveMessage, .identityChangedMessage |
| e2eeVerifyTitle, e2eeVerifyHelp, e2eeResetTitle | encryption.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)
| MediaPicker | MesiboUiConfig |
|---|---|
| mUseBuiltInGallery, mGalleryFullScreen, mGalleryButton | mediaPicker.useBuiltInGallery, .galleryFullScreen, .galleryButton |
| mUseBuiltInCamera | mediaPicker.useBuiltInCamera |
| mToolbarColor, mAccentColor | taken from theme |
messageIcons — new: the icons by the time of a message
| Before | Now |
|---|---|
| (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.
| setting | default | at or above the threshold |
|---|---|---|
| tapToView | 0 | covered (pictures blurred, text hidden) until tapped; your own sent ones only with coverSent |
| coverSent | false | your own sent messages are covered too, as received ones (tapToView); not a threshold |
| coverAgain | 0 | uncovered ones are covered again when the chat is opened again |
| hidePreview | 0 | the chat list, replies and quotes show title instead of the content |
| noForward | 0 | Forward dimmed; a tap shows noForwardMessage |
| noCopy | 0 | Copy dimmed; a tap shows noCopyMessage |
| noScreenshot | 0 | Android: 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) |
| showIcon | 1 | an eye icon by the time |
| title, tapTitle | “Sensitive message”, “Tap to view” | the cover and previews |
| image (Android: imageResource) | built in | the eye icon |
Notifications are built by the app: check the message’s sensitivity there too.
imageEditor — new: the photo editor before sending
| MediaPicker | MesiboUiConfig |
|---|---|
| mFiltersEnabled + mLooksEnabled | imageEditor.showLooks |
| mCropEnabled | imageEditor.showCrop |
| mAnnotationEnabled + mCanvasEnabled, mTextEnabled, mStickersEnabled, mDrawEnabled | imageEditor.showCanvas, .showText, .showStickers, .showDraw |
| mStickers | imageEditor.stickers |
| mSharpenOnResize | imageEditor.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.