diff --git a/data/core.telegram.org/constructor/privacyValueDisallowChatParticipants.html b/data/core.telegram.org/constructor/privacyValueDisallowChatParticipants.html new file mode 100644 index 0000000000..b9275a1a74 --- /dev/null +++ b/data/core.telegram.org/constructor/privacyValueDisallowChatParticipants.html @@ -0,0 +1,147 @@ + + + + + privacyValueDisallowChatParticipants + + + + + + + + + + + + + +
+
+
+
+ + +
+
+
+
+
+
+
+

privacyValueDisallowChatParticipants

+ +

Disallow only participants of certain chats

+

+ +
+
privacyValueDisallowChatParticipants#acae0690 chats:Vector<int> = PrivacyRule;

+

Parameters

+ + + + + + + + + + + + + + + +
NameTypeDescription
chatsVector<int>Disallowed chats
+

Type

+

PrivacyRule

+ +
+ +
+
+
+
+
+
Telegram
+
+ Telegram is a cloud-based mobile and desktop messaging app with a focus on security and speed. +
+ +
+
About
+ +
+
+
Mobile Apps
+ +
+
+
Desktop Apps
+ +
+
+
Platform
+ +
+
+
+
+
About
+
+
+
Blog
+
+
+
Apps
+
+
+
Platform
+
+
+
Twitter
+
+
+
+
+ + + + + + diff --git a/data/core.telegram.org/method/auth.cancelCode b/data/core.telegram.org/method/auth.cancelCode new file mode 100644 index 0000000000..dc90016e20 --- /dev/null +++ b/data/core.telegram.org/method/auth.cancelCode @@ -0,0 +1,180 @@ + + + + + auth.cancelCode + + + + + + + + + + + + + +
+
+
+
+ + +
+
+
+
+
+
+
+

auth.cancelCode

+ +

Cancel the login verification code

+

+ +
+
boolFalse#bc799737 = Bool;
+boolTrue#997275b5 = Bool;
+---functions---
+auth.cancelCode#1f040578 phone_number:string phone_code_hash:string = Bool;

+

Parameters

+ + + + + + + + + + + + + + + + + + + + +
NameTypeDescription
phone_numberstringPhone number
phone_code_hashstringPhone code hash from auth.sendCode
+

Result

+

Bool

+

Possible errors

+ + + + + + + + + + + + + + + + + + + + +
CodeTypeDescription
400PHONE_CODE_EXPIREDThe phone code you provided has expired, this may happen if it was sent to any chat on telegram (if the code is sent through a telegram chat (not the official account) to avoid it append or prepend to the code some chars)
400PHONE_NUMBER_INVALIDThe phone number is invalid
+

Related pages

+

auth.sendCode

+

Send the verification code for login

+ +
+ +
+
+
+
+
+
Telegram
+
+ Telegram is a cloud-based mobile and desktop messaging app with a focus on security and speed. +
+ +
+
About
+ +
+
+
Mobile Apps
+ +
+
+
Desktop Apps
+ +
+
+
Platform
+ +
+
+
+
+
About
+
+
+
Blog
+
+
+
Apps
+
+
+
Platform
+
+
+
Twitter
+
+
+
+
+ + + + + + diff --git a/data/corefork.telegram.org/constructor/channelAdminLogEventActionChangeUsername.html b/data/corefork.telegram.org/constructor/channelAdminLogEventActionChangeUsername.html new file mode 100644 index 0000000000..3f57427daa --- /dev/null +++ b/data/corefork.telegram.org/constructor/channelAdminLogEventActionChangeUsername.html @@ -0,0 +1,152 @@ + + + + + channelAdminLogEventActionChangeUsername + + + + + + + + + + + + + +
+
+
+
+ + +
+
+
+
+
+
+
+

channelAdminLogEventActionChangeUsername

+ +

Channel/supergroup username was changed

+

+ +
+
channelAdminLogEventActionChangeUsername#6a4afc38 prev_value:string new_value:string = ChannelAdminLogEventAction;

+

Parameters

+ + + + + + + + + + + + + + + + + + + + +
NameTypeDescription
prev_valuestringOld username
new_valuestringNew username
+

Type

+

ChannelAdminLogEventAction

+ +
+ +
+
+
+
+
+
Telegram
+
+ Telegram is a cloud-based mobile and desktop messaging app with a focus on security and speed. +
+ +
+
About
+ +
+
+
Mobile Apps
+ +
+
+
Desktop Apps
+ +
+
+
Platform
+ +
+
+
+
+
About
+
+
+
Blog
+
+
+
Apps
+
+
+
Platform
+
+
+
Twitter
+
+
+
+
+ + + + + + diff --git a/data/corefork.telegram.org/constructor/inputStickerSetEmpty.html b/data/corefork.telegram.org/constructor/inputStickerSetEmpty.html new file mode 100644 index 0000000000..2ba949ba2b --- /dev/null +++ b/data/corefork.telegram.org/constructor/inputStickerSetEmpty.html @@ -0,0 +1,132 @@ + + + + + inputStickerSetEmpty + + + + + + + + + + + + + +
+
+
+
+ + +
+
+
+
+
+
+
+

inputStickerSetEmpty

+ +

Empty constructor

+

+ +
+
inputStickerSetEmpty#ffb62b95 = InputStickerSet;

+

Parameters

+

This constructor does not require any parameters.

+

Type

+

InputStickerSet

+ +
+ +
+
+
+
+
+
Telegram
+
+ Telegram is a cloud-based mobile and desktop messaging app with a focus on security and speed. +
+ +
+
About
+ +
+
+
Mobile Apps
+ +
+
+
Desktop Apps
+ +
+
+
Platform
+ +
+
+
+
+
About
+
+
+
Blog
+
+
+
Apps
+
+
+
Platform
+
+
+
Twitter
+
+
+
+
+ + + + + + diff --git a/data/corefork.telegram.org/constructor/stats.messageStats b/data/corefork.telegram.org/constructor/stats.messageStats new file mode 100644 index 0000000000..6fc380d217 --- /dev/null +++ b/data/corefork.telegram.org/constructor/stats.messageStats @@ -0,0 +1,147 @@ + + + + + stats.messageStats + + + + + + + + + + + + + +
+
+
+
+ + +
+
+
+
+
+
+
+

stats.messageStats

+ +

Message statistics

+

+ +
+
stats.messageStats#8999f295 views_graph:StatsGraph = stats.MessageStats;

+

Parameters

+ + + + + + + + + + + + + + + +
NameTypeDescription
views_graphStatsGraphMessage view graph
+

Type

+

stats.MessageStats

+ +
+ +
+
+
+
+
+
Telegram
+
+ Telegram is a cloud-based mobile and desktop messaging app with a focus on security and speed. +
+ +
+
About
+ +
+
+
Mobile Apps
+ +
+
+
Desktop Apps
+ +
+
+
Platform
+ +
+
+
+
+
About
+
+
+
Blog
+
+
+
Apps
+
+
+
Platform
+
+
+
Twitter
+
+
+
+
+ + + + + + diff --git a/data/corefork.telegram.org/constructor/topPeerCategoryCorrespondents.html b/data/corefork.telegram.org/constructor/topPeerCategoryCorrespondents.html new file mode 100644 index 0000000000..f249d4a714 --- /dev/null +++ b/data/corefork.telegram.org/constructor/topPeerCategoryCorrespondents.html @@ -0,0 +1,132 @@ + + + + + topPeerCategoryCorrespondents + + + + + + + + + + + + + +
+
+
+
+ + +
+
+
+
+
+
+
+

topPeerCategoryCorrespondents

+ +

Users we've chatted most frequently with

+

+ +
+
topPeerCategoryCorrespondents#637b7ed = TopPeerCategory;

+

Parameters

+

This constructor does not require any parameters.

+

Type

+

TopPeerCategory

+ +
+ +
+
+
+
+
+
Telegram
+
+ Telegram is a cloud-based mobile and desktop messaging app with a focus on security and speed. +
+ +
+
About
+ +
+
+
Mobile Apps
+ +
+
+
Desktop Apps
+ +
+
+
Platform
+ +
+
+
+
+
About
+
+
+
Blog
+
+
+
Apps
+
+
+
Platform
+
+
+
Twitter
+
+
+
+
+ + + + + + diff --git a/data/corefork.telegram.org/type/ShippingOption.html b/data/corefork.telegram.org/type/ShippingOption.html new file mode 100644 index 0000000000..a685e7189f --- /dev/null +++ b/data/corefork.telegram.org/type/ShippingOption.html @@ -0,0 +1,143 @@ + + + + + ShippingOption + + + + + + + + + + + + + +
+
+
+
+ + +
+
+
+
+
+
+
+

ShippingOption

+ +

Shipping options

+

+ +
+
shippingOption#b6213cdf id:string title:string prices:Vector<LabeledPrice> = ShippingOption;

+

Constructors

+ + + + + + + + + + + + + +
ConstructorDescription
shippingOptionShipping option
+ +
+ +
+
+
+
+
+
Telegram
+
+ Telegram is a cloud-based mobile and desktop messaging app with a focus on security and speed. +
+ +
+
About
+ +
+
+
Mobile Apps
+ +
+
+
Desktop Apps
+ +
+
+
Platform
+ +
+
+
+
+
About
+
+
+
Blog
+
+
+
Apps
+
+
+
Platform
+
+
+
Twitter
+
+
+
+
+ + + + + + diff --git a/data/instantview.telegram.org/docs.html b/data/instantview.telegram.org/docs.html new file mode 100644 index 0000000000..db035fac4e --- /dev/null +++ b/data/instantview.telegram.org/docs.html @@ -0,0 +1,1527 @@ + + + + + Instant View Manual + + + + + + + + + + + +
+ +
+
+
+
+
+
+ +
+
+
+
+
+
+
+
+
+
+
+ +
+ Login + + Hello, anonymous! + +
+
+
+
+
+
+
+

Instant Views and Where to Find Them

+ +
+ +

This document describes Telegram's Instant View format in stupefying detail. If this is your first time hearing about Instant View, please check out our Introduction and Sample Templates before you dive in.

+

If you're comfortable with the idea of Instant View templates, let's look at what makes them tick. To begin with, this is our in-house artist's idea of how Instant View pages are generated:

