generated from exteraGramPlugins/pluginBase
lyuksovannyyandClaude Opus 5.5
0176f7099d
Publish plugin / publish (push) Successful in 4s
- Delete dialog: "Keep message for myself" checkbox keeps your deletion on this device (marked deleted); unticked, the message is hidden and never restored. Already deleted messages get a plain "Remove from view" dialog (fixes the chat staying dimmed/touch-blocked after it). - "Reset deleted/edited marks" in the chat menu (Plugins) and, for all chats, in the plugin settings. - Fix restored text-only messages showing as empty bubbles (rich text wrappers like links lost their text); missing settings icons. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
62 lines
3.3 KiB
Markdown
62 lines
3.3 KiB
Markdown
<p align="center">
|
|
<img src="images/icon.svg" width="128" height="128" alt="Message Logger icon">
|
|
</p>
|
|
|
|
<h1 align="center">Message Logger</h1>
|
|
|
|
**TL;DR:** an [exteraGram](https://exteragram.app) plugin that keeps deleted messages in
|
|
your chats and shows the edit history of edited ones, using what your
|
|
[telegram-panel](../../telegram-panel) message logger saved.
|
|
|
|
## Description
|
|
|
|
Message Logger connects exteraGram to a telegram-panel message logger and shows its data
|
|
natively in chats. Messages other people delete stay visible, edited messages get a full
|
|
edit history, and comments of deleted channel posts can still be opened. Marks are cached on
|
|
the device, so a chat opened again, even offline, shows them at once.
|
|
|
|
## Features
|
|
|
|
- **Deleted messages stay.** Messages others delete remain in the chat at 75% opacity with a
|
|
red trash icon (from the active icon pack) in the time row. Messages deleted while the app
|
|
was closed are confirmed with Telegram and restored from the logger copy.
|
|
- **Keep your own deletions.** The delete dialog gets a *Keep message for myself* checkbox: ticked,
|
|
the deletion goes to Telegram but the message stays on this device, marked deleted.
|
|
Unticked (the default), it is deleted as usual and never restored from the logger here.
|
|
Deleting a message that is already deleted shows a plain dialog that removes it from view
|
|
on this device only.
|
|
- **Edit history.** *Edit history* in the message menu (right above Forward, for edited
|
|
messages) opens every version as a mock chat, also for the logger groups' own posts, with
|
|
an *Open topic* button for the history topic in the activity group.
|
|
- **Comments of deleted channel posts.** The comments button of a deleted post opens the
|
|
app's own comments section for it (avatars, names, replies, media), filled from the logged
|
|
comments.
|
|
- **Links into chats you're not in.** Message links into a chat the current account isn't
|
|
in (e.g. a log post's "Message" link) open that chat as a signed-in account that is in it;
|
|
going back returns to your account.
|
|
- **Reset marks.** *Reset deleted/edited marks* in the chat's menu (Plugins) forgets that
|
|
chat's cached marks and checks it with the server again; the same row in the plugin
|
|
settings does it for every chat. Messages you removed from view stay hidden.
|
|
- **Cache lifetime.** Cached answers are kept for 1, 7, 30, 90 or 365 days, or forever
|
|
(30 by default).
|
|
|
|
The account reading the logged copies must be a member of the logger and activity groups.
|
|
|
|
## Setup
|
|
|
|
1. In the panel, create a token per master, the account owning the logger groups
|
|
(Settings → API Tokens). Any Telegram account can use a token.
|
|
2. In the plugin settings, enter the panel URL and the tokens (separated by spaces).
|
|
3. Tap *Test connection*.
|
|
|
|
For diagnostics, see the gotchas section of [docs/sdk-notes.md](docs/sdk-notes.md).
|
|
|
|
## Documentation
|
|
|
|
- [How Message Logger works](docs/how-it-works.md): server sync and the local cache
|
|
- [Development](docs/development.md): getting started, repo layout, building and verifying, icon export
|
|
- [How exteraGram plugins work](docs/how-plugins-work.md): the plugin format and lifecycle
|
|
- [Device setup and ADB automation](docs/device-and-adb.md): deploy, watch, logs, debugger
|
|
- [Versioning and releases](docs/versioning-and-releases.md): git hooks, auto-bump, CI publishing
|
|
- [SDK notes](docs/sdk-notes.md): condensed exteraGram SDK API surface
|