From ebf3dfd0769bfc3b123ce83bc9805c11e80fb0f7 Mon Sep 17 00:00:00 2001
From: Tiago Vasconcelos <talvasconcelos@gmail.com>
Date: Tue, 1 Jun 2021 23:25:57 +0100
Subject: [PATCH] New Docs (#195)

New docs for TPOS and Events, and a fix in Events extension!

Co-authored-by: Tiago Vasconcelos <tvasconcelos@gmail.com>
---
 lnbits/extensions/events/README.md            | 36 +++++++++++++++++--
 .../events/templates/events/register.html     | 28 +++++++--------
 lnbits/extensions/events/views_api.py         |  3 ++
 lnbits/extensions/tpos/README.md              | 16 ++++++---
 4 files changed, 62 insertions(+), 21 deletions(-)

diff --git a/lnbits/extensions/events/README.md b/lnbits/extensions/events/README.md
index 9108519c..11b62fec 100644
--- a/lnbits/extensions/events/README.md
+++ b/lnbits/extensions/events/README.md
@@ -1,3 +1,33 @@
-<h1>Events</h1>
-<h2>Events: Sell and register event tickets</h2>
-Events alows you to make a wave of tickets for an event, each ticket is in the form of a unqiue QRcode, which the user presents at registration. Events comes with a shareable ticket scanner, which can be used to register attendees.
+# Events
+
+## Sell tickets for events and use the built-in scanner for registering attendants
+
+Events alows you to make tickets for an event. Each ticket is in the form of a uniqque QR code. After registering, and paying for ticket, the user gets a QR code to present at registration/entrance.
+
+Events includes a shareable ticket scanner, which can be used to register attendees.
+
+## Usage
+
+1. Create an event\
+   ![create event](https://i.imgur.com/dadK1dp.jpg)
+2. Fill out the event information:
+
+   - event name
+   - wallet (normally there's only one)
+   - event information
+   - closing date for event registration
+   - begin and end date of the event
+
+   ![event info](https://imgur.com/KAv68Yr.jpg)
+
+3. Share the event registration link\
+   ![event ticket](https://imgur.com/AQWUOBY.jpg)
+
+   - ticket example\
+     ![ticket example](https://i.imgur.com/trAVSLd.jpg)
+
+   - QR code ticket, presented after invoice paid, to present at registration\
+     ![event ticket](https://i.imgur.com/M0ROM82.jpg)
+
+4. Use the built-in ticket scanner to validate registered, and paid, attendees\
+   ![ticket scanner](https://i.imgur.com/zrm9202.jpg)
diff --git a/lnbits/extensions/events/templates/events/register.html b/lnbits/extensions/events/templates/events/register.html
index b1a6a6c1..63af65e8 100644
--- a/lnbits/extensions/events/templates/events/register.html
+++ b/lnbits/extensions/events/templates/events/register.html
@@ -82,7 +82,7 @@
 <script>
   Vue.component(VueQrcode.name, VueQrcode)
   Vue.use(VueQrcodeReader)
-  var mapEvents = function (obj) {
+  var mapEvents = function(obj) {
     obj.date = Quasar.utils.date.formatDate(
       new Date(obj.time * 1000),
       'YYYY-MM-DD HH:mm'
@@ -94,7 +94,7 @@
   new Vue({
     el: '#vue',
     mixins: [windowMixin],
-    data: function () {
+    data: function() {
       return {
         tickets: [],
         ticketsTable: {
@@ -119,35 +119,35 @@
       }
     },
     methods: {
-      hoverEmail: function (tmp) {
+      hoverEmail: function(tmp) {
         this.tickets.data.emailtemp = tmp
       },
-      closeCamera: function () {
+      closeCamera: function() {
         this.sendCamera.show = false
       },
-      showCamera: function () {
+      showCamera: function() {
         this.sendCamera.show = true
       },
-      decodeQR: function (res) {
+      decodeQR: function(res) {
         this.sendCamera.show = false
         var self = this
 
         LNbits.api
           .request('GET', '/events/api/v1/register/ticket/' + res)
-          .then(function (response) {
+          .then(function(response) {
             self.$q.notify({
               type: 'positive',
               message: 'Registered!'
             })
-            setTimeout(function () {
+            setTimeout(function() {
               window.location.reload()
             }, 2000)
           })
-          .catch(function (error) {
+          .catch(function(error) {
             LNbits.utils.notifyApiError(error)
           })
       },
-      getEventTickets: function () {
+      getEventTickets: function() {
         var self = this
         console.log('obj')
         LNbits.api
@@ -155,17 +155,17 @@
             'GET',
             '/events/api/v1/eventtickets/{{ wallet_id }}/{{ event_id }}'
           )
-          .then(function (response) {
-            self.tickets = response.data.map(function (obj) {
+          .then(function(response) {
+            self.tickets = response.data.map(function(obj) {
               return mapEvents(obj)
             })
           })
-          .catch(function (error) {
+          .catch(function(error) {
             LNbits.utils.notifyApiError(error)
           })
       }
     },
-    created: function () {
+    created: function() {
       this.getEventTickets()
     }
   })
diff --git a/lnbits/extensions/events/views_api.py b/lnbits/extensions/events/views_api.py
index 3ea61843..e6aea102 100644
--- a/lnbits/extensions/events/views_api.py
+++ b/lnbits/extensions/events/views_api.py
@@ -195,6 +195,9 @@ async def api_event_register_ticket(ticket_id):
     if not ticket:
         return jsonify({"message": "Ticket does not exist."}), HTTPStatus.FORBIDDEN
 
+    if not ticket.paid:
+        return jsonify({"message": "Ticket not paid for."}), HTTPStatus.FORBIDDEN
+
     if ticket.registered == True:
         return jsonify({"message": "Ticket already registered"}), HTTPStatus.FORBIDDEN
 
diff --git a/lnbits/extensions/tpos/README.md b/lnbits/extensions/tpos/README.md
index dd4491ec..04e049e3 100644
--- a/lnbits/extensions/tpos/README.md
+++ b/lnbits/extensions/tpos/README.md
@@ -1,7 +1,15 @@
-<h1> TPOS</h1>
-<h2>A Shareable PoS that doesnt need to be installed and can run in phones browser!</h2>
-<p>If someone drops your Quickening in a beer at your bar, staff can scan a QR and open/use a browser based PoS, linked to the same self-hosted lnbits instance!</p>
+# TPoS
 
-<img src="https://i.imgur.com/8wgTWDn.jpg">
+## A Shareable PoS (Point of Sale) that doesn't need to be installed and can run in the browser!
 
+An easy, fast and secure way to accept Bitcoin, over Lightning Network, at your business. The PoS is isolated from the wallet, so it's safe for any employee to use. You can create as many TPOS's as you need, for example one for each employee, or one for each branch of your business.
 
+### Usage
+
+1. Enable extension
+2. Create a TPOS\
+   ![create](https://imgur.com/8jNj8Zq.jpg)
+3. Open TPOS on the browser\
+   ![open](https://imgur.com/LZuoWzb.jpg)
+4. Present invoice QR to costumer\
+   ![pay](https://imgur.com/tOwxn77.jpg)