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.

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

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)

Fixed a few issues in 8.0.0-beta98.

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

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

Verification emails for weblate should now be sent correctly!

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!

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);

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");
    }
}

And use a plugin base to run all plugins included in the plugins folder.

See the documentation for more info on how to create MadelineProto plugins!

- Message objects with bound methods

Both plugins and normal bots can make use of bound update methods like reply(), delete(), getReply(), getHTML() and simplified properties like chatId, senderId, command, commandArgs and many more, see the documentation for more info!

- Filters

Plugins and bots can now use three different filtering systems, to easily receive only updates satisfying certain conditions (incoming/outgoing, from group, channel, private, from an admin or a specific peer, with an audio/sticker/..., satisfying a certain regex or a certain /command, and much more!), see the documentation for more info!

- Built-in cron system

All event handler methods marked by the Cron attribute are now automatically invoked by MadelineProto every period seconds:

use danog\MadelineProto\EventHandler\Attributes\Cron;

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)."!");
    }
}

See the documentation for more info!

- IPC support for the event handler

You can now call event handler and plugin methods from outside of the event handler, using getEventHandler() on an API instance, see the docs for more info!

- Automatic static analysis of event handler code

Finally, all new bots and plugins will be automatically analyzed by MadelineProto, blocking execution if performance or security issues are detected!

See the documentation for info!

This update introduced plugins », bound methods », filters », a built-in cron system », IPC support for the event handler » and automatic static analysis for event handler code ».

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!

MadelineProto was updated (8.0.0-beta102)!

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');

$link = $MadelineProto->getDownloadLink($fileId);

$MessageMedia can be a a media object or even a bot API file ID (files up to 4GB are supported!).

You can also use the new getDownloadLink() bound method:

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());
    }
}

In both cases, the download link will be generated automatically if running via web.

The generated download $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).

Resuming is also supported!

If running via cli (or if URL rewriting is enabled), an additional step is required, see the documentation for more info.


Update: fixed a small issue with the quality selections of photos and getDownloadLink with bot API file IDs, remove the vendor folder and re-run composer update to get the latest version (beta102)!

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)!

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);

Note that you don't have to provide the file size, name and mime type manually if you're using the bound getDownloadInfo() method in the event handler:

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-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.

In both cases, if $waitForResult is true, waits for a result from the bot before returning.

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

beta109 brings some additional fixes and allows passing a class name to getEventHandler!

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+ سر بزنید!

https://xn--r1a.website/MadeLine_Farsi/3917

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!

You can subscribe to my stories and add @danogentili as a contact to receive early updates about my projects ❤️

https://xn--r1a.website/danogentili/s/2