Official MadelineProto channel. Italian Channel: @MadelineProtoIta Group: @pwrtelegramgroup
beta123 adds a FilterFromSender filter (single version of FilterFromSenders), fixes some issues, and disables non-IPC fallback mode, which could have led to long IPC startup times in certain edge conditions.
Читать полностью…beta120 includes multiple UX improvements, such as:
- Event handler attribute validation
- Warnings about missing extensions and MadelineProto updates in the login UI
And various fixes:
- Improve renaming using bot API file IDs and sendDocument/sendPhoto
- Improve getReply
- Fix the HTTP/HTTPS/WS/WSS transports
- Various file-related fixes
MadelineProto 8 beta 116 fixes a few issues with updateSettings, getReply and FilterReplyToSelf!
Читать полностью…P. S. It works for protected stories as well :)
Читать полностью…MadelineProto was updated (8.0.0-beta115)!
Features:
- You can now get direct download links for or directly download stories, check out the open-source MadelineProto-based @tgstories_dl_bot to download any Telegram story!
- Added support for parse_mode
parsing for story methods.
- getReply
now simply returns null if the message doesn't reply to any other message.
- getReply
now has an optional parameter that can be used to filter the returned message type.
- Added isSelfUser()
, isSelfBot()
messages to check whether the current user is a user or a bot.
- Improved IDE typehinting.
- CLI bots: you can now optionally specify a default download link URL (used by getDownloadLink
) in the settings.
- Added DialogMessagePinned
service message with a getPinnedMessage()
method.
Fixes:
- Fixed simple filters with service messages.
- Fixed IDE typehinting for getEventHandler
.
- Fixed startAndLoopMulti.
- Tweaked the default drop timeout on media DCs to avoid timeout errors on slow networks.
- Now the admin list only contains user report peers.
- Make markdownEscape
method accessible.
- Fixed getDownloadLink
for non-event-handler web IPC instances.
MadelineProto supports Telegram Stories in 8.0.0-beta113!
New Methods:
- users.getStoriesMaxIDs
- account.invalidateSignInCodes
- contacts.editCloseFriends
- contacts.toggleStoriesHidden
- channels.clickSponsoredMessage
- stories.sendStory
- stories.editStory
- stories.deleteStories
- stories.togglePinned
- stories.getAllStories
- stories.getUserStories
- stories.getPinnedStories
- stories.getStoriesArchive
- stories.getStoriesByID
- stories.toggleAllStoriesHidden
- stories.getAllReadUserStories
- stories.readStories
- stories.incrementStoryViews
- stories.getStoryViewsList
- stories.getStoriesViews
- stories.exportStoryLink
- stories.report
New Constructors:
- inputMediaStory
- messageMediaStory
- updateStory
- updateReadStories
- updateStoryID
- inputPrivacyKeyAbout
- privacyKeyAbout
- inputPrivacyValueAllowCloseFriends
- privacyValueAllowCloseFriends
- webPageAttributeStory
- messageReplyStoryHeader
- messagePeerVote
- messagePeerVoteInputOption
- messagePeerVoteMultiple
- sponsoredWebPage
- storyViews
- storyItemDeleted
- storyItemSkipped
- storyItem
- userStories
- stories.allStoriesNotModified
- stories.allStories
- stories.stories
- stories.userStories
- storyView
- stories.storyViewsList
- stories.storyViews
- inputReplyToMessage
- inputReplyToStory
- exportedStoryLink
Changed Constructors:
Added close_friend param to user
Added stories_hidden param to user
Added stories_unavailable param to user
Added stories_max_id param to user
Added alt_document param to messageMediaDocument
Added stories_muted param to inputPeerNotifySettings
Added stories_hide_sender param to inputPeerNotifySettings
Added stories_sound param to inputPeerNotifySettings
Added stories_muted param to peerNotifySettings
Added stories_hide_sender param to peerNotifySettings
Added stories_ios_sound param to peerNotifySettings
Added stories_android_sound param to peerNotifySettings
Added stories_other_sound param to peerNotifySettings
Added stories_pinned_available param to userFull
Added stories param to userFull
Added peer param to updateMessagePollVote
Removed user_id param from updateMessagePollVote
Added nosound param to documentAttributeVideo
Added preload_prefix_size param to documentAttributeVideo
Added stories_preload param to autoDownloadSettings
Added small_queue_active_operations_max param to autoDownloadSettings
Added large_queue_active_operations_max param to autoDownloadSettings
Added chats param to messages.votesList
Added keep_archived_unmuted param to globalPrivacySettings
Added keep_archived_folders param to globalPrivacySettings
Added webpage param to sponsoredMessage
Added my param to messagePeerReaction
Click here to start using Telegram Stories in MadelineProto!
beta109 brings some additional fixes and allows passing a class name to getEventHandler!
Читать полностью…MadelineProto was updated (8.0.0-beta107)!
Features:
- Add getPeriodicLoops
function to get all periodic loops created by Cron attribtues
- Add isReply
bound method
- Add exception logging in the browser
Fixes:
- Relax dl.php verification for getDownloadLink
- Made more fixes to photo bot API conversion
- Fix functions.php plugin inclusion
Also here's a more detailed list of the properties and bound methods of the new simple event handler API:
- $message->message
: string Content of the message
- $message->fwdInfo
: ?ForwardedInfo Info about a forwarded message
- $message->command
: ?string Bot command (if present)
- $message->commandType
: ?CommandType Bot command type (if present)
- $message->commandArgs
: list<string> Bot command arguments (if present)
- $message->protected
: bool Whether this message is protected
- $message->matches
: list<string> Regex matches, if a filter regex is present
- $message->fromScheduled
: bool Whether this message is a sent scheduled message
- $message->viaBotId
: ?int If the message was generated by an inline query, ID of the bot that generated it
- $message->editDate
: ?int Last edit date of the message
- $message->keyboard
: InlineKeyboard|ReplyKeyboard|null Inline or reply keyboard.
- $message->imported
: bool Whether this message was imported from a foreign chat service
- $message->psaType
: ?string For Public Service Announcement messages, the PSA type
- $message->nextSent
: ?self @readonly For sent messages, contains the next message in the chain if the original message had to be split.
- $message->id
: int Message ID
- $message->out
: bool Whether the message is outgoing
- $message->chatId
: int ID of the chat where the message was sent
- $message->senderId
: int ID of the sender of the message
- $message->replyToMsgId
: ?int ID of the message to which this message is replying
- $message->date
: int When was the message sent
- $message->topicId
: ?int ID of the forum topic where the message was sent
- $message->threadId
: ?int ID of the message thread where the message was sent
- $message->replyToScheduled
: bool Whether this is a reply to a scheduled message
- $message->mentioned
: bool Whether we were mentioned in this message
- $message->silent
: bool Whether this message was sent without any notification (silently)
- $message->ttlPeriod
: ?int Time-to-live of the message
- $message->media
: Media|null Attached media.
- $message->media->botApiFileId
: Bot API file ID of media.
- $message->media->botApiFileUniqueId
: Bot API unique file ID of media.
- $message->media->fileName, fileExt, creationDate, size, ...
: see the full list of properties by clicking on the documentation for all classes in the \danog\MadelineProto\EventHandler\Media namespace!
Methods:
- $message->getHTML(bool $allowTelegramTags = false): string
: Get an HTML version of the message. $allowTelegramTags
specifies whether to allow telegram-specific tags like tg-spoiler, tg-emoji, mention links and so on…
- $message->getReply(): ?self
: Get replied-to message. May return null if the replied-to message was deleted.
- $message->delete(bool $revoke = true): void
: Delete the message. $revoke
is true by default, if false it deletes the message on just one side of the chat.
- $message->reply(string $message, ParseMode $parseMode, ...): \danog\MadelineProto\EventHandler\Message
: Reply to the message, see the documentation for more info on the parameters!
Also, you can now more easily press inline buttons using the new simple keyboard API:
- $message->keyboard->
press(string $label, bool $waitForResult)
: Presses the first keyboard button with the specified label.- $message->keyboard->pressByCoordinates(int $row, int $column, bool $waitForResult): Presses button at the specified keyboard coordinates.
Update: fixed a small issue with getDownloadLink with bot api file ids (up to 4gb) and quality selections of photos, run composer update to get the latest version (8.0.0-beta102)!
Читать полностью…Coming up next, even more abstracted media methods, keyboard builders, a new web UI, MadelineProto in the browser with WASM, a getDownloadLink
method and much more!
Introducing MadelineProto's biggest update yet, 8.0.0-beta100!
This version introduces plugins », bound methods », filters », a built-in cron system », IPC support for the event handler » and automatic static analysis for event handler code ».
See the following post for examples!
Other features:
- Thanks to the many translation contributors @ https://weblate.madelineproto.xyz/, MadelineProto is now localized in Hebrew, Persian, Kurdish, Uzbek, Russian, French and Italian!
- Added simplified sendMessage
, sendDocument
, sendPhoto
methods that return abstract Message objects with simplified properties and bound methods!
- You can now use Tools::callFork
to fork a new green thread!
- You can now automatically pin messages broadcasted using broadcastMessages
, broadcastForwardMessages
by using the new pin: true
parameter!
- You can now use sendMessageToAdmins
to send messages to the bot's admin (the peers returned by getReportPeers
).
- Added wrapUpdate
, wrapMessage
, wrapMedia
methods to wrap low-level MTProto updates into an abstracted Message object with bound methods!
- The waveform
attribute of Voice
objects is now automatically encoded and decoded to an array of 100 integer values!
- Added a custom PeerNotInDbException
class for "This peer is not present in the internal peer database" errors
- Added a label
property to the Button class, directly indicating the button label (instead of manually fetching it as an array key).
- Added isForum
method to check whether a given supergroup is a forum
- Added an entitiesToHtml
method to convert a message and a set of Telegram entities to an HTML string!
- You can now use reportMemoryProfile()
to generate and send a pprof
memory profile to all report peers to debug the causes of high memory usage.
- Added support for pay
, loginurl, webapp
and tg://user?id=
buttons in bot API syntax!
- Added a getAdminIds
function that returns the IDs of the admin of the bot (equal to the peers returned by getReportPeers in the event handler).
- Added a new ParseMode
enum!
- Added support for HTML lists in parseMode!
- Fixed parsing of markdown code blocks!
Breaking changes:
- Switched to a custom markdown parser with bot API MarkdownV2 syntax, which differs from the previous Markdown syntax supported by parsedown.
- Markdown text can't contain HTML anymore.
Fixes:
- Fixed file uploads with ext-uv!
- Fixed file re-uploads!
- Improve background broadcasting with the broadcast API using a pre-defined list of whitelist
IDs!
- Fixed a bug that caused updates to get paused if an exception is thrown during onStart.
- Broadcast IDs are now unique across multiple broadcasts, even if previous broadcasts already completed their ID will never be re-used.
- Now uploadMedia, sendMedia and upload can upload files from string buffers created using ReadableBuffer
.
- Reduced memory usage during flood waits by tweaking config defaults.
- Reduced memory usage by clearing the min database automatically as needed.
- Automatically try caching all dialogs if a peer not found error is about to be thrown.
- Fixed some issues with pure phar installs.
- Fixed splitting of HTML and markdown messages
- Fixed formatting of multiline markdown codeblocks
- And many other performance improvements and bugfixes!
While I'm preparing the biggest MadelineProto update yet for beta100 (with plugins, filters, attributes and much more!), check out the new FAQ section of the MadelineProto docs: https://docs.madelineproto.xyz/docs/FAQ.html
Читать полностью…Fixed a few issues in 8.0.0-beta98.
Читать полностью…MadelineProto was updated (8.0.0-beta95)!
Fixes:
- Improved self-restart logic on some webhosts
- Fixed redis driver
Also, I've updated the official docker image documentation to include detailed instructions on how to use mysql, postgres and redis with the official MadelineProto image!
I've also included a detailed example on how to use the official MadelineProto docker image via web with automatic HTTPS thanks to the caddy webserver!
I heavily recommend you use the official docker image instead of aapanel/cpanel/apache.
See here for more info: https://docs.madelineproto.xyz/docs/DOCKER.html
Fixed an issue caused by a migration of the backend for the madeline.php alpha channel.
As usual, a warning: NEVER use this install method in production.
The madeline.php install script is as an alpha-level distribution channel for MadelineProto with frequent breaking changes distributed with automatic updates.
If you require a stable, semantically versioned install of MadelineProto with no automatic updates, please install MadelineProto using composer », or by downloading the phar file from the latest release.
MadelineProto was updated (8.0.0-beta121)!
Features:
- Added StaticSticker, AnimatedSticker, VideoSticker media classes.
Fixes:
- Fix localization of some error messages
- Make sure the event handler class is in scope before unserializing
- Other various fixes
I've released MadelineProto 8 beta 117!
Features:
- Add FilterTextCaseInsensitive filter
Fixes:
- Multiple file-related fixes
You can also post stories using MadelineProto, here's a simple example that reposts messages as stories: https://github.com/danog/MadelineProto/blob/v8/examples/bot.php#L164
$media can be an update a message or inputMedia constructor with a URL/file path just like the one accepted by sendMedia!
Another example:
$media = [
'_' => 'inputMediaUploadedPhoto',
'file' => 'faust.jpg'
];
$MadelineProto->stories->sendStory(
media: $media,
caption: "This story was posted using [MadelineProto](/channel/MadelineProto)!",
parse_mode: ParseMode::MARKDOWN,
privacy_rules: [['_' => 'inputPrivacyValueAllowAll']]
);
You can now download any Telegram Story using @tgstories_dl_bot!
Just send it a /dlStory @username command, and it will generate download links for all stories on the user's profile!
@tgstories_dl_bot is powered by @MadelineProto, and it's fully open source!
You can subscribe to my stories and add @danogentili as a contact to receive early updates about my projects ❤️
Читать полностью…MadelineProto 8.0.0-beta110 was released!
Fixes:
- Fix thumbnail parsing
- Fix parsing of round videos in some conditions
- Fix content-type/extension of getDownloadLink/downloadToBrowser
Also, check out the farsi channel for a translation of all the posts describing the features of MadelineProto 8.0.0-beta100+!
به کانال فارسی مدلین برای دیدن توضیحات تمام ویژگی های MadelineProto 8.0.0-beta100+ سر بزنید!
/channel/MadeLine_Farsi/3917
Released beta108 with a few additional features and fixes:
Features:
- Allow specifying command types in FilterCommand
Fixes:
- Fix localization issues
- Fix the IPC server when using a standalone madeline.phar
Note: to get a download link for bot API file IDs as a bot (files up to 4gb), the file name, size and mime type should also be provided:
<?php
if (!file_exists('madeline.php')) {
copy('https://phar.madelineproto.xyz/madeline.php', 'madeline.php');
}
include 'madeline.php';
$MadelineProto = new \danog\MadelineProto\API('session.madeline');
$MadelineProto->botLogin('token');
$botApiFileId = '...';
$fileName = '...';
$fileSize = 123..;
$mimeType = '...';
$link = $MadelineProto->getDownloadLink($botApiFileId, size: $fileSize, name: $fileName, mime: $mimeType);
class MyEventHandler extends SimpleEventHandler {Читать полностью…
/**
* Gets a download link for any file up to 4GB!
*/
#[FilterCommand('dl')]
public function downloadLink(Incoming&Message $message): void
{
if (!$message->replyToMsgId) {
$message->reply("This command must reply to a media message!");
return;
}
$message = $message->getReply();
if (!$message instanceof Message || !$message->media) {
$message->reply("This command must reply to a media message!");
return;
}
$message->reply("Download link: ".$message->media->getDownloadLink());
}
}
MadelineProto was updated (8.0.0-beta101)!
After introducing plugins », bound methods », filters », a built-in cron system », IPC support for the event handler » and automatic static analysis for event handler code » in beta100, beta101 brings some bugfixes and the getDownloadLink
function!getDownloadLink
can be used to fetch a direct download link for any file up to 4GB, even using a bot API file ID!
Other features:
- Added an openFileAppendOnly
function, that can be used to asynchronously open a file in append-only mode!
Fixes:
- Improved the markdownEscape
function!
- Translated even more MadelineProto UI elements!
- Improve the static analyzer.
- Fixed some bugs in simple filters.
- Relax markdown parser.
Here's an example on how to use the new getDownloadLink()
function:
<?php
if (!file_exists('madeline.php')) {
copy('https://phar.madelineproto.xyz/madeline.php', 'madeline.php');
}
include 'madeline.php';
$MadelineProto = new \danog\MadelineProto\API('session.madeline');
$MadelineProto->botLogin('token');
$fileId = '...'; // bot API file ID
$link = $MadelineProto->getDownloadLink($fileId);
$MessageMedia
can be a a media object or even a bot API file ID (files up to 4GB are supported!).getDownloadLink()
bound method:class MyEventHandler extends SimpleEventHandler {In both cases, the download link will be generated automatically if running via web.
/**
* Gets a download link for any file up to 4GB!
*/
#[FilterCommand('dl')]
public function downloadLink(Incoming&Message $message): void
{
if (!$message->replyToMsgId) {
$message->reply("This command must reply to a media message!");
return;
}
$message = $message->getReply();
if (!$message instanceof Message || !$message->media) {
$message->reply("This command must reply to a media message!");
return;
}
$message->reply("Download link: ".$message->media->getDownloadLink());
}
}
$link
will point to your own server, and the link will stream files directly to the browser (no temporary files will be created, 0 disk space will be used). Here's a more detailed explanation of the most important new features of MadelineProto 8.0.0-beta100!
- Native plugin system
To create a plugin, simply create an event handler that extends PluginEventHandler.
For example, create a plugins/Danogentili/PingPlugin.php
file:
<?php declare(strict_types=1);And use a plugin base to run all plugins included in the
namespace MadelinePlugin\Danogentili\PingPlugin;
use danog\MadelineProto\PluginEventHandler;
use danog\MadelineProto\EventHandler\Filter\FilterText;
use danog\MadelineProto\EventHandler\Message;
use danog\MadelineProto\EventHandler\SimpleFilter\Incoming;
class PingPlugin extends PluginEventHandler
{
#[FilterCommand('echo')]
public function echoCmd(Incoming & Message $message): void
{
// Contains the arguments of the command
$args = $message->commandArgs;
$message->reply($args[0] ?? '');
}
#[FilterRegex('/.*(mt?proto).*/i')]
public function testRegex(Incoming & Message $message): void
{
$message->reply("Did you mean to write MadelineProto instead of ".$message->matches[1].'?');
}
#[FilterText('ping')]
public function pingCommand(Incoming&Message $message): void
{
$message->reply("Pong");
}
}
plugins
folder. reply()
, delete()
, getReply()
, getHTML()
and simplified properties like chatId
, senderId
, command
, commandArgs
and many more, see the documentation for more info!Cron
attribute are now automatically invoked by MadelineProto every period
seconds: use danog\MadelineProto\EventHandler\Attributes\Cron;See the documentation for more info!
class MyEventHandler extends SimpleEventHandler
{
/**
* This cron function will be executed forever, every 60 seconds.
*/
#[Cron(period: 60.0)]
public function cron1(): void
{
$this->sendMessageToAdmins("The bot is online, current time ".date(DATE_RFC850)."!");
}
}
getEventHandler()
on an API
instance, see the docs for more info!Verification emails for weblate should now be sent correctly!
Читать полностью…MadelineProto can now be translated in your language!
Just head over to https://weblate.madelineproto.xyz/projects/madelineproto/madelineproto/ to start localizing MadelineProto's UI and TUI strings :D
MadelineProto was updated (8.0.0-beta97)!
Features:
- Added support for automatic QR code login both via CLI and via web with start()
!
- Added a new QR code login API!
- restart()
can now be used to restart the IPC daemon (useful in order to apply updates after running composer update
)
MadelineProto was updated (8.0.0-beta94)!
Fixes:
- Fixed call aggregation syntax. Will introduce a PHP 8 named arguments version of this syntax in future versions.
Features:
- The docker image now uses libuv instead of the libev/libeio event loop drivers: libuv is the same event loop library used by V8/Node.js!
- The image now also includes the ext-memprof extension for optional memory profiling.
Fixed a small issue with the broadcast API that may be triggered when serializing the session in beta90!
Run composer update
to update to the latest version if you're using composer, otherwise run docker compose restart
if you're using the phar version in docker to restart the daemon.