+
+ +
+ +

It turns out, he is not entirely wrong. This is how Instant View pages are really generated:

+
    +
  1. Whenever Telegram needs to display a link preview for a URL, it also checks whether an Instant View template exists for that domain.
    2. +
  2. If a template exists, our Instant View Bot obtains the page using the URL (it only processes pages that have the MIME-type text/html).
    3. +
  3. The bot then applies rules from the template that determine the positioning of the key elements on the source page (using XPath 1.0 expressions) and modifies the page content to fit the Instant View format.
    4. +
  4. The edited page is used to create a new Instant View page that will be displayed to the user.
    5. +
+

This document will explore the Instant View Format, the Types of Rules your template can utilize, as well as some useful XPath constructs, conditions, and functions that may help you build better templates.

+

This manual was intended to be used as a reference, so you don't have to read the entire thing to get started. Our sample templates make for a much better entry point. You can check back here whenever something is not clear.

+

Recent changes

+

September 10, 2020

+
    +
  • Added the new ~allowed_origin option
    • +
  • Added the new @load function
    • +
  • The @inline function now supports the silent parameter which ignores errors while fetching a page
    • +
+

March 20, 2019

+

Version 2.1

+
    +
  • Supported the srcset attribute in Image and Icon types. The IV engine will automatically take the highest image resolution available (but not higher than 2560px).
    • +
  • The @match function now returns only nodes which content was matched by regular expression
    • +
  • The @replace function now returns only nodes which content was replaced by regular expression
    • +
  • The @inline function no longer follows canonical redirect links while fetching a page
    • +
+

Also in this update:

+ +

December 10, 2018

+

Instant View 2.0 expands the platform with support for right-to-left languages, new page blocks, useful functions and much more. We recommend using the latest version in your templates. To do this, add the following rule at the beginning of the template:

+
~version: "2.0"
+

Below is a list of changes in version 2.0:

+

New properties:

+
    +
  • kicker
    • +
  • site_name
    • +
+

New types:

+
    +
  • Map
    • +
  • Table
    • +
  • Details
    • +
  • RelatedArticles
    • +
  • Marked
    • +
  • Subscript
    • +
  • Superscript
    • +
  • Icon
    • +
  • PhoneLink
    • +
  • Reference
    • +
+

New types of rules:

+ +

New functions:

+ +

Other features and improvements:

+
    +
  • Xpath query results can be appended into variables using + (see more)
    • +
  • New XPath function ends-with
    • +
  • Lists can contain block elements such as paragraph, nested lists, tables and so on
    • +
  • Support for attribution in media captions (<cite> tag)
    • +
  • Support for image links (href attribute for the Image type)
    • +
  • Unsupported elements (such as an image inside the blockquote) now generate an error instead of moving up
    • +
  • Improved @simplify function for better processing RichText (e.g. saves line breaks formed by block elements)
    • +
+

Instant View Format

+

An Instant View page is an object with the following properties:

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ParameterTypeDescription
title RequiredRichTextPage title
subtitleRichTextPage subtitle
kicker RichTextKicker
authorStringAuthor name
author_urlUrlAuthor link
published_dateUnixtimeDate published
descriptionStringA short description (used in link preview)
image_urlUrlLink preview photo (used in link preview)
document_urlUrlLink preview document (used in link preview)
site_name StringName of website (used in link preview)
channelStringThe username of the article author's (or the originating website's) channel on Telegram in the format @username
coverMedia (Image/Video/Embed/Map)Page cover
body RequiredArticlePage content
+

RTL support

+

The platform supports right-to-left languages. If <html> tag or tag referenced by body property has the attribute dir="rtl", the page will be marked as RTL. In case this attribute is not set, you can set it manually to display the page in Instant View as RTL using the following rule:

+
  @set_attr(dir, "rtl"): $body   # if body is already defined
+  @set_attr(dir, "rtl"): /html   # alternative way
+

Supported types

+

The IV page object can hold the following types:

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
TypeAllowed childrenDescriptionHTML counterpart
ArticleHeader
Subheader
Paragraph
Preformatted
Divider
Anchor
List
Blockquote
Pullquote
Media
Image
Video
Audio
Embed
Slideshow
Table
Details
Footer
RelatedArticles		Page content<article>
HeaderRichTextMajor headingWe use the top-level of the <h1> – <h4> headings found on the source page
SubheaderRichTextMinor headingWe use the remaining headings <h1> – <h4> as well as <h5> – <h6> headings
ParagraphRichTextA paragraph<p>
PreformattedRichTextPreformatted text<pre> with the optional attribute data-language*
Anchor–Anchor<anchor> with the attribute name that contains the anchor name
Divider–A separator<hr>
ListListItemA list<ul> for a bullet list, <ol> for a numbered list
ListItemversion 1.0:
RichText

version 2.0:
Header
Subheader
Paragraph
Preformatted
Divider
Anchor
List
Blockquote
Pullquote
Media
Image
Video
Audio
Embed
Slideshow
Table
Details		A list item<li>
BlockquoteRichText
QuoteCaption		A block quote<blockquote>
PullquoteRichText
QuoteCaption		A pull quote<aside>
QuoteCaptionRichTextCaption of a quote<cite>
MediaImage
Video
Audio
Embed
Map
MediaCaption		Media content<figure>
Image–An image<img> with the attribute src and the optional attribute href to make the image clickable. Allowed formats: GIF, JPG, PNG (GIF would be converted into Video type by IV)
As of version 2.1, supports the attribute srcset (srcset has higher priority than src, the same as in a browser; IV gets the highest available resolution under 2560px).
Video–A video<video> with the attribute src, or containing the tag <source type="video/mp4"> with the attribute src
Audio–An audio<audio> with the attribute src, or containing the tag <source> with the attribute src and the attribute type (possible types: audio/ogg, audio/mpeg, audio/mp4)
Embed–An embedded element<iframe> with the attribute src. List of supported embeds
Map –A map<img> or <iframe> with the attribute src referring to Google or Yandex maps
SlideshowMedia (Image/Video)
Image
Video
MediaCaption		A slideshow<slideshow>
MediaCaptionRichTextMedia caption<figcaption>
As of IV 2.0, can contain an additional tag <cite> with attribution (author, creator or source of the media)
Table TableCaption
TableRow		A table<table>
TableCaption RichTextA table caption<caption>
TableRow TableCellA table row<tr> with the optional attributes align, valign, can be wrapped with <thead> or <tbody> or <tfoot> with the optional attributes align, valign
TableCell RichTextA table cell<td> for a standard cell, <th> for a header cell, with the optional attributes align, valign, colspan, rowspan
Details 
(version 2.0+)		DetailsHeader
Header
Subheader
Paragraph
Preformatted
Divider
Anchor
List
Blockquote
Pullquote
Media
Image
Video
Audio
Embed
Slideshow
Table
Details		A collapsible block<details> with the optional attribute open to be opened by default
DetailsHeader 
(version 2.0+)		RichTextA visible heading for the collapsible block<summary>
RelatedArticles Header
Link		Related articles<related> containing one of <h1> – <h6> tag as header of the block and <a> tags with the attribute href containing a URL of related article. Note: Only articles that have an IV will appear in this block on the IV page.
FooterRichTextThe footer<footer>
RichTextBold
Italic
Underline
Strike
Fixed
Marked
Subscript
Superscript
Icon
Link
EmailLink
PhoneLink
LineBreak
Anchor
Reference
String		Formatted textText elements and supported tags
BoldRichTextBold text<b> or <strong>
ItalicRichTextItalic text<i> or <em>
UnderlineRichTextUnderlined text<u> or <ins>
StrikeRichTextStrikethrough text<s> or <del> or <strike>
FixedRichTextMonospace text<code> or <kbd> or <samp> or <tt>
Marked RichTextMarked text<mark>
Subscript RichTextSubscript text<sub>
Superscript RichTextSuperscript text<sup>
Icon –A small image inside the text<pic> with the attribute src, width, height. Can contain the attribute optional if the image is not important and may be ignored. Allowed formats: JPG, PNG.
As of version 2.1, supports the attribute srcset (srcset has higher priority than src, the same as in a browser).
LinkRichTextA link<a> with the attribute href containing a URL
EmailLinkRichTextA link to an email address<a> with the attribute href containing a mailto: link
PhoneLink RichTextA link to a phone number<a> with the attribute href containing a tel: link
Reference RichTextA reference<reference> with the attribute name that contains the reference name
LineBreak–Line break<br>
+
Note on code languages
+

Telegram apps currently do not support code highlighting, but they will in the future. For this reason, it is advisable to include the code language attribute (data-language) for large <pre> blocks if it is supplied in the source.

+
+

Types of Rules

+

Instant View rules are instructions that tell our IV bot where to find the meta-elements on the source page and how it should modify the content of the page when an Instant View page is created.

+

Each new line in a template describes a new rule. When the bot renders a page into the Instant View format, it applies rules from the relevant template one after another and ignores any empty lines. You can leave comments by starting a line with #, all following text on that line will be ignored unless enclosed in quote marks. You can use the \ symbol to carry a rule over to the next string, like this:

+
# Comment 
+# You can break up \
+  a long rule into \
+  multiple strings
+

Most rules are based on XPath 1.0 expressions used to locate the required nodes on the source page.

+

A block of rules may have a name. In this case, it can be reused in other rules.

+

We support the following types of rules:

+

Conditions

+

Conditions offer unlimited flexibility for your templates. Rules of this type begin with the symbols ? or ! and use the following format:

+
?condition:  xpath_query   # condition example
+!condition:  regexp        # parameter on the right depends on the type of the condition
+?condition                 # some conditions don't have parameters
+

Groups of conditions that immediately follow one another are interpreted as a block. ?-rules follow the OR logic when joined, while !-rules follow the AND logic. This means that for the bot to apply each block, all !-conditions in the block and at least one of the ?-conditions within it must be met. This also means that each block must have at least one ?-condition.

+

Blocks of conditions split your rule set into groups. Groups of rules that do not have any conditions are always applied. All other groups are only applied if their conditions are met.

+

Examples

