Super Chat Update (Free)

Extensions
1

Send voice messages
Send media from the gallery
Photos and videos shared via a link appear directly in the chat
Photos, videos, and audio play in the chat
Edit messages
Delete messages
Copy messages
Reply to messages

Profile customization:
Change your avatar
Add a description
Set your gender and age
Add social media links
And more…

blocks
blocks1799×2107 481 KB

Events:

SuperChat has total 10 events.

1. SendText

User pressed send with text. replyToId is empty if it is not a reply. Send it to your server and (if AutoAddMyMessages is off) call AddMessage.

Parameter Type
messageId text
text text
replyToId text

2. SendMedia

User attached a file. type: image, video, audio or file. path: local file to upload.

Parameter Type
messageId text
type text
path text
caption text
replyToId text

3. SendVoice

User recorded a voice message. path: local .m4a file to upload.

Parameter Type
messageId text
path text
durationMs number
replyToId text

4. MessageEdited

The author edited his message (within the edit window). Update it on your server.

Parameter Type
messageId text
newText text

5. MessageDeleted

The author deleted his message. Delete it on your server.

Parameter Type
messageId text

6. ProfileChanged

The user changed his profile (nickname set once, new avatar file, status, age, interests…). avatarPath is a local file: upload it. profileJson: all profile fields as text; save it on your server and give it to others with SetUserProfile.

Parameter Type
nickname text
avatarPath text
profileJson text

7. MessageClicked

Message bubble was tapped.

Parameter Type
messageId text
userId text

8. MessageLongClicked

Message bubble was long-pressed.

Parameter Type
messageId text
userId text

9. AvatarClicked

Avatar was tapped (the profile window opens too if ProfileDialogEnabled).

Parameter Type
userId text

10. ErrorOccurred

Error (no permission, cannot read file, storage problem…).

Parameter Type
message text

Methods:

SuperChat has total 24 methods.

1. Initialize

Puts the chat into the given arrangement (its width is set to Fill parent; use a NON-scrollable arrangement with Fill parent height). storage: plug TinyDB1 (chat is restored automatically), or FirebaseDB / CloudDB (chat is saved there; in their GotValue event call LoadChatJson), or any text (e.g. “local”) to keep the chat in an internal file. Call it once in Screen.Initialize, after SetCurrentUser.

Parameter Type
layout component
storage any

2. SetCurrentUser

Who is ‘me’: messages with this userId are shown on the right as mine. avatar: url, file path or app asset name. If nickname is not empty it is locked (nickname can be set only once); if empty, the user is asked for a nickname in the profile window. A nickname / avatar the user set himself in the profile is restored from the saved chat.

Parameter Type
userId text
nickname text
avatar text

3. AddMessage

Adds a text message. A link to a photo / video / audio / YouTube in the text is shown as a player right in the bubble. time: any text, empty = current time; or a number of milliseconds since 1970 (then the time is formatted automatically and the edit window counts from it). avatar: url, file path or app asset name. A message with an id that already exists is ignored.

Parameter Type
messageId text
userId text
nickname text
avatar text
text text
time text

4. AddReplyMessage

Same as AddMessage, but the message answers another message (replyToId = id of that message): a quote is shown on top of the bubble.

Parameter Type
messageId text
userId text
nickname text
avatar text
text text
time text
replyToId text

5. AddMediaMessage

Adds a message with attachment. type: image, video, audio (voice) or file. path: url or file path. caption may be empty. replyToId may be empty. time: see AddMessage.

Parameter Type
messageId text
userId text
nickname text
avatar text
type text
path text
caption text
time text
replyToId text

6. ChangeMessageId

Changes the id of a message (for example when the server confirmed a message that was shown with a local id).

Parameter Type
oldId text
newId text

7. UpdateMessageText

Changes the text of a message (use it when somebody else edited a message).

Parameter Type
messageId text
text text

8. RemoveMessage

Removes a message by id.

Parameter Type
messageId text

9. Clear

Removes all messages from the screen (and from the saved chat).

10. ScrollToBottom

Scrolls the chat to the last message.

11. PickMedia

Opens the phone file picker (photo, video, audio, any file).

12. SetInputText

Puts text into the input field.

Parameter Type
text text

13. ReplyTo

Starts a reply to the message (same as the reply icon under it).

Parameter Type
messageId text

