Merge branch 'master' into master

Author: delivrance

README.md

@@ -12,6 +12,8 @@
 - [Download](https://github.com/pyrogram/plugins/archive/master.zip) and copy the desired plugin(s) into your *plugins* folder.
 - Enable plugins in your Client by telling Pyrogram to search on your folder with `plugins_dir="plugins"`:
   ```python
+  from pyrogram import Client
+
   app = Client("my_account", plugins_dir="plugins")
   ```
 - Done! Run your client with `app.run()`, the plugins will be automatically loaded.
@@ -38,4 +40,5 @@ You found a bug on a plugin or want to extend one? Or maybe you have ideas on ho
 Name | Description | Usage | License
 :--- | :--- | :--- | :---
 [**Haste**](plugins/haste), by [delivrance](//github.com/delivrance) | Upload text to hastebin.com and send its link | Reply to a group chat text message with `!haste` | MIT
-[**Replace**](plugins/replace), by [brightside](//github.com/bright5ide) | Search and Replace a part of a message to suggest user if he meant something else  | Reply to a group chat text message with `!r <old>/<new>` | MIT
+[**Welcome**](plugins/welcome), by [delivrance](//github.com/delivrance) | Greet new members with a welcome message | Run and wait for new members to join your groups | MIT
+[**Replace**](plugins/replace), by [brightside](//github.com/bright5ide) | Search and Replace a part of a message to suggest user if he meant something else  | Reply to a group chat text message with `!r <old>/<new>` | MIT

plugins/welcome/welcome.py

@@ -0,0 +1,35 @@
+# MIT License
+#
+# Copyright (c) 2018 Dan Tès <https://github.com/delivrance>
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+from pyrogram import Client, Emoji, Filters
+
+MENTION = "[{}](tg://user?id={})"
+MESSAGE = "{} Welcome to [Pyrogram](https://docs.pyrogram.ml/)'s group chat {}!"
+
+chats_filter = Filters.chat(["PyrogramChat", "PyrogramLounge"])
+
+
+@Client.on_message(chats_filter & Filters.new_chat_members)
+def welcome(client, message):
+    new_members = [MENTION.format(i.first_name, i.id) for i in message.new_chat_members]
+    text = MESSAGE.format(Emoji.SPARKLES, ", ".join(new_members))
+    message.reply(text, disable_web_page_preview=True)