+
# If a rule is placed here, it will be applied
+# Same with the one here
+
+?false               # This condition is always false
+# The rule placed here will never be applied, because the condition is not met
+# Very useful indeed
+
+?exists: //article   # This condition is true if the page has an article tag
+# On these lines, a new group of rules is located, and it will be applied if
+# there's an article tag on the page, despite the ?false condition above
+
+?exists: //article
+?exists: //div[@id="article"]
+!exists: //meta[@property="og:title"]
+# The rules below this block will be applied if an <article> tag or a
+# <div id="article"> can be found, this tag must also be present: <meta property="og:title">
+

+ +
+

Check out the Supported Conditions to see what works out of the box »

+
+

Properties

+

Properties are the building blocks for your IV page. Check the Instant View Format for a list of properties that can be used when creating IV pages (you can also define custom properties, but they will not be used anywhere on the resulting IV page). Use this format to fill properties:

+
property: xpath_query
+property: "Some string"
+property: null
+

Properties store the first node that matches the XPath expression xpath_query. By default, if a property already has a value, it will not be overwritten. You can change this behavior by adding ! to the property name – in this case a new non-empty value can be assigned. If you add !! to the property name, even an empty new value can be assigned to the property.

+

You can also assign a string to the property instead of the xpath_query. In this case, the property will contain a text element with the specified text. It is also possible to assign null to discard the property's value (will only work with !!).

+

Examples

+
title:   //article//h1      # Looking for the 'title' in the article heading
+title:   //h1               # If not found, checking for any headings at all
+title:   //head/title       # If no luck either, trying the <title> tag
+?path: /blog/.*             # On pages in the /blog/ section 
+title!:  //div[@id="title"] # we prefer to use <div id="title">, if present
+?path: /news/.*             # On pages in the /news/ section
+title!!: //h3               # title is always in an h3 tag
+
+author:   //article/@author  # Get author name from the author attribute
+?exists:  //article[has-class("anonymous")]    
+author!!: null               # Don't display author for anonymous posts
+
+

Reminder: The title and body properties are required for an IV page to be created.

+
+

Variables

+

Variables are useful for storing and manipulating nodes before assigning them to properties for the final IV page. Variable names begin with the $ symbol. Use this format to initialize them:

+
$variable: xpath_query
+$variable: "Some text"
+$variable: null
+

Variables store a list of nodes that match the Xpath expression xpath_query. If a variable is assigned for the second time, its previous value is overwritten. You can change this behavior by adding ? to the variable name. You can also append a list of nodes to the previous one by adding + to the variable name.

+

You can also assign a string to the variable instead of the xpath_query. In this case, the variable will contain a list with one text element that has the specified text. It is also possible to assign null to discard the variable's value.

+

Examples

+
$images:  //img
+$images:  //img[@src]     # the previous value will be overwritten
+$images?: //article//img  # a new value will only be assigned if the variable is empty
+$medias:  //img
+$medias+: //video         # now $medias contains all img and video tags
+

Options

+

Options affect how the page is processed by the bot. Options begin with the ~ symbol. Use this format to set them:

+
~option: "value"
+~option: true
+

Options can be set with values in JSON format.

+

Examples

+
~version: "2.1"
+

+ +
+

Check out Supported Options to see what else works out of the box.

+
+

Functions

+

Functions are extremely flexible, but you'll probably mostly use them to strip unnecessary nodes from the page and to replace certain elements with others. Function names begin with the @ symbol, you can use the following format:

+
@function:                 xpath_query   # a function without parameters
+@function(param):          xpath_query   # additional parameters are placed in paretheses
+@function(p1 p2):          xpath_query   # a function with two parameters
+@function(p1, "param #2"): xpath_query   # parameters can be separated by commas
+                                         # and enclosed in quote marks when needed
+@function:                 "Some text"   # use string instead of xpath_query if needed
+

The main argument of a function is a list of nodes that match the Xpath expression xpath_query. You can also use a string as the main argument instead of an xpath_query. In this case, the main argument passed to the function will be a list with one text element that has the specified text.

+

Examples

+
@remove:            //header               # removes all <header> tags found on the page
+@replace_tag(<h1>): //div[@class="header"] # replaces all <div class="header"> tags with <h1>
+<h1>:               //div[@class="header"] # an alias for @replace_tag(<h1>)
+

+ +

Note: You may find the @debug function particularly useful when creating XPath expressions.

+
+

Check out Supported Functions to see what else works out of the box.

+
+

Block Functions

+

Block functions manipulate blocks of rules. Block function names also begin with the @ symbol, you can use the following format:

+
@function(xpath_query) {   # opening bracket should be at the end of the line
+  $variable: xpath_query   # some other rules here
+  @function: $@            #   inside the block function
+}                          # closing bracket should be on a separate line
+

A block function can contain another block function so they can be nested. Block function can not contain conditions.

+
+

Please note that block functions that execute a block of rules several times (map, repeat, while, while_not) have a limit on the total number of iterations for the entire template.

+
+

Examples

+
@if( //article ) {    # if <article> exists
+  @append(<p>): $$    #   append paragraph into it
+}
+

+ +
+

Check out Supported Block Functions to see what else works out of the box.

+
+

Include

+
+

Note: This is a service rule, it will not work in your templates. It was included in this reference to give you a better understanding of how the system works. You can see an example of this rule at work in the Processing Pages section.

+
+

Rules of this type begin with the + symbol and use the following format:

+
+ rules
+

This rule inserts a block of rules with the specified name. In most cases, the name corresponds to the domain to which the rules apply.

+

Examples

+
+ core.telegram.org # inserting the block of rules that is used for core.telegram.org
+?not_exists: $body
++ telegram.org      # inserting the block of rules that is used for telegram.org
+

Special variables $$ and $@

+

The special variables work within a group of rules.

+
    +
  • The $$ variable always contains the result of the most recent XPath query.
    • +
  • The $@ variable holds the return of the most recently run function.
    • +
+

These variables come in handy when you're creating chains of rules. If a rule is missing xpath_query, the statement is considered to be equal to $$.

+

Examples

+
# Put a picture into a <figure> tag, then set it as the cover
+@wrap(<figure>): //img[@id="cover"]
+cover:           $@
+
+# Insert a divider before each div.divider that's no longer required
+@before(<hr>):   //div[has-class("divider")]
+@remove          # this is the same as @remove: $$
+

Extended XPath

+

For your convenience, you can use the following constructs in your XPath expressions.

+

Context

+

Regular XPath queries search for nodes in the context of the entire document. To specify the context for a particular expression, you can use variables in the format $context. If a matching variable exists, the query will be made relative to each variable node. If it doesn't and a matching property exists, the query will be made relative to the property node. If no matching variables or properties exist, the query return an empty list.

+

Examples

+
$headers:      //h1              # all <h1> tags on the page
+article:       //article         # the first <article> tag on the page
+$art_headers:  $article//h1      # all <h1> tags inside article
+$header_links: $art_headers//a   # all <a> tags inside each $art_headers node
+

Zeroing in on nodes

+

The result of an XPath query is always a list of matching nodes. If you'd like to narrow the list down to a single node, you can use the following syntax: (xpath_query)[n], where n is the number of the desired node. Numbering starts at 1, you can get the last node by using the last() function. This syntax can only be applied to the entire expression.

+

Examples

+
$headers:    //h1                    # all <h1> tags on the page
+$header2:    (//h1)[2]               # the second <h1> tag on the page
+$header2:    ($headers)[2]           # same
+$last_link:  ($header2//a)[last()]   # the last link inside $header2
+

has-class

+

You will often need to locate nodes that have a certain class. To do this, you can use the has-class("class") function that serves as an alias for the expression contains(concat(" ", normalize-space(@class), " "), " class ").

+

Examples

+
# Transform all div.header elements into h1
+<h1>: //div[contains(concat(" ", normalize-space(@class), " "), " header ")]
+# same idea, but much shorter
+<h1>: //div[has-class("header")]
+

ends-with

+

XPath has a starts-with function that checks whether the first string starts with the second string but does not have ends-with. In IV you can use the ends-with("haystack","needle") function that serves as an alias for the expression (substring("haystack", string-length("haystack") - string-length("needle") + 1) = "needle").

+

Examples

+
# Select all JPG images
+@debug: //img[(substring(@src, string-length(@src) - string-length(".jpg") + 1) = ".jpg")]
+# the same, but much shorter
+@debug: //img[ends-with(@src, ".jpg")]
+

prev-sibling

+

An axis that selects the previous sibling of the current node. Serves as an alias for the expression preceding-sibling::*[1]/self.

+

Examples

+
# Transform all div nodes, that immediately follow img nodes into figcaption
+<figcaption>: //div[./preceding-sibling::*[1]/self::img]
+# the same
+<figcaption>: //div[./prev-sibling::img]
+

next-sibling

+

An axis that selects the next sibling of the current node. Serves as an alias for the expression following-sibling::*[1]/self

+

Examples

+
# Join paragraphs following each other into one, separating them with a line break
+@combine(<br>): //p/following-sibling::*[1]/self::p
+# the same, but shorter
+@combine(<br>): //p/next-sibling::p
+

Supported conditions

+

Below are conditions supported in Instant View rules.

+

domain

+
domain: regexp
+

Checks whether the domain of the current page matches a regular expression. The check is case-insensitive, so the actual expression used will look like this: /^regexp$/i.

+

Examples

+
# Rule for *.subdomain.example.com URLs
+?domain: .+\.subdomain\.example\.com
+

domain_not

+
domain_not: regexp
+

Checks whether the domain of the current page does not match a regular expression. The check is case-insensitive, so the actual expression used will look like this: /^regexp$/i.

+

Examples

+
# Rule for *.subdomain.example.com URLs with an exception for dev.subdomain.example.com
+?domain:     .+\.subdomain\.example\.com
+!domain_not: dev\.subdomain\.example\.com
+

path

+
path: regexp
+

Checks whether the path to the current page matches a regular expression. The check is case-insensitive, so the actual expression used will look like this: /^regexp$/i.

+

Examples

+
# Rule for example.com/news/* links
+?path: /news/.+   # no need to escape the slash
+

path_not

+
path_not: regexp
+

Checks whether the path to the current page does not match a regular expression. The check is case-insensitive, so the actual expression used will look like this: /^regexp$/i.

+

Examples

+
# Rule for example.com/news/* links with an exception for example.com/news/recent
+?path:     /news/.+
+!path_not: /news/recent
+

exists

+
exists: xpath_query
+

Checks whether target nodes exist on the current page.

+

Examples

+
# Apply rule only to pages with an <article> tag
+?exists: //article
+

not_exists

+
not_exists: xpath_query
+

Checks whether target nodes do not exist on the current page.

+

Examples

+
# Apply rule only to pages with an <article> tag, that do not include any quotes.
+?exists:     //article
+!not_exists: //article//blockquote
+

true

+
true
+

A condition that is always true.

+

Examples

+
?path:    /blog/.+
+# Rules for the blog section go here
+?true
+# Rules that go here will be applied to all pages
+

false

+
false
+

A condition that is always false.

+

Examples

+
?path:    /news/.+
+# Rules for the news section go here
+?false
+# Rules that go here will never be applied
+

Supported options

+

Below are options supported in Instant View rules.

+

version

+
~version: "2.1"
+

Sets the version of IV used in the template. The behavior of some IV functions may change according to the version provided (see the manual of corresponding function).
The value must be one of "1.0", "2.0" or "2.1". We recommend using the latest version, 2.1.

+

Examples

+
~version: "2.1"
+# Now you can use new features from IV 2.1
+
+

Please note that version should be set at the beginning of the template before any other rules.

+
+

allowed_origin NEW

+
~allowed_origin: "https://example.com"
+~allowed_origin: ["https://example.com", "https://subdomain.example.com"]
+

Sets the origin (or the list of origins) from which content can be loaded using the @load and @inline functions.
The value should be String or Array of String.

+

Examples

+
~allowed_origin: "https://api.example.com"
+# Now you can load content from https://api.example.com regardless of the origin of current page
+@load: "https://api.example.com/get/article"
+

Supported functions

+

The general format for a function is the following:

+
@function: xpath_query
+

Each function accepts the list of nodes returned by the XPath statement as the main parameter. You may omit xpath_query, in which case $$, the result of the previous XPath query, will be passed into the function. The function then processes each element in the list and returns a list of transformed nodes which are stored in the $@ variable.

+

Below is a list of functions that are supported in Instant View rules.

+

debug

+
@debug: xpath_query
+

Logs the elements passed into the function, these elements will be displayed in the status line at the bottom of the screen in the Instant View Editor. Returns the elements passed. Consider combining with $$ and $@.

+

Example

+
@debug: //article//a     # displays all links from the page in the log
+@debug                   # displays all links again
+

+ +

Look for debug output at the bottom of your Editor:

+
+ +
+ + +

remove

+
@remove: xpath_query
+

Removes target nodes from the page, returns an empty list.

+

Examples

+
@remove: //div[has-class("related")] # remove article div.related
+@debug                               # empty list
+

append

+
@append("Some text"): xpath_query
+@append(@attr):       xpath_query
+@append(<tag>):       xpath_query
+@append(<tag>, attr, value[, attr, value[, ...]]): xpath_query
+

Inserts content, specified by the parameter, to the end of each target node.

+
    +
  • If the first parameter is in angle brackets, a new <tag> node will be created. The following two parameters then specify the name and value of an attribute for that node. If value has the format @attr, the value of the attribute attr in the target node will be used as the value. value can be an XPath expression that begins with ., in this case the query will be executed relative to the relevant node, and the text value of the returned elements will be used as the attribute's value. Otherwise, value will be used as the attribute's value.
    • +
  • If the first parameter has the format @attr, a new text element with value of the attribute attr of the targeted node will be created.
    • +
  • Otherwise, a text element with the text specified in the first parameter will be created.
    • +
+

Returns a list of the newly created nodes.

+

Examples

+
# <div class="a"><em>1</em></div>
+@append(<p>): //div
+# <div class="a"><em>1</em><p></p></div>
+

prepend

+
@prepend("Some text"): xpath_query
+@prepend(@attr):       xpath_query
+@prepend(<tag>):       xpath_query
+@prepend(<tag>, attr, value[, attr, value[, ...]]): xpath_query
+

Inserts content, specified by the parameter, to the beginning of each target node.

+
    +
  • If the first parameter is in angle brackets, a new <tag> node will be created. The following two parameters then specify the name and value of an attribute for that node. If value has the format @attr, the value of the attribute attr in the target node will be used as the value. value can be an XPath expression that begins with ., in this case the query will be executed relative to the relevant node, and the text value of the returned elements will be used as the attribute's value. Otherwise, value will be used as the attribute's value.
    • +
  • If the first parameter has the format @attr, a new text element with value of the attribute attr of the targeted node will be created.
    • +
  • Otherwise, a text element with the text specified in the first parameter will be created.
    • +
+

Returns a list of the newly created nodes.

+

Examples

+
# <div class="a"><em>1</em></div>
+@prepend(<p>, data-class, @class): //div
+# <div class="a"><p data-class="a"></p><em>1</em></div>
+

after

+
@after("Some text"): xpath_query
+@after(@attr):       xpath_query
+@after(<tag>):       xpath_query
+@after(<tag>, attr, value[, attr, value[, ...]]): xpath_query
+

Inserts content, specified by the parameter, after each target node.

+
    +
  • If the first parameter is in angle brackets, a new <tag> node will be created. The following two parameters then specify the name and value of an attribute for that node. If value has the format @attr, the value of the attribute attr in the target node will be used as the value. value can be an XPath expression that begins with ., in this case the query will be executed relative to the relevant node, and the text value of the returned elements will be used as the attribute's value. Otherwise, value will be used as the attribute's value.
    • +
  • If the first parameter has the format @attr, a new text element with value of the attribute attr of the targeted node will be created.
    • +
  • Otherwise, a text element with the text specified in the first parameter will be created.
    • +
+

Returns a list of the newly created nodes.

+

Examples

+
# <div class="a"><em>1</em><em>2</em></div>
+@after("!"): //div/em
+# <div class="a"><em>1</em>!<em>2</em>!</div>
+

before

+
@before("Some text"): xpath_query
+@before(@attr):       xpath_query
+@before(<tag>):       xpath_query
+@before(<tag>, attr, value[, attr, value[, ...]]): xpath_query
+

Inserts content, specified by the parameter, before each target node.

+
    +
  • If the first parameter is in angle brackets, a new <tag> node will be created. The following two parameters then specify the name and value of an attribute for that node. If value has the format @attr, the value of the attribute attr in the target node will be used as the value. value can be an XPath expression that begins with ., in this case the query will be executed relative to the relevant node, and the text value of the returned elements will be used as the attribute's value. Otherwise, value will be used as the attribute's value.
    • +
  • If the first parameter has the format @attr, a new text element with value of the attribute attr of the targeted node will be created.
    • +
  • Otherwise, a text element with the text specified in the first parameter will be created.
    • +
+

Returns a list of the newly created nodes.

+

Examples

+
# <div class="a"><em>1</em></div>
+@before("@"): //div/em
+# <div class="a">@<em>1</em></div>
+

append_to

+
@append_to(xpath_query): xpath_query
+@append_to($var):        xpath_query
+

Inserts each target node to the end of the base node.

+

The first parameter specifies the base node. You can pass an XPath expression that begins with ., in this case the query will be executed relative to the relevant node. The first relevant node will be used as the base node. You can also pass a variable name. If such a variable exists, the first relevant node will be used as the base node. If the variable doesn't exist or is empty, the property with a matching name will be used as the base node.

+

Returns a list of target nodes.

+

Examples

+
$div:             //div
+# <div class="a"><em></em></div><p>Text</p>
+@append_to($div): //p
+# <div class="a"><em></em><p>Text</p></div>
+

prepend_to

+
@prepend_to(xpath_query): xpath_query
+@prepend_to($var):        xpath_query
+

Inserts each target node to the beginning of the base node.

+

The first parameter specifies the base node. You can pass an XPath expression that begins with ., in this case the query will be executed relative to the relevant node. The first relevant node will be used as the base node. You can also pass a variable name. If such a variable exists, the first relevant node will be used as the base node. If the variable doesn't exist or is empty, the property with a matching name will be used as the base node.

+

Returns a list of target nodes.

+

Examples

+
$div:              //div
+# <div class="a"><em></em></div><p>Text</p>
+@prepend_to($div): //p
+# <div class="a"><p>Text</p><em></em></div>
+

after_el

+
@after_el(xpath_query): xpath_query
+@after_el($var):        xpath_query
+

Inserts each target node after the base node.

+

The first parameter specifies the base node. You can pass an XPath expression that begins with ., in this case the query will be executed relative to the relevant node. The first relevant node will be used as the base node. You can also pass a variable name. If such a variable exists, the first relevant node will be used as the base node. If the variable doesn't exist or is empty, the property with a matching name will be used as the base node.

+

Returns a list of target nodes.

+

Examples

+
$div:                        //div
+# <div class="a"><p>Text</p><em></em></div>
+@after_el("./../self::div"): //p
+# <div class="a"><em></em></div><p>Text</p>
+

before_el

+
@before_el(xpath_query): xpath_query
+@before_el($var):        xpath_query
+

Inserts each target node before the base node.

+

The first parameter specifies the base node. You can pass an XPath expression that begins with ., in this case the query will be executed relative to the relevant node. The first relevant node will be used as the base node. You can also pass a variable name. If such a variable exists, the first relevant node will be used as the base node. If the variable doesn't exist or is empty, the property with a matching name will be used as the base node.

+

Returns a list of target nodes.

+

Examples

+
$div:                        //div
+# <div class="a"><p>Text</p><em></em></div>
+@before_el("./../self::div"): //p
+# <p>Text</p><div class="a"><em></em></div>
+

replace_tag

+
@replace_tag(<tag>):     xpath_query
+<tag>:                   xpath_query
+

Changes the name of the tag. The new name for the tag should be passed as the first parameter. Returns target nodes.

+

Examples

+
# <div class="list unordered"><div class="item"></div><div class="item"></div></div>
+@replace_tag(<li>): //div[has-class("item")]
+<ul>:               //div[has-class("list")]
+# <ul class="list unordered"><li class="item"></li><li class="item"></li></ul>
+

wrap

+
@wrap(<tag>): xpath_query
+

Wrap each target node in the <tag> tag. Returns a list of the new <tag> elements.

+

Examples

+
# <em>1</em><em>2</em>
+@wrap(<b>): //em
+# <b><em>1</em></b><b><em>2</em></b>
+@wrap(<u>)
+# <b><u><em>1</em></u></b><b><u><em>2</em></u></b>
+@wrap(<p>): $@
+# <b><p><u><em>1</em></u></p></b><b><p><u><em>2</em></u></p></b>
+

wrap_inner

+
@wrap_inner(<tag>): xpath_query
+

Wrap an HTML structure around the content of each target node in the <tag> tag. Returns a list of new <tag> elements.

+

Examples

+
# <p>H<sub>2</sub>0</p>
+@wrap_inner(<b>): //p
+# <p><b>H<sub>2</sub>0</b></p>
+

clone

+
@clone: xpath_query
+

Creates a copy of each target node. Returns a list of the newly created nodes.

+

Examples

+
# <p class="text">Paragraph</p>
+@clone: //p
+# <p class="text">Paragraph</p><p class="text">Paragraph</p>
+

detach

+
@detach: xpath_query
+

Separates the target node from the rest in the parent tag. Creates a copy of the parent tag and wraps the target node into this new instance. Returns a list of parent tags that contain target nodes.

+

Examples

+
# <a href="#1">
+#   <b>1</b>
+#   <p>Link #1</p>
+# </a>
+# <a href="#2">
+#   <b>2</b>
+#   <p>Link #2</p>
+# </a>
+
+@detach: //a/b
+
+# <a href="#1">
+#   <b>1</b>
+# </a>
+# <a href="#1">
+#   <p>Link #1</p>
+# </a>
+# <a href="#2">
+#   <b>2</b>
+# </a>
+# <a href="#2">
+#   <p>Link #2</p>
+# </a>
+
+@after(<br>): $@
+
+# <a href="#1">
+#   <b>1</b>
+# </a><br>
+# <a href="#1">
+#   <p>Link #1</p>
+# </a>
+# <a href="#2">
+#   <b>2</b>
+# </a><br>
+# <a href="#2">
+#   <p>Link #2</p>
+# </a>
+

split_parent

+
@split_parent: xpath_query
+

Splits the parent tag by the target node. Places preceding siblings wrapped into parent element before the target node. Places following siblings wrapped into parent element placed after target node.

+

Returns a list of target nodes.

+

Examples

+
# <p class="text">
+#   <b>First</b> line
+#   <figure><img src="photo.jpg"></figure>
+#   <i>Second</i> line
+# </p>
+@split_parent: //p/figure
+# <p class="text">
+#   <b>First</b> line
+# </p>
+# <figure><img src="photo.jpg"></figure>
+# <p class="text">
+#   <i>Second</i> line
+# </p>
+

pre

+
@pre: xpath_query
+

Specifies that the text inside the target node is already formatted. Returns a list of matching nodes.

+

Examples

+
# <p>     Some          text  , </p>
+# <p>  Some  another      text  </p>
+@pre: (//p)[1]
+# Result in the Instant View page:
+#      Some          text  , 
+# Some another text
+

set_attr

+
@set_attr(attr, value):       xpath_query
+@set_attr(attr, @attr):       xpath_query
+@set_attr(attr, "Some text"): xpath_query
+@set_attr(attr, "Some text", @from-attr, ...): xpath_query
+

Sets an attribute in each matching node. The name of the attribute is passed in the first parameter. The value of the attribute is the rest of the parameters concatenated.

+

If value has the format @attr, the value of the attribute attr of the target node will be used as the value. value can be an XPath expression that begins with ., in this case the query will be executed relative to the relevant node, and the text value of the returned elements will be used as the attribute's value. Otherwise, value will be used as the attribute's value.

+

Returns a list of attribute nodes.

+

Examples

+
# <p class="a"></p>
+@set_attr(data-class, @class)
+# <p class="a" data-class="a"></p>
+@set_attr(id, @class, "_", ./@data-class)
+# <p class="a" data-class="a" id="a_a"></p>
+

set_attrs

+
@set_attrs(attr, value): xpath_query
+@set_attrs(attr, value[, attr, value[, ...]]): xpath_query
+

Sets multiple attributes for each of the target nodes. Each two parameters specify the name and value for the new attributes.

+

If value has the format @attr, the value of the attribute attr of the target node will be used as the value. value can be an XPath expression that begins with ., in this case the query will be executed relative to the relevant node, and the text value of the returned elements will be used as the attribute's value. Otherwise, value will be used as the attribute's value.

+

Returns a list of the matching nodes.

+

Examples

+
# <p class="a"></p>
+@set_attrs(data-class, @class, id, "a_a"): //p
+# <p class="a" data-class="a" id="a_a"></p>
+

match

+
@match(regexp):                         xpath_query
+@match(regexp, match_index):            xpath_query
+@match(regexp, match_index, modifiers): xpath_query
+

Performs a search based on a regular expression. Replaces the content of the target node with the search result. The second parameter specifies the number of the captured parenthesized subpattern. If this is not specified, the text that matched the full pattern will be used. You can specify modifiers for the regular expression using the optional parameter (ims modifiers are supported).

+

Returns a list of target nodes. As of IV 2.1, returns a list of target nodes the content of which matched the regular expression.

+

Examples

+
# <p class="plainText">Hello, world!</p>
+@match("[a-z]+!"): //p
+# <p class="plainText">world!</p>
+@match("([a-z]+)!", 1): //p/text()
+# <p class="plainText">world</p>
+@match("..t", 0, "i"): //p/@class
+# <p class="inT">Bye, world!</p>
+
+# <ul><li>a1</li><li>a</li><li>21b</li><li>.</li></ul>
+@match("[0-9]+"): //ul/li
+# <ul><li>1</li><li></li><li>21</li><li></li></ul>
+@debug: $@
+# Debug 2 nodes:
+#   [0]: <li>1</li>
+#   [1]: <li>21</li>
+

replace

+
@replace(regexp, replacement):            xpath_query
+@replace(regexp, replacement, modifiers): xpath_query
+

Performs a search and replace operation using the regular expression. You can specify modifiers for the regular expression using the optional parameter (ims modifiers are supported).

+

Returns a list of target nodes. As of IV 2.1, returns a list of target nodes the content of which was replaced by the regular expression.

+

Examples

+
# <p class="text">Hello, world!</p>
+@replace("Hello", "Goodbye"): //p/text()
+# <p class="text">Goodbye, world!</p>
+@replace(".t$", "mp"): //p/@class
+# <p class="temp">Goodbye, world!</p>
+@replace("goodb", "B", "i"): //p/text()
+# <p class="temp">Bye, world!</p>
+
+# <ul><li>a1</li><li>a</li><li>21b</li><li>.</li></ul>
+@replace("[0-9]+", "($0)"): //ul/li
+# <ul><li>a(1)</li><li>a</li><li>(21)b</li><li>.</li></ul>
+@debug: $@
+# Debug 2 nodes:
+#   [0]: <li>a(1)</li>
+#   [1]: <li>(21)b</li>
+

urlencode

+
@urlencode: xpath_query
+

Encodes the content of the target node as per RFC 3986. Returns target nodes.

+

Examples

+
# <a href="https://telegram.org">link</a>
+$a: //a
+@urlencode: $a/@href
+# <a href="https%3A%2F%2Ftelegram.org">link</a>
+@set_attr(href, "/?url=", @href): $a
+# <a href="/?url=https%3A%2F%2Ftelegram.org">link</a>
+

urldecode

+
@urldecode: xpath_query
+

Decodes the content of the target node as per RFC 3986. Returns target nodes.

+

Examples

+
# <a href="/?url=https%3A%2F%2Ftelegram.org">link</a>
+$a: //a
+@match("^/\?url=(.+)$", 1): $a/@href
+# <a href="https%3A%2F%2Ftelegram.org">link</a>
+@urldecode
+# <a href="https://telegram.org">link</a>
+

htmlencode

+
@htmlencode: xpath_query
+

Convert special characters in the target node to HTML entities. Returns the target nodes.

+

Examples

+
# <p>&lt;b&gt;Some text&lt;\b&gt;</p>
+@htmlencode: //p
+# <p>&amp;lt;b&amp;gt;Some text&amp;lt;\b&amp;gt;</p>
+

htmldecode

+
@htmldecode: xpath_query
+

Convert special HTML entities in the target node back to characters. Returns the target nodes.

+

Examples

+
# <p>&amp;lt;b&amp;gt;Some text&amp;lt;\b&amp;gt;</p>
+@htmldecode: //p
+# <p>&lt;b&gt;Some text&lt;\b&gt;</p>
+

style_to_attrs

+
@style_to_attrs(css_prop, attr): xpath_query
+@style_to_attrs(css_prop, attr[, css_prop, attr[, ...]]): xpath_query
+

Gets a value of a CSS property from the style attribute and sets it into an attribute for each of the target nodes. Each two parameters specify the name for the new attribute and the name of CSS property. Returns a list of matching nodes.

+

Examples

+
# <img style="width: 20px; height: 20px">
+@style_to_attrs(width, data-width, height, data-height): //img
+# <img style="width: 20px; height: 20px" data-width="20" data-height="20">
+

background_to_image

+
@background_to_image: xpath_query
+

Transforms the target node with a background picture into an <img> tag with an src attribute. The target node must contain a style attribute with the background. Returns a list of transformed nodes.

+

Examples

+
# <div class="bg_image" style="background-image:url(image.jpg)"></div>
+@background_to_image: //div[has-class("bg_image")]
+# <img src="image.jpg">
+

json_to_xml

+
@json_to_xml: xpath_query
+

Transforms the content of the target node to the XML format. The contents must be in valid JSON format. The resulting XML tree will be inserted into the document. Returns the root element of the XML tree.

+

Examples

+
# <div data-var='{"a":1,"b":[1,2],"c":{"p":"Hello!"}}'></div>
+@json_to_xml: //div/@data-var
+@debug: $@
+# <xml><a>1</a><b><item>1</item><item>2</item></b><c><p>Hello!</p></c></xml>
+

html_to_dom

+
@html_to_dom: xpath_query
+

Parse the content of the target node in HTML format and insert it into the document. Returns the root element of the inserted HTML tree.

+

Examples

+
# <div data-content="&lt;b&gt;Some text&lt;\b&gt;"></div>
+@html_to_dom: //div/@data-content
+@debug: $@
+# <dom><b>Some text</b></dom>
+

combine

+
@combine:                        xpath_query
+@combine(" - "):                 xpath_query
+@combine(<tag>):                 xpath_query
+@combine(<tag>[, " - "[, ...]]): xpath_query
+

Combines each target node with its preceding node if such a node exists. You can use parameters to specify nodes to be inserted above the target node. If the parameter is in angular brackets, a new <tag> node will be created. Otherwise a text element with the text specified by the parameter will be used.

+

Returns a list of nodes, preceding the target nodes.

+

Examples

+
# <pre>1 2 3</pre>
+# <pre> 4 5 </pre>
+# <pre>6 7 8</pre>
+@combine:             //pre/following-sibling::*[1]/self::pre
+# <pre>1 2 3 4 5 6 7 8</pre>
+
+# <p>first</p>
+# <p>second</p>
+@combine(<br>, <br>): //p/following-sibling::*[1]/self::p
+# <p>first<br><br>second</p>
+
+# <h1>Title</h1>
+# <strong>Subtitle</strong>
+@combine(<br>, "\n"): //h1/following-sibling::*[1]/self::strong
+# <h1>Title<br>
+# Subtitle</h1>
+

datetime

+
@datetime(-2): xpath_query
+@datetime(-2, "en-US", "yyyy-MM-dd"): xpath_query
+

Transforms the date and time from the text of the target node into a unixtime timestamp. The parameter specifies the timezone of the original date and time.

+

You can also pass a locale and a pattern to parse the date and time in more complicated cases. If a non-gregorian calendar is used, this needs to be specified in the locale. For example, "fa-IR@calendar=persian". Available patterns are documented here.

+

On success, returns a text element with the unixtime timestamp. Otherwise, returns the target element.

+

Examples

+
# <div id="date">1 January 2017, 15:04</div>
+@datetime(-2):  //div[@id="date"]
+published_date: $@   # the property published_date will hold a unixtime timestamp
+
+# <time>دوشنبه, ۲۳ اسفند ۱۳۹۵</time>
+@datetime(0, "fa-IR@calendar=persian", "EEEE, dd MMMM yyyy"): //time
+published_date: $@   # the property published_date will hold a unixtime timestamp
+

simplify

+
+

Note: This is a service function. There is no reason for you to use it in your templates. It was included in this reference to give you a better understanding of how the system works (see the ..after block).

+
+
@simplify: xpath_query
+

Processes the target nodes according to the Instant View format. Returns the target nodes.

+

Examples

+
# <p><span><b>S</b>ome</span> <em>important</em> text!</p>
+@simplify: //p
+# <p><b>S</b>ome <em>important</em> text!</p>
+

inline

+
@inline:         xpath_query
+@inline(silent): xpath_query
+

If the target element is an <iframe> with the attribute src, the content of the iframe will be loaded. The target element will be replaced with the content of the iframe.

+

If the target node is an HTML-comment, a <comment> element with the content of the comment will be created. The comment will be replaced by the newly created node.

+

You can use silent parameter to ignore errors while processing this function. You will still see an error in the debug console, but the rules that come after will continue to execute.

+

Returns a list of replaced nodes.

+
+

Note: The @inline function adheres to the same-origin policy. This means that the target and the inlined pages should have the same origin. You can specify additional allowed origins using the option ~allowed_origin

+
+

Examples

+
# <p><iframe src="/subpage.html"></iframe></p>
+# /subpage.html:
+#   <html><body><p>Hello!</p></body></html>
+@inline: //p/iframe
+# <p><html><body><p>Hello!</p></body></html></p>
+@debug
+# <html><body><p>Hello!</p></body></html>
+
+# <p><!--<b>Hello!</b>, world!--></p>
+@inline: //p/comment()
+# <p><comment><b>Hello!</b>, world!</comment></p>
+@debug
+# <comment><b>Hello!</b>, world!</comment>
+

load NEW

+
@load:         "https://example.com"
+@load(silent): xpath_query
+

Loads the content of the URL. The URL can be specified as a string or be the content of the target node.

+

You can use silent parameter to ignore errors while processing this function. You will still see an error in the debug console, but the rules that come after will continue to execute.

+

Returns the newly created node with loaded content.

+
+

Note: The @load function adheres to the same-origin policy. This means that the target and the loaded pages should have the same origin. You can specify additional allowed origins using the option ~allowed_origin

+
+

Examples

+
@append(<iframe> src "/subpage.html"): /html/body
+$iframe: $@
+@remove
+@inline: $iframe
+# the same, but much shorter
+@load: "/subpage.html"
+
+@load(silent): //meta[@property="api:url"]/@content
+# trying to load content from api:url
+@if ( $@ ) {
+  # Do something with content
+}
+

unsupported

+
@unsupported: xpath_query
+

Specifies that the target node contains essential content that can't be represented in the Instant View format. Returns the target nodes.

+

Examples

+
# <p>See the graph below:</p>
+# <canvas class="article_graph" width="600" height="400"></canvas>
+@unsupported: //canvas[has-class("article_graph")]
+
+

Tip: It is important to identify that a page contains essential unsupported content — no IV page will be generated to ensure that the user never gets incomplete info from an article. The system will take care of the most popular cases in the ..after block, but your template must cover everything that the system doesn't catch.

+
+

Supported block functions

+

The general format for a block function is the following:

+
@function(xpath_query) {
+  # block of rules
+}
+

Block functions usually accept the list of nodes returned by the XPath statement as a parameter. Depending on the function and its parameters, rules inside the block can be run several times or never. Block functions can contain any type of rules except conditions.

+

Below is a list of block functions that are supported in Instant View rules.

+

if

+
@if(xpath_query) {
+  # block of rules
+}
+

Executes the block of rules if target nodes exist on the current page. If target nodes do not exist, the block of rules will be skipped. The $$ and $@ variables contain target nodes found by the XPath query.

+

Example

+
@if( //div[has-class("blockquote")] ) { # if div.blockquote exists
+  <blockquote>: $@                      #   change tag name to blockquote
+  <cite>: $@//div[has-class("author")]  #   and mark div.author as a caption
+}
+

if_not

+
@if_not(xpath_query) {
+  # block of rules
+}
+

Executes a block of rules if target nodes do not exist on the current page. If such nodes exist, the block of rules will be skipped. The $$ and $@ variables contain target nodes found by the XPath query.

+

Example

+
@if_not( $body//footer ) {     # if footer does not exist
+  @append(<footer>): $body     #   append it into body
+}
+

map

+
@map(xpath_query) {
+  # block of rules
+}
+

Executes a block of rules once per each target node found by the XPath query. At the beginning of each iteration, the following variables will be set:

+
    +
  • $$ will contain the target nodes found by XPath query;
    • +
  • $@ will contain the current target node;
    • +
  • $index will contain the index of the current target node (starts with 1);
    • +
  • $first will contain <true> if the current target node is the first in the list and an empty list otherwise;
    • +
  • $middle will contain <true> if the current target node is between the first and the last in the list, empty list otherwise;
    • +
  • $last would contain <true> if the current target node is the last one in the list, empty list otherwise.
    • +
+

Example

+
@map( //div[@id="list"]/p ) {   # for each paragraph in list
+  $p: $@                        #   store the current paragraph in $p variable
+  @prepend_to($p): ". "         #   and
+  @prepend_to($p): $index       #   number them starting with 1
+}
+
+

Please note that the @map function should be used only if it is impossible to use regular functions with xpath queries (for example you need to use $index). Otherwise, regular functions are faster because they process several nodes at once.

+
+

Example

+
# Bad way:
+@map( //div[has-class("image")] ) {
+  $image: $@
+  <cite>:       $image//p/span
+  <figcaption>: $image//p
+  <figure>:     $image
+}
+# The same result, but faster:
+$image:       //div[has-class("image")]
+<cite>:       $image//p/span
+<figcaption>: $image//p
+<figure>:     $image
+

repeat

+
@repeat(n) {
+  # block of rules
+}
+

Executes a block of rules n times. At the beginning of each iteration, the following variables will be set:

+
    +
  • $$ and $@ will contain the previous value of $$;
    • +
  • $index will contain the index of the current iteration (starts with 1);
    • +
  • $first will contain <true> if this is the first iteration, an empty list otherwise;
    • +
  • $middle will contain <true> if the current iteration is between the first and last, empty list otherwise;
    • +
  • $last will contain <true> if this is the last iteration, empty list otherwise.
    • +
+

Example

+
# appends "1, 2, 3, 4, 5" to $body
+@repeat( 5 ) {
+  @append_to($body): $index
+  @if_not( $last ) {
+    @append_to($body): ", "
+  }
+}
+

while

+
@while(xpath_query) {
+  # block of rules
+}
+

Executes a block of rules while target nodes exist on the current page. At the beginning of each iteration the following variables will be set:

+
    +
  • $$ and $@ will contain target nodes found by XPath query;
    • +
  • $index will contain the index of the current iteration (starts with 1);
    • +
  • $first will contain <true> if it is the first iteration, an empty list otherwise.
    • +
+

Example

+
@while( //iframe ) {
+  @inline: $@          # inline all nested iframes
+}
+

while_not

+
@while_not(xpath_query) {
+  # block of rules
+}
+

Executes a block of rules while target nodes do not exist on the current page. At the beginning of each iteration the following variables will be set:

+
    +
  • $$ and $@ will contain target nodes found by XPath query;
    • +
  • $index will contain the index of the current iteration (starts with 1);
    • +
  • $first will contain <true> if this is the first iteration, an empty list otherwise.
    • +
+

Example

+
@while_not( //video ) {   # if no video exists on the current page
+  @inline: //iframe       #   try to inline iframes, maybe video is inside the frame
+}
+

Embedded elements

+

Instant View supports widgets from popular services. We display them as embedded elements or specially formatted quotes. The Instant View bot analyzes all iframes in the document body and generates a widget if the service is supported.

+
+

Some popular widgets do not use iframes. Note that the ..after block of rules contains rules to transform such widgets to an Instant View compatible format.

+
+

We currently support the following services:

+
    +
  • Youtube
    • +
  • Vimeo
    • +
  • Tweets & Twitter Videos
    • +
  • Facebook Posts & Videos
    • +
  • Instagram
    • +
  • Giphy
    • +
  • SoundCloud
    • +
  • GithubGist
    • +
  • Aparat
    • +
  • VK.com Videos
    • +
+

Processing pages

+

All pages are processed according to the following rules:

+
# Url: http://example.com/some_page.html
++ example.com
+?true
++ ..after
+

If a page is on a third-level domain and above, the following rules are applied:

+
# Url: http://some.subdomain.example.com/some_page.html
++ some.subdomain.example.com
+?not_exists: $body
++ subdomain.example.com
+?not_exists: $body
++ example.com
+?true
++ ..after
+

In other words, at first the bot attempts to use a block of rules that features the full domain name. If such a block does not exist, the bot checks for the next level up to the second-level domain.

+

..after is a special block of rules that is applied to all pages irrespective of the domain name.

+

Working with subdomains

+

If the page is on a third-level domain or higher, you need to manually select the domain level to which your template will apply. Use this menu in the top left corner of the page:

+
+
+
+ +

Choose a level that hosts pages with the same structure, so that your rules are relevant to all the matching pages on this domain.

+
+

For example, use wikipedia.org to create an IV page for https://en.wikipedia.org/wiki/Domain_name because the page structure doesn't depend on language in Wikipedia.

+
+
+ +
+
+
+
+
+ + + + + + + + + + + + + + diff --git a/data/telegram.org/blog.html b/data/telegram.org/blog.html new file mode 100644 index 0000000000..3846a1517b --- /dev/null +++ b/data/telegram.org/blog.html @@ -0,0 +1,268 @@ + + + + + Telegram Blog + + + + + + + + + + + + + + + + + + + +
+
+
+
+
+ + +
+
+
+
+
+
+

Telegram News

+
+
+ +
+

Live Streams, Flexible Forwarding, Jump to Next Channel, Trending Stickers and More

+
Telegram 8.0 brings live streams with unlimited viewers to groups and channels, options to…
+
+
Aug 31, 2021
+
+ +
+

Video Calls with up to 1000 Viewers, Video Messages 2.0, Video Playback Speed and More

+
This update takes video to the next level. Group video calls now have up to 1000 viewers,…
+
+
Jul 30, 2021
+
+ +
+

Group Video Calls

+
Today's update lets you turn on your camera or share your screen during Voice Chats in groups – on all devices, including tablets and desktops. This brings voice chats to a whole new…
+
+
Jun 25, 2021
+
+ +
+

Animated Backgrounds

+
In addition to Group Video Calls, this update adds animated backgrounds and message sending animations, as well as a new menu button for bots, new ways to import stickers, reminders…
+
+
Jun 25, 2021
+
+ +
+

Payments 2.0, Scheduled Voice Chats, New Web Versions

+
This update brings Payments 2.0 for all Telegram chats, Scheduling and Mini Profiles for Voice Chats, new versions of Telegram Web for…
+
+
Apr 26, 2021
+
+ +
+

Voice Chats 2.0: Channels, Millions of Listeners, Recorded Chats, Admin Tools

+
Voice Chats first appeared in December, adding a new dimension of live talk to Telegram groups. Starting today, they become available in…
+
+
Mar 19, 2021
+
+ +
+

Auto-Delete, Widgets and Expiring Invite Links

+
This update brings an auto-delete timer for messages in any chat, as well as new flexible invite links and faster access to your chats…
+
+
Feb 23, 2021
+
+ +
+

Moving Chat History from Other Apps

+
Over 100 million new users joined Telegram this January, seeking more privacy and freedom. But what about the messages and memories that remain in older apps? Starting today, everyone…
+
+
Jan 28, 2021
+
+ +
+

Voice Chats Done Right

+
Today, Telegram groups get an entire new dimension with Voice Chats – persistent conference calls that members can join and leave as they please. Our 12th update in 2020 brings them…
+
+
Dec 23, 2020
+
+ +
+

Pinned Messages 2.0, Improved Live Locations, Playlists and More

+
Halloween is just around the corner and we've assembled choice tools to help organize your trick-or-treating. Practice your voodoo skills…
+
+
Oct 30, 2020
+
+ +
+

Search Filters, Anonymous Admins, Channel Comments and More

+
Your personal Telegram Cloud is endless and full of spicy memes – to help you find your way around it, we're introducing Search Filters.…
+
+
Sep 30, 2020
+
+ +
+

Video Calls and Seven Years of Telegram

+
Today marks seven years of Telegram. In 2013, we began as a small app focused on secure messaging and have since grown into a platform with over 400M users. Now this platform also…
+
+
Aug 14, 2020
+
+ +
+

Profile Videos, 2 GB File Sharing, Group Stats, Improved People Nearby and More

+
Today's update brings Profile Videos along with improved People Nearby features, unlimited file sharing with up to 2 Gigabytes per file…
+
+
Jul 26, 2020
+
+ +
+

Video Editor, Animated Photos, Better GIFs and More

+
In 2015, Telegram released the most powerful photo editor to be implemented in a messaging app, letting you enhance image quality and add…
+
+
Jun 4, 2020
+
+ +
+

400 Million Users, 20,000 Stickers, Quizzes 2.0 and €400K for Creators of Educational Tests

+
Telegram has reached 400,000,000 monthly users, up from 300 million a year ago. Every day…
+
+
Apr 24, 2020
+
+ +
+

Coronavirus News and Verified Channels

+
Channels are a tool for broadcasting your public messages to large audiences. They offer a unique opportunity to reach people directly, sending a notification to their phones with…
+
+
Apr 3, 2020
+
+ +
+

Chat Folders, Archive, Channel Stats and More

+
Many of our users rely on Telegram for their work and studies, even more so in the last weeks. To make sure everyone's chat lists can handle…
+
+
Mar 30, 2020
+
+ +
+

New Profiles, Fast Media Viewer and People Nearby 2.0

+
Hundreds of millions rely on Telegram to share precious moments with their loved ones. Today we're making it easier to relive shared memories…
+
+
Feb 13, 2020
+
+ +
+

Polls 2.0: Visible Votes, Multiple Answers, and Quiz Mode

+
Since we first added polls for groups and channels, they've been used for everything from deciding where to have lunch to organizing leaderless…
+
+
Jan 23, 2020
+
+ +
+

Verifiable Builds, New Theme Editor, Send When Online and So Much More

+
Introducing Reproducible Apps, Theme Editor 2.0, Send When Online and So Much More
+
+
Jan 1, 2020
+
 +
+ +
+ +
+
+
+
+
+
+
Telegram
+
+ Telegram is a cloud-based mobile and desktop messaging app with a focus on security and speed. +
+ +
+
About
+ +
+
+
Mobile Apps
+ +
+
+
Desktop Apps
+ +
+
+
Platform
+ +
+
+
+
+
About
+
+
+
Blog
+
+
+
Apps
+
+
+
Platform
+
+
+
Twitter
+
+
+
+ + + + + + diff --git a/data/telegram.org/blog/pinned-messages-locations-playlists/world.html b/data/telegram.org/blog/pinned-messages-locations-playlists/world.html new file mode 100644 index 0000000000..a993c3e5fe --- /dev/null +++ b/data/telegram.org/blog/pinned-messages-locations-playlists/world.html @@ -0,0 +1,278 @@ + + + + + Pinned Messages 2.0, Improved Live Locations, Playlists and More + + + + + + + + + + + + + + + + + + + +
+
+
+
+
+ + +
+
+
+
+
+
+
+
+ Recent News +
+ +
Aug 31
+
Live Streams, Flexible Forwarding, Jump to Next Channel, Trending Stickers and More
+ +
Jul 30
+
Video Calls with up to 1000 Viewers, Video Playback Speed, Video Messages 2.0 and More
+ +
Jun 25
+
Group Video Calls
+ +
Jun 25
+
Animated Backgrounds
+ +
Apr 26
+
Payments 2.0, Scheduled Voice Chats, New Web Versions
+ +
Mar 19
+
Voice Chats 2.0: Channels, Millions of Listeners, Recorded Chats, Admin Tools
+ +
Feb 23
+
Auto-Delete, Widgets and Expiring Invite Links
+ +
+
+
+
+
+

Pinned Messages 2.0, Improved Live Locations, Playlists and More

+ +
+
+
+ +
+ +
+ +

Starting today you can pin several messages in every chat, get notified when friends get near if they are sharing their Live Location, send music as Playlists, and more.

+

Multiple Pinned Messages

+

Each chat now supports multiple pinned messages. To jump between them, simply tap the top bar several times – or use the new button to see all pinned messages on a separate page.

+
+ +
+ +

In addition to channels and groups, pinned messages now work in one-on-one chats.

+

Improved Live Locations

+

When friends share their live location, you can set up an alert that will notify you when they're close. Icons on the live location map also show which direction people are facing.

+
+ +
+ +

Playlists

+

When you send multiple songs at once, they'll be arranged together in a playlist – easier to play, forward, or comment on. Opening one of the songs will queue them all up in Telegram's built-in media player.

+
+ Playlist sent to a chat +
+ +

Sending multiple files together also displays them in one chat bubble. Just like with photo albums, you can always select each file or track individually.

+

Channel Post Stats

+

Comments have boosted subscriber activity in channels, and now we're introducing new tools for admins to track it. In addition to channel statistics, you can view stats for individual posts in your channel – including a list of public channels to which your post was forwarded.

+
+ Channel post stats page +
+ + +

New Animations on Android

+

Our Android developers added new animations for sending messages and switching songs in the music player.

+
+ +
+ +

Also on Android: when viewing a photo you’ve received, you can edit and send it back right away, instead of downloading and uploading it again. Just tap the brush button when viewing a photo to quickly draw or put stickers on it.

+

Jackpot

+

Send 🎰 to any chat to see if you hit the jackpot.

+
+ +
+ +

In case you missed it, this also works for 🎲, 🏀, ⚽️ and 🎯.

+

And More Animated Emoji

+

We've animated some new emoji for Halloween. To get one of these 👇 in a chat, simply send a message with a single emoji. When viewing animated emoji in chats, try tapping on ⚰️ or 🎃 for a surprise.

+
+ +
+ +

If you are not a fan of Halloween, we've got another new animated emoji for you:

+
+ +
+ +

How to Get This Update

+

The new version with these features is already available for all our Android users via Google Play or APK. If you're on iOS, you'll get the update as soon as either a) Apple finishes reviewing it OR b) you decide it's time to switch to Android. 👀 UPD: (October, 31) The iOS part of the update has now also been approved.

+

And that's it for today, stay tuned for the next update!

+

+ +

October 30, 2020
The Telegram Team

+
+ +
+
+ Forward + Tweet +
+ +
+
+

+ Other News +

+
+
+ +
+

Live Streams, Flexible Forwarding, Jump to Next Channel, Trending Stickers and More

+
Telegram 8.0 brings live streams with unlimited viewers to groups and channels, options to…
+
+
Aug 31, 2021
+
+ +
+

Video Calls with up to 1000 Viewers, Video Messages 2.0, Video Playback Speed and More

+
This update takes video to the next level. Group video calls now have up to 1000 viewers,…
+
+
Jul 30, 2021
+
+ +
+

Group Video Calls

+
Today's update lets you turn on your camera or share your screen during Voice Chats in groups – on all devices, including tablets and desktops. This brings voice chats to a whole new…
+
+
Jun 25, 2021
+
+ +
+

Animated Backgrounds

+
In addition to Group Video Calls, this update adds animated backgrounds and message sending animations, as well as a new menu button for bots, new ways to import stickers, reminders…
+
+
Jun 25, 2021
+
 +
+
+ +
+
+
+
+
+
+
Telegram
+
+ Telegram is a cloud-based mobile and desktop messaging app with a focus on security and speed. +
+ +
+
About
+ +
+
+
Mobile Apps
+ +
+
+
Desktop Apps
+ +
+
+
Platform
+ +
+
+
+
+
About
+
+
+
Blog
+
+
+
Apps
+
+
+
Platform
+
+
+
Twitter
+
+
+
+ + + + + + + diff --git a/data/telegram.org/blog/video-1000.html b/data/telegram.org/blog/video-1000.html new file mode 100644 index 0000000000..3c130ed845 --- /dev/null +++ b/data/telegram.org/blog/video-1000.html @@ -0,0 +1,354 @@ + + + + + Video Calls with up to 1000 Viewers, Video Messages 2.0, Video Playback Speed and More + + + + + + + + + + + + + + + + + + + +
+
+
+
+
+ + +
+
+
+
+
+
+
+
+ Recent News +
+ +
Aug 31
+
Live Streams, Flexible Forwarding, Jump to Next Channel, Trending Stickers and More
+ +
Jul 30
+
Video Calls with up to 1000 Viewers, Video Playback Speed, Video Messages 2.0 and More
+ +
Jun 25
+
Group Video Calls
+ +
Jun 25
+
Animated Backgrounds
+ +
Apr 26
+
Payments 2.0, Scheduled Voice Chats, New Web Versions
+ +
Mar 19
+
Voice Chats 2.0: Channels, Millions of Listeners, Recorded Chats, Admin Tools
+ +
Feb 23
+
Auto-Delete, Widgets and Expiring Invite Links
+ +
+
+
+
+
+

Video Calls with up to 1000 Viewers, Video Messages 2.0, Video Playback Speed and More

+ +
+ +
+
+ +
+ Video Calls with up to 1000 Viewers, Video Messages 2.0, Video Playback Speed and More +
+ +

This update takes video to the next level. Group video calls now have up to 1000 viewers, video messages record in higher quality and can be expanded, regular videos may be watched at 0.5 or 2x speed. We've also added screen sharing with sound to all video calls, including 1-on-1 calls — and much more.

+

Group Video Calls 2.0

+

Group video calls allow up to 30 users broadcast video from both their camera and screen – and now 1000 people can watch anything from online lectures to live rap battles.

+

We will keep increasing this limit until all humans on Earth can join one group call and watch us yodel in celebration (coming soon).

+
+ +
+ +
+

To start a Group Video Call, create a Voice Chat from the info page (in the ⋮ menu on Android) of any group where you are an admin – then turn your video on.

+
+

Video Messages 2.0

+

Video messages are a quick way to check in or share your surroundings without adding another video to your gallery. They now have higher resolution and you can tap on a video message to expand it and take in all those extra pixels.

+
+ +
+ +

Tapping on an expanded video message pauses it and gives you the opportunity to fast forward or rewind the message in case you missed a word.

+
+

To record a video message, tap the microphone icon in the message bar to switch from voice message recording to video. Press and hold to record, then tap the camera icon to switch back.

+
+

Audio from your device will keep playing as you record so you can now sing along to your favorite songs or reply without pausing your podcast. Additionally, recording with your rear camera lets you pinch to zoom in and capture things at a distance or add a dramatic effect (eerie music not included).

+

Video Playback Speed

+

To power through lecture videos and replay kung fu moves in slow motion, the media player now supports 0.5x, 1.5x and 2x playback speeds. Our Android developer is a fan of hummingbirds, so his app also supports 0.2x speed.

+
+ +
+ +
+

To change your video playback speed, tap ⋮ on Android or ⋯ on iOS when watching a video in fullscreen.

+
+

On Android, you can also press and hold the 2X button when playing voice or video messages to switch between 0.5x, 1x, 1.5x and 2x playback speed.

+

Timestamp Links

+

Since 2019, putting a timestamp like 0:30 in the captions or replies to videos and YouTube links lets users jump to that exact second – and you can now press and hold on a timestamp in a message to copy the link and share the moment in another chat.

+

Screen Sharing With Sound

+

Screen sharing has been added to 1-on-1 calls as well, and now includes the sound from your device when broadcasting in any video call. So make sure you quit Super Mario before its your turn to present — or don't, and use the game for sound effects.

+
+ +
+ +

When switching on video during any call, you can swipe to choose a camera or share your screen instead — and use the video preview to make sure that everything is perfect before going live.

+ + +
+

To share your screen during a video call, tap the camera button and select your screen as the video source.

+
+

Auto-Delete After 1 Month

+

Messages in any chat can be set to erase themselves after 1 day or 1 week – and now 1 month, in case you need your chats to stick around for a full lunar cycle before disappearing.

+
+ Auto-Delete After 1 Month +
+ + + +
+

To enable the timer on Android, tap ⋮ > Clear History then choose a duration. On iOS, press and hold a message, tap Select > Clear Chat (top-left) > Enable Auto-Delete.

+
+

Precision Drawing

+

The media editor allows you to illustrate and decorate your photos and videos with drawings, text and stickers. To more easily add fine details (or that perfect mustache and pointy ears), the width of your brush now decreases as you zoom in – giving you the precision of a professional.

+
+ +
+ +
+

To change the width of your brush at any time, drag the dot up from the color selector.

+
+

The Telegram Desktop app now has its own photo editor to crop, rotate or flip images – and add drawings or stickers. Unique to desktop, your edited versions can be sent as uncompressed files by unchecking the Compress Images box.

+

Passcode Animations

+

New animations make the passcode lock interfaces even snappier than before. If you're using an animated background, it will also appear on the passcode lock screen. The disco never stops.

+
+ +
+ +

Password Recovery and Reminders

+

We've added a new prompt in Settings to help you practice entering your Two-Step Verification password.

+
+ Practice Your 2-Step Verification Password +
+ +

If you forgot your password, there is a new password reset option that works even if you don’t have a recovery email — as long as you're still logged into your account. The process will take 7 days and can be cancelled from any of your devices.

+

Message Sending Animations on Android

+

Like emoji and stickers, text messages have new lightweight animations – when you hit Send, your text smoothly transforms into the message bubble as it flies into the chat. iOS users received these energy-efficient animations in the previous update.

+
+ +
+ +

New In-App Camera on iOS

+

The in-app camera now utilizes all zoom levels on your device – including 0.5x and 2x if available. You can also press and hold to open a zoom wheel that lets you zoom in and out with granular control.

+
+ +
+ +
+

To use the in-app camera, tap the 📎 icon in the message bar and then tap the camera feed in the attachment menu.

+
+

More for iOS

+

Choose multiple recipients for forwarded messages by tapping 'Select' in the forwarding menu to share your best memes with all your best friends.

+
+ Forwarding to multiple recipients +
+ +

Scrolling with two fingers in the chat list quickly selects several chats for bulk actions like archive, delete or mark all as read.

+ + + + +

Profile pictures now follow the messages as you scroll in group chats so you always know who sent each one, even in long chains of one. word. after. another.

+
+ +
+ +

New Animated Emoji

+

No Telegram update is complete without new animated emoji. As always, simply send a message with a single emoji to get one of these in a chat:

+
+ +
+ + +

And that's all for today's update – we're working on the next one at 2X speed.

+

+ +

July 30, 2021
The Telegram Team

+
+ +
+
+ Forward + Tweet +
+ +
+
+

+ Other News +

+
+
+ +
+

Live Streams, Flexible Forwarding, Jump to Next Channel, Trending Stickers and More

+
Telegram 8.0 brings live streams with unlimited viewers to groups and channels, options to…
+
+
Aug 31, 2021
+
+ +
+

Group Video Calls

+
Today's update lets you turn on your camera or share your screen during Voice Chats in groups – on all devices, including tablets and desktops. This brings voice chats to a whole new…
+
+
Jun 25, 2021
+
+ +
+

Animated Backgrounds

+
In addition to Group Video Calls, this update adds animated backgrounds and message sending animations, as well as a new menu button for bots, new ways to import stickers, reminders…
+
+
Jun 25, 2021
+
+ +
+

Payments 2.0, Scheduled Voice Chats, New Web Versions

+
This update brings Payments 2.0 for all Telegram chats, Scheduling and Mini Profiles for Voice Chats, new versions of Telegram Web for…
+
+
Apr 26, 2021
+
 +
+
+ +
+
+
+
+
+
+
Telegram
+
+ Telegram is a cloud-based mobile and desktop messaging app with a focus on security and speed. +
+ +
+
About
+ +
+
+
Mobile Apps
+ +
+
+
Desktop Apps
+ +
+
+
Platform
+ +
+
+
+
+
About
+
+
+
Blog
+
+
+
Apps
+
+
+
Platform
+
+
+
Twitter
+
+
+
+ + + + + + +