14. SetUserColors

Sets colors for one user (any color; use transparent/None to keep default): nickname color, bubble color, message text color.

Parameter Type
userId text
nickColor number
bubbleColor number
textColor number

15. SetUserField

Sets one profile field of a user. field: nick, avatar, status, about, age, gender (m / f), city, work, interests (comma separated), contacts.

Parameter Type
userId text
field text
value text

16. SetUserProfile

Sets the whole profile of a user from JSON (the same text that the ProfileChanged event gives you). Only the fields that are present are changed.

Parameter Type
userId text
json text

17. GetProfileJson

Returns the profile of a user as JSON text (to save it on your server).

  • Return type: text
Parameter Type
userId text

18. SetUserAbout

Sets the ‘About’ text shown in the user’s profile window.

Parameter Type
userId text
about text

19. SetUserInfo

Adds or changes an extra row in the user’s profile window (for example label ‘Car’, value ‘Lada’).

Parameter Type
userId text
label text
value text

20. OpenProfile

Opens the profile window of a user (same as tapping the avatar).

Parameter Type
userId text

21. SaveChat

Saves the chat right now (it is also saved automatically after every change).

22. LoadChatJson

Restores the chat from text. Use it in the GotValue event of FirebaseDB / CloudDB (check that the tag equals StorageTag) and with any text from your own server.

Parameter Type
json text

23. GetChatJson

Returns the whole chat (messages, profiles) as one text.

  • Return type: text

24. ClearSavedChat

Deletes the saved chat from the storage (messages on screen stay).

Designer:

SuperChat has total 21 designer properties.

1. MyBubbleColor

  • Input type: color
  • Default value: 2B7BFF

2. OtherBubbleColor

  • Input type: color
  • Default value: 262B36

3. MyTextColor

  • Input type: color
  • Default value: FFFFFF

4. OtherTextColor

  • Input type: color
  • Default value: EDEFF4

5. MyNameColor

  • Input type: color
  • Default value: CFE2FF

6. OtherNameColor

  • Input type: color
  • Default value: FFB347

7. BackgroundColor

  • Input type: color
  • Default value: 0E1117

8. InputColor

  • Input type: color
  • Default value: 1A1F29

9. AccentColor

  • Input type: color
  • Default value: 2B7BFF

10. FontSize

  • Input type: non_negative_float
  • Default value: 15

11. BubbleRadius

  • Input type: integer
  • Default value: 18

12. ShowAvatars

  • Input type: boolean
  • Default value: True

13. ShowNames

  • Input type: boolean
  • Default value: True

14. ShowTime

  • Input type: boolean
  • Default value: True

15. AutoAddMyMessages

  • Input type: boolean
  • Default value: True

16. Hint

  • Input type: string

17. InputVisible

  • Input type: boolean
  • Default value: True

18. EditWindowMinutes

  • Input type: integer
  • Default value: 5

19. ProfileDialogEnabled

  • Input type: boolean
  • Default value: True

20. StorageTag

  • Input type: string
  • Default value: SuperChatData

21. MaxSavedMessages

  • Input type: integer
  • Default value: 500

Setters:

SuperChat has total 21 setter properties.

1. MyBubbleColor

My bubble color.

  • Input type: number

2. OtherBubbleColor

Other users’ bubble color.

  • Input type: number

3. MyTextColor

My message text color.

  • Input type: number

4. OtherTextColor

Other users’ text color.

  • Input type: number

5. MyNameColor

My nickname color.

  • Input type: number

6. OtherNameColor

Other users’ nickname color.

  • Input type: number

7. BackgroundColor

Chat background color.

  • Input type: number

8. InputColor

Input field and dialogs color.

  • Input type: number

9. AccentColor

Accent color (send button, voice play button, profile banner).

  • Input type: number

10. FontSize

Message text size.

  • Input type: number

11. BubbleRadius

Bubble corner radius.

  • Input type: number

12. ShowAvatars

Show avatars.

  • Input type: boolean

13. ShowNames

Show nicknames.

  • Input type: boolean

14. ShowTime

Show message time.

  • Input type: boolean

15. AutoAddMyMessages

If true, my sent messages appear in the chat immediately. Turn off if you add them yourself after the server confirms.

  • Input type: boolean

16. Hint

Input field hint (empty = default).

  • Input type: text

17. InputVisible

