add email support

v2.0

Author: ahmnouira

.gitignore

@@ -6,6 +6,10 @@ __pycache__/
 # C extensions
 *.so
 
+# .idea
+*.idea
+.idea/
+
 # Distribution / packaging
 .Python
 build/

.idea/.gitignore

@@ -5,12 +5,14 @@ This is a simple flask register-form application designed to run in multiple way
 * This app use _[MongoDB](https://www.mongodb.com/)_ as database supported by _[Flask-MongoAlchemy](https://pythonhosted.org/Flask-MongoAlchemy/)_ extension
 => So you have to install **MongoDB** database to run this locally 
 
-* uses _[Flask-SocketIO](https://github.com/miguelgrinberg/Flask-SocketIO)_ along with _Ajax_ for real time update
+* uses _[Flask-SocketIO](https://github.com/miguelgrinberg/Flask-SocketIO)_ along with _[Ajax](https://en.wikipedia.org/wiki/Ajax_(programming)_ for real time update
 
+* you will get an email if you have registered 
 
 # Overview
 ![index](/img/index.png)
 ![registered](/img/registered.png)
+![email](/img/email.png)
 
 # Running this app
 
@@ -31,6 +33,7 @@ This app is designed to run in different ways:
 ### running the app
 
 * After installing, you need to set your application _environment variable_ by running `export FLASK_APP=app.py`
+* run `export MAIL_PASSWORD=<your-email-password>` to set your email password _environment variable_ 
 * run the server using the script file `run.sh` by typing `./run`
 * Access the running app in a browser at the URL written to the console (most likely http://0.0.0.0:5000)
 

.idea/flask-simple-form.iml

@@ -0,0 +1 @@
+## This folder _contains the application  files_

.idea/inspectionProfiles/profiles_settings.xml

@@ -1,11 +1,13 @@
 from flask import Flask
 from app.config import Config
 from flask_mongoalchemy import MongoAlchemy
-
+from flask_socketio import SocketIO
+from flask_mail import Mail
 
 app = Flask(__name__)
 app.config.from_object(Config)
 db = MongoAlchemy(app)
-
+socketio = SocketIO(app)
+mail = Mail(app)
 
 from app import models, views

.idea/libraries/R_User_Library.xml

@@ -9,3 +9,10 @@ class Config(object):
     SECRET_KEY = os.environ.get('SECRET_KEY') or 'secret'
     # sets MongoDB database
     MONGOALCHEMY_DATABASE = 'flask-simple-form'
+    # send mail confi
+    MAIL_SERVER = os.environ.get('MAIL_SERVER') or 'smtp.googlemail.com'
+    MAIL_PORT = os.environ.get('MAIL_PORT') or 587 or 25  # 25 smtp port
+    MAIL_USE_TLS =  True
+    MAIL_USERNAME = os.environ.get('MAIL_USERNAME') or '[email protected]'
+    MAIL_PASSWORD = os.environ.get('MAIL_PASSWORD') ## set it using export MAIL_PASSWORD=<your-email-password>
+    

.idea/misc.xml

@@ -0,0 +1,20 @@
+from app import app, mail
+from flask_mail import Message
+from flask import render_template
+from threading import Thread
+
+def send_email_helper(subject , sender, recipients, text_body, html_body):
+    msg = Message(subject, sender=sender, recipients=recipients)
+    msg.body = text_body
+    msg.html = html_body
+    Thread(target=send_sync_email, args=(app, msg)).start()
+
+
+def send_sync_email(app, msg):
+    with app.app_context():
+        mail.send(msg)
+
+def send_mail(user):
+    send_email_helper('[Flask-Simple-Form] Notification', sender=app.config['MAIL_USERNAME'], \
+    recipients=[user.email], text_body = render_template('email/register_notification.txt', user=user),
+    html_body = render_template('email/register_notification.html', user=user))

.idea/modules.xml

@@ -0,0 +1 @@
+## This folder contains email files

.idea/vcs.xml

@@ -0,0 +1,28 @@
+
+
+<div style=" background-color: #3b4b54; width : 100%;
+	height: 100%;
+	margin: 0 auto;
+  	font-size: 110%;
+	color: #ffffff;
+	font-family: sans-serif;">
+
+ <img style=" padding-top: 10%;
+	    display: block;
+	    margin: 0 auto;
+	    padding-bottom: 2em;
+	    max-width:200px;" src="https://raw.githubusercontent.com/AhmNouira/flask-simple-form/master/app/static/images/newapp-icon.png" alt="newapp" />
+
+<div style="text-align: center;">
+<h2> Dear {{ user.first_name }}, {{user.last_name}} </h2>
+<h2>
+    Thanks for registering to <a style="color: #00aed1; text-decoration:none;"  href="https://github.com/AhmNouira/flask-simple-form"  target=_blank> Flask-Simple-Form </a></h2> 
+			
+<h2> See you later </h2>
+
+<h2> ^^ The Blog Team ^^ </h2>
+<br>
+<br>
+</div>
+</div>
+

README.md

@@ -0,0 +1,6 @@
+Dear {{user.first_name }}, {{ user.last_name}}
+Thank you for your registering to our Flask-Simple-Form
+
+Sincerely,
+
+  ^^  Flask-Simple-Form Team ^^

app/README.md

@@ -0,0 +1,53 @@
+from app import socketio
+from flask_socketio import emit
+from datetime import datetime as dt
+
+
+thread = None
+time = {}
+
+
+def time_dict():
+    global time
+    time = {
+        'day_name': str(dt.strftime(dt.now(), '%A')),
+        'month': str(dt.strftime(dt.now(), '%B')),
+        'day': str(dt.now().day),
+        'year': str(dt.now().year),
+        'hour': str(dt.now().hour),
+        'minute': str(dt.strftime(dt.now(), '%M')),
+        'second': str(dt.strftime(dt.now(), '%S')),
+        'pm_am': str(dt.strftime(dt.now(), '%P'))
+    }
+
+
+
+
+def background_thread():
+    while True:
+
+        socketio.sleep(1)
+
+        time_dict()
+
+        """
+            On every seconds, the server send message to the client with updated time.
+            First parameter of emit function tells which function to call on client side.
+
+        """
+        socketio.emit('my_response',
+                      {'data': 'Message from server', 'time': time},
+                      namespace='/test')
+
+
+@socketio.on('connect', namespace='/test')
+def test_connect():
+    time_dict()
+    global thread
+    if thread is None:
+        # Once any client is connected, the background_thread function starts in loop
+        thread = socketio.start_background_task(target=background_thread)
+
+    socketio.emit('my_response',
+                  {'data': 'Message from server', 'time': time},
+                  namespace='/test')

app/REAMDE.md

@@ -1,45 +1,9 @@
-
 from flask import render_template, redirect, url_for
+from app import app
 from app.forms import UserForm
 from app.models import Users as User
-from datetime import datetime as dt
-from flask_socketio import SocketIO, emit
-from app import app
-socketio = SocketIO(app)
-thread = None
-time = {}
-
-
-def time_dict():
-    global time
-    time = {
-        'day_name': str(dt.strftime(dt.now(), '%A')),
-        'month': str(dt.strftime(dt.now(), '%B')),
-        'day': str(dt.now().day),
-        'year': str(dt.now().year),
-        'hour': str(dt.now().hour),
-        'minute': str(dt.strftime(dt.now(), '%M')),
-        'second': str(dt.strftime(dt.now(), '%S')),
-        'pm_am': str(dt.strftime(dt.now(), '%P'))
-    }
-
-
-def background_thread():
-    while True:
-
-        socketio.sleep(1)
-
-        time_dict()
-
-        """
-            On every seconds, the server send message to the client with updated time.
-            First parameter of emit function tells which function to call on client side.
-          
-        """
-        socketio.emit('my_response',
-                      {'data': 'Message from server', 'time': time},
-                      namespace='/test')
-
+from app.mail import send_mail
+from app.time_socket import *
 
 @app.route("/", methods=['GET', 'POST'])
 def index():
@@ -57,6 +21,10 @@ def index():
         user.set_password(form.password.data)
         print("USER-->", user)
         user.save()
+        send_to_user = User.query.filter(User.email == user.email).first()
+        if send_to_user:
+            send_mail(user)
+            print ('SEND_TO-->', send_to_user.first_name + " " + send_to_user.last_name)
         return redirect(url_for('registered'))
     return render_template('index.html', form=form, time=time)
 
@@ -66,16 +34,3 @@ def registered():
     time_dict()
 
     return render_template('registered.html', time=time)
-
-
-@socketio.on('connect', namespace='/test')
-def test_connect():
-    time_dict()
-    global thread
-    if thread is None:
-        # Once any client is connected, the background_thread function starts in loop
-        thread = socketio.start_background_task(target=background_thread)
-
-    socketio.emit('my_response',
-                  {'data': 'Message from server', 'time': time},
-                  namespace='/test')