Show the input bar (hide it for read-only chat).

  • Input type: boolean

18. EditWindowMinutes

How many minutes the author can edit his message.

  • Input type: number

19. ProfileDialogEnabled

Open the profile window when an avatar is tapped.

  • Input type: boolean

20. StorageTag

Tag (key) under which the chat is saved in the storage. Use a different tag for every chat / user.

  • Input type: text

21. MaxSavedMessages

How many last messages are kept in the saved chat.

  • Input type: number

Getters:

SuperChat has total 22 getter properties.

1. MessageCount

Number of messages in the chat.

  • Return type: number

2. MyBubbleColor

My bubble color.

  • Return type: number

3. OtherBubbleColor

Other users’ bubble color.

  • Return type: number

4. MyTextColor

My message text color.

  • Return type: number

5. OtherTextColor

Other users’ text color.

  • Return type: number

6. MyNameColor

My nickname color.

  • Return type: number

7. OtherNameColor

Other users’ nickname color.

  • Return type: number

8. BackgroundColor

Chat background color.

  • Return type: number

9. InputColor

Input field and dialogs color.

  • Return type: number

10. AccentColor

Accent color (send button, voice play button, profile banner).

  • Return type: number

11. FontSize

Message text size.

  • Return type: number

12. BubbleRadius

Bubble corner radius.

  • Return type: number

13. ShowAvatars

Show avatars.

  • Return type: boolean

14. ShowNames

Show nicknames.

  • Return type: boolean

15. ShowTime

Show message time.

  • Return type: boolean

16. AutoAddMyMessages

If true, my sent messages appear in the chat immediately. Turn off if you add them yourself after the server confirms.

  • Return type: boolean

17. Hint

Input field hint (empty = default).

  • Return type: text

18. InputVisible

Show the input bar (hide it for read-only chat).

  • Return type: boolean

19. EditWindowMinutes

How many minutes the author can edit his message.

  • Return type: number

20. ProfileDialogEnabled

Open the profile window when an avatar is tapped.

  • Return type: boolean

21. StorageTag

Tag (key) under which the chat is saved in the storage. Use a different tag for every chat / user.

  • Return type: text

22. MaxSavedMessages

How many last messages are kept in the saved chat.

  • Return type: number

The update will add the ability to run HTML code in the chat.
com.superchat.aix (128.2 KB)
The extension was created with the help of: :rocket: FAST

2 Likes
2

Yeah man great job :blush:

3

This is great.

By the way, if am using your extension will the profile layout auto created?

4

What’s new (soon)

Chat basics

  • Stylish message bubbles with avatar, nickname and time. Long text wraps across the full bubble width.
  • Nickname, bubble and text colors are set by the developer, including per-user colors.
  • Bubble styles: with a tail, flat, gradient. Light and dark theme, chat wallpaper, smooth appearance animation.

Messages and media

  • Photos, videos and files from the phone storage.
  • Voice messages: hold-to-record, waveform, 1x / 1.5x / 2x speed, listen before sending.
  • Links to photos, videos, audio and YouTube play right in the chat. Video opens in a window. Ordinary links get a preview card (image, title, description).
  • Full-screen photo gallery with swipe. Stickers and animated GIFs. Location and contact sharing.
  • Upload progress inside the bubble with a cancel button.

Message actions

  • Icons under every message: reply, save, copy, edit (5 minutes), delete.
  • Swipe right to reply, quote inside the bubble. Emoji reactions. @mentions.
  • Long press opens a menu. Multi-select: copy, forward, delete.
  • Chat search, pinned message.

Live chat

  • Load older messages when scrolling to the top.
  • Delivery status: sending, sent, delivered, read, failed with retry.
  • Date separators (“Today”, “Yesterday”), a “scroll down” button with an unread counter.
  • “Typing…” and “online” indicators.

Profiles and data

  • Social-network-style profile: status, age, gender, city, work, interests, contacts, about. Users change their own avatar, the nickname is set only once.
  • The chat and profiles are saved automatically to TinyDB, Firebase, CloudDB or an internal file, and restored at app start.
  • Added automatic phone language detection, and the chat will be in your device’s language.

blocks
blocks1847×4506 909 KB

com.superchat.aix (220.9 KB)

No further extension updates will be released.

5

The layout is created automatically; the user fills in their own data, avatar, description